john
43 lines
2.2 KiB
Markdown
43 lines
2.2 KiB
Markdown
# 回归守卫索引
|
||
|
||
本目录记录**已验证、不可轻易回退**的行为。适用于 Codex、Cloud、Cursor 及任何人工作前的自检。
|
||
|
||
## 文档
|
||
|
||
| 文档 | 保护内容 |
|
||
|------|----------|
|
||
| [mindspace-publish-and-chat-finish.md](./mindspace-publish-and-chat-finish.md) | ① `edit_file` 覆盖 `public/*.html` ② Finish 后聊天不清空、不暴露 agent 内部前缀 |
|
||
| [mindspace-remote-page-sync-and-thumbnail.md](./mindspace-remote-page-sync-and-thumbnail.md) | ① remote 模式 public HTML 入库 sync ② storage 缺失时缩略图/读页回退 workspace HTML |
|
||
| [page-data-delivery-contract.md](./page-data-delivery-contract.md) | 数据集注册、绑定、真实 page UUID 与交付验收 |
|
||
| [h5-session-stream-replay.md](./h5-session-stream-replay.md) | Portal/Goose SSE 游标映射、断线续播与 Finish 终态恢复 |
|
||
| [memory-v2-candidate-and-lifecycle.md](./memory-v2-candidate-and-lifecycle.md) | 候选记忆表幂等初始化、Portal fail-open、生命周期 off/canary/active 作用域 |
|
||
| [episodic-history-recall.md](./episodic-history-recall.md) | 历史会话召回、用户隔离、旧快照回退、提示注入与 off/canary/active 灰度 |
|
||
|
||
## 自动化
|
||
|
||
```bash
|
||
npm run verify:mindspace-publish-guards # 推荐：改相关代码后
|
||
npm run verify:mindspace-publish-guards:full # 发 Portal runtime 后
|
||
npm run verify:h5-session-patches # H5 会话、Agent Run 与 SSE 续播
|
||
```
|
||
|
||
## 新增守卫时
|
||
|
||
1. 在本目录添加说明 md（症状 + 必须保留的行为 + checklist）
|
||
2. 添加/扩展 `*.test.mjs` 并接入 `npm test`
|
||
3. 在 `scripts/verify-*.mjs` 增加源码片段检查（如适用）
|
||
4. 更新根目录 [AGENTS.md](../../AGENTS.md) 索引
|
||
5. （可选）在 `.cursor/rules/` 添加对应 `.mdc` 供 Cursor 自动提示
|
||
|
||
## 工具可见性
|
||
|
||
| 机制 | Cursor | Codex / Cloud / 其它 |
|
||
|------|--------|----------------------|
|
||
| 本目录 + `AGENTS.md` | ✅ | ✅（需读仓库文件） |
|
||
| `npm run verify:*` | ✅ | ✅ |
|
||
| `npm test` | ✅ | ✅ |
|
||
| 发版脚本门禁 | ✅ | ✅ |
|
||
| `.cursor/rules/*.mdc` | ✅ 自动 | ❌ 不自动 |
|
||
|
||
**其它 AI 工具不会自动读 Cursor 规则**；请以 `AGENTS.md` 与本目录为准。
|