helloagents 3.0.29 → 3.0.31

package/bootstrap.md

@@ -6,7 +6,7 @@
 配置文件: ~/.helloagents/helloagents.json
 `output_language` 非空时，所有用户可见文本使用该语言；为空则跟随用户当前语言。
 会话级缓存优先：当前上下文已有"当前用户设置"、原始 JSON 或读取摘要，且覆盖所需配置项时，直接复用。
-仅在缺少所需项、用户要求刷新，或本轮修改后需要核验时读取；对 Codex 来说，首次对话前若当前上下文仍缺少所需配置项，必须先读取一次 `~/.helloagents/helloagents.json`，压缩/恢复后的首次对话同样先重读一次；输出格式只在缺少 `output_format` 已知值时触发读取。
+仅在缺少所需项、用户要求刷新，或本次修改后需要核验时读取；对 Codex 来说，首次对话前若当前上下文仍缺少所需配置项，必须先读取一次 `~/.helloagents/helloagents.json`，压缩/恢复后的首次对话同样先重读一次；输出格式只在缺少 `output_format` 已知值时触发读取。
 同一会话内，同一路径的配置文件、模块、SKILL、模板只读一次并跨轮复用；读取失败必须明示，并按默认值或已知设置执行。
 
 ## 通用交付规则（强制）
@@ -107,8 +107,8 @@
 ## 交互、停顿与收尾
 ### 输出格式
 适用条件：
-- 当 `helloagents.json` 的 `output_format` 为 `true` 时，主代理必须在本轮最后一条、且确认**不再继续调用工具、不再继续执行**的**收尾消息**中使用输出格式。
-- 若某个 skill 在本轮明确要求输出停顿、确认或总结，也仅当该消息同时是**本轮最终收尾消息**时，才可使用输出格式。
+- 当 `helloagents.json` 的 `output_format` 为 `true` 时，主代理必须在每轮对话最后一条、且确认**不再继续调用工具、不再继续执行**的**最终回复**中使用输出格式。
+- 若某个 skill 在当前对话明确要求输出停顿、确认或总结，也仅当该消息同时是**当前对话的最终回复**时，才可使用输出格式。
 
 排除条件：
 - 当 `output_format` 为 `false` 时，所有回复保持自然输出，不得使用输出格式。
@@ -126,16 +126,16 @@
 图标：💡直接响应（一次性答复 / 只读分析） | ⚡快速执行（低风险直接执行） | 🔵规划流程（方案 / 规划产出） | ✅完成（已完成且无待确认动作） | ❓等待输入（等待用户输入 / 授权） | ⚠️警告（存在重要风险或限制） | ❌错误（发生错误或已阻塞）
 
 使用约束：
-- 首行必须保留 `【HelloAGENTS】` 和连字符 `-`，不得省略；状态图标与收尾内容必须一致。正文仍在等待用户输入、确认、授权或补充信息（含确认是否执行已给出的方案或修改）时，只能使用 `❓等待输入`；仅在本轮执行已完成且不存在待确认动作时，才能使用 `✅完成`。同一条最终收尾消息只使用一次该格式；若主体需要分段，在同一个外层块内分节，不得在正文中再次输出 `【HelloAGENTS】` 或第二个 `🔄 下一步`。
+- 首行必须保留 `【HelloAGENTS】` 和连字符 `-`，不得省略；状态图标与收尾内容必须一致。正文仍在等待用户输入、确认、授权或补充信息（含确认是否执行已给出的方案或修改）时，只能使用 `❓等待输入`；仅在当前对话执行已完成且不存在待确认动作时，才能使用 `✅完成`。同一条最终回复只使用一次该格式；若主体需要分段，在同一个外层块内分节，不得在正文中再次输出 `【HelloAGENTS】` 或第二个 `🔄 下一步`。
 - `🔄 下一步` 必须写真正的下一步动作，不写单纯当前状态或条件式能力表述。若正在等待确认，写清待确认动作；若仍有已授权且可继续执行的动作，不得收尾，必须继续执行；若当前任务已完整结束且确无合理后续，可明确写出任务已结束、无后续动作，不补条件式邀约。
 
 ### 收尾状态信号
-- `turn-state` 只在运行时必须识别本轮“完成 / 等待输入 / 阻塞”时写入；普通问候、普通问答、T0 只读分析和一次性解释不调用
-- 必须调用场景：显式 `~auto` / `~loop`；非只读任务完成验证并进入收尾；需要让运行时识别本轮已完成、等待输入或已阻塞时；已进入项目连续流程或方案包闭环
+- `turn-state` 只在运行时必须识别当前对话“完成 / 等待输入 / 阻塞”时写入；普通问候、普通问答、T0 只读分析和一次性解释不调用
+- 必须调用场景：显式 `~auto` / `~loop`；非只读任务完成验证并进入收尾；需要让运行时识别当前对话已完成、等待输入或已阻塞时；已进入项目连续流程或方案包闭环
 - 首选参数式调用，保证一次完成：`helloagents-turn-state write --kind complete --role main`；也可用 stdin JSON。不要查找、读取或拼接 `turn-state.mjs` 源码路径
-- 本轮已完成且不再等待用户输入 → `helloagents-turn-state write --kind complete --role main`
+- 当前对话已完成且不再等待用户输入 → `helloagents-turn-state write --kind complete --role main`
 - 因阻塞判定等待用户输入、确认、授权或补充信息（含未授权的外部副作用确认） → 写 `kind=waiting`、`role=main`，并同时写 `reasonCategory` 与 `reason`
-- 因错误、缺少前置条件或外部依赖而本轮停下 → 写 `kind=blocked`、`role=main`，并同时写 `reasonCategory` 与 `reason`
+- 因错误、缺少前置条件或外部依赖而当前对话停下 → 写 `kind=blocked`、`role=main`，并同时写 `reasonCategory` 与 `reason`
 - `reasonCategory` 只允许：`ambiguity`、`missing-input`、`missing-file`、`missing-credential`、`unauthorized-side-effect`、`high-risk-confirmation`、`external-dependency`、`error`
 - 显式 `~auto` / `~loop` 下，`waiting` / `blocked` 还必须写入 `blocker.target`、`blocker.evidence`、`blocker.requiredAction`；阶段汇报、单轮探测完成、路线调整或“下一步建议”不构成停下理由
 - 子代理不得写 turn-state；子代理结束只直接返回结果，不为主代理代写完成态
