远程终端控制系统阅读导航
版本：0.1。日期：2026-10-20。状态：补编设计稿。
本资料集为 Web 管理 Windows 设备的远程任务平台提供实施和验收依据。先完成账号、授权、设备配对、任务分发及 browser.open_url 的真实闭环，再按需求扩展聊天、模型与其他能力。
来源与有效范围
本次补编前，仓库可见资料为根目录 AGENTS.md 和仅含项目标题的 README。AGENTS 中引用的十份文档及历史原件未提供。本目录沿用其中已列明的路径，内容依据根目录约定与本次方案补编，不是原文件恢复，也不声称与原版逐字或逐项一致。
有效规则以根目录 AGENTS 为准。各文档中的新增设计与参数应按 设计决策与参数基线 区分规范要求、建议和上线前待确认项。收到原始资料后先登记差异，再决定如何吸收；原件独立保留。
阅读顺序
| 顺序 | 文档 | 解决的问题 |
|---|---|---|
| 1 | 正式开发规格 | 首版范围、架构、数据模型、API、协议和状态转换 |
| 2 | 设计决策与参数基线 | 统一默认值、假设和必须确定的业务条件 |
| 3 | 第一阶段实施计划 | 按依赖顺序开发，每个里程碑怎样验收 |
| 4 | 用户权限与模型密钥 | 用户角色、对象归属、撤销、私人数据和密钥生命周期 |
| 5 | 必须补齐的七项要求 | 首版与生产发布分别必须满足的安全门禁 |
| 6 | 验收用例与证据矩阵 | 正向、拒绝、并发与故障的期望结果和证据 |
| 7 | 部署指南 | 网络拓扑、身份、秘密、健康检查、备份和恢复 |
| 8 | 更新与版本发布 | 兼容性、发布完整性、灰度和回滚 |
| 按需求 | 聊天式远程控制 | 聊天内容如何转成经过授权的任务 |
| 按需求 | 大模型 Skill MCP 扩展 | 模型、Skill、MCP 的注册、约束和撤销 |
| 按需求 | 功能查漏与增强路线图 | 基础闭环之后的功能依赖与禁用边界 |
当前实施状态
| 项目 | 状态 |
|---|---|
| 资料集与首版方案 | 已补编，待后续实施反馈 |
| Web、API、Windows Agent、共享协议代码 | 已建立隔离测试版；Agent 浏览器执行仍关闭，详见根目录 README |
| 依赖清单、锁文件、安装和测试命令 | 已建立并本地验证；尚无 CI 执行器 |
| MySQL 迁移与集成测试 | 宝塔 opc 空库已迁移至 0002_datetime_precision；真实 MySQL 8.4.11 事务测试已通过并回滚测试数据 |
| 真实 Windows 端到端验证 | 未执行 |
| 部署、备份恢复、更新与回滚演练 | 未执行 |
| 生产可用性与七项门禁 | 未验收 |
| 聊天、模型、BYOK、审批、Skill/MCP、桌面、Shell | 规划中，默认不开放 |
文档里的完整能力仍是实施目标。当前仓库的实际代码与本地启动命令见根目录 README；尚不能把本地测试版或规格站当作生产远程控制服务。
名称和阶段口径
“第一阶段实施计划”指首个交付闭环，映射为总规格阶段 0–4。总规格“阶段 1”仅指身份与 RBAC，不等于完成首个交付。
既有规范统一采用 MySQL 8.4 LTS、Nginx、/api/v1 分区 API、独立 /ws/agent 与 /ws/console。未来收到的 PostgreSQL、Caddy 或旧路径示例不能自动成为有效实现要求。task.rejected 为事件，任务落为 failed；不添加 rejected 状态。
原始文件名清单、压缩包内容和旧 AGENTS 原文当前未知，不编造原名对照。上述路径是根目录已经列出的目标路径。日后迁移到 docs/ 时同时更新根目录、README 和所有相对链接，避免两份有效规格并行维护。