维护者确认：PR #3745 会话级只读 library extraDirs（产品 / 插件基座 / 规则）

[MagicLizi]

PR：#3745
作者：PraiseZhu
标题：feat(desktop): 会话级只读 library extraDirs，ChatInput 不计系统槽

这条改动触发了维护者确认门，需要维护者在 PR 上明确表态后才能继续合并。

为什么要确认

1. 产品 / UI：composer 额外目录会出现不可移除的系统项「Mivo 作品库（只读）」，且该槽不计入用户 10 个目录名额。这是用户看得见的交互与配额语义变化。
2. 插件基座：改到 libraryVault / librarySlot / cindySlot / imageChannelRegistry 以及相关握手字段（authorizedReadonly / libraryGeneration / libraryIdentity）。插件基座一次作用到全部已装插件，不吃 bugfix / 纯技术改动豁免。请核对升级后用户什么都不做时，已装 / 已批准 / 已启用的插件是否照旧可用，新字段有没有从旧授权事实 backfill。
3. 规则文档：改了 docs/dev-rules/plugin-library-storage.md，审查判据本身也变了。
4. 架构体量：核心路径约 894 行，总 diff 约 2782 行，涉及三 harness 的 extraDirs 注入。

请维护者怎么做

• 同意当前方向与范围：直接在 PR feat(desktop): 会话级只读 library extraDirs，ChatInput 不计系统槽 #3745 上 Approve。
• 需要修改：在 PR 上 Request Changes，写清要改什么；作者改完后再 Approve 即放行。
• 普通评论、摘标签或讨论 issue 里的口头同意都不构成通过。

CI 目前未全绿，还有未 resolve conversation。即使确认通过，也要等这些卡点清掉后才能合。

---

关联 PR:#3745(作者 @PraiseZhu);本 issue 由 review-pr 流程自动创建,用于先讨论该 PR 涉及的产品 / UI 变更,维护者确认后 PR 会恢复推进。

[dash-s-cindy]

判断：这项能力具有明确的产品价值，值得继续推进，但当前不应直接批准 #3745。PR 将已经合入的持久 Library 基座接入 Mivo 会话级只读引用目录，使 Claude、Codex、Pi 等 harness 可以通过受控 extraDirs 原生读取作品库正本，同时将该系统项从用户 10 个目录的配额中排除。真正需要处理的是集成链路和兼容性一致性，而不是重新设计 Library 基座。

行动：建议在 PR #3745 上 Request Changes。修复并完成针对性验证后，再由维护者在该 PR 上 Approve；同时仍需清理 CI 失败和未 resolve conversation。Issue 中要求“同意方向即可 Approve”的流程说明，不能替代对当前实现状态的审查。

已确认的现有基础

当前主干快照 8a0d7795a28f6e36a52cf6a7ff68274f36a78009 已经包含持久 Library 的通用基座：

• apps/desktop/src/main/cindy-brain/libraryVault.ts：受控路径、原子写、文件身份复核、分块读写和不可用状态处理；
• apps/desktop/src/main/cindy-brain/librarySlot.ts：插件资格审查、owner scope 绑定、binding 解析、Library 请求分派和数据库服务；
• apps/desktop/src/main/cindy-brain/index.ts：Library slot 单例、生命周期挂点，以及账号边界时的 getGhostLibrarySlot().disposeAll()；
• docs/dev-rules/plugin-library-storage.md：当前权威规则，明确要求 owner 隔离、相对路径、不可用不伪装为空，以及生命周期和迁移安全。

这些代码证明 Cindy 已具备插件持久 Library 能力，也证明账号边界的基础收口已经存在。但在该快照中未检索到以下本 PR 新增概念：authorizedReadonly、libraryGeneration、libraryIdentity、cindy-library: 和 applyLibraryReadonlyExtraDir。因此 #3745 仍是尚未合入主干的集成变更，不能把 PR 描述中的测试结果视为当前发布版本已经具备的行为。

当前 PR 的实质阻断点

PR #3745 的公开审查讨论给出了两项可直接改变合并决定的问题：

1. Library 只读目录注入入口没有生产调用方

   PR 在 apps/desktop/src/main/maker-ipc/register.ts 中加入了统一目录授权入口，但审查指出 applyLibraryReadonlyExtraDir 没有生产调用方。若该结论在 PR 最新提交中仍成立，则 library ready 时不会把当前作品库注入 Mivo 会话，迁移根目录、解绑或卸载时也不会同步更新/撤销该系统槽。这样新增的 cindy-library: 目录和三 harness 原生 Read 路径虽然存在代码接口，却不会在真实生命周期中生效。

   这不是单纯的“未来可能漏接线”，而是会使 PR 声明的核心用户价值无法成立。应先沿 library ready、位置迁移、解绑、卸载和账号切换的真实调用链确认：注入、更新、撤销都发生在正确的 owner 和会话上，并且不会把旧 owner 的目录留在活动会话中。

