前言¶
在 DeepSeek Harness(DSH)里做完一件事,步骤往往散落在工具调用、失败重试和用户纠正里。手工抄进 SKILL.md 费时,也容易漏掉「当时怎么验证通过」这类细节。社区插件 会话考古(dsh-session-archaeology)的做法是:你手动选定一段已经提交的历史会话,插件用纯规则、离线读日志,整理出带事件序号证据的可复用 Skill,并写入当前 profile 的技能库。它不接管实时对话,也不调用模型。
这是什么¶
维护者为 LittleGreyy。插件是一个 DSH bundle(package.json 中声明 dsh.bundle.patch 与 dsh.client),当前版本 0.3.0,许可证 MIT。
一句话定位:手动选中一段历史会话,离线蒸馏出可复用的 Skill。
与「边聊边记」不同:只有你在界面里点蒸馏并保存,才会产生产物;蒸馏过程零模型调用、零网络请求。
核心功能¶
下面几项能力均来自项目 README,安装前可自行对照源码。
- 手动触发:不操作界面则不会发生任何事。
- 完全离线:
digest.js对{ session, events }做规则蒸馏,不依赖 DSH 运行时即可单独测试。 - 可回查:每条结论带
(#seq),对应源会话事件序号。 - 即插即用:保存后通过
ctx.skills注册 provider,该 profile 下技能目录会立刻刷新;删除同理。 - 中英双语:界面与产出的
SKILL.md支持zh/en。
蒸馏时各章节与判据(摘要):
| SKILL.md 章节 | 数据来源 | 判据要点 |
|---|---|---|
| 步骤 | 工具调用最密集的一轮 | 成功调用按 seq 排序、去重,附意图句 |
| 关键文件 | write / edit 的 file_path |
按命中次数排序 |
| 坑与修正 | 失败调用 → 同轮下一次成功 | 失败原因取结果首行或错误字段 |
| 用户纠正 | 用户发言 | 含「不对 / 应该 / 改成 / instead / actually…」等 |
| 验证 | 命中 test/build/lint/run 等命令 | 且输出像成功结果(如 success / passed / exit: 0) |
被用户推翻的修正会标注「随后被用户纠正 #n」,避免把错误做法写进结论。
产物目录:
~/.dsh/session-archaeology/skills/<skill-name>/
├── SKILL.md # YAML frontmatter + Markdown 正文
└── meta.json # 统计与证据索引
安装与启用¶
宿主要求:DeepSeek Harness 0.2.0 或更新(package.json 的 engines.dsh 为 >=0.2.0-0,更旧版本会被拦截)。
在目标 profile 下,于 DSH 会话中让 agent 执行安装(target 指向插件目录的绝对路径):
plugin_manager install_bundle <path-to>/dsh-session-archaeology
安装会写入该 profile 的 package.json 与 cordis.patch.yml,无需手改。完成后刷新 DSH Web 页面,左侧边栏应出现「会话考古」图标。README 注明:递归 install_bundle 后同样需要刷新页面才能加载新的 Client 模块。
卸载:
plugin_manager remove_bundle dsh-session-archaeology
插件以当前 DSH 进程的权限运行;安装前应阅读仓库源码与 MIT 许可证,确认行为符合你的环境策略。
典型用法¶
- 点击左侧「会话考古」图标;
- 在左栏选中一段历史会话;
- 点击「蒸馏 Skill」;
- 检查并修改名称、描述、「何时使用」等字段;
- 点击「保存到技能库」。
当前粒度是整段会话,还不能只选其中若干轮(README 将其列为自然的下一步扩展)。
适用场景与注意¶
适合:你已经有一段在 DSH 里跑通、且日志已提交的会话,想把步骤、踩坑和验证方式固化成 Skill,供同 profile 后续会话复用。
不适合或需有预期:
- 蒸馏是启发式的:忠实记录「发生了什么」,不解释「为什么」,也不替你润色措辞。
- 仅在 DSH Desktop / Windows 上实测过;其他 profile 布局未验证。
- 不参与实时对话,不能替代在线 Skill 编写或模型总结。
DeepSeek Harness 生态强调「一切皆插件」;社区目录 SkillHub 插件页 与 GitHub 仓库由社区维护,与 DeepSeek / 幻方无官方从属关系。
结尾¶
会话考古把「事后整理」变成可选中的一键离线流程:有证据序号、无模型成本,产物直接进入技能库。若要查看实现细节,仓库内 index.js(Host 路由与 skills provider)、client.js(侧边栏与中央页)、digest.js(蒸馏核心)分工清晰。
- 目录页:https://www.skillhub.cn/plugins/LittleGreyy/dsh-session-archaeology
- 源码与文档:https://github.com/LittleGreyy/dsh-session-archaeology