DDDFXYqiming/dsh-session-recap

简体中文 | English

@dsh-external/dsh-session-recap

DeepSeek Harness（DSH）会话回顾插件。你把 Web 窗口切到后台，或者转到另一个会话，它就在后台生成一份简短回顾。等你回来，一张卡片会概括那个会话的当前任务、已完成进展和下一步。

当前插件版本为 0.1.7，peer 兼容范围为 DSH >=0.1.6-alpha.1

GitHub 安装会触发 prepare 脚本重新构建 lib/。pnpm ≥10 首次 add 会拒绝运行该构建脚本。把 pnpm 打印的包键复制进 profile 的 pnpm-workspace.yaml 后重新 add 即可。下面是一份示例。
yaml
allowBuilds:
'@dsh-external/dsh-session-recap': true

请把这项授权视为「允许该包代码在安装时于你的机器上执行」；担心后续推送改变构建内容时，锁定 commit（github:DDDFXYqiming/dsh-session-recap#）。

插件自带 cordis.patch.yml，安装后会自动加入 dsh-session-recap bundle 条目。首次安装后重启 Web profile，再刷新页面。

配置

bundle 安装提供默认条目；需要覆盖配置时，在 profile 的 cordis.patch.yml 中使用下面的裸条目。
yaml
- id: dsh-session-recap
config:
enabled: true        # 只控制自动回顾；/recap 始终可用
hostCommand: false   # Web 保持 false；无浏览器 profile 可设为 true
idleMs: 180000       # 最后一个完成 turn 到自动回顾的最短时间（毫秒）
minTurns: 3          # 自动回顾所需的最少完成轮数
recentMessages: 80   # 进入回顾窗口的最近会话消息数（工具结果不计入）
maxChars: 1200       # 回顾文本上限
maxInputChars: 24000 # 回顾输入上限（字节）
maxOutputTokens: 2048 # 回顾模型的输出 token 预算（思考型模型把思考 token 也算进该预算）
timeoutMs: 30000
manualRequestTimeoutMs: 70000 # 浏览器手动 /recap 等待结果的超时（毫秒）；生成最长约 2×timeoutMs，放弃等待不影响服务端继续生成
provider: ''         # 留空：复用会话最近实际使用的 provider
model: ''            # 留空：复用会话最近实际使用的 model；固定路由时与 provider 一起填写
reasoningEffort: ''  # 留空：插件不传思考等级；也可填写目标适配器支持的 id
temperature: 0.2   # 可选；省略时使用目标模型/适配器默认值
stopSequences: []    # 可选停止词列表

provider 与 model 必须成对填写；同时留空时，自动回顾和 /recap 都复用会话最新 request/context 中的实际路由，回顾默认跟着会话真正在用的模型走，不需要单独为它指定路由。默认不会继承或传递会话的 reasoningEffort，目标模型适配器仍可应用自己的默认值。回顾路由若跟着思考型会话模型走，思考 token 会占用 maxOutputTokens 预算。预算耗尽时，只要已有至少一个完整句子就直接交付；完全没有完整正文才按 4 倍预算（上限 4096）重试一次。上述覆盖项与输入/输出边界、超时设置同时适用于自动和手动回顾。
hostCommand 决定 /recap 的唯一所有者。Web profile 保持默认值，由客户端贡献完整菜单样式；只有不加载 Web 客户端的 profile 才设为 true，由宿主命令在终端或其他命令面直接返回正文。同一 profile 不要同时启用两种所有者。

存储布局
text
/.dsh/plugin-data/dsh-session-recap/
└── .json

sidecar 只保存当前会话的回顾文本、生成时间和完成轮次锚点。DSH 的 session log 是 append-only 的，插件不改它的事件词汇，也不往里写自定义事件。旧回顾会被清理。会话前进后，每个会话留下的始终是当前那一份回顾。

安全边界

/api/dsh-session-recap route 仅接受 loopback 连接：校验远端地址、Host 头与 Origin。Host 用锚定正则匹配，阻断 DNS rebinding；跨端口、跨协议与伪造 Host 的请求一律拒绝。写入面 POST（presence 上报与手动生成）强制要求精确同源的浏览器 Origin，非法来源不会触发生成。读取面 GET 不要求 Origin：任何能访问该本机端口、且能通过地址与 Host 校验的本地进程都可读取指定会话的回顾正文，这与直接读取插件 sidecar 文件等价，不引入额外暴露。该 route 按既定设计免宿主鉴权，信任完全依赖上述 loopback 与同源校验；route 不触碰任何凭据，也不返回会话日志原文，响应不带 CORS 头，并带 Cache-Control: no-store 与 X-Content-Type-Options: nosniff。

兼容性

| 项目 | 版本或范围 |
| --- | --- |
| dsh-session-recap | 0.1.7（package.json） |
| DeepSeek Harness packages | 兼容范围 >=0.1.6-alpha.1 =24.0.0（与 DSH 当前运行时范围一致） |
| 使用面 | 所有提供 LLM 与 session projection 服务的 DSH profile。宿主命令另需 commands；Web 卡片另需 locale、conversation、slots 和 web-server 服务 |

开发与验证
bash
npm install
npm run typecheck
npm run build
npm test
npm run test:upstream # 未设置 DSH_UPSTREAM_ROOT 时自动跳过；默认核对 dsh-v0.1.6-alpha.1
npm run build:client
npm pack

构建脚本优先使用本地依赖。针对 DSH checkout 开发时可以设置 DSH_CHECKOUT，也可以设置 DSH_GLOBAL_NODE_MODULES 指向兼容的全局 node_modules。脚本只补建缺失的链接，不替换已有的包。上游结构测试默认使用发布标签 dsh-v0.1.6-alpha.1；需要检查更新的源码时可通过 DSH_UPSTREAM_REF 指定分支、标签或提交，不在文档中把会移动的 master 写成固定事实。

插件不调用宿主的 deepFreeze。请求选项的冻结由插件内本地实现完成，避免依赖这个内部导出的迁移位置。

相关

- DeepSeek Harness
- pi-recap，同一行为在 Pi Coding Agent TUI 上的实现
- GitHub Releases

授权

MIT