# 更新日志

本文件记录每个已发布版本的对外变化。版本号遵循语义化版本（主.次.修订）。

> **脱敏声明（2026-10-08）**：为公开发布做准备，**本文件历史条目中的个人标识已做脱敏** ——
> 人名昵称、人格卡示例中的姓名/别名、内部实例名与容器名、本机绝对路径，一律换成中性示例
> （如 `本名：「示例」；别名：「例子」`）。**"改了什么、为什么改"的技术内容逐字保留**，只换标识。

> ### 版本号读法（2026-10-04 用户要求）
> **对外称呼用两段式：`<DSH 适配版本>/<插件版本>`**，例如 **`0.2.0-rc.2/0.1.6`**。
> - 第一段 = 适配的 DSH 版本（本部署是 `0.2.0-rc.2`）
> - 第二段 = 插件自身版本（本版是 `0.1.6`）
> - ⚠️ `/` 不能出现在 `package.json` 的 `version` 与文件名里（前者要合法 semver，后者是路径分隔符）⇒
>   这两处落地为 **`0.1.6+dsh.0.2.0-rc.2`**（`+` 是合法 semver 的 build metadata）。**两处指同一件事。**
> - ⚠️ **发到 npm 时只用第二段（干净号）**（2026-10-08 补充）：`npm publish` 会用 `semver.clean()`
>   **剥掉 `+…`** 再上传（npm 自带 `libnpmpublish` 的行为），所以"发 `0.1.9+dsh.0.2.0-rc.2`"实际发上去的
>   就是 `0.1.9` —— 与其让工具**静默改名**，不如**发布前就把 `version` 写成 `0.1.9`**。
>   **`0.1.9` 该号一旦发出永久占用、不可覆盖**，所以这一步必须在发布前定死。

## 0.2.0-rc.2/0.1.17 — 2026-10-11（**未发布**，界面文案清理版）

> **为什么又换一次号**：`0.1.15` 与 `0.1.16` 先后被**两次并行的发布**占用（registry 上同版本不可覆盖、不可重发），而那两次的产物都**没有走本仓库的脱敏与逐字节验收**（其中一次还带着 2 个已无源文件的陈旧产物）。本版用**通过全部隐私检查**的内容重发。

**修掉的内容（面向用户的界面文案）**

- 技能页的删除提示里出现了一个**内部运维侧的称呼** → 改为中性表述（中英文成对）：「真要删文件，**跟运维通道说一声**，我帮你删（会先备份）。」
- 测试注释里指向同一内部称呼的措辞 → 一并中性化。

**为什么之前没被发现（一条值得记住的教训）**

- 隐私检查的规则表里**只收录了"带前缀的实例全名"，没有收录"裸的罗马化短名"**；
  而"验规则表能不能抓到已知串"这类对照实验，**永远测不出"规则表根本没覆盖"这件事**。
- 现已补上：罗马化形式进规则表（**一律带词边界**，否则会淹没在 `channel`/`naming` 这类词的噪音里），
  并在对照实验里增设一步 ——「**故意放一个规则表里没有的真阳性，预期它应当被漏过**」，用来验证对照本身有没有盲区。
- 另加一道**死文件校验**：包内每个文件都应能在 `src/` 找到源文件（`0.1.15` 的产物里混进了 2 个 0 引用的陈旧文件）。

**与 0.1.15 的关系**

功能与逻辑**完全一致** —— 逐字节比对显示两者的差异 **100% 只是「主人→用户」这类称呼替换**，零逻辑差异。本版只是把**还没清干净的文字**清掉，并补齐产物完整性校验。

## 0.2.0-rc.2/0.1.15 — 2026-10-10（**未发布**，换号重发版；内容与 0.1.14 一致）

> **这是一次"换号重发"，不是一次功能变更。**
>
> **为什么要换号**：npm 规定**版本号一旦用过就永不复用**（不可覆盖、不可重复发布同一号）。
> 本插件此前在 npm 上可见的版本（`0.1.0`–`0.1.14`）已按**隐私处置**整体删除；
> 删除后重发**必须启用一个从未用过的新号**，因此本版取号 `0.1.15`。
>
> **内容**：与本轮已经过两轮脱敏的 `0.1.14` 发布包**逐字节一致**，差异只有
> `package.json` 的 `version` 字段与本文这一条说明 —— **没有任何功能、文案、数据或依赖变化**。
> 发布包指纹与逐文件差异对照见 `docs/reports/humanity-0.1.15-publish.md`。
>
> **状态**：本轮只**备包**，未发布。发布需等整包删除完成并跨过 npm 的 24 小时名字封禁期后另行执行。

## 0.2.0-rc.2/0.1.14 — 2026-10-09（**未发布**，人格卡只剩 4 个原生项 + 去掉「用户定义」区块）

> **npm 发布为 `0.1.14`；两段式称 `0.2.0-rc.2/0.1.14`**（见上方版本号读法）。
> 本地构建的 tgz 用**带版次的新文件名** `0.1.14+dsh.0.2.0-rc.2-r1.tgz`（同名同版本换内容的坑已在流程里修掉）。
> **未部署**：本轮只做到"打好包 + 独立验收"，装包与重启由用户单独拍板。

**用户 2026-10-09 的两条产品决定（逐字）**

> ① "只有 8 个原生项，角色卡 4 个，人格卡 4 个，其余都是属于自定一项，**没有标准这一说**，
> 除了原生的 8 个外，**其余都一样待遇**，包括 dsh 新装一个 Humanity，也是显示 8 个原生项。"
> ② "**用户自定义可以删了，它跟添加小节重复了。**"

**A 人格卡原生项从 8 个减到 4 个（其余一律自定义、待遇相同）**

- **唯一真源改一处、全局跟随**：`src/host/persona/constants.ts` 的 `STANDARD_SECTION_TITLES` 截到 4 项
  （对用户称呼 / 说话风格 / 交付格式 / 行为边界），`LOCKED_SECTION_TITLES` 仍是它的前 4 项（派生，不另抄）。
  宿主 7 处与客户端 4 处消费者（默认文档、规范化、校验、补齐、排序、界面）全部跟随，没有第二份字面量。
- **新装只有 8 个原生项**：身份卡 4 字段 + 人格卡 4 小节；**不再预置**那 4 个空节。
- **现存那 4 个节降级为普通自定义项**（内容与标题一字不动）：可删、可改名，**删掉之后不再被补回**
  （只有原生 4 个会被"补齐"）。列表顺序会变（原生在前），这是预期。
- **「非标准小节」提示取消**：`mutable.section-non-standard` 这个**问题码本身删除**
  （连同客户端中英文案与派生判断 `isStandardMutableLayer`）—— 与 `mutable.address-changed` 同一种退役方式：
  永远不会再产生的东西不留着。**删的是提示，不是校验**：空标题、重复标题、冒牌固定层字段名、超长条目照旧拦。
- **原生 4 项仍锁定**：界面没有删除/改名入口，绕过界面直删直改被宿主以 `mutable.section-locked-missing`
  拒绝（`checkLockedSections` 对所有来源生效）——工作台不是后门。

**B 去掉 UI 的「用户定义」区块（数据保留）**

- 渲染与编辑路径整体下线：`PersonaFields` 的区块、`persona-edits` 的三个入口、
  控制器的 `addUserDefined` / `setUserDefined` / `removeUserDefined`、以及中英文案。
- **数据一个字节都不动**：`mutableLayer.userDefined` 仍在 schema 里、仍随保存原样写回、仍会进注入；
  用户的那张卡里它是空数组 ⇒ 零影响。**非空的老卡**：界面不再显示它（报告里已点名这一残留）。

**验证读数（施工方，2026-10-09）**：`pnpm typecheck` → **RC=0**；
`pnpm test` → **基线 697/697/0 → 710/710/0**（净增 13；新增 `test/persona-native-four.test.mjs` 的 15 条 V3–V8 用例，
其中 V4/V5/V6 都做了正反两面）；`pnpm build` → RC=0；tgz 的 **sha256 / 字节数 / 文件数**见施工报告。

