dsh-memes-reply

dsh-memes-reply · 蓝色大肥鱼表情包回复

English: A DSH plugin that drops one animated blue-fish sticker under each reply — picked by context, by the model, or by you for the next turn.

让 DSH 在每一条回复正文下方（靠左、与正文左对齐）贴一张会动的蓝色大肥鱼表情包。

它替你省掉的是"自己找图 → 复制 → 粘贴"这条手工链：一轮一张，贴在回复下面，刷新还在、向上滚回历史还在、每个会话各是各的。 贴哪张由语境决定（默认：回复里命中情绪词就补一张），也可以由你为下一轮点名一张。

素材（157 张 / 86 MB）走插件自己的 HTTP 路由直出，不经过 DSH 附件流水线 —— 那条流水线会把动画压成静图。

效果实拍：一轮真实对话 —— 贴纸贴在回复正文下方、靠左与正文对齐（右下角那个是「常驻挂件」，另一条路径）。这一轮是 keyword 模式命中情绪词后自动补的，不是手动点出来的。

---

它长什么样、怎么动

一轮回复在页面上的版面（ASCII 结构图，不是截图）：

你    帮我把这个脚本改成 TypeScript
模型  改好了，三条都过了类型检查。

      [ 大肥鱼 ]  ← 贴纸：贴纸层画的，不是回复正文
                    靠左、与正文左对齐 · 默认 96px

                                   [ 大肥鱼 ]  ← 常驻挂件：右下角浮层，可拖、可收

动效是真的动画，不是一张静图：贴纸层永远加载全尺寸动画 WebP，不走首帧缩略图。

这张是动图（67 帧动画 WebP，506×396）—— 直接截自一轮真实回复：上面能看到 use_sticker 的工具调用行，下面是贴纸在回复正文下方动起来的样子。

下面三条是从本机运行中的实例 GET /api/dsh-memes-reply/catalog 拿到的真实元数据（原始 JSON 见「诊断」）：

它长在哪（四个座位）

什么时候出现

下一轮指定一张（三种入口）

「一次性」是字面意思：指定被最新的那个已落定回合用掉即清（src/client/node.tsx 的 latchConsumedFor），历史回合不会把它反复吃掉。

---

快速开始

三种装法。共同前提：装完要重启（bundle 层与客户端脚本清单都在启动时读取）。

一、装

方式一：从 GitHub 装（推荐）

dsh plugin --profile web add github:liceses/dsh-memes-reply

实测 1.26 MB / 4 秒：不编译、不装构建依赖、不需要任何构建白名单。

DSH Desktop 用户注意：desktop profile 由 Electron 独占管理，命令行会被直接拒绝 （profile "desktop" is managed exclusively by the Electron application）。 请在设置 → 插件界面填入仓库地址。

为什么能免编译：lib/ 已随仓库提交，而 pnpm 的 packageShouldBeBuilt() 只有两种情况会构建 —— ① scripts.prepare 存在；② 有 prepublish/prepack/publish 且 main 文件不存在。 本包用 prepack（发布时才编译），而 lib/index.js 已入库 → 两条都不成立，直接跳过。

早期提交（≤ 2865aca）没提交 lib/ 且用的是 prepare，所以 git 安装会现场编译， 并撞上 pnpm 的构建白名单（ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED）。现在不需要了。

方式二：从 npm 装（尚未发布）

[!IMPORTANT] 这条路现在走不通 —— 包还没发布到 npm，下面这条命令目前会 404。 先看方式一。

包已经按发布形态准备好 —— npm pack 约 210 KB、内含编译好的 lib/、prepack 会在打包前自动构建 —— 但还没有发布到 npm，所以下面这条命令目前会 404：

# 尚未可用；等发布后再用
dsh plugin --profile web add dsh-memes-reply

发布流程就两步：npm login → npm publish（prepack 自动编译，不用手工 build）。

方式三：本地链接（开发用）

pnpm install && npm run build    # link: 安装不会替你跑 prepack，得先自己编译
dsh plugin --profile web add "link:D:\developing\DSH-plugin\dsh-memes-reply"

二、取素材

素材 87 MB，既不随 npm 包发布，也不在 git 仓库里（走 GitHub release 附件）：

cd ~/.dsh/profiles/web/node_modules/dsh-memes-reply
node scripts/fetch-assets.mjs

