# 回归清单 · MCP 下发工作流约定，连接指南改用用户级指令文件

- 产品：CoDelphi
- 提交：[9a21af3](https://github.com/gzhanlei/codelphi/compare/45f2727c8bc85052db790401a80da11257f220b6...9a21af3ed08f26c8425f9314cdab3e6c47f77fdd)
- 生成时间：2026-11-15 03:51 UTC

## MCP key 管理与只读工具面
- [ ] [移除] EC-16 — 「MCP key 管理与只读工具面」移除场景 EC-16（行为变化）（待验证）
- [ ] [移除] EC-17 — 「MCP key 管理与只读工具面」移除场景 EC-17（行为变化）（待验证）
- [ ] [移除] ER-10 — 「MCP key 管理与只读工具面」移除场景 ER-10（行为变化）（待验证）
- [ ] [移除] ER-2 — 「MCP key 管理与只读工具面」移除场景 ER-2（行为变化）（待验证）
- [ ] [移除] ER-3 — 「MCP key 管理与只读工具面」移除场景 ER-3（行为变化）（待验证）
- [ ] [移除] ER-4 — 「MCP key 管理与只读工具面」移除场景 ER-4（行为变化）（待验证）
- [ ] [移除] ER-5 — 「MCP key 管理与只读工具面」移除场景 ER-5（行为变化）（待验证）
- [ ] [移除] ER-6 — 「MCP key 管理与只读工具面」移除场景 ER-6（行为变化）（待验证）
- [ ] [移除] ER-7 — 「MCP key 管理与只读工具面」移除场景 ER-7（行为变化）（待验证）
- [ ] [回归] EC-1 — 尚无任何 key 渲染 key 列表（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] EC-10 — 授权请求使用未注册 client_id 或回跳地址不匹配 GET 或 POST /api/mcp/oauth/authorize（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] EC-11 — 用户在授权页选择拒绝 POST /api/mcp/oauth/authorize，decision=deny（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] EC-12 — 令牌请求缺少 client_id POST /api/mcp/oauth/token（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] EC-13 — refresh_token 分支缺少 refresh_token POST /api/mcp/oauth/token，grant_type=refresh_token（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] EC-14 — 设置页 06 面板已签发 key 并展示明文 查看明文区与配置卡片（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] EC-2 — viewer 打开 MCP 面板 渲染面板（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] EC-3 — 调用工具时未提供 JSON 参数 运行 mcp-call.py <tool>（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] EC-4 — 尚未签发 key 或刚签发前 查看连接配置（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] EC-5 — 尚未签发 key 或 key 为空白 渲染连接配置（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] EC-6 — 尚未签发 key 或 key 为空白 渲染连接配置（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] EC-7 — 尚未签发 key 或签发后未保留明文 查看连接配置（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] EC-8 — 注册请求体不是合法 JSON 或缺少 client_name POST /api/mcp/oauth/register（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] EC-9 — 注册请求的 redirect_uris 为空、超过 5 个、超长或非 http/https POST /api/mcp/oauth/register（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] ER-1 — 签发或撤销请求失败 提交操作（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [新增] ER-11 — 「MCP key 管理与只读工具面」新增场景 ER-11（行为变化；证据路径命中 lib/mcp/server.ts）（待验证）
  情境：调用 lookup_by_files 时 paths 为空或超过 20 个｜操作：handleMcpRpc 处理 tools/call｜结果：返回 JSON-RPC 错误码 -32602（INVALID_PARAMS）
- [ ] [新增] ER-12 — 「MCP key 管理与只读工具面」新增场景 ER-12（行为变化；证据路径命中 lib/mcp/server.ts）（待验证）
  情境：调用不存在的工具或方法｜操作：handleMcpRpc 处理 tools/call 或未知 method｜结果：返回 JSON-RPC 错误码 -32601（METHOD_NOT_FOUND）
