前言¶
在 DSH 里做开发或日常协作时，任务往往分散在聊天、笔记和外部待办工具之间；Agent 能帮你写代码，却未必能稳定读写同一份「今天要做什么」的清单。若把跟踪面板做成独立 SaaS，又引入账号、同步和隐私成本。下面介绍维护者 vogtersea 发布的客户端插件 dsh-worklog：在 Harness 侧边栏挂载「工作志」，数据落在本机单个 SQLite 文件，并向 Agent 注册五个读写工具，使人与 AI 共用同一套工作项。
这是什么¶
dsh-worklog 是 DeepSeek Harness 的客户端类插件（社区目录：vogtersea/dsh-worklog）。定位是「在 DSH 里直接可用的个人工作跟踪面板」：自带全部功能，不依赖外部服务，也无需另装数据库。源码托管于 GitHub，许可证 MIT；package.json 中当前版本为 0.2.0，要求 DSH 引擎 >=0.2.1-rc.3。
核心功能¶
面板视图¶
插件提供多视图管理同一批工作项（README 中的能力表）：
| 视图 | 说明 |
|---|---|
| 仪表盘 | 逾期 / 今日到期 / 临期 / 本周 / 无截止日期 五个分桶 |
| 周视图 | 一周七天各列一处，按截止日期落位，今天高亮 |
| 工作详情 | 标题、详情、完成条件、优先级、项目、标签；可追加进展记录 |
| 例行 | 每周/每月模板，按周期自动生成本期任务，同一周期不重复生成 |
| 项目 | 把工作归到项目下 |
| 归档 | 已完成的全部留存 |
界面采用服务端渲染 + 同源 iframe 嵌入插件路由，无独立前端构建步骤；支持深色模式（实现见 lib/views.js）。
Agent 工具¶
插件向 Agent 注册 5 个工具，AI 与面板读写同一份 SQLite 数据：
| 工具 | 用途 |
|---|---|
worklog_list |
按周、状态、关键词列出工作项 |
worklog_add |
新建一条工作 |
worklog_done |
标记完成 |
worklog_progress |
追加进展记录 |
worklog_summary |
概览各分桶数量 |
README 说明：报告类汇总不调用外部模型，由 DSH 的 Agent 通过上述工具完成。
数据存放¶
数据路径（尊重 DSH_HOME，多 profile 互不干扰）：
~/.dsh/worklog/worklog.db
单个 SQLite 文件，WAL 模式；备份即复制该文件。存储层使用 Node 自带的 node:sqlite（lib/store.js），无原生编译依赖。
安装与启用¶
在目标 profile 下执行官方 README 中的安装命令：
dsh plugin --profile <profile> add dsh-worklog
若在本仓库目录内做本地链接安装：
dsh plugin --profile <profile> add link:.
安装完成后，侧边栏会出现「工作志」一行。插件通过 cordis.patch.yml 将条目写入 profile 的插件表；客户端注入 @deepseek-ai/dsh-client-ui-slots，平台为 web。
典型用法¶
- 人工维护：在侧边栏打开工作志，在仪表盘或周视图查看分桶与截止日，进入详情编辑优先级、项目、标签并追加进展。
- 例行任务：配置每周/每月模板，由插件按周期生成本期任务（同一周期不重复生成）。
- Agent 协作：在对话中让 Agent 调用
worklog_list/worklog_add/worklog_progress等工具，与你在面板上的操作保持一致。
维护者在仓库中提供了本地调试与验收入口（开发时可选）：
node test/dev-server.mjs # http://127.0.0.1:8091/worklog-plugin/app
node test/integration.mjs
node test/acceptance.mjs
适用场景与注意¶
适合：已在 DSH 中常驻工作的个人开发者，希望任务清单、进展与 Agent 工具链在同一进程生态内闭环，且接受本地单文件存储与自行备份。
设计取舍（README 原文）：单用户场景，无多用户与登录；未实现 Word 导出、Obsidian 集成与外部推送；本质不依赖外部系统。
安全与信任：插件以当前 DSH 进程权限运行，可读写 ~/.dsh/worklog/worklog.db 并在 UI 中展示数据。安装前请阅读 源码与 LICENSE，确认符合你的环境与合规要求。SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；Harness 生态遵循「一切皆插件」，本插件是其中一项客户端扩展。
结尾¶
dsh-worklog 把个人工作跟踪收进 DSH 侧边栏，用本地 SQLite 与五个 Agent 工具对齐人机视图。进一步了解可访问目录页 skillhub.cn/plugins/vogtersea/dsh-worklog 与仓库 github.com/vogtersea/dsh-worklog。