## 0.2.0-rc.2/0.1.11 — 2026-10-09（**未发布**，人格卡护栏改「接近预算就刹 + 写入前预演」）

> **npm 发布为 `0.1.11`；两段式称 `0.2.0-rc.2/0.1.11`**（见上方版本号读法）。
> 本地构建的 tgz 文件名沿用旧口径 `0.1.11+dsh.0.2.0-rc.2`。
> **未部署**：本轮只做到"打好包 + 独立验收"，装包与重启由用户单独拍板。
> 本条目**只覆盖 A（人格卡护栏）**；B（技能落盘）见本条目末尾的追加标记。

**A 护栏从「已经超了才拦」改成「接近预算就刹 + 写入前预演」**

- **现象 / 根因**（真机实测，2026-10-09T03:20:47Z 那轮）：自进化台账逐字写着
  `人格注入预算：已用 1880/2065 字符，预算内（注入 33 条）；本轮合并同义条目 0 条` ——
  0.1.10 的判据只看 `truncated`（**已经**装不下），它读到"预算内"就放行，**追加 3 条之后就超了**；
  随后注入即报超预算。"此刻没超"不等于"写完不超"，只看前者永远晚一步。
- **修复（两道闸，都在 `src/host/evolution/`）**：
  1. **护栏**：轮首读一次预算读数（仍是 `persona/render.ts` 的 `FitStats`，**唯一真源**），
     判据从 `truncated` 扩成 `truncated || used/budget ≥ 0.85`
     （新常量 `PERSONA_BUDGET_GUARD_RATIO`，见下"为什么是常量"）。触发时：
     分析提示词末尾追加"**只做整合（合并/精简）、禁止追加新条目**"（读数文案分两档：
     「已超」与「**接近上限**」，运行记录里能分清是哪种）；写回层同样一条新条目都不写，
     **但合并照常**（护栏只停追加，不停"腾地方"）。
  2. **写入前预演**（本版核心）：护栏**没**触发时也不是照单全收 —— 把拟新增条目先合进候选文档、
     用**与真实注入同一套拟合**重新算一遍；这一批会让注入变成"已截断"就**整批丢弃**、只保留合并。
     ⇒ 这就是"空当"被堵住的地方：读数 0.83 的卡再追加一批，照样在写盘前被拦下。
- **可观测**：运行记录注记扩成
  `人格注入预算：已用 N/M 字符，占 xx%（接近上限） ⇒ 本轮只做整合；本轮合并同义条目 K 条，护栏/预演拦下拟新增 J 条`
  —— "自进化这轮什么都没干"与"它守住了预算"终于能分开看。
- **为什么阈值是常量而不是配置项**：这是护栏的**松紧**，不是用户的功能选择；做成配置项会让
  提示词与写回层各读一个阈值，护栏形同虚设（且它的含义随 `PROMPT_CHAR_BUDGET` 一起变，本质与预算常量成对）。
- **已知取舍（提请用户拍板）**：`truncated` 也包含"单条超过软上限 `VALUE_SOFT_LIMIT = 120`、
  注入时会被裁短"这一档 ⇒ 这类**超长新条目**也会被拦下（宁可这轮不写并如实记账，也不静默收下半条）。
  若希望"长条目照收、注入时再裁"，把预演判据收窄成 `dropped > 0` 即可（一处改动）。
- **阴性对照**：预算充足（如占 34%）时那段约束**一个字都不出现**，新条目**照常写入**；预演能过的追加照常写入。
- **红线未动**：`PROMPT_CHAR_BUDGET` 仍 **2400**；不新增存储表、旧数据零迁移；不做删除。

**B 技能落盘：立即止血 + 根因调研**（本版另一条线，由 B 的施工方完成；此处补记）

- **止血（数据面）**：把 `evolution_proposals` 里两条 `kind: skill`、`status: applied` 的提案正文，
  用已装包里真正的 `renderSkillFile`（不自己实现格式）渲染后写进
  `<DSH_HOME>/skills/dsh-duplicate-plugin-mount-fix/SKILL.md` 与 `<DSH_HOME>/skills/restart-effect-verification/SKILL.md`
  —— 落盘用**先 staging 再落目标**，并做了独立校验（比对正文 sha256，不用写入脚本的自述）。
  两个文件的正文与提案 payload **逐字一致**（唯一一处不完全逐字之处已在报告中如实说明）。
- **根因（源码级）**：插件在「批准提案 / 启动恢复」时落盘，那一刻**没有 agent 会话** ⇒
  官方文件后端按**部署默认模式**判（本部署 `workspace-write`，根 `/workspace`），
  而 `$DSH_HOME/skills` 不在其下 ⇒ `FS_SANDBOX_DENIED`。
  **权限预设是会话级的**（`setSandboxMode(session, mode)` 写的是 `sandbox/mode` 会话事件），
  对无会话的插件调用**不生效** —— 所以"把预设放宽到 danger-full-access 就能落盘"是错的
  （README 该句已在 0.1.12 订正）。
- **DSH 不给"插件侧自签通道"**：`ctx.fs.writeText` 的 per-call `sandboxPolicy` 形参确实存在
  （`dsh-fs/lib/types/index.d.ts:221`），但合法取值只有"该会话的策略"或"已批准的升级"，
  两者都要求会话对象；插件自己手搓 `{mode:'danger-full-access'}` 传进去属于**绕过围栏**，不是通道。
- **当时的落地方式**：由有会话身份的一方（会话侧 bash）直接写文件；插件侧保持"如实上报失败"
  （技能页 `落盘写入 0 条 … 失败 2 条`）。→ **0.1.12 把这条路产品化**（见下一条）。

**验证读数（施工方，2026-10-09）**：`pnpm typecheck` → **RC=0**；
`pnpm test` → **tests 628 / pass 628 / fail 0**（改动前基线 **622 / 622 / 0**，净增 6 条新用例，
逐条对应 `docs/plans/humanity-0.1.11-guard-and-skill-disk.md` §4 的 V3–V6，含 V4 阴性对照与 V5 边界用例）；
`pnpm build` → RC=0；tgz 的 **sha256 / 字节数 / 文件数**见施工报告。

## 0.2.0-rc.2/0.1.13 — 2026-10-09（**未发布**，人格页交互改造：8 项锁定 / 整项删除 / 名称只读·内容可编 / 底部添加 + 历史保留期）

> **npm 发布为 `0.1.13`；两段式称 `0.2.0-rc.2/0.1.13`**（见上方版本号读法）。
> 本地构建的 tgz 文件名沿用旧口径 `0.1.13+dsh.0.2.0-rc.2`。
> **未部署**：本轮只做到"打好包 + 独立验收"，装包与重启由用户单独拍板（可**与 0.1.12 一起装**，省一次重启）。
> 判据真源：`docs/plans/humanity-0.1.13-persona-ui-lock-delete.md` §0 / §4（V1–V8）。

**A 默认 8 项锁死：固定层 4 项 + 人格卡前 4 个小节**

- **锁的是哪 8 项**：身份卡 姓名 / 性别 / 人格偏好 / 主语言（`CORE_IDENTITY_KEYS`，**原有**约束）
  \+ 人格卡 对用户称呼 / 说话风格 / 交付格式 / 行为边界（新增 `LOCKED_SECTION_TITLES`，
  派生自 `STANDARD_SECTION_TITLES` 的前 4 项，不另抄字面量）。
- **两面都拦**：① 界面上这 8 项**没有删除入口**（`canDeleteItem` 是唯一判据，连二次确认态都进不去）；
  ② **绕过界面直接请求删除被拒** —— 宿主新增 `mutable.section-locked-missing`（rejected），
  对**所有写入来源**生效（工作台不是后门）。固定层那半边仍由既有的 `identity.core-missing` 管。
- **只拦"整项删除"，不拦编辑**：清空条目、改写内容照常放行（P-010 的高风险是"内容没了"，
  且只对 Agent 生效；"这一节空着"不是删除）。
- **祖父化**：当前文档里本来就没有这一节时（旧数据 / 外部写入留下的畸形文档）不拦 ——
  否则会变成"一个字都存不进去"的死结。`prev` 缺席（首次写入）时从严，与 `checkCoreFields` 同一口径。