- [ ] [回归] ER-9 — 客户端以无效凭据访问 /api/mcp 发送带无效 Bearer token 的请求（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-1 — 工作区 editor/owner 在设置页 填写名称并签发 key（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-10 — 连接器启动连接时自动注册客户端 POST /api/mcp/oauth/register，提交 client_name 与 1-5 个 http/https redirect_uris（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-11 — 已登录用户批准已注册客户端的授权请求 GET 授权页携带 client_id、redirect_uri、code_challenge、S256，随后 POST decision=approve（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-12 — 连接器用授权码换取令牌 POST /api/mcp/oauth/token，grant_type=authorization_code 并携带 client_id、code、code_verifier、redirect_uri（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-13 — 访问令牌过期后静默续期 POST /api/mcp/oauth/token，grant_type=refresh_token 并携带 client_id 与 refresh_token（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-17 — 访客未登录访问 /mcp 打开 /mcp 页面（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-18 — 已登录用户访问 /mcp 打开 /mcp 页面（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-19 — 支持 OAuth 自动发现的连接器（ChatGPT/Claude 网页版） 以无凭据请求访问 /api/mcp（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-2 — 已签发 key 需要失效 点击撤销（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-20 — 用户在设置页 MCP 卡片查看连接向导，且刚签发了新 key。 渲染通用 mcpServers JSON 模板。（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-21 — 用户尚未签发 key 时查看连接向导。 渲染 mcpServers JSON 模板。（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-22 — ChatGPT/Claude Web 连接器请求受保护资源元数据。 GET 资源元数据端点。（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-23 — 连接器请求授权服务器元数据。 GET 授权服务器元数据端点。（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-24 — 连接器进行 RFC 7591 动态客户端注册。 提交 client_name 与 redirect_uris。（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-25 — 用户已批准授权，连接器持授权码、PKCE verifier、回跳地址与 client_id 换取 token。 调用授权码换 token。（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-26 — 客户端 access token 过期，持有效 refresh token 与相同 client_id 续期。 调用 refresh 换新 token。（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [新增] HP-27 — 「MCP key 管理与只读工具面」新增场景 HP-27（行为变化；证据路径命中 lib/mcp/server.ts）（待验证）
  情境：客户端发起 MCP initialize 握手｜操作：handleMcpRpc 处理 initialize 请求｜结果：响应含 protocolVersion、tools 能力、serverInfo 与 instructions 工作流约定（覆盖 lookup_by_files、get_release、send_feedback 等时机）
- [ ] [新增] HP-28 — 「MCP key 管理与只读工具面」新增场景 HP-28（行为变化；证据路径命中 lib/mcp/server.ts）（待验证）
  情境：agent 读取工具列表｜操作：handleMcpRpc 处理 tools/list 请求｜结果：返回 13 个只读工具，描述中标注调用时机（list_projects 先匹配 slug、lookup_by_files 改前必查、list_releases/get_release push 后对账、send_feedback 带三要素）
- [ ] [新增] HP-29 — 「MCP key 管理与只读工具面」新增场景 HP-29（行为变化；证据路径命中 lib/mcp/server.ts）（待验证）
  情境：客户端发起 initialize 握手｜操作：handleMcpRpc 处理 initialize 请求｜结果：响应除 protocolVersion、capabilities.tools 与 serverInfo 外，还携带 instructions 字段，内容含 lookup_by_files、get_release、send_feedback 等工作流约定
- [ ] [回归] HP-3 — 需要接入 AI 客户端 查看 MCP 集成面板（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [新增] HP-30 — 「MCP key 管理与只读工具面」新增场景 HP-30（行为变化；证据路径命中 lib/mcp/server.ts）（待验证）
  情境：客户端请求 tools/list｜操作：handleMcpRpc 处理 tools/list 请求｜结果：返回只读工具清单，其中 list_projects 描述提示先用 git remote 的 owner/name 匹配产品取 slug，lookup_by_files 描述标注做计划或改文件前必查，list_releases 与 get_release 描述标注 push 后对账，send_feedback 描述要求带场景、证据、代码实际行为三要素
- [ ] [新增] HP-31 — 「MCP key 管理与只读工具面」新增场景 HP-31（行为变化；证据路径命中 lib/mcp/server.ts）（待验证）
  情境：客户端发起 MCP initialize 握手｜操作：handleMcpRpc 处理 initialize 请求｜结果：响应含 protocolVersion、tools 能力、serverInfo，并携带 instructions 字段，内容覆盖 lookup_by_files 计划期反查、get_release push 后对账与 send_feedback 上报
- [ ] [新增] HP-32 — 「MCP key 管理与只读工具面」新增场景 HP-32（行为变化；证据路径命中 lib/mcp/server.ts）（待验证）
  情境：agent 查看工具清单以决定调用时机｜操作：tools/list 返回工具定义｜结果：list_projects 描述提示先用 git remote 的 owner/name 匹配产品取 slug，lookup_by_files 标注做计划或改文件前必查，list_releases 标注 per-push 一条且 push 后用本次 sha 找发布，get_release 标注 push 后对账，send_feedback 标注带场景/证据/实际行为三要素
