日记（dsh-diary）

日记不是日志。一份写给别人看，一份只写给自己；记性会变糊、会淡忘，也会因为被反复想起而留得更久。

这是一个跑在 DeepSeek Harness 上的日记系统，由四部分组成：

「记忆」和「日记本」是两套东西：记忆是会遗忘的记性（会注入到每轮对话）， 日记本是纸（每天两份文件，写完就一直留着）。

它和别的日记插件有什么不一样

1. 日记会自己变糊。 每轮只给一段「模糊视图」——心情 + 一句短标题，正文要本人主动展开。 剩余寿命越短给的信息越少：>50% 给心情+标题，20–50% 只给心情，<20% 只剩日期。

2. 翻看不会续命。 只有明确的「延长」才加天数，同一天只算一次。 这是为了模仿人：你反复想起一件事，不代表它会永远记得；但你真的舍不得，就会主动留。

3. 搁着分两种代价。 选「不敢看」→ 冻结计时，一天都不会少；选「没兴趣」→ 照常衰减。 理由随时能改——选错了不算错。

4. 到期不直接删。 先模糊成关键词、临存几天，再决定恢复 / 划掉 / 不管；划掉也只是进回收站。

5. 记忆分两边。 私聊与群聊各有一套记忆，互不相通；只有写日记那一刻两边会合。

6. 每天两份文件，内容不同。 公开那份愿意给人看，私密那份只给自己。

7. 写日记的素材覆盖一整天。 不是「取最后 N 行」，而是按小时分桶均匀取样—— 哪怕一天两千多条，早上说的话也一定在。

Related MCP server: ebbingflow-mcp

三档寿命

四条硬规则：寿命从写下那天算绝对时长；翻看不续命；同一天只算一次延长； 升/降档按新档位的初始寿命重算，不在旧寿命上叠加。

十二个工具

diary_write（写）· diary_list（目录）· diary_open（展开）· diary_extend（延长） · diary_promote（升档）· diary_demote（降档）· diary_shelve（搁着）· diary_unshelve（拿出来） · diary_fade（记糊）· diary_delete（划掉）· diary_amend（补写心情/没敢说的话）· diary_moods（按天数翻心情）

外加 diary_recall（上下文压缩配套：最近主动打开过的 300 条，一次最多查 16 条）。

工具描述里放的是这些动作意味着什么，而不是 API 文档：

「同一天里不管想它几次，只能延长一次——舍不得也不是这么用的。」

快速开始

1. 装上 MCP 工具（让 AI 能读写记忆）

npm install
node src/mcp-diary.js        # 标准 MCP stdio 服务，交给 DSH 的 MCP 客户端拉起

在 DSH 的 profile patch 里加一行：

- insert:
    - id: mcp-diary
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: diary
        transport: stdio
        command: 'node'
        args: ['<仓库路径>/src/mcp-diary.js']

工具名会变成 mcp__diary__diary_write 这种形式。

2. 装面板插件（在设置页里看和修）

node scripts/install-diary-plugin.mjs desktop   # 幂等；装完完全退出 DSH 再打开

打开后在 设置 → 日记。插件配置可以指定它管哪些目录：

- id: dsh-diary
  name: 'dsh-diary'
  config:
    root: 'D:\我的日记'        # 数据根：日记文件所在，也是面板允许写的那棵子树
    project: 'D:\我的项目'     # 项目根：config.json 与 state/ 所在
    readOnly: false

3. 跑测试

npm test                                  # 记忆内核 18 组 + 日记本内核 9 组
node plugins/dsh-diary/index.js --selftest # 面板插件自检 26 项（临时目录，不碰真实数据）

都不需要 DSH、不需要网络、不需要真实日记。

每天 23:30 的两份日记

<数据根>/日记/2026-10-23.md
<数据根>/日记-私密/2026-10-23.md

公开那份的正文长这样（真实输出，已脱敏）：

早上群友乙的耳机到了，竹林鸟烛龙，他说蹲了半个月……五百八，比原价便宜一百。 中午开始大家聊吃的…… 到下午，群友乙说老板第三次改需求了…… 傍晚下雨，路上全堵。晚上说好一起打的，人到齐了又因为这局输了互相怪。

