dsh-session-summarizer

LIMITATIONS

Known limitations

### 已知限制 - 转录基于派生消息（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` 完成注册。