**B 其余项可删，且是「真删」（删除粒度 = 整项）**

- 可删：习惯与偏好 / 经验教训 / 情绪 / 未结修正 / 自定义小节 / 自定义字段 / 「用户定义」条目。
  **不做条目级删除**（用户明确否掉）。
- **真删**：整项从 `mutableLayer.sections`（或 `fields` / `userDefined`）里摘掉 ⇒ 文档里没有、
  注入内容里也没有。客户端 `orderedSections` **不再补齐缺失的标准小标题** ——
  旧实现会给每个标准标题兜一个空壳，于是"删了还在界面上、还打不进字"（假删除）。
- **二次确认**：删除是**不可逆**的（本步没有撤销栈），点删除先进确认态（确认带点名删的是哪一项），
  确认后才落进草稿；落盘仍走卡片上的「保存」这一条路。
- **可回溯**：被删内容进 `persona_history` —— 沿用宿主既有行为（`persistPersona` → `supersededBy`，
  `reason: superseded`）。**保留期**见下方「返工 2」。

**C 形态：名称是纯文字、内容一直是输入框 + 删除按钮在项名称下方 + 添加走底部入口**

- **名称区没有输入框**（用户原话："只说每项的名称不要输入框了"）：字段名 / 小节名 /「用户定义」的键
  一律纯文字；**用户自定义的项**可以点「改名」把这一格临时换成输入框（见「追加 3」），
  锁定 8 项与标准小节的名字只读。
- **内容区一直是可编辑输入框**：单行（身份卡字段 /「用户定义」的值）或多行（小节），
  **不需要**"点一下才出现"这一步；只读部署下渲染为 `disabled`。
- **删除按钮位于项名称下方**（用户原话）：项名那一列纵向排「名字 → 删除」，
  行的列定义从 `名称 | 内容 | 操作` 收敛成 `名称 | 内容`（内容区更宽）。
- **底部统一添加入口**：默认只有一个按钮，点开才出现输入区 + 保存/取消；保存顺带走一次写回
  （填出来的一项不该停在草稿里）。名字或内容为空时按钮**禁用**、提交是**空操作**（两处说的同一件事）。

**追加 3（同日，用户选定"加一个改名按钮"）：给用户自定义的项加「改名」入口**

- **给**：自定义身份卡字段、**自定义**小节、「用户定义」的条目 —— 名称处多一个「改名」按钮，
  点了才把名称那一格换成输入框 + 确定/取消；确认后原地换名字，落盘仍走卡片上的「保存」
  （旧名字那一节按"被取代"进 `persona_history`）。
- **不给**：锁定 8 项 + **全部标准小节**（含可删的习惯与偏好 / 经验教训 / 情绪 / 未结修正）。
  理由有机械依据（不是"觉得不该给"）：标准名是插件认的标识，改掉之后
  `completeSections`（Agent 整理工具）下一次就会把原标准名**补回一个空壳**、
  而新名字变成非标准小节（实测：`经验教训`→`复盘` 之后，小节列表多出一个空的 `经验教训`，
  `复盘` 拿 `mutable.section-non-standard` 警告）。
- **边界**（V13）：空名 / 没改动 / 撞标准名（保留名）/ 重名 **一律不落草稿**，确定键禁用并在旁边写明原因；
  重名判据是**整张人格卡内名字唯一**（字段名 / 小节标题 / 用户定义键共用一个名字空间）——
  与宿主逐向对齐，其中"小节或用户定义键撞身份卡字段名"这一向**比宿主严**（宿主不拦这一向，
  这里在源头拦，避免用户之后加不回同名字段）。**绝不静默覆盖**：改名只改这一项自己的键 / 标题。
- **没动宿主**：这条只改客户端（宿主对自定义项的改名本来就放行），锁定拦截等约束原样。

**追加 4（同日，**真机反馈**修复）：按钮并排 + 身份卡输入框不再被截断**

> 0.1.13 装到真机、用户在浏览器里用眼睛看出来的两个问题 —— 前几轮的渲染断言**覆盖不到**
> "按钮排布好不好看、框够不够宽"。修复都是纯客户端布局，**判据也改成可机械复核的形态**（含阴性对照）。

- **按钮并排**（用户：改名与删除原来上下两行堆着）：项名下方新增一层**横向动作行**
  （`editor-styles.itemActions`：`display:flex; flex-direction:row; flex-wrap:nowrap`），
  「改名」「删除」同属这一层；锁定项两个动作都没有时**整层不渲染**（不留空行）。
- **身份卡输入框被截断**（根因是布局，不是宽度策略）：原语 `Input` 的真实结构是
  `<span class="wrap" style="display:inline-flex">` + 内层 `<input style="flex:1">`
  （`dsh-client-ui-primitives/lib/Input.module.css`）——外层是 **inline-flex（收缩到内容宽）**。
  0.1.12 时它是 grid 的**直接子项**，grid 的 `justify-self: stretch` 会拉满那一列；
  0.1.13 给它加了 `data-persona-content` 包装层（为了可机械复核），而包装层是 `display:block`
  —— **block 不拉伸子元素** ⇒ 输入框退回收缩宽（≈ 输入框默认 20 字符 ≈ 135px），长值被框截住。
  `<textarea>` 没事是因为它自带 `width:100%`。
  修法：包装层改**纵向 flex**（`display:flex; flex-direction:column; width:100%`）——
  一处修好所有走这层的控件（身份卡值 / 用户定义值 / 改名输入框 / 底部添加表单两个输入框）。
  ⚠️ **只给 block 包装加 `width:100%` 是假的修法**（外层 inline-flex 依旧收缩）——V15 的阴性对照钉这一点。
- **没动数据与校验**：只改两个样式常量 + 一处包装元素；`renameIssue`、锁定拦截、宿主规则一律未动。
- **读数**：`pnpm test` 从 **690/0** → **694/0**（V14 判据阴性对照 + V14 正面 + V15 正面 + V16 回归口径），
  `pnpm typecheck` RC=0，`pnpm build` RC=0；tgz 指纹见施工报告 §11。

**追加 5（同日，用户看过真机效果后的**布局**要求）：改成一行三段「名称 | 内容 | 按钮」**

> 用户原话：按钮并排那条确认好了 ✅，但**整体还是不好看** —— 要的是左中右三栏、三格垂直居中，
> "整齐感"是关键。⚠️ **审美由用户目视定**：本轮交付的是**结构**（三栏顺序 / 弹性宽度 / 对齐），
> 不声称"最终版"。

```text
┌──────────┬──────────────────────────────┬──────────────┐
│ 名称      │  [     内容输入框      ]      │  [改名][删除] │
└──────────┴──────────────────────────────┴──────────────┘
   ①窄              ②minmax(240px, 1fr)（最宽）        ③窄
```

- **一处结构改动**：每项从"两列（名称+按钮一列 / 内容一列）"改成**三格一行**——
  `PersonaFields` 不再给每项套一个自己的小网格，而是**三张列表各用一个共享网格**
  （`editor-styles.itemList`：`minmax(96px,160px) minmax(240px,1fr) max-content` + `align-items:center`）。
  为什么必须共享：第三轨是 `max-content`（按内容收缩），每项各自成网格时**没有按钮的锁定行**第三轨为 0
  ⇒ 每行中间列宽不同、输入框右边缘参差；共享网格下第三轨取所有行的最大值 ⇒ **每一行三列严格对齐**，
  锁定行只留一个**空的动作格占位**。
- **内容栏的可用下限写进模板**：`minmax(240px, 1fr)` ⇒ "内容栏 ≥ 240px"是**构造上成立**的
  （三栏会把内容压窄，而"内容看不全"正是用户报过的障）。窄视口放不下时宁可整行横向溢出，也不压缩内容栏。
- **底部添加入口也按同一套栅格**：外框从"带边框的面板"改成**只加一条虚线**的横跨行
  （旧面板的内边距会把输入框整体右移 ≈10px，与上面的项对不齐），内部用**同一个列宽常量**。
