helloagents 3.0.30 → 3.0.32

package/scripts/cli-doctor.mjs

@@ -3,10 +3,9 @@ import { join } from 'node:path'
 
 import { DEFAULTS } from './cli-config.mjs'
 import { inspectCodexDoctor as inspectCodexDoctorImpl } from './cli-doctor-codex.mjs'
-import { inspectNativeDeepseekDoctor } from './cli-deepseek.mjs'
 import { printDoctorText } from './cli-doctor-render.mjs'
 import { buildRuntimeCarrier } from './cli-runtime-carrier.mjs'
-import { FULL_CARRIER_PROFILE_MARKER, loadHooksWithCliEntry, safeJson, safeRead } from './cli-utils.mjs'
+import { loadHooksWithCliEntry, safeJson, safeRead } from './cli-utils.mjs'
 
 const runtime = {
   home: '',
@@ -219,78 +218,6 @@ function inspectGeminiDoctor(settings) {
   return { host, label: runtime.getHostLabel(host), trackedMode, detectedMode, status, checks, issues, notes, suggestedFix: suggestDoctorFix(host, status, trackedMode) }
 }
 
-function inspectDeepseekDoctor(settings) {
-  const host = 'deepseek'
-  const trackedMode = normalizeDoctorMode(runtime.getTrackedHostMode(settings, host))
-  const detectedMode = normalizeDoctorMode(runtime.detectHostMode(host))
-  const deepseekDir = join(runtime.home, '.deepseek')
-  const carrierPath = join(deepseekDir, 'AGENTS.md')
-  const expectedCarrierFile = (detectedMode === 'global' || (detectedMode === 'none' && trackedMode === 'global'))
-    ? 'bootstrap.md'
-    : 'bootstrap-lite.md'
-  const checks = {
-    carrierMarker: (safeRead(carrierPath) || '').includes('HELLOAGENTS_START'),
-    carrierContentMatch: extractManagedCarrierContent(carrierPath)
-      === readExpectedCarrierContent(
-        expectedCarrierFile,
-        settings,
-        expectedCarrierFile === 'bootstrap.md' ? { profile: 'full' } : {},
-      ),
-    homeLink: safeRealTarget(join(deepseekDir, 'helloagents')) === runtime.pkgRoot,
-    fullProfile: (safeRead(carrierPath) || '').includes(FULL_CARRIER_PROFILE_MARKER),
-  }
-  const nativeDoctor = inspectNativeDeepseekDoctor()
-  const issues = []
-  const notes = []
-
-  if (trackedMode !== 'none' && detectedMode !== 'none' && trackedMode !== detectedMode) {
-    issues.push(buildDoctorIssue('tracked-mode-mismatch', '记录模式与检测模式不一致', 'Tracked mode does not match detected mode'))
-  }
-  if (detectedMode === 'standby') {
-    if (!checks.carrierMarker) issues.push(buildDoctorIssue('standby-carrier-missing', 'standby `~/.deepseek/AGENTS.md` 缺少 HelloAGENTS 标记', 'Standby `~/.deepseek/AGENTS.md` is missing the HELLOAGENTS marker'))
-    if (checks.carrierMarker && !checks.carrierContentMatch) issues.push(buildDoctorIssue('standby-carrier-drift', 'standby `~/.deepseek/AGENTS.md` 与当前标准模式规则不一致', 'Standby `~/.deepseek/AGENTS.md` differs from the current standby rules'))
-    if (!checks.homeLink) issues.push(buildDoctorIssue('standby-link-missing', 'standby `~/.deepseek/helloagents` 链接缺失或未指向稳定运行根目录', 'Standby `~/.deepseek/helloagents` link is missing or points to a different runtime root'))
-    if (checks.fullProfile) issues.push(buildDoctorIssue('standby-full-profile-residue', 'standby 模式下不应保留 full 标记', 'Standby mode should not keep the full profile marker'))
-  }
-  if (detectedMode === 'global') {
-    if (!checks.carrierMarker) issues.push(buildDoctorIssue('global-carrier-missing', 'global `~/.deepseek/AGENTS.md` 缺少 HelloAGENTS 标记', 'Global `~/.deepseek/AGENTS.md` is missing the HELLOAGENTS marker'))
-    if (checks.carrierMarker && !checks.carrierContentMatch) issues.push(buildDoctorIssue('global-carrier-drift', 'global `~/.deepseek/AGENTS.md` 与当前全局模式规则不一致', 'Global `~/.deepseek/AGENTS.md` differs from the current global rules'))
-    if (!checks.homeLink) issues.push(buildDoctorIssue('global-link-missing', 'global `~/.deepseek/helloagents` 链接缺失或未指向稳定运行根目录', 'Global `~/.deepseek/helloagents` link is missing or points to a different runtime root'))
-    if (!checks.fullProfile) issues.push(buildDoctorIssue('global-full-profile-missing', 'global 模式缺少 full 标记', 'Global mode is missing the full profile marker'))
-  }
-  if (trackedMode === 'none' && detectedMode !== 'none') {
-    issues.push(buildDoctorIssue('untracked-managed-state', '检测到受管状态，但配置中未记录该 CLI 模式', 'Managed state detected but this CLI mode is not tracked in config'))
-  }
-  if (trackedMode !== 'none' && detectedMode === 'none') {
-    issues.push(buildDoctorIssue('tracked-state-missing', '配置记录该 CLI 已安装，但未检测到对应的受管文件或配置', 'Config says this CLI is installed, but no managed artifacts were detected'))
-  }
-  if (!nativeDoctor.available) {
-    notes.push(runtime.msg(
-      '未找到 deepseek 命令；已跳过 DeepSeek 原生 doctor。',
-      'The deepseek command was not found; DeepSeek native doctor was skipped.',
-    ))
-  } else if (!nativeDoctor.ok) {
-    issues.push(buildDoctorIssue('native-doctor-failed', 'DeepSeek 原生 doctor 返回非零状态', 'DeepSeek native doctor returned a non-zero status'))
-  }
-  if (nativeDoctor.available && nativeDoctor.parseError) {
-    issues.push(buildDoctorIssue('native-doctor-invalid-json', 'DeepSeek 原生 doctor 输出不是可解析的 JSON', 'DeepSeek native doctor output was not valid JSON'))
-  }
-
-  const status = summarizeDoctorStatus(issues, { host, trackedMode, detectedMode })
-  return {
-    host,
-    label: runtime.getHostLabel(host),
-    trackedMode,
-    detectedMode,
-    status,
-    checks,
-    issues,
-    notes,
-    nativeDoctor,
-    suggestedFix: suggestDoctorFix(host, status, trackedMode),
-  }
-}
-
 function parseDoctorArgs(args) {
   const wantsJson = args.includes('--json')
   const unknownFlags = args.filter((arg) => arg.startsWith('--') && arg !== '--json' && arg !== '--all')
@@ -311,13 +238,12 @@ function parseDoctorArgs(args) {
 function inspectDoctorHost(host, settings) {
   if (host === 'claude') return inspectClaudeDoctor(settings)
   if (host === 'gemini') return inspectGeminiDoctor(settings)
-  if (host === 'deepseek') return inspectDeepseekDoctor(settings)
   return inspectCodexDoctorImpl(runtime, settings)
 }
 
 function buildDoctorReport(host) {
   const settings = runtime.readSettings(true)
-  const hosts = host === 'all' ? ['claude', 'gemini', 'codex', 'deepseek'] : [host]
+  const hosts = host === 'all' ? ['claude', 'gemini', 'codex'] : [host]
   const reports = hosts.map((target) => inspectDoctorHost(target, settings))
   const summary = reports.reduce((acc, report) => {
     acc[report.status] = (acc[report.status] || 0) + 1

package/scripts/cli-host-detect.mjs

@@ -7,7 +7,6 @@ import {
   CODEX_PLUGIN_NAME,
 } from './cli-codex.mjs'
 import { getStableRuntimeRoot } from './cli-runtime-root.mjs'
-import { FULL_CARRIER_PROFILE_MARKER } from './cli-utils.mjs'
 import { safeJson, safeRead } from './cli-utils.mjs'
 
 const HOST_ALIASES = new Map([
@@ -19,8 +18,6 @@ const HOST_ALIASES = new Map([
   ['gemini-cli', 'gemini'],
   ['codex', 'codex'],
   ['codex-cli', 'codex'],
-  ['deepseek', 'deepseek'],
-  ['deepseek-tui', 'deepseek'],
 ])
 
 function hasHelloagentsMarker(filePath) {
@@ -31,10 +28,6 @@ function hasHelloagentsSettings(filePath) {
   return JSON.stringify(safeJson(filePath) || {}).includes('helloagents')
 }
 
-function hasFullCarrierProfile(filePath) {
-  return (safeRead(filePath) || '').includes(FULL_CARRIER_PROFILE_MARKER)
-}
-
 function normalizePath(value = '') {
   return String(value || '').replace(/\\/g, '/').toLowerCase()
 }
@@ -97,26 +90,6 @@ function detectCodexMode(home) {
   return ''
 }
 
-function detectDeepseekMode(home) {
-  const deepseekDir = join(home, '.deepseek')
-  const carrierPath = join(deepseekDir, 'AGENTS.md')
-  const runtimeRoot = normalizePath(getStableRuntimeRoot(home))
-  const homeLinkTarget = safeRealTarget(join(deepseekDir, 'helloagents'))
-  if (
-    (hasHelloagentsMarker(carrierPath) || (existsSync(join(deepseekDir, 'helloagents')) && homeLinkTarget === runtimeRoot))
-    && hasFullCarrierProfile(carrierPath)
-  ) {
-    return 'global'
-  }
-  if (
-    (existsSync(join(deepseekDir, 'helloagents')) && homeLinkTarget === runtimeRoot)
-    || hasHelloagentsMarker(carrierPath)
-  ) {
-    return 'standby'
-  }
-  return ''
-}
-
 export function normalizeHost(value = '') {
   return HOST_ALIASES.get(String(value || '').toLowerCase()) || ''
 }
@@ -125,7 +98,6 @@ export function getHostLabel(host) {
   if (host === 'claude') return 'Claude Code'
   if (host === 'gemini') return 'Gemini CLI'
   if (host === 'codex') return 'Codex CLI'
-  if (host === 'deepseek') return 'DeepSeek TUI'
   return 'All CLIs'
 }
 
@@ -133,6 +105,5 @@ export function detectHostMode(host, runtime) {
   if (host === 'claude') return detectClaudeMode(runtime.home)
   if (host === 'gemini') return detectGeminiMode(runtime.home)
   if (host === 'codex') return detectCodexMode(runtime.home)
-  if (host === 'deepseek') return detectDeepseekMode(runtime.home)
   return ''
 }

package/scripts/cli-hosts.mjs

@@ -12,7 +12,6 @@ import {
   loadHooksWithCliEntry,
 } from './cli-utils.mjs';
 import { buildRuntimeCarrier, readCarrierSettings } from './cli-runtime-carrier.mjs';
-import { installDeepseekGlobal, installDeepseekStandby, uninstallDeepseekGlobal, uninstallDeepseekStandby } from './cli-deepseek.mjs'
 
 export function installClaudeStandby(home, pkgRoot) {
   const claudeDir = join(home, '.claude');
@@ -82,10 +81,3 @@ export function uninstallGeminiStandby(home) {
 
   return true;
 }
-
-export {
-  installDeepseekGlobal,
-  installDeepseekStandby,
-  uninstallDeepseekGlobal,
-  uninstallDeepseekStandby,
-}

package/scripts/cli-lifecycle-hosts.mjs

@@ -2,12 +2,8 @@ import { spawnSync } from 'node:child_process'
 
 import {
   installClaudeStandby,
-  installDeepseekGlobal,
-  installDeepseekStandby,
   installGeminiStandby,
   uninstallClaudeStandby,
-  uninstallDeepseekGlobal,
-  uninstallDeepseekStandby,
   uninstallGeminiStandby,
 } from './cli-hosts.mjs'
 import {
@@ -100,10 +96,6 @@ function installHostStandby(runtime, host) {
     installGeminiStandby(runtime.home, runtime.pkgRoot)
     return {}
   }
-  if (host === 'deepseek') {
-    installDeepseekStandby(runtime.home, runtime.pkgRoot)
-    return {}
-  }
   if (!installCodexStandby(runtime.home, runtime.pkgRoot)) return { skipped: true }
   cleanupCodexGlobalResidueForStandby(runtime.home)
   return {}
@@ -130,10 +122,6 @@ function installHostGlobal(runtime, host) {
       'Gemini CLI extension auto-install failed. Run manually: gemini extensions install https://github.com/hellowind777/helloagents',
     )
   }
-  if (host === 'deepseek') {
-    installDeepseekGlobal(runtime.home, runtime.pkgRoot)
-    return {}
-  }
   uninstallCodexStandby(runtime.home)
   return installCodexGlobal(runtime.home, runtime.pkgRoot) ? {} : { skipped: true }
 }
@@ -141,7 +129,6 @@ function installHostGlobal(runtime, host) {
 function cleanupHostStandby(runtime, host) {
   if (host === 'claude') return { skipped: !uninstallClaudeStandby(runtime.home) }
   if (host === 'gemini') return { skipped: !uninstallGeminiStandby(runtime.home) }
-  if (host === 'deepseek') return { skipped: !uninstallDeepseekStandby(runtime.home) }
   const standbyCleaned = uninstallCodexStandby(runtime.home)
   const globalResidueCleaned = uninstallCodexGlobal(runtime.home)
   return { skipped: !(standbyCleaned || globalResidueCleaned) }
@@ -168,7 +155,6 @@ function cleanupHostGlobal(runtime, host) {
       'Gemini CLI extension auto-remove failed. Run manually: gemini extensions uninstall helloagents',
     )
   }
-  if (host === 'deepseek') return { skipped: !uninstallDeepseekGlobal(runtime.home) }
   return { skipped: !uninstallCodexGlobal(runtime.home) }
 }
 
@@ -194,18 +180,12 @@ function installStandby(runtime) {
     console.log(runtime.msg('  - Codex CLI 未检测到，跳过', '  - Codex CLI not detected, skipped'))
     results.codex = { skipped: true }
   }
-  if (installDeepseekStandby(runtime.home, runtime.pkgRoot)) {
-    runtime.ok(runtime.msg('DeepSeek TUI 已配置（standby 模式）', 'DeepSeek TUI configured (standby mode)'))
-    results.deepseek = {}
-  } else {
-    results.deepseek = { skipped: true }
-  }
   return results
 }
 
 function installGlobal(runtime) {
   const results = {}
-  for (const host of ['claude', 'gemini', 'codex', 'deepseek']) {
+  for (const host of ['claude', 'gemini', 'codex']) {
     const result = installHostGlobal(runtime, host)
     reportHostAction(runtime, 'install', host, 'global', result)
     results[host] = result
@@ -223,7 +203,6 @@ export function uninstallAllHosts(runtime) {
   cleanupHostGlobal(runtime, 'gemini')
   uninstallCodexStandby(runtime.home)
   uninstallCodexGlobal(runtime.home)
-  uninstallDeepseekStandby(runtime.home)
 }
 
 export function runHostLifecycle(runtime, action, host, mode) {

package/scripts/cli-lifecycle.mjs

@@ -10,7 +10,7 @@ import {
 import { installAllHosts, runHostLifecycle, uninstallAllHosts } from './cli-lifecycle-hosts.mjs'
 import { ensureDir, safeJson, safeWrite } from './cli-utils.mjs'
 
-export const HOSTS = ['claude', 'gemini', 'codex', 'deepseek']
+export const HOSTS = ['claude', 'gemini', 'codex']
 
 const runtime = {
   home: '',
@@ -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

@@ -19,18 +19,6 @@ function codexGlobalStatus({ home, msg }) {
     : msg('安装 Codex CLI 后重新运行 npm install -g helloagents', 'Install Codex CLI then re-run npm install -g helloagents')
 }
 
-function deepseekStandbyStatus({ home, msg }) {
-  return existsSync(join(home, '.deepseek'))
-    ? msg('已自动配置（~/.deepseek/AGENTS.md）', 'Auto-configured (~/.deepseek/AGENTS.md)')
-    : msg('安装 DeepSeek TUI 后重新运行 npm install -g helloagents', 'Install DeepSeek TUI then re-run npm install -g helloagents')
-}
-
-function deepseekGlobalStatus({ home, msg }) {
-  return existsSync(join(home, '.deepseek'))
-    ? msg('已自动切到受管全局载体（~/.deepseek/AGENTS.md）', 'Managed global carrier applied (~/.deepseek/AGENTS.md)')
-    : msg('安装 DeepSeek TUI 后重新运行 npm install -g helloagents', 'Install DeepSeek TUI then re-run npm install -g helloagents')
-}
-
 function pluginCommands() {
   return [
     '    Claude Code:  /plugin marketplace add hellowind777/helloagents',
@@ -61,24 +49,24 @@ function renderInstallMessage(context, mode, state) {
   if (mode === 'global') {
     if (install) {
       return msg(
-        `\n  ✅ HelloAGENTS 已安装（global 模式）！\n\n    Claude Code / Gemini CLI: 已自动尝试宿主原生插件/扩展安装\n    Codex:        ${codexGlobalStatus(context)}（~/.agents/plugins/marketplace.json + ~/plugins/helloagents）\n    DeepSeek TUI: ${deepseekGlobalStatus(context)}\n\n  ${restartHint(msg)}\n\n  若宿主命令不可用，请手动执行：\n${pluginCommands()}\n\n  切换模式：\n    helloagents --standby   标准模式（默认，非插件安装）`,
-        `\n  ✅ HelloAGENTS installed (global mode)!\n\n    Claude Code / Gemini CLI: native plugin/extension install attempted automatically\n    Codex:        ${codexGlobalStatus(context)} (~/.agents/plugins/marketplace.json + ~/plugins/helloagents)\n    DeepSeek TUI: ${deepseekGlobalStatus(context)}\n\n  ${restartHint(msg)}\n\n  If a host command is unavailable, run manually:\n${pluginCommands()}\n\n  Switch modes:\n    helloagents --standby   Standby mode (default, non-plugin install)`,
+        `\n  ✅ HelloAGENTS 已安装（global 模式）！\n\n    Claude Code / Gemini CLI: 已自动尝试宿主原生插件/扩展安装\n    Codex:        ${codexGlobalStatus(context)}（~/.agents/plugins/marketplace.json + ~/plugins/helloagents）\n\n  ${restartHint(msg)}\n\n  若宿主命令不可用，请手动执行：\n${pluginCommands()}\n\n  切换模式：\n    helloagents --standby   标准模式（默认，非插件安装）`,
+        `\n  ✅ HelloAGENTS installed (global mode)!\n\n    Claude Code / Gemini CLI: native plugin/extension install attempted automatically\n    Codex:        ${codexGlobalStatus(context)} (~/.agents/plugins/marketplace.json + ~/plugins/helloagents)\n\n  ${restartHint(msg)}\n\n  If a host command is unavailable, run manually:\n${pluginCommands()}\n\n  Switch modes:\n    helloagents --standby   Standby mode (default, non-plugin install)`,
       )
     }
     return msg(
       refresh
-        ? `  global 模式已刷新。\n  Claude Code / Gemini 已自动尝试刷新宿主插件/扩展；Codex 原生本地插件已重装并同步最新文件；DeepSeek TUI 受管全局载体已同步。\n  ${restartHint(msg)}`
-        : `  所有项目将自动启用完整 HelloAGENTS 规则。\n  Claude Code / Gemini 已自动尝试安装宿主插件/扩展；Codex 已自动安装原生本地插件；DeepSeek TUI 已切到受管全局载体。\n  ${restartHint(msg)}\n\n若宿主命令不可用，请手动执行：\n${pluginCommands()}`,
+        ? `  global 模式已刷新。\n  Claude Code / Gemini 已自动尝试刷新宿主插件/扩展；Codex 原生本地插件已重装并同步最新文件。\n  ${restartHint(msg)}`
+        : `  所有项目将自动启用完整 HelloAGENTS 规则。\n  Claude Code / Gemini 已自动尝试安装宿主插件/扩展；Codex 已自动安装原生本地插件。\n  ${restartHint(msg)}\n\n若宿主命令不可用，请手动执行：\n${pluginCommands()}`,
       refresh
-        ? `  Global mode refreshed.\n  Claude Code / Gemini native plugin/extension refresh was attempted automatically; Codex native local-plugin files were reinstalled and synced; the managed DeepSeek TUI global carrier was refreshed.\n  ${restartHint(msg)}`
-        : `  All projects will use full HelloAGENTS rules.\n  Claude Code / Gemini native plugin/extension install was attempted automatically; Codex now uses the native local-plugin path automatically; DeepSeek TUI now uses the managed global carrier.\n  ${restartHint(msg)}\n\nIf a host command is unavailable, run manually:\n${pluginCommands()}`,
+        ? `  Global mode refreshed.\n  Claude Code / Gemini native plugin/extension refresh was attempted automatically; Codex native local-plugin files were reinstalled and synced.\n  ${restartHint(msg)}`
+        : `  All projects will use full HelloAGENTS rules.\n  Claude Code / Gemini native plugin/extension install was attempted automatically; Codex now uses the native local-plugin path automatically.\n  ${restartHint(msg)}\n\nIf a host command is unavailable, run manually:\n${pluginCommands()}`,
     )
   }
 
   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    DeepSeek TUI: ${deepseekStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  standby 模式下，hello-* 技能不会自动触发。\n  在项目中使用 ~wiki 或 ~init 仅创建/同步知识库；用 ~global 初始化项目级全局模式；也可用 ~command 按需调用。\n\n  切换模式：\n    helloagents --global    项目级全局模式（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件；DeepSeek 使用受管 AGENTS 载体）`,
-      `\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    DeepSeek TUI: ${deepseekStandbyStatus(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; DeepSeek uses a managed AGENTS carrier)`,
+      `\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)`,
     )
   }
 
@@ -102,17 +90,17 @@ HelloAGENTS v${pkgVersion} — The orchestration kernel for AI CLIs
   helloagents-js             ${msg('（受管宿主配置的跨平台稳定入口）', '(cross-platform stable entrypoint for managed host configs)')}
 
 ${msg('模式切换', 'Mode switching')}:
-  helloagents --global     ${msg('项目级全局模式（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件；DeepSeek 使用受管 AGENTS 载体）', 'Project-level global mode (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex; DeepSeek uses a managed AGENTS carrier)')}
+  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 deepseek --standby
+  helloagents install gemini --standby
   helloagents install --all --global
   helloagents update codex
   helloagents cleanup claude --global
   helloagents uninstall gemini
-  ${msg('支持: claude | gemini | codex | deepseek | --all；省略模式时优先沿用该 CLI 已记录/已检测的模式，否则回退 standby', 'Hosts: claude | gemini | codex | deepseek | --all; omit mode to reuse the tracked/detected mode for that CLI, then fall back to standby')}
+  ${msg('支持: claude | gemini | codex | --all；省略模式时优先沿用该 CLI 已记录/已检测的模式，否则回退 standby', 'Hosts: claude | gemini | codex | --all; omit mode to reuse the tracked/detected mode for that CLI, then fall back to standby')}
 
 ${msg('分支切换', 'Branch switching')}:
   helloagents switch-branch beta
@@ -123,7 +111,7 @@ ${msg('分支切换', 'Branch switching')}:
 ${msg('诊断', 'Diagnostics')}:
   helloagents doctor
   helloagents doctor codex --json
-  ${msg('检查 carrier、链接、hooks、配置注入、Codex 插件安装、DeepSeek 原生 doctor 摘要、受管 model_instructions_file 指向、Codex hook trust 本机状态与版本漂移', 'Checks carriers, links, hooks, config injections, Codex plugin installation, DeepSeek native doctor summaries, managed model_instructions_file targeting, machine-local Codex hook trust state, and version drift')}
+  ${msg('检查 carrier、链接、hooks、配置注入、Codex 插件安装、受管 model_instructions_file 指向、Codex hook trust 本机状态与版本漂移', 'Checks carriers, links, hooks, config injections, Codex plugin installation, managed model_instructions_file targeting, machine-local Codex hook trust state, and version drift')}
 
 ${msg('Codex /goal', 'Codex /goal')}:
   helloagents codex goals status

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) {
@@ -54,6 +54,10 @@ function buildAliasRouteNote(skillName) {
   return '';
 }
 
+function buildDelegatedTaskHint() {
+  return '若当前输入明显来自上级代理、控制器或多代理协作上下文，且本次输出会交回上级代理继续汇总、决策或复述，而不是直接交付给最终用户，则按子代理处理：直接完成局部任务并返回结果、证据或阻塞项，不使用 HelloAGENTS 外层输出格式，不写 turn-state，不做面向最终用户的收尾。'
+}
+
 export function buildCompactionContext({ payload, pkgRoot, settings, bootstrapFile, host }) {
   const summaryParts = [];
   summaryParts.push('## HelloAGENTS 压缩摘要');
@@ -148,7 +152,7 @@ export function buildRouteInstruction({ skillName, extraRules = '', cwd, pkgRoot
   const commandHint = buildCommandRouteHint(canonicalSkillName, cwd, workflowOptions);
   const capabilityHint = buildCapabilityHint({ cwd, skillName: canonicalSkillName, options: workflowOptions });
   const projectStorageHint = buildProjectStorageHint(cwd, workflowOptions);
-  return `用户使用了 ~${skillName} 命令。当前命令技能文件已解析为：${skillPath}。请直接读取这个 SKILL.md；不要再探测其他 helloagents 路径。${aliasNote ? ` ${aliasNote}` : ''}${projectStorageHint ? ` ${projectStorageHint}` : ''}${commandHint ? ` ${commandHint}` : ''}${capabilityHint ? ` ${capabilityHint}` : ''}${extraRules}`;
+  return `用户使用了 ~${skillName} 命令。当前命令技能文件已解析为：${skillPath}。请直接读取这个 SKILL.md；不要再探测其他 helloagents 路径。 ${buildDelegatedTaskHint()}${aliasNote ? ` ${aliasNote}` : ''}${projectStorageHint ? ` ${projectStorageHint}` : ''}${commandHint ? ` ${commandHint}` : ''}${capabilityHint ? ` ${capabilityHint}` : ''}${extraRules}`;
 }
 
 export function buildSemanticRouteInstruction(cwd, payload = {}) {
@@ -159,6 +163,7 @@ export function buildSemanticRouteInstruction(cwd, payload = {}) {
   return [
     '当前消息未使用 ~command。',
     '请根据用户请求的真实意图选路，不依赖关键词表。',
+    buildDelegatedTaskHint(),
     'Delivery Tier: T0=探索/比较；T1=低风险小改动或显式验证；T2=多文件功能/新项目/需要结构化产物；T3=高风险或不可逆操作。',
     '路由映射：~idea=只读探索，不创建文件；~build=明确实现；~verify=审查/验证；~plan=结构化规划；~prd=重型规格；~auto=自动选择并继续执行后续阶段。',
     '若判定为 T3，默认先走 ~plan / ~prd；纯审查/验证请求才优先 ~verify。',

package/scripts/notify-events.mjs

@@ -4,14 +4,9 @@ export function shouldIgnoreCodexNotifyClient(client) {
   return normalized !== 'codex' && !normalized.startsWith('codex-');
 }
 
-export function shouldIgnoreFormattedSubagent(lastMsg, outputFormatEnabled) {
-  return outputFormatEnabled && !lastMsg.includes('【HelloAGENTS】');
-}
-
 export function resolveNotifyHost(argv = []) {
   const args = Array.from(argv, (value) => String(value || ''));
   const command = args[2] || args[0] || '';
-  if (args.includes('--deepseek')) return 'deepseek';
   if (args.includes('--gemini')) return 'gemini';
   if (args.includes('--codex') || command === 'codex-notify') return 'codex';
   return 'claude';

package/scripts/notify-route.mjs

@@ -17,7 +17,7 @@ export function resolveBootstrapFile(cwd, settings = {}, host = '') {
 }
 
 function shouldBypassRoute(prompt) {
-  return !prompt || /^\[子代理任务\]/.test(prompt)
+  return !prompt
 }
 
 function buildHelpExtraRules(skillName) {

package/scripts/notify-source.mjs

@@ -6,7 +6,6 @@ const HOST_LABELS = {
   codex: 'Codex',
   claude: 'Claude Code',
   gemini: 'Gemini',
-  deepseek: 'DeepSeek TUI',
 }
 
 function normalizePath(filePath = '') {

package/scripts/plan-contract.mjs

@@ -5,7 +5,7 @@ import { resolveProjectPlanDir } from './project-storage.mjs'
 
 export const PLAN_CONTRACT_FILE_NAME = 'contract.json'
 const VALID_VERIFY_MODES = new Set(['test-first', 'review-first'])
-const VALID_ADVISOR_SOURCES = new Set(['claude', 'codex', 'gemini', 'deepseek'])
+const VALID_ADVISOR_SOURCES = new Set(['claude', 'codex', 'gemini'])
 
 function normalizeStringArray(values) {
   if (!Array.isArray(values)) return []

package/scripts/ralph-loop.mjs

@@ -89,6 +89,30 @@ function runVerify(commands, cwd) {
   return failures;
 }
 
+function getLastAssistantMessage(data = {}) {
+  return String(
+    data.lastAssistantMessage
+    || data.last_assistant_message
+    || data['last-assistant-message']
+    || '',
+  ).trim();
+}
+
+function hasHelloagentsWrapper(message = '') {
+  if (!message.includes('【HelloAGENTS】')) return false;
+  const firstNonEmptyLine = message
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .find(Boolean);
+  return /^[💡⚡🔵✅❓⚠️❌]【HelloAGENTS】- /.test(firstNonEmptyLine || '') || message.includes('【HelloAGENTS】');
+}
+
+function validateSubagentOutput(data = {}) {
+  const message = getLastAssistantMessage(data);
+  if (!message || !hasHelloagentsWrapper(message)) return '';
+  return '[HelloAGENTS Runtime] 子代理输出不应使用 HelloAGENTS 外层格式。当前回复不是直接面向最终用户的终局交付，请改为自然输出，只返回结果、证据或阻塞项。';
+}
+
 /** Filter commands to fast checks only for subagent mode. Returns null if no fast commands found. */
 function filterSubagentCommands(commands) {
   const fast = commands.filter(cmd =>
@@ -117,6 +141,17 @@ export function evaluateRalphLoop(data = {}, runtime = {}) {
   const isSubagent = runtime.isSubagent ?? IS_SUBAGENT;
   const hookEventName = runtime.hookEventName || HOOK_EVENT;
 
+  if (isSubagent) {
+    const formatReason = validateSubagentOutput(data);
+    if (formatReason) {
+      return {
+        decision: 'block',
+        reason: formatReason,
+        suppressOutput: true,
+      };
+    }
+  }
+
   let commands = detectCommands(cwd);
   if (!commands?.length) {
     return { suppressOutput: true };

package/scripts/runtime-scope.mjs

@@ -146,7 +146,7 @@ export function getProjectRoot(cwd) {
 
 function getCarrierPathForRoot(root, host = '') {
   if (!root) return ''
-  if (host === 'codex' || host === 'deepseek') return join(root, 'AGENTS.md')
+  if (host === 'codex') return join(root, 'AGENTS.md')
   if (host === 'gemini') return join(root, '.gemini', 'GEMINI.md')
   return join(root, 'CLAUDE.md')
 }

package/scripts/turn-stop-gate.mjs

@@ -39,7 +39,7 @@ function buildBlockReason(routeContext, detail, cwd) {
   const commandLabel = `~${routeContext.skillName}`
   const workflowHint = buildWorkflowHint(cwd)
   return [
-    `[HelloAGENTS Runtime] 显式 ${commandLabel} 本轮不应直接停下。`,
+    `[HelloAGENTS Runtime] 显式 ${commandLabel} 当前对话不应直接停下。`,
     detail,
     workflowHint,
     '若无真实阻塞，请继续沿当前路径执行。',
@@ -74,7 +74,7 @@ function validateFormattedCloseoutMessage(routeContext, payload, cwd) {
   if (!firstNonEmptyLine || !/^[💡⚡🔵✅❓⚠️❌]【HelloAGENTS】- /.test(firstNonEmptyLine)) {
     return buildBlockReason(
       routeContext,
-      '最终收尾消息使用了 HelloAGENTS 外层格式，但首个非空行不是规范标题行。',
+      '最终回复使用了 HelloAGENTS 外层格式，但首个非空行不是规范标题行。',
       cwd,
     )
   }
@@ -82,7 +82,7 @@ function validateFormattedCloseoutMessage(routeContext, payload, cwd) {
   if (countMatches(message, /[💡⚡🔵✅❓⚠️❌]【HelloAGENTS】-/g) > 1) {
     return buildBlockReason(
       routeContext,
-      '最终收尾消息重复输出了 HelloAGENTS 标题；请把所有内容合并到同一个外层块内。',
+      '最终回复重复输出了 HelloAGENTS 标题；请把所有内容合并到同一个外层块内。',
       cwd,
     )
   }
@@ -90,7 +90,7 @@ function validateFormattedCloseoutMessage(routeContext, payload, cwd) {
   if (countMatches(message, /^🔄 下一步:/gm) > 1) {
     return buildBlockReason(
       routeContext,
-      '最终收尾消息重复输出了 `🔄 下一步`；请只保留一个真实下一步。',
+      '最终回复重复输出了 `🔄 下一步`；请只保留一个真实下一步。',
       cwd,
     )
   }
@@ -140,7 +140,7 @@ function validateTurnState(routeContext, turnState, cwd, payload = {}) {
       cwd,
     )
   }
-  return buildBlockReason(routeContext, `当前 turn-state 为 \`${turnState.kind}\`，不能作为本轮结束状态。`, cwd)
+  return buildBlockReason(routeContext, `当前 turn-state 为 \`${turnState.kind}\`，不能作为当前对话结束状态。`, cwd)
 }
 
 export function evaluateTurnStopGate(payload = {}) {

package/skills/commands/auto/SKILL.md

@@ -15,7 +15,7 @@ Trigger: ~auto <任务描述>
 - `T3` 高风险或不可逆操作默认不直接进入 `~build`；优先先走 `~plan` 或 `~prd`，纯审查/纯验证请求才可先进入 `~verify`
 - 主路径一旦确定，立即读取对应 command skill，并在阶段完成后继续执行后续阶段，避免同一任务重复探索或重复等待
 - 选路不替代授权；涉及外部副作用或高风险不可逆操作时，仍遵守 HelloAGENTS 阻塞判定与确认规则
-- 用户显式使用 `~auto`，表示已授权在当前任务边界内沿选定主路径持续执行；若本轮运行在 Codex `/goal` 下，`/goal` 只提供长程续跑与预算，`~auto` 仍按方案包、`state_path` 与验证契约推进；`~plan` / `~prd` 作为中间阶段时，不再额外询问“是否开始执行”，除非仍有真实阻塞；不得把 `🔄 下一步` 当作阶段交接或继续执行占位
+- 用户显式使用 `~auto`，表示已授权在当前任务边界内沿选定主路径持续执行；若当前运行在 Codex `/goal` 下，`/goal` 只提供长程续跑与预算，`~auto` 仍按方案包、`state_path` 与验证契约推进；`~plan` / `~prd` 作为中间阶段时，不再额外询问“是否开始执行”，除非仍有真实阻塞；不得把 `🔄 下一步` 当作阶段交接或继续执行占位
 - 优先消费当前上下文中已注入的 ROUTE / TIER、当前工作流约束与项目状态；不要在 `~auto` 内另建一套关键词路由表
 
 ## 流程
@@ -33,7 +33,7 @@ Trigger: ~auto <任务描述>
 ### 1. 选路
 
 - 先按当前上下文里已注入的 ROUTE / TIER 语义约束判断，不依赖关键词命中做机械分流
-- 若本轮没有足够的注入约束，再结合以下信号补足判断：影响范围、风险等级、是否需要结构化产物、是否已有活跃方案包、用户是否只想先比较方向
+- 若当前上下文没有足够的注入约束，再结合以下信号补足判断：影响范围、风险等级、是否需要结构化产物、是否已有活跃方案包、用户是否只想先比较方向
 - 选路优先级：
   - 纯探索 / 点子 / 方向比较 → `~idea`
   - 明确要求验证 / 审查 / 跑检查 → `~verify`

package/skills/commands/build/SKILL.md

@@ -20,15 +20,15 @@ Trigger: ~build [description]
 
 ### 1. 恢复与定位
 
-- 优先按当前已加载的 HelloAGENTS 规则恢复当前任务，并遵循“.helloagents/ 文件读取优先级”；若当前消息明确要继续上次任务、会话刚经历恢复 / 压缩，或本轮运行在 Codex active goal 下，先读取 `state_path`，再用当前用户消息、活跃方案包 / PRD 与代码事实确认当前任务
+- 优先按当前已加载的 HelloAGENTS 规则恢复当前任务，并遵循“.helloagents/ 文件读取优先级”；若当前消息明确要继续上次任务、会话刚经历恢复 / 压缩，或当前运行在 Codex active goal 下，先读取 `state_path`，再用当前用户消息、活跃方案包 / PRD 与代码事实确认当前任务
 - 若存在最近的活跃方案包，读取对应的：
   - `requirements.md`
   - `plan.md`
   - `tasks.md`
   - `contract.json`
-  - 实现时优先把 `tasks.md` 中每个任务的“完成标准”当作本轮实现约束，不要只按任务标题猜测范围
+  - 实现时优先把 `tasks.md` 中每个任务的“完成标准”当作本次实现约束，不要只按任务标题猜测范围
   - `contract.json` 存在时，优先按其中的 `verifyMode`、`reviewerFocus`、`testerFocus` 理解后续验证边界
-- 若本轮运行在 Codex active goal 下，按 `tasks.md` 未完成项、`contract.json` 与 `state_path` 恢复实现位置；不要自动创建新 goal，也不要把 goal 目标原文替代方案包
+- 若当前运行在 Codex active goal 下，按 `tasks.md` 未完成项、`contract.json` 与 `state_path` 恢复实现位置；不要自动创建新 goal，也不要把 goal 目标原文替代方案包
 - 若当前上下文中已注入“当前工作流约束”或“当前推荐下一命令”，先服从它；只有推荐仍为 `~build`，或用户明确提出新增实现范围时，才继续 `~build`
 - 其余项目知识库与相关代码文件，按 HelloAGENTS 项目上下文要求读取
 - 若任务涉及 UI，按以下优先级读取并遵循：当前活跃 `plan.md` / PRD 中的 UI 决策 > 逻辑 `.helloagents/DESIGN.md`（实际路径按当前项目存储模式解析） > 已读取的 `hello-ui` 规则；同时所有 UI 任务都必须满足 UI 质量基线