它会下载 → 校验 sha256 与字节数 → 解到 <DSH_HOME>/memes-reply/assets。 下载慢或不通就手动下载后走本地包：node scripts/fetch-assets.mjs --from <memes-assets-v1.zip>； 只想看它会做什么：加 --dry-run。目标目录已有素材时会直接退出（要覆盖加 --force）。

素材不是必须的一步 —— 没取的话插件照常加载，只是没有图可贴（面板会显示 0 张）。

本机已取过的真实结果：<DSH_HOME>/memes-reply/assets 下 315 个文件 / 91,221,513 字节 —— 顶层 158 个（157 张贴纸 + index.json），thumb/ 里 157 张缩略图。

三、验证装对了

dsh --profile web --dump-config | grep memes-reply   # 能看到 id: memes-reply
node test/live-probe.mjs                             # 对运行中的 GUI 打活体探针

live-probe 会一次性把客户端 bundle、贴纸字节、缩略图、清单、/vocab、/session-state、 「下一轮用这张」与状态行全部打一遍。

改了 host 半区必须重启 dsh web（路由是启动时注册的）；只改浏览器半边则刷新页面即可。 客户端贴纸层为此带了一份打包词表兜底：宿主没重启（/vocab 还是 404）时它照样工作。

四、用

---

目录

---

配置面板

位置：侧栏 插件 → 已安装 → 查看 memes-reply（统一插件管理页；配置面板画在本插件自己的页面上，默认展开）。形态对齐原版折叠卡片 （标题 + 描述 + 未保存徽章 + chevron → 展开体 → 底部 丢弃/保存），全部用 --dsw-alias-* 主题变量。

配置字段走官方客户端设置服务 ctx.configForms（草稿→保存，revision 冲突自带恢复），由宿主设置服务 写进 profile 的 patch（~/.dsh/profiles/<profile>/cordis.patch.yml 里该条目的 config:； 0.1.5/0.1.6 时代的 ~/.dsh/settings.yaml 已被改名 settings.yaml.imported，只作迁移对照）。 状态行/预览墙/指定走插件自己的同源路由。 面板里改的规则（autoMode / 间隔 / 兜底 / 冷却）由浏览器半边直接读设置生效，不需要重启。

22 个字段与默认值

字段序就是设置面板的展示顺序，也是保存 diff 的顺序（src/config.ts 的 CONFIG_FIELDS）。 默认值取自 src/config.ts 的 DEFAULT_CONFIG，说明取自 src/schema.ts 里每个字段的 description。

本机的真实 dump（dsh --profile web --dump-config，实跑，exit 0 / 48,051 字符）里，这个插件只有两行 —— 没有 config: 块，也就是 22 个字段全在默认值上：

# == dsh-memes-reply
- id: memes-reply
  name: dsh-memes-reply

desktop profile 里同样没有 config: 块（只有 - id: memes-reply + disabled: false）。

---

工作原理

v2.0：贴纸是"会话流里的一个节点"

贴纸不再是"宿主发事件、客户端抢座位渲染"的浮层，而是会话事件的纯函数： 一轮 = 一个节点，跟着那条回复走 —— 向上滚回历史能看到、刷新页面还在、每个会话各是各的。 生成中先显示「思考中 / 打字中」，回复写完的瞬间同一个节点换成这一轮的最终贴纸。

• 每回合一张，不用模型操心（autoMode=every 时每轮必贴；autoMode=jev 时由 JEV 按语境判情绪族、 而且能判"这轮不贴"；模型也可以用 use_sticker 点名要哪张）
• 两阶段：生成中 = 占位表情 → 落定 = 最终贴纸（结构性替换，不是遮住）
• 会动：永远加载全尺寸动画 WebP，不走首帧缩略图
• 零日志污染：不往 session log 写自定义事件（那会让日志在别的构建里"拒绝解释"，见下）
• 原生风格的配置面板（侧栏 插件 → 已安装 → 查看 memes-reply）：状态行 + 22 个字段 + 素材预览墙
• 常驻挂件：页面上一直有一只大肥鱼（点一下换一张、可拖、可收成小圆点）——随时能看到
• 一键关掉：面板总开关 + /fish off 本会话静音

