前言¶
在 Harness 里做开发，事务往往散落在对话、终端和临时笔记里；到了周五写周报，只能靠回忆拼凑，容易漏项、措辞也费时间。常见做法是单独开一个 Markdown 或 Notion 页面记流水账，再在别处套模板——数据与 IDE 脱节，和 Agent 对话也无法直接「记一条」「生成本周报告」。下面介绍维护者 doombeaker 的客户端插件 dsh-weekly-log（npm 包名 dsh-weekly-log）：在 DSH 侧栏维护按 ISO 周组织的工作条目，一键导出周报 Markdown，并可选用 Harness 已配置的模型润色措辞；提供 weekly_log、weekly_report 两个 Agent 工具，插件本身不需要 API Key。
这是什么¶
dsh-weekly-log 是 DeepSeek Harness 的 profile 级插件（分类：客户端）。它在侧栏提供「周报 / 周志」面板，用一行一条的方式记录「已完成」或「计划」；支持按周浏览、计划顺延（carry-forward）并保留痕迹、中止项不入报告；可将「上周已完成 + 本周计划」渲染为固定模板的周报，并可选一键 AI 润色。条目持久化在 ~/.dsh/weekly-report/data.json（即 $DSH_HOME/weekly-report/data.json），跨工作区共享；导出的报告为纯 Markdown，默认写到当前工作区下的 reports/weekly-<ISO week>.md（目录可在设置中改）。
仓库：https://github.com/doombeaker/dsh-weekly-log
社区目录：https://www.skillhub.cn/plugins/doombeaker/dsh-weekly-log
当前资料中的版本为 0.1.0，许可证 MIT，要求 dsh >= 0.2.0。
核心功能¶
侧栏面板¶
- 侧边栏入口，一行一条事项；可切换任意 ISO 周，当前周有标记，「回到当前周」可快速归位。
- 录入时选择 完成（done，默认）或 计划（plan），回车保存；可先切到未来周再录入，把计划归到该周。
- 对计划可执行 完成 / 顺延 / 中止：顺延会改条目所属周并在历史中留痕（例如上周仍显示「顺延到第 46 周」，本周计划侧保留同一事项）；中止项仍可见但不会进入导出报告。
导出与润色¶
- 生成报告：以所选周为「本周」，其前一周为「上周」；模板含
Name:、Last week:、This week:，每项一行-列表。 - 规则：上周工作 = 该周
state为done的条目；本周工作 = 该周当前为plan的条目（含顺延进来的）。 - AI 润色：调用 Harness 里已配置的默认模型整理用语、长度和错别字；结果与草稿对照，可自行采纳或丢弃。无默认模型时面板会提示，仍可手工编辑与复制保存。
Agent 工具（2 个）¶
在对话中可使用 weekly_log、weekly_report，对应「记一条」「这周记了什么」「生成报告」等意图。面板与工具共用同一套 lib/impl.js 实现（含 POST /weekly/api）。
条目数据模型（摘要）¶
| 字段 | 含义 |
|---|---|
text |
一行描述 |
state |
plan / done / aborted |
week |
所属 ISO 周，如 2026-W45 |
day |
最近一次状态变更日期 |
tag |
可选标签，不参与报告分组 |
link |
可选链接，导出时附在行末 |
history |
创建 / 完成 / 中止 / 顺延 / 移动等痕迹 |
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议在 GitHub 查看源码与 MIT 许可证。安装命令以 README 为准：
plugin_manager install_bundle target=dsh-weekly-log
成本与前置：插件不单独要 API Key。「AI 润色」走 Harness 已配置的模型，费用按该模型计费。设置页会显示运行版本，并提供「检查更新」；从 npm 安装的 bundle 可通过 pluginManager.updateBundle 原地升级（失败会回滚）。本地 link: 安装无法自助升级，面板会说明而非静默失败。
典型用法¶
- 记流水：在面板输入一行，选「完成」或「计划」，回车。工作中随手记，避免周末回忆。
- 翻周与处理计划：用周切换条查看历史或未来周；对未完成计划做完成、顺延或中止。
- 出周报：点「生成报告」，需要时再点「AI 润色」，然后复制或保存 Markdown。
- 在对话里操作：让 Agent 调用
weekly_log写入、weekly_report生成，与面板数据一致。
导出路径默认：
<当前工作区>/reports/weekly-<ISO week>.md
若希望报告进 git，可在设置里把导出目录指到仓库内路径；条目 JSON 本身不跟工作区走，也不进 git。
适用场景与注意¶
适合：需要按 ISO 周整理个人工作清单、定期输出结构化周报 Markdown 的 Harness 用户；希望在侧栏与对话两端都能记与导出的场景。
注意：
- 面板界面目前仅中文（商店 locale 含中英文元数据）。
- AI 润色依赖 Harness 已配置默认模型；未配置时只能手工编辑。
- 数据存在 profile 级 JSON，不按工作区隔离；多机需自行同步
~/.dsh/weekly-report/data.json。 - 存储为插件自有 JSON 文件，而非框架 KV 域（profile 安装的插件无法解析
@deepseek-ai/dsh-storage-domain）。
已知局限（来自 README）：同上语言与模型依赖；数据不随工作区、不进版本库，需自行规划导出目录与备份。
结尾¶
dsh-weekly-log 把「边做边记」和「按周导出 + 可选润色」收进 Harness 客户端：一条安装命令、侧栏面板、两个 Agent 工具，不额外绑定 API Key。进一步了解用法与发布说明见仓库 README 与 docs/PUBLISHING.md。
- 社区目录：https://www.skillhub.cn/plugins/doombeaker/dsh-weekly-log
- GitHub：https://github.com/doombeaker/dsh-weekly-log
