# 使用指南截图清单

> 本目录存放 `../13-usage-guide.md` 引用的所有截图。
> 命名规则：`<section>-<NN>-<short-desc>.png`，统一 PNG，1280px 宽推荐。

## 已有（FFOA UI 截图，2026-05-19 用 Playwright MCP 自动抓）

| 文件 | 内容 |
|---|---|
| `01-page-overview.png` | My Apps 页面整体：token 状态条 / mcp add 命令框 / 部署话术 callout / 空 apps 列表 |
| `02-regenerate-confirm.png` | 点 "Regenerate" 后的确认弹窗 |

## 待补（终端截图 · 需要员工/工程师在自己电脑上拍 + 提交）

这部分**没法用 Playwright 模拟**——必须是真实 Claude Code 终端会话的截图。
拍完按下面命名丢进本目录，`13-usage-guide.md` 直接渲染，不用改文档。

| 文件 | 场景 | 关键点 |
|---|---|---|
| `terminal-01-mcp-add-success.png` | shell 里执行 `claude mcp add --transport http ffoa-apps ...` 成功的输出 | 能看到成功提示行（如 `Added MCP server "ffoa-apps"`），token 部分**打码或裁掉** |
| `terminal-02-mcp-list-connected.png` | 执行 `claude mcp list` 看到 `ffoa-apps` 行 + ✓ Connected | 整段输出可见即可 |
| `terminal-03-claude-receives-deploy-prompt.png` | Claude Code 里贴了"部署话术"模板并发送，Claude 开始调 `mcp__ffoa-apps__deploy_prepare` | 显示工具调用块（`Tool: deploy_prepare`）开始执行 |
| `terminal-04-deploy-prepare-result-with-hint.png` | `deploy_prepare` 返回后 Claude 跑完 `git push` 并对你说"5 分钟后访问 URL 验证..." | **关键**：postDeployHint 文案要清晰可见——证明"push≠上线"提示已生效 |
| `terminal-05-logs-tool-output.png` | 用户说"看下日志"，Claude 调 `mcp__ffoa-apps__logs` 返回容器日志 | 工具调用 + 返回日志片段都可见 |

## 拍图建议

- **terminal 主题**：浅色背景（白/米白）+ 等宽字体 14-15px；深色主题在文档里阅读吃力
- **窗口宽度**：≥ 1100px，避免文本被强制换行成豆腐块
- **隐藏敏感**：token 明文 / 服务器内网 IP 用马赛克或裁掉
- **截图工具**：macOS `Shift+Cmd+4` 框选、Linux `gnome-screenshot -a`、Windows `Win+Shift+S`
- **PNG 优先**（JPG 会糊化文字）
- 单图 ≤ 500 KB；超了用 `pngquant --quality=80-95 file.png` 压一下