helloagents 3.0.29 → 3.0.30

package/bootstrap.md

@@ -209,7 +209,7 @@
 - 审查 / 执行验证 → `~verify`
 - 不确定或希望端到端自动推进时使用 `~auto`
 
-当前项目只要已建立 `.helloagents/`（例如执行过 `~wiki`、`~init`，或已进入项目级连续流程），就按项目级完整流程执行。
+当前项目只要已初始化（例如执行过 `~global`，或当前项目级规则文件已包含 `<!-- HELLOAGENTS_PROFILE: full -->`），就按项目级完整流程执行。
 
 #### 2. SPEC — 澄清目标与验收
 根据任务需要，按需读取项目上下文（知识库文件和项目文件），明确：
@@ -225,9 +225,9 @@
 先确定当前技能根目录：
 - 优先使用当前上下文中已注入的“本轮 HelloAGENTS 读取根目录”
 - 若当前上下文未注入，则使用稳定运行根目录 `~/.helloagents/helloagents`
-- 宿主固定链接（Codex `~/.codex/helloagents`、Claude `~/.claude/helloagents`、Gemini `~/.gemini/helloagents`）只作为兼容别名，不作为优先探测路径
+- 宿主固定链接（Codex `~/.codex/helloagents`、Claude `~/.claude/helloagents`、Gemini `~/.gemini/helloagents`、DeepSeek `~/.deepseek/helloagents`）只作为兼容别名，不作为优先探测路径
 - 仍无法确定时，明确说明缺少 HelloAGENTS 读取根目录；不要递归扫描 `$HOME`、`Downloads`、项目目录或旧版本目录
-- 已激活项目或全局模式下，技能是否需要使用由当前已加载 AGENTS 规则决定；不要因此额外探测项目目录里的 HelloAGENTS skills 路径
+- 全局模式或已初始化项目时，技能是否需要使用由当前已加载 AGENTS 规则决定；不要因此额外探测项目目录里的 HelloAGENTS skills 路径
 路径确定一次即可，不预读、不扫描整个目录，也不重复探测同一路径。
 hello-* 技能读取路径：`{HELLOAGENTS_READ_ROOT}/skills/{技能名}/SKILL.md`
 包内脚本优先使用稳定命令入口；涉及 turn-state 时按“收尾状态信号”执行。
@@ -265,8 +265,10 @@ 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）
@@ -287,7 +289,7 @@ 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` 只记录当前活跃会话索引，避免同一会话被拆成多个目录
@@ -299,7 +301,7 @@ templates/ 查找路径（按优先级；首次确定模板根目录后，本轮
 - 状态文件（`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 — 变更历史

package/gemini-extension.json

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

package/install.ps1

@@ -1,12 +1,12 @@
 # HelloAGENTS one-shot installer.
 #
 # Environment:
-#   HELLOAGENTS=all|claude|gemini|codex[:standby|global]
+#   HELLOAGENTS=all|claude|gemini|codex|deepseek[:standby|global]
 #   HELLOAGENTS_ACTION=install|update|cleanup|uninstall|switch-branch|branch
-#   HELLOAGENTS_TARGET=all|claude|gemini|codex
+#   HELLOAGENTS_TARGET=all|claude|gemini|codex|deepseek
 #   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"
 
@@ -29,7 +29,7 @@ if (-not $Target) { $Target = "all" }
 $Target = $Target.ToLowerInvariant()
 if ($Mode) { $Mode = $Mode.ToLowerInvariant() }
 
