每日工作日志 ShineFree7/dsh-daily-log

dsh-daily-log

dsh-daily-log 是 DeepSeek Harness 的每日工作日志插件。/daily 命令会生成 YYYY-MM-DD.md 和跟随系统浅色/深色主题的 YYYY-MM-DD.html 仪表盘；同时提供三个面向模型（agent）的工具用于读取、合并、列出日志。所有文件都写入配置的 outputDir，默认是 ~/.dsh/daily-log。

dsh-daily-log 是 DeepSeek Harness 的每日工作日志插件。/daily 命令会生成 YYYY-MM-DD.md 以及一个跟随主题的 YYYY-MM-DD.html 仪表盘（系统浅色/深色），还有三个面向模型的工具用于读取、合并和列出日志。所有文件都写入配置的输出目录，默认为 ~/.dsh/daily-log。

截图 Screenshots

浅色 / Light

Light

深色 / Dark

Dark

功能 Features

- /daily 一键生成当天或指定日期日志：/daily、/daily 2026-08-19、 /daily list
- 六个固定区块：done（已完成）、changes（变更）、problems（问题）、 next（下一步）、improve（改进）、takeaways（经验）
- Markdown 与 HTML 双格式；HTML 为仪表盘版并支持系统浅色/深色主题
- 模型工具：daily_log_write（按区块合并写入，覆盖前自动 .bak 备份）、 daily_log_read（结构化读取）、daily_log_list（列出已有日志）
- 支持 zh / en locale 配置

- /daily 为今天或指定日期生成脚手架：/daily、/daily 2026-08-19、 /daily list
- 六个固定区块：done、changes、problems、next、improve、 takeaways
- 同时提供 .md 和仪表盘风格的、跟随主题的 .html（系统浅色/深色）
- 模型工具：daily_log_write（按区块合并，覆盖前自动 .bak 备份）、 daily_log_read（结构化读取）、daily_log_list（列出日期，最新在前）
- 支持 zh / en locale

布局 Layout

- src/index.ts — Cordis 插件入口：注册 /daily 与三个工具
- src/daily-log.ts — 日期解析、Markdown/HTML 渲染、合并写入（.bak 备份）、读回解析、列表
- cordis.patch.yml — dsh.bundle 引用的补丁层
- scripts/smoke.mjs — 无依赖 smoke 测试（Node 24 类型剥离）
- assets/ — 浅色/深色截图

- src/index.ts — Cordis 插件入口：注册 /daily 与三个工具
- src/daily-log.ts — 日期解析、Markdown/HTML 渲染、合并写入并带 .bak 备份、读回解析、列表
- cordis.patch.yml — dsh.bundle 引用的 bundle 补丁层
- scripts/smoke.mjs — 无依赖 smoke 测试（Node 24 类型剥离）
- assets/ — 浅色/深色截图

使用 Usage

面向用户的 /daily 命令：

面向用户的 /daily 命令：

/daily # today, default output directory
/daily 2026-08-19 # a specific date (scaffold only, never overwrites)
/daily list # list existing log dates, newest first

面向模型（agent）的工具：

面向模型的工具：

- daily_log_write — 写入某天日志。合并规则：只覆盖你传入的区块，未传的区块保留原内容（首次写入时缺失区块渲染为提示占位）。即将被覆盖的文件会先备份为 YYYY-MM-DD.bak.md / .bak.html。六个区块中至少提供一项：done、 changes、problems、next、improve、takeaways。空数组视为“未提供” （不会清空区块）。返回 updated / preserved / backups 供确认。
- daily_log_read — 将某天日志读为结构化区块 + 原始 Markdown（省略 date 即今天）。
- daily_log_list — 列出输出目录中全部日志日期，最新在前。

problems 的每条可写成“问题：xxx；解决：yyy”（也可用“处理方式：”“，改用” 等自然写法）；HTML 渲染时会自动拆分为“问题/解决”两栏，没有解决方式的条目右侧显示横杠。

- daily_log_write — 写入某天日志。合并规则：只覆盖你传入的区块，未传的区块保留原内容（首次写入时缺失区块渲染为提示占位）。即将被覆盖的文件会先备份为 YYYY-MM-DD.bak.md / .bak.html。六个区块中至少提供一项：done、 changes、problems、next、improve、takeaways。空数组视为“未提供” （不会清空区块）。返回 updated / preserved / backups 供确认。
- daily_log_read — 将某天日志读为结构化区块 + 原始 Markdown（省略 date 即今天）。
- daily_log_list — 列出输出目录中全部日志日期，最新在前。

problems 的每条可写成“问题：xxx；解决：yyy”（也可用“处理方式：”“，改用” 等自然写法）；HTML 渲染时会自动拆分为“问题/解决”两栏，没有解决方式的条目右侧显示横杠。

- daily_log_write — 写入某天日志。合并规则：只覆盖你发送的内容会被覆盖；省略的区块保留其先前内容（首次写入时，缺失的区块会渲染为提示占位符）。将被覆盖的文件会先备份为 YYYY-MM-DD.bak.md / .bak.html。至少提供六个区块之一：done、changes、problems、next、improve、takeaways。空数组视为“未提供”（绝不会清空某个区块）。返回 updated / preserved / backups 以供确认。
- daily_log_read — 以结构化区块加原始 Markdown 的形式读取某一天的日志（省略 date = 今天）。
- daily_log_list — 列出输出目录中的所有日志日期，最新的在前。

每个 problems 项可以使用 “Problem: xxx; Solution: yyy”（或自然措辞，例如 “处理方式：” / “，改用” / “fixed by”）；HTML 渲染器会将其拆分为问题/解决方案对，而没有解决方案的项会在右侧保留一个短横线。

.md 与 .html 始终渲染全部六个区块，.md 同时是合并数据源。如果手工编辑破坏了生成格式，下次合并会明确报错而不是覆盖，daily_log_read 也会返回原始 Markdown 以便恢复。

Both .md and .html are always rendered with all six sections; the .md is
also the merge source. If hand edits break the generated section format, the
next merge fails loudly instead of overwriting, and daily_log_read returns
the raw Markdown for recovery.

配置 Configuration

在 profile 的 cordis.patch.yml 中覆盖输出目录与语言：

Override the output directory and language from the profile's
cordis.patch.yml:

- id: dsh-daily-log
config:
outputDir: 'D:\\dsh\\workspace\\daily-log'
locale: zh # 'zh' (default) or 'en'

outputDir 默认为 ~/.dsh/daily-log（不会使用 process.cwd()）；locale 控制区块标题、工具描述、命令输出和渲染文档的语言。

outputDir defaults to ~/.dsh/daily-log (never process.cwd()); locale
controls section labels, tool descriptions, command output, and the rendered
documents.

本地开发 Local development

包面向 Node >= 24，直接通过原生 TypeScript 类型剥离加载 src/index.ts，本地链接无需构建步骤。运行 pnpm smoke 执行 smoke 测试；类型检查先
pnpm install，再 pnpm typecheck。

The package targets Node >= 24 and loads src/index.ts directly through native
TypeScript type stripping, so no build step is required for local links. Run the
smoke test with pnpm smoke. Type checking needs pnpm install first, then
pnpm typecheck.

安装到 profile：

Install into a profile:

dsh plugin --profile web add /absolute/path/to/dsh-daily-log