前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。zhm20001 提供的 dsh-diary 插件针对需要长期记录与 AI 辅助总结的场景。它提供了一个纸感信纸风格的 Web 页面，核心逻辑是先保存用户输入的原文到本地磁盘，再调用 LLM 生成评注。这种设计确保了即使 AI 总结失败，用户的原始内容也不会丢失。
核心功能¶
- 原文落盘与 AI 评注分离：原文提交后立即落盘；AI 评注（关键词、总结、Emoji、评注文本）在后台生成，失败不影响保存。
- 30 小时制日期处理：插件读取系统时间。在
nightCutoff（默认 6 点）之前写入的内容会被归类为前一天，时间戳显示为 25:xx 至 29:xx，避免深夜补记将同一天的记录劈成两个文件。 - 模板化建档与追加：支持按模板建档，同日多次提交会追加条目并重新生成当天的总结（旧评注块会被摘除重写）。
- LLM 直调：通过
ctx.llm调用，产出今日关键词、一句话总结、当日 emoji 和评注。 - 长期记忆（用户画像）：每次保存日记时，系统会并行维护一份用户画像，存放在日记目录的
.diary-meta/profile.md中。画像会参考近一周的概要进行更新。 - 热力图与草稿：生成基于时间的热力图（半年一帧），草稿自动存入浏览器 localStorage。
安装与启用¶
安装步骤如下：
git clone https://github.com/zhm20001/dsh-diary.git
cd dsh-diary
pnpm install
dsh plugin --profile web add <本目录路径>
安装后重启 dsh web，浏览器访问 /diary。
典型用法¶
- 首次使用：打开页面会显示设置卡，需填写日记目录（如
~/Documents/日记），保存后配置写入config.json，立即生效。 - 日常写作：在页面输入内容并提交，原文即刻落盘。若总结生成失败，可点击“仅重试总结”补生成，原文不会丢失。
- 草稿保存：未提交的内容会自动存入浏览器 localStorage，按日期分键。
配置与进阶¶
- 配置优先级：三层优先级（高到低）：cordis patch / profile config > 插件根
config.json> 内置默认。 - 自定义 Prompt：在页面“AI 评注模型”选择器旁打开 prompt 卡，可编辑系统提示词（
summaryPrompt），保存后即时生效。 - 长期记忆逻辑：生成总结前，画像全文与近一周概要作为上下文注入。评注落盘后，系统会基于旧画像和当天全文生成新画像。画像更新失败仅显示提示，不影响保存。
- 热力图规则：半年一帧，已写显示当日 emoji，未写显示淡底，未来显示灰色。极少数年份（如 7月1日逢周日）下半年的 12 月 31 日格可能不显示。
隐私与数据管理¶
- 隐私保护：日记全文仅落本地盘。唯一的外发数据是总结请求（当日全文 + 用户画像 + 近一周概要）。热力图、meta 和草稿均不出本机。
- 数据备份：数据自包含在日记目录。备份时需包含
.diary-meta/文件夹，否则 emoji 会静默降级为绿块，画像无法读取。 - 语义细节：同日再提交会追加条目并重写总结，不要手动编辑“## AI评注”区域。文件格式为
<diaryDir>/YYYY-MM-DD.md。
结尾¶
该插件为 DSH 用户提供了落地的日记记录方案，结合 LLM 实现了本地化存储与智能辅助的平衡。使用时需注意备份包含 meta 目录，且总结模型配置需符合插件要求。
