## 它的作用 这**不是**一个 AI 智能体安装程序。大多数智能体都很容易安装。这是一个**生态系统配置器**——它接管你正在使用的任何 AI 编程智能体，并使用 Gentleman 技术栈为其赋能：持久化记忆、Spec-Driven Development (SDD) 工作流、精选的编程技能、MCP 服务器、AI 提供商切换器、注重教学且安全优先的人设，以及按阶段分配模型的功能，从而让每个 SDD 步骤都可以在不同的模型上运行。 **之前**：“我安装了 Claude Code / OpenCode / Cursor，但这只是一个用来写代码的聊天机器人。” **之后**：你的智能体现在拥有了记忆、技能、工作流、MCP 工具，以及一个真正能教导你的人设。 ### 支持的 10 种智能体 | 智能体 | 委派模型 | 主要特性 | |-------|:---:|---| | **Claude Code** | 完整 (Task 工具) | 子智能体，输出样式 | | **OpenCode** | 完整 (多模式叠加) | 按阶段路由模型 | | **Gemini CLI** | 完整 (实验性) | `~/.gemini/agents/` 中的自定义智能体 | | **Cursor** | 完整 (原生子智能体) | `~/.cursor/agents/` 中的 9 个 SDD 智能体 | | **VS Code Copilot** | 完整 (runSubagent) | 并行执行 | | **Codex** | 单智能体 | CLI 原生，TOML 配置 | | **Windsurf** | 单智能体 | Plan Mode, Code Mode，原生工作流 | | **Antigravity** | 单智能体 + Mission Control | 内置浏览器/终端子智能体 | | **Kiro IDE** | 完整 (原生子智能体) | 原生 `~/.kiro/agents/` + 引导式编排 | | **Qwen Code** | 完整 (原生子智能体) | Slash 命令，`~/.qwen/commands/`，`auto_edit` 模式 | ## 快速开始 ### macOS / Linux ``` curl -fsSL https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.sh | bash ``` ### Windows ``` scoop bucket add gentleman https://github.com/Gentleman-Programming/scoop-bucket scoop install gentle-ai ``` 或者通过 PowerShell 脚本安装：`irm https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.ps1 | iex` ### 安装后：项目级设置 智能体配置完成后，在项目中打开你的 AI 智能体并运行以下两个命令以注册项目上下文： | 命令 | 作用 | 何时重新运行 | |---------|-------------|----------------| | `/sdd-init` | 检测技术栈、测试功能，如果可用则激活 Strict TDD Mode | 当你的项目添加/移除了测试框架，或首次在新项目中时 | | `skill-registry` | 扫描已安装的技能和项目规范，构建注册表 | 在安装/移除技能后，或首次在新项目中时 | 这些对于基本用法**不是必需的**。如果 SDD 编排器检测到没有上下文，它会自动运行 `/sdd-init`。但如果你的项目发生了变化（新的测试运行器、新的依赖项），手动重新运行它们可以确保智能体拥有最新的上下文。 ## 安装 ### 推荐 ``` # macOS / Linux brew tap Gentleman-Programming/homebrew-tap brew install gentle-ai # Windows scoop bucket add gentleman https://github.com/Gentleman-Programming/scoop-bucket scoop install gentle-ai ```

其他安装方法 (Go install、PowerShell 脚本、二进制文件下载)

#### Go install (任何安装了 Go 1.24+ 的平台) ``` go install github.com/gentleman-programming/gentle-ai/cmd/gentle-ai@latest ``` #### Windows (PowerShell 脚本) ``` irm https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.ps1 | iex ``` **要从 PowerShell 安装器迁移到 Scoop？** 请先移除旧的二进制文件： ``` Remove-Item "$env:LOCALAPPDATA\gentle-ai" -Recurse -Force # 然后按照上面的说明通过 Scoop 安装 ``` #### 从 Releases 下载 从 [GitHub Releases](https://github.com/Gentleman-Programming/gentle-ai/releases) 下载适用于你平台的二进制文件。