分工上，宿主只做四件事（src/index.ts）：贴纸字节路由、客户端派生的数据与开关（/vocab / /session-state）、 模型工具 use_sticker、斜杠命令 /fish 与设置表单；"贴哪张"这个决定整个搬到了浏览器半边， 由 src/derive.ts 这份 host 与浏览器共用的纯逻辑算出来 —— 所以刷新只是重放，不需要任何持久化绑定。

派生优先级（落定那一张）

finalStickerFor()（src/derive.ts）按顺序取第一个能落地的：

人指定（本会话 /fish > 面板全局）  >  JEV 语境结论  >  模型点名（id，其次 mood 关键词）
                                  >  规则（keyword / every）  >  兜底贴纸  >  不贴

• 规则里 keyword 命中的词、模型给的 mood，都由同一套检索器（src/search.ts，两端共用）解成 id —— 同一份词表 + 同一个算法 ⇒ 两端结论一致。
• 冷却（cooldownTurns）在规则这一层过滤"最近用过的"，不会否决人指定或模型点名。

为什么不用自定义会话事件

最"正统"的写法是像官方 present 工具那样把决定 session.append('memes-reply/sticker', …) 写进日志。 这条路对本插件是危险的：Session.append() 没有任何渠道设置 ignorable 标记，而持久化读取的规则是 "未知类型且未标记 ignorable → 拒绝解释整个日志"，且已知类型表是仓库内生成的静态表、 下游插件类型按构造就不在里面。写自定义事件 = 让用户的历史会话变成打不开。

所以 v2.0 只读会话事件：决定完全是 (会话, 轮次, 收尾正文, 模型的工具实参, 宿主开关) 的纯函数 （src/derive.ts，host 与浏览器共用同一份实现），可重放、无竞态、零污染。

贴纸贴在哪一轮、什么时候出现

模型那一侧：一行提示 + 一个工具

工具注册了就对所有会话可用，但用不用完全由模型决定。实测（扫全部会话日志）显示：装好之后跑过的别的会话， 请求里都带着 use_sticker（ds-tts 连续 6 轮都带着），却一次都没调用过 —— 它排在 71 个工具的目录末尾， 模型在正常写代码/查问题的流程里没有理由去动一个"装饰性"工具。

所以 src/prompt.ts 往系统提示里加一行（不是一段），锚在 TOOLS_SDK 之前（order = 锚点 - 100）， 且只在工具真的注册了、总开关开着、本会话没被 /fish off 静音时才输出，否则输出空串（0 token）：

情绪合适时（问题修好、踩了坑、夸一句、任务收工）可以用 use_sticker 贴一张大肥鱼；一轮最多一张，用户说不要图时别贴。

工具 use_sticker 的职责收窄成三件（src/tool.ts）：校验模型的点名（id 存在、文件真读得到，失败给可执行的重试建议）、 维护"人按过的开关"（会话静音 / 一次性指定 / 最近用过）、回一句人话告诉模型"已选定，正文里不要写任何图片 URL，也不用再调用"。 "每轮最多一张"由结构保证：一轮只有一个节点、只认最后一次点名。

JEV 模式：让 JEV 决定贴哪张

autoMode: 'jev' —— 把这一轮的回复交给 JEV （TypeSafe 的 System One 模型，只做选择/分类/打分）判一个情绪族，再由代码在族内挑一张。

为什么是"先判族、再选张"

真实 API 实测（2026-09-20，text=验收完成…踩了个坑…，同一份 state）：

JEV 对窄候选集明显更可靠，而"族里到底选哪张"（三张几乎一样的一字马）本来就该由代码定 ——顺带把冷却去重与确定性一起解决了。这与 JEV 自己的纪律一致：精确规则与算术用代码，Jev 只做判断。

三条硬需求怎么落的

代价（说清楚，不埋在代码里）

• 隐私：开这个模式等于把助手每一轮的回复正文发到 OpenRouter（正文截断 12k 字符）。
• 成本：实测 $0.0000488/轮（约 1 万分之 5 美元），已在 /stats 的 jev.costUsd 记账。
• 延迟：直连实测 784 ms，经 127.0.0.1:10808 实测 2268 ms（同一份请求）。 Node 的 global fetch 默认不读 HTTPS_PROXY；Node 24 起可用 NODE_USE_ENV_PROXY=1 让它读。
• 非确定性：同一输入两次跑出 yes=0.79 / 0.80 —— 这就是必须做服务端缓存的原因。
• needs_review（CLI 退出码 2）在真正两可的回复上是常态（例：celebrate 0.61 vs bug 0.31）， 不是错误。这里取分布的最大值，不把"未达 0.8 阈值"当成失败。