- **改名态跟着搬**：名称格临时变输入框（仍在第一栏），「确定/取消」进动作栏，原因提示横跨三栏一行。
- **判据**：V17（三格横向 + 顺序 名称→内容→动作 + 三轨网格 + `align-items:center`）、
  V18（`grid-template-columns` 读出"弹性且下限 ≥240px"；控件落在这条轨里；添加入口列宽与列表一致），
  两条都配**阴性对照**（固定窄宽 / `minmax(0,1fr)` / 下限 120px / 两轨 / 名称格挪位 ⇒ 判失败）；
  V19 = V5/V12/V14/V15 全部仍绿 + 全量 **697 pass / 0 fail / RC=0**（≥694）。
- **读数**：`pnpm typecheck` RC=0；`pnpm build` RC=0；tgz 指纹见施工报告 §12。

**D 改动面（红线条条守住）**

- **不动固定层规则**：`validate-identity.ts` 一行未改；`checkCoreFields` / 封存判定原样。
- **不改注入预算**（`PROMPT_CHAR_BUDGET` 仍 2400）；**不做条目级删除**；**不动生产 profile**；
  本轮**未装包、未重启**。
- 客户端半边仍是**单文件 bundle**（模块 id = 包名），相对导入靠构建期内联，未引新依赖。

**返工（同日，用户当轮澄清两点）**

- **返工 1 口径修正**：首版把 V5 理解成"默认态一个输入框都没有、点内容才进编辑态" —— **那不是用户要的**。
  原话逐字：「不是说完全没有输入框，**每项内的内容还是需要有输入框的**，只说每项的名称不要输入框了。
  还是经验教训举例：经验教训（固定无输入框、名称下方有删除按钮）— 经验教训的具体内容（有输入框可更改）」。
  ⇒ **去掉整条"编辑态"机制**（控制器不再有 `beginEdit`/`endEdit`、状态里不再有 `editing`），
  内容区默认就是输入框；名称区永远是纯文字。这是**简化**（少一套状态、少一次点击），不是加开关。
- **返工 2 新功能：人格历史有了保留期**（用户原话：「删除的进历史，要有个**保留天数**，而不是永久保留」）：
  - 新配置项 `modules.persona.historyRetentionDays`（**默认值只加在 `config.ts` 的 schema 里**），
    默认 **30 天**（数字真源是 `persona/constants.ts` 的 `HISTORY_RETENTION_DAYS`）；
  - **`0` 或负数 = 关闭清理**（永久保留，唯一入口，必须显式设置）；负数是非法输入，
    **按 0 处理**（不解释成"立刻清空"：误配一个负号不该把历史全删掉）；
  - **超期清理**，`at < 截止时刻` 的严格小于判定（边界那条保留）；
  - **清理范围窄到表级**：只遍历 / 删除 `persona_history`，记忆条目 / 提案 / 游标 / 人格本体一个都不碰
    （实现只拿到历史表句柄；用例逐表点数）；
  - **触发时机三处**：启动就绪后一次、**每次人格落盘之后**一次（同一批写入合并成一次，
    `createWriteSweeper`）、保留天数被改小之后一次；**永不抛**（维护动作失败只记日志）；
  - 表结构、表名、`supersededBy` 的留档语义**都没变** —— 变的只是生命周期。
- **读数（返工后）**：`pnpm test` 从上一版 **668/0** → **679/0**（净增 11 条：保留期 9 + 界面口径 2），
  基线仍是 **644/0**；`pnpm typecheck` RC=0；`pnpm build` RC=0；tgz 的 sha256 / 字节数 / 文件数见报告。

**验证读数（施工方）**：`pnpm typecheck` RC=0；改动前 `pnpm test` 基线 644 pass / 0 fail / RC=0，
返工后 **679 pass / 0 fail / RC=0**；加上「追加 3（改名）」后 **690 pass / 0 fail / RC=0**；
再加上「追加 4（真机修复）」后 **694 pass / 0 fail / RC=0**；
再加上「追加 5（三栏布局）」后 **697 pass / 0 fail / RC=0**；
`pnpm build` RC=0；tgz 的 sha256 / 字节数 / 文件数见施工报告
`docs/reports/humanity-0.1.13-build.md`（含返工与"追加 3"两节）。V3–V7 另有独立重跑（`qa-evolve`）。

## 0.2.0-rc.2/0.1.12 — 2026-10-09（**未发布**，技能落盘根因修复 + 注记/文档小修）

> **npm 发布为 `0.1.12`；两段式称 `0.2.0-rc.2/0.1.12`**（见上方版本号读法）。
> 本地构建的 tgz 文件名沿用旧口径 `0.1.12+dsh.0.2.0-rc.2`。
> **未部署**：本轮只做到"打好包 + 独立验收"，装包与重启由用户单独拍板。

**A 技能落盘根因修复：新增 Agent 工具 `humanity_skill_persist`（**按调用会话的权限**落盘）**

- **做法**：工具由 agent 调用 ⇒ 那一刻 `exec.agent.session` 在场 ⇒ 用**那次会话**的模式与 cwd
  解析 per-call 沙箱策略（`ctx.sandboxPolicy.resolve({ session })`），连同 `exec.signal` 一起交给
  官方 `ctx.fs.writeText`（第 4/5 个参数）。官方 `dsh-fs-sandbox` 的 `checkedTarget` 逐字是
  `const policy = sandboxPolicy ?? this.ctx.sandboxPolicy.resolve()` ⇒ **per-call 策略优先**。
  同一条缝官方工具在用：`dsh-tool-str-replace-editor/lib/index.js:59-60` 就是
  `resolve(exec) { … this.policy?.resolve({ session: exec.agent.session }) }`。
- **它不是什么**：不是"插件自签更宽模式"。工具**只继承调用会话自己的权限** ——
  `danger-full-access` 的会话能写，`workspace-write`（根不含技能目录）的会话**照样被拒**，
  拒了如实回报并提示"不要重试或绕路"。**部署围栏一个字没放宽。**
- **安全边界（防"修一个洞开一个洞"）**：工具**只接受技能名**，不接受任何路径；目标路径由
  `skills/paths.ts` 的 `skillFile()` 唯一构造（非 kebab-case 名在名字闸就被拒，一次文件系统调用都不发）；
  正文**只从已批准（`applied`）的提案取**，调用方不能自带内容；仍走 `createIfAbsent`，
  目录里已有同名技能**绝不覆盖**。
- **阴性对照**：非 kebab-case 名（`../evil`、`a/b`、绝对路径、大写）⇒ 0 次 fs 调用；
  参数表里**没有** path/内容字段；合法名必然落在 `<DSH_HOME>/skills/<name>/SKILL.md`；
  策略服务缺席而后端会围栏时**拒绝写盘**（与官方工具同一条判断）。

**B1 运行注记：百分比口径与护栏判据**恒等价**（修"显示说 85%、判据说没超"）**

- **现象**：`1755/2065 = 84.988%`，判据（`≥ 0.85`）**不拦**，注记却显示「占 85%（预算充足）」——
  显示与判据互相矛盾（显示层用了 `Math.round`）。
- **修法**：显示改用 **`Math.floor`** ⇒ `floor(ratio×100) ≥ 85 ⟺ ratio ≥ 0.85`（整数翻转点正好在 0.85），
  "显示的百分数 ≥ 85"与"护栏触发"**恒等价**；相邻档位必然分档：**1755 → 84%（预算充足）、
  1756 → 85%（接近上限）**。注记的构造也搬进 `prompt.ts`（与判据、百分比同处一套预算词汇，
  改判据不可能忘记改显示）。

**B2 文档订正**

- README「装完请确认一件事」那句"放宽权限预设技能就能落盘"是**错的**（预设是会话级的，对无会话的
  插件调用不生效）⇒ 改写为「技能落盘」一节：说清根因、正确做法（调用 `humanity_skill_persist`）、
  手动代写路径、以及"没落盘也不影响本次会话（只是关掉会话就没了）"。
- CHANGELOG 补上 **0.1.11 · B** 条目（树内与包内都缺，本轮补）。

