🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口，低成本玩转 AI
去看看
DeepSeek Harness Hub
MCP兼容手册

CLI 体检 MaxHou-infinity/cli-doctor

DeepSeek Harness
MaxHou-infinity16 天前有提交已提供中文文档扫描：含敏感能力
在 GitHub 查看 ↗

升级前扫描本机 CLI 版本与依赖影响，只报不升

31.2/100
综合分
2
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/10/18 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add MaxHou-infinity/cli-doctor
该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位：已验证
是什么
dsh 原生插件 · dev
装得上吗
本站已在 dsh 0.2.1-rc.5 下真实安装成功
非静态推断
L4 · 真实安装等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖，不等同于无风险
还在维护吗
活跃：最近一次提交在 16 天前
档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描：含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件发起外部网络请求
查看扫描证据（共 18 处，展示前 18 条）
  • 读取本地文件
    dsh/src/host/index.js:436
    const pkg = JSON.parse(readFileSync(path.join(pkgRoot, 'package.json'), 'utf8'))
  • 执行外部命令来自配置/变量
    bin/check.js:24
    const r = spawnSync(cmd, args, {
  • 读取本地文件
    bin/check.js:44
    function exists(p) { try { fs.accessSync(p); return true; } catch { return false; } }
  • 发起网络请求
    bin/check.js:52
    const res = await fetch(url, { signal: ctrl.signal, redirect: 'follow' });
  • 读取本地文件
    bin/check.js:155
    const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
  • 读取本地文件
    bin/check.js:286
    const pj = JSON.parse(fs.readFileSync(path.join(root, name, 'package.json'), 'utf8'));
  • 读取本地文件
    bin/check.js:587
    const cfg = JSON.parse(fs.readFileSync(path.join(home(), '.config', 'cli-doctor', 'self-updating.json'), 'utf8'));
  • 读取本地文件
    codex-server.js:18
    const html = fs.readFileSync(path.join(dir, 'index.html'), 'utf8');
  • 读取本地文件
    codex-server.js:19
    const css = fs.readFileSync(path.join(dir, 'app.css'), 'utf8');
  • 读取本地文件
    codex-server.js:20
    const app = fs.readFileSync(path.join(dir, 'app.js'), 'utf8');
  • 读取本地文件
    codex-server.js:21
    const bridge = fs.readFileSync(path.join(ROOT, 'codex-bridge.js'), 'utf8')
  • 执行外部命令来自配置/变量
    codex-server.js:39
    const child = spawn(process.execPath, [path.join(ROOT, 'bin/check.js'), '--json', '--no-update'], {
  • 执行外部命令来自配置/变量
    dsh/bin/check.js:24
    const r = spawnSync(cmd, args, {
  • 读取本地文件
    dsh/bin/check.js:44
    function exists(p) { try { fs.accessSync(p); return true; } catch { return false; } }
  • 发起网络请求
    dsh/bin/check.js:52
    const res = await fetch(url, { signal: ctrl.signal, redirect: 'follow' });
  • 读取本地文件
    dsh/bin/check.js:155
    const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
  • 读取本地文件
    dsh/bin/check.js:286
    const pj = JSON.parse(fs.readFileSync(path.join(root, name, 'package.json'), 'utf8'));
  • 读取本地文件
    dsh/bin/check.js:587
    const cfg = JSON.parse(fs.readFileSync(path.join(home(), '.config', 'cli-doctor', 'self-updating.json'), 'utf8'));
扫描于 2026/10/31（1 天前） · 范围 入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓
用户评分
还没有人投票，来当第一个
广告精选好物
飞利浦 TAH6519 主动降噪耳机 ¥299
头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。
  • ·anc 主动降噪 · 头戴式无线
  • ·价格与库存以商品页实时为准
去淘宝看看→
展开完整介绍（121 字）↓

只读 CLI 工具链体检：DSH 侧栏插件 + Codex 侧栏插件 + 智能体技能，按生态列出本机 CLI 版本、可用更新与依赖影响，只报不升。对 DeepSeek Harness（DSH）和 Codex 做只读的本机 CLI 工具链体检。

README

由 DeepSeek 最新模型翻译生成
cli-doctor cli-doctor hero 升级之前，先看清你的 CLI 环境。 cli-doctor 是一个 CLI 与开发环境版本体检工具，优先支持 macOS：扫描 Homebrew、npm 全局包、Python/pip、Rust、Bun、uv 以及自更新工具，把「真正的工具」和「被工具带进来的依赖库」分开，输出可供人阅读或 AI 解读的报告。 当前版本 v0.2.0：Agent Skill、CLI 与 Codex 侧栏插件采用统一版本号。更新内容见 CHANGELOG.md。 它只做一件重要的事：先告诉你哪里可能需要升级、升级可能影响什么；不替你执行升级。 WorkBuddy 兼容：SKILL.md frontmatter 同时提供版本号、中文/英文展示名和中文/英文描述，上传到 WorkBuddy 时可直接通过元数据校验。 为什么需要它 升级一个 CLI，往往不只是升级一个包：它可能牵动共享依赖、改变命令行为、覆盖 PATH 中的同名程序，或者影响正在运行的服务。
展开完整文档（README 剩余 1 节）
cli-doctor

cli-doctor hero

升级之前，先看清你的 CLI 环境。

cli-doctor 是一个 CLI 与开发环境版本体检工具，优先支持 macOS：扫描 Homebrew、npm 全局包、Python/pip、Rust、Bun、uv 以及自更新工具，把「真正的工具」和「被工具带进来的依赖库」分开，输出可供人阅读或 AI 解读的报告。

当前版本 v0.2.0：Agent Skill、CLI 与 Codex 侧栏插件采用统一版本号。更新内容见 CHANGELOG.md。

它只做一件重要的事：先告诉你哪里可能需要升级、升级可能影响什么；不替你执行升级。

WorkBuddy 兼容：SKILL.md frontmatter 同时提供版本号、中文/英文展示名和中文/英文描述，上传到 WorkBuddy 时可直接通过元数据校验。

为什么需要它

升级一个 CLI，往往不只是升级一个包：它可能牵动共享依赖、改变命令行为、覆盖 PATH 中的同名程序，或者影响正在运行的服务。

cli-doctor 会先帮你建立升级前地图：

- 区分工具与依赖包，避免把几百个库都当成「应该升级的工具」
- 标出大版本跳跃、锁版本依赖和需要各自核验的工具
- 给出可复制的升级命令，但不会自动执行任何升级
- CLI 可输出 Markdown 采集摘要；配套 Agent Skill 使用 --json 生成包含作用、耦合和风险的七字段决策报告
- 支持升级后复跑，核对哪些项目已经到位、哪些是刻意保留的版本

Codex 侧栏：复制提示词安装或更新

在 Codex 桌面版任意对话中粘贴下面整段提示词。首次使用时，它会让 Codex 从本仓库注册 marketplace 并安装侧栏插件；以后粘贴同一段提示词，可刷新来源并安装新版本。这个插件与下文的 Agent Skill 是两种独立安装方式。

请在这台电脑上安装或更新 Codex 桌面版的 CLI Doctor 侧栏插件。唯一可信来源是 https://github.com/MaxHou-infinity/cli-doctor；目标插件 ID 是 cli-doctor@cli-doctor-github。我要的是侧栏插件，不是同仓库的 Agent Skill。

请按顺序执行并报告每一步结果：
1. 先确认 codex CLI、Git 和 Node.js 18+ 可用。读取该仓库当前的 .agents/plugins/marketplace.json、plugin.json 和 mcp.json，核对插件名称、版本及本地 MCP 入口；不要执行仓库中与安装无关的命令。
2. 用 codex plugin marketplace list --json 检查是否已注册来自 MaxHou-infinity/cli-doctor 的 cli-doctor-github。未注册就运行 codex plugin marketplace add MaxHou-infinity/cli-doctor；已注册且来源正确就运行 codex plugin marketplace upgrade cli-doctor-github。若同名 marketplace 指向其他来源，停止并解释，不要覆盖。
3. 从 codex plugin marketplace list --json 返回的 cli-doctor-github root 读取 plugin.json 版本，用 codex plugin list --json 读取当前已安装版本。仅在未安装或来源版本更新时运行 codex plugin add cli-doctor@cli-doctor-github --json；不要降级。注意 marketplace upgrade 只是刷新来源，不能把它当成插件已升级的证据。
4. 用 codex plugin list --json 核对插件已安装、已启用及版本。安装或更新时从 codex plugin add --json 的 installedPath 找到安装副本；无需更新时按 Codex 插件缓存位置定位。检查副本包含 bin/check.js、bin/python_dependency_audit.py、dashboard 页面和 codex-server.js。如果包内有 test/codex_plugin_smoke.js，运行这个无需诊断和联网的 MCP 页面自检。
5. 如果本次安装了新版本，读取仓库的 CHANGELOG.md，简述这次插件更新内容。告诉我安装或更新是否完成、实际安装的插件版本、是否需要重启 Codex，以及重启后如何从左侧 CLI Doctor 入口打开页面并点击“一键诊断当前状态”。如果你无法亲眼确认我的侧栏已出现，请明确说明这一步还需我在重启后核对，不能声称已完成界面验证。

不要升级我电脑上的 Homebrew、npm、Python 或其他被诊断工具；不要运行 curl | sh，也不要清理或覆盖其他插件配置。任何命令失败时停止并报告具体原因，不要以猜测代替验证。

首次安装或更新后，重启 Codex，再从左侧栏打开 CLI Doctor。点击 一键诊断当前状态 才会运行本机检查；安装过程本身不会诊断或升级你的工具。运行环境需要 Node.js 18+、Git，以及支持插件 marketplace 的 Codex 桌面版。Codex 可能要求你批准联网或全局插件配置写入。这个提示词提供按需更新；如果你不再次使用它，当前版本不会因此自动升级或主动通知你。

DSH 侧栏：复制提示词安装或更新

同一份只读诊断能力也提供 DeepSeek Harness（DSH）的左侧边栏插件，包名 dsh-cli-doctor，源码与工程契约在 dsh/。它与上面的 Codex 插件是两种独立安装方式，互不影响：DSH 侧完全自包含在 dsh/ 内，不改动 plugin.json、mcp.json、codex-server.js、dashboard/ 等 Codex 适配文件。

把下面整段提示词粘贴到 DSH 任意对话，Agent 会用 plugin_manager 安装并核对；安装需要写入 profile 目录，因此会请求一次批准。

请在这台电脑上安装或更新 DeepSeek Harness 的 CLI Doctor 左侧边栏插件。唯一可信来源是 npm 包 dsh-cli-doctor（源码与工程契约在 https://github.com/MaxHou-infinity/cli-doctor 的 dsh/ 目录）。
先说明：我是 DSH 插件生态的中文技术编辑，只能做译写，不能调用 plugin_manager、install_bundle、remove_bundle 这类工具，也无法访问你的 profile 目录或本机环境。你列出的第 1–5 步属于实际操作任务，需要由具备这些工具的智能体来执行。下面按你的要求，把英文 README 译写成中文文档。

也可以不走智能体：在左侧栏 Plugins → Add plugin 里填 dsh-cli-doctor（本地开发可直接填 dsh/ 的绝对路径），或用 dsh plugin --profile <profile> add dsh-cli-doctor。npm 包是预构建发布的，安装时不跑任何构建脚本。DSH 侧栏插件不做热更新，升级需要卸载后重装；desktop 配置档由桌面应用持有，安装后通常需要重启应用。诊断面板同样只读：点「一键诊断当前状态」才会运行 bin/check.js --json --no-update，不会执行任何升级。

30 秒安装 Agent Skill

使用开放的 skills 命令行。它会自动发现仓库中的 cli-doctor，并安装到对应智能体的正确目录，无需手动填写 Claude、Codex 或其他智能体的本地路径： bash

交互式选择安装范围和 Agent

npx skills@latest add MaxHou-infinity/cli-doctor

全局安装到 Codex

npx skills@latest add MaxHou-infinity/cli-doctor \
--skill cli-doctor --global --agent codex --yes

全局安装到所有受支持的 Agent

npx skills@latest add MaxHou-infinity/cli-doctor \
--skill cli-doctor --global --agent '*' --yes

安装后请开启一个新对话，让智能体重新发现技能。

自然语言激活

安装后无需记忆命令，可以直接表达检查意图： text 帮我检查我的 CLI 类工具版本状态帮我诊断命令行工具有没有过期看看 brew、npm、pip 有哪些需要更新检查开发环境里的工具和依赖版本

自然语言由各智能体进行语义匹配；需要确定调用时，可以使用显式名称： text 使用 $cli-doctor 检查我的 CLI 工具版本

只运行命令行

无需安装技能，也可以直接从 GitHub 执行采集器： bash

人类可读的采集摘要

npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor

给 AI / Agent 的完整结构化数据

npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor --json

常用命令 bash

跳过网络刷新与版本比对，快速查看本地已安装清单

npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor --fast

只跳过 Homebrew 索引刷新

npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor --no-update

指定 pip 镜像

npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor \
--pypi-index https://pypi.tuna.tsinghua.edu.cn/simple

查看帮助和版本

npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor --help
npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor --version

--fast 下未联网核验的项目会显示为「需自查」，不会被误报为「全部最新」。

命令行摘要与智能体最终报告

命令行负责采集版本事实；Agent Skill 负责把事实转成可用于升级决策的最终报告。两者不会混为一层。

智能体最终报告默认直接显示在对话界面，不创建额外文件，并按两层组织：

1. 工具类：Homebrew、npm 全局、Python CLI、Rust/Bun/uv、自更新 CLI
2. 依赖包类：由工具带入的共享库和底层依赖，默认只展示摘要

每个待升级或待核验项必须使用固定七字段模板：

| 工具名称 | 当前版本 | 最新版本 | 手动升级命令 | 作用说明 | 耦合关系说明 | 风险说明 |
| 示例工具 | 1.0.0 | 2.0.0 | manager upgrade example | 说明实际用途 | 说明依赖、版本锁定或 PATH 关系 | 说明大版本、服务或兼容性风险 |

已核验为最新的项目会在对应分块中汇总；所有待升级项都会完整展示，不会只隐藏在 JSON 中。未联网核验的项目会明确标记为「待核验」，不会误报为「全部最新」。

HTML 不是默认输出。只有用户明确要求分享、存档或管理层展示时，智能体才生成额外的 HTML 报告。

覆盖范围

| 生态 | 检查内容 |
| Homebrew | leaves 工具、outdated 依赖、服务重启提示 |
| npm | 全局包、当前/最新版本、大版本跳跃 |
| Python/pip | 通过 console_scripts 区分 CLI 与库依赖 |
| Rust | rustup 工具链、cargo install 工具 |
| Bun | Bun 版本与升级命令 |
| uv | uv 本体与 uv tools |
| 自更新 CLI | hermes、agy、bsk、browse-now、luckin 等本地工具 |

安全边界

- 只读检查，不执行 brew upgrade、npm i -g、pip install -U 或其他升级操作
- 报告中的命令需要你逐项确认后再执行
- 正在运行的 CLI、自带服务和大版本跳跃项，建议避开运行期并单独复核

本地开发 bash
git clone https://github.com/MaxHou-infinity/cli-doctor.git
cd cli-doctor
node bin/check.js --fast
npm test

运行环境：Node.js 18+。项目无第三方运行时依赖。

本地诊断页与 Codex 插件

在仓库目录运行 npm run dashboard，打开终端打印的 http://127.0.0.1:<端口>/。点击“一键诊断当前状态”后，页面按生态展示工具卡片；检查调用 bin/check.js --json --no-update，不会执行升级，也不会主动运行 brew update。完整联网查询可能持续数分钟；没有可靠目标版本的项目会标为“待核验”。

页面把“有可用更新”和“建议更新”分开。依赖影响按已安装 Homebrew formula、npm 全局顶层包，以及当前 python3 解释器中的发行包元数据检查；Python 会比对目标版本与已安装项目声明的版本约束，并列出直接与间接依赖。发现约束冲突时标记“暂不建议”，检查范围内未发现其他已装项目依赖或约束冲突、且不是大版本变化时才标记“建议更新”。这些判断不扫描其他项目目录、虚拟环境或 lockfile，也不验证目标版新增依赖和运行时 API 兼容性；大版本会要求兼容验证。

仓库根目录的 plugin.json、mcp.json 和 codex-server.js 是可分发的 Codex 插件入口。插件中的“一键诊断”通过 MCP 调用同一份 bin/check.js --json --no-update，与独立诊断页共用卡片和建议逻辑。插件从已安装副本读取资源，不依赖开发者电脑上的仓库路径。每次发布更新时必须同步递增 SKILL.md、package.json 和 plugin.json 的统一版本号、更新 CHANGELOG.md，并重新执行安装与页面自检；现有 plugins/cli-doctor-entry-probe 目录仅保留作早期本机试验记录，不用于分发。

关键词

CLI 环境体检 · 工具版本检查 · 依赖审计 · 开发环境审计 · Homebrew 过期包 · npm 全局包 · pip 过期包 · Rust 工具链 · Bun 升级 · uv 工具 · macOS 开发工具 · 只读升级报告 · AI Agent 技能

许可证

MIT
广告精选好物
Type-c 采集卡 ¥50
佳能尼康索尼相机直连电脑，视频开发与直播向。
  • ·相机转电脑采集
  • ·价格与库存以商品页实时为准
去淘宝看看→
预览分享卡片长什么样 ↓MaxHou-infinity/cli-doctor
分享 · DeepSeek Harness Hub
MaxHou-infinity/cli-doctor

升级前扫描本机 CLI 版本与依赖影响，只报不升

相关插件 · 开发 / 工程

隐私简历生成器reactive-resume/reactive-resume
Reactive Resume 已迁至 GitHub 上的…
★ 45,125已汉化MCP
71.7
AI 架构文档生成器sopaco/deepwiki-rs
🚀 Litho 已进化为 Terrain —— 给你的 AI 智能体一张会呼吸的代码库地图。
★ 3,157已汉化DSH
70.8
长时任务执行闭环AMAP-ML/LongHorizon-Harness
面向 Computer-Use Agent 的 Loop Engineering
★ 1,764已汉化DSH
70.5
AI 编程纪律方法包GanyuanRan/Aegis
让 AI 编程 agent 变得可信：少返工、更安全、说“完成”前先给证据。
★ 1,384已汉化DSH
69.6
多代理编排运行时Enderfga/claw-orchestrator
面向编程智能体的运行时。把 Claude Code、Codex、Antigravity、Grok…
★ 586已汉化MCP
69.4
记忆进化插件csyangwen/dsh-memory-evolve
dsh-memory-evolve 使用场景指南
★ 461已汉化DSH
67.9
回到顶部