前言¶
用 DSH（DeepSeek Harness）这类「一切皆插件」的框架搭智能体，长期记忆要自己搭：存哪、怎么压缩、下次怎么读，每个环节都得动手。日记是个典型场景——既要原文留档，又要让模型隔天回看时抓得住重点，还不能一开口就是冷冰冰的统计报告。
下面介绍 dsh-diary-detective（赛博日记侦探），它把日记读写、记忆压缩、温和反馈打包成一个插件。项目由 SageChenAI 维护，MIT 许可证。
这是什么¶
一句话定位：一面有温度的镜子，读日记、照见盲点、给温柔反馈。
它做的事情分两层：
1、机械层：把口述日记存成文件、读回原文、做基础统计、维护一份压缩记忆。
2、理解层：由 SKILL.md 里的温暖观察者准则驱动，指导模型怎么思考、怎么分析、怎么说话。
既照盲点（反复犯错的习惯与根因），也照成长的地方。身份边界写得清楚：它不是治疗师，不是教练，也不是生产力追踪器。分析以假设形式给出，用户可以确认、否认或纠正。
核心功能¶
插件提供五个工具：
diary_write：把口述日记保存为YYYY-MM-DD.md，不强制格式diary_read：读取原始日记条目，原文是唯一事实来源diary_index：机械统计，包括星期分布、标签频率、中文 bigram 频率、连续天数、空档——注意这些只是粗略代理，语义理解是模型的事diary_memory/diary_memory_update：读取、重写压缩记忆diary_feedback：一次调用的入门包，把今日条目、记忆、统计一起返回
工具之外还有一个技能：SKILL.md，即温暖观察者准则。它约束的是表达方式——一次只讲一个发现，且要引用原文证据；没有值得说的就直说，不为凑数编造模式；先倾听，后表达。
数据默认相对工作区存放：日记在 <workspace>/diary/，记忆在 <workspace>/diary-memory.md。所有工具都支持 dir / path 参数，想存哪里自己指定。
安装与启用¶
先装工具（bundle）：
dsh plugin --profile <name> add dsh-diary-detective
<name> 换成你的 profile 名。也可以从 GitHub 安装，命令中的占位符需自行替换：
dsh plugin --profile <name> add github:<your-github-username>/dsh-diary-detective
再做第二步：手动安装技能。把仓库里的 SKILL.md 复制到技能目录：
# 用户级
cp SKILL.md ~/.dsh/skills/diary-detective/SKILL.md
# 或项目级
cp SKILL.md <project>/.dsh/skills/diary-detective/SKILL.md
经过上面的步骤，工具和技能都就位了。当前版本 0.1.0，依赖 @deepseek-ai/dsh-tools ^0.1.0。技能目前需要手动复制，Roadmap 的 v1.1 计划支持 bundle 自动注册技能和插件配置路径。
典型用法¶
日常使用靠自然语言触发：
- 「今天复盘」/「daily review」
- 「写日记：今天……」/「journal: today I…」
- 「我最近是不是……」/「have I been… lately?」
以「今天复盘」为例，模型会先加载技能，再按顺序调用工具：读原文 → 读记忆 → 机械统计 → 分析 → 表达 → 更新记忆。先做事实采集，再做理解和表达，最后把新结论写回记忆，下次接着用。
隐私¶
- 所有日记内容本地存储，位置由你通过
dir/path指定 - 原文可能发给模型做分析，但本项目不会分享或用于训练
适用场景与注意¶
适合两类人：
- 想给智能体加长期日记记忆的 DSH 用户，工具链是现成的，不用自己写存储和统计
- 对分析语气敏感的人。这套准则强调不贴标签、不编造模式、不翻旧账，内容超出能力范围时会建议找真人
两点注意：
- 插件以当前 dsh 进程的权限运行，能读写它拿到的路径。安装前建议先看一遍源码和许可证（本项目为 MIT）。
- 项目还在早期（0.1.0）。v1.1 计划加入
diary_report（周/月复盘）和插件配置路径，v1.2 计划做通用 prompt 版本（可粘贴进任意 AI）和带连续天数统计的浏览器面板，选型时留意。
小结¶
dsh-diary-detective 把「存日记、读日记、记住结论、温和表达」收进一个插件：工具管事实，SKILL.md 管分寸。如果你正在给 DSH 智能体补日记和记忆能力，可以从它开始看。
- 社区插件目录页：https://www.skillhub.cn/plugins/SageChenAI/dsh-diary-detective
- GitHub 仓库：https://github.com/SageChenAI/dsh-diary-detective
（注：skillhub.cn 为社区维护的插件目录，与 DeepSeek / 幻方无官方从属关系。）
