BootAgent AGENTS.md

BootAgent 开发约定

当前代码线是 Go/Wails 稳定化主线。不要在本文硬编码发布版本；发布版本以 Git tag、 GitHub Release 和构建工作流注入的版本为准。唯一产品入口是 cmd/bootagent-desktop，React 只能通过生成的 Wails bindings 调用后端。

目录

• internal/app：Status、Provider、Agent、Profile、Runtime、DesktopAgent、安装、 启动、设置和更新等用例，以及统一的写操作锁。
• internal/catalog：嵌入的 agents.lock.json、providers.lock.json、 runtimes.lock.json，以及内置 Provider 目录。
• internal/config：TOML/JSON/JSONC 适配器、配置发现和 golden fixtures。
• internal/install：默认安装最新版或可选精确版本的 Agent 包、registry 选择、 Node.js/uv runtime 引导（下载、校验、解压和 PATH 更新），以及 Aider 的 Python 管理边界。
• internal/profile 与 internal/securefs：Profile、密钥、备份、权限和原子写入。
• internal/mcp：MCP 规范化模型、秘密处理、Registry 私有存储、导入导出，以及 Claude Code、Codex、OpenCode、Kilo CLI 和 Hermes 原生配置适配器。
• internal/binding：React 与 Go 之间唯一的边界。Services 聚合 Status、Provider、 Agent、Profile、Runtime、DesktopAgent、Transfer 和 MCP 八个服务；UpdateService 在桌面 入口中单独注册。这里的 DTO 发生变化时，必须重新生成 frontend/bindings，并同步 frontend/src/backend/wails.ts 与 frontend/src/types/api.ts。
• cmd/bootagent-desktop：Wails 桌面入口。
• frontend/bindings：Wails 生成文件，禁止手工编辑。

cmd/bootagent-release、cmd/bootagent-rc 和 cmd/bootagent-provider-smoke 已在 23805b0 删除，其职责转移到 .github/workflows/build-artifacts.yml。历史文档中 出现这些命令只代表背景，不是可执行指令。

公共站点已迁移到 MaimoryLab/BootAgent-site，本仓库不再 包含 site/。站点把发布 tag 中的 agents.lock.json 和 providers.lock.json 复制到 自己的 data/ 目录；发布完成后，构建工作流会通知站点刷新。直接修改本仓库的 main 不应立即改变站点，因为站点描述的是已发布版本支持的内容。

providers.lock.json 是内置 Provider endpoint、fallback model 和公共站点商业披露 字段的唯一事实来源。用户 Provider 与内置 Provider 覆盖项保存在 ~/.bootagent/providers.json。

本地命令

go test ./...
go test -race ./...
go vet ./...
python3 -m unittest scripts/test_generate_third_party_licenses.py
python3 scripts/generate_third_party_licenses.py --check
python3 scripts/check-docs.py
cd frontend
pnpm install --frozen-lockfile
pnpm run test
pnpm run build
pnpm run test:e2e

.github/workflows/ci.yml 在 pull request 与 main push 上运行四组门禁：Go、 Frontend、Docs 和 Release compliance。Go 门禁还运行 staticcheck。