对话总结导出 v833/dsh-chat-summary

@linxin666/dsh-client-ui-chat-summary

一个 DSH Web GUI 插件：总结当前对话，并导出为 Markdown / DOCX / PDF。

功能

- 在会话标题栏的动作行新增「总结导出」按钮。
- 拉取会话历史并生成结构化时间线（用户轮次、助手轮次及其工具调用）——纯本地，无需任何 API Key。
- 配置 LLM API Key 后，会请求宿主进程的 /chat-summary/summarize 路由生成一段 AI 总结。
- 导出为 Markdown / DOCX / PDF：
- Markdown 与 DOCX 在浏览器内生成并直接下载；
- PDF 在新窗口打开打印友好文档——在打印对话框中选择「另存为 PDF」。
- 设置卡片（设置 → 插件配置 → Web UI 插件 → Chat Summary）可配置 LLM 接口地址、模型、API Key 与导出默认项。

安装

说明：插件尚未发布到 npm，正式发布前请从本仓库安装。

在仓库克隆目录内
pnpm install
pnpm build
dsh plugin --profile web add link:$(pwd)

然后重启 dsh web 并刷新页面——会话标题旁会出现「总结导出」按钮。

配置 LLM 总结（可选）

结构化时间线开箱即用。如需 AI 总结段落，打开设置卡片填写：

| 字段 | 默认值 | 说明 |
| API Key | （空） | 宿主进程调用你的接口时使用的密钥。 |
| 接口地址 | https://api.deepseek.com/v1 | 任意 OpenAI 兼容 base URL。 |
| 模型 | deepseek-chat | 接口上的模型 ID。 |

导出默认项（是否包含工具调用、是否包含 AI 总结）也可以在这里开关。

安全模型

- LLM API Key 保存在本机设置文档中，仅宿主进程使用。浏览器半区永远拿不到它：只把对话轮次 POST 到 /chat-summary/summarize，拿回总结文本。
- summarize 路由与 GUI 共用同一个 webserver（默认仅回环地址），和其他 dsh 路由一样受部署网络暴露方式约束。
- 导出文档全部本地生成；除请求 AI 总结外，不向任何服务上传数据。
- AI 总结请求会把当前可见的对话文本发送到你配置的接口。请勿对不信任的端点开启此功能。

已知限制

- 总结仅基于当前可见的最近对话：历史窗口有上限，且长会话可能被 Harness 压缩，早期轮次可能缺失。
- DOCX 渲染会把 docx 依赖打进浏览器 bundle（gzip 后约 190 KB）。
- PDF 导出走浏览器打印对话框（无服务端渲染器）。

开发

pnpm typecheck # tsc --noEmit
pnpm test # vitest run
pnpm build # tsc -p tsconfig.build.json && tsdown

目录结构：src/core（共享纯逻辑）、src/host（node 半区：设置区段 + summarize 路由）、src/client（浏览器半区：按钮、面板、设置卡片）。

License

BSD-3-Clause。