写作需要一个宿主来调度（本仓库提供被调用的内核，不含具体宿主）： 宿主每天到点 → 取当天聊天流水、按小时取样 → 让模型写两段 → 落盘。 接入方式与最小示例见 docs/INTEGRATION.md。

关键细节：

• 流水：state/chat-log/YYYY-MM-DD.jsonl，一条消息一行，自己说的话也记（s:"我"）； 默认保留 10 天（logRetentionDays）。

• 取样：按小时分桶，每桶取首/尾/中间几行；预算不够整体降采样（6→4→3→2→1）， 绝不靠丢掉前面的小时来省字数。

• 不加盖：已经写过的日期不会重写；只有缺一份时才补那一份。

• 补写：关机错过的日期，开机后按 catchupDays（默认 7 天）往回补，每次只补一天。

• 不编历史：startedOn 记着部署日，不会给安装之前的日子凭空写日记。

窗口 / 注入长什么样

每轮给 AI 看到的是这样一小块（没有正文）：

【日记·作用域】群聊（调 diary_* 工具时 scope=group；私聊与群聊的记忆互不相通，也不该互相提起）

【日记·模糊印象】聊到「失联」的时候，这几条忽然冒了出来——你只记得个大概，看不到原文：
【刻骨铭心】10月18日 · 心里有点沉　他说自己失恋过　id=d3
【重要】10月20日 · 有点烦　id=d7
（想看哪条就用 diary_open 展开；不打开就一直是这个样子。展开不算留住。）

命令与配置

config.json（宿主用，本仓库只给示例 config.example.json）：

{
  "diary": {
    "enabled": true,
    "settleAt": "23:30",
    "fadeGraceDays": 3,
    "heartRemindEveryDays": 7,
    "injectMaxEntries": 10,
    "injectMaxChars": 1200,
    "portraitThreshold": 80
  },
  "journal": {
    "enabled": true,
    "publicDir": "D:\\我的日记\\日记",
    "privateDir": "D:\\我的日记\\日记-私密",
    "writeAt": "23:30",
    "catchupDays": 7,
    "logRetentionDays": 10,
    "digestPerHour": 6,
    "maxDigestChars": 8000
  }
}

目录结构

.
├── src/
│   ├── diary-core.js       记忆内核（寿命/遗忘/搁着/回收站/模糊视图/结算/缓存）
│   ├── journal-store.js    日记本内核（两份文件/流水/取样/补写窗口）
│   └── mcp-diary.js        MCP stdio 服务（12 个工具 + diary_recall）
├── plugins/dsh-diary/      面板插件（host 路由 + 客户端设置页）
│   ├── index.js            host：注册 /api/diary/*
│   ├── client.js           设置页「日记」
│   └── lib/{guards,paths,data,write,router,selftest}.js
├── scripts/
│   ├── install-diary-plugin.mjs   幂等安装到 DSH profile
│   ├── test-diary.mjs             记忆内核测试
│   └── test-journal.mjs           日记本内核测试
├── docs/
│   ├── DIARY.md             记忆系统完整设计（寿命/结算/作用域/缓存）
│   ├── JOURNAL.md           每日两份日记完整设计（流水/取样/补写）
│   └── INTEGRATION.md       怎么接进你自己的宿主（调度与落盘）
├── config.example.json
└── package.json

隐私与安全

• 本仓库不含任何真实日记数据。 真实数据在 state/、日记/、日记-私密/，都在 .gitignore 里。

• 插件只读写你配置的两个根目录下的文件，越界一律拒绝。

• 面板的写操作有三道闸：配置 readOnly 不为真、请求带 confirm=yes、Origin 是本机面板。

• 写盘一律「指纹拒写 → 改前备份 → 原子写 → 写完复核」： 这期间别人（比如自动写日记的进程）改过这个文件 → 拒绝写入，而不是覆盖。

• 备份在 state/diary-backups/，不会自动删（那是使用者的东西）。

与 dsh-memory-board 的关系

面板的写盘内核（指纹拒写、TOCTOU 复检、改前备份、写完复核）与「认根只认特征文件」 「写操作三关」的设计来自 S3K926/dsh-memory-board（MIT）。 本仓库按自己的数据结构做了移植与裁剪，不是它的分支，也不共享数据格式。

许可

MIT。见 LICENSE。