hyperMoss/dsh-diary

dsh-diary

一个 DeepSeek Harness 插件，为 agent 提供一个
每日 markdown 日志：创建条目、管理生成的 .md 文件、使用自定义模板，并可通过网页设置区域进行
全部配置。

它新增了什么

十个面向模型的工具，注册在 ctx.tools 上：

| 工具 | 用途 |
|---|---|
| diary_create | 创建新条目（YYYY-MM-DD[-slug].md），可选标题、标签、正文和指定模板 |
| diary_list | 列出带元数据的条目，可按年/月、标签或标题/文件名子串筛选 |
| diary_read | 读取某个条目的 frontmatter 和完整正文 |
| diary_update | 替换或追加正文，和/或修改标题和标签 |
| diary_delete | 删除某个条目文件 |
| diary_search | 在条目正文中进行全文搜索，返回行号和片段 |
| diary_template_list | 列出可供 diary_create 使用的模板 |
| diary_template_read | 读取某个模板的完整内容 |
| diary_template_set | 创建或覆盖模板 |
| diary_template_delete | 删除模板 |

自定义模板

模板是位于 /templates/ 下的 markdown 文件。diary_create 接受一个
template 名称，并在模板正文中替换以下占位符：

{{date}} {{title}} {{tags}} {{slug}} {{year}} {{month}} {{day}} {{datetime}} {{time}}

当同时向 diary_create 传入 template 和 content 时，渲染后的模板正文在前，
content 会在一个空行之后追加在后面。

网页 GUI

该插件附带一个浏览器端部分（lib/client.js，通过 /plugins/dsh-diary/client.js 提供），包含两个
界面：

- 一个 「日记」设置区域：显示日记/模板目录，并可列出、创建、编辑和
删除模板；
- 一个 日记看板 (diary board)：一个独立面板（自带浮动切换按钮，📓），按月份分组列出
条目，带有一个 「新建日记」 按钮以及每个条目的删除操作。

两者都由一个 diary Typert Remote 命名空间支撑，暴露在 /api/diary/ 下：
getDirectory、listTemplates、getTemplate、setTemplate、deleteTemplate、listEntries、
getEntry、createEntry、deleteEntry。

存储

条目是带有可选 YAML frontmatter 的 markdown 文件：

title: My day
date: 2026-08-14
tags:
- work
- life

Today I …

默认情况下，它们位于 $DSH_HOME/diaries 下（回退到 ~/.dsh/diaries）。可在 profile 的
cordis.patch.yml 中覆盖目录：

- insert:
- id: dsh-diary
name: 'dsh-diary'
config:
directory: '/Users/me/Diary'

默认每个日期一个条目；向 diary_create 传入 slug 可在同一天保留多个条目
（文件会变为 YYYY-MM-DD-.md）。

安装

将已发布的 dsh-diary 包安装到 web
profile 中：

dsh plugin --profile web add dsh-diary
然后重启 Web 服务器，使新层（工具 + 设置部分）生效。

开发

pnpm install      # 链接 @deepseek-ai/ 宿主端 + 客户端包以进行类型检查
pnpm run build    # esbuild → lib/index.js（宿主端）+ lib/client.js（浏览器端）+ 声明文件
pnpm run typecheck
node smoke.mjs    # 对十个工具进行功能性冒烟测试