helloagents 3.0.12 → 3.0.16-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.12",
+  "version": "3.0.16-beta.1",
   "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",
@@ -12,7 +12,8 @@
   },
   "bin": {
     "helloagents": "cli.mjs",
-    "helloagents-js": "cli.mjs"
+    "helloagents-js": "cli.mjs",
+    "helloagents-turn-state": "scripts/turn-state-cli.mjs"
   },
   "scripts": {
     "test": "node --test",
@@ -20,7 +21,13 @@
     "preuninstall": "node cli.mjs preuninstall",
     "uninstall": "node cli.mjs preuninstall",
     "postuninstall": "node cli.mjs preuninstall",
-    "prepublishOnly": "node cli.mjs sync-version"
+    "prepublishOnly": "node cli.mjs sync-version",
+    "deploy": "node cli.mjs install",
+    "deploy:standby": "node cli.mjs install --all --standby",
+    "deploy:global": "node cli.mjs install --all --global",
+    "sync-hosts": "node cli.mjs update",
+    "cleanup-hosts": "node cli.mjs cleanup",
+    "switch-branch": "node cli.mjs switch-branch"
   },
   "files": [
     "cli.mjs",
@@ -32,11 +39,23 @@
     "bootstrap.md",
     "bootstrap-lite.md",
     "README_CN.md",
+    "install.sh",
+    "install.ps1",
     "gemini-extension.json",
     ".claude-plugin/",
     ".codex-plugin/"
   ],
-  "keywords": ["ai", "agent", "claude", "codex", "cli", "orchestration", "subagent", "hooks", "skills"],
+  "keywords": [
+    "ai",
+    "agent",
+    "claude",
+    "codex",
+    "cli",
+    "orchestration",
+    "subagent",
+    "hooks",
+    "skills"
+  ],
   "engines": {
     "node": ">=18"
   }

package/scripts/advisor-state.mjs

@@ -1,12 +1,19 @@
-import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
-import { join } from 'node:path'
 
 import { appendReplayEvent } from './replay-state.mjs'
-import { captureWorkspaceFingerprint } from './verify-state.mjs'
-
-export const ADVISOR_EVIDENCE_FILE_NAME = '.ralph-advisor.json'
-const ADVISOR_EVIDENCE_MAX_AGE_MS = 30 * 60 * 1000
+import {
+  captureWorkspaceFingerprint,
+  clearRuntimeEvidence,
+  getRuntimeEvidencePath,
+  getRuntimeEvidenceRelativePath,
+  readRuntimeEvidence,
+  validateEvidenceFingerprint,
+  validateEvidenceTimestamp,
+  writeRuntimeEvidence,
+} from './runtime-artifacts.mjs'
+
+export const ADVISOR_EVIDENCE_FILE_NAME = 'advisor.json'
 const VALID_ADVISOR_OUTCOMES = new Set(['clean', 'findings'])
 const VALID_SOURCES = new Set(['claude', 'codex', 'gemini'])
 
@@ -24,20 +31,16 @@ function normalizeOutcome(value) {
   return VALID_ADVISOR_OUTCOMES.has(normalized) ? normalized : ''
 }
 
