chengzhicao/llm-capture

LLM Capture 是 DeepSeek Harness Web 的调用日志插件。它在会话页面增加独立的 LLM Capture 标签页，用于查看模型请求、消息、返回内容、Token 用量、耗时和工具调用。

功能

• 按 Session 记录完整的 LLM 请求与响应。
• 展示模型、Provider、耗时、Token 用量和完成原因。
• 支持请求、消息、返回和原文四种详情视图。
• 支持全文搜索、手动刷新和清空当前 Session 的日志。
• 每个 Session 独立编号，新 Session 从 #1 开始。
• 日志持久化到本地，重启 DSH 后仍可查看。

安装

LLM Capture 需要 DeepSeek Harness Web 和 Node.js ^22.19.0 || >=24.0.0。

dsh plugin --profile web add github:chengzhicao/llm-capture

安装完成后启动 Web：

dsh web

需要卸载时执行：

dsh plugin --profile web remove dsh-llm-capture

使用

1. 打开或创建一个会话并发起模型调用。
2. 点击会话顶部的 LLM Capture 标签页。
3. 在左侧选择一次调用，在右侧查看请求、消息、返回或原文。
4. 使用搜索框过滤当前 Session 的请求和返回内容。
5. 点击“清空”会清除当前 Session 的内存记录，并将对应日志文件覆盖为空数组；其他 Session 不受影响。

日志存储

日志默认保存在 DSH 的用户数据目录下，不随启动命令所在目录变化：

$DSH_HOME/llm-capture-data/

未设置 DSH_HOME 时，DSH 会使用默认 Harness home（通常为 ~/.dsh）。

每个 Session 对应一个 JSON 文件。日志文件包含完整提示词、消息、工具参数和模型返回，请勿提交到版本库或发送给不受信任的第三方。

可以在 $DSH_HOME/cordis.patch.yml 中覆盖存储配置：

- id: llm-capture
  config:
    directory: !!js dshHomePath('llm-capture-data')
    capacity: 500
    flushDelayMs: 400

配置项	默认值	说明
directory	dshHomePath('llm-capture-data')	日志目录；默认位于 $DSH_HOME，相对路径仍基于 DSH 的工作目录解析
capacity	500	每个 Session 在内存和磁盘中保留的最大记录数
flushDelayMs	400	合并连续磁盘写入的等待时间，单位为毫秒

修改配置后重启 DSH 生效。默认目录调整后，旧的 tmp/llm-capture-data 不会自动迁移；如需保留旧日志，请手动移动到 $DSH_HOME/llm-capture-data。插件不会自动迁移自定义目录中的旧日志。

工作方式

Host 插件监听 llm/stream，在不改变模型输出的前提下收集请求和流式返回，并按 Session 写入 JSON 文件。Web Client 通过 llmLog Remote 接口读取和清空记录，不直接访问主机文件系统。