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 模块都会在启动时自动注册。 卸载：dsh plugin --profile web remove dsh-worklog。

使用

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

配置

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

项	默认	说明
模型接口格式	dsh	dsh（内置默认模型）/ openai（OpenAI 兼容）/ anthropic
Base URL	—	外部接口地址（openai/anthropic 时）
API Key	—	留空则回退环境变量/凭据库 GJSL_API_KEY
Model Name	—	外部模型名
上下文窗口	0	输入上下文窗口 tokens（不影响输出上限）
摘要 Prompt	内置	可自定义，界面展示默认结构
主动模式	开	每个有新活动的日期即时补摘要

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

见 bundle.gui.patch.yml：时区偏移、扫描间隔、静默阈值、输出上限、摘要并发等。

数据与缓存

• 数据目录：$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