dsh-diary · 日记插件
dsh（DeepSeek Harness）的日记插件：在一个纸感信纸风的 web 页里写日记，原文先落盘、AI 评注后生成——总结失败永远不会丢你的字。
English · 使用指南（装好后页面右上角 ?，或 /diary/guide）
界面预览
| 日常写作（亮色） | 暗色 |
|---|---|
| 首次使用·设置卡 | 内置使用指南（中/EN） |
|---|---|
分工
| 谁 | 负责 |
|---|---|
| 插件代码（确定性） | 30 小时制日期判断（读系统时间）、按模板建档、条目追加、评注区排版、时间戳收尾、再提交时旧评注摘除 |
LLM（经 ctx.llm 直调） |
只产四样东西：【今日关键词】【一句话总结】【当日 emoji】【评注】——provider/model/temperature 默认取插件配置；页面「AI 评注模型」选择器可逐次覆盖 provider/model（仅采纳模型目录里存在的组合，其余静默回退默认）。另在评注落盘后产出一份新的用户画像全文（同一套路由，见「长期记忆」） |
快速上手
git clone https://github.com/zhm20001/dsh-diary.git
cd dsh-diary
pnpm install # lib/ 产物随仓库提交，无需 build
dsh plugin --profile web add <本目录路径>
# 重启 dsh web，浏览器打开 http://127.0.0.1:/diary
首次打开页面是设置卡：填一个日记目录（如 ~/Documents/日记，~ 会展开），保存即写入插件根 config.json，立即生效、无需重启。然后写第一篇 → 点「保存并生成总结」。
日常流程：打开页面 → 写 → 提交。原文即刻落盘；总结失败不丢原文，点「仅重试总结」补生成。草稿自动存浏览器 localStorage（按日期分键）。dsh web 侧栏底部也有「日记」入口（src/client.js，文案中英自适应）。每次提交还会静默更新一份用户画像（见「长期记忆」），失败只在页面给一条不影响保存的提示。
配置
三层优先级（高 → 低）：
| 层 | 说明 |
|---|---|
| cordis patch / profile config | 装载时注入，最高优先；此处设了 diaryDir 时页面设置卡会提示「被覆盖」 |
插件根 config.json |
页面设置卡与 prompt 卡维护的就是它；手工编辑也行，逐请求现读、改完即生效。字段见 config.example.json，相对路径按插件根解析、支持 ~/（summaryPrompt 为原文存取的文本键，不做路径处理） |
| 内置默认 | 模板兜底 assets/diary-template.md；无目录则进入设置卡模式；评注 prompt 兜底为内置默认 |
自定义评注 prompt：「AI 评注模型」选择器旁的 📝 打开 prompt 卡——阅读驱动 AI 评注的系统提示词，可编辑、保存、「恢复默认」；存 config.json 的 summaryPrompt，即时生效（优先级同上表）。保存时校验输出契约：【今日关键词】【一句话总结】【评注】三个标记必须保留（【当日 emoji】行可删，删后当日格子降级绿块）；自定义只影响之后的总结，已写入日记的评注块不变。cordis patch 塞入的坏 prompt 会在总结时响亮报错（不静默回退）。
其余插件项（cordis patch 层）：provider / model（总结模型，默认 deepseek-official / deepseek-chat）、temperature（0.6）、timeoutMs（120000）、nightCutoff（6）、pagePath（/diary；改动需同步 src/client.js 里的 href）、summaryPrompt（评注 prompt 覆盖）。
长期记忆（用户画像）
每次保存日记时，系统在总结之外并行维护一份用户画像——纯文本 markdown，存在日记目录的 .diary-meta/profile.md，与 emoji 元表相邻但概念独立，可以直接翻开看。
- 注入：生成当日总结前，画像全文与近一周记录日的概要（记忆窗口 = 今天 + 前 6 个记录日，每日「关键词 + 一句话」，从往日日记的评注块提取，零额外调用）作为参考数据拼进总结请求；当天日记全文仍是唯一主体。画像缺失或为空时自动省略该节，总结照常。
- 更新：评注落盘后立刻发起一次独立的画像更新调用（旧画像全文 + 当天日记全文 → 新画像全文），同步完成、随响应返回前写完磁盘。画像按「人格核心 / 阶段性状态 / 近期事件」三分层维护，更新规则内置固定（近期事件超期无复提由模型裁决去留、容量有硬上限），用户不可编辑——你能改的是评注 prompt（怎么用上下文），改不了的是更新规则（怎么改画像）。
- 失败语义：画像更新失败不影响保存与总结——接口仍返回 200，页面显示一条「画像更新失败，不影响保存」的提示；无重试入口，下次提交天然自愈。总结失败仍走既有 502 路径，且不触发画像更新。
- 全量重算：设置卡里的「从历史生成画像」按钮，仅在检测不到画像文件时可点（有画像即禁用，永不覆盖维护中的画像）；点击弹成本警告并二次确认后，从全部历史日记按时间顺序分块累积生成初始画像。换机器 = 拷贝
.diary-meta/profile.md。
整套功能没有开关、没有新配置键：每日 LLM 用量约翻倍（多一次画像更新调用 + 总结多带一份画像），单用户场景绝对值可忽略。日记原文永远不被「遗忘」改动——画像是可重算的派生状态。
隐私与数据
- 日记全文只落本地盘；唯一的外发是总结请求：当日全文 + 用户画像 + 近一周概要发给你配置（或页面选择）的 LLM provider，换取四件套（画像更新调用同样只在本机与 provider 之间往返）。热力图数据、meta、草稿都不出本机（草稿在浏览器 localStorage）。
- 数据自包含在日记目录：正文
YYYY-MM-DD.md，当日 emoji 在同目录隐藏文件夹.diary-meta/YYYY.json，用户画像在同文件夹profile.md。备份 = 整个目录复制（迁移别漏.diary-meta/，否则 emoji 静默降级成绿块、画像回到冷启动）。 - 「有没有写」永远由目录文件名当场派生（含
-后缀文件），不落缓存：手建/手删/改名即时反映到热力图；meta 里的孤儿 emoji 会被无害忽略。
语义细节
- 30 小时制：凌晨 0 点到
nightCutoff（默认 6）之间写的算前一天，收尾时间显示 25:xx–29:xx——深夜补记不会劈成两个文件。 - 同日再提交 = 追加新条目并重新生成整天总结（旧评注块被摘除重写，其上的用户内容永远不动）。约定：不要手工编辑「## AI评注」之下的区域。
- 文件契约：
/YYYY-MM-DD.md，front matter 来自模板（支持空date:字段或{{date}}占位）；同日2026-04-28-note.md这类后缀文件也计入 4-28，同日多文件不重复计数。 - 总结失败时接口返回
stage:'summary'+ hint（HTTP 502）；保存失败返回stage:'save'。 - 热力图板：半年一帧（上=1–6月，下=7–12月），固定 27 周 × 7 格、周一起始，帧窗口从半年首日所在/之前的周一开始，相邻帧共享边缘周（冗余明确允许）。已写=当日 emoji（无则绿块）、已过未写=淡底、未到=灰、今日加描边；分母为该半年实际天数。极少数年份（7月1日逢周日，如 2018/2029）H2 窗口 190 天超出 27 周，12-31 那格不显示（计数不受影响）。
- 往期日记补评注 / 换目录迁移 / 删除某天：见页面内置指南「你的数据」一节。
本地开发
pnpm install
pnpm typecheck
pnpm test # vitest：core 纯函数 + 路径解析 + 原子写
pnpm build # 重新生成 lib/（CI 会校验产物与 src 无漂移）
# 冒烟：dev overlay 把插件指向 /tmp/diary-sandbox，不污染真实日记
dsh web --patch dev.patch.yml # 浏览器访问 /diary-dev
结构：src/core.ts 纯函数（无 IO）→ src/paths.ts 路径变量（config.json 读写）→ src/service.ts 路由与编排（webServer/httpServer 双名兼容）→ src/summary.ts 总结 LLM 管线 → src/profile.ts 长期记忆（画像读写 / 注入组装 / 更新回路 / 全量重算）→ src/page.ts 页面 + src/guide.ts 指南。lib/ 为编译产物、随仓库提交（克隆分发免构建）；src/ 改动必须带 lib/ 一起提交。
宿主要求：dsh web 宿主（内部 harness 版暴露 ctx.webServer，npm @deepseek-ai/dsh-host-webserver rc 线暴露 ctx.httpServer——两者均兼容）。
License
MIT