还能"这轮不贴"

blank 是候选里的一族，配一个 stick 是非题（实测 yes=0.79~0.83）。两个都指向"没情绪"时 就不贴，所以 jev 模式下"每轮必有鱼"不再是唯一选项 —— 纯技术输出可以不打扰。

调试浮层：看它到底发了什么、回了什么

配置面板里打开 JEV 调试浮层（默认关），页面右上会出现一枚可拖的小胶囊，点开成面板：

三条设计约束：

• 只记真实往返：命中缓存不产生新条目 —— 一次刷新会重放好几个回合，都记进去只会把真正发生过的事淹掉。 缓存次数由头部那个 缓存 M 表达。
• 只在展开时轮询（每 2.5 s）：收了或关了就不发请求。
• 只读：面板里没有任何写操作（不重发、不改族表）—— 排障工具不该能改变被观测的东西。

日志在宿主内存里（环形，最近 20 趟，不落盘）；请求/响应里的长文本按 1.2k 字符截断并显式标注 "截断，原文 N 字符"。位置与收起态写回 state.json，刷新后还在。

13 个情绪族 + blank（src/moods.ts）

族表是人工整理的：157 张里 152 张归入 13 族，剩 5 张不收。未收录的 id 不会消失 —— 它们仍可被 keyword 模式、模型点名、latch 选中，只是不作为 JEV 的候选出现。

test/jev.test.mjs 有一条回归盯着"表里的 id 必须真实存在"。

HTTP 端点（11 条，全部在 /api/dsh-memes-reply 下）

id 白名单是 ^[a-z0-9][a-z0-9-]{0,39}$（src/protocol.ts），因为只接受这个形状，路由天然不存在路径穿越； 单张贴纸读取上限 16 MiB。POST /latch 没有鉴权（本机任意页面可调），只影响"下一轮贴哪张"， 且有回环围栏 + 不发 CORS 头 + id 白名单（见「已知局限」）。

常驻挂件：随时能看到大肥鱼

页面上一直有一只大肥鱼（默认右下角，128px 圆形）。它坐在 shell.overlay —— 官方对那个座位的定义就是 frame-wide floating layer，加法型（replaceRisk: none）， 而且整层 click-through、条目自己 opt in 到 pointer events，所以它不挡下面的界面。

（这也是你原来那只 鲸鱼娘 的模型：~/.dsh/pet.json 里就是 display: {visible, size, right, bottom}。）

本机 state.json 里挂件的真实落点："pet": { "id": "penji", "right": 1415, "bottom": 704 }。

素材与体积

# 默认：保留全部帧，单张上限 700 KB（体积换顺滑）
node scripts/import-assets.mjs --format webp --also-package

# 降到 25fps：动作仍比 GIF 顺，体积省掉约 1/3（推荐在意外体积时用）
node scripts/import-assets.mjs --format webp --fps 25 --also-package

# 想换回 GIF（体积最小，帧率会被阶梯砍到 10–20fps）
node scripts/import-assets.mjs --format gif --also-package

node scripts/import-assets.mjs --thumbs --also-package    # 只补缩略图（设置面板预览墙）
node scripts/import-assets.mjs --dry-run                  # 只看会做什么
node scripts/import-assets.mjs --reindex --also-package   # 只重算元数据+标签，不重新编码

当前产物：157 张 / 85.9 MB / 均值 560 KB（全帧的代价）。assets/ 跟着仓库走的话建议用 --fps 25 减半到 ~45 MB，或把 assets/ 加进 .gitignore（运行时主力其实是 ~/.dsh 那份）。

release 附件包的真实清单（scripts/assets-pack.json）：315 个文件 / 157 张贴纸 / 91,043,470 字节， sha256 = 345684d337dada6332f99627ce44ab91c244b918aba4c4236947e9cd6641f9d1，fetch-assets.mjs 会逐项校验。 本机解出来的那份是 315 个文件 / 91,221,513 字节（顶层 157 张贴纸 + index.json，thumb/ 157 张缩略图）—— 文件数与清单一致，字节数比压缩包大是解压后的正常结果。

