AgentDock 施工员
4a2be5899d
- 当前进度 Wave 2.2：五件套全链路打通 + 两轮返工完成 - 来源：此前各波施工的工位仓库（wave-0 / wave-1 / wave-0.5 / wave-2 / wave-2.1 / wave-2.2） - README 补「入库说明」一节，并更正仓库当前状态为 Wave 2.2
64 lines
2.9 KiB
Markdown
64 lines
2.9 KiB
Markdown
# AgentDock
|
||
|
||
跨平台、中文化、可扩展的 Agent CLI 软件管理器。帮助用户发现、安装、更新、配置、授权和排查 Agent CLI。
|
||
|
||
## 入库说明
|
||
|
||
本仓库为 AgentDock 的**入库初版**。当前进度做到 **Wave 2.2**（五件套全链路打通 + 两轮返工完成），
|
||
来源为此前各波施工的工位仓库。分支 `main` 的提交历史保留各波次 tag：
|
||
|
||
- `wave-0`：Tauri2 + React 桌面应用空壳可运行，Windows 本机环境检测
|
||
- `wave-1`：适配器框架与安全基座（schema 校验 / dry-run / exec 沙箱 / 密钥库 / 日志脱敏）
|
||
- `wave-0.5`：4K 布局与空态修复（老板验收 15 条，视觉规范 v1.3）
|
||
- `wave-2`：五件套打通全链路（安装/检测/配置/授权/诊断）
|
||
- `wave-2.1`：返工黑屏/安装进度/官方配置三层/文档深度/真机列表
|
||
- `wave-2.2`：流式安装输出、软件内授权四模式、本机环境一键装与总览缓存
|
||
|
||
**本仓库当前为 Wave 2.2 状态**：五件套（发现/安装/配置/授权/诊断）全链路打通，含流式安装输出、软件内
|
||
四种授权方式、本机环境一键安装与总览缓存。已过总工真机审核并部署到桌面。
|
||
|
||
## 仓库结构
|
||
|
||
```text
|
||
agentdock/
|
||
├── apps/desktop/ # Tauri 2 应用入口（React UI + src-tauri）
|
||
│ └── src/tokens/ # 设计 Token（对接视觉规范 v1.2，唯一品味依据）
|
||
├── crates/ # 本机能力层（八层）
|
||
│ ├── agentdock-core/ # 编排（发现/安装/配置/授权/诊断流水线）
|
||
│ ├── agentdock-adapter/ # 适配器 schema 加载、版本校验、执行器接口
|
||
│ ├── agentdock-platform/# Win/Linux 环境检测、PATH、发行版识别
|
||
│ ├── agentdock-config/ # 配置读写（原子写入、备份、多格式编解码）
|
||
│ ├── agentdock-secrets/ # 系统密钥库封装 + 脱敏
|
||
│ ├── agentdock-exec/ # 参数白名单、禁止 shell 拼接的进程执行
|
||
│ ├── agentdock-diag/ # 诊断规则引擎
|
||
│ └── agentdock-store/ # SQLite 空库与 schema 迁移骨架
|
||
├── adapters/ # 版本化适配器 YAML（14 + 目录索引）
|
||
├── docs/ # 架构文档副本
|
||
└── tests/ # 测试夹具与 e2e 脚本
|
||
```
|
||
|
||
## 本地开发
|
||
|
||
```bash
|
||
# 前端依赖 + 构建
|
||
cd apps/desktop
|
||
npm install
|
||
npm run build
|
||
|
||
# Rust 工作区测试（八 crate + 桌面壳）
|
||
cargo test
|
||
|
||
# 启动桌面应用（开发模式）
|
||
cd apps/desktop
|
||
npm run tauri dev
|
||
```
|
||
|
||
## Wave 0 范围
|
||
|
||
- 应用外壳：左侧竖导航六项 + 顶栏 + 六个占位页（视觉规范 v1.2 §3.0 + PRD §7）
|
||
- IPC 心跳：`detect_env` 命令（Windows 本机环境检测，架构 §5）
|
||
- `agentdock-store`：SQLite 空库 + schema 迁移骨架
|
||
- 假目录：CLI 目录页以 `adapters/catalog.yaml` 渲染 14 张卡片
|
||
|
||
后续波次见 `docs/architecture.md` §12。
|