2. Codex 旧版本降级可能造成运行时与持久化状态分离

   审查还指出，packages/maker-core/src/agents/codex/index.ts 的旧 app-server 兼容路径在不支持只读引用目录时可能静默忽略 setExtraDirs，但仍让上层认为操作成功并持久化新目录。结果是 UI/数据库显示 Library 已授权，而活动 Codex 会话实际无法读取该目录。

   这与仓库已有的兼容性口径冲突：配置状态必须描述实际执行状态，不能采用“运行时没生效、下次仍按已授权恢复”的双重事实。可接受的方向是让不支持的版本显式失败并阻止持久化，或实现一个经过明确产品确认、且运行时和落盘语义完全一致的降级方案；不能继续静默成功。

存量插件与协议兼容

PR 新增握手字段原则上属于 additive 协议扩展，旧插件忽略未知字段这一点本身是合理方向；但 Issue 要求确认“已装、已批准、已启用插件升级后用户什么都不做仍照旧可用”，目前材料不足以证明这一点：

• 新字段如何从旧授权事实 backfill，当前主干只能确认存在通用的历史插件批准迁移机制，不能据此证明本 PR 的只读 Library 授权事实已经正确接入；
• 三 harness 对 extraDirs 的消费方式不同，且 Codex 有版本门，不能用单一单测替代跨 harness 验证；
• PR 自述未启动 Desktop 实机，Mivo 端到端回执链路也不在本仓，因此尚未证明真实会话中的注入、resume/fork、版本降级和撤销行为。

这里不应因为缺少某个 backfill 代码片段就直接推导出必须新增某种迁移限制；需要作者明确说明旧授权事实、新字段默认值/backfill 规则以及失败时的状态口径，并用测试证明。若既有授权事实并不包含 Library 只读目录，则应保持旧插件原有能力不变，而不是把新能力静默伪装成已授权。

建议的修改与验证门槛

请作者在 PR 中补齐以下证据后再重新请求维护者确认：

1. 接通 library ready 到当前会话的只读 extraDirs 注入，并覆盖迁移位置、binding 变化、解绑、卸载、停用和账号切换时的更新/撤销；

2. 在 Codex app-server 不支持只读引用目录时禁止静默成功，确保运行时实际应用结果与 DB/UI 持久化结果一致；明确版本门、错误提示和后续重试语义；

3. 明确 authorizedReadonly、libraryGeneration、libraryIdentity 的兼容规则，包括旧授权事实的 backfill 或“不产生新授权”的默认行为；

4. 验证已装、已批准、已启用的旧插件升级后无需重装、重新批准或重新配置仍可用；未声明 library 的插件保持原行为；

5. 补充 Claude、Codex、Pi 的新建会话、resume/fork、运行中更新和旧版本不支持路径测试；

6. 补做 Desktop 实机验证，至少覆盖 Mivo 会话中系统项显示、不可移除、用户目录满 10 个时的计数，以及 Library ready/迁移/撤销后的实际可读性；Mivo 侧不在本仓的回执变化应由配套仓库给出联调证据；

7. 执行仓库规则要求的最小验证：

   pnpm --filter desktop exec vitest run src/main/cindy-brain/__tests__/library
   pnpm --filter desktop typecheck

   并在 PR 中区分直接相关测试、CI 环境性失败和未执行的实机/跨平台验证。

相关记录

• PR #3079：已合入的持久 Library 基座，建立了 library 槽、owner-scoped 存储、生命周期、迁移和规则文档；其兼容结论是未声明 library 的旧插件行为不变。它是本 PR 的直接基础，但没有覆盖会话级只读 extraDirs 注入或三 harness 运行时接线。
• PR #3745：当前待审集成变更，包含系统只读槽、握手字段、三 harness extraDirs 消费和 ChatInput 配额语义；公开讨论中仍有生产调用链和 Codex 状态一致性问题，因此应先 Request Changes。
• Issue #3633：此前 Library reveal/saveAs 变更的维护者门控记录。该记录确认 Library 基座已有 owner 隔离和异步边界审查要求，也说明“旧插件不调用新 op”不能替代新增异步路径的真实验证；与本次同属 Library 插件基座审查，但不构成当前注入问题的重复报告。

[MagicLizi]

维护者确认已通过,讨论结束,PR 恢复正常推进。关联 PR:#3745(https://github.com/makecindy/cindy/pull/3745)。本 issue 由 review-pr 流程自动关闭。