企业官网建设流程全解析

HelloAGENTS 是叠加在 Claude Code、Gemini CLI 和 Codex CLI 之上的 AI 编码 CLI 工作流层，提供技能调度、质量门禁与安全守卫。它的standby（标准）与global（全局）两种部署模式，直接决定了这套工作流在你的项目里如何生效。本文用最直观的方式对比两种模式的差异，帮你快速选定最适合的部署方式。

30 秒看懂：standby 和 global 的核心区别

一句话记忆：standby 是"按项目开"，global 是"全局常开"。

standby 模式：轻量显式，按需激活

standby 是默认安装模式（配置项install_mode默认值即为"standby"）。它只把规则部署到指定 CLI，项目是否进入完整工作流，由你在项目里执行~init决定。

部署步骤

# 只部署到 Codex helloagents install codex --standby # 一次部署到全部受管 CLI helloagents install --all --standby

各 CLI 实际写入的文件（摘自 README_CN.md 的"标准模式文件"章节）：

standby 模式下项目怎么"激活"完整工作流？

在某个项目目录里对 AI 说~init，项目级规则文件会写入<!-- HELLOAGENTS_PROFILE: full -->标记，同时创建.helloagents/项目知识库。此后该项目才自动激活编码技能（如hello-ui、hello-test等 14 个内置技能）。未初始化的项目只保留轻量规则和显式~command入口，简单任务不会被额外流程拖慢。

运行时，HelloAGENTS 通过 scripts/notify-route.mjs 中的resolveBootstrapFile判断该加载哪份常驻规则：standby 且未初始化项目加载轻量的 bootstrap-lite.md，已初始化或全局模式加载完整版 bootstrap.md。

global 模式：宿主层全局启用完整规则

部署步骤

helloagents --global helloagents install --all --global

global 模式会在宿主层更广泛地启用完整规则，三个 CLI 的安装机制各不相同：

所有链路都回链到同一个稳定运行根目录~/.helloagents/helloagents，因此安装、更新、切分支、清理始终围绕同一份运行时副本刷新，不会出现配置漂移。

什么场景优先选 global？

• 你主力使用Codex app / 插件发现链路，希望插件被宿主原生识别；
• 你希望新打开的项目无需~init就能自动获得完整工作流（自动激活编码技能、QA 闭环、Guard 守卫等）；
• 你维护多个项目，不想逐个初始化。

如何选择：一份决策清单

选 standby，如果：

1. 你只在一两个主力项目使用完整工作流，其他项目只想保留轻量能力
2. 你看重"显式控制"——什么时候进入完整流程，由~init说了算
3. 你希望宿主配置尽可能少、易于排查和手动维护

选 global，如果：

1. 你看重 Codex app / 插件发现链路
2. 希望所有项目默认享受完整的技能、质量门禁和知识库能力
3. 团队多项目并行，不想反复初始化

两种模式可以随时切换，见下一节。

模式切换与安全机制：切错也不怕

这是很多新手担心的问题：模式之间切换会不会把宿主配置搞乱？HelloAGENTS 用了几层防护：

1）单 CLI 模式记录

配置文件中host_install_modes记录每个 CLI 当前的模式（如{ "codex": "standby" }），它只在宿主安装成功后写入，且优先级高于全局默认install_mode。省略--standby或--global执行命令时，HelloAGENTS 会先复用该 CLI 已记录或检测到的模式，再回退到standby，避免"无意识切换"。

2）global 切回 standby 的清理顺序

把 Claude 或 Gemini 从 global 切回 standby 时，HelloAGENTS 会先移除原生插件或扩展。如果这一步失败，会继续保持global记录，而不是静默叠加两套规则——宁可保留旧模式，也不让两种模式混在一起。

3）用 doctor 自检

helloagents doctor helloagents doctor codex --json

doctor会检查规则文件、链接、hooks、插件根目录、缓存副本和版本漂移，还能识别 Codex 的--previous-notify包装链，适合在切换模式后做一次全面体检。

常见问题速答

Q：~init和--global是同一个东西吗？不是。~init在项目仓库内初始化工作流并同步项目知识；helloagents --global在宿主层做全局部署。standby 模式下两者配合使用：宿主装好 + 项目初始化，完整工作流才生效。

Q：装完后~help不识别？先跑helloagents doctor确认安装，然后重启对应 AI CLI 或新开会话——已运行会话不会自动重载注入规则。详见 README_CN.md 的"故障排除"章节。

Q：卸载会删掉项目知识库吗？不会。.helloagents/项目文件和~/.helloagents/helloagents.json配置都会保留。

小结

• standby：轻量、显式、按项目~init激活，适合想要精细控制的用户（默认模式）
• global：宿主层原生插件/扩展部署，完整规则全局常开，适合 Codex app 用户和多项目场景
• 切换模式有完整的清理与自检链路，切错也不怕，doctor随时兜底

更多细节可参阅仓库中的 README_CN.md、cli.mjs 入口实现，以及 skills/ 下的 14 个技能定义目录。