- [ ] [新增] HP-33 — 「MCP key 管理与只读工具面」新增场景 HP-33（行为变化；证据路径命中 lib/mcp/server.ts）（待验证）
  情境：coding agent 以 API key 或 OAuth 身份连接 MCP 端点并发送 initialize 请求｜操作：客户端调用 initialize｜结果：响应包含 protocolVersion、capabilities、serverInfo，并新增 instructions 字段，值为四条工作流约定文本（计划前 lookup_by_files 反查、search_scenarios/get_feature 理解行为、push 后 list_releases/get_release 对账、send_feedback 三要素上报）
- [ ] [新增] HP-34 — 「MCP key 管理与只读工具面」新增场景 HP-34（行为变化；证据路径命中 lib/mcp/server.ts）（待验证）
  情境：agent 已连接 MCP 并调用 tools/list｜操作：客户端请求 tools/list｜结果：返回的工具描述包含调用时机说明：list_projects 按 git remote owner/name 匹配取 slug、lookup_by_files 计划或改文件前必查、list_releases/get_release push 后对账、send_feedback 带三要素上报
- [ ] [回归] HP-4 — 本地已配置 ~/.zcode/cli/config.json 中的 codelphi MCP 服务 运行 mcp-call.py tools-list（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-5 — 本地已配置 codelphi MCP 服务 运行 mcp-call.py <tool> '<json-args>' 调用工具（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-6 — 需要接入 AI 客户端 查看 MCP 集成面板（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-7 — 需要接入 AI 客户端 查看 MCP 集成面板（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-8 — 连接器读取授权服务器元数据 GET /.well-known/oauth-authorization-server（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）
- [ ] [回归] HP-9 — 连接器读取受保护资源元数据 GET /.well-known/oauth-protected-resource 或 /.well-known/oauth-protected-resource/api/mcp（影响面推荐）（证据路径命中 lib/mcp/server.ts）（待验证）

## MCP 连接指南公开页
- [ ] [变化] 更新功能「MCP 连接指南公开页」（行为变化）（待验证）
- [ ] [移除] EC-4 — 「MCP 连接指南公开页」移除场景 EC-4（行为变化）（待验证）
- [ ] [移除] EC-5 — 「MCP 连接指南公开页」移除场景 EC-5（行为变化）（待验证）
- [ ] [移除] EC-6 — 「MCP 连接指南公开页」移除场景 EC-6（行为变化）（待验证）
- [ ] [移除] EC-7 — 「MCP 连接指南公开页」移除场景 EC-7（行为变化）（待验证）
- [ ] [移除] HP-10 — 「MCP 连接指南公开页」移除场景 HP-10（行为变化）（待验证）
- [ ] [移除] HP-11 — 「MCP 连接指南公开页」移除场景 HP-11（行为变化）（待验证）
- [ ] [移除] HP-12 — 「MCP 连接指南公开页」移除场景 HP-12（行为变化）（待验证）
- [ ] [移除] HP-13 — 「MCP 连接指南公开页」移除场景 HP-13（行为变化）（待验证）
- [ ] [移除] HP-14 — 「MCP 连接指南公开页」移除场景 HP-14（行为变化）（待验证）
- [ ] [移除] HP-15 — 「MCP 连接指南公开页」移除场景 HP-15（行为变化）（待验证）
- [ ] [移除] HP-16 — 「MCP 连接指南公开页」移除场景 HP-16（行为变化）（待验证）
- [ ] [移除] HP-17 — 「MCP 连接指南公开页」移除场景 HP-17（行为变化）（待验证）
- [ ] [移除] HP-18 — 「MCP 连接指南公开页」移除场景 HP-18（行为变化）（待验证）
- [ ] [移除] HP-19 — 「MCP 连接指南公开页」移除场景 HP-19（行为变化）（待验证）
- [ ] [移除] HP-20 — 「MCP 连接指南公开页」移除场景 HP-20（行为变化）（待验证）
- [ ] [移除] HP-5 — 「MCP 连接指南公开页」移除场景 HP-5（行为变化）（待验证）
- [ ] [移除] HP-6 — 「MCP 连接指南公开页」移除场景 HP-6（行为变化）（待验证）
- [ ] [移除] HP-7 — 「MCP 连接指南公开页」移除场景 HP-7（行为变化）（待验证）
- [ ] [移除] HP-8 — 「MCP 连接指南公开页」移除场景 HP-8（行为变化）（待验证）
- [ ] [移除] HP-9 — 「MCP 连接指南公开页」移除场景 HP-9（行为变化）（待验证）
- [ ] [变化] EC-1 — 「MCP 连接指南公开页」更新场景 EC-1（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：团队希望把同一约定共享给所有成员｜操作：查看指南第五节说明｜结果：仓库根目录 AGENTS.md 被标注为可选加强、非必需；已连接 agent 还会随连接收到相同的 MCP instructions
- [ ] [新增] EC-18 — 「MCP 连接指南公开页」新增场景 EC-18（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：团队希望把同一约定共享给所有成员｜操作：查看 /mcp 指南的指令文件说明｜结果：指南说明可再把同段贴进仓库根目录 AGENTS.md 作为可选加强，并说明已连接 agent 会随连接收到相同约定（MCP instructions）
- [ ] [新增] EC-19 — 「MCP 连接指南公开页」新增场景 EC-19（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：团队希望把同一段约定共享给所有成员｜操作：查看指南中关于仓库级 AGENTS.md 的说明｜结果：仓库根目录 AGENTS.md 被标注为可选的团队共享加强，非必需
- [ ] [变化] EC-2 — 「MCP 连接指南公开页」更新场景 EC-2（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：仓库未接入 CoDelphi 或 git remote 匹配不到产品｜操作：agent 读取用户级指令段｜结果：段内门控条件不满足，agent 直接跳过该段，不影响未接入项目
- [ ] [新增] EC-20 — 「MCP 连接指南公开页」新增场景 EC-20（行为变化；证据路径命中 app/mcp/page.tsx；证据路径命中 lib/mcp/server.ts）（待验证）
  情境：用户级指令文件未配置｜操作：已连接本服务的 agent 建立连接｜结果：agent 仍随连接收到一份相同的约定（MCP instructions），具备基本触发