@@ -173,7 +173,7 @@
 以下情况才构成中途停下并请求用户输入的正当理由：
 - 需求存在影响执行结果的真实歧义
 - 缺少继续执行所必需的信息、文件、路径或凭据
-- 将产生外部副作用，但本轮尚未获得对应授权（含等待确认是否实施已给方案）
+- 将产生外部副作用，但当前任务尚未获得对应授权（含等待确认是否实施已给方案）
 - 操作属于高风险或不可逆，按安全规则必须确认
 除上述情况外，默认继续执行。
 
@@ -209,7 +209,7 @@
 - 审查 / 执行验证 → `~verify`
 - 不确定或希望端到端自动推进时使用 `~auto`
 
-当前项目只要已建立 `.helloagents/`（例如执行过 `~wiki`、`~init`，或已进入项目级连续流程），就按项目级完整流程执行。
+当前项目只要已初始化（例如执行过 `~global`，或当前项目级规则文件已包含 `<!-- HELLOAGENTS_PROFILE: full -->`），就按项目级完整流程执行。
 
 #### 2. SPEC — 澄清目标与验收
 根据任务需要，按需读取项目上下文（知识库文件和项目文件），明确：
@@ -221,13 +221,13 @@
 
 #### 3. PLAN — 规划与上下文准备
 根据 skills/ 目录下各 hello-* 技能的 SKILL.md frontmatter（name + description），标记本次任务可能需要的技能（不读取文件内容，仅记录名称）。
-路径定义：`{HELLOAGENTS_READ_ROOT}` = 本轮已确定的 HelloAGENTS 读取根目录，统一用于读取 `skills/` 与 `templates/`
+路径定义：`{HELLOAGENTS_READ_ROOT}` = 当前对话已确定的 HelloAGENTS 读取根目录，统一用于读取 `skills/` 与 `templates/`
 先确定当前技能根目录：
-- 优先使用当前上下文中已注入的“本轮 HelloAGENTS 读取根目录”
+- 优先使用当前上下文中已注入的“当前对话 HelloAGENTS 读取根目录”
 - 若当前上下文未注入，则使用稳定运行根目录 `~/.helloagents/helloagents`
 - 宿主固定链接（Codex `~/.codex/helloagents`、Claude `~/.claude/helloagents`、Gemini `~/.gemini/helloagents`）只作为兼容别名，不作为优先探测路径
 - 仍无法确定时，明确说明缺少 HelloAGENTS 读取根目录；不要递归扫描 `$HOME`、`Downloads`、项目目录或旧版本目录
-- 已激活项目或全局模式下，技能是否需要使用由当前已加载 AGENTS 规则决定；不要因此额外探测项目目录里的 HelloAGENTS skills 路径
+- 全局模式或已初始化项目时，技能是否需要使用由当前已加载 AGENTS 规则决定；不要因此额外探测项目目录里的 HelloAGENTS skills 路径
 路径确定一次即可，不预读、不扫描整个目录，也不重复探测同一路径。
 hello-* 技能读取路径：`{HELLOAGENTS_READ_ROOT}/skills/{技能名}/SKILL.md`
 包内脚本优先使用稳定命令入口；涉及 turn-state 时按“收尾状态信号”执行。
