@kulebbb/dsh-context-optimize

DSH（DeepSeek Harness）左侧边栏的 Skill 管理面板：看清每个 skill 占了你多少上下文、多久没用了，没用的收起来。

English. A Skill manager for the DeepSeek Harness sidebar. It lists every installed skill with its call count, last-used date and estimated context cost, split into global and project scope, and archives or restores a skill by moving its directory into a reversible skill-archive.

它解决什么问题

DSH 每次开新会话，都会把「所有 skill 的名字和一句话介绍」预先塞进模型的上下文——哪怕这次一个都用不上。skill 装得越多，这份清单越贵，而你通常不知道哪些其实从来没被调用过。

这个插件把这件事摊开给你看：

• 列清楚：全局（~/.dsh/skills、~/.agents/skills、App 内置 skill）与项目级（项目根下的 .dsh/skills、.agents/skills）分开看；
• 看得懂：每条显示历史调用次数、最近使用时间、以及它在会话目录里占多少 tokens；
• 动得了：一键归档（把目录移进同级的 skill-archive，全程不删除任何文件）与一键还原，还能直接打开 skill 所在目录。

截图 / Screenshots

全局总览

顶部是上下文预算：所有生效中的 skill 加起来占多少 tokens、按占用排开的色带、历史调用与近 30 天调用。下面是明细表，可按调用次数或占用排序。

项目详情

点进任意工作区，看到的项目级 skill 与全局页用同一套筛选和表格：生效中 / 从未被调用 / 已归档三个状态互斥切换，各自带计数。

从未被调用

「从未被调用」会告诉你这些条目一共占了多少上下文——这一组通常就是最值得收起来的。

已归档

归档后条目进入同一张表的「已归档」状态，行尾一键还原，没有任何删除动作。

功能

• 全局 / 项目两个范围分开统计，项目范围按「项目根」聚合（见下方常见问题）；
• 每条 skill 显示调用次数、最近使用时间、估算上下文占用（名字 + 描述，按 3.5 字符 ≈ 1 token 估算）；
• 状态筛选互斥三态，带计数；生效中可按调用次数或占用排序；
• 一键归档 / 还原：归档是把 skill 目录移到同级的 skill-archive，DSH 不会再加载它，随时可还原；
• 归档后 3 秒内可撤销；目标位置有同名条目时自动改名，不会覆盖；
• 行尾可直接打开 skill 目录，或在 Finder 中打开项目目录；
• 内置只读 skill 会被宿主拒绝归档，不依赖界面置灰。

安装

需要带左侧边栏面板槽位的 DSH（桌面端与 Web 版都可以）。

方式一：插件页

侧边栏打开「插件」页 → 安装，填入下面任一地址，装完按提示重启 DSH：

• npm：@kulebbb/dsh-context-optimize
• GitHub：https://github.com/kulebbb/dsh-context-optimize

方式二：CLI

dsh plugin --profile desktop add @kulebbb/dsh-context-optimize

重启后左侧边栏出现「Skill 管理」入口。本包是 bundle（dsh.bundle 指向自带的 cordis.patch.yml），由插件页负责启用/卸载，不需要手工改 profile。

使用

• 看总量：打开面板先看预算卡——它是每次会话的固定目录开销，归档没用的 skill 会直接把它降下来。
• 找没用的：点「从未被调用」，默认按占用降序，先砍最贵的。
• 归档：行尾的归档按钮。想反悔就点提示条上的「撤销」；过了 3 秒也能在「已归档」里还原。
• 还原：切到「已归档」，行尾还原按钮会把目录搬回原来那个根。
• 排序：只有「生效中」状态显示排序按钮，在「按调用次数 / 按占用」之间切换。

调用次数是怎么来的

宿主会读本机会话日志里「模型加载某个 skill」的事件，外加你手敲 /skill名 直接触发的次数，按会话折叠成熟度数据。首次启用时要把历史会话扫一遍（本机 700+ 会话约 45 秒，面板顶部有进度条），之后靠增量累加。

缓存文件在 ~/.dsh/storages/dsh-context-optimize/，删掉会重新跑一次全量扫描。

归档箱在哪

范围	归档目录
全局	~/.dsh/skill-archive、~/.agents/skill-archive
项目	<项目根>/.dsh/skill-archive、<项目根>/.agents/skill-archive

归档目录和 skills 同级，DSH 不会把它当成 skill 再扫到。

安全说明

• 全流程没有删除动作：归档是移动目录，还原是搬回去；
• 客户端只传根 ID、工作区 ID 和目录名，绝对路径全部由宿主拼接并做穿越校验；
• 内置只读 skill 不能被归档，拒绝发生在宿主端，不依赖界面；
• 「打开目录」走 DSH 官方桌面通道，不自己执行 shell 命令；
• 宿主只读会话日志里的工具调用事件和工作目录，不读对话正文。

常见问题

为什么有的 skill 调用次数是 0？ 统计只看会话日志里的 skill 加载事件。刚装好时先等首次回溯跑完；缓存被删后也会重新扫。

归档之后 DSH 还会加载它吗？ 不会。目录已经移出 skills 根，DSH 扫描不到；还原后立刻恢复。

「项目级 skill」的范围到底怎么算？ DSH 会从会话工作目录往上找最近一个带 .git 的目录作为项目根，项目级 skill 指项目根下的 .dsh/skills 与 .agents/skills。所以同一个项目根下的多个工作区会看到同一批项目级 skill。

会改动我的配置或 skill 内容吗？ 不会。它只移动 skill 目录本身，不修改任何 skill 文件，也不写 DSH 配置。

支持哪些平台？ DSH 桌面端与 Web 版都可以，插件注册的是侧边栏入口 + 中央面板。

已知限制

• 英文界面里「今天 / 昨天」仍是中文（相对时间在共享代码里硬编码）；
• 历史缓存最多保留 5000 个会话，超过后「历史调用」不再是全部历史；
• 归档时间取目录的 ctime，之后如果目录元数据被改动，这个时间会刷新；
• 内置 skill 只读，不能归档；
• 同名 skill 的覆盖关系按 DSH 自己的优先级判定（项目 .dsh > 项目 .agents > 用户 .dsh > 用户 .agents > 内置）。

开发

pnpm install
pnpm check   # typecheck + test + build

• 宿主半：src/index.ts + src/host/** → lib/index.js（ESM）
• 浏览器半：src/client/** → lib/client.js（CJS + window.__ModuleLoader__ 包装）
• 测试：tests/** 8 个 spec、153 条用例，全部落在 os.tmpdir()，不读真实 ~/.dsh 或 ~/.agents
• 本地调试用 link: 装进 profile，改完 pnpm build 再重启 DSH；细节见 docs/development.md

反馈

问题、建议、使用中的坑都欢迎开 Issue。

License

MIT