- [ ] [新增] EC-21 — 「MCP 连接指南公开页」新增场景 EC-21（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：用户尚未签发 key｜操作：查看通用 mcpServers JSON 配置块｜结果：Authorization 使用占位符 <sk_cd_…>，提示签发后自动写入真实值
- [ ] [新增] EC-22 — 「MCP 连接指南公开页」新增场景 EC-22（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：用户已签发 key 并在设置页复制烤好的配置｜操作：查看 /mcp 指南页配置块｜结果：指南页配置块仍以占位符展示，真实 key 由设置页烤入版本提供
- [ ] [新增] EC-23 — 「MCP 连接指南公开页」新增场景 EC-23（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：团队希望把同一约定共享给所有成员｜操作：查看指南中仓库级 AGENTS.md 的说明｜结果：仓库根目录 AGENTS.md 被标注为可选加强、非必需，并说明已连接 agent 会随连接收到相同约定
- [ ] [新增] EC-24 — 「MCP 连接指南公开页」新增场景 EC-24（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：用户尚未签发 key 时查看指南的通用 mcpServers JSON｜操作：查看配置代码块｜结果：Authorization 使用占位符，提示把占位符换成自己的 key 或到设置页签发后复制烤好的版本
- [ ] [新增] EC-25 — 「MCP 连接指南公开页」新增场景 EC-25（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：尚未签发 key 时查看连接配置｜操作：查看通用 mcpServers JSON 代码块｜结果：Authorization 使用占位符 <sk_cd_…>，提示签发 key 后自动写入真实值
- [ ] [新增] EC-26 — 「MCP 连接指南公开页」新增场景 EC-26（行为变化；证据路径命中 app/mcp/page.tsx；证据路径命中 components/copy-block.tsx）（待验证）
  情境：已签发 key 后查看连接配置｜操作：查看通用 mcpServers JSON 代码块｜结果：Authorization 为真实 key，可点击复制按钮一键复制
- [ ] [变化] EC-3 — 「MCP 连接指南公开页」更新场景 EC-3（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：用户所在仓库未接入 CoDelphi 或未连接 codelphi MCP｜操作：把用户级指令段贴进 ~/.zcode/AGENTS.md 或 ~/.claude/CLAUDE.md｜结果：指令段自带门控条件，不满足时自动跳过，不影响未接入的项目
- [ ] [新增] ER-1 — 「MCP 连接指南公开页」新增场景 ER-1（行为变化；证据路径命中 components/copy-block.tsx）（待验证）
  情境：浏览器不支持或拒绝剪贴板写入｜操作：点击 CopyBlock 的「复制」按钮｜结果：复制失败，按钮文案不切换为「已复制」