-if (@("all", "claude", "gemini", "codex") -notcontains $Target) {
+if (@("all", "claude", "gemini", "codex", "deepseek") -notcontains $Target) {
     throw "Unsupported HELLOAGENTS target: $Target"
 }
 
@@ -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

@@ -4,12 +4,12 @@ set -eu
 # HelloAGENTS one-shot installer.
 #
 # Environment:
-#   HELLOAGENTS=all|claude|gemini|codex[:standby|global]
+#   HELLOAGENTS=all|claude|gemini|codex|deepseek[:standby|global]
 #   HELLOAGENTS_ACTION=install|update|cleanup|uninstall|switch-branch|branch
-#   HELLOAGENTS_TARGET=all|claude|gemini|codex
+#   HELLOAGENTS_TARGET=all|claude|gemini|codex|deepseek
 #   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:-}"
@@ -36,7 +36,7 @@ TARGET="$(printf '%s' "$TARGET" | tr '[:upper:]' '[:lower:]')"
 MODE="$(printf '%s' "$MODE" | tr '[:upper:]' '[:lower:]')"
 
 case "$TARGET" in
-  all|claude|gemini|codex) ;;
+  all|claude|gemini|codex|deepseek) ;;
   *) echo "Unsupported HELLOAGENTS target: $TARGET" >&2; exit 1 ;;
 esac
 
@@ -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.30",
   "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/advisor-state.mjs

