vps-commander/docs/PROGRESS_TRACKING.md

VPS-Commander 项目进度与路线图

本文档记录当前版本真实进度。历史审计文件继续保留原始证据，不直接作为当前状态判断依据。

---

一、当前总体状态

模块	状态
Hub / Agent 双通道	✅ 已完成
多节点持久化	✅ 已完成
Per-device Credential	✅ 已完成
Security Snapshot	✅ 已完成
Low / Medium / High Gate	✅ 已完成
MCP 安全门禁	✅ 已完成
edit_block 原子安全	✅ 已完成
Session 资源限制	✅ 已完成
Web Panel	✅ 已完成
Webhook	✅ 已完成
MCP 11 Tools	✅ 已完成源码实现
Clean Production Rebuild	🟡 下一次发布收口
EffectiveRisk 完全 Fail-closed	🔵 v2.1
Agent Token 脱离 argv	🔵 v2.1
Principal 强隔离	🔵 v2.1

---

二、MCP 当前能力

当前共 12 个 Tools：

1. list_devices
2. exec_command
3. read_file
4. read_multiple_files
5. create_directory
6. move_file
7. list_processes
8. edit_block
9. write_file
10. list_agent_mcp
11. call_agent_mcp

早期“4 个 MCP Tools”的文档已经废止。

---

三、v2.0 当前收口

当前架构已经形成：

• Hub 中央控制。
• Agent WSS 回连。
• Per-device Credential。
• Policy Snapshot。
• Tool Registry。
• MCP / HTTP Unified Gate。
• SQLite Audit。
• Session Resource Limits。
• Web Management Panel。

---

四、2026-10-02 审计发现

4.1 生产构建漂移

生产 Hub / Agent 曾以 vcs.modified=true 构建。 这会破坏源码 → revision → binary 的可追溯链。

4.2 代码兼容问题

• process/session API 存在 snake_case 请求字段兼容问题。
• Hub 本地 process/session 路径缺少 local fallback。

在源码、测试和生产现场全部验证之前，上述项目不标记为“已修复”。

---

五、v2.1 路线

5.1 P0-1：EffectiveRisk

• Canonical Device Identity。
• unknown / offline / bad credential → risk 0。
• GlobalRisk 只作为已认证设备的业务默认。
• Unknown 不得继承 High。

5.2 P0-2：Agent Credential

• EnvironmentFile / LoadCredential。
• ExecStart 不出现 secret。
• /proc/*/cmdline 不可读取 token。
• 支持 rotation + rollback。

5.3 P1：Principal

• principal_id。
• principal_type。
• credential_id。
• device_id。
• Session Owner 绑定 Principal。
• takeover 必须显式授权并审计。

---

六、标准发布顺序

Backup
  ↓
Clean Build
  ↓
Single-node Gray Release
  ↓
Hub Restart Recovery
  ↓
Rolling Agent
  ↓
MCP / Security / Audit
  ↓
Full Acceptance

---

七、文档同步规则

任何新功能或安全变更必须同步检查：

• README
• ARCHITECTURE
• DEV_SPEC
• MCP_INTEGRATION
• deploy/README
• ACCEPTANCE_CRITERIA
• PROGRESS_TRACKING
• openapi.json（如影响 HTTP Contract）

历史审核报告保持原貌，不回写成当前状态。