改素材语义/标签：编辑 scripts/sticker-map.json（128 条：id + 中文 tags + 英文 aliases），重跑导入。 id 是 ASCII 短名（dianzan、aixin-2），进 URL；原名只留在索引里。

重跑导入后要执行 npm run build：客户端自带一份打包词表（src/client/vocab-fallback.json， 由 scripts/build-client-vocab.mjs 从 assets/index.json 生成），有测试盯着它与索引不漂移。

词的纪律（踩过两次）

凡是展示给模型看的词，都必须能被自己的检索器命中：工具描述里的例子、系统提示里的场景短语、 失败文案里建议的重试词——全都有回归测试盯着。 踩过的两次：描述里写「得意」却检索不到；提示里写「任务收工」导致模型传「扒源码收工」也检索不到。

检索器对中文是容忍的：修好了→修好、踩了坑→踩坑、扒源码收工→（含）收工 都能落到图上， 而 ≤2 字的短查询（点赞、哭）行为不变。模型只给 mood 时，客户端用同一套检索器解出 id。 匹配不上时工具会明说可以重试；设置里的「兜底贴纸」（默认关）能让它无论如何都贴一张，并如实标注。

诊断

node scripts/probe-report.mjs 40     # 读 /stats：这一版 bundle 加载了吗 / 节点渲染了吗 / 选的是哪张 / 有没有被折叠
node scripts/scan-sticker-usage.mjs  # 每个会话：提示是否进请求 / 工具是否可用 / 是否真调用 / 出了几张图

浏览器控制台宿主看不到，所以客户端的关键动作都会经 POST /debug 回传到 host 的环形缓冲 （/stats 一次读全）——这是"某条回复为什么没有贴纸"唯一能看见的办法。

真机读数（本机运行中的实例）

GET /api/dsh-memes-reply/stats 的真实返回（长 trace 数组已省略，其余逐字未改）：

{
  "ok": true, "ready": true,
  "entries": 157,
  "index": "C:\\Users\\ROG\\.dsh\\memes-reply\\assets\\index.json",
  "format": "webp",
  "assetRoot": "C:\\Users\\ROG\\.dsh\\memes-reply\\assets",
  "originalRoot": "", "quality": "compressed",
  "totalBytes": 90057114,
  "served": 9, "miss": 0, "denied": 0,
  "lastId": "penji", "lastAt": 1791315376623,
  "latch": null,
  "jev": { "calls": 0, "hits": 0, "fallbacks": 0, "costUsd": 0, "lastMs": 0, "lastNote": "", "cacheSize": 0 }
}

同一份 /stats 里的 trace 有 48 条回执、6 种 kind 各 8 次（client-apply 出现 8 次 ≈ 8 次页面加载）。客户端半边真的挂上了两个座位 （这两条是原始回执文本）：

client:sticker-node-installed · build=sticker-node-a kind=memes-sticker
client:sticker-turn-tail-installed · slot=conversation.chat.turnTail id=dsh-memes-reply-sticker（落定贴纸的新座位；旧的自定义节点只留生成中占位）
client:sticker-turn-tail-slot · 槽位已声明 → 注册 dsh-memes-reply-sticker
client:sticker-turn-tail-registered · register 成功 id=dsh-memes-reply-sticker · slots.entries=1 条[dsh-memes-reply-sticker]

/catalog?limit=3 的真实返回（「它长什么样」那张动效表的原始 JSON；URL 里的主机名是本机实例的）：

{"ok":true,"ready":true,"total":157,"items":[
 {"id":"tiaowu-pizhichun","name":"跳舞(低皮质醇)","tags":["跳舞(低皮质醇)","低皮质醇","从容","松弛"],
  "bytes":629686,"w":240,"h":240,"frames":66,"fps":50,"durationMs":1320,
  "thumb":"http://127.0.0.1:3081/api/dsh-memes-reply/thumb/tiaowu-pizhichun.webp",
  "url":"http://127.0.0.1:3081/api/dsh-memes-reply/sticker/tiaowu-pizhichun.webp"},
 {"id":"notice-bits","name":"通知_提示 Bits","tags":["通知_提示 Bits","通知","打赏动画"],
  "bytes":715886,"w":240,"h":240,"frames":86,"fps":50,"durationMs":1720},
 {"id":"qidai-1","name":"期待","tags":["期待","期待","等着","催更"],
  "bytes":794786,"w":200,"h":200,"frames":131,"fps":50,"durationMs":2620}]}