**验证读数（施工方，2026-10-09）**：`pnpm typecheck` → **RC=0**；
`pnpm test` → 见施工报告（含改动前基线原文）；`pnpm build` → RC=0；
tgz 的 **sha256 / 字节数 / 文件数**见施工报告。
A 的"可行路"另有**真实 DSH 组件**的隔离实测：不带策略 ⇒ 被拒（复现报障原文）；
带调用会话解析出的策略（`danger-full-access`）⇒ 写入成功；会话策略是 `workspace-write` 且根不含目标 ⇒ 仍被拒。

## 0.2.0-rc.2/0.1.10 — 2026-10-09（**未发布**，自进化接管「人格预算整理」+「记忆维护」）

> **npm 发布为 `0.1.10`；两段式称 `0.2.0-rc.2/0.1.10`**（见上方版本号读法）。
> 本地构建的 tgz 文件名沿用旧口径 `0.1.10+dsh.0.2.0-rc.2`。
> **未部署**：本轮只做到"打好包 + 独立验收"，装包与重启由用户单独拍板。

**本版补的是自进化*本来就该有、但代码里从没实现*的两块**（依据：用户 2026-10-09 的原话
"我最开始的安排是，自进化会自行整理人格、记忆等，达到符合要求。"）。

**A 人格卡装不下时，自进化产出「合并/精简」建议（不再只会报"已截断"）**

- **现象**：注入预算写死 **2400 字符**（`src/host/persona/render.ts`），装不下就截断并在提示词末尾标注；
  而自进化对人格**只有**"并同义条目 + 追加新条目"，**没有**"按预算取舍"⇒ 卡越满，能进提示词的内容越少，
  且它每轮还会很合理地"再补一条"（P-056 的"越整理越长"）。
- **修复**：
  - 每轮开头**现读**一次人格注入预算读数（宿主接 `personaFit`，与提示词拼装共用
    `persona/render.ts` 的同一套拟合，**不在别处重算**）；
  - **仅当超预算**（`truncated === true`）时，在分析提示词末尾追加硬约束：给出
    "可用/已用/多少条未注入"的读数 + **只做整合（合并/精简）、禁止追加新条目**；
  - 写回层再兜一层（`classify-persona.ts`）：超预算时 `personaSections` 一律忽略，只认
    `sectionConsolidations` —— **不指望模型听话**。被校验拒绝仍转提案（现成行为，未新造通道）。
- **可观测（A4）**：运行记录注记写明"已用/预算 字符、多少条没能进提示词、本轮合并同义条目 N 条"。
- **阴性对照**：预算充足时那段约束**一个字都不出现**，且新增条目**照常写入**
  （否则就成了"把补充能力整个关掉"，而不是"超预算时才取舍"）。
- **红线未动**：`PROMPT_CHAR_BUDGET` 仍是 **2400**；固定层不可触碰；被拒转提案照旧。

**B 每轮顺带做一次记忆衰减核算，并记账**

- **现象**：衰减只在**检索路径**顺带触发（`void`、不 await、相隔 ≥24h），自进化完全不参与记忆维护 ——
  生产库 98 条记忆全 `active`、0 归档，"维护"基本等于"没人看得见"。
- **修复**：
  - 自进化每轮在**门禁之前**顺带跑一次核算（不依赖扫描与模型路由），报告写进运行记录：
    `记忆维护（本轮顺带核算）：扫描 N 条，受保护 P 条，未到期 F 条，降权 D 条，归档 A 条`；
  - 报告新增 **"未到期"** 一档：旧报告只有扫描/受保护/降权/归档，"扫了 98 条却一条没动"分不清是
    *都没到期*还是*都被保护*，自进化每轮记账之后这个区别必须看得出来；
  - 新增可配项 **`memory.advanced.decayUnusedDays`**（**默认仍 90**；值取自 `memory/constants.ts`，
    唯一真源，配置 schema 里只做接线，不另抄一个数字）。
- **阴性对照**：`advanced.decay=false`（含记忆模块 `mode=off`）时**不进核算入口** ——
  库里条目一个字都不动，运行记录里也不出现那行报告（"跑了但什么都没做"与"根本不该跑"必须分得开）。
- **红线未动**：受保护规则（`user-stated` / `importance ≥ 4` / `pinned`）一字未改；90 天默认未改；
  归档仍是**可恢复的状态位**，不做任何删除。

**验证读数（施工方，2026-10-09）**

- `pnpm typecheck` → **RC=0**；
- `pnpm test` → **tests 622 / pass 622 / fail 0**（改动前基线 **615 / 615 / 0**，净增 7 条新用例，
  逐条对应 `docs/plans/humanity-0.1.10-evolution-fit.md` §4 的 V1–V10，含 V4/V7 两组阴性对照）；
- `pnpm build` → RC=0，产出 `lib/index.js` + `lib/client.js`；tgz 的 **sha256 / 字节数 / 文件数**见施工报告。
- ⚠️ **本轮不装包、不重启**；源码树与生产安装目录分离（改动前已做整树快照，路径见施工报告）。

## 0.2.0-rc.2/0.1.9 — 2026-10-05（**未发布**，修"整理一直失败" + 记忆静默截断）

> **npm 发布为 `0.1.9`；两段式仍称 `0.2.0-rc.2/0.1.9`**（见上方版本号读法）。
> 本地构建的 tgz 文件名沿用旧口径 `0.1.9+dsh.0.2.0-rc.2`（本部署就是用它装的）。

**本版修的是用户报障的那条链**（工作台「最近行为 · 失败」+「今日 0 / 20 次调用 · 0 tokens」）。
**未部署**：装/重启由用户定（很可能与 0.1.8 攒一次重启）。

**修① 自进化：状态表从未被创建 ⇒ 每一轮整理起手就失败**

- **现象**：`evolution_runs` **12 条全 `failed`**、扫描/记忆/提案/计费**全 0**、单次 **26–101 ms** 就结束；
  12 条 `error` **同一句**：`domain 'humanity' table 'evolution_state' has no record 'main' to update`。
- **根因**：`mutateState` **无条件 `update(STATE_KEY)`**，而**全库没有任何一处对该表 `put()`**
  ⇒ `evolution_state` 表从来没被创建；官方 `dsh-storage-domain` 的 `update` 语义是
  **记录必须已存在**（`missing-key`）。读侧有出厂值兜底 ⇒ **症状被掩盖**，工作台只看得出"失败"。
- **修复**：`createEvolutionState` 里加**记忆化的 ensure-once** —— 首次 `mutateState` 前若
  `state.get(STATE_KEY) === undefined` 就 `put(STATE_KEY, STATE_INITIAL)`，随后照旧 `update`。
  - **为什么不是"先 put 出厂值、再拿同一个 patch 去 update"**：那会把**函数式 patch 算两次**
    （`dailyCalls + 1` 变成 +2），污染每日配额账本 —— 一种看不见的双计。
  - **读侧 `readState` 一字未动**（出厂值兜底照旧，坏一条状态不该停模块）。
  - **ensure 失败不缓存**：一次瞬时存储故障不该把状态写入永久卡死。
- **同一根因的另外两处一并转好**：`dailyCalls` 不再是恒 0（"20 次/日"额度恢复记账与生效）、
  `nextRunAt` 能落盘（定时模式的重启补跑恢复）。
- ⚠️ **本轮不修、下一版处理**：空闲触发的"必须有新活动才跑"闸有个死角 ——
  **上一次空闲运行失败后、若之后无人使用，它不会重试**（详见 `docs/reports/fix-019.md` §7）。

**修② 记忆写入的静默截断**

- **现象**：正文硬切到 **200 字**，**不报错也不标注**，调用方收到成功回执。
  生产者实测：用户库里 56 条记忆 **最长 200 / 中位 200 / 恰好 200 的 33 条（59%）**、`>200` 为 0
  ⇒ 200 不是"上限"，而是**绝大多数写入的切割点**。
