前言¶

在 DeepSeek Harness（DSH）里写代码、调模型时，手头事项往往散在对话、便签和脑子里，换一台机器或隔一周再想「那天做了什么」常常对不上。通用待办工具要账号、要同步，和 DSH 会话也脱节。维护者 EastChilde 的 dsh-worklog 是 DSH 生态下的工作记录插件（社区目录分类：记忆），把任务按天挂在本地 JSON，面板看月历与列表，装好后还可通过 4 个 Agent 工具在对话里让模型代记，数据不联网。

下面介绍它解决什么问题、能做什么、怎么装、典型用法和注意事项。事实以 GitHub 仓库 README 与 SkillHub 目录页 为准；DSH 社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系。

这是什么¶

dsh-worklog（npm 包名 dsh-worklog，当前资料中的版本为 0.2.0，许可证 MIT）面向 DSH 桌面 profile 用户：按天记录任务标题与备注，四档状态、项目归类、三档优先级，用月历和「未完成 / 全部」视图回溯；服务端与 Agent 工具共用 core.js，写入同一份本机 tasks.json。插件以当前 DSH 进程权限运行，安装前宜自行查看源码与许可证。

核心功能¶

按天记录与状态¶

每条任务挂在某一天，含标题、备注；状态为 待开始 / 进行中 / 已完成 / 已阻塞。面板里可点圆圈完成或取消，点状态胶囊按上述顺序循环；备注默认可折叠，编辑时支持多行。新建任务默认记在当天。

项目归类与优先级¶

任务可挂项目（下拉或「＋ 新建项目…」），未选则为「未归类」；项目颜色由名称哈希生成，无需额外配置。筛选项目时日历、明细与顶部统计同步变化。「管理项目」支持改名（同名则合并）或删除（任务退回未归类）。优先级为 低 / 中 / 高（默认中）；「未完成」视图按高→中→低排序，同优先级按日期。

工具栏与月历¶

日历上方：未完成 N（默认）与 全部 M 为与关系，并可按项目筛选。未完成项按记录日期从早到晚，过期未完成日期标红；全部记录从新到旧；两视图不受当前月份限制。月历格显示当天完成、进行中、阻塞数量；点某一天可只查看该日，再点或点 × 取消。统计含本月完成、当前进行中、连续记录天数（每天至少完成 1 条计一天），随项目筛选变化。

Agent 工具（对话里代记）¶

安装并重启 DSH 后，模型可调用以下工具（与面板写同一文件）：

示例说法（摘自 README）：「记一下，今天跟完供应商合同，放供应链改造」；「把这周供应链改造还有什么没做完？」

入口¶

视宿主槽位而定，可能同时出现：会话头部「◷ 记录」抽屉、右侧栏「◷ 工作记录」标签、设置 → 工作记录整页。

安装与启用¶

从 GitHub 安装（换机、多机推荐）¶

在 PowerShell 中执行官方命令，装完重启 DSH：

dsh plugin --profile desktop add "github:EastChilde/dsh-worklog"

更新时向仓库推送后，再执行同一条 add 即可。

从 Gitee 安装（国内网络）¶

仓库镜像：https://gitee.com/EastChilde/dsh-worklog。README 说明需先 clone 到本地，再以 link: 安装（dsh plugin add 认 npm 包名 / github:owner/repo / link:本地目录）。用户若按 README 操作，需自行 clone 后：

dsh plugin --profile desktop add "link:$env:USERPROFILE/dsh-worklog"

无 dsh 命令时¶

可在「设置 → 插件市场 → 自定义安装」粘贴本地目录路径，效果与 link: 相同。

卸载（不删数据）：

dsh plugin --profile desktop remove dsh-worklog

数据位置与备份¶

插件程序与数据分离。任务文件默认：

%USERPROFILE%\.dsh\dsh-worklog\tasks.json

若设置了 DSH_HOME，则为 $DSH_HOME\dsh-worklog\tasks.json；面板底部会显示真实路径。备份或迁移机器时复制该文件即可；写入采用临时文件加原子改名。持久化 JSON 中任务 status 等字段与面板中文档口径以 README 示例为准（如示例里 done 表示已完成）。

典型用法¶

1. 重启 DSH 后，从「◷ 记录」或设置页打开面板，选「未完成」，按项目筛选，在当天格子下新增任务并设优先级。
2. 用月历点某一天，核对该日完成与阻塞数量；需要时在列表里点状态胶囊推进进度。
3. 在会话中直接说：「记一下，今天某某事项，项目某某」——由模型调用 worklog_add；查进度用 worklog_list 或 worklog_projects。

排错时可看宿主日志：出现 [dsh-worklog] 已就绪，数据文件：… 表示路由就绪；另有 已注册 4 个 Agent 工具。无工具日志时面板仍可用，但对话代记可能不可用，日志会给出原因。

适用场景与注意¶

适合需要在 DSH 同一环境里留存「按天、按项目」工作痕迹、又不想依赖云端待办的开发者。不适合多人协作看板或跨设备自动同步——多机需自行复制 tasks.json。

安装插件即信任其在本机读写上述路径；宜在 GitHub 审阅 lib/、client/ 后再用于工作机。改 lib/index.js 或客户端 bundle 后通常要重启 DSH；仅改 lib/core.js 时 README 提供 POST …/dsh-worklog/reload 热重载方式（端口以本机 DSH 为准）。

结尾¶

dsh-worklog 把「记任务、看月历、筛未完成」收进 DSH，并用四个 Agent 工具与面板共享存储，适合本地、轻量、可对话补充的工作记录。目录与源码：

• SkillHub：https://www.skillhub.cn/plugins/EastChilde/dsh-worklog
• GitHub：https://github.com/EastChilde/dsh-worklog