# devbell-install **Repository Path**: xqtang/devbell-install ## Basic Information - **Project Name**: devbell-install - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-16 - **Last Updated**: 2026-11-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # DevBell AI Agent 部署指引 > **目的**:本文档精确规定 AI Agent 应如何部署 DevBell。请严格按步骤执行 —— 不得跳过、猜测或自行发挥。 --- ## 0. 前置检查 执行任何命令之前,确认以下事项全部满足: - [ ] `git` 已安装且在 `PATH` 中(执行 `git --version` 验证) - [ ] 可以访问 `gitee.com` - [ ] 有可写的工作目录 若任意一项不满足 → **停止并告知用户**,不得继续。 --- ## 1. 确认自身 Agent 身份(不可跳过) 你必须将自己匹配到下表中的**且仅一个** Agent 类型。依据"识别信号"进行判断。如果没有任何信号匹配 → **停止并询问用户**。 ### Agent 注册表 | 序号 | Agent 类型 | 识别信号 | 克隆命令 | 入口文档 | | --- | --- | --- | --- | --- | | A | **Trae Agent** | 在 Trae IDE 中运行(Trae CN / Trae International);具有 Trae 专属工具(Skill、MCP、PureShowWidget 等);工作目录位于 Trae 工作区下 | `git clone https://gitee.com/xqtang/devbell-bridge.git` | `docs/devbell-guide.md` | | B | **Codex Agent** | 以 OpenAI Codex CLI 或 VS Code Codex 扩展运行;使用 Codex 工具集 | `git clone https://gitee.com/xqtang/devbell-for-codex.git` | `devbell-codex-quickstart.md` | | C | **WorkBuddy Agent** | 在 WorkBuddy 桌面应用或 VS Code WorkBuddy 扩展中运行;WorkBuddy 无 hook 系统 —— 状态推送依赖 AGENTS.md 注入 | `git clone https://gitee.com/xqtang/devbell-for-workbudy.git` | `devbell-quickstart.md` | | D | **DeepSeek Harness** | 在 DeepSeek Harness 评测框架下运行 | `git clone https://gitee.com/xqtang/devbell-for-deepseek-harness.git` | `devbell-deepseek-harness-quickstart.md` | ### 决策算法(严格按此流程) ``` 1. 观察你的运行环境、可用工具以及用户消息。 2. 按顺序(A → B → C → D)匹配识别信号,找到第一个满足的行。 3. 如果零行匹配 → 停止。向用户提问: "我无法从环境中判断自己的 Agent 类型, 请告诉我我是哪一种:Trae、Codex、WorkBuddy 还是 DeepSeek Harness?" 4. 如果多行同时匹配 → 停止。请用户帮你确认。 5. 只有在唯一确定匹配且有有效入口文档后 → 进入第 2 步。 ``` --- ## 2. 克隆仓库 执行第 1 步中匹配行对应的**完整**克隆命令。 ### 克隆验证 `git clone` 成功完成后,检查: - [ ] 目标目录已存在 - [ ] **入口文档**(注册表中该行所列的文件)确实存在于目录中(或其相对路径下) 若入口文档缺失 → **将你查找的完整文件名原样报告给用户**,不得继续。 --- ## 3. 按照入口文档完成安装 ``` cd <克隆目录> ``` 阅读注册表中该行的**入口文档**,按顺序执行其中的每一条指令。不得跳过任何章节。若任一步失败,停止并报告。 --- ## 4. 完成 当入口文档声明部署完成后,向用户确认: > "DevBell 部署完成。仓库:``。" --- ## ❌ 禁止行为 - **禁止** 在确认 Agent 类型之前执行 `git clone`。 - **禁止** 通过猜测、随机方式选择仓库。 - **禁止** 跳过入口文档 —— 不读指南桥接无法正常工作。 - **禁止** 假设入口文档名为 `devbell-quickstart.md` —— 每个仓库有各自的文件名(见上表)。 - **禁止** 修改本文件。