- **修复**：上限提到 **2000**（依据：本10倍余量、体积可控、注入侧按条 + `maxInject=3` 不受影响）；
  且截断**必须说出来**：回执 `message` 写明"原 N 字 → 存 M 字 + 怎么办（拆条 / 会话检索）"，
  工具返回值新增 `truncated` 位（输出 schema 同步登记），自进化那条路把条数写进**运行记录**的注记。
- ⚠️ **不改历史数据**：用户库里那 33 条已存正文**一个字都没动**；本修复只约束**以后的写入**。

**追加修③ 测试替身与真后端语义对齐**（缺陷① 之所以能瞒过全部单测的原因）

- `test/helpers/evolution-fake.mjs` 的 `update` 原本**缺失即补建**（注释还自称"与官方同语义"），
  真后端是**缺失即抛** ⇒ 全部 evolution 单测跑在一个"永远不缺记录"的世界里。
- 改成同语义。**自证**：只改替身、不改产品代码时，既有 evolution 用例**大面积变红**
  （新边界用例 5/7 红、既有套件 15+ 红）；修完①后**全绿**（125/125）—— 这条链的证伪能力被修回来了。

**追加修④ 工作台的"存储就绪"不再硬编码**

- `section-runtime` 原写 `{ ...deps.status(), storeReady: true }` —— 是**断言**不是**测量**
  （排查时它显示"就绪"，而当时所有状态写入都在抛错）。现在值由宿主从真实句柄现算（`index.ts`）。

**测试**：新增 `test/evolution-state-init.test.mjs`（7）+ `test/memory-truncation.test.mjs`（7）
+ 全量回归 **615 pass / 0 fail**、typecheck 0 error（0.1.8 基线 601）。

## 0.2.0-rc.2/0.1.8 — 2026-10-05（**未发布**，两条精确性小修：空锚点 / 超长）

> 文件名/`version` 落地为 `0.1.8+dsh.0.2.0-rc.2`（见上方版本号读法）。

**触发面：只有本就异常的字段值** —— **用户卡的常见形态**（`本名：「示例」；别名：「例子」`）走的仍是正常分支，
输出**未变**。本版**未部署**：装/重启生产由用户批准后另行执行。

**缺陷① 空锚点返回标点**（`docs/reports/deploy-execution.md` §12.3 实测）

- 输入 `本名：；别名：` ⇒ 0.1.7 的 `identityNameOf()` 返回 **`"："`** ⇒ 身份行变成
  `我是运行在 DeepSeek Harness 里的一台机器上的「：」。` —— **比降级更糟**（降级只是不写名字，
  这个是写了个假名字）。
- 根因：锚点正则的**裸值分支**会把标签后面那个冒号本身抓成"名字"
  （`：` 不在该分支的排除集里，`\s*[:：]?\s*` 会回溯成不消费它）。
- 修复：在取名路径的**唯一闸口** `clean()` 上加判据 —— **必须含至少一个实义字符**（字母/数字/汉字），
  纯标点与纯空白一律当作"没写"⇒ 降级。放在闸口而非只改正则：那里能堵住**所有**取名路径，不只这一种形状。

**缺陷② 超长值被截断当名字**（同 §12.3；实测口径与报告描述不同，见下）

- 0.1.7 在 **25–120 字**这一段会把值切成 `前 24 字…` 塞进身份行；
  而同一文件的注释（`NAME_FIELD_MAX`）写的是"此时正确的动作是**降级成不写名字**，
  而不是从里面截出 24 个字当作名字"，既有测试的标题也写着"超长 ⇒ 降级" ⇒ **实现与自家口径不一致**。
- ⚠️ 实测订正：§12.3 记的触发条件是"**>120 字**"，实跑并非如此 —— `>120` 字走的是
  `NAME_FIELD_MAX` 那道闸，**0.1.7 就已经降级**（121/130/400 字实测均 `undefined`）。
  真正截断的是 **25–120 字**这一段。缺陷成立，但报告里的阈值不准。
- 修复：`IDENTITY_NAME_LIMIT`(24) 从"截断点"改成"**准入判据**" —— 名字超过 24 字**就降级**，
  不再截断。两道闸（120 与 24）口径统一为**只降级、不截断**；身份行里**永不出现**截断标记 `…`。

**附带发现的第三条（同源同害，一并修）**

- 输入 `「小安」和「小亮」`（多个引号段、无标签）⇒ 0.1.7 返回**整串**，身份行变回
  `「「小安」和「小亮」」` —— 正是 0.1.7 刚修掉的 P0-4 旧病形态。
- 根因：规则 3（"无引号段 ⇒ 整串收下"）**漏写了"无引号段"这个前提**
  （文档规则 2/4 都白纸黑字写着它），于是多引号段的值掉进该分支被整串收下。
- 修复：补上 `quoted.length === 0` ⇒ 落入"不猜"分支降级。

**测试**：新增 `test/persona-name-edges.test.mjs`（13 条，专钉异常侧）+ 全量回归
**601 pass / 0 fail**、typecheck 0 error（0.1.7 基线 588）。

**产物**：`deepseek-harness-humanity-0.1.8+dsh.0.2.0-rc.2.tgz`（sha256 与字节数见
`docs/reports/fix-018.md` 与包旁 `BUILD-INFO.txt`）。

## 0.2.0-rc.2/0.1.7 — 2026-10-04（**未发布**，修姓名取值缺陷：真实数据暴露）

> 文件名/`version` 落地为 `0.1.7+dsh.0.2.0-rc.2`（见上方版本号读法）。

**⚠️ 这一版是被**生产真实数据**揪出来的** —— 合成 fixture 没覆盖到的形态。

**缺陷**

生产部署后，容器里的人格段写着：

```
我是运行在 DeepSeek Harness 里的一台机器上的「本名：「示例」；别名：「例子」」。
```

**根因**：`identityNameOf()` 取了固定层「姓名」字段的**整个值**。而用户卡里该字段的值
**本身就是一整串**（含「本名：」「别名：」标签与 `；` 分隔符 —— 现实里很正常的写法），
于是**整串被当成名字**塞进身份行。

**为什么 lab 没抓到**：lab 用的是**合成卡**，姓名只有「小安」两个字 ⇒
**合成 fixture 覆盖不到真实数据形态**。**"拿合成数据验过"不等于"对真实数据成立"。**
（这条已记进项目知识库。）

**修复**（`src/host/persona/render-content.ts`）

- 新增 `parseNameFromField()`：**优先解析常见形态** —— `本名：「X」` / `本名：X` / `本名 X`
  （含 `姓名` / `名字` / `名称` / `全名` / `昵称` 同类标签；半角/全角冒号都认），
  无标签时若整串只有**一对**引号段（`「X」` / `"X"` / `'X'`）则取其中内容；
  既无标签、也无引号段、也不含分隔符 ⇒ 视为本来就是个干净名字（「小安」这种最常见形态）。
- **判不出来就降级**：返回 `undefined` ⇒ 身份行只写「一台机器上的一个 AI」，
  **绝不把整串塞回去、也绝不编一个名字**。判不出来的情形包括：含标签但解析不出、
  多个引号段分不清哪个是名字、**多行**（不猜哪一行是名字）、字段值 > 120 字（不可能是名字）。
- **保留既有清洗**：单行、长度上限 24（超长截断 + `…`）、控制字符与 `{{` 仍由上游处理。
- 顺带修掉一处自己引入的缺陷：上一版先截断输入再解析，会把 `本名：「很长的名字…」` 的
  收尾引号切掉、白白降级。现在改为**先解析、再把名字限长**。

**验证**

- 机械门：`pnpm test` **588 pass / 0 fail**；`pnpm run typecheck` 0 error
- 新增/更新 5 条测试（`test/persona-prompt.test.mjs`）：
  **用户卡常见形态** `本名：「示例」；别名：「例子」` ⇒ 恰好取到 `示例`（断言名字里不含标签与分隔符）；
  简单形态；引号/无引号/半角冒号/别名在前；多行 ⇒ 降级；超长 ⇒ 降级；
  以及一条**防回归不变式**：**任何输入都不许把整串标签塞进名字**（覆盖 15 种输入）。
- lab 验证（与用户卡**同形态**的 fixture 跑一次）：见 `docs/reports/name-fix.md`

