[KuramiWan]

Desktop Change（桌面端改动）

What changed（改了什么）

用户不可见；底层变化是角色扮演的设定读取拿回真实对话历史。

每轮输入前写出的设定桥接文件 eleckoi-setting-library-state.json，history 现在包含可见对话历史：

prepare() — 每轮输入前写设定桥接文件
  history =
-   [开场白, 当前输入]
+   [开场白, 可见对话历史, 当前输入]

  可见对话历史 = 用户输入 + 最终回复（去掉工具步骤与 <FINAL> 标签）
  会话末尾仍保留当前输入时（重新生成）→ 这一条不计入，桥接文件只追加一次

history 的两个消费者：

eleckoi-setting-library-state.json
├── eleckoi_glob_setting_files → required_entries（关键词升格为本轮须读）
└── EJS 渲染 → matchChatMessages / getMessageVar / lastMessageId

受影响的行为：关键词扫描深度 > 1 时扫描最近 N 条消息；EJS 的 matchChatMessages / getMessageVar / lastMessageId 能看到最近对话；关键词/EJS 升格的「本轮须读」判断不再失真。

根因：v0.2.8 迁入 DSH 插件后，prepareConversationRuntime 的 history 只保留开场白；迁移前 AgentSessionCoordinator 取完整历史（d3ab69d）。

Architecture route（架构归属）

• Main 新文件仅承担桌面壳职责，位于 host / modules / platform / i18n（无新增 Main 文件）
• Shared 新文件位于闭合集合：contracts / foundation（无新增 Shared 文件）
• 产品跨 Host/Client 查询与命令使用生成的 Typert Remote；会话事件、分页与 projection 使用 DSH Connection 正式协议，未新增业务 IPC 或私有桥
• Renderer 未直接访问 Electron、Node、SQLite 或 DSH SDK（无 Renderer 改动）
• 官方运行时装配隔离在 @eleckoi/dsh-runtime；Host/Client 插件使用同版本公开合同，上游包仍是同一个精确版本批次（无版本变化）
• 新业务进入 DSH Host/Client 插件；产品数据库与 Repository 由 @eleckoi/dsh-product-data 独占，跨模块依赖只使用对方 index.ts 公开面（改动在 dsh-client-roleplay Host 插件内部）
• 长生命周期资源已注册为 Host/Cordis Plugin，并能反向释放（无新增长生命周期资源）

Data and compatibility（数据与兼容）

• Schema 改动附带新的向前迁移，没有重写已发布迁移（无 Schema 改动）
• 没有把会话、消息、角色或模型配置写入 localStorage
• 旧数据、取消、失败或异常退出路径已考虑（取不到 Session 时 history 退回为空，不阻塞生成；重新生成保留的当前输入按会话末尾的直接用户消息识别，不比较正文；压缩摘要条目保留在历史里）

回滚与影响面

• Door: two-way。桥接文件是运行时 JSON；revert 这两个提交再重跑 pnpm build 即可。产品数据库、Session 日志、Schema 都不动。
• Blast Radius: roleplay。只影响角色扮演的设定读取，不动 IPC、DB、UI。副作用：每轮桥接文件写入随会话长度变大；压缩摘要条目（<compacted-summary>）会进入历史，与模型读到的历史一致。

Verification（验证）

• pnpm test（本地已跑受影响文件；全量由 CI 执行，状态见检查项）
• pnpm build（由 CI 执行，状态见检查项；本机 Linux 已知停在 check:licenses，与本次改动无关）
• DSH 改动已通过 pnpm check:electron-dsh（由 CI 执行，状态见检查项；本 PR 未改 DSH 运行时装配）
• 没有启动 Android、Docker、QEMU 或 ARM64 DSH 核心编译
• UI 未定稿阶段没有借底层改造擅自改变 JSX/CSS 视觉（无 UI 改动）

本地证据（旧源码 + 新回归用例 → 修复后）：

• Before: 旧源码 + 新回归用例，集成用例 1 failed：

  × writes the visible conversation history into the setting library bridge
  AssertionError: expected [ { role: 'assistant', …(1) }, …(1) ] to deeply equal [ { role: 'assistant', …(1) }, …(3) ]
  Tests  1 failed | 15 passed (16)
  

• After: 修复后同一文件 16 passed：

  ✓ |integration| tests/integration/dsh-old-chat-generation.test.js (16 tests)
  ✓ |host| packages/client/features/dsh-client-roleplay/tests/host/dsh-conversation-context.test.js (16 tests)
  

pnpm typecheck 过；快闸除 check:plugin-docs 外全过。check:plugin-docs 在未改动的 main（a5bb881）上同样失败（@eleckoi/dsh-client-html-resources 的 ./client 导出解析不到 src/client/types.ts），是基线红，与本次改动无关。

fork 侧的预跑与评审记录：KuramiWan#5

Review scope（审查范围）

• packages/client/features/dsh-client-roleplay/src/host/conversation-context.mjs
• packages/client/features/dsh-client-roleplay/src/host/session-runtime.mjs
• packages/client/features/dsh-client-roleplay/tests/host/dsh-conversation-context.test.js
• tests/integration/dsh-old-chat-generation.test.js

评审重点：会话末尾保留输入的识别（不比较正文）、压缩摘要条目的处理、取不到 Session 的退回路径。