---
description: MindSpace 公开页 edit_file 落盘与聊天 Finish 同步回归守卫（勿盲覆盖）
globs: mindspace-public-finish-sync.mjs,chat-finish-sync.mjs,conversation-display.mjs,src/hooks/useTKMindChat.ts,src/utils/message.ts,server.mjs,chat-skills.mjs
alwaysApply: false
---

# MindSpace 发布 & 聊天 Finish — 回归守卫

已验证行为（2026-06-29）。删改下列逻辑前必须先读 `docs/regression-guards/mindspace-publish-and-chat-finish.md` 并跑 `npm run verify:mindspace-publish-guards`。

## 公开 HTML

- `edit_file` 的 `old_str`/`new_str` **必须**经 `mindspace-public-finish-sync.mjs` 落盘并**覆盖**已有 `public/*.html`
- 不得回退为仅处理 `write_file` 全量 `content`

## 聊天 Finish

- **禁止** `syncSessionMessages` / `UpdateConversation` 用服务端 snapshot **盲覆盖**本地已展示消息
- Finish 同步 **必须**使用 `mergeConversationSnapshot`（见 `chat-finish-sync.mjs`），并在服务端条数落后时重试
- **禁止**无 hint 时命中 session snapshot 缓存（需 `hint_mc` 与 `hint_ua` 同时匹配）
- 用户可见文案 **必须**优先 `metadata.displayText`；否则用 `deriveUserFacingText` 剥离 routing / skill / `[用户身份]` 等 agent-only 前缀

## 改完必跑

```bash
npm run verify:mindspace-publish-guards
```