## 0.2.0-rc.2/0.1.6 — 2026-10-04（**未发布**，F3：一条坏记录不再害死整库）

> 文件名/`version` 落地为 `0.1.6+dsh.0.2.0-rc.2`（见上方版本号读法）。

**⚠️ 定位先说清**：生产当前 **52/52 条记录全部合规**，**用户没有实际踩到这条**。
本版是**加固** —— 防的是"未来某条旧代/损坏记录让整场失忆"。**不要把它说成"修了用户当下的问题"。**

**背景**：存储里**任何一条**记录过不了当前 schema ⇒ `facility.open` 抛 `invalid-record` ⇒
**整个领域打不开** ⇒ ① 每轮注入假声明（`0.1.5` 的 F1 已治）② **`humanity_recall` 整场查不到记忆**
（本版治的就是这条）。

**修复**

- **F3 逐记录容错**（`src/host/store-open.ts`）：新增 `tolerantRecord()` —— 把每张表的记录 schema
  包成 `z.union([正常schema, 哨兵.catch(...)])`。坏记录**解析成哨兵**而不是抛错 ⇒ 领域照常打开、
  好记录照常加载；随后 `purgeUnreadable()` 逐表扫描，把哨兵**摘掉**并**直写 stderr 点名**
  （键 / 表名 / 原始值 / "原始值只在这行日志里" 的提醒）。
- **为什么不用官方的 `invalidRecords: 'backup-and-skip'`**（实测结论，已写进代码注释）：
  该选项要求后端实现 `KvUnit.backupRecord`（把坏记录的**文档**挪走），而我们的 JSON 后端是
  **`single` 布局**（整库一个 `humanity.json`），`single` 布局的单元类**没有** `backupRecord`
  （`dsh-storage-json/lib/index.js` 里只有 `per-record` 单元实现它）⇒ 该开关**降级为"整域拒绝"**，
  也就是"一条坏记录害死整库"本身。**实测确认：单布局下这个开关帮不上忙。**
- **代价（写在明处）**：坏记录**不会**被物理挪走（single 布局没有"挪走一条"的介质操作），
  它仍留在盘上、只是在内存里被替换成哨兵、之后被删除。**数据不丢**（原始值已进 stderr），
  但盘上那份要人工清理。这个取舍好过"整库打不开"。
- 记录**形状迁移**（任务里的 b）**未做**：本轮先把"整库不可用"这条链切断；形状归一化是独立一件事，
  见 `reports/f3-fix.md` 的未验证项。

**验证**

- 机械门：`pnpm test` **585 pass / 0 fail**；`pnpm run typecheck` 0 error
- 新增 `test/store-invalid-records.test.mjs`（4 条，**真实** `dsh-storage` / `dsh-storage-json` /
  `dsh-storage-domain` 组合）：① 无坏记录（正常路径不受影响）② 一条坏记录（领域照常打开 +
  被隔离 + 好记录仍在 + stderr 点名）③ 多条 + 跨表（`memory_entries` 与 `persona_history`）
  ④ 坏记录在历史表 ⇒ 记忆表不受牵连
- lab 验证（含坏记录的存储上 `humanity_recall` 仍能查到好记录）：见 `reports/f3-fix.md`

## 0.1.5 — 2026-10-04（**未发布**，F1/F2：存储打不开不再撒谎、且故障可见）

**背景**：`humanity` 存储域只要**打不开**（一条记录不符合 schema 就够），插件就**静默降级**为
"本次无持久化" ⇒ `state.store` 永不赋值 ⇒ 文档回落成**空默认文档**（`initializedAt === ''`）
⇒ **每轮注入 `UNINITIALIZED_PROMPT`（「人格尚未初始化…」）** —— 那是一句**假声明**：
用户可能早就初始化过，只是这一轮读不到。同一根因还让 `humanity_recall` **整场**回
"存储尚未就绪"。外部表现是"整场失忆"，而容器日志干干净净。

**修复**

- **F1**（`src/host/persona/index.ts`）：`ready` 从 `section.attached` 改为
  **`section.attached && deps.store() !== undefined`**。
  存储读不到的那几轮**返回空串**（什么都不注入），而不是注入一句假话。
  注意 `prompt-render.ts:42-44` 本来就是为这件事写的注释（"那份空文档不代表用户没初始化过"），
  只是当时 `ready` 没把存储算进去。
- **F2**（`src/host/store-open.ts`，两处：声明非法 / 打开失败）：日志改走 **`reportBootFailure`**。
  它**除了**日志门面还**直写 stderr** —— 因为部署容器的 `ctx.logger` 输出**不进 `docker logs`**
  （`src/host/log.ts` 有实测记录），这两条最要命的日志过去在容器里**一个字都看不到**。

**⚠️ F1 与 F2 必须同版本上线**：F1 的唯一"减法"是存储永久打不开时**不再撒谎、也不再有任何提示**
（故障更安静）。F2 就是把可观测性补回来的那一半。只上 F1 = 把"撒谎"换成"沉默"，更糟。

**验证**

- 机械门：`pnpm test` **581 pass / 0 fail**；`pnpm run typecheck` 0 error
- 新增 8 条测试：
  - `test/persona-ready-gate.test.mjs`（5 条）：**三态**走真实 `installPersona` ——
    ① 存储未就绪 ⇒ **空串** ② 就绪+未初始化 ⇒ 引导语 ③ 就绪+已初始化 ⇒ 人格段；
    另有"绕过 gate 会真的出现那句假声明"的**防倒退钉子**，与"`attached` 也必须算进去"的反向断言。
  - `test/store-boot-visible.test.mjs`（3 条）：`log.error` 不进 stderr 而 `reportBootFailure` 进；
    `openDomain` 打开失败 ⇒ **stderr 留一行**且降级返回 `undefined`（G-002 不抛）。
- lab 验证（含坏记录的存储）：见 `reports/f12-fix.md`

## 0.1.4 — 2026-10-04（**未发布**，修 `0.1.3` 的 P0-4 残项）

**修复**

- **P0-4 的姓名改为从人格卡固定层字段取**（`src/host/persona/render-content.ts`）。
  `0.1.3` 把名字写死成「小安」，而人格卡是可换名的 —— 换名后同一段提示词里会出现**两个名字**。
  现在取 `CORE_IDENTITY_KEYS[0]`（即「姓名」）的值。
  - **清洗**：只取字段值的**第一行**（身份行是 `head` 里的原子行，字段值多行会把一句话劈成两行）、
    再裁到 **24 字符**（超长截断，不报错；不复用 120 的条目级上限，因为那是"一条条目"的口径）。
    控制字符/ANSI 与 `{{` 已在 `collectPersonaContent` 里预处理，不重复做。
  - **降级（明确）**：取不到姓名时**不编名字、也不留占位符**，只删掉名字那一小块，
    句子其余部分逐字保留 ⇒ `我是运行在 DeepSeek Harness 里的一台机器上的一个 AI。`
    理由：随便填一个名字就是把假信息写进身份层（这正是本条要修的毛病）；
    写「（未设置）」之类占位符会被模型当内容念出来；而身份陈述的价值在"承认载体 + 否认扮演"，
    名字只是锦上添花。
  - 形态不变：第一人称、承认载体、**不承认"扮演"**。

**验证**

- 机械门：`pnpm test` **573 pass / 0 fail**；`pnpm run typecheck` 通过
- 新增 2 条回归：① 降级（无姓名时不编名字、不留占位符）② 清洗（多行/超长/`{{` 不破坏身份行结构）；
  并把 P0-4 原测试从"名字写死「小安」"改为"等于卡里的值"
- 产物：`deepseek-harness-humanity-0.1.4.tgz`（sha256 / 路径见 `reports/p0-changes.md` §10）
- 产物 diff：与 `0.1.3` 逐字 diff，**差异只有姓名取值这一处**（见报告 §10）

## 0.1.3 — 2026-10-04（**未发布**，破戏 P0 改动）

在 `0.1.2-adapt020` 基础上做「破戏」P0 四条。**只改提示词文本与一条记忆引导语，不动任何接线与数据面。**

