dsh-plugin-dev-tools
DSH 开发工具箱：按 Alt 悬浮查看界面元素归属、把踩过的坑记进随插件分发的经验库、开发模式下自动注入动手前的自检清单。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:eighteentang/dsh-plugin-dev-tools#270b10f6d2f643145f629220d91645802ebaea36Plugin Dev Tools 以 dsh-plugin-dev-tools 发布，当前版本为 1.5.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
当前版本 1.5.1 · 变更记录见 CHANGELOG.md（在这里写版本号，是因为
package.json 里那个数字用户看不到，而"我装的这版新不新"是他们会问的第一个问题）。
给 DSH（DeepSeek Harness） 插件开发者的一小组工具，外加一份随插件分发的开发经验库。
装一次，之后你自己开关里面的每个小工具。
开发 DSH 插件时会遇到很多文档里没写、只能踩出来的坑，比如：
每个人各踩一遍、各花几小时，是纯浪费。
所以这个插件做三件事：
打开 DSH → 侧边栏 插件 页面 → Add plugin
填入：
github:eighteentang/dsh-plugin-dev-tools
确认插件列表里出现 dsh-plugin-dev-tools 且为启用状态
重启一次客户端（DSH 按文件路径缓存已加载的模块，必须重启才加载新代码）
不需要构建授权。 这个插件是纯 JavaScript，没有
build/prepare脚本， 所以 pnpm 没有脚本要跑，也就不会要求你在pnpm-workspace.yaml里加allowBuilds。 （带 TypeScript 构建的插件才需要那一步。）
想改代码、或者网络不通时用这个：
Code → Download ZIP，或 git clone）dev-tools 这个文件夹放到一个长期保留的位置
（路径里不要有中文和空格，例如 D:\dsh-plugins\dev-tools）D:\dsh-plugins\dev-tools⚠️ 用本地路径装时，DSH 会把它记成
link:形式 —— 这种方式不会安装该包的依赖。 本插件零依赖，所以没影响；但如果你在改它、并加了依赖，记得手动补。
打开 设置 → 开发工具，应该看到一个总开关和几个小工具。
Ctrl+Alt+C 直接复制，不用瞄准按钮复制出来的内容长这样，可以直接贴给 AI 助手或同事：
【界面定位】侧边栏底部动作区
slot: sidebar.footer.action
元素: div.dvt-controls
路径: body > div.app > div.sidebar > div.dvt-controls
尺寸: 120×26 top=720 left=12
说明: 💀 结束进程按钮渲染在这里
看到「（未收录的元素）」说明那个位置还没登记过名字 —— 把复制到的路径发给我们，就能给它起个名字，以后大家都用那个叫法。
侧边栏底部的一个 💀 按钮：结束 DSH 宿主进程。
点它 → 确认 → DSH 弹出恢复框 → 在那里选「重启」（干净的自动重启，约 7 秒）或「退出」。
那个框不是报错，是正常流程 —— DSH 外壳把"宿主进程终止"一律当异常处理， 所以任何结束宿主的操作都会经过它。
为什么不做成"直接重启"按钮：DSH 没有对外的重启接口。
它的重启原语是 app.relaunch() + quitWithoutConfirmation()，写在 lib/main.js 的
崩溃恢复对象里，只被 fail() 调用，没有任何 IPC 暴露
（当前版本的 preload 通道里没有 restart / quit / shutdown ——
具体数量随 DSH 版本变，以 app-control.js 的注释为准）。
自己 kill 进程再拉起要慢 9 倍（实测 64 秒 vs 7 秒），所以不如把选择交给官方那个框。
打开后三件事生效：
record_experience 工具 —— AI 踩到新坑时可以直接记进经验库关掉后这些立即撤下（不是隐藏，是真正注销），注入的内容变成 0 字符。
注入的体量：开着时约 6.6 千字符/次（自检清单 + 工作流约 1.8 千字符，经验索引约 4.8 千字符）。 经验库全文（185 KB / 10.3 万字符 —— 前者是磁盘字节、后者是文本长度， 中文一字三字节，两者差约 1.8 倍，别混）不进上下文，AI 需要细节时自己去读； 索引才进上下文，而且它按固定预算装配 —— 经验库继续变长也不会把提示词撑爆。
这是本插件最有价值的部分。
它在 experience/经验库.md，随插件分发 ——
你装插件就自动获得。而且它的索引会被注入到 AI 助手的提示词里，
所以 AI 也会知道"有这些坑存在"，而不是重新踩一遍。
打开 设置 → 开发工具，页面里会显示：
开发经验库 [⟳ 刷新]
版本 2026-10-13
条数 77 条
更新于 2026-10-13
指纹 78594924
那个 ⟳ 是「刷新」按钮（重新读取经验库），不是重启按钮。 它存在的意义：你替换掉经验库文件后，不用重启客户端就能看到新数字。
experience/经验库.md 有没有更新怎么判断"是不是有更新"：比对设置页显示的条数与指纹。 只看日期不够 —— 有人可能只是修正了一条旧经验（条数没变，但内容变了）。
踩到新坑后：
experience/经验库.md 末尾追加一条（格式照抄现有的）entries（条数）、updatedAt（日期）、fingerprint（指纹）格式（固定格式是为了能被脚本解析并注入提示词）：
## E15 · 一句话标题（写症状，不要写"要注意 XX"）
- **范围**：通用 | 项目特定 —— 可选，缺省为"通用"
- **症状**：你会看到什么现象
- **解法**：该怎么做
- **细节**：可选补充（为什么、怎么查、实测案例）
写作标准：
| 要 | 不要 |
|---|---|
| 写具体症状（"点复制按钮没反应，粘贴是空的"） | 写原则（"要注意剪贴板权限"） |
| 写可执行的解法（给命令、给函数名） | 写方向（"建议参考框架实现"） |
| 一条一个坑 | 一条混好几个问题 |
原则 AI 本来就知道，具体症状才能让它对上号。
标注 范围：项目特定 的条目不会被注入到别人的提示词里 ——
它们只留在文件里作范例（讲的是某个具体产品的架构取舍，对别人没参考价值）。
dev-tools/
├─ package.json 插件清单（声明"我是插件"、入口、浏览器半）
├─ cordis.patch.yml 加载器行声明
├─ index.js 宿主半（跑在 DSH 主进程里）
├─ client.js 客户端半（跑在页面里，**必须单文件、零 import**）
├─ app-control.js 结束进程接口 + 经验库查询 + 诊断接口
├─ dev-rule.js 提示词注入（自检清单）+ 开发模式状态
├─ workflow.js "开工前定需求"那段注入文本
├─ experience.js 经验库解析、索引生成、追加条目
├─ experience-tool.js record_experience 工具
└─ experience/
├─ 经验库.md ← 77 条实测踩坑（随插件分发）
└─ README.md 经验库的使用与贡献说明
Config 无法被内省：因为外部插件 import 不到 asar 内部的
@deepseek-ai/schemastery，只能手写 Standard Schema，于是
Config.listConfigs 显示 status: "unsupported"。功能不受影响link: 形式，不会安装依赖：本插件零依赖所以没影响源码里那些注释不是装饰。它们记录了实测踩出来的坑，比如：
ctx.inject(deps, cb) 不能用 ctx.get(deps) 代替tools.register 的 parameters 必须是 JSON Schema 而不是简写useEffect 的依赖数组里不能放它自己 setState 的 statesingle 槽位可以用更低的 priority 遮蔽 shipped 的注册*/ 提前结束注释 —— 都实测踩过）改代码前读一下注释，能省下你重新踩一遍的时间。
更详细的事故记录在 experience/经验库.md，64 条，每条都是踩出来的。
改完代码行为没变，然后开始瞎猜（ESM 缓存？路径不对？热重载没开？）—— 这个 tab 就是为了让这件事不用猜。
去哪找：右侧边栏的引导页里挑一次「开发诊断」（跟官方 Files 那个 tab 一样， 不是默认就摆在「上下文」旁边）。挑过一次之后它就在那儿了。
它分六区：
! 需重启 / ~ 已生效 / · 一致第 6 区为什么不能省：宿主插件的
console.log桌面端不落盘（写进宿主 stdout， 桌面应用不重定向）。所以"插件到底做了什么"本来完全看不见， 故障表现是"不崩溃但什么都不做"，只能靠猜。这是唯一的观察窗口。日志写在
~/.dsh/dev-tools.log，单文件 512 KB 上限、超了滚一代（.1）。 写日志失败静默 —— 为一行日志把插件搞崩不划算。
touch 或用编辑器重写同样内容都会刷新 mtime，但内容没变 —— 用 mtime 会假报"未生效"。
所以它在模块加载时记下每个关键文件的内容哈希，运行时重算比对。
这是最容易混起来的地方：
| 改什么 | 要不要重启 |
|---|---|
插件源码（.js） | 要 —— Node 的 ESM 缓存以文件 URL 为键 |
运行期读盘的文件（experience/经验库.md 这种） | 不要 —— 每次读盘，改完立刻生效 |
| profile 的配置 / patch | 不要 —— HMR 默认监听配置（实测 patch 改完 2 秒后重挂载） |
实测结论（2026-10-12）：
@deepseek-ai/dsh-base/cordis.patch.yml把 HMR 的config.root设成[]，也就是只监听配置、不监听源码。 包自身 schema 的默认是["."]，被 base 组合覆盖了 —— 两处矛盾时以 base 为准。
logger / events / registry / reflectdsh-tool-cordis 的
api-catalog.js），插件读不到权威副本；要查签名得用宿主侧的 cordis_inspect_queryGET http://127.0.0.1:8800/dev-tools/self-check 直接返回同一份 JSON（只读）。
加载时还会往 ~/.dsh/dev-tools-selfcheck.log 写一条加载记录 ——
宿主插件的 console.log 桌面端不落盘，不自己记就等于没有。