john
d3239ff292
Ensure page sync runs via pageSyncService in remote mode, fall back to workspace HTML when storage assets are missing, and prevent production Portal from linking to loopback Plaza URLs baked in at build time. Co-authored-by: Cursor <cursoragent@cursor.com>
回归守卫索引
本目录记录已验证、不可轻易回退的行为。适用于 Codex、Cloud、Cursor 及任何人工作前的自检。
文档
| 文档 | 保护内容 |
|---|---|
| mindspace-publish-and-chat-finish.md | ① edit_file 覆盖 public/*.html ② Finish 后聊天不清空、不暴露 agent 内部前缀 |
| mindspace-remote-page-sync-and-thumbnail.md | ① remote 模式 public HTML 入库 sync ② storage 缺失时缩略图/读页回退 workspace HTML |
自动化
npm run verify:mindspace-publish-guards # 推荐：改相关代码后
npm run verify:mindspace-publish-guards:full # 发 Portal runtime 后
新增守卫时
- 在本目录添加说明 md（症状 + 必须保留的行为 + checklist）
- 添加/扩展
*.test.mjs并接入npm test - 在
scripts/verify-*.mjs增加源码片段检查（如适用） - 更新根目录 AGENTS.md 索引
- （可选）在
.cursor/rules/添加对应.mdc供 Cursor 自动提示
工具可见性
| 机制 | Cursor | Codex / Cloud / 其它 |
|---|---|---|
本目录 + AGENTS.md |
✅ | ✅（需读仓库文件） |
npm run verify:* |
✅ | ✅ |
npm test |
✅ | ✅ |
| 发版脚本门禁 | ✅ | ✅ |
.cursor/rules/*.mdc |
✅ 自动 | ❌ 不自动 |
其它 AI 工具不会自动读 Cursor 规则；请以 AGENTS.md 与本目录为准。