- [ ] [变化] HP-1 — 「MCP 连接指南公开页」更新场景 HP-1（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：访客未登录访问 /mcp｜操作：打开 /mcp 页面｜结果：以公开外壳渲染连接指南，含端点、通用 mcpServers JSON、各客户端文件位置、OAuth 连接器说明、13 个工具清单与工作流约定，并显示「返回产品总览」链接
- [ ] [变化] HP-2 — 「MCP 连接指南公开页」更新场景 HP-2（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：已登录用户访问 /mcp｜操作：打开 /mcp 页面｜结果：以应用外壳渲染同一连接指南内容，侧栏 MCP 项高亮
- [ ] [新增] HP-27 — 「MCP 连接指南公开页」新增场景 HP-27（行为变化；证据路径命中 app/mcp/page.tsx；证据路径命中 components/copy-block.tsx）（待验证）
  情境：用户需要让 agent 在所有仓库自觉执行工作流约定｜操作：在 /mcp 指南中点击用户级常驻指令段的「复制」｜结果：门控片段（未连接 codelphi MCP 或 remote 匹配不到时自动跳过）写入剪贴板，按钮显示「已复制」，可贴进 ~/.zcode/AGENTS.md 或 ~/.claude/CLAUDE.md
- [ ] [新增] HP-28 — 「MCP 连接指南公开页」新增场景 HP-28（行为变化；证据路径命中 app/mcp/page.tsx；证据路径命中 components/copy-block.tsx）（待验证）
  情境：用户需要复制通用 mcpServers 连接配置｜操作：在 /mcp 指南的「通用 mcpServers JSON」块点击「复制」｜结果：配置 JSON 写入剪贴板，按钮文案变为「已复制」
- [ ] [新增] HP-29 — 「MCP 连接指南公开页」新增场景 HP-29（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：访客未登录访问 /mcp｜操作：打开 /mcp 页面｜结果：以公开外壳渲染连接指南，含端点、通用 mcpServers JSON、各客户端文件位置、OAuth 连接器说明、工具清单与工作流约定，并显示「返回产品总览」链接
- [ ] [变化] HP-3 — 「MCP 连接指南公开页」更新场景 HP-3（行为变化；证据路径命中 app/mcp/page.tsx；证据路径命中 components/copy-block.tsx）（待验证）
  情境：用户需要把通用 mcpServers 配置写入 coding agent｜操作：在指南第二节查看配置块并点击「复制」｜结果：CopyBlock 将配置 JSON 写入剪贴板，按钮文案变为「已复制」
- [ ] [新增] HP-30 — 「MCP 连接指南公开页」新增场景 HP-30（行为变化；证据路径命中 app/mcp/page.tsx；证据路径命中 components/copy-block.tsx）（待验证）
  情境：用户在 /mcp 指南中查看通用 mcpServers JSON 配置块｜操作：点击该块的「复制」按钮｜结果：配置 JSON 写入剪贴板，按钮文案变为「已复制」
- [ ] [新增] HP-31 — 「MCP 连接指南公开页」新增场景 HP-31（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：用户希望让 agent 在所有仓库自觉执行工作流约定｜操作：复制「用户级常驻指令段」并贴进 ~/.zcode/AGENTS.md 或 ~/.claude/CLAUDE.md｜结果：指南给出带门控的指令段（未连接 codelphi MCP 或仓库匹配不到时自动跳过），一次配置对所有仓库生效
- [ ] [新增] HP-32 — 「MCP 连接指南公开页」新增场景 HP-32（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：用户需要让 agent 自觉执行工作流约定｜操作：查看「写入你的 coding agent」章节｜结果：页面推荐把门控生效的指令段贴进用户级指令文件（~/.zcode/AGENTS.md 或 ~/.claude/CLAUDE.md），并提供可复制的指令段文本；仓库根目录 AGENTS.md 标注为可选团队共享
- [ ] [新增] HP-33 — 「MCP 连接指南公开页」新增场景 HP-33（行为变化；证据路径命中 app/mcp/page.tsx；证据路径命中 components/copy-block.tsx）（待验证）
  情境：用户需要复制通用 mcpServers JSON｜操作：点击 CopyBlock 的「复制」按钮｜结果：配置文本写入剪贴板，按钮文案变为「已复制」