## 备份 每次安装、同步和升级都会自动为你的配置文件创建快照。备份是**压缩**的 (tar.gz)、**去重**的（相同的配置不会被重复备份）以及**自动清理**的（保留最近的 5 个）。你可以通过 TUI（按 `p` 键）固定重要的备份，以防止它们被清理。 有关详细信息，请参阅 [备份与回滚指南](docs/rollback.md)。 ## 你应该了解的关键特性 ### OpenCode SDD Profiles 将不同的 AI 模型分配给不同的 SDD 阶段——使用强大的模型进行设计，快速的模型进行实现，廉价的模型进行探索。创建多个配置文件，并在 OpenCode 中使用 Tab 键在它们之间切换。 ``` # 通过 CLI gentle-ai sync --profile cheap:openrouter/qwen/qwen3-30b-a3b:free gentle-ai sync --profile-phase cheap:sdd-design:anthropic/claude-sonnet-4-20250514 # 或者通过 TUI：gentle-ai → "OpenCode SDD Profiles" → 创建 ``` 创建配置文件后，打开 OpenCode 并按 **Tab** 键在 `sdd-orchestrator`（默认）和你的自定义配置之间切换。 **完整指南**：[OpenCode SDD Profiles](docs/opencode-profiles.md) ### Engram (持久化记忆) 你的 AI 智能体会自动记住跨会话的决策、错误和上下文。你不需要做任何事情——但当你需要时： ``` engram projects list # See all projects with memory counts engram projects consolidate # Fix name drift ("my-app" vs "My-App") engram search "auth bug" # Find a past decision from the terminal engram tui # Visual memory browser ``` **完整参考**：[Engram 命令](docs/engram.md) ## 文档 | 主题 | 描述 | |-------|-------------| | [预期用法](docs/intended-usage.md) | gentle-ai 的设计使用方式——心智模型 | | [OpenCode SDD Profiles](docs/opencode-profiles.md) | 为 OpenCode 创建和管理按阶段的模型配置 | | [Engram 命令](docs/engram.md) | CLI 命令、MCP 工具、项目管理、团队共享 | | [智能体](docs/agents.md) | 支持的智能体、功能矩阵、配置路径及各项智能体的说明 | | [组件、技能和预设](docs/components.md) | 所有组件、GGA 行为、技能目录和预设定义 | | [使用方法](docs/usage.md) | 人设模式、交互式 TUI、CLI 标志和依赖管理 | | [备份与回滚](docs/rollback.md) | 备份保留、压缩、去重、固定和恢复 | | [Kiro IDE](docs/kiro.md) | Kiro 特定设置、配置路径、原生子智能体和 SDD 行为 | | [平台](docs/platforms.md) | 支持的平台、Windows 说明、安全验证、配置路径 | | [架构与开发](docs/architecture.md) | 代码库布局、测试以及与 Gentleman.Dots 的关系 | ## 社区亮点 当社区在此基础上进行构建时，这个项目会变得更好。 ### 社区集成 - [sub-agent-statusline](https://github.com/Joaquinvesapa/sub-agent-statusline) — 可选的 OpenCode TUI 插件，当 OpenCode 公开时，它会显示子智能体的活动、状态、已用时间以及 token/上下文使用情况。 - [sdd-engram-plugin](https://github.com/j0k3r-dev-rgl/sdd-engram-plugin) — 可选的 OpenCode TUI 插件，用于直接从 OpenCode 管理 SDD 配置并浏览 Engram 记忆，支持运行时配置激活且无需重启。 当你在安装程序中选择 OpenCode 时，Gentle AI 会询问是否注册每个社区插件，并提供一个浏览器快捷方式以便你先查看代码库。Gentle AI 仅确保 `~/.config/opencode/tui.json` 存在，并将插件包的名称添加到其 `plugin` 数组中；OpenCode 会在下次启动时安装/加载这些包。一旦 OpenCode 在 `~/.config/opencode/node_modules/` 下实例化了插件，`gentle-ai update` 就可以将其本地 `package.json` 的版本与该插件的 GitHub Releases 版本进行比较。 ## 下一步 - **刚安装完？** 阅读 [预期用法](docs/intended-usage.md)——这是解释该心智模型的唯一页面。 - **正在使用 OpenCode？** 设置 [SDD Profiles](docs/opencode-profiles.md) 以便为每个阶段分配不同的模型。 - **想在多台机器间共享记忆？** 在 [Engram 参考](docs/engram.md) 中了解 `engram sync`。 - **准备好做贡献了吗？** 查看 [CONTRIBUTING.md](CONTRIBUTING.md) 和 [开放的问题](https://github.com/Gentleman-Programming/gentle-ai/issues?q=is%3Aissue+is%3Aopen+label%3A%22status%3Aapproved%22)。

标签：AI提供商切换, AI编程, AI编程助手, Claude Code, CLI, Codex, Cursor, EVTX分析, Gemini CLI, Go语言, MCP服务器, MIT开源, OpenCode, PyRIT, Python安全, SDD, VS Code Copilot, WiFi技术, 上下文管理, 人工智能, 代码生成, 任务委派, 多智能体系统, 多模型管理, 威胁情报, 安全优先, 工作流引擎, 开发者工具, 持久化记忆, 提示词工程, 教学导向, 文档结构分析, 日志审计, 模型路由, 渗透测试工具, 生态系统配置器, 用户模式Hook绕过, 程序破解, 策略决策点, 编码技能, 自动化配置, 规范驱动开发