chore: wave-0 baseline (Tauri2+React shell, platform detect, fake catalog)

2026-08-25 00:21:13 +08:00
commit 296843215f
137 changed files with 6696 additions and 0 deletions
@@ -0,0 +1,51 @@
+# AgentDock
+
+跨平台、中文化、可扩展的 Agent CLI 软件管理器。帮助用户发现、安装、更新、配置、授权和排查 Agent CLI。
+
+**本仓库当前为 Wave 0 状态**：桌面应用空壳可运行（Tauri 2 + React 19 + TypeScript + Vite），含设计 Token、
+八层 Rust crate 骨架、适配器目录骨架、Windows 本机环境检测与 SQLite 空库。
+
+## 仓库结构
+
+```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。