前言¶
在 DSH 里和模型来回改需求、跑命令、定方案，对话越长，事后越难复盘：待办散在原文里，决定和承诺要一条条翻记录才能摘出来。自己复制粘贴再让模型总结，多半还要反复改提示词。DeepSeek Harness 支持用插件扩展 Web 端能力；维护者 RedoMiao 的 dsh-session-recap（社区目录归类为「记忆」）面向同一段 DSH 对话：你写好模板当作给模型的完整指令，插件读取当前会话事件日志、调用你在 DSH 里已配置的模型生成结果，预览后可复制 Markdown，或写入 Obsidian 库。没有 Obsidian 也能生成和预览；保存时才需要指定库路径。
下面按定位、能力、安装、用法与限制说明，事实以 GitHub README 与 Release v0.2.7 为准。
这是什么¶
dsh-session-recap 把「一段 DSH 对话 + 你定义的模板」变成可留存文稿。界面入口是页面右下角的小猫按钮（package.json 描述里亦提到 /summary）；流程是选模板、生成、预览、复制或保存。模板正文本身就是任务指令，不是插件内置的固定总结算法；输出格式与内容受对话原文、所用模型影响。代码仓库：https://github.com/RedoMiao/dsh-session-recap；社区目录页：https://www.skillhub.cn/plugins/RedoMiao/dsh-session-recap。
核心功能¶
模板驱动的生成¶
插件不会自动套一层「请总结这段对话」。模板正文即本次请求的完整指令。例如 README 中的「数」类写法：只统计出现次数并限定输出行数；「挑」类：只列待办并要求 Markdown 表格列名。正文里一旦出现 【】，会按笔记骨架处理，由模型把内容填进占位；不含 【】 则为自由指令。两种模式不要混用：只要出现 【】 就走骨架逻辑。最多保存 6 个模板；模板名优先用作保存文件名，名为空时回退会话标题。
预览、复制与 Obsidian 保存¶
默认按轻量 Markdown 渲染预览（表格、标题、列表、引用、代码块等）；可切换「源码 / 预览」，切换不重新请求模型。复制与落盘内容均为原始 Markdown。保存默认路径形如：库/项目经历/年.月/月.日 项目名/项目名 · 模板名.md，可在设置里改。第一次保存需选择 Obsidian 库根目录（应含 .obsidian），支持自动查找或手填路径。
数据与权限（README 归纳）¶
| 行为 | 说明 |
|---|---|
| 读会话 | 只读当前这一次对话的事件日志 |
| 调模型 | 使用 DSH 当前配置的模型；短对话一次请求，「读全部」长对话可能分段多次 |
| 写文件 | 仅写入你设置的库目录，文件名做安全化处理 |
| 联网 | 除模型调用外不联网；README 写明无遥测 |
| 配置 | ~/.dsh/session-recap.json，写入前保留 .bak |
| 日志 | 系统临时目录 dsh-recap.log，记阶段与错误，不记笔记正文 |
只有你点击「生成」或「保存」时才会动作，不会后台自动生成。
安装与启用¶
前提¶
| 项 | 资料中的说明 |
|---|---|
| DSH CLI | 0.1.2-rc.1 实测；其他版本未验证 |
| Node.js | v24.16.0 实测；package.json 要求 >=20 |
| 系统 | Windows 11 10.0.26200 实测；macOS / Linux 未验证 |
| Obsidian | 可选 |
本版未发布到 npm，仅以 tarball 分发。DSH 仍为预发布形态时，插件通过注入脚本挂到页面；大版本升级后可能失效，升级后先刷新页面，仍异常则需等待插件跟进。
安装包与命令¶
到 Release v0.2.7 下载：
- 文件：
dsh-session-recap-0.2.7.tgz - SHA-256：
E3056A371E5EA0E616FE525064178102097C0D71B284BF1AD7875CD53C06CD0C
在 PowerShell 中用本地路径安装（将 web 换成你的 profile，路径换成实际下载位置）：
dsh plugin --profile web add "$env:USERPROFILE\Downloads\dsh-session-recap-0.2.7.tgz"
README 写明实测的是「本地 tarball + dsh plugin --profile ... add」，未实测直接用 https URL 安装；也不要使用 npm install dsh-session-recap。装完后重启该 profile（例如关闭再运行 dsh web），并刷新浏览器页面。
升级与卸载¶
新版本：下载新 tarball，用同一条 add 命令覆盖安装，重启并刷新；升级不自动迁移模板与库路径。卸载示例：
dsh plugin --profile web remove dsh-session-recap
卸载后可能留下 ~/.dsh/session-recap.json 与临时目录中的 dsh-recap.log，不需要可手动删除。已写入 Obsidian 的笔记不会自动删除。
典型用法¶
第一次走通流程¶
- 点右下角小猫；未配库也可直接打开面板。
- 选择模板；若无合适项，进入「设置」→「编辑」改正文后保存再选。
- 点「生成」，选择要处理的对话；长对话若需压缩，会先询问「只读重点 / 读全部」。
- 查看预览，必要时切「源码」核对原始 Markdown。
- 「复制」带走文稿，或「保存进 Obsidian」；首次保存需先选好库路径，同一稿再次保存不会重新生成。
模板示例（摘自 README，可自行改写）¶
自由指令——统计关键词：
数一数这次对话里出现了几次 DSH。
只回三行：次数、最多 5 条原话、读取范围。
自由指令——待办表格：
只挑出还没做完或待确认的事，其他一律不写。
输出标准 Markdown 表格，第一行是表头：事情 | 谁在做 | 现在卡在哪 | 原话依据（一句）；第二行是分隔行。
按紧急程度排序，最多 10 行。没有就回一行「没有待办」。
笔记骨架：
# 【标题】
## 要点
- 【填写】
## 结论
- 【填写】
README 还把示例意图分成「数 / 挑 / 提 / 转 / 评 / 结构化」等写法参考（如周报改写、JSON 仅输出 decisions[] 等），均属模板正文示例，不是插件硬编码功能。需要稳定表格时，应在模板里写清表头、分隔行与行数上限。
适用场景与注意¶
适合谁：经常在同一条 DSH 会话里推进任务，想把结果沉淀为清单、表格、交接说明或 Obsidian 笔记的开发者；愿意用模板约束模型输出格式的人。
运行与信任边界：插件随当前 DSH 进程与你在 Web 端使用的 profile 加载；读的是当前对话日志，生成时把材料发给 DSH 已配置的模型服务。安装前宜浏览仓库源码与 LICENSE（代码为 MIT）。README 单独说明 assets/ 下图片与 cat.mp3 等素材来源与授权部分待补，与代码许可分开；音效在来源确认前不宜默认可再分发或商用。
已知限制（摘要）：
- 一次只处理单条会话，不做跨对话项目级汇总。
- 注入式挂载，DSH 大版本变化后可能需插件更新。
- 预览不支持脚注、数学公式、Mermaid 等扩展语法；远程图片不加载。
- 多 profile 共用
~/.dsh/session-recap.json，换 profile 仍是同一套模板与库路径。 - 模型输出有波动，同一模板在不同模型上格式可能不一致。
故障排查要点：小猫不出现——确认装在对的 profile、已重启并刷新；列表为空——确认对话仍活跃或刷新后重试；保存失败——库路径须为可写 Obsidian 根目录；预览无表格——先看源码是否含 |---| 分隔行，再收紧模板表述。
结尾¶
dsh-session-recap 的价值在于把「怎么整理这段对话」交还给你：模板即指令，生成—预览—落盘一条链完成，Obsidian 可选。当前资料记载的真实装机环境为 Windows 11 + DSH 0.1.2-rc.1 + 插件 0.2.7；其他系统与其他 DSH 版本未经作者同等验证，使用前请按 README「未验证」理解。
- 社区目录：https://www.skillhub.cn/plugins/RedoMiao/dsh-session-recap
- GitHub：https://github.com/RedoMiao/dsh-session-recap
- 问题反馈：https://github.com/RedoMiao/dsh-session-recap/issues