@@ -15,7 +15,7 @@ import {
 
 export const ADVISOR_EVIDENCE_FILE_NAME = 'advisor.json'
 const VALID_ADVISOR_OUTCOMES = new Set(['clean', 'findings'])
-const VALID_SOURCES = new Set(['claude', 'codex', 'gemini'])
+const VALID_SOURCES = new Set(['claude', 'codex', 'gemini', 'deepseek'])
 
 function normalizeStringArray(values) {
   if (!Array.isArray(values)) return []

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-deepseek.mjs

@@ -0,0 +1,131 @@
+import { spawnSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+
+import { buildRuntimeCarrier, readCarrierSettings } from './cli-runtime-carrier.mjs'
+import { createLink, ensureDir, injectMarkedContent, removeLink, removeMarkedContent, safeRead } from './cli-utils.mjs'
+
+export const DEEPSEEK_COMMAND = process.env.HELLOAGENTS_DEEPSEEK_CMD || 'deepseek'
+
+function looksLikeCommandPath(command = '') {
+  return /[\\/]/.test(command) || /^[A-Za-z]:/.test(command)
+}
+
+function injectDeepseekCarrier(home, pkgRoot, bootstrapFile, options = {}) {
+  const deepseekDir = join(home, '.deepseek')
+  ensureDir(deepseekDir)
+
+  const bootstrapContent = safeRead(join(pkgRoot, bootstrapFile))
+  if (!bootstrapContent) return false
+
+  injectMarkedContent(
+    join(deepseekDir, 'AGENTS.md'),
+    buildRuntimeCarrier(bootstrapContent, readCarrierSettings(home), options).trimEnd(),
+  )
+  createLink(pkgRoot, join(deepseekDir, 'helloagents'))
+  return true
+}
+
+export function installDeepseekStandby(home, pkgRoot) {
+  return injectDeepseekCarrier(home, pkgRoot, 'bootstrap-lite.md')
+}
+
+export function installDeepseekGlobal(home, pkgRoot) {
+  return injectDeepseekCarrier(home, pkgRoot, 'bootstrap.md', { profile: 'full' })
+}
+
+export function uninstallDeepseekStandby(home) {
+  const deepseekDir = join(home, '.deepseek')
+  if (!existsSync(deepseekDir)) return false
+
+  removeMarkedContent(join(deepseekDir, 'AGENTS.md'))
+  removeLink(join(deepseekDir, 'helloagents'))
+  return true
+}
+
+export function uninstallDeepseekGlobal(home) {
+  return uninstallDeepseekStandby(home)
+}
+
+function runDeepseekCommand(command, args = []) {
+  if (looksLikeCommandPath(command) && !existsSync(command)) {
+    return {
+      ok: false,
+      missing: true,
+      exitCode: null,
+      stdout: '',
+      stderr: '',
+      errorMessage: '',
+      combinedOutput: '',
+    }
+  }
+  const needsShell = process.platform === 'win32' && /\.cmd$/i.test(command)
+  const result = spawnSync(command, args, {
+    encoding: 'utf-8',
+    errors: 'replace',
+    shell: needsShell,
+    windowsHide: true,
+  })
+  const stdout = String(result.stdout || '').trim()
+  const stderr = String(result.stderr || '').trim()
+  const errorMessage = result.error?.message || ''
+  return {
+    ok: result.status === 0,
+    missing: result.error?.code === 'ENOENT',
+    exitCode: typeof result.status === 'number' ? result.status : null,
+    stdout,
+    stderr,
+    errorMessage,
+    combinedOutput: [stdout, stderr, errorMessage].filter(Boolean).join('\n').trim(),
+  }
+}
+
+function tryParseJson(text = '') {
+  if (!text) return null
+  try {
+    return JSON.parse(text)
+  } catch {
+    return null
+  }
+}
+
+function buildDoctorSummary(report = {}) {
+  const skills = report.skills || {}
+  const capability = report.capability || {}
+  const sandbox = report.sandbox || {}
+  const mcp = report.mcp || {}
+  return {
+    version: typeof report.version === 'string' ? report.version : '',
+    configPath: typeof report.config_path === 'string' ? report.config_path : '',
+    skillsSelected: Array.isArray(skills.selected) ? skills.selected : [],
+    mcpPresent: Boolean(mcp.present),
+    sandboxAvailable: typeof sandbox.available === 'boolean' ? sandbox.available : null,
+    resolvedProvider: typeof capability.resolved_provider === 'string' ? capability.resolved_provider : '',
+    resolvedModel: typeof capability.resolved_model === 'string' ? capability.resolved_model : '',
+  }
+}
+
+export function inspectNativeDeepseekDoctor() {
+  const result = runDeepseekCommand(DEEPSEEK_COMMAND, ['doctor', '--json'])
+  if (result.missing) {
+    return {
+      available: false,
+      command: DEEPSEEK_COMMAND,
+      exitCode: null,
+      ok: false,
+      summary: null,
+      note: 'command-not-found',
+    }
+  }
+
+  const parsed = tryParseJson(result.stdout) || tryParseJson(result.combinedOutput)
+  return {
+    available: true,
+    command: DEEPSEEK_COMMAND,
+    exitCode: result.exitCode,
+    ok: result.ok,
+    summary: parsed ? buildDoctorSummary(parsed) : null,
+    parseError: parsed ? '' : (result.combinedOutput ? 'invalid-json' : ''),
+    output: parsed ? '' : result.combinedOutput,
+  }
+}

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

@@ -3,10 +3,10 @@ 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 { readTopLevelTomlLine } from './cli-toml.mjs'
-import { loadHooksWithCliEntry, safeJson, safeRead } from './cli-utils.mjs'
+import { FULL_CARRIER_PROFILE_MARKER, loadHooksWithCliEntry, safeJson, safeRead } from './cli-utils.mjs'
 
 const runtime = {
   home: '',
@@ -78,9 +78,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) {
@@ -219,6 +219,78 @@ 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')
@@ -239,12 +311,13 @@ 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'] : [host]
+  const hosts = host === 'all' ? ['claude', 'gemini', 'codex', 'deepseek'] : [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,6 +7,7 @@ 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([
@@ -18,6 +19,8 @@ const HOST_ALIASES = new Map([
   ['gemini-cli', 'gemini'],
   ['codex', 'codex'],
   ['codex-cli', 'codex'],
+  ['deepseek', 'deepseek'],
+  ['deepseek-tui', 'deepseek'],
 ])
 
 function hasHelloagentsMarker(filePath) {
@@ -28,6 +31,10 @@ 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()
 }
@@ -90,6 +97,26 @@ 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()) || ''
 }
@@ -98,6 +125,7 @@ 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'
 }
 
@@ -105,5 +133,6 @@ 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,6 +12,7 @@ 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');
@@ -81,3 +82,10 @@ export function uninstallGeminiStandby(home) {
 
   return true;
 }
+
+export {
+  installDeepseekGlobal,
+  installDeepseekStandby,
+  uninstallDeepseekGlobal,
+  uninstallDeepseekStandby,
+}