# README 截图素材

本目录保存 README（中文 [../../README.md](../../README.md)、英文 [../../README.en.md](../../README.en.md)）使用的截图，两个语言版本共用同一批图片。文件名统一使用英文 kebab-case，README 里用 HTML `<img>` 引用以便控制宽度。

## 已收录截图

| 文件 | 原始文件名 | 内容 | 尺寸 | README 位置 |
| --- | --- | --- | --- | --- |
| `agent-picker.jpg` | 会话增强01.png | 工作区会话列表中的 Agent Logo、归档会话与工作区入口 | 1200×1200 | `功能详解 → 外部 Agent 集成` |
| `model-picker.jpg` | 模型选择.png（裁剪） | Codex 模型列表与当前模型、思考强度 | 1200×1200 | `功能详解 → 外部 Agent 集成` |
| `subscription-usage.jpg` | 订阅详情01.png（裁剪） | 上游用量弹层：请求、Token、费用、缓存命中率与按模型统计 | 1200×1200 | `功能详解 → 会话增强与订阅用量` |
| `subscription-plan.jpg` | 订阅详情02.png（裁剪） | 订阅额度、当前使用比例与重置时间 | 1200×1200 | `功能详解 → 会话增强与订阅用量` |
| `workspace-debug.jpg` | 调试服务01.png（裁剪） | 工作区调试面板：Backend、Frontend 配置、端口状态与进程操作 | 1200×900 | `功能详解 → 工作区调试` |
| `workspace-debug-edit.jpg` | 调试服务02.png（裁剪） | 工作区调试面板的启动配置编辑表单 | 1200×900 | `功能详解 → 工作区调试` |
| `workspace-overview.jpg` | 工作台01.png（裁剪） | CodingNS 工作台与右侧 Git 面板 | 1200×675 | `界面预览` 首图 |
| `settings-overview.jpg` | 功能模块01.png（裁剪） | Codingns4DSH 功能模块设置卡片上半部分 | 1200×1200 | `功能详解 → 模块与设置` |
| `settings-modules.jpg` | 功能模块02.png（裁剪） | Codingns4DSH 功能模块设置卡片下半部分与版本信息 | 1200×1200 | `功能详解 → 模块与设置` |
| `login-protection.jpg` | 本地保护.png（裁剪） | 本地账号登录页（LOCAL ACCESS）：用户名、密码、登录 DSH Web | 1200×675 | `功能详解 → 登录保护` |
| `relay-service.jpg` | 中转服务01.png（裁剪） | 中转访问服务卡片：服务地址、账号、H5 登录页面地址、设备在线状态 | 1020×1200 | `功能详解 → 远程访问` |
| `relay-h5-login.jpg` | 中转服务02.png（裁剪） | H5 登录页选择 DSH Host 并连接（`https://dsh.codingns.com`） | 1020×1200 | `功能详解 → 远程访问` |
| `relay-status.jpg` | 用户管理.png（裁剪） | 账户状态弹层：访问路径、CPU、内存与注销登录 | 1200×675 | `功能详解 → 远程访问` |

以上均为 JPEG 截图，已按功能组裁剪为固定画布比例，README 通过单列或两列布局展示；单张均小于 150 KB，无需再压缩。

## 可选补充

| 文件名 | 内容 |
| --- | --- |
| `terminal-persistent.png` | 侧栏终端多个标签，以及「重启 DSH 后终端恢复」的场景 |
| `lan-access.png` | 局域网访问卡片：监听网卡、端口、自动探测到的 DSH 端口与转发状态 |
| `tmux-restore.gif` | 关闭 DSH → 重新启动 → 终端内容仍在的连续过程（GIF，≤5 MB） |
| `agent-stream.gif` | 外部 Agent 流式输出 + 工具调用 + 权限确认在一个回合内出现的过程 |

## 规范

- **命名**：英文 kebab-case，按「功能-对象」命名（如 `relay-h5-login.jpg`），不使用中文文件名。
- **目录**：只放在本目录，不要放进 `docs/配图/`（该目录已被 `.gitignore` 排除，图片无法入库）。
- **尺寸**：按功能组裁剪为统一画布：方图 `1200×1200`、横图 `1200×675`、调试图 `1200×900`、中转图 `1020×1200`；同组图片在 README 中使用两列布局。
- **格式**：JPEG / PNG / WebP 均可，单张 ≤ 500 KB；过程型能力优先用 GIF 或短视频。
- **隐私**：使用演示工作区；避免真实项目名、客户名、内网 IP、token、Cookie、邮箱与真实流量数字，必要时用纯色块遮挡；不要暴露 `~/.config/codingns4dsh/` 下的凭据文件。
- **一致性**：同一批截图使用同一台机器、同一主题与相近窗口宽度。
- **同步**：新增或替换图片后，同时更新 README 的引用和本表。

## 备注

- `assets/provider-icons/**` 已包含在 npm `files` 列表中，本目录未包含，因此截图不会进入 npm 包体积；若希望 npm 页面也显示图片，需要把 `assets/screenshots/**` 加入 `files` 并补上 `package.json` 的 `repository` 字段。