dsh-session-summarizer
DSH（DeepSeek Harness）生态原生 Cordis 插件：读取指定 / 当前 / 最近会话并生成上下文摘要，帮助模型在长会话中恢复上下文。全程走 DSH 官方运行时（@deepseek-ai/dsh-session 读取会话、@deepseek-ai/dsh-llm 生成摘要），不依赖任何外部服务。
简介
插件以 bundle patch 方式挂载到 profile，注册模型可见工具 session_summarize。它读取指定（或当前 / 最近）会话内容，调用模型产出一份中文「上下文摘要」并回复，供模型在长会话中快速恢复上下文。
目录结构：
dsh-session-summarizer/
├── package.json # manifest：main 指向 src/index.js，dsh.bundle.patch 声明
├── cordis.patch.yml # bundle patch 层：向 profile 插入插件行
├── src/
│ └── index.js # 插件入口 { name, inject, apply }，注册 session_summarize 工具
├── README.md
├── CHANGELOG.md
└── LICENSE安装
以 bundle patch 形式把插件装入 profile 的 node_modules，随 dsh plugin 命令完成。
# 从 npm 安装（发布形态）
dsh plugin --profile <profile名> add dsh-session-summarizer
# 从 GitHub 仓库安装
dsh plugin --profile <profile名> add github:KhalilYamber/dsh-session-summarizer
# 本地路径（开发验证）
dsh plugin --profile <profile名> add file:../dsh-session-summarizer> 安装语法已在本机核实（dsh CLI 0.1.0-rc.6）：dsh plugin 会把 --profile 之外的剩余参数转发给该 profile 目录内的 pnpm，实际等价于 pnpm add <package>。若你使用的 dsh CLI 版本不同，以 dsh plugin --profile <name> --help 的实际输出为准。
安装后启动 profile，session_summarize 工具随插件注册。摘要模型、转录预算等行为可在 cordis.patch.yml 的 config 中调整（model、transcriptChars、recentScanLimit）。
用法
在会话中让模型调用工具 session_summarize。
| 参数 | 必填 | 说明 |
|---|---|---|
sessionId | 否 | 要摘要的会话 id；缺省时优先当前会话，再回退最近活跃落盘会话 |
lastTurns | 否 | 只摘要最后 N 轮用户消息；缺省不限制（计数单位为「用户消息」，非 assistant 消息） |
会话内调用示例（文本为占位符）：
> （在会话中输入）请用 session_summarize 汇总当前会话最近 20 轮，帮我恢复上下文。
预期输出 JSON 样例：
{
"ok": true,
"summary": "本会话围绕……展开，已确定……，待办包括……（摘要正文，占位符）",
"sessionId": "sess_xxxxxxxx",
"source": "current-agent",
"readPath": "live-sessions",
"chars": 4821
}输出字段说明：
| 字段 | 类型 | 说明 |
|---|---|---|
ok | boolean | 是否成功 |
summary | string | 摘要正文 |
sessionId | string | 实际摘要的会话 id |
source | string | 会话来源：explicit / current-agent / recent-active / none / error |
readPath | string | 读取路径：live-sessions / persistence-inspect / none / error |
chars | integer | 送入摘要模型的转录字符数（截断后） |
message | string（可选） | 失败时的错误说明 |
已知限制与契约说明
已知限制
- 转录基于派生消息（live 路径
Session.deriveMessages()）或落盘事件日志（persistence-inspect 路径inspect()的事件流），只保留 user / assistant 文本，不含工具调用内部细节。 - 长会话转录采用「保留首尾、截断中段」策略，默认预算
transcriptChars: 12000字符，超长部分以提示行替代。 lastTurns按「用户消息数」计数，assistant 消息不占用轮数上限。- live 会话仓命中时优先走
deriveMessages，否则回退落盘inspect；最近活跃会话回退时最多扫描前recentScanLimit（默认 10）个快照。 - 摘要生成依赖
ctx.llm.stream的deepseek-official路由与默认模型deepseek-v4-flash（可在cordis.patch.yml的config.model覆盖）。
契约说明
- 版本锁定：本插件按
@deepseek-ai/*@0.1.0-rc.6契约实现，依赖@deepseek-ai/cordis ^4.0.1、@deepseek-ai/dsh-llm ^0.1.0-rc.6、@deepseek-ai/dsh-session ^0.1.0-rc.6、@deepseek-ai/dsh-tools ^0.1.0-rc.6。升级依赖前需回归验证会话读取与摘要生成两条路径。 - 安装机制：依赖
dsh-app-boot的 bundle patch 约定，package.json的dsh.bundle.patch指向cordis.patch.yml，安装后自动进入 profile 的 bundle 层。 - 工具注册：用
@deepseek-ai/dsh-tools的defineTool声明工具，经注入的ctx.tools（ToolRuntime 注册表）调用register完成注册。
License
MIT，见 [LICENSE](LICENSE)。