helloagents 3.0.10-beta.1 → 3.0.10

package/README_CN.md

@@ -6,7 +6,7 @@
 
 <div align="center">
 
-**质量驱动的 AI 编码 CLI 工作流框架 — 14 个自动激活技能、流程纪律、检查清单把关。**
+**面向 AI 编码 CLI 的工作流层：技能、知识库、交付检查、更安全的配置写入，以及可恢复的执行流程。**
 
 [![Version](https://img.shields.io/badge/version-3.0.10-orange.svg)](./package.json)
 [![npm](https://img.shields.io/npm/v/helloagents.svg)](https://www.npmjs.com/package/helloagents)
@@ -25,35 +25,30 @@
 ---
 
 > [!IMPORTANT]
-> **找 v2.x？** 旧版 Python 代码库已迁移到独立归档仓库：[helloagents-archive](https://github.com/hellowind777/helloagents-archive)。v3.x 是完全重写 — 纯 Node.js/Markdown 架构，无 Python 依赖。
+> 如果你在找 `v2.x`，旧的 Python 版本已经迁到 [helloagents-archive](https://github.com/hellowind777/helloagents-archive)。`v3` 是基于 Node.js、Markdown 规则、skills 和轻量运行时脚本的完全重写版本。
 
-## 📑 目录
+## 目录
 
-<details>
-<summary><strong>点击展开</strong></summary>
+- [HelloAGENTS 做什么](#helloagents-做什么)
+- [相对 v3.0.7 的真实变化](#相对-v307-的真实变化)
+- [核心功能](#核心功能)
+- [快速开始](#快速开始)
+- [CLI 管理](#cli-管理)
+- [对话命令](#对话命令)
+- [项目知识库](#项目知识库)
+- [工作流与交付](#工作流与交付)
+- [配置](#配置)
+- [各 CLI 集成方式](#各-cli-集成方式)
+- [验证](#验证)
+- [FAQ](#faq)
+- [故障排除](#故障排除)
+- [许可证](#许可证)
 
-- [🎯 为什么选择 HelloAGENTS？](#-为什么选择-helloagents)
-- [🆚 相比 v2.3.8 的变化](#-相比-v238-的变化)
-- [✨ 核心特性](#-核心特性)
-- [🚀 快速开始](#-快速开始)
-- [🔄 安装流程与文件写入](#-安装流程与文件写入)
-- [📖 命令](#-命令)
-- [🔧 配置](#-配置)
-- [⚙️ 工作原理](#️-工作原理)
-- [📚 使用指南](#-使用指南)
-- [🧪 验证](#-验证)
-- [❓ FAQ](#-faq)
-- [🛠️ 故障排除](#️-故障排除)
-- [📈 版本历史](#-版本历史)
-- [📜 许可证](#-许可证)
+## HelloAGENTS 做什么
 
-</details>
+AI 编码 CLI 写代码很快，但也容易停在建议、跳过检查、丢失项目上下文，或在真正完成前就报告完成。
 
-## 🎯 为什么选择 HelloAGENTS？
-
-你有没有遇到过这种情况：AI 编码助手分析了一通，最后来一句"建议你这样做"就结束了？或者写了代码但跳过测试、忽略边界情况，然后说"完成了"？
-
-HelloAGENTS 就是为了解决这个问题。它是一个编排层，装在你的 AI CLI 上面，在每一步都强制执行质量标准。
+HelloAGENTS 叠加在 Claude Code、Gemini CLI 和 Codex CLI 之上，帮助模型选择合适流程、使用任务相关的质量技能、维护项目知识库，并在交付前完成验证。
 
 <table>
 <tr>
@@ -61,827 +56,581 @@ HelloAGENTS 就是为了解决这个问题。它是一个编排层，装在你
 
 **没有 HelloAGENTS**
 
-<img src="./readme_images/08-demo-snake-without-helloagents.png" alt="没有 HelloAGENTS" width="520">
+<img src="./readme_images/08-demo-snake-without-helloagents.png" alt="Without HelloAGENTS" width="520">
 
 </td>
 <td width="50%" valign="top" align="center">
 
-**有 HelloAGENTS**
+**使用 HelloAGENTS**
 
-<img src="./readme_images/07-demo-snake-with-helloagents.png" alt="有 HelloAGENTS" width="520">
+<img src="./readme_images/07-demo-snake-with-helloagents.png" alt="With HelloAGENTS" width="520">
 
 </td>
 </tr>
 </table>
 
-| 挑战 | 没有 HelloAGENTS | 有 HelloAGENTS |
-|------|-----------------|----------------|
-| **止步于规划** | 给建议就结束 | 推进到实现和验证 |
-| **质量不一致** | 看 prompt 运气 | 14 个技能按任务类型自动激活 |
-| **危险操作** | 容易误执行破坏性命令 | Guard 系统拦截危险命令 |
-| **没有验证** | "应该能用" | Ralph Loop 完成前自动跑 lint/test/build |
-| **知识丢失** | 上下文散落各处 | 项目知识库持久化并持续积累 |
+| 问题 | 没有 HelloAGENTS | 使用 HelloAGENTS |
+|------|------------------|------------------|
+| 结束过早 | 停在建议 | 继续实现、验证和收尾 |
+| 质量不稳定 | 很依赖提示词 | 按任务类型激活 14 个质量技能 |
+| 上下文分散 | 方案散落在聊天记录里 | 项目知识和方案文件落在磁盘上 |
+| 完成态模糊 | 自然语言说“完成” | 按状态、证据和验证结果交付 |
+| 配置容易漂移 | CLI 文件可能不一致 | 安装、更新、清理和 doctor 会检查受管文件 |
 
-### 💡 最适合
-- ✅ **使用 AI CLI 的开发者**，想要一致的、经过验证的输出
-- ✅ **团队**，需要 AI 辅助编码的质量护栏
-- ✅ **复杂项目**，需要结构化的 设计 → 开发 → 验证 工作流
+## 相对 v3.0.7 的真实变化
 
-### ⚠️ 不适合
-- ❌ 简单的一次性问题（HelloAGENTS 会增加流程开销）
-- ❌ 非编码任务（针对软件工程优化）
+下面是当前 `v3.0.10` 相对 `v3.0.7` 的主要运行时和安装变化：
 
-## 🆚 相比 v2.3.8 的变化
+- 主代理交付改用结构化 `turn-state`，明确区分 `complete`、`waiting`、`blocked`；stop、notify、收尾流程不再从自然语言里猜完成态。
+- 工作流恢复改为读取当前 `state_path`，状态文件按会话写入 `.helloagents/sessions/<branch>/<session-or-default>/STATE.md`。
+- 移除旧的项目根状态文件回退逻辑，恢复流程只走当前状态路径。
+- Codex 标准/全局模式的安装、刷新、清理和 doctor 检查更严格：受管 `notify` 会带标记，多行 `notify` 数组可保留，用户自己的 `model_instructions_file`、`notify`、非托管 `codex_hooks` 会在恢复时保留。
+- Codex 全局模式在重装、更新或本地切分支后，会同步刷新 home 读取根、本地插件根目录、marketplace 条目、插件启用段和缓存副本。
 
-如果你上一次认真使用 HelloAGENTS 还是 `v2.3.8`，这一代的变化不是“增量补丁”，而是整条产品线重构。
+## 核心功能
 
-| 维度 | v2.3.8 | 本地 `v3.0.10` |
-|------|--------|---------------|
-| **底层实现** | Python 包 + 大量脚本/规则混合 | 纯 Node.js + Markdown 运行时，围绕 `cli.mjs`、`bootstrap*.md`、`skills/`、`scripts/` 重建 |
-| **目标定位** | 更像多 CLI 管理工具 + 提示协议集合 | 更像 AI CLI 的质量工作流框架，重点是路由、把关、验证和可恢复执行 |
-| **安装方式** | pip / uv / npx / 一键脚本并行存在 | npm 为主；安装包后再显式部署到 Claude / Gemini / Codex |
-| **CLI 支持策略** | 6 个目标，能力差异很大 | 聚焦 3 个主战场：Claude Code、Gemini CLI、Codex CLI |
-| **工作流模型** | R0/R1/R2 三层路由 + 老式 design/develop 语义 | ROUTE/TIER → SPEC → PLAN → BUILD → VERIFY → CONSOLIDATE 六阶段主流程 |
-| **命令体系** | 15 个命令，含 `~exec` / `~rollback` / `~rlm` / `~validatekb` | 13 个聚焦命令：`~idea` / `~plan` / `~build` / `~verify` / `~prd` / `~loop` / `~wiki` / `~help` 等 |
-| **质量模型** | 规则较分散，更多依赖自然语言约束 | 14 个自动激活技能 + 检查清单把关 + Ralph Loop + 结构化证据 |
-| **项目状态** | 知识库更多是附属能力 | `.helloagents/` 成为项目激活边界，`STATE.md` / 方案包 / `DESIGN.md` / `contract.json` 组成主流程的主要判断依据 |
-| **知识库存储** | 默认项目本地 | 默认项目本地，同时新增 `project_store_mode=repo-shared`，支持同一 git 仓库多个 worktree 共享稳定知识和方案资产 |
-| **Codex 集成** | 早期依赖更多兼容层和旧流程 | 标准模式使用注入规则 + 本地链接；全局模式使用原生本地插件，减少噪音与漂移 |
+### 1）14 个按任务使用的质量技能
 
-一句话概括：`v2.3.8` 更像“给多个 CLI 加一层工作流外壳”，`v3.0.10` 更像“把质量规则、计划产物、验证证据和安装生命周期统一成一套真正可运转的工作流框架”。
+HelloAGENTS 内置 14 个 `hello-*` 技能。技能只在当前阶段需要时读取，因此简单任务不会被额外流程拖慢，复杂任务则会得到更完整的检查。
 
-## ✨ 核心特性
+| 技能 | 关注点 |
+|------|--------|
+| `hello-ui` | UI 规划、设计契约、实现映射、视觉验收 |
+| `hello-api` | API 设计、校验、错误格式、兼容性 |
+| `hello-security` | 认证、密钥、权限、注入风险 |
+| `hello-test` | TDD、覆盖率、边界用例、测试结构 |
+| `hello-verify` | 审查、命令验证、交付证据、收尾 |
+| `hello-errors` | 错误处理、日志、重试和恢复 |
+| `hello-perf` | 性能、缓存、查询和渲染风险 |
+| `hello-data` | 数据库、迁移、事务、索引 |
+| `hello-arch` | 架构、边界、代码体积、可维护性 |
+| `hello-debug` | 问题诊断和卡住时的升级处理 |
+| `hello-subagent` | 子代理分工和结果整合 |
+| `hello-review` | 代码审查和结构化问题记录 |
+| `hello-write` | 文档、报告和文字交付 |
+| `hello-reflect` | 可复用经验和知识更新 |
 
-HelloAGENTS 通过三重机制协同保障质量：
+所有 UI 任务都会先受共享的 UI 质量基线约束。
+在已激活项目或明确的 UI 工作流里，`hello-ui` 会进一步补充设计契约执行、设计系统映射与视觉验收。
+当需要视觉证据时，HelloAGENTS 可以写入 `.helloagents/.ralph-visual.json`。
 
-<table>
-<tr>
-<td width="50%" valign="top">
-<img src="./readme_images/02-feature-icon-installer.svg" width="48" align="left">
+### 2）面向不同工作方式的命令
 
-**🎯 14 个自动激活质量技能**
+命令在 AI CLI 对话中使用，以 `~` 开头。HelloAGENTS 会直接读取对应 command skill；无关技能不会提前加载，除非后续流程确实需要。
 
-技能根据你正在做的事情自动激活，无需配置。
-- UI、安全、API、架构、性能
-- 测试、错误处理、数据、代码审查
-- 调试、子代理、文档、验证、反思
+| 命令 | 用途 |
+|------|------|
+| `~idea` | 轻量探索和方向比较；不写文件 |
+| `~auto` | 自动选择主路径，并持续推进到交付或真实阻塞 |
+| `~plan` | 需求、方案、任务拆分和方案包 |
+| `~build` | 按当前请求或现有方案实现 |
+| `~prd` | 通过逐维度讨论生成现代产品需求文档 |
+| `~loop` | 设置指标和守卫命令，循环改进、保留或回滚 |
+| `~wiki` | 只创建或同步项目知识库 |
+| `~init` | 完整项目初始化：知识库、项目级规则文件和 skills 链接 |
+| `~test` | 为指定模块或最近变更编写测试 |
+| `~verify` | 审查、运行验证命令、修复失败并收尾 |
+| `~commit` | 生成规范化提交信息并同步知识库 |
+| `~clean` | 归档已完成方案，清理临时运行文件 |
+| `~help` | 显示命令和当前设置 |
 
-**你的收益：** 每个任务都能得到正确的质量检查，不用你记着去要求。
+兼容别名：
 
-</td>
-<td width="50%" valign="top">
-<img src="./readme_images/03-feature-icon-workflow.svg" width="48" align="left">
+- `~do` → `~build`
+- `~design` → `~plan`
+- `~review` → `~verify` 的审查优先模式
 
-**📋 检查清单把关**
+### 3）项目知识库
 
-编码完成后，HelloAGENTS 收集所有已激活技能的交付检查清单，逐项验证通过才能报告完成。
+HelloAGENTS 可以在 `.helloagents/` 下创建和维护项目知识库。
 
-**你的收益：** 没有真正通过质量检查的东西不会被标记为"完成"。
+知识库让后续对话不用反复重新理解同一批项目事实。它可以包含：
 
-</td>
-</tr>
-<tr>
-<td width="50%" valign="top">
-<img src="./readme_images/04-feature-icon-safety.svg" width="48" align="left">
+| 文件或目录 | 用途 |
+|------------|------|
+| `context.md` | 项目概览、技术栈、架构、模块索引 |
+| `guidelines.md` | 从仓库推断出的非显而易见编码约定 |
+| `verify.yaml` | lint、test、build 等验证命令 |
+| `CHANGELOG.md` | 项目级变更记录 |
+| `DESIGN.md` | UI 项目的稳定设计契约 |
+| `modules/*.md` | 模块级说明和经验 |
+| `plans/<feature>/` | 活跃方案包 |
+| `archive/` | 已归档方案包 |
 
-**🛡️ Guard 系统 + Ralph Loop**
+`~wiki` 只创建或更新知识库。
 
-L1 拦截破坏性命令（`rm -rf /`、`git push --force`、`DROP DATABASE`）。L2 扫描硬编码密钥和安全模式。Ralph Loop 在每个任务后自动运行验证命令。
+`~init` 做得更多：创建或更新知识库、写入项目级规则文件，并刷新各宿主项目级原生 skills 链接。
 
-**你的收益：** 零配置的安全防护，每次输出都经过验证。
+### 4）结构化方案包
 
-</td>
-<td width="50%" valign="top">
-<img src="./readme_images/05-feature-icon-compat.svg" width="48" align="left">
+复杂任务不再只依赖聊天里的几段说明，而是可以落成方案包。
 
-**⚡ 结构化工作流**
+`~plan` 使用：
 
-简单任务保持快速。复杂任务走“先选路再执行”的主流程：ROUTE/TIER → SPEC → PLAN → BUILD → VERIFY → CONSOLIDATE，并通过显式命令通道拆分脑暴、规划、实现与验证。
+- `requirements.md`
+- `plan.md`
+- `tasks.md`
+- `contract.json`
 
-**你的收益：** 按需投入 — 简单任务保持快速，复杂任务获得完整流程。
+`~prd` 还会生成 PRD 文件，例如：
 
-</td>
-</tr>
-<tr>
-<td width="50%" valign="top">
-<img src="./readme_images/02-feature-icon-installer.svg" width="48" align="left">
+- `prd/00-overview.md`
+- `prd/01-user-stories.md`
+- `prd/02-functional.md`
+- `prd/03-ui-design.md`
+- `prd/04-technical.md`
+- `prd/05-nonfunctional.md`
+- `prd/06-i18n-l10n.md`
+- `prd/07-accessibility.md`
+- `prd/08-content.md`
+- `prd/09-testing.md`
+- `prd/10-deployment.md`
+- `prd/11-legal-privacy.md`
+- `prd/12-timeline.md`
 
-**🧠 结构化计划产物**
+`contract.json` 会影响验证范围、reviewer/tester 关注点、可选 advisor 检查和可选视觉验收。
 
-复杂任务不再只靠一段自然语言方案，而是落成 `requirements.md`、`plan.md`、`tasks.md`、`contract.json`、`STATE.md`、`DESIGN.md` 等可追踪产物。
+### 5）状态与恢复
 
-**你的收益：** 路由、实现、验证、收尾都围绕同一组判断依据推进，不容易中途漂移。
+长任务需要一个小型恢复快照，但多个对话共用一个状态文件并不安全。
 
-</td>
-<td width="50%" valign="top">
-<img src="./readme_images/05-feature-icon-compat.svg" width="48" align="left">
+HelloAGENTS 现在只从 `state_path` 解析当前状态文件：
 
-**🗂️ 本地 / 共享双存储**
+- 宿主提供稳定会话标识时：`.helloagents/sessions/<branch>/<session>/STATE.md`
+- 宿主未提供稳定会话标识时：`.helloagents/sessions/<branch>/default/STATE.md`
 
-默认把知识库和方案包放在项目本地 `.helloagents/`；如果你有多个 worktree，可以切到 `project_store_mode=repo-shared`，把稳定项目知识共享到 `~/.helloagents/projects/<repo-key>/`。
+`STATE.md` 只记录当前工作流做到哪里，不承担所有对话的统一记忆。
 
-**你的收益：** 保留本地运行态隔离，同时避免在多个 worktree 间复制方案和知识库。
+### 6）验证与交付证据
 
-</td>
-</tr>
-</table>
+HelloAGENTS 不把“命令通过”和“任务完成”简单画等号。交付还可能要求需求覆盖、任务清单、审查证据、advisor 证据和视觉证据。
 
-## 🚀 快速开始
+运行态证据文件包括：
 
-### 1）先安装
+- `.helloagents/.ralph-review.json`
+- `.helloagents/.ralph-advisor.json`
+- `.helloagents/.ralph-visual.json`
+- `.helloagents/.ralph-closeout.json`
+- `.helloagents/loop-results.tsv`
 
-```bash
-npm install -g helloagents
-```
+### 7）更安全的安装、更新、清理和诊断
 
-如果你的系统 `PATH` 里已经存在其他同名 `helloagents` 可执行文件，可以改用内置的稳定别名：
+CLI 显式管理宿主文件：
 
-```bash
-helloagents-js
-```
+- `install` 只写入指定目标，除非使用 `--all`
+- `update` 刷新指定目标或全部目标
+- `cleanup` 删除受管注入和链接
+- `uninstall` 在移除包前执行对应清理
+- `doctor` 检查规则文件、链接、hooks、配置项、插件根目录、缓存副本和版本漂移
 
-`postinstall` 现在只负责安装包和初始化 `~/.helloagents/helloagents.json`，**不会自动部署到任何 CLI**。
+## 快速开始
 
-安装包后，用显式命令部署到目标 CLI：
+### 1）安装包
 
 ```bash
-helloagents install codex --standby
-helloagents install --all --standby
+npm install -g helloagents
 ```
 
-> 注意：`npm install helloagents`（不带 `-g`）同样只会安装包本身，不会自动改任何 CLI 配置。
+如果系统里已经有别的 `helloagents` 可执行文件，可以使用稳定别名：
 
-### 2）选择模式
+```bash
+helloagents-js
+```
+
+`postinstall` 只安装包命令并初始化 `~/.helloagents/helloagents.json`，不会自动部署到任何 AI CLI。
 
-| 目标 | 执行命令 | 结果 |
-|------|----------|------|
-| 先安装包，不立即改宿主 | `npm install -g helloagents` | 仅安装命令与 `~/.helloagents/helloagents.json` |
-| 默认保持轻量 | `helloagents install --all --standby` | **标准模式**：显式为目标 CLI 注入精简规则 |
-| 所有项目启用完整规则 | `helloagents install --all --global` 或 `helloagents --global` | 切到 **全局模式**：Claude/Gemini 走原生插件/扩展，Codex 自动安装原生本地插件 |
-| 本地切分支/改文件后重新同步 | `helloagents update codex`、`helloagents install --all --standby`、`helloagents --global` | 按目标或当前模式刷新已注入/已复制的文件 |
+### 2）部署到目标 CLI
 
-### 2.1）按单个 CLI 管理
+想按项目显式激活，使用标准模式：
 
 ```bash
 helloagents install codex --standby
-helloagents install --all --global
-helloagents update codex
-helloagents cleanup claude --global
-helloagents uninstall gemini
+helloagents install --all --standby
 ```
 
-- 支持的目标：`claude`、`gemini`、`codex`
-- 省略 `--standby` / `--global` 时：优先沿用该 CLI 已记录或已检测到的模式；如果没有历史记录，则回退到 `standby`
-- `install` / `update` 只处理目标 CLI；用 `--all` 可显式批量处理全部目标
-- Claude Code / Gemini CLI 在 `global` 模式下仍需手动执行原生插件/扩展安装或卸载命令；Codex CLI 仍由 HelloAGENTS 自动处理本地插件安装
-
-如需所有项目启用完整规则，切换到全局模式：
+想在所有项目默认启用完整规则，使用全局模式：
 
 ```bash
 helloagents --global
 ```
 
-然后按需为你的 CLI 安装原生插件/扩展：
+### 3）在 AI CLI 里验证
 
-```bash
-# Claude Code
-/plugin marketplace add hellowind777/helloagents
+输入：
 
-# Gemini CLI
-gemini extensions install https://github.com/hellowind777/helloagents
+```text
+~help
 ```
 
-Codex CLI 无需手动执行插件命令。`helloagents --global` 会自动安装原生本地插件，写入：
-- `~/.agents/plugins/marketplace.json`
-- `~/plugins/helloagents/`
-- `~/.codex/plugins/cache/local-plugins/helloagents/local/`
-- `~/.codex/config.toml` 中的 `helloagents@local-plugins`
+应能看到 13 个对话命令和当前设置。
 
-### 3）在对话里验证
+### 4）创建项目知识
 
-```bash
-# 在 AI CLI 对话中输入：
-~help
-```
+只创建知识库：
 
-**预期输出：**
+```text
+~wiki
 ```
-💡【HelloAGENTS】- 帮助
 
-可用命令: ~idea, ~auto, ~plan, ~build, ~prd, ~loop, ~wiki, ~init, ~test, ~verify, ~commit, ~clean, ~help
+完整初始化项目：
 
-自动激活技能 (14): hello-ui, hello-api, hello-security, hello-test, hello-verify, hello-errors, hello-perf, hello-data, hello-arch, hello-debug, hello-subagent, hello-review, hello-write, hello-reflect
+```text
+~init
 ```
 
-### 4）首次使用
+## CLI 管理
 
-```bash
-# 简单任务 — 直接执行
-"修复 src/utils.ts 第 42 行的拼写错误"
+### Shell 命令
 
-# 复杂任务 — 用 ~auto 走完整流程
-~auto "添加基于 JWT 的用户认证"
-
-# 想先看方案？
-~plan "重构支付模块"
+```bash
+helloagents --standby
+helloagents --global
+helloagents install codex --standby
+helloagents install --all --global
+helloagents update codex
+helloagents cleanup claude --global
+helloagents uninstall gemini
+helloagents doctor
+helloagents doctor codex --json
 ```
 
-## 🔄 安装流程与文件写入
-
-HelloAGENTS 在不同模式下会写入不同文件，但写入/恢复/清理都是可预期的。
+支持的目标：
 
-### 标准模式（默认）
+- `claude`
+- `gemini`
+- `codex`
+- `--all`
 
-| CLI | HelloAGENTS 会写入/更新的文件 | 保留什么 | 卸载 / 切模式时会清什么 |
-|-----|------------------------------|----------|-------------------------|
-| Claude Code | `~/.claude/CLAUDE.md`、`~/.claude/settings.json`、`~/.claude/helloagents -> <包根目录>` | 现有非 HelloAGENTS markdown、settings、permissions、hooks | 删除注入标记块、HelloAGENTS hooks/permissions 和符号链接 |
-| Gemini CLI | `~/.gemini/GEMINI.md`、`~/.gemini/settings.json`、`~/.gemini/helloagents -> <包根目录>` | 现有 markdown、hooks 和无关配置 | 删除注入标记块、HelloAGENTS hooks 和符号链接 |
-| Codex CLI | `~/.codex/AGENTS.md`、`~/.codex/config.toml`、形如 `~/.codex/config.toml_YYYYMMDD-HHMMSS.bak` 的时间戳备份、`~/.codex/helloagents -> <包根目录>` | 通过 backup/restore 保留原有顶层 TOML 配置和无关 section | 删除注入标记块、HelloAGENTS TOML 键、符号链接以及最新的 HelloAGENTS 托管备份 |
+省略 `--standby` 或 `--global` 时，HelloAGENTS 会先复用该 CLI 已记录或检测到的模式，再回退到 `standby`。
 
-### 全局模式
+### 标准模式文件
 
-| CLI | 安装方式 | 相关文件 |
-|-----|---------|----------|
-| Claude Code | 原生插件安装（手动命令） | 由 Claude 插件系统管理 |
-| Gemini CLI | 原生扩展安装（手动命令） | 由 Gemini 扩展系统管理 |
-| Codex CLI | 原生本地插件（自动） | `~/.agents/plugins/marketplace.json`、`~/plugins/helloagents/`、`~/.codex/plugins/cache/local-plugins/helloagents/local/`、`~/.codex/config.toml`、`~/.codex/helloagents -> ~/plugins/helloagents` |
+| CLI | 写入或更新的文件 | 清理行为 |
+|-----|------------------|----------|
+| Claude Code | `~/.claude/CLAUDE.md`、`~/.claude/settings.json`、`~/.claude/helloagents -> <package-root>` | 删除受管标记块、HelloAGENTS hooks / 权限和符号链接 |
+| Gemini CLI | `~/.gemini/GEMINI.md`、`~/.gemini/settings.json`、`~/.gemini/helloagents -> <package-root>` | 删除受管标记块、HelloAGENTS hooks 和符号链接 |
+| Codex CLI | `~/.codex/AGENTS.md`、`~/.codex/config.toml`、`~/.codex/helloagents -> <package-root>`、受管备份 | 删除受管标记块、受管配置键、符号链接和最近一次受管备份 |
 
-### 更新 / 重装 / 切分支行为
+### 全局模式文件
 
-- **标准模式** 通过 `~/.claude/helloagents`、`~/.gemini/helloagents`、`~/.codex/helloagents` 这三个符号链接保持脚本、技能、模板和 hooks 与包根目录同步，相关链接文件会立即反映本地变化；但 `CLAUDE.md`、`GEMINI.md`、`AGENTS.md` 这类注入后的规则文件仍是快照，bootstrap 或分支变化后需要显式刷新。
-- **Codex 全局模式** 使用复制后的运行时文件，并维护 `~/.codex/helloagents -> ~/plugins/helloagents` 作为 bootstrap 路由期望的稳定读取根目录。重新执行 `helloagents --global` 会刷新 `~/plugins/helloagents/` 和 Codex cache 中的副本。
-- 重新执行当前模式命令是被支持的：`helloagents --standby` 和 `helloagents --global` 都是 **切换或刷新** 命令。
-- 如需确定性的手动清理，先执行 `helloagents cleanup`，再执行 `npm uninstall -g helloagents`。
-- `npm uninstall -g helloagents` 会移除包本身；`~/.helloagents/helloagents.json` 会被有意保留。
+| CLI | 安装方式 | 涉及文件 |
+|-----|----------|----------|
+| Claude Code | 原生插件安装 | 由 Claude Code 插件系统管理 |
+| Gemini CLI | 原生扩展安装 | 由 Gemini 扩展系统管理 |
+| Codex CLI | 原生本地插件链路 | `~/.agents/plugins/marketplace.json`、`~/plugins/helloagents/`、`~/.codex/plugins/cache/local-plugins/helloagents/local/`、`~/.codex/config.toml`、`~/.codex/helloagents -> ~/plugins/helloagents` |
 
-## 📖 命令
+Claude Code 和 Gemini CLI 的全局模式仍需要宿主原生命令：
 
-所有命令在 AI 对话中使用 `~` 前缀：
+```text
+/plugin marketplace add hellowind777/helloagents
+gemini extensions install https://github.com/hellowind777/helloagents
+```
 
-**工作流命令：**
+Codex 全局模式由 HelloAGENTS 通过本地插件路径自动安装。
 
-| 命令 | 说明 |
-|------|------|
-| `~idea` | 轻量点子探索 — 比较方向与方案，不写文件 |
-| `~auto` | 自动执行 — 自动选择主路径并持续推进到实现 / 验证 / 收尾，并优先复用现有活跃方案包 |
-| `~plan` | 结构化规划 — 需求澄清 + 方案确认 + 计划包 |
-| `~build` | 执行实现 — 基于当前需求或现有计划包完成实现 |
-| `~prd` | 完整 PRD — 13 维度头脑风暴式探索，生成产品需求文档 |
-| `~loop` | 自主迭代优化 — 设定目标和指标，AI 循环改进直到达标 |
+## 对话命令
 
-**质量命令：**
+### 常见流程
 
-| 命令 | 说明 |
+| 目标 | 使用 |
 |------|------|
-| `~test` | 编写完整测试（TDD：Red → Green → Refactor） |
-| `~verify` | 统一验证入口 — 审查、lint、typecheck、test、build 与修复循环 |
+| 写文件前先比较方案 | `~idea "compare two API designs"` |
+| 让 HelloAGENTS 自己选路并持续推进 | `~auto "add JWT login"` |
+| 先审查方案再实现 | `~plan "refactor payment module"` |
+| 按明确请求或活跃方案实现 | `~build "finish task 2 in the plan"` |
+| 生成完整产品需求文档 | `~prd "modern dashboard for operations team"` |
+| 按指标迭代优化 | `~loop "reduce bundle size" --metric "npm run size" --direction lower` |
+| 只创建或刷新项目知识 | `~wiki` |
+| 完整激活项目工作流 | `~init` |
+| 验证当前工作 | `~verify` |
+| 生成提交信息并同步知识库 | `~commit` |
 
-**工具命令：**
+### 已激活项目与未激活项目
 
-| 命令 | 说明 |
-|------|------|
-| `~wiki` | 仅创建/同步项目知识库（`.helloagents/`） |
-| `~init` | 完整初始化项目：知识库 + 项目级规则文件 |
-| `~commit` | 生成规范化提交信息 + 知识库同步 |
-| `~clean` | 归档已完成方案，清理临时文件 |
-| `~help` | 显示所有命令和当前配置 |
+标准模式下，未激活项目只获得轻量规则和显式 `~command` 入口。项目中出现 `.helloagents/` 后才进入项目级工作流，通常由 `~wiki` 或 `~init` 创建。
 
-兼容别名：
-- `~design` → `~plan`
-- `~do` → `~build`
-- `~review` → `~verify`（审查优先模式）
+全局模式下，HelloAGENTS 默认启用完整规则。
 
-## 🔧 配置
+## 项目知识库
 
-配置文件：`~/.helloagents/helloagents.json`（安装时自动创建）
+### 本地模式
 
-只需包含你想覆盖的键，缺失的键使用默认值。
+默认情况下，项目知识写在项目内：
 
-```json
-{
-  "output_language": "",
-  "output_format": true,
-  "notify_level": 0,
-  "ralph_loop_enabled": true,
-  "guard_enabled": true,
-  "kb_create_mode": 1,
-  "project_store_mode": "local",
-  "commit_attribution": "",
-  "install_mode": "standby"
-}
+```text
+.helloagents/
 ```
 
-| 配置项 | 默认值 | 说明 |
-|--------|-------|------|
-| `output_language` | `""` | 空=跟随用户语言，填写 `zh-CN`、`en` 等指定 |
-| `output_format` | `true` | `true`=仅主代理在流式结束后的最终收尾回复可使用 HelloAGENTS 布局；所有流式/进度/中间输出及所有子代理输出保持自然；`false`=自然输出 |
-| `notify_level` | `0` | `0`=关闭，`1`=桌面通知，`2`=声音，`3`=两者 |
-| `ralph_loop_enabled` | `true` | 任务完成时自动运行验证 |
-| `guard_enabled` | `true` | 拦截危险命令 |
-| `kb_create_mode` | `1` | `0`=关闭，`1`=已激活项目或全局模式中的编码任务自动，`2`=已激活项目或全局模式中始终 |
-| `project_store_mode` | `"local"` | `"local"`=知识库/方案包保留在项目本地 `.helloagents/`；`"repo-shared"`=本地 `.helloagents/` 仅保留激活/STATE/运行态，知识库与方案包改写到 `~/.helloagents/projects/<repo-key>/` |
-| `commit_attribution` | `""` | 空=不添加，填写内容则追加到 commit message |
-| `install_mode` | `"standby"` | `"standby"`=按项目激活（精简规则），`"global"`=所有项目启用完整规则 |
+这个目录同时承担：
 
-<details>
-<summary>📝 常见配置场景</summary>
+- 激活信号
+- 本地知识库目录
+- 方案目录
+- 状态与运行态目录
 
-**切换到全局模式（所有项目启用完整规则）：**
-```bash
-helloagents --global
-```
+### 共享模式
 
-**切换回标准模式（默认）：**
-```bash
-helloagents --standby
-```
+当 `project_store_mode = "repo-shared"` 时：
 
-**纯英文输出：**
-```json
-{ "output_language": "en" }
-```
+- 本地 `.helloagents/` 保留激活和运行态文件
+- 稳定知识和方案文件写到 `~/.helloagents/projects/<repo-key>/`
+- 同一 git 仓库的多个 worktree 可以共享这些稳定资料
 
-**关闭知识库自动创建：**
-```json
-{ "kb_create_mode": 0 }
-```
+运行态文件仍保留在当前项目本地：
 
-**多个 worktree 共享知识库和方案包：**
-```json
-{ "project_store_mode": "repo-shared" }
-```
+- `state_path`
+- `.ralph-*.json`
+- `loop-results.tsv`
 
-**开启桌面+声音通知：**
-```json
-{ "notify_level": 3 }
-```
+### 知识创建规则
 
-**关闭 Guard（不推荐）：**
-```json
-{ "guard_enabled": false }
-```
+| 命令或配置 | 行为 |
+|------------|------|
+| `~wiki` | 只创建或同步知识库 |
+| `~init` | 创建知识库，同时写入项目级规则文件和 skills 链接 |
+| `kb_create_mode = 0` | 关闭自动知识更新 |
+| `kb_create_mode = 1` | 已激活项目或全局模式中，编码任务自动更新知识 |
+| `kb_create_mode = 2` | 已激活项目或全局模式中，更积极地更新知识 |
 
-</details>
+## 工作流与交付
 
-## ⚙️ 工作原理
+### 工作流阶段
 
-**简单说：** HelloAGENTS 根据任务类型、风险等级和项目状态选择执行深度。标准模式下，未激活项目只保留轻量规则：安全、完成约束、压缩版质量下限，以及显式 `~command` 通道；一旦项目通过 `.helloagents/` 激活，或启用全局模式，就切换到完整主流程，显式经过脑暴、规划、实现、验证与收尾阶段。
+结构化任务使用以下阶段：
 
-**六阶段主流程：**
+```text
+ROUTE / TIER → SPEC → PLAN → BUILD → VERIFY → CONSOLIDATE
+```
 
-1. **ROUTE / TIER** — 判断当前任务应进入 `~idea`、`~plan`、`~build`、`~verify`、`~prd` 还是 `~auto`
-2. **SPEC** — 明确目标、约束与成功标准
-3. **PLAN** — 标记所需质量技能，并准备 `requirements.md`、`plan.md`、`tasks.md` 等结构化产物
-4. **BUILD** — 实现，TDD（写测试 → 写代码 → 重构），每步后增量验证
-5. **VERIFY** — 运行 Ralph Loop，需要时先审查 diff，再收集交付检查清单
-6. **CONSOLIDATE** — 更新 `STATE.md`、同步知识库、归档计划包
+| 阶段 | 用途 |
+|------|------|
+| `ROUTE / TIER` | 判断任务应走 idea、plan、build、verify、PRD 还是自动流程 |
+| `SPEC` | 明确目标、约束和完成标准 |
+| `PLAN` | 准备方案文件并选择需要的技能 |
+| `BUILD` | 实现并做局部检查 |
+| `VERIFY` | 审查、运行命令、核对契约和证据 |
+| `CONSOLIDATE` | 更新状态、知识库和收尾证据 |
 
-**Delivery Tier：**
-- `T0` — 只读探索、点子比较、方向发散
-- `T1` — 低风险小改动、明确实现、显式验证
-- `T2` — 多文件功能、新项目、需要结构化产物的任务
-- `T3` — 高风险或不可逆操作，如认证、安全、支付、数据库、生产发布
+### 交付分层
 
-**路由规则：**
-- 点子探索 / 比较方向 → `~idea`
-- 简单任务（单文件、明确修复）→ 直接执行或 `~build`
-- 复杂任务（3+ 文件、架构变更、新项目）→ 通过 `~plan`、`~auto` 或 `~prd` 走完整流程
-- 审查 / 验证类任务 → `~verify`
+| 分层 | 典型场景 |
+|------|----------|
+| `T0` | 只读分析、点子探索、方案比较 |
+| `T1` | 低风险小修复或明确验证 |
+| `T2` | 多文件功能、新项目、结构化方案 |
+| `T3` | 高风险或不可逆工作，如认证、支付、数据库、发布、生产操作 |
 
-**按任务类型生效的质量规则与技能：**
-- UI / 前端 / 视觉交互任务始终先遵循当前 bootstrap 文件中的 UI 质量基线
-- 在已激活项目、全局模式或显式 UI 工作流命令中，`hello-ui` 会进一步补充设计契约执行、设计系统映射与视觉验收
-- 只有当 UI `contract.json` 显式要求更强 UI 保障时，HelloAGENTS 才会在保持默认路径轻量的前提下，额外引入 `.helloagents/.ralph-advisor.json` 和 `.helloagents/.ralph-visual.json`
-- 涉及 API？→ `hello-api` 激活（REST 规范、校验、错误格式）
-- 任何代码变更？→ `hello-test`、`hello-verify`、`hello-review` 激活
+### UI 工作流
 
-### 标准模式 vs 全局模式
+UI 任务遵循以下优先级：
 
-HelloAGENTS 支持两种安装模式，采用不同的安装方式：
+1. 当前 `plan.md` 或 PRD 中的 UI 决策
+2. `.helloagents/DESIGN.md`
+3. 共享 UI 质量基线
+4. `hello-ui` 的实现和验收规则
 
-| 模式 | 安装方式 | 规则 | 技能 | 适用场景 |
-|------|---------|------|------|----------|
-| **标准模式** (默认) | `helloagents install <target> --standby` 或 `helloagents install --all --standby` | `bootstrap-lite.md`（含压缩版质量下限、UI 质量基线、安全规则与完成约束的精简规则） | `~command` 按需使用；激活前 UI 任务仍受 UI 质量基线约束，出现 `.helloagents/` 后切换到完整流程 | 按需使用，不影响其他项目 |
-| **全局模式** | Claude/Gemini 手动装插件；Codex 自动装原生本地插件 | `bootstrap.md`（完整规则） | 14 个技能自动激活 | 全面使用 HelloAGENTS |
+更重的 UI 任务可以通过 `contract.json` 要求：
 
-标准模式会把规则注入到 `~/.claude/CLAUDE.md`、`~/.gemini/GEMINI.md`、`~/.codex/AGENTS.md`；对于 Codex，HelloAGENTS 还会在 `~/.codex/config.toml` 中写入一条受管的 `model_instructions_file`，指向同步后的 `~/.codex/AGENTS.md`，让同一份 home carrier 同时成为 Codex 的 base instructions override。执行清理时会恢复用户原来的 `model_instructions_file`。每个 CLI 还会创建 `helloagents` 包根目录符号链接。Claude Code 和 Gemini 仍使用 hooks，因为宿主可以较安静地承载这类注入；Codex 默认**不启用** HelloAGENTS hooks：最新 pre 源码里 hook 生命周期会在 TUI 中可见显示，且 `suppressOutput` 不能作为真正的静默注入通道，所以 Codex 改为依赖注入后的规则文件，以及本地符号链接 / 原生本地插件目录结构。全局模式下，Claude Code 通过 `.claude-plugin/plugin.json` 中声明的 hooks 工作，Gemini 通过 `contextFileName=bootstrap.md` 和扩展 hooks 工作；Codex 仍使用原生本地插件安装（marketplace + 本地插件目录 + cache + `config.toml` 插件启用段），并继续使用同一份 `~/.codex/AGENTS.md` home 基线，但不启用插件 hooks。
+- `ui.styleAdvisor.required`
+- `ui.visualValidation.required`
 
-在标准模式下，`.helloagents/` 就是项目激活边界。激活前，lite 规则**不会**进入完整六阶段主流程，也不会启用语义自动选路；它只保留轻量执行规则、显式 `~command` 入口，以及最低质量/完成门槛。项目一旦存在 `.helloagents/`，当前项目就切换到完整项目流程，并以 `bootstrap.md` 作为运行时判断依据。
+这些要求分别通过 `.helloagents/.ralph-advisor.json` 和 `.helloagents/.ralph-visual.json` 收尾。
 
-整套切换可用：`helloagents --global` 或 `helloagents --standby`
+### 验证命令来源
 
-重复执行当前模式命令也是合法的。它会在本地切分支、开发调试或手工清理后刷新当前模式下的注入/复制文件。
+验证命令按以下顺序检测：
 
-## 📚 使用指南
+1. 逻辑 `.helloagents/verify.yaml`
+2. `package.json` 等包管理脚本
+3. 自动检测
 
-### 核心工作流通道
+当 `project_store_mode = "repo-shared"` 时，逻辑 `.helloagents/verify.yaml` 会从共享项目存储中解析。
 
-| 模式 | 说明 | 适用场景 |
-|------|------|----------|
-| `~idea` | 仅做轻量探索，不写文件 | 想先比较方向，不想进入完整项目流程 |
-| `~plan` | 仅做交互式规划，生成计划包 | 想先审查方案再编码 |
-| `~build` | 从当前需求或现有计划包执行实现 | 需求已明确，想直接开始做 |
-| `~verify` | 审查与验证工作流 | 想先看审查结果、跑检查并修复 |
-| `~auto` | 在以上模式之间自动选择并一路推进 | 需求明确，想要端到端交付 |
-| `~prd` | 13 维度 PRD 生成 | 需要完整的产品需求文档 |
+## 配置
 
-典型模式：先 `~idea` 比较方向，再 `~plan` 确认方案，然后 `~build` 实现，最后 `~verify` 验证。或者直接 `~auto` 一步到位。如果项目里已经有活跃方案包，`~auto` 应先复用现有计划，而不是无故重新脑暴或重新规划。涉及 UI 时，决策优先级固定为：`plan.md` / PRD 中的 UI 决策 → `DESIGN.md` → 通用 UI 规则。
+配置文件：
 
-### 质量验证（Ralph Loop）
+```text
+~/.helloagents/helloagents.json
+```
 
-每个任务完成后，Ralph Loop 自动运行项目的验证命令：
-- 优先级：逻辑 `.helloagents/verify.yaml`（`project_store_mode=repo-shared` 时解析到共享知识目录）→ `package.json` scripts → 自动检测
-- 全部通过？→ 收集技能检查清单 → 验证 → 完成
-- 有失败？→ 反思 → 修复 → 重跑（3 次连续失败后触发熔断）
-- 若当前活跃方案包仍有未完成任务、缺少必需结构化产物，或残留模板占位内容，交付也会被额外把关拦下
+默认结构：
 
-### 知识库（`.helloagents/`）
+```json
+{
+  "output_language": "",
+  "output_format": true,
+  "notify_level": 0,
+  "ralph_loop_enabled": true,
+  "guard_enabled": true,
+  "kb_create_mode": 1,
+  "project_store_mode": "local",
+  "commit_attribution": "",
+  "install_mode": "standby"
+}
+```
 
-`~wiki` 只创建或同步项目知识库。`~init` 是更完整的项目初始化：它还会写入项目级规则文件（`AGENTS.md`、`CLAUDE.md`、`.gemini/GEMINI.md`）、刷新各宿主项目级原生 skills 链接，并补齐相关忽略项。在标准模式下，真正让当前项目进入完整项目流程的是项目本地 `.helloagents/` 的存在，项目级规则文件只是 `~init` 的附加能力。
+| 键 | 默认值 | 含义 |
+|----|--------|------|
+| `output_language` | `""` | 默认跟随用户语言 |
+| `output_format` | `true` | 只有主代理最终收尾消息可以使用 HelloAGENTS 格式 |
+| `notify_level` | `0` | `0` 关闭，`1` 桌面通知，`2` 声音，`3` 两者 |
+| `ralph_loop_enabled` | `true` | 任务完成后运行验证 |
+| `guard_enabled` | `true` | 拦截危险命令 |
+| `kb_create_mode` | `1` | 控制知识库自动更新 |
+| `project_store_mode` | `"local"` | `local` 或 `repo-shared` |
+| `commit_attribution` | `""` | 提交信息附加署名 |
+| `install_mode` | `"standby"` | 当前默认安装模式 |
 
-默认情况下，知识库和方案包都写在项目本地 `.helloagents/`。状态文件只使用 `state_path` 指定的位置。当宿主能提供稳定的会话标识时，HelloAGENTS 会把它写到 `.helloagents/sessions/<branch>/<session>/STATE.md`；否则写到分支默认位置 `.helloagents/sessions/<branch>/default/STATE.md`。若 `project_store_mode = "repo-shared"`，本地 `.helloagents/` 仅保留激活信号、会话级 `STATE.md` 与 `.ralph-*` 等运行态文件；`context.md`、`guidelines.md`、`DESIGN.md`、`verify.yaml`、`modules/`、`plans/`、`archive/` 会改写到 `~/.helloagents/projects/<repo-key>/`，从而在同一 git 仓库的多个 worktree 间共享稳定资料。
+## 各 CLI 集成方式
 
-`STATE.md` 是由 `state_path` 解析出的当前状态文件，不是所有交互的统一记忆文件。按“分支 + 会话 / 默认位置”存储后，同仓库并发对话不再争用同一个文件。它会在 `~wiki`、`~init`、`~plan`、`~build`、`~auto`、`~prd`、`~loop` 这类项目级连续流程中创建并持续更新；在验证/审查类任务中仅在文件已存在时更新；对 `~help` 这类一次性只读交互则不会创建。
+### Claude Code
 
-| 文件 | 用途 |
-|------|------|
-| `STATE.md` | 项目级恢复快照（≤70 行，压缩后可据此续接） |
-| `DESIGN.md` | 项目级 UI 契约（设计系统、组件模式、状态覆盖、无障碍要求） |
-| `context.md` | 项目架构、技术栈、约定 |
-| `guidelines.md` | 非显而易见的编码规则 |
-| `verify.yaml` | 验证命令 |
-| `CHANGELOG.md` | 变更历史 |
-| `modules/*.md` | 模块文档 + 经验 |
-| `plans/` | 活跃计划包（`requirements.md`、`plan.md`、`tasks.md`、`contract.json`） |
-| `archive/` | 已完成计划包 |
+- 标准模式写入 `~/.claude/CLAUDE.md`
+- 标准模式在 `~/.claude/settings.json` 中写入受管 hooks 和权限
+- 标准模式创建 `~/.claude/helloagents -> <package-root>`
+- 全局模式使用 Claude Code 插件系统
 
-### 智能提交（~commit）
+### Gemini CLI
 
-- 分析 `git diff` 生成 Conventional Commits 格式消息
-- 提交前质量检查（代码-文档一致性、测试覆盖）
-- 自动排除敏感文件（`.env`、`*.pem`、`*.key`）
-- 遵循 `commit_attribution` 配置
-- 按 `kb_create_mode` 设置同步知识库
+- 标准模式写入 `~/.gemini/GEMINI.md`
+- 标准模式在 `~/.gemini/settings.json` 中写入受管 hooks
+- 标准模式创建 `~/.gemini/helloagents -> <package-root>`
+- 全局模式使用 Gemini 扩展系统
 
-### 自主迭代优化（~loop）
+### Codex CLI
 
-设定目标和指标，让 AI 自主迭代：
-1. 审查 → 构思 → 修改 → 提交 → 验证 → 决策 → 记录 → 重复
-2. 结果记录在 `.helloagents/loop-results.tsv`
-3. 失败实验使用 `git revert` 干净回滚
+Codex 默认走规则文件驱动。
 
-## 🧪 验证
+- 标准模式写入 `~/.codex/AGENTS.md`
+- 标准模式写入受管 `model_instructions_file` 指向该文件
+- 标准模式写入受管 `notify` 命令用于收尾通知
+- 标准模式创建 `~/.codex/helloagents -> <package-root>`
+- 全局模式安装原生本地插件链路
+- HelloAGENTS 默认不启用 Codex hooks
 
-HelloAGENTS 使用 Node 内置测试运行器：
+## 验证
+
+运行全部测试：
 
 ```bash
 npm test
 ```
 
-测试覆盖：
-- 标准/全局模式的安装、重装、刷新、卸载、模式切换
-- Claude / Gemini / Codex 配置文件的合并、恢复、清理行为
-- Codex 本地插件在本地切分支或文件更新后的刷新流程
-- 运行时 inject / route / guard / Ralph Loop 流程
-- `~/.codex/` 已不存在时，Codex 全局产物的清理行为
-
-## ❓ FAQ
-
-<details>
-<summary><strong>Q：这是 CLI 工具还是 prompt 框架？</strong></summary>
-
-**A：** 两者都是。CLI（`cli.mjs`）负责安装、模式切换和 CLI 配置。实际工作流来自 `bootstrap.md` / `bootstrap-lite.md` 规则、质量技能，以及按宿主选择的运行时辅助流程。Claude/Gemini 会使用 `notify.mjs`、`guard.mjs`、`ralph-loop.mjs` 等 hooks；Codex 默认走规则文件驱动，尽量保持 TUI 安静。可以理解为：交付系统 + 智能质量协议。
-</details>
+当前测试覆盖：
 
-<details>
-<summary><strong>Q：v2.x 到 v3.x 有什么变化？</strong></summary>
+- 安装、更新、卸载、清理和模式切换
+- Claude、Gemini、Codex 的配置合并与恢复
+- Codex 受管 `model_instructions_file`、`notify`、本地插件、marketplace 和缓存行为
+- `helloagents doctor`
+- 项目存储和 `repo-shared`
+- 会话级 `state_path`
+- 运行时选路、Guard、验证、视觉证据和交付门控
+- README 与 skill 契约一致性
 
-**A：** 全部重写了：
-- Python 包 → 纯 Node.js/Markdown 架构
-- 15 个命令 → 12 个命令 + 14 个自动激活质量技能
-- 6 个 CLI 目标 → 3 个（Claude Code + Codex CLI + Gemini CLI）
-- 新增：检查清单把关、Guard 系统、~prd、~loop、~verify、设计系统生成
-- 详见[版本历史](#-版本历史)。
-</details>
+## FAQ
 
-<details>
-<summary><strong>Q：该用哪个 CLI？</strong></summary>
+### 这是 CLI 工具还是提示词框架？
 
-**A：** Claude Code 体验最好（插件系统、11 个生命周期 hooks、Agent Teams 支持）。Gemini CLI 通过扩展系统支持。Codex CLI 也不错。先安装包，再用 `helloagents install <target> --standby` 或 `helloagents install --all --standby` 显式部署到你要用的 CLI。
-</details>
+两者都是。
 
-<details>
-<summary><strong>Q：14 个质量技能是什么？</strong></summary>
+- `cli.mjs` 负责安装、更新、清理、诊断和宿主配置
+- `bootstrap.md` 与 `bootstrap-lite.md` 定义工作流规则
+- `skills/` 定义任务类型相关行为
+- `scripts/` 提供选路、Guard、通知、验证、状态和证据等运行时辅助能力
 
-**A：** 按任务类型自动激活：
-- **hello-ui**：深层 UI 实现与验收（设计契约、设计系统映射、无障碍、响应式、动画）
-- **hello-api**：API 设计（REST、校验、错误格式、限流）
-- **hello-security**：安全（认证、输入校验、XSS/CSRF、密钥管理）
-- **hello-test**：测试（TDD 流程、边界用例、AAA 模式）
-- **hello-verify**：验证把关（Ralph Loop、熔断器）
-- **hello-errors**：错误处理（结构化错误、日志、恢复策略）
-- **hello-perf**：性能（N+1、缓存、代码分割、虚拟滚动）
-- **hello-data**：数据库（迁移、事务、索引、完整性）
-- **hello-arch**：架构（SOLID、边界、代码体积限制）
-- **hello-debug**：调试（四阶段流程、卡住时升级）
-- **hello-subagent**：子代理编排（分发、协调、审查）
-- **hello-review**：代码审查（逻辑、安全、性能、可维护性）
-- **hello-write**：文档（金字塔原则、受众感知）
-- **hello-reflect**：经验捕获（教训 → 知识库）
+### 应该用 `~wiki` 还是 `~init`？
 
-子代理只跳过路由、交互流程和输出包装；编码原则、安全约束、失败处理等基础规则仍然持续生效。
-</details>
+只想创建项目知识库，用 `~wiki`。
 
-<details>
-<summary><strong>Q：标准模式和全局模式有什么区别？</strong></summary>
+还想写入项目级规则文件和宿主原生 skills 链接，用 `~init`。
 
-**A：** 标准模式（默认）把精简规则部署到你明确指定的目标 CLI，通常用 `helloagents install <target> --standby` 或 `helloagents install --all --standby`。项目只要建立了 `.helloagents/` 就会进入完整项目流程，通常通过 `~wiki`（仅知识库）或 `~init`（完整初始化）完成。全局模式使用各 CLI 原生的插件/扩展系统，所有项目自动启用完整规则；可用 `helloagents install <target> --global`、`helloagents install --all --global`，或通过 `helloagents --global` 做整套切换。
-</details>
+### standby 和 global 有什么区别？
 
-<details>
-<summary><strong>Q：项目知识存在哪里？</strong></summary>
+`standby` 更轻量、更显式。它只把规则部署到指定 CLI，完整项目流程由项目激活触发。
 
-**A：** 默认在项目本地 `.helloagents/` 目录。可以由 `~wiki`（仅知识库）或 `~init`（完整项目初始化）创建；之后会按 `kb_create_mode` 在代码变更场景中自动同步。若 `project_store_mode = "repo-shared"`，本地 `.helloagents/` 只保留激活信号、`STATE.md` 与 `.ralph-*` 运行态文件，知识库和方案包会改存到 `~/.helloagents/projects/<repo-key>/`。其中 `STATE.md` 只作为长流程任务的精简恢复快照，不承担所有交互的统一记忆。
-</details>
+`global` 默认更广泛地启用完整规则。Claude 和 Gemini 使用原生插件 / 扩展；Codex 使用本地插件路径。
 
-<details>
-<summary><strong>Q：Guard 系统是什么？</strong></summary>
+### 为什么 Codex 默认不用 hooks？
 
-**A：** 两层安全防护：
-- **L1 拦截**：执行前阻止破坏性命令（`rm -rf /`、`git push --force`、`DROP DATABASE`、`chmod 777`、`FLUSHALL`）
-- **L2 建议**：扫描文件写入中的硬编码密钥、API key、.env 暴露 — 警告但不阻止
-</details>
+当前 Codex 集成使用规则文件、`model_instructions_file`、`notify` 和本地插件更稳定。hooks 输出仍可能显示在 TUI 中，因此 HelloAGENTS 默认不启用 Codex hooks。
 
-<details>
-<summary><strong>Q：开启格式化输出后，底部“下一步”栏表示什么？</strong></summary>
+### 可以关闭通知或 Guard 吗？
 
-**A：** 它始终显示当前最合适的下一步动作。若存在自然后续动作，HelloAGENTS 会直接给出明确引导；若当前任务已完整结束且没有合理后续，则回落为完成/等待状态，而不是输出空洞套话。
-</details>
+可以。
 
-<details>
-<summary><strong>Q：可以关闭不需要的功能吗？</strong></summary>
+- 把 `notify_level` 设为 `0` 可关闭通知
+- 把 `guard_enabled` 设为 `false` 可关闭命令 Guard
 
-**A：** 可以。设置 `guard_enabled: false` 关闭 Guard，`ralph_loop_enabled: false` 跳过验证，`kb_create_mode: 0` 关闭知识库。质量技能自动激活但不会给无关任务增加开销。
-</details>
+### `npm uninstall -g helloagents` 会删除项目知识库吗？
 
-<details>
-<summary><strong>Q：~prd 是什么？</strong></summary>
+不会。卸载包只移除包本身。项目 `.helloagents/` 文件和 `~/.helloagents/helloagents.json` 会保留，除非你手动删除。
 
-**A：** 13 维度 PRD 生成器。逐维度走过：产品概述、用户故事、功能需求、UI/UX 设计、技术架构、非功能需求、国际化、无障碍、内容策略、测试策略、部署运维、法律隐私、时间线 — 头脑风暴式，一次一个维度。
-</details>
+## 故障排除
 
-## 🛠️ 故障排除
+### `~help` 无法识别
 
-### 插件未加载（Claude Code）
+检查：
 
-**问题：** 安装插件后 `~help` 无法识别
-
-**解决：** 重启 Claude Code。如果仍不行，检查 `/plugin list` 确认安装状态。
-
----
-
-### 扩展不工作（Gemini CLI）
-
-**问题：** `gemini extensions install` 后 `~help` 无法识别
-
-**解决：** 重启 Gemini CLI。用 `gemini extensions list` 确认安装状态，确保扩展已启用。
-
----
-
-### 文件写入超出工作区范围
-
-**问题：** Gemini CLI 或 Codex CLI 提示目标文件路径不在允许的工作区内。
-
-**解决：** 将文件写入当前项目工作区内，或写入对应 CLI 的临时工作区目录。做 headless 验证时，优先使用当前仓库下的路径，不要随意写到任意绝对路径。
-
----
-
-### 命令未找到
-
-**问题：** 安装后 `~help` 无法识别
+```bash
+npm list -g helloagents
+helloagents doctor
+```
 
-**解决：**
-- 验证安装：`npm list -g helloagents`
-- Claude Code：检查 `~/.claude/CLAUDE.md` 是否包含 HelloAGENTS 标记
-- Gemini CLI：检查 `~/.gemini/GEMINI.md` 是否包含 HelloAGENTS 标记
-- Codex CLI：检查 `~/.codex/AGENTS.md` 是否包含 HelloAGENTS 标记，`~/.codex/config.toml` 是否保留指向 `~/.codex/AGENTS.md` 的 `model_instructions_file` 与 `notify`
-- 重启你的 CLI
+然后重启目标 CLI。
 
----
+### 某个 CLI 已安装但行为像旧版本
 
-### 本地切分支后 Codex 全局模式仍在用旧文件
+运行：
 
-**问题：** 你切换了分支，或更新了本地 link 的仓库，但 Codex 全局模式仍然加载旧的复制文件。
+```bash
+helloagents doctor
+helloagents update codex
+helloagents --standby
+helloagents --global
+```
 
-**解决：** 重新执行当前模式命令：
-- `helloagents --global` → 刷新 `~/plugins/helloagents/` 和 Codex cache 副本
-- `helloagents --standby` → 刷新标准模式下注入的文件和符号链接
+根据当前安装模式和目标 CLI 选择对应命令。
 
----
+### Codex 本地切分支后仍使用旧文件
 
-### Guard 拦截了合法命令
+刷新 Codex：
 
-**问题：** Guard 拦截了你确实想执行的命令
+```bash
+helloagents update codex
+```
 
-**解决：** 在 `~/.helloagents/helloagents.json` 中设置 `guard_enabled: false`。或者检查被拦截的命令 — Guard 只拦截真正的破坏性操作如 `rm -rf /` 和 `git push --force`。
+全局模式也可以运行：
 
----
+```bash
+helloagents --global
+```
 
-### Ralph Loop 持续失败
+### 通知不工作
 
-**问题：** 验证循环无法通过
+先检查 `notify_level`。
 
-**解决：**
-- 检查 `.helloagents/verify.yaml` 中的命令是否正确
-- 手动运行验证命令查看实际错误
-- 3 次连续失败后熔断器激活 — `hello-debug` 升级介入
+- Windows：PowerShell 需要能显示桌面通知或播放声音
+- macOS：需要 `afplay`
+- Linux：需要 `aplay`、`paplay` 或 `notify-send`
 
----
+### Guard 拦截了你确实想执行的命令
 
-### CCswitch 替换了 HelloAGENTS 配置
+先复查命令。Guard 会拦截已知破坏性操作，并对风险写入给出提醒。如果你仍要关闭：
 
-**问题：** 切换 CCswitch 配置后 HelloAGENTS 停止工作
+```json
+{ "guard_enabled": false }
+```
 
-**解决：** 切换配置后重新运行 `/plugin marketplace add hellowind777/helloagents`。CCswitch 会替换整个 CLI 配置目录。
+## 许可证
 
----
+代码使用 [Apache-2.0](./LICENSE.md)，文档使用 CC BY 4.0。
 
-### 通知不工作
+## 参与贡献
 
-**问题：** 没有声音或桌面通知
-
-**解决：**
-- 检查配置中的 `notify_level`（默认 0=关闭）
-- Windows：确保 PowerShell 可以访问 `System.Media.SoundPlayer`
-- macOS：确保 `afplay` 可用
-- Linux：确保安装了 `aplay` 或 `paplay`
-
-## 📈 版本历史
-
-### v3.0.10（当前版本）
-
-**相对 `v3.0.9beta` 的修复与验证：**
-- 🔧 Codex 受管 `notify` 配置现在带有明确标记，清理时可区分 HelloAGENTS 写入和用户自定义的 `codex-notify`
-- 🔧 Codex 清理流程现在会保留用户的多行 `notify` 数组，并正确恢复周围 TOML 配置
-- 🔧 `notify_level=0` 现在同时关闭完成、警告和确认通知，和文档中的“关闭”含义保持一致
-- 🔧 恢复 `hello-ui` 的完整指导；已确认 OpenAI 公开 skill 建议是主 `SKILL.md` 尽量控制在约 500 行以内，而不是按 200 行硬限制精简
-- 🧪 新增 Codex `notify` 保留、多行 TOML 处理和通知等级门控的回归测试
-
-### v3.0.9
-
-**修复与验证：**
-- 🔧 Claude Code / Gemini CLI 的 `stop` 交付门控现在只接受结构化 `turn-state` 完成态，普通等待态不再被误判为已完成
-- 🔧 Codex 清理流程现在会保留安装后用户自行改写的 `model_instructions_file`、`notify` 与非托管 `codex_hooks`，不再被安装前旧备份回写覆盖
-- 🧪 新增运行时 / 生命周期回归，覆盖 `stop` 的结构化完成态门控，以及安装后用户改写 Codex 配置时的 cleanup 保留行为
-
-### v3.0.7
-
-**相对 `v2.3.8` 的当前主线结果：**
-- ✨ 从 Python 包全面重写为 Node.js/Markdown 工作流框架，安装、运行时注入、技能、规则与验证流程全部重建
-- ✨ 把旧的多层路由 / design-develop 流程，统一整理为 ROUTE/TIER → SPEC → PLAN → BUILD → VERIFY → CONSOLIDATE 六阶段主流程
-- ✨ 从旧命令集切换到 `~idea` / `~plan` / `~build` / `~verify` / `~prd` / `~loop` / `~wiki` 等更聚焦的命令体系，并引入 14 个自动激活质量技能
-- ✨ 项目产物体系成型：`STATE.md`、`DESIGN.md`、`requirements.md`、`plan.md`、`tasks.md`、`contract.json`、`.ralph-*` 证据成为流程判断依据，而不是附属文档
-- ✨ 安装模型重构为标准模式 / 全局模式双轨；Codex 改为原生本地插件，Claude/Gemini 保留各自宿主原生能力
-- ✨ 新增 `project_store_mode=repo-shared`，让同一 git 仓库的多个 worktree 可以共享稳定知识库和方案包，而本地 `.helloagents/` 继续保留激活和运行态隔离
-
-### v3.0.4
-
-**标准待机与运行时边界：**
-- 🔧 相对 `v3.0.3`，进一步明确激活边界：完整六阶段主流程保留在 `bootstrap.md`，`bootstrap-lite.md` 作为项目激活前的待机规则文件
-- ✨ 固化标准模式、未激活项目的压缩版质量下限，让轻量模式仍能维持现代技术基线、性能基线和 UI 质量要求
-- 🔧 统一精修 bootstrap 的运行时术语与规则表述，在不改变既有把关模型的前提下提升准确性和专业性
-
-### v3.0.3
-
-**流程与知识库激活：**
-- ✨ 新增 `~wiki`，用于只创建或同步 `.helloagents/`，不写项目级规则文件
-- 🔧 明确标准模式下的激活边界：`.helloagents/` 才是项目进入完整流程的实际信号；项目级规则文件仍属于 `~init` 的职责
-- 🔧 统一修正 bootstrap、帮助文本和 README 中 `kb_create_mode` 的表述，使其只描述已激活项目或全局模式下的同步时机
-- 🧪 新增 `~wiki` 路由覆盖，并持续验证标准模式下基于 `.helloagents/` 的激活行为
-
-### v3.0.2
-
-**修复与验证：**
-- 🔧 移除误回流到 Codex 标准/全局安装产物 `AGENTS.md` 中的静态运行时上下文前缀
-- 🔧 复查 Claude / Gemini 标准模式与全局模式静态规则文件，确认本来就不存在同类已废弃运行时规则块
-- 🔧 同步修正文档中关于 Codex `model_instructions_file -> ~/.codex/AGENTS.md` 和无 hooks 运行方式的表述
-- 🧪 新增回归断言，确保 Codex 标准/全局规则文件中不再出现被移除的运行时上下文前缀
-
-### v3.0.1
-
-**修复与验证：**
-- 🔧 明确并加强 `STATE.md` 恢复规则：关键决策变更即更新，长流程一旦失真立即重写，宿主明确进入压缩/恢复前置阶段前必须先确认已同步
-- 🔧 修复 Codex 本地插件清理后的空 `~/.agents/plugins/marketplace.json` 残留
-- 🔧 修复并验证单 CLI `update` 在记录模式过期时仍会优先复用本地已检测模式，符合 `helloagents update <cli>` 的预期行为
-- 🔧 明确标准模式下“链接文件立即同步、注入后的规则文件需显式刷新”的分支 / bootstrap 刷新语义
-- 🧪 新增标准模式规则文件刷新、模式自动复用、Codex 空 marketplace 清理，以及与版本号无关的 npm pack 生命周期测试
-
-### v3.0.0 🎉
-
-**破坏性变更：**
-- 🔴 完全重写：Python 包 → 纯 Node.js/Markdown 架构。`pip`/`uv` 安装方式不再可用
-- 🔴 命令重命名/移除：`~design` → `~plan`、`~review` → `~verify`、`~do` → `~build`，移除 `~exec`/`~rollback`/`~rlm`/`~status`/`~validatekb`/`~upgradekb`/`~cleanplan`
-- 🔴 配置键从大写改为小写。移除：`BILINGUAL_COMMIT`、`EVAL_MODE`、`UPDATE_CHECK`、`CSV_BATCH_MAX`
-
-**新功能：**
-- ✨ 14 个自动激活质量技能：hello-ui、hello-api、hello-security、hello-test、hello-verify、hello-errors、hello-perf、hello-data、hello-arch、hello-debug、hello-subagent、hello-review、hello-write、hello-reflect
-- ✨ 3 个支持的 CLI：Claude Code（插件/marketplace）、Gemini CLI（扩展）、Codex CLI（npm）
-- ✨ 检查清单把关：所有已激活技能必须通过交付检查清单才能完成任务
-- ✨ `~prd` 命令：13 维度头脑风暴式 PRD 框架
-- ✨ `~loop` 命令：自主迭代优化，带指标追踪和 git 回滚
-- ✨ `~verify` 命令：自动检测并运行所有验证命令
-- ✨ Guard 系统（`guard.mjs`）：L1 拦截破坏性命令 + L2 安全模式建议
-- ✨ 标准/全局模式：`install_mode` 配置项支持按项目或全局激活
-- ✨ 流状态管理（`STATE.md`）：用于压缩/恢复时继续工作的恢复快照（≤70 行）
-- ✨ 设计系统生成（`DESIGN.md`）：作为项目级 UI 契约自动创建
-- ✨ 计划包系统：`requirements.md` + `plan.md` + `tasks.md` + `contract.json`
-- ✨ 可选 advisor 契约与证据：仅在 T3 / UI / 高风险流程启用，通过 `contract.json` + `.helloagents/.ralph-advisor.json` 记录
-- ✨ 可选视觉验收证据：仅在 UI 契约明确要求时启用，通过 `contract.json` + `.helloagents/.ralph-visual.json` 记录
-
-**架构：**
-- 📦 先选路再执行的六阶段主流程：ROUTE/TIER → SPEC → PLAN → BUILD → VERIFY → CONSOLIDATE
-- 📦 简化配置：8 个小写键，合理默认值
-- 📦 双模式安装：标准模式（非插件，显式部署）/ 全局模式（插件/扩展）
-- 📦 模块化脚本架构：`cli-utils.mjs`（共享工具）、`notify-ui.mjs`（跨平台声音/桌面通知）、`guard.mjs`（安全防护）、`ralph-loop.mjs`（质量验证）
-- 📦 Hook 脚本跨平台兼容：事件名动态适配（Claude Code / Gemini CLI / Codex CLI），通过环境变量或 CLI 参数推断
-- 📦 Standby 模式路由隔离：新项目检测仅在 global 模式或已激活项目中触发，不干扰未激活项目
-- 📦 通知系统跨平台支持（Windows toast、macOS osascript、Linux notify-send）
-
-### v2.3.8
-
-**架构变更：**
-- 路由层级整合：移除 R2 简化流和 R3 标准流，统一为 R0/R1/R2 三层路由
-- 评估改为维度充分性驱动，替代固定总分阈值
-- 末轮提问+确认合并，减少独立确认步骤
-- 移除 L0 用户记忆系统和自定义命令扩展
-- 配置系统整合：单一 `~/.helloagents/helloagents.json`
-- 新增代码体积控制规则：预警 300/40 行，强制拆分 400/60 行
-
-**新功能：**
-- ✨ 5 个新工作流命令：`~test`、`~rollback`、`~validatekb`、`~upgradekb`、`~cleanplan`
-- ✨ `notify_level` 配置项控制通知行为
-- ✨ 独立配置读取模块供 hook 脚本使用
-
-**安全：**
-- 修复 `shared_tasks.py` 路径注入漏洞
-- 修复 `validate_package.py` 路径遍历防护不完整
-
-### v2.3.7
-
-**Bug 修复：**
-- 修复非编码任务在 `KB_CREATE_MODE=2` 时错误创建知识库
-- 修复 R2 标准流在方案选择后重定向到归档而非 DEVELOP
-- 修复非编码任务错误创建计划包
-
-**改进：**
-- 📦 优化上下文压缩后的实施计划状态恢复
-- 📦 优化整体设计流程
-
-### v2.3.6
-
-**新功能：**
-- ✨ 子代理编排大改：新增 brainstormer 子代理用于并行方案构思
-- ✨ 子代理阻塞机制：失败/超时时自动阻塞并回退
-
-**改进：**
-- 📦 工具/Shell 约束优化：内置工具失败时允许回退到 Shell
-- 📦 Shell 编码约束细化：明确 UTF-8 无 BOM 要求
-- 📦 移除 3 个冗余子代理，功能回归主代理和 RLM 角色
-
-### v2.3.5
-
-**新功能：**
-- ✨ 声音通知系统，5 种事件音效，跨 Windows/macOS/Linux
-- ✨ Claude Code hooks 从 9 个扩展到 11 个生命周期事件类型
-- ✨ Hooks 支持扩展到 Gemini CLI 和 Grok CLI
-- ✨ 会话启动时配置完整性检查
-- ✨ 上下文压缩前注入恢复游标
-- ✨ 用户自定义工具注册和编排
-
-**改进：**
-- 📦 全面审计修复（21 个问题：6 HIGH + 9 MEDIUM + 6 LOW）
-- 📦 核心架构：新增 dispatcher 模块、Codex 角色、Claude 规则管理
-- 📦 安装/更新脚本重构，持久化配置
-
-## 📜 许可证
-
-本项目采用双许可证：代码遵循 [Apache-2.0](./LICENSE.md)，文档遵循 CC BY 4.0。
-
-详见 [LICENSE.md](./LICENSE.md)。
-
-## 🤝 参与贡献
-
-- 🐛 **Bug 报告**：[创建 issue](https://github.com/hellowind777/helloagents/issues)
-- 💡 **功能建议**：[发起讨论](https://github.com/hellowind777/helloagents/issues)
-- 📖 **文档改进**：欢迎 PR
-
-## 支持的 CLI
-
-| CLI | 标准模式安装（默认） | 全局模式安装（插件） | 卸载 |
-|-----|-------------------|-------------------|------|
-| Claude Code | `helloagents install claude --standby` | `/plugin marketplace add hellowind777/helloagents` | `npm uninstall -g helloagents`（全局模式另需 `/plugin remove helloagents`） |
-| Gemini CLI | `helloagents install gemini --standby` | `gemini extensions install https://github.com/hellowind777/helloagents` | `npm uninstall -g helloagents`（全局模式另需 `gemini extensions uninstall helloagents`） |
-| Codex CLI | `helloagents install codex --standby` | `helloagents install codex --global` | `npm uninstall -g helloagents` |
+- Bug 反馈：[提交 issue](https://github.com/hellowind777/helloagents/issues)
+- 功能建议：[提交 issue](https://github.com/hellowind777/helloagents/issues)
+- 欢迎提交 PR
 
 ---
 
@@ -889,8 +638,6 @@ npm test
 
 如果这个项目对你有帮助，点个 star 就是最好的支持。
 
-感谢 <a href="https://codexzh.com/?ref=EEABC8">codexzh.com</a> / <a href="https://ccodezh.com">ccodezh.com</a> 对本项目的支持
-
-[⬆ 返回顶部](#helloagents)
+感谢 <a href="https://codexzh.com/?ref=EEABC8">codexzh.com</a> / <a href="https://ccodezh.com">ccodezh.com</a> 对本项目的支持。
 
 </div>