**变更**

- **P0-1**（`src/host/memory/inject.ts`）：删掉记忆引导语末句里的「扮演场景」措辞。
  原句一边要求"如实说明不在记忆里"，一边把整件事称作"扮演场景"——提示词自己在教模型"你在扮演"。
  删后只保留前半段语义（已由上一句"不得把即兴发挥…当作记忆陈述"承担）。
- **P0-2**（`src/host/persona/render-content.ts`）：给退让条款**加限定域**。
  原文「作为默认倾向，不覆盖当前对话里的明确要求」**没有作用域**，于是"你是扮演的"这类元信息一旦
  出现在对话里就有资格压过身份层。现在明确它作用于**任务与偏好层面**、**不作用于身份层**。
- **P0-4**（同文件）：人格段开头补一句**第一人称身份陈述**（承认载体、不承认"扮演"）。
  位置必须在 `humanity:persona` 段内——官方 `deployment:persona-prefix` 槽会被 `identity-layer`
  按名摘除，写在那里等于死配置。
  顺带补回一个 2026-10-06 正文换稿后失去的锚点：旧版独立判断正文自带「你已经有自己的身份和性格
  （来自人格卡）」，新版正文不含锚点，"防模型拿独立判断拒绝用户设定"这条防线当时只剩注入时机一层。
- **P0-5**（同文件）：人格段内加**元信息抑制**条目（不主动谈论插件/设置/记忆文件、不说"我在扮演"）。

**验证**

- 机械门：`pnpm test` = **570 pass / 0 fail**（基线 568 + 本次新增 2 条回归）；`pnpm run typecheck` 通过
- 产物：`deepseek-harness-humanity-0.1.3.tgz`，sha256 `62dbdaef11dc10f32954d254507c43527d58ccfdea1987db43b118af3ca6bb7c`，
  123 个文件，文件清单与 `0.1.2-adapt020` 包逐项一致
- 注入实测：四条改动**逐字**出现在 lab 会话的 `system/message` 人格段里（见项目报告 `reports/p0-changes.md`）
- ⚠️ **未做**：带人格卡的行为对照（lab 里人格段注入不稳定，见该报告的不确定性清单）

**已知限制（残项）**

- ~~P0-4 的身份陈述里**写死了「小安」**~~ —— **已在 `0.1.4` 修复**（改为从固定层 `姓名` 字段取，见下）。

## 0.1.2-adapt020 — 2026-10-02（**未发布**，本地适配构建）

**新增**

- 支持 DSH **`0.2.0-rc.2`**：把 `peerDependencies` 里 6 个官方 seam 的范围从 `^0.1.5-rc.2`
  放宽为 `^0.1.5-rc.2 || ^0.2.0-rc.2`（`^0.1.x` 的上界是 `<0.2.0`，不放宽会在启动时被
  运行时兼容门**拒绝挂载整个 bundle**）。
  失败形态：人格卡从 system prompt 消失、工作台页面消失、`remember`/`recall` 工具消失；
  **数据不受损**（插件被拒绝启动，而不是启动后出错）。

**验证（靶机 `隔离靶机`，DSH 0.2.0-rc.2）**

- 机械门 `sh scripts/verify.sh`：**568 pass / 0 fail**
- 插件挂载成功：`dsh --profile web --dump-config` 无 skipping；页面 boot payload 含本插件
- 数据面 `POST /api/humanity/describe`：`writable: true`，四个命名空间齐备
- 写入持久化：空 patch 写入后修订号递增（`humanity` 2→3、`humanity-persona` 3→4），**重启后仍在**
- 数据零丢失：`storages/humanity.json` 六表 6/35/20/7/10/1，与升级前逐项一致（只增不减）
- 官方 0.1.7-rc.2 → 0.2.0-rc.2 的 API 面差异：**0 删除 / 0 改名**（283 包逐包导出符号 diff，
  含 842 个 exports 子路径与 Cordis service 名）

**已知限制（残项）**

- `devDependencies` 仍钉在 `^0.1.5-rc.2`，故仓库 `pnpm typecheck` 跑的是 0.1.5 的类型；
  0.2.0 把 `dsh-client-ui-primitives` 的 `Input` 从函数组件改成 `ForwardRefExoticComponent`，
  类型面差异未在门里覆盖（运行时 JSX 兼容，官方导出名全部保留）。
- 工作台**渲染回归**未自动验证：验证环境无浏览器，仅做了静态契约核对
  （客户端运行时只 require `react` / `react/jsx-runtime` / `dsh-client-ui-primitives`，三者均由外壳提供）。

## 0.1.2 — 2026-09-28

**变更**

- **改名**：「反谄媚」这个说法整体退场，统一叫**独立判断**。对外可见的只有代码里的名字
  （配置项 `antiSycophancy` → `independentJudgment`、客户端字段与组件名），界面上的标签仍是
  「🧠 独立判断模式」，开关位置与行为不变；提示文字更新为「以事实与证据为准，不迎合、不编造」。
  ⚠️ 用旧键名 `antiSycophancy` 改过设置的用户，升级后该键不再生效、回落到默认值**开**
  （默认就是开，所以功能默认不受影响；要关请在新开关上关一次）。
- 「独立判断模式」正文换稿：由用户 2026-10-06 重新定稿，逐字采用
  「以事实、逻辑和可验证证据为最高依据 … 优先提供可核查的答案」那一版（含首行标题「# 独立判断模式」）。
  要求从"不要谄媚"改为**可验证性**：区分事实/推断/观点、信息不足就说不确定、有新证据就修正结论。
  注入时机不变（固定层封存后才注入、开关默认开、永不截断）。旧的"人格卡锚点 + 反谄媚清单"措辞整体退场。

## 0.1.1 — 2026-09-26

**修复**

- 身份卡的封存入口：原来"封存"只发生在**首次保存**，于是预填 / 旧数据那种"已初始化但未封存"的卡
  在界面上**永远封不上**（独立判断开关一直是灰的）。现在未封存时卡片标题旁有明确的「封存」按钮，
  走的是同一条保存路径（本机校验 + 修订号 + 宿主拒绝原样显示）。
- 「未初始化」这个标签用词错了：它判的是**封存**状态，现在显示为「未封存」（英文 Not sealed）。
  说明文案同步改写，写清"填完点封存"这件事。

## 0.1.0 — 2026-09-26

首个公开发布版本。

**支持的 DSH 版本**：`0.1.5-rc.2` / `0.1.5-rc.3`（Node ≥ 22）。
`0.1.7-rc.*` 尚不支持 —— 0.1.7 移除了插件注册设置页所用的 `installSection`，
在那个版本上工作台会读不到数据（Agent 工具与提示词注入不受影响）。

**包含**

- **人格**：固定层（身份卡，对 Agent 封存）+ 可变层（8 个标准小标题）+ 用户定义；
  注入带字符预算与逐条降级，工作台显示"进提示词 N/M 条"；可一键关闭独立判断模式。
- **记忆**：三层作用域（长期 / 区域 / 会话）、自动写入、敏感内容待确认、冲突只标记不解决、
  衰减归档、近似去重（本地判据，不调用模型）、工作台合并与撤销。
- **技能**：自进化总结出的技能可在工作台编辑、停用、恢复（落盘到官方技能目录）。
- **自进化 / 梦境**：空闲/定时/手动触发，扫描新会话 → 模型解析 → 低风险自动写入、
  高风险只出提案等批准；逐项记账与每日调用上限；运行时间线与梦境叙事。
- **工作台**：侧栏入口（有待确认时带红点）+ 总览 + 四个页签，全部使用 DSH 官方 UI 原语与设计令牌。
- **数据**：版本化存储领域 `humanity`，跟随 `$DSH_HOME` 迁移；卸载插件不删数据。

**已知限制**

- 极简模式（`minimal` preset）下 DSH 平台会跳过插件注入，人格与记忆不生效（工作台会显示原因）。
- 技能落盘需要放宽 DSH 权限预设（工作区之外的写入）。
- 0.1.7 适配中；跨版本迁移工具（导出/导入）尚未提供。