- [ ] [新增] HP-34 — 「MCP 连接指南公开页」新增场景 HP-34（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：用户需要把工作流约定写进 coding agent 的常驻指令｜操作：在指南「写入你的 coding agent」段查看用户级常驻指令段｜结果：展示推荐贴进 ~/.zcode/AGENTS.md 或 ~/.claude/CLAUDE.md 的门控片段，说明每人一次、所有仓库生效，未连接或匹配不到时自动跳过
- [ ] [新增] HP-35 — 「MCP 连接指南公开页」新增场景 HP-35（行为变化；证据路径命中 app/mcp/page.tsx；证据路径命中 components/copy-block.tsx）（待验证）
  情境：用户需要复制通用 mcpServers JSON 或用户级指令段｜操作：点击对应代码块的「复制」按钮｜结果：文本写入剪贴板，按钮文案变为「已复制」
- [ ] [新增] HP-36 — 「MCP 连接指南公开页」新增场景 HP-36（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：用户需要把工作流约定交给 agent 自觉执行｜操作：查看连接指南的指令段区块｜结果：推荐贴进用户级指令文件 ~/.zcode/AGENTS.md 或 ~/.claude/CLAUDE.md，展示带门控的常驻指令段（未连接 codelphi MCP 或仓库匹配不到时自动跳过），并说明仓库根 AGENTS.md 为可选团队共享、已连接 agent 会随连接收到相同约定
- [ ] [新增] HP-37 — 「MCP 连接指南公开页」新增场景 HP-37（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：用户访问 /mcp 指南页的「二、写入你的 coding agent」小节｜操作：查看通用 mcpServers JSON 配置块｜结果：配置块以 CopyBlock 渲染，显示 label「通用 mcpServers JSON」、复制按钮与 pre/code 中的配置 JSON
- [ ] [新增] HP-38 — 「MCP 连接指南公开页」新增场景 HP-38（行为变化；证据路径命中 components/copy-block.tsx）（待验证）
  情境：用户点击配置块的复制按钮｜操作：点击「复制」按钮｜结果：配置 JSON 文本被写入剪贴板，按钮文案变为「已复制」
- [ ] [新增] HP-39 — 「MCP 连接指南公开页」新增场景 HP-39（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：用户访问 /mcp 指南页的「五、给 agent 的工作流约定」小节｜操作：查看常驻指令配置说明｜结果：页面推荐把指令段贴进用户级指令文件（~/.zcode/AGENTS.md 或 ~/.claude/CLAUDE.md），说明每人一次、所有仓库生效、段内自带门控；并提供 CopyBlock 展示该指令段；同时说明团队可选贴进仓库根目录 AGENTS.md，已连接 agent 还会随连接收到相同约定
- [ ] [变化] HP-4 — 「MCP 连接指南公开页」更新场景 HP-4（行为变化；证据路径命中 app/mcp/page.tsx）（待验证）
  情境：用户希望 agent 在所有仓库自觉执行账本约定｜操作：在指南第五节复制用户级常驻指令段并贴进 ~/.zcode/AGENTS.md 或 ~/.claude/CLAUDE.md｜结果：CopyBlock 复制含门控条件的指令段（计划期 lookup_by_files 反查、search_scenarios 理解行为、push 后 list_releases/get_release 对账、send_feedback 上报），一次粘贴覆盖所有仓库
- [ ] [新增] HP-40 — 「MCP 连接指南公开页」新增场景 HP-40（行为变化；证据路径命中 app/mcp/page.tsx；证据路径命中 components/copy-block.tsx）（待验证）
  情境：用户点击用户级指令段的复制按钮｜操作：点击「复制」按钮｜结果：指令段文本被写入剪贴板，按钮文案变为「已复制」

## 可复制代码块组件
- [ ] [新增] 新增功能「可复制代码块组件」（行为变化）（待验证）
- [ ] [回归] EC-1 — 用户尚未点击复制 查看代码块（影响面推荐）（证据路径命中 components/copy-block.tsx）（待验证）
- [ ] [回归] HP-1 — 指南页展示可复制的配置或指令文本 点击「复制」按钮（影响面推荐）（证据路径命中 components/copy-block.tsx）（待验证）