-export function getAdvisorEvidencePath(cwd) {
-  return join(cwd, '.helloagents', ADVISOR_EVIDENCE_FILE_NAME)
+export function getAdvisorEvidencePath(cwd, options = {}) {
+  return getRuntimeEvidencePath(cwd, ADVISOR_EVIDENCE_FILE_NAME, options)
 }
 
-export function readAdvisorEvidence(cwd) {
-  try {
-    return JSON.parse(readFileSync(getAdvisorEvidencePath(cwd), 'utf-8'))
-  } catch {
-    return null
-  }
+export function readAdvisorEvidence(cwd, options = {}) {
+  return readRuntimeEvidence(cwd, ADVISOR_EVIDENCE_FILE_NAME, options)
 }
 
-export function clearAdvisorEvidence(cwd) {
-  rmSync(getAdvisorEvidencePath(cwd), { force: true })
+export function clearAdvisorEvidence(cwd, options = {}) {
+  clearRuntimeEvidence(cwd, ADVISOR_EVIDENCE_FILE_NAME, options)
 }
 
 export function normalizeAdvisorEvidence(input = {}) {
@@ -55,19 +58,19 @@ export function normalizeAdvisorEvidence(input = {}) {
   }
 }
 
-export function writeAdvisorEvidence(cwd, input = {}) {
-  mkdirSync(join(cwd, '.helloagents'), { recursive: true })
+export function writeAdvisorEvidence(cwd, input = {}, options = {}) {
   const normalized = normalizeAdvisorEvidence(input)
   const payload = {
     updatedAt: new Date().toISOString(),
     ...normalized,
     fingerprint: captureWorkspaceFingerprint(cwd),
   }
-  writeFileSync(getAdvisorEvidencePath(cwd), `${JSON.stringify(payload, null, 2)}\n`, 'utf-8')
+  writeRuntimeEvidence(cwd, ADVISOR_EVIDENCE_FILE_NAME, payload, options)
   appendReplayEvent(cwd, {
     event: 'advisor_evidence_written',
     source: normalized.source,
     skillName: normalized.originCommand,
+    payload: options.payload || {},
     details: {
       reason: normalized.reason,
       focus: normalized.focus,
@@ -75,12 +78,12 @@ export function writeAdvisorEvidence(cwd, input = {}) {
       consultedSources: normalized.consultedSources,
       outcome: normalized.outcome,
     },
-    artifacts: ['.helloagents/.ralph-advisor.json'],
+    artifacts: [getRuntimeEvidenceRelativePath(cwd, ADVISOR_EVIDENCE_FILE_NAME, options)],
   })
   return payload
 }
 
-function readRequiredAdvisorEvidence(cwd, required) {
+function readRequiredAdvisorEvidence(cwd, required, options = {}) {
   if (!required) {
     return {
       required: false,
@@ -88,53 +91,23 @@ function readRequiredAdvisorEvidence(cwd, required) {
     }
   }
 
-  const evidence = readAdvisorEvidence(cwd)
+  const evidence = readAdvisorEvidence(cwd, options)
   if (evidence) return { evidence }
   return {
     error: {
       required: true,
       status: 'missing',
-      details: ['missing advisor evidence required by the active contract'],
+      details: ['缺少当前契约要求的 advisor 证据'],
     },
   }
 }
 
 function validateAdvisorTimestamp(evidence, now) {
-  const updatedAt = Date.parse(evidence.updatedAt || '')
-  if (!Number.isFinite(updatedAt)) {
-    return {
-      required: true,
-      status: 'invalid',
-      evidence,
-      details: ['advisor evidence timestamp is invalid'],
-    }
-  }
-  if (now - updatedAt > ADVISOR_EVIDENCE_MAX_AGE_MS) {
-    return {
-      required: true,
-      status: 'stale-time',
-      evidence,
-      details: ['advisor evidence is older than 30 minutes'],
-    }
-  }
-  return null
+  return validateEvidenceTimestamp(evidence, now, 'advisor 证据')
 }
 
 function validateAdvisorFingerprint(cwd, evidence) {
-  const currentFingerprint = captureWorkspaceFingerprint(cwd)
-  if (
-    currentFingerprint.available
-    && evidence.fingerprint?.available
-    && currentFingerprint.combined !== evidence.fingerprint.combined
-  ) {
-    return {
-      required: true,
-      status: 'stale-diff',
-      evidence,
-      details: ['workspace diff changed after the last advisor evidence'],
-    }
-  }
-  return null
+  return validateEvidenceFingerprint(cwd, evidence, 'advisor 证据')
 }
 
 function validateAdvisorContent(evidence, focus = []) {
@@ -143,7 +116,7 @@ function validateAdvisorContent(evidence, focus = []) {
       required: true,
       status: 'invalid',
       evidence,
-      details: ['advisor evidence must record explicit outcome, reason, and summary'],
+      details: ['advisor 证据必须记录明确的 outcome、reason 和 summary'],
     }
   }
   if (normalizeSources(evidence.consultedSources).length === 0) {
@@ -151,7 +124,7 @@ function validateAdvisorContent(evidence, focus = []) {
       required: true,
       status: 'invalid',
       evidence,
-      details: ['advisor evidence must record at least one consulted source'],
+      details: ['advisor 证据必须记录至少一个参考来源'],
     }
   }
   if (normalizeStringArray(focus).length > 0 && normalizeStringArray(evidence.focus).length === 0) {
@@ -159,7 +132,7 @@ function validateAdvisorContent(evidence, focus = []) {
       required: true,
       status: 'invalid',
       evidence,
-      details: ['advisor evidence must retain the requested advisor focus'],
+      details: ['advisor 证据必须保留已请求的 advisor focus'],
     }
   }
   if (normalizeOutcome(evidence.outcome) !== 'clean') {
@@ -167,14 +140,14 @@ function validateAdvisorContent(evidence, focus = []) {
       required: true,
       status: 'blocked',
       evidence,
-      details: ['latest advisor evidence still records blocking findings'],
+      details: ['最新 advisor 证据仍记录阻塞问题'],
     }
   }
   return null
 }
 
-export function getAdvisorEvidenceStatus(cwd, { required = false, focus = [], now = Date.now() } = {}) {
-  const requiredEvidence = readRequiredAdvisorEvidence(cwd, required)
+export function getAdvisorEvidenceStatus(cwd, { required = false, focus = [], now = Date.now(), ...options } = {}) {
+  const requiredEvidence = readRequiredAdvisorEvidence(cwd, required, options)
   if ('status' in requiredEvidence) return requiredEvidence
   if (requiredEvidence.error) return requiredEvidence.error
 
@@ -209,10 +182,10 @@ function main() {
 
   const input = readStdinJson()
   const cwd = input.cwd || process.cwd()
-  const payload = writeAdvisorEvidence(cwd, input)
+  const payload = writeAdvisorEvidence(cwd, input, { payload: input })
   process.stdout.write(JSON.stringify({
     suppressOutput: true,
-    path: getAdvisorEvidencePath(cwd),
+    path: getAdvisorEvidencePath(cwd, { payload: input }),
     payload,
   }))
 }

package/scripts/capability-registry.mjs

@@ -26,8 +26,8 @@ export function selectCapabilities({ cwd, skillName = '', options = {} }) {
     capabilities.push({
       id: 'advisor-artifact',
       description: advisorRequirement.styleRequired
-        ? '风格 advisor：当前 UI 契约要求进入收尾前复查设计方向，并复用 `.helloagents/.ralph-advisor.json` 记录 reason、focus、consultedSources 与结论。'
-        : '独立 advisor：当前契约要求进入收尾前写 `.helloagents/.ralph-advisor.json`，记录 advisor reason、focus、consultedSources 与结论。',
+        ? '风格 advisor：当前 UI 契约要求进入收尾前复查设计方向，并写当前会话 `artifacts/advisor.json` 记录 reason、focus、consultedSources 与结论。'
+        : '独立 advisor：当前契约要求进入收尾前写当前会话 `artifacts/advisor.json`，记录 advisor reason、focus、consultedSources 与结论。',
     })
   }
   if (plan?.contract?.verifyMode === 'review-first') {
@@ -39,13 +39,13 @@ export function selectCapabilities({ cwd, skillName = '', options = {} }) {
   if (plan?.contract?.ui?.required || existsSync(getProjectDesignContractPath(cwd))) {
     capabilities.push({
       id: 'design-contract',
-      description: `UI 契约：仅在 UI 场景按需读取当前 plan.md / prd/03-ui-design.md、${describeProjectStoreFile(cwd, 'DESIGN.md')} 与 hello-ui，不全局常驻。`,
+      description: `UI 契约：仅在 UI 场景按需读取当前 plan.md / prd/03-ui-design.md、${describeProjectStoreFile(cwd, 'DESIGN.md')} 与 hello-ui，并与 UI 质量基线共同生效。`,
     })
   }
   if (visualRequirement.required) {
     capabilities.push({
       id: 'visual-evaluator',
-      description: '视觉验收：当前 UI 契约要求进入收尾前写 `.helloagents/.ralph-visual.json`，记录 tooling、screensChecked、statesChecked、status 与 summary。',
+      description: '视觉验收：当前 UI 契约要求进入收尾前写当前会话 `artifacts/visual.json`，记录 tooling、screensChecked、statesChecked、status 与 summary。',
     })
   }
 

package/scripts/cli-branch.mjs

@@ -0,0 +1,84 @@
+import { spawnSync } from 'node:child_process'
+
+import { normalizeHost } from './cli-lifecycle.mjs'
+
+const DEFAULT_REPO_SPEC = 'github:hellowind777/helloagents'
+
+function runCommand(command, args) {
+  const needsShell = process.platform === 'win32' && /\.cmd$/i.test(command)
+  const result = spawnSync(command, args, {
+    encoding: 'utf-8',
+    errors: 'replace',
+    shell: needsShell,
+    stdio: 'inherit',
+    windowsHide: true,
+  })
+  if (result.error) throw result.error
+  if (result.status !== 0) {
+    throw new Error(`${command} ${args.join(' ')} 执行失败，退出码 ${result.status}`)
+  }
+}
+
+function parseModeFlag(args) {
+  const hasGlobal = args.includes('--global')
+  const hasStandby = args.includes('--standby')
+  if (hasGlobal && hasStandby) throw new Error('不能同时使用 --global 和 --standby')
+  if (hasGlobal) return 'global'
+  if (hasStandby) return 'standby'
+  return ''
+}
+
+function parseTarget(args) {
+  const wantsAll = args.includes('--all')
+  const positionals = args.filter((arg) => !arg.startsWith('--'))
+  if (!positionals.length) throw new Error('缺少分支名或 npm ref')
+  if (wantsAll && positionals.length > 1) {
+    throw new Error('`--all` 不能和指定 CLI 同时使用')
+  }
+
+  const branch = positionals[0]
+  const host = wantsAll ? 'all' : normalizeHost(positionals[1] || 'all')
+  if (!host) throw new Error(`不支持的 CLI：${positionals[1]}`)
+  if (positionals.length > 2) throw new Error(`参数过多：${positionals.join(' ')}`)
+  return { branch, host }
+}
+
+function parseBranchArgs(args) {
+  const unknownFlags = args.filter((arg) => (
+    arg.startsWith('--') && !['--global', '--standby', '--all'].includes(arg)
+  ))
+  if (unknownFlags.length) throw new Error(`未知参数：${unknownFlags.join(', ')}`)
+  return {
+    ...parseTarget(args),
+    mode: parseModeFlag(args),
+  }
+}
+
+function buildPackageSpec(ref) {
+  if (/^(github:|git\+|https?:|file:)/i.test(ref)) return ref
+  return `${DEFAULT_REPO_SPEC}#${ref}`
+}
+
+function buildSyncArgs({ host, mode }) {
+  return [
+    'explore',
+    '-g',
+    'helloagents',
+    '--',
+    'npm',
+    'run',
+    'sync-hosts',
+    '--',
+    host === 'all' ? '--all' : host,
+    ...(mode ? [`--${mode}`] : []),
+  ]
+}
+
+export function runBranchSwitch(args, options = {}) {
+  const parsed = parseBranchArgs(args)
+  const npmCommand = options.npmCommand || process.env.HELLOAGENTS_NPM_CMD || 'npm'
+
+  const packageSpec = buildPackageSpec(parsed.branch)
+  runCommand(npmCommand, ['install', '-g', packageSpec])
+  runCommand(npmCommand, buildSyncArgs(parsed))
+}

package/scripts/cli-codex-config.mjs

@@ -6,6 +6,11 @@ import {
 
 export const CODEX_PLUGIN_CONFIG_HEADER = '[plugins."helloagents@local-plugins"]'
 export const CODEX_MANAGED_TOML_COMMENT = '# helloagents-managed'
+export const CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH = '~/.codex/AGENTS.md'
+export const CODEX_MANAGED_NOTIFY_COMMAND = process.platform === 'win32'
+  ? 'helloagents-js.cmd'
+  : 'helloagents-js'
+export const CODEX_MANAGED_NOTIFY_VALUE = `["${CODEX_MANAGED_NOTIFY_COMMAND}", "codex-notify"]`
 
 function normalizePath(value = '') {
   return String(value || '').replace(/\\/g, '/')
@@ -30,9 +35,8 @@ export function isManagedCodexNotify(line = '') {
   const value = String(line || '').replace(/\\/g, '/')
   return value.includes(CODEX_MANAGED_TOML_COMMENT)
     || (
-      value.includes('codex-notify')
-      && value.includes('/scripts/notify.mjs')
-      && /(^|[/\\])helloagents([/\\]|-|$)|[/\\]plugins[/\\]helloagents[/\\]/i.test(value)
+      value.includes('helloagents-js')
+      && value.includes('codex-notify')
     )
 }
 
@@ -40,24 +44,20 @@ export function isManagedCodexBackupInstruction(line = '') {
   return line.includes(CODEX_MANAGED_TOML_COMMENT)
 }
 
-export function isManagedCodexHooks(line = '') {
-  return /^\s*codex_hooks\s*=\s*true(?:\s+#.*)?\s*$/i.test(String(line || ''))
-}
-
 function formatManagedCodexModelInstructionsValue(filePath) {
   return `"${normalizePath(filePath)}" ${CODEX_MANAGED_TOML_COMMENT}`
 }
 
-function formatManagedCodexModelInstructionsLine(filePath) {
+function formatManagedCodexModelInstructionsLine(filePath = CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH) {
   return `model_instructions_file = ${formatManagedCodexModelInstructionsValue(filePath)}`
 }
 
-function formatManagedCodexNotifyValue(notifyScriptPath) {
-  return `["node", "${normalizePath(notifyScriptPath)}", "codex-notify"]`
+function formatManagedCodexNotifyValue() {
+  return CODEX_MANAGED_NOTIFY_VALUE
 }
 
-function formatManagedCodexNotifyLine(notifyScriptPath) {
-  return `notify = ${formatManagedCodexNotifyValue(notifyScriptPath)} ${CODEX_MANAGED_TOML_COMMENT}`
+function formatManagedCodexNotifyLine() {
+  return `notify = ${formatManagedCodexNotifyValue()} ${CODEX_MANAGED_TOML_COMMENT}`
 }
 
 function removeTopLevelLinesBeingReplaced(toml, lines) {
@@ -79,16 +79,10 @@ function upsertOrderedCodexTopLevelLines(toml, lines) {
   )
 }
 
-export function installCodexModelInstructions(toml, filePath) {
-  return upsertOrderedCodexTopLevelLines(toml, [
-    formatManagedCodexModelInstructionsLine(filePath),
-  ])
-}
-
-export function installCodexManagedTopLevelConfig(toml, { modelInstructionsPath, notifyScriptPath }) {
+export function installCodexManagedTopLevelConfig(toml, { modelInstructionsPath } = {}) {
   return upsertOrderedCodexTopLevelLines(toml, [
     formatManagedCodexModelInstructionsLine(modelInstructionsPath),
-    formatManagedCodexNotifyLine(notifyScriptPath),
+    formatManagedCodexNotifyLine(),
   ])
 }
 

package/scripts/cli-codex.mjs

@@ -8,8 +8,8 @@ import {
 import { ensureTimestampedBackup, readCodexBackup, removeCodexBackup } from './cli-codex-backup.mjs';
 import {
   CODEX_MANAGED_TOML_COMMENT,
+  CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH,
   CODEX_PLUGIN_CONFIG_HEADER,
-  isManagedCodexHooks,
   installCodexManagedTopLevelConfig,
   isManagedCodexBackupInstruction,
   isManagedCodexModelInstruction,
@@ -21,11 +21,9 @@ import {
 import {
   readTopLevelTomlLine,
   readTopLevelTomlBlock,
-  readTomlKeyInSection,
-  removeTomlKeyInSection,
-  ensureTomlKeyInSection,
   removeTopLevelTomlLines,
 } from './cli-toml.mjs';
+import { buildRuntimeCarrier, readCarrierSettings } from './cli-runtime-carrier.mjs';
 
 export const CODEX_MARKETPLACE_NAME = 'local-plugins';
 export const CODEX_PLUGIN_NAME = 'helloagents';
@@ -108,22 +106,17 @@ function removeCodexMarketplaceEntry(marketplaceFile) {
   return true;
 }
 
-function buildCodexRuntimeCarrier(bootstrapContent) {
-  const normalized = String(bootstrapContent || '').trim();
-  return normalized ? `${normalized}\n` : '';
-}
-
-function injectCodexRuntimeCarrier(filePath, bootstrapPath) {
+function injectCodexRuntimeCarrier(filePath, bootstrapPath, settings) {
   const bootstrapContent = safeRead(bootstrapPath);
   if (!bootstrapContent) return false;
-  injectMarkedContent(filePath, buildCodexRuntimeCarrier(bootstrapContent).trimEnd());
+  injectMarkedContent(filePath, buildRuntimeCarrier(bootstrapContent, settings).trimEnd());
   return true;
 }
 
-function writeCodexRuntimeCarrier(filePath, bootstrapPath) {
+function writeCodexRuntimeCarrier(filePath, bootstrapPath, settings) {
   const bootstrapContent = safeRead(bootstrapPath);
   if (!bootstrapContent) return false;
-  safeWrite(filePath, buildCodexRuntimeCarrier(bootstrapContent));
+  safeWrite(filePath, buildRuntimeCarrier(bootstrapContent, settings));
   return true;
 }
 
@@ -133,11 +126,9 @@ function cleanupCodexManagedConfig(configPath, { removePluginConfig = false } =
 
   const currentModelInstructions = readTopLevelTomlLine(toml, 'model_instructions_file');
   const currentNotify = readTopLevelTomlBlock(toml, 'notify');
-  const currentCodexHooks = readTomlKeyInSection(toml, '[features]', 'codex_hooks');
 
   const shouldRestoreModelInstructions = isManagedCodexModelInstruction(currentModelInstructions);
   const shouldRestoreNotify = isManagedCodexNotify(currentNotify);
-  const shouldRestoreCodexHooks = isManagedCodexHooks(currentCodexHooks);
 
   if (removePluginConfig) {
     toml = removeCodexPluginConfig(toml);
@@ -150,13 +141,9 @@ function cleanupCodexManagedConfig(configPath, { removePluginConfig = false } =
     toml = removeTopLevelTomlLines(toml, (line) =>
       line.startsWith('notify =') && isManagedCodexNotify(line)).text;
   }
-  if (shouldRestoreCodexHooks) {
-    toml = removeTomlKeyInSection(toml, '[features]', 'codex_hooks');
-  }
 
   const backupModelInstructions = readTopLevelTomlLine(backupToml, 'model_instructions_file');
   const backupNotify = readTopLevelTomlBlock(backupToml, 'notify');
-  const backupCodexHooks = readTomlKeyInSection(backupToml, '[features]', 'codex_hooks');
 
   toml = restoreCodexTopLevelConfig(toml, {
     modelInstructionsLine: shouldRestoreModelInstructions && !isManagedCodexBackupInstruction(backupModelInstructions)
@@ -166,14 +153,6 @@ function cleanupCodexManagedConfig(configPath, { removePluginConfig = false } =
       ? backupNotify
       : '',
   });
-  toml = ensureTomlKeyInSection(
-    toml,
-    '[features]',
-    'codex_hooks',
-    shouldRestoreCodexHooks && !isManagedCodexHooks(backupCodexHooks)
-      ? backupCodexHooks
-      : '',
-  );
 
   return toml;
 }
@@ -183,16 +162,16 @@ export function installCodexStandby(home, pkgRoot) {
   if (!existsSync(codexDir)) return false;
   ensureDir(codexDir);
 
+  const settings = readCarrierSettings(home);
   const codexAgentsPath = join(codexDir, CODEX_RUNTIME_CARRIER);
-  injectCodexRuntimeCarrier(codexAgentsPath, join(pkgRoot, 'bootstrap-lite.md'));
+  injectCodexRuntimeCarrier(codexAgentsPath, join(pkgRoot, 'bootstrap-lite.md'), settings);
 
   const configPath = join(codexDir, 'config.toml');
   let toml = safeRead(configPath) || '';
   ensureTimestampedBackup(configPath, CODEX_CONFIG_BASENAME);
 
   toml = installCodexManagedTopLevelConfig(toml, {
-    modelInstructionsPath: codexAgentsPath,
-    notifyScriptPath: join(pkgRoot, 'scripts', 'notify.mjs'),
+    modelInstructionsPath: CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH,
   });
   safeWrite(configPath, toml);
 
@@ -200,6 +179,24 @@ export function installCodexStandby(home, pkgRoot) {
   return true;
 }
 
+export function cleanupCodexGlobalResidueForStandby(home) {
+  const codexDir = join(home, '.codex');
+  const pluginRoot = join(home, 'plugins', CODEX_PLUGIN_NAME);
+  const pluginCacheRoot = join(codexDir, 'plugins', 'cache', CODEX_MARKETPLACE_NAME, CODEX_PLUGIN_NAME);
+  const marketplaceFile = join(home, '.agents', 'plugins', 'marketplace.json');
+  const configPath = join(codexDir, 'config.toml');
+
+  removeIfExists(pluginRoot);
+  removeIfExists(pluginCacheRoot);
+  removeCodexMarketplaceEntry(marketplaceFile);
+
+  const toml = removeCodexPluginConfig(safeRead(configPath) || '');
+  if (toml.trim()) safeWrite(configPath, toml);
+  else removeIfExists(configPath);
+
+  return true;
+}
+
 export function uninstallCodexStandby(home) {
   const codexDir = join(home, '.codex');
   let changed = false;
@@ -213,15 +210,10 @@ export function uninstallCodexStandby(home) {
     else removeIfExists(configPath);
     changed = true;
     removeCodexBackup(configPath, CODEX_CONFIG_BASENAME);
-    removeIfExists(join(codexDir, 'hooks.json'));
     removeLink(join(codexDir, 'helloagents'));
     changed = true;
   }
 
-  for (const path of [join(codexDir, 'skills', 'helloagents'), join(home, '.agents', 'skills', 'helloagents')]) {
-    changed = removeLink(path) || changed;
-  }
-
   return changed;
 }
 
@@ -248,19 +240,22 @@ export function installCodexGlobal(home, pkgRoot) {
   ensureDir(join(home, 'plugins'));
   ensureDir(installedPluginRoot);
 
+  const settings = readCarrierSettings(home);
   copyEntries(pkgRoot, pluginRoot, CODEX_RUNTIME_ENTRIES);
   copyEntries(pkgRoot, installedPluginRoot, CODEX_RUNTIME_ENTRIES);
   createLink(pluginRoot, join(codexDir, 'helloagents'));
   writeCodexRuntimeCarrier(
     join(pluginRoot, CODEX_RUNTIME_CARRIER),
     join(pluginRoot, 'bootstrap.md'),
+    settings,
   );
   writeCodexRuntimeCarrier(
     join(installedPluginRoot, CODEX_RUNTIME_CARRIER),
     join(installedPluginRoot, 'bootstrap.md'),
+    settings,
   );
   const homeCarrierPath = join(codexDir, CODEX_RUNTIME_CARRIER);
-  injectCodexRuntimeCarrier(homeCarrierPath, join(pkgRoot, 'bootstrap.md'));
+  injectCodexRuntimeCarrier(homeCarrierPath, join(pkgRoot, 'bootstrap.md'), settings);
 
   ensureDir(join(home, '.agents', 'plugins'));
   updateCodexMarketplace(marketplaceFile);
@@ -268,8 +263,7 @@ export function installCodexGlobal(home, pkgRoot) {
   let toml = safeRead(configPath) || '';
   ensureTimestampedBackup(configPath, CODEX_CONFIG_BASENAME);
   toml = installCodexManagedTopLevelConfig(toml, {
-    modelInstructionsPath: homeCarrierPath,
-    notifyScriptPath: join(pluginRoot, 'scripts', 'notify.mjs'),
+    modelInstructionsPath: CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH,
   });
   toml = upsertCodexPluginConfig(toml);
   safeWrite(configPath, toml);

package/scripts/cli-doctor-render.mjs

@@ -4,6 +4,10 @@ export function printDoctorText(runtime, report) {
     `配置:\n  package_version: ${report.config.packageVersion}\n  install_mode: ${report.config.installMode}\n  tracked_host_modes: ${JSON.stringify(report.config.trackedHostModes)}`,
     `Config:\n  package_version: ${report.config.packageVersion}\n  install_mode: ${report.config.installMode}\n  tracked_host_modes: ${JSON.stringify(report.config.trackedHostModes)}`,
   ))
+  console.log(runtime.msg(
+    `  runtime_root: ${report.config.runtimeRoot}`,
+    `  runtime_root: ${report.config.runtimeRoot}`,
+  ))
 
   for (const entry of report.hosts) {
     console.log(`\n${entry.label}:`)