dsh-worklog

dsh-worklog · DSH 工作日志日历

English · 中文

把你在 DSH 里的所有聊天（跨工作区、跨 SSH 路由、含已结束会话）自动整理成工作日志：

• 按对话节点切片——每一轮「用户发消息 → 模型完成」是一个节点，逐节点生成摘要；
• 日历视图按天统计会话量与时长，点选日期/区间即可查看、勾选并生成日报 / 周报 / 月报 / 半年总结；
• 摘要走指纹缓存 + 增量重算：节点内容没变就复用，会话有新活动只补新增节点，不重复烧 token；
• 会话在报告里仍作为一个整体项目聚合（跨天也不散）。

特性

• 全量汇总：ctx.sessionQuery 读取本机与 SSH 路由上所有会话（含已结束）。
• 对话节点级摘要：颗粒度精细到每一轮对话，按本地日期归属。
• 主动 / 手动摘要：主动模式即时补摘要；工作台提供「生成摘要（节点切片）」按钮，按需强制重算。
• 独立 LLM 配置：支持 DSH 内置、OpenAI 兼容、Anthropic 三种接口，可配 baseUrl / apiKey / model / 上下文，摘要 prompt 可自定义。
• 报表：日历选区间 → 勾选条目（支持全选/全不选）→ 生成 markdown 报告，可复制。
• 模型工具：worklog_status / day / range / report / rescan，任意会话可用。

安装（官方方式）

前置：DSH（deepseek-harness）+ Node ≥ 22。

dsh plugin --profile web add github:aijunjiang/dsh-worklog
# 或本地路径：dsh plugin --profile web add <本仓库路径>

pnpm dsh web   # 重启一次即可，无需其它参数

安装后重启一次 dsh web：宿主插件（扫描/摘要/工具）与「工作台」client 模块都会在启动时自动注册——bundle.gui.patch.yml 已内置 insert id: worklog，无需手动改 profile。 卸载：dsh plugin --profile web remove dsh-worklog。

使用

1. 工作台：任意会话头部视图切换里点「工作台」页签 → 月历显示每天会话量/分钟。
2. 看某天：点一个日期看当天条目（默认收起，点「展开 N 个节点」看该日节点级摘要）；点两个日期选区间。
3. 生成报告：选好区间 → 「全选/全不选」或逐条勾选 → 选报告类型（日报/周报/月报/半年）→ 「生成报告」。
4. 补摘要：选日期后点「生成摘要（节点切片）」按需重算。
5. 设置：设置 → 插件 → 插件配置 →「工作日志」，配置摘要模型与 prompt、主动模式。

配置

摘要设置（设置 → 插件 → 工作日志）

行级配置（profile cordis.patch.yml）

宿主 row 已由 bundle patch 自动 insert（零 config 走默认值）。要覆盖默认值（时区偏移、扫描间隔、 静默阈值、输出上限、摘要并发等），在 profile 的 cordis.patch.yml 里按 id 覆盖：

- id: worklog
  config:
    timezoneOffsetMinutes: 480   # 时区偏移（分钟），默认 480（UTC+8）
    scanIntervalMs: 300000       # 语料扫描间隔（毫秒）
    autoSummarize: true          # 会话结束后自动 LLM 摘要

全部可用键与默认值见 src/config.js。

数据与缓存

• 数据目录：$DSH_HOME/dsh-worklog/items.json（默认 ~/.dsh/dsh-worklog）。
• 每个会话存 nodes[]：节点摘要带内容指纹；指纹不变则复用，变了才重算 → 增量、省 token。

目录

src/index.js       宿主插件入口（扫描/摘要/工具/通道）
src/summarize.js   节点级摘要队列（指纹缓存 + 增量）
src/transcript.js  对话节点切片 + 指纹哈希
src/llm.js         摘要 LLM 调用（DSH/openai/anthropic）
src/report.js      报表组装（按日期筛选节点）
src/endpoints.js   /dsh-worklog GUI JSON-RPC 端点
src/client/index.ts 浏览器端：工作台 + 设置卡片
lib/client.js      编译产物（随仓库提交，无需本地构建）
tests/             单测（node --test）

开发

npm test            # 单测
npm run build:client  # 用 harness tsdown 管线重建 lib/client.js

卸载

dsh plugin --profile web remove dsh-worklog

License

MIT