@@ -265,12 +265,14 @@ hello-* 技能读取路径：`{HELLOAGENTS_READ_ROOT}/skills/{技能名}/SKILL.m
 - 有方案包且准备报告完成 → 优先调用 `scripts/closeout-state.mjs write` 写当前会话 `artifacts/closeout.json`，记录“需求覆盖”和“交付清单”；每项写明 `PASS` / `BLOCKED` 与简要摘要，再进入最终交付
 - 状态文件维护：按上文“流程状态”中的适用范围执行。属于“强制创建并持续更新”范围时，重写 `state_path` 指向的文件（“正在做什么”更新为已完成，清空关键上下文 / 下一步 / 阻塞项）；属于“已有则更新”范围时，仅在文件已存在时重写；属于“不创建”范围时不生成此文件
 - 有方案包且任务已完成 → 将整个 `plans/{feature}/` 目录归档到 `.helloagents/archive/YYYY-MM/`，并更新 `archive/_index.md`。清理当前会话临时文件（`artifacts/loop-results.tsv`、`capsule.json`、`events.jsonl`、`artifacts/loop-breaker.json`、`artifacts/verify.json`、`artifacts/review.json`、`artifacts/closeout.json`）
-- 按 `kb_create_mode` 同步知识库（0=关闭 / 1=已激活项目或全局模式中编码自动 / 2=已激活项目或全局模式中始终）：
-  - `.helloagents/` 不存在则按 templates/ 创建知识库文件（`context.md`、`guidelines.md`、`verify.yaml`、`CHANGELOG.md`、`modules/`）
+- 按 `kb_create_mode` 同步知识库（0=关闭 / 1=知识库已存在时自动同步，未创建则不自动补建 / 2=编码任务在知识库已存在或全局模式下自动创建或同步）：
+  - `0` → 跳过
+  - `1` → 仅在知识库已存在时按模板增量同步；未创建则不自动补建
+  - `2` → 仅在编码任务中生效；知识库已存在时按模板增量同步；若知识库不存在但当前项目已处于全局模式，则按 templates/ 创建或补全 `context.md`、`guidelines.md`、`verify.yaml`、`CHANGELOG.md`、`modules/`
   - 已存在但不完整（缺少上述核心文件）→ 按 templates/ 补全缺失文件，不覆盖已有文件
   - 已存在且完整则按模板格式更新 `CHANGELOG.md`、相关 `modules/*.md`、增量经验 delta 追加
 - 符合条件时触发 `hello-reflect`（详见 `hello-reflect` SKILL.md）
-- 本地版本检查点：非只读任务完成验证且产生工作区变更时，若 `auto_commit_enabled=true`，最终收尾前自动执行本地提交；若 `auto_commit_enabled=false`，跳过这一步。先检查 `git status --short`；若不是 git 仓库或无变更则跳过。若发现 `.env`、密钥、凭据、明显不应提交的大文件或二进制产物，停止提交并说明风险；否则执行 `git add -A`，使用当前回复语言生成简洁 conventional commit message 后执行 `git commit`。显式 `~commit` 不受这个开关影响。不自动远程 `git push`，除非用户明确要求
+- 本地版本检查点：非只读任务完成验证且产生工作区变更时，若 `auto_commit_enabled=true`，最终回复前自动执行本地提交；若 `auto_commit_enabled=false`，跳过这一步。先检查 `git status --short`；若不是 git 仓库或无变更则跳过。若发现 `.env`、密钥、凭据、明显不应提交的大文件或二进制产物，停止提交并说明风险；否则执行 `git add -A`，使用当前回复语言生成简洁 conventional commit message 后执行 `git commit`。显式 `~commit` 不受这个开关影响。不自动远程 `git push`，除非用户明确要求
 
 ### 完成判定
 - 未进入 VERIFY / CONSOLIDATE 的路径，声称完成前必须完成与任务类型匹配的必要检查；无法执行的检查必须明确说明，不得直接宣称完成
@@ -287,19 +289,19 @@ hello-* 技能读取路径：`{HELLOAGENTS_READ_ROOT}/skills/{技能名}/SKILL.m
 ### .helloagents/ 目录
 路径: {CWD}/.helloagents/
 所有文件的创建和更新必须按 templates/ 目录中对应模板的格式执行，不可自由发挥格式。
-- `.helloagents/` 表示项目级存储路径，也是标准模式的项目激活信号
+- `.helloagents/` 表示项目本地存储路径，负责知识、方案、状态与运行态；它不再作为项目是否已初始化的判定信号
 - `state_path` 指向的状态文件、当前会话 `capsule.json`、`events.jsonl`、`artifacts/*.json`、`artifacts/loop-results.tsv` 等运行态文件始终保留在项目本地 `.helloagents/sessions/{workspace}/{session}/`
 - `state_path` 是状态文件的唯一位置。宿主提供会话标识时，写入 `.helloagents/sessions/{workspace}/{session}/STATE.md`；没有稳定会话标识时，写入 `.helloagents/sessions/{workspace}/default/STATE.md`
 - `{workspace}` 为当前 Git 分支、`detached-{sha}` 或非 Git 项目的 `workspace`；`.helloagents/sessions/active.json` 只记录当前活跃会话索引，避免同一会话被拆成多个目录
 - 若 helloagents.json 中 `project_store_mode = "repo-shared"`，`context.md`、`guidelines.md`、`CHANGELOG.md`、`verify.yaml`、`DESIGN.md`、`modules/`、`plans/`、`archive/` 改按当前上下文中已注入的“当前项目存储”/“项目知识/方案目录”解析；未注入具体路径时，按当前存储模式自行解析，不要假定这些文件一定实际位于当前工作树中
-templates/ 查找路径（按优先级；首次确定模板根目录后，本轮复用）：
+templates/ 查找路径（按优先级；首次确定模板根目录后，本会话复用）：
 按上文相同的技能根目录规则确定；确定根目录后读取其中的 `templates/`。
 
 ### 流程状态（不受 `kb_create_mode` 控制，始终可写）
 - 状态文件（`state_path`）— ≤70 行，用来记录“上次做到哪里”。判断当前任务时，当前用户消息、显式命令、活跃方案包 / PRD、代码与验证证据优先于状态文件
   内容：主线目标、正在做什么、关键上下文（决策/变更/假设）、下一步（具体可执行动作含文件路径）、阻塞项
   适用边界：
-  - 强制创建并持续更新：`~wiki`、`~init`、`~plan`、`~build`、`~auto`、`~prd`、`~loop`，以及进入工作流阶段或已激活项目的连续任务
+  - 强制创建并持续更新：`~wiki`、`~init`、`~global`、`~plan`、`~build`、`~auto`、`~prd`、`~loop`，以及进入工作流阶段、已初始化项目的连续任务，或任何会创建/修改本地文件、会在当前工作区留下实际输出或操作记录的非只读任务
   - 强制更新，不要求首次创建：`~clean`，主代理汇总子代理结果后
   - 已有则更新：`~verify`、`~review`（兼容别名）、`~test`、`~commit`
   - 不创建：`~help`、`~idea`、普通问答、一次性只读任务、子代理自身执行过程、压缩/恢复钩子
@@ -320,7 +322,7 @@ templates/ 查找路径（按优先级；首次确定模板根目录后，本轮
 - archive/_index.md — 归档索引
 
 ### 知识记录（受 `kb_create_mode` 控制）
-- 0=关闭；1=已激活项目或全局模式中的编码任务自动同步；2=已激活项目或全局模式中始终同步
+- 0=关闭；1=知识库已存在时自动同步；2=编码任务在知识库已存在或全局模式下自动创建或同步
 - context.md — 项目架构、技术栈、目录结构、模块索引
 - guidelines.md — 编码约定（仅含非显而易见的约定）
 - CHANGELOG.md — 变更历史
@@ -335,7 +337,7 @@ templates/ 查找路径（按优先级；首次确定模板根目录后，本轮
 - artifacts/closeout.json — 当前会话最近一次成功收尾的交付证据快照
 
 ### 主线判断依据
-1. 当前用户最新消息、显式 `~command`、本轮已确认的范围与结论
+1. 当前用户最新消息、显式 `~command`、当前对话已确认的范围与结论
 2. 当前活跃方案包 / PRD、代码与验证证据
 3. 当前状态文件（`state_path`，只用于补齐最近进度）
 4. 其他知识记录与历史归档

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.29",
+  "version": "3.0.31",
   "description": "Quality-driven orchestration kernel for AI CLIs",
   "contextFileName": "bootstrap.md",
   "author": "HelloWind",

package/install.ps1

@@ -6,7 +6,7 @@
 #   HELLOAGENTS_TARGET=all|claude|gemini|codex
 #   HELLOAGENTS_MODE=standby|global
 #   HELLOAGENTS_BRANCH=main|beta|...
-#   HELLOAGENTS_PACKAGE=helloagents|github:owner/repo#ref|...
+#   HELLOAGENTS_PACKAGE=helloagents|https://github.com/owner/repo/archive/refs/heads/ref.tar.gz|...
 
 $ErrorActionPreference = "Stop"
 
@@ -39,7 +39,7 @@ if ($Mode -and @("standby", "global") -notcontains $Mode) {
 
 if (-not $Package) {
     if ($Branch) {
-        $Package = "github:hellowind777/helloagents#$Branch"
+        $Package = "https://github.com/hellowind777/helloagents/archive/refs/heads/$Branch.tar.gz"
     } else {
         $Package = "helloagents"
     }

package/install.sh

@@ -9,7 +9,7 @@ set -eu
 #   HELLOAGENTS_TARGET=all|claude|gemini|codex
 #   HELLOAGENTS_MODE=standby|global
 #   HELLOAGENTS_BRANCH=main|beta|...
-#   HELLOAGENTS_PACKAGE=helloagents|github:owner/repo#ref|...
+#   HELLOAGENTS_PACKAGE=helloagents|https://github.com/owner/repo/archive/refs/heads/ref.tar.gz|...
 
 ACTION="${HELLOAGENTS_ACTION:-install}"
 TARGET="${HELLOAGENTS_TARGET:-}"
@@ -49,7 +49,7 @@ fi
 
 if [ -z "$PACKAGE" ]; then
   if [ -n "$BRANCH" ]; then
-    PACKAGE="github:hellowind777/helloagents#$BRANCH"
+    PACKAGE="https://github.com/hellowind777/helloagents/archive/refs/heads/$BRANCH.tar.gz"
   else
     PACKAGE="helloagents"
   fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.29",
+  "version": "3.0.31",
   "type": "module",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, quality verification (Ralph Loop), safety guards, and notifications.",
   "author": "HelloWind",

package/scripts/cli-branch.mjs

@@ -2,7 +2,7 @@ import { spawnSync } from 'node:child_process'
 
 import { normalizeHost } from './cli-lifecycle.mjs'
 
-const DEFAULT_REPO_SPEC = 'github:hellowind777/helloagents'
+const DEFAULT_REPO_ARCHIVE_BASE = 'https://github.com/hellowind777/helloagents/archive/refs/heads'
 
 function runCommand(command, args) {
   const needsShell = process.platform === 'win32' && /\.cmd$/i.test(command)
@@ -19,6 +19,10 @@ function runCommand(command, args) {
   }
 }
 
+function getDefaultNpmCommand() {
+  return process.platform === 'win32' ? 'npm.cmd' : 'npm'
+}
+
 function parseModeFlag(args) {
   const hasGlobal = args.includes('--global')
   const hasStandby = args.includes('--standby')
@@ -56,7 +60,7 @@ function parseBranchArgs(args) {
 
 function buildPackageSpec(ref) {
   if (/^(github:|git\+|https?:|file:)/i.test(ref)) return ref
-  return `${DEFAULT_REPO_SPEC}#${ref}`
+  return `${DEFAULT_REPO_ARCHIVE_BASE}/${ref}.tar.gz`
 }
 
 function buildSyncArgs({ host, mode }) {
@@ -76,7 +80,7 @@ function buildSyncArgs({ host, mode }) {
 
 export function runBranchSwitch(args, options = {}) {
   const parsed = parseBranchArgs(args)
-  const npmCommand = options.npmCommand || process.env.HELLOAGENTS_NPM_CMD || 'npm'
+  const npmCommand = options.npmCommand || process.env.HELLOAGENTS_NPM_CMD || getDefaultNpmCommand()
 
   const packageSpec = buildPackageSpec(parsed.branch)
   runCommand(npmCommand, ['install', '-g', packageSpec])

package/scripts/cli-codex.mjs

@@ -121,17 +121,17 @@ function removeCodexMarketplaceEntry(marketplaceFile) {
   return true;
 }
 
-function injectCodexRuntimeCarrier(filePath, bootstrapPath, settings) {
+function injectCodexRuntimeCarrier(filePath, bootstrapPath, settings, options = {}) {
   const bootstrapContent = safeRead(bootstrapPath);
   if (!bootstrapContent) return false;
-  injectMarkedContent(filePath, buildRuntimeCarrier(bootstrapContent, settings).trimEnd());
+  injectMarkedContent(filePath, buildRuntimeCarrier(bootstrapContent, settings, options).trimEnd());
   return true;
 }
 
-function writeCodexRuntimeCarrier(filePath, bootstrapPath, settings) {
+function writeCodexRuntimeCarrier(filePath, bootstrapPath, settings, options = {}) {
   const bootstrapContent = safeRead(bootstrapPath);
   if (!bootstrapContent) return false;
-  safeWrite(filePath, buildRuntimeCarrier(bootstrapContent, settings));
+  safeWrite(filePath, buildRuntimeCarrier(bootstrapContent, settings, options));
   return true;
 }
 
@@ -298,9 +298,10 @@ export function installCodexGlobal(home, pkgRoot) {
     join(pkgRoot, CODEX_RUNTIME_CARRIER),
     join(pkgRoot, 'bootstrap.md'),
     settings,
+    { profile: 'full' },
   );
   const homeCarrierPath = join(codexDir, CODEX_RUNTIME_CARRIER);
-  injectCodexRuntimeCarrier(homeCarrierPath, join(pkgRoot, 'bootstrap.md'), settings);
+  injectCodexRuntimeCarrier(homeCarrierPath, join(pkgRoot, 'bootstrap.md'), settings, { profile: 'full' });
 
   ensureDir(join(home, '.agents', 'plugins'));
   updateCodexMarketplace(marketplaceFile);

package/scripts/cli-config.mjs

@@ -34,6 +34,14 @@ export function ensureConfig(helloagentsHome, configFile, safeJson, ensureDir) {
   for (const [key, val] of Object.entries(DEFAULTS)) {
     if (!(key in reconciled)) reconciled[key] = val;
   }
+  if (!reconciled.host_install_modes || typeof reconciled.host_install_modes !== 'object' || Array.isArray(reconciled.host_install_modes)) {
+    reconciled.host_install_modes = {};
+  } else {
+    reconciled.host_install_modes = Object.fromEntries(
+      Object.entries(reconciled.host_install_modes)
+        .filter(([host, mode]) => ['claude', 'gemini', 'codex'].includes(host) && typeof mode === 'string' && mode),
+    );
+  }
   if (JSON.stringify(reconciled) !== JSON.stringify(existing)) {
     writeFileSync(configFile, JSON.stringify(reconciled, null, 2), 'utf-8');
   }

package/scripts/cli-doctor-codex.mjs

@@ -64,9 +64,9 @@ function readExpectedHooks(runtime, hooksFile, pathVar) {
   return pickManagedHooks(loadHooksWithCliEntry(runtime.pkgRoot, hooksFile, pathVar)?.hooks || {})
 }
 
-function readExpectedCarrierContent(runtime, fileName, settings) {
+function readExpectedCarrierContent(runtime, fileName, settings, options = {}) {
   const bootstrap = safeRead(join(runtime.pkgRoot, fileName)) || ''
-  return normalizeText(buildRuntimeCarrier(bootstrap, settings))
+  return normalizeText(buildRuntimeCarrier(bootstrap, settings, options))
 }
 
 function buildDoctorIssue(runtime, code, cn, en) {
@@ -168,7 +168,12 @@ function buildCodexChecks(runtime, settings, trackedMode, detectedMode) {
     checks: {
       carrierMarker: (safeRead(join(codexDir, 'AGENTS.md')) || '').includes('HELLOAGENTS_START'),
       carrierContentMatch: normalizeText((safeRead(join(codexDir, 'AGENTS.md')) || '').match(/<!-- HELLOAGENTS_START -->([\s\S]*?)<!-- HELLOAGENTS_END -->/)?.[1] || '')
-        === readExpectedCarrierContent(runtime, expectedHomeCarrier, settings),
+        === readExpectedCarrierContent(
+          runtime,
+          expectedHomeCarrier,
+          settings,
+          expectedHomeCarrier === 'bootstrap.md' ? { profile: 'full' } : {},
+        ),
       homeLink: homeLinkTarget === (safeRealTarget(runtime.pkgRoot) || normalizePath(runtime.pkgRoot)),
       globalHomeLink: homeLinkTarget === runtimeRoot,
       modelInstructionsFile: !!modelInstructionsLine,
@@ -187,8 +192,8 @@ function buildCodexChecks(runtime, settings, trackedMode, detectedMode) {
       pluginCache: existsSync(pluginCacheRoot),
       pluginRootLink: pluginRootTarget === runtimeRoot,
       pluginCacheLink: pluginCacheTarget === runtimeRoot,
-      pluginCarrierMatch: normalizeText(safeRead(join(pluginRoot, 'AGENTS.md')) || '') === readExpectedCarrierContent(runtime, 'bootstrap.md', settings),
-      pluginCacheCarrierMatch: normalizeText(safeRead(join(pluginCacheRoot, 'AGENTS.md')) || '') === readExpectedCarrierContent(runtime, 'bootstrap.md', settings),
+      pluginCarrierMatch: normalizeText(safeRead(join(pluginRoot, 'AGENTS.md')) || '') === readExpectedCarrierContent(runtime, 'bootstrap.md', settings, { profile: 'full' }),
+      pluginCacheCarrierMatch: normalizeText(safeRead(join(pluginCacheRoot, 'AGENTS.md')) || '') === readExpectedCarrierContent(runtime, 'bootstrap.md', settings, { profile: 'full' }),
       marketplaceEntry: Array.isArray(marketplace.plugins) && marketplace.plugins.some((plugin) => plugin?.name === CODEX_PLUGIN_NAME),
       pluginEnabled: codexConfig.includes(CODEX_PLUGIN_CONFIG_HEADER) && codexConfig.includes('enabled = true'),
       globalNotifyPathMatch: codexConfig.includes(CODEX_MANAGED_NOTIFY_VALUE),

package/scripts/cli-doctor-render.mjs

@@ -17,6 +17,22 @@ export function printDoctorText(runtime, report) {
     for (const [key, value] of Object.entries(entry.checks)) {
       console.log(`  ${key}: ${value ? 'ok' : 'missing'}`)
     }
+    if (entry.nativeDoctor) {
+      console.log(`  native_doctor.available: ${entry.nativeDoctor.available ? 'ok' : 'missing'}`)
+      if (entry.nativeDoctor.available) {
+        console.log(`  native_doctor.ok: ${entry.nativeDoctor.ok ? 'ok' : 'missing'}`)
+      }
+      if (entry.nativeDoctor.summary) {
+        if (entry.nativeDoctor.summary.version) console.log(`  native_doctor.version: ${entry.nativeDoctor.summary.version}`)
+        if (entry.nativeDoctor.summary.configPath) console.log(`  native_doctor.config_path: ${entry.nativeDoctor.summary.configPath}`)
+        if (entry.nativeDoctor.summary.resolvedProvider) console.log(`  native_doctor.resolved_provider: ${entry.nativeDoctor.summary.resolvedProvider}`)
+        if (entry.nativeDoctor.summary.resolvedModel) console.log(`  native_doctor.resolved_model: ${entry.nativeDoctor.summary.resolvedModel}`)
+        if (entry.nativeDoctor.summary.sandboxAvailable !== null) console.log(`  native_doctor.sandbox_available: ${entry.nativeDoctor.summary.sandboxAvailable}`)
+        console.log(`  native_doctor.mcp_present: ${entry.nativeDoctor.summary.mcpPresent ? 'ok' : 'missing'}`)
+        console.log(`  native_doctor.skills_selected: ${entry.nativeDoctor.summary.skillsSelected.join(', ') || '(none)'}`)
+      }
+      if (entry.nativeDoctor.output) console.log(`  native_doctor.output: ${entry.nativeDoctor.output}`)
+    }
     for (const note of entry.notes) {
       console.log(`  note: ${note}`)
     }

package/scripts/cli-doctor.mjs

@@ -5,7 +5,6 @@ import { DEFAULTS } from './cli-config.mjs'
 import { inspectCodexDoctor as inspectCodexDoctorImpl } from './cli-doctor-codex.mjs'
 import { printDoctorText } from './cli-doctor-render.mjs'
 import { buildRuntimeCarrier } from './cli-runtime-carrier.mjs'
-import { readTopLevelTomlLine } from './cli-toml.mjs'
 import { loadHooksWithCliEntry, safeJson, safeRead } from './cli-utils.mjs'
 
 const runtime = {
@@ -78,9 +77,9 @@ function managedHooksMatch(actualHooks, expectedHooks) {
   return stringifySorted(pickManagedHooks(actualHooks || {})) === stringifySorted(expectedHooks || {})
 }
 
-function readExpectedCarrierContent(fileName, settings) {
+function readExpectedCarrierContent(fileName, settings, options = {}) {
   const bootstrap = safeRead(join(runtime.pkgRoot, fileName)) || ''
-  return normalizeText(buildRuntimeCarrier(bootstrap, settings))
+  return normalizeText(buildRuntimeCarrier(bootstrap, settings, options))
 }
 
 function buildDoctorIssue(code, cn, en) {

package/scripts/cli-lifecycle-hosts.mjs

@@ -1,6 +1,11 @@
 import { spawnSync } from 'node:child_process'
 
-import { installClaudeStandby, installGeminiStandby, uninstallClaudeStandby, uninstallGeminiStandby } from './cli-hosts.mjs'
+import {
+  installClaudeStandby,
+  installGeminiStandby,
+  uninstallClaudeStandby,
+  uninstallGeminiStandby,
+} from './cli-hosts.mjs'
 import {
   cleanupCodexGlobalResidueForStandby,
   installCodexGlobal,

package/scripts/cli-lifecycle.mjs

@@ -28,14 +28,28 @@ export function initCliLifecycle(options) {
   Object.assign(runtime, options)
 }
 
+function sanitizeSettings(settings = {}) {
+  const next = settings && typeof settings === 'object' ? { ...settings } : {}
+  const tracked = next.host_install_modes
+  if (!tracked || typeof tracked !== 'object' || Array.isArray(tracked)) {
+    next.host_install_modes = {}
+    return next
+  }
+  next.host_install_modes = Object.fromEntries(
+    Object.entries(tracked).filter(([host, mode]) => HOSTS.includes(host) && typeof mode === 'string' && mode),
+  )
+  return next
+}
+
 export function readSettings(shouldEnsure = false) {
   if (shouldEnsure) ensureConfig(runtime.helloagentsHome, runtime.configFile, safeJson, ensureDir)
-  return safeJson(runtime.configFile) || {}
+  return sanitizeSettings(safeJson(runtime.configFile) || {})
 }
 
 function writeSettings(settings) {
+  const sanitized = sanitizeSettings(settings)
   ensureDir(runtime.helloagentsHome)
-  writeFileSync(runtime.configFile, JSON.stringify(settings, null, 2), 'utf-8')
+  writeFileSync(runtime.configFile, JSON.stringify(sanitized, null, 2), 'utf-8')
 }
 
 function hasTrackedHostModes(settings) {

package/scripts/cli-messages.mjs

@@ -65,18 +65,18 @@ function renderInstallMessage(context, mode, state) {
 
   if (install) {
     return msg(
-      `\n  ✅ HelloAGENTS 已安装（standby 模式）！\n\n    Claude Code:  已自动配置（~/.claude/CLAUDE.md + hooks）\n    Gemini CLI:   已自动配置（~/.gemini/GEMINI.md）\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  standby 模式下，hello-* 技能不会自动触发。\n  在项目中使用 ~wiki 仅创建/同步知识库，或用 ~init 完整初始化项目；也可用 ~command 按需调用。\n\n  切换模式：\n    helloagents --global    全局模式（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件）`,
-      `\n  ✅ HelloAGENTS installed (standby mode)!\n\n    Claude Code:  Auto-configured (~/.claude/CLAUDE.md + hooks)\n    Gemini CLI:   Auto-configured (~/.gemini/GEMINI.md)\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  In standby mode, hello-* skills won't auto-trigger.\n  Use ~wiki to create or sync the KB only, or ~init for the full project setup; ~command stays available on demand.\n\n  Switch modes:\n    helloagents --global    Global mode (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)`,
+      `\n  ✅ HelloAGENTS 已安装（standby 模式）！\n\n    Claude Code:  已自动配置（~/.claude/CLAUDE.md + hooks）\n    Gemini CLI:   已自动配置（~/.gemini/GEMINI.md）\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  standby 模式下，hello-* 技能不会自动触发。\n  在项目中使用 ~wiki 或 ~init 仅创建/同步知识库；用 ~global 初始化项目级全局模式；也可用 ~command 按需调用。\n\n  切换模式：\n    helloagents --global    项目级全局模式（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件）`,
+      `\n  ✅ HelloAGENTS installed (standby mode)!\n\n    Claude Code:  Auto-configured (~/.claude/CLAUDE.md + hooks)\n    Gemini CLI:   Auto-configured (~/.gemini/GEMINI.md)\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  In standby mode, hello-* skills won't auto-trigger.\n  Use ~wiki or ~init to create or sync the KB only; use ~global to initialize project-level global mode; ~command stays available on demand.\n\n  Switch modes:\n    helloagents --global    Project-level global mode (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)`,
     )
   }
 
   return msg(
     refresh
       ? `  standby 模式已刷新，CLI 注入与链接已同步最新文件。\n  ${restartHint(msg)}\n  ${removeHint(msg)}`
-      : `  项目可通过 ~wiki 创建/同步知识库，或通过 ~init 完整初始化；未激活项目仅注入通用规则。\n  ${restartHint(msg)}\n  ${removeHint(msg)}`,
+      : `  项目可通过 ~wiki 或 ~init 创建/同步知识库；用 ~global 初始化项目级全局模式；未初始化时仅注入轻量规则。\n  ${restartHint(msg)}\n  ${removeHint(msg)}`,
     refresh
       ? `  Standby mode refreshed; injected files and links were synchronized.\n  ${restartHint(msg)}\n  ${removeHint(msg)}`
-      : `  Projects can use ~wiki for KB-only activation or ~init for the full project setup. Unactivated projects get lite rules only.\n  ${restartHint(msg)}\n  ${removeHint(msg)}`,
+      : `  Projects can use ~wiki or ~init to create/sync the KB; use ~global to initialize project-level global mode. Projects that are not initialized get lite rules only.\n  ${restartHint(msg)}\n  ${removeHint(msg)}`,
   )
 }
 
@@ -84,17 +84,18 @@ function renderHelp({ pkgVersion, msg }) {
   return `
 HelloAGENTS v${pkgVersion} — The orchestration kernel for AI CLIs
 
-${msg('安装', 'Install')}:
+  ${msg('安装', 'Install')}:
   npm install -g helloagents  ${msg('（安装命令并同步稳定运行根目录；CLI 部署需显式执行 helloagents install ...）', '(installs the command and syncs the stable runtime root; deploy to CLIs explicitly with helloagents install ...)')}
   HELLOAGENTS=codex:global npm install -g helloagents
   helloagents-js             ${msg('（受管宿主配置的跨平台稳定入口）', '(cross-platform stable entrypoint for managed host configs)')}
 
 ${msg('模式切换', 'Mode switching')}:
-  helloagents --global     ${msg('全局模式（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件）', 'Global mode (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)')}
+  helloagents --global     ${msg('项目级全局模式（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件）', 'Project-level global mode (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)')}
   helloagents --standby    ${msg('标准模式（非插件安装，hello-* 不自动触发，默认）', "Standby mode (non-plugin install, hello-* won't auto-trigger, default)")}
 
 ${msg('单 CLI 管理', 'Scoped CLI management')}:
   helloagents install codex --standby
+  helloagents install gemini --standby
   helloagents install --all --global
   helloagents update codex
   helloagents cleanup claude --global
@@ -104,7 +105,7 @@ ${msg('单 CLI 管理', 'Scoped CLI management')}:
 ${msg('分支切换', 'Branch switching')}:
   helloagents switch-branch beta
   helloagents switch-branch beta claude --global
-  helloagents branch github:hellowind777/helloagents#beta --all --standby
+  helloagents branch beta --all --standby
   ${msg('先通过 npm 安装指定 ref，再通过 npm 脚本同步宿主 CLI', 'Installs the requested ref with npm first, then syncs host CLIs through npm scripts')}
 
 ${msg('诊断', 'Diagnostics')}:

package/scripts/cli-runtime-carrier.mjs

@@ -1,15 +1,15 @@
 import { join } from 'node:path'
 
-import { safeJson } from './cli-utils.mjs'
+import { safeJson, withCarrierProfile } from './cli-utils.mjs'
 
 export function readCarrierSettings(home) {
   return safeJson(join(home, '.helloagents', 'helloagents.json')) || {}
 }
 
-export function buildRuntimeCarrier(bootstrapContent, settings = {}) {
+export function buildRuntimeCarrier(bootstrapContent, settings = {}, options = {}) {
   void settings
   const normalized = String(bootstrapContent || '').trim()
   if (!normalized) return ''
 
-  return `${normalized}\n`
+  return withCarrierProfile(normalized, options.profile || '')
 }

package/scripts/cli-utils.mjs

@@ -54,8 +54,17 @@ export function removeLink(p) {
 
 const MARKER = '<!-- HELLOAGENTS_START -->';
 const MARKER_END = '<!-- HELLOAGENTS_END -->';
+export const FULL_CARRIER_PROFILE_MARKER = '<!-- HELLOAGENTS_PROFILE: full -->';
 const MARKER_RE = new RegExp(`\\n*${MARKER}[\\s\\S]*?${MARKER_END}\\n*`, 'g');
 
+export function withCarrierProfile(content, profile = '') {
+  const normalized = String(content || '').trim();
+  if (!normalized) return '';
+  if (profile !== 'full') return `${normalized}\n`;
+  if (normalized.includes(FULL_CARRIER_PROFILE_MARKER)) return `${normalized}\n`;
+  return `${FULL_CARRIER_PROFILE_MARKER}\n${normalized}\n`;
+}
+
 /** Inject content wrapped in markers, preserving existing content outside markers. */
 export function injectMarkedContent(filePath, content) {
   const existing = safeRead(filePath) || '';

package/scripts/guard.mjs

@@ -133,7 +133,7 @@ function buildPostWriteWarnings(data) {
   const filePath = data.tool_input?.file_path || ''
   return [
     ...(detectIdeaBoundaryContext(data)?.zeroSideEffect
-      ? ['~idea 本轮要求只读探索；检测到写入文件的工具调用，请回到探索输出，或升级到 ~plan / ~build / ~prd / ~auto 后再修改文件']
+      ? ['~idea 当前任务要求只读探索；检测到写入文件的工具调用，请回到探索输出，或升级到 ~plan / ~build / ~prd / ~auto 后再修改文件']
       : []),
     ...scanUnrequestedFiles(filePath, data.tool_name),
     ...(content ? [...scanForSecrets(content), ...scanDangerousPackages(content, filePath)] : []),

package/scripts/notify-context.mjs

@@ -34,7 +34,7 @@ function buildReadRootBlock(readRoot) {
     turnStateCommand: 'helloagents-turn-state write --kind complete --role main',
     turnStateUsage: '仅在运行时需要识别完成、等待或阻塞时调用；普通问答不调用',
   };
-  return `## 本轮 HelloAGENTS 读取根目录\n\`\`\`json\n${JSON.stringify(block, null, 2)}\n\`\`\``;
+  return `## 当前对话 HelloAGENTS 读取根目录\n\`\`\`json\n${JSON.stringify(block, null, 2)}\n\`\`\``;
 }
 
 export function resolveCanonicalCommandSkill(skillName) {

package/scripts/notify-route.mjs

@@ -1,4 +1,4 @@
-import { isProjectRuntimeActive } from './runtime-scope.mjs'
+import { hasProjectFullCarrier } from './runtime-scope.mjs'
 
 export function resolveRuntimeInstallMode(settings = {}, host = '') {
   if (!settings || typeof settings !== 'object') return 'standby'
@@ -13,8 +13,7 @@ export function resolveBootstrapFile(cwd, settings = {}, host = '') {
   const installMode = typeof settings === 'string'
     ? settings
     : resolveRuntimeInstallMode(settings, host)
-  const isActivated = isProjectRuntimeActive(cwd)
-  return (installMode === 'global' || isActivated) ? 'bootstrap.md' : 'bootstrap-lite.md'
+  return (installMode === 'global' || hasProjectFullCarrier(cwd, host)) ? 'bootstrap.md' : 'bootstrap-lite.md'
 }
 
 function shouldBypassRoute(prompt) {
@@ -23,7 +22,7 @@ function shouldBypassRoute(prompt) {
 
 function buildHelpExtraRules(skillName) {
   if (skillName !== 'help') return ''
-  return ' 这是 HelloAGENTS 的帮助命令，不是宿主 CLI 的内置帮助。仅显示 HelloAGENTS 的帮助和当前设置；优先使用当前会话上下文中已注入的“当前用户设置”、配置文件原始 JSON 或此前读取结果摘要，上下文不存在或缺少要展示的配置项时才读取一次 ~/.helloagents/helloagents.json；自动激活技能说明仅在全局模式或已激活项目中生效。不要调用宿主 CLI 的帮助工具（如 cli_help 或 /help），不要使用子代理，不要读取项目文件；若受工作区限制无法读取配置，必须明确说明并按已知默认值或已注入设置展示。'
+  return ' 这是 HelloAGENTS 的帮助命令，不是宿主 CLI 的内置帮助。仅显示 HelloAGENTS 的帮助和当前设置；优先使用当前会话上下文中已注入的“当前用户设置”、配置文件原始 JSON 或此前读取结果摘要，上下文不存在或缺少要展示的配置项时才读取一次 ~/.helloagents/helloagents.json；自动激活技能说明仅在全局模式或已初始化项目时生效。不要调用宿主 CLI 的帮助工具（如 cli_help 或 /help），不要使用子代理，不要读取项目文件；若受工作区限制无法读取配置，必须明确说明并按已知默认值或已注入设置展示。'
 }
 
 function routeExplicitCommand({

package/scripts/notify.mjs

@@ -391,6 +391,7 @@ function cmdInject() {
   const cwd = payload.cwd || process.cwd();
   const settings = getSettings();
   const bootstrapFile = resolveBootstrapFile(cwd, settings, HOST);
+  const shouldEnsureProjectLocal = bootstrapFile === 'bootstrap.md' || source === 'resume' || source === 'compact';
 
   startReplaySession(cwd, {
     host: HOST,
@@ -398,6 +399,7 @@ function cmdInject() {
     bootstrapFile,
     installMode: settings.install_mode || '',
     payload,
+    ensureProjectLocal: shouldEnsureProjectLocal,
   });
   if (!IS_SILENT) {
     appendReplayEvent(cwd, {
@@ -413,7 +415,10 @@ function cmdInject() {
     });
   }
   clearRouteContext({ cwd, payload });
-  clearTurnState(cwd, { payload });
+  clearTurnState(cwd, {
+    payload,
+    ensureProjectLocal: shouldEnsureProjectLocal,
+  });
   cleanupProjectSessions(cwd, {
     minIntervalMs: IS_SILENT ? PROJECT_SESSION_CLEANUP_COOLDOWN_MS : 0,
   });

package/scripts/project-storage.mjs

@@ -250,7 +250,7 @@ export function buildProjectStorageHint(cwd, options = {}) {
     hints.push(`当前宿主未提供稳定会话标识，因此使用工作区默认位置 \`${summary.stateSessionToken}\``)
   }
   if (summary.usesSharedStore) {
-    hints.push(`项目存储：\`project_store_mode=repo-shared\`；本地激活/会话运行态目录仍是 \`${summary.promptActivationDir}\`，知识库/方案目录改为 \`${summary.promptStoreDir}\``)
+    hints.push(`项目存储：\`project_store_mode=repo-shared\`；项目本地存储/会话运行态目录仍是 \`${summary.promptActivationDir}\`，知识库/方案目录改为 \`${summary.promptStoreDir}\``)
   }
   return hints.join('。') + (hints.length > 0 ? '。' : '')
 }
@@ -263,7 +263,7 @@ export function buildProjectStorageBlock(cwd, options = {}) {
 
   const details = {
     project_store_mode: summary.projectStoreMode,
-    activation_dir: summary.promptActivationDir,
+    project_local_dir: summary.promptActivationDir,
     state_scope: summary.stateScope,
     state_path: summary.promptStatePath,
     state_workspace: summary.stateWorkspace,
@@ -281,9 +281,9 @@ export function buildProjectStorageBlock(cwd, options = {}) {
     explanations.push('说明：当前宿主未提供稳定会话标识，因此使用工作区默认位置。')
   }
   if (summary.usesSharedStore) {
-    explanations.push('说明：状态文件与会话产物写本地激活目录；`context.md`、`guidelines.md`、`DESIGN.md`、`verify.yaml`、`modules/`、`plans/`、`archive/` 写知识库/方案目录。')
+    explanations.push('说明：状态文件与会话产物写项目本地存储目录；`context.md`、`guidelines.md`、`DESIGN.md`、`verify.yaml`、`modules/`、`plans/`、`archive/` 写知识库/方案目录。')
   } else {
-    explanations.push('说明：当前使用项目本地 `.helloagents/` 作为激活目录、知识库目录和方案目录。')
+    explanations.push('说明：当前使用项目本地 `.helloagents/` 作为知识、方案、状态和运行态目录。')
   }
 
   return [