会话日志体检（scan-sticker-usage.mjs）的真实输出

扫 82 个会话，列出最近 10 个：

时间                  workspace                             提示    工具    调用    贴纸URL  解出
2026/9/22 20:00:22  D-applications-deepseekharness         有     1     0        0  2.6 MB
2026/9/22 19:59:08  D-developing-Oss~76F8~5173             有     2     0        0  0.8 MB
2026/9/22 19:58:15  D-developing-ds~6C11~95F4~79D1~7       有     1     0        0  0.2 MB
2026/9/22 19:54:57  D-developing-ds~6C11~95F4~79D1~7       有     1     0        0  0.1 MB
2026/9/22 19:53:15  D-developing-ds~6C11~95F4~79D1~7       有     1     0        0  0.1 MB
2026/9/22 19:50:47  D-developing-ds~6C11~95F4~79D1~7       -     2     0        0  53.7 MB
2026/9/22 19:17:54  D-developing                           -     0     0        0  0.0 MB
2026/9/22 19:04:09  D-developing-ai~0020benchmark-Qw       有     5     3        0  6.2 MB
2026/9/22 14:44:48  D-developing-make-videos-kit           有    20     6        0  4.3 MB
2026/9/22 12:29:00  D-applications-deepseekharness         有     2     0        0  2.9 MB

最近 10 个会话：提示命中 8 个 · 真的调用过 2 个

怎么读这张表（脚本自己的说明）：

• 「提示」列 = 装配后的请求里确实带了我们那一行（有）/ 只在正文里出现过、可能是我自己引用过（?）/ 没有（-）；
• 「工具」列 = 请求的工具目录里有几个 use_sticker（= 工具对所有会话可用）。有数字但「调用」为 0 = 模型看见了却没用；
• 判断"模型到底用没用"，看的是「调用」列，别被「工具」列骗了（那是没装插件的老会话）。
• 「贴纸URL」列数的是会话产物里的贴纸 URL 条数；上表里是 0 —— 该列匹配的是 /api/dsh-memes-reply/sticker/， 而这些会话里的贴纸是客户端派生渲染的（v2.0 起工具不再产出 URL，只回 id/name），所以这一列在 v2.0 会话上天然是 0。

JEV 那一层另有一条通道

GET /jev-log（环形，最近 20 趟真实往返，含请求与响应原件）。 不用敲命令 —— 面板里打开「JEV 调试浮层」就能看，见 JEV 模式 → 调试浮层。 命令行想直接看就：

# 最近 5 趟真实往返（含发给 JEV 的请求与它回的响应）
node -e "fetch('http://127.0.0.1:3080/api/dsh-memes-reply/jev-log?limit=5').then(r=>r.json()).then(d=>console.log(JSON.stringify(d.entries,null,2)))"

/stats 里的 jev 段是计数（calls / hits / fallbacks / costUsd / cacheSize），不是原文 —— 原文只在 /jev-log，那样 12 秒轮询的 /stats 才不会被一堆没人看的 JSON 拖胖。

插件自有状态在哪

<DSH_HOME>/memes-reply/
  assets/      素材（157 张贴纸 + index.json；由 fetch-assets.mjs 或 import-assets.mjs 产出）
  state.json   人按过的开关：每会话静音 / 一次性指定 / 最近用过 / 挂件坐标 / JEV 面板位置

state.json 的真实片段（本机，recent 是冷却用的"最近用过"，pet 是挂件落点）：

{
  "version": 1,
  "sessions": {
    "session-49fbb356-4c93-4e96-9fd6-b43151d595f8": { "recent": ["tingzhi-gongzuo", "qingzhu", "mojing-fanguang"] },
    "session-d3a88913-da08-4ec4-8796-770dd6ae99ad": { "recent": ["dianzan", "tingzhi-gongzuo", "qingzhu"] }
  },
  "global": { "pet": { "id": "penji", "right": 1415, "bottom": 704 } }
}

写盘纪律：同目录 tmp + rename 的原子写；文件损坏 / 缺失一律当空状态处理 —— 绝不因为一个 json 坏掉而让插件起不来（写失败只记一行日志，不影响回复）。

验证记录（本机）

这一节只记这次 README 改写作业里真跑过的东西，跑不了的如实标注。