跳到主要内容

安装

不同编码智能体的安装方式不同。除了 Qoder CLI 可以复用 Qoder Desktop 内置的 版本之外，每个宿主都需要单独安装 Better Harness。安装或更新插件后，请开启 新的会话或任务，让宿主重新加载插件清单。

前置条件​

通过宿主使用 Better Harness 时，请先安装下方任一受支持的编码智能体，并确认它 能够打开要分析的仓库。宿主自身的系统要求和运行时仍然适用；除非对应标签页 明确使用源码检出，否则请按宿主步骤操作，不要运行本仓库的开发环境安装流程。

只有使用独立 CLI、从源码检出运行 Better Harness 或参与本仓库开发时，才需要 Node.js 和 npm。这些路径支持 Windows、macOS 和 Linux，并要求：

  • Node.js >=22.20.0 <25.0.0
  • npm >=10.9.3 <12.0.0

使用独立或源码 CLI 前，请检查当前运行时：

node --version
npm --version

检查并规划生命周期变更​

独立 CLI 提供 Better Harness 安装证据的只读视图。它不会访问远程注册表、 修改宿主配置，也不会执行生命周期计划中的步骤：

better-harness plugin status --host all
better-harness doctor --platform all
better-harness plugin plan install --host qwen --surface cli --scope user
better-harness plugin verify --host qwen --surface cli

计划会保留宿主差异，不会伪造统一的变更路径。Qoder Desktop 为内置分发， Codex Desktop 返回手工 UI 步骤；Cursor 在原生命令合同完成核对前只保留会话级 状态；Pi 缺少当前原生证据的操作为手工或不可用；WorkBuddy 没有可管理的插件 生命周期入口。CLI 不提供 plugin apply 命令。

可以使用 Git 克隆并检查 Cursor manifest，但仅存在 manifest 并不能证明当前 存在受支持的安装路径。

没有找到你的 Coding Agent？

下方六个标签页是已验证的快速开始路径，项目当前共跟踪十个宿主适配器。 请先比较全部适配器的支持边界；如果希望新增或补全 一个集成，再按照新增宿主贡献流程与 PR 示例操作。 开始重复工作前，也可以先查看仓库当前的 Pull Requests。

Claude Code​

把本仓库注册为 Claude Code marketplace：

/plugin marketplace add QoderAI/better-harness

然后安装 Better Harness：

/plugin install better-harness@better-harness

验证安装​

在终端里验证插件可被发现：

claude plugin details better-harness@better-harness

详情中应包含 Skills (1) better-harness。接着在要分析的仓库中开启新的 Claude 会话，运行报告提示词：

/better-harness analyze this project's AI coding workflow and generate an evidence-backed report

Claude Code 默认在仓库的 .claude/better-harness 报告根目录下产出自包含的 report.html，并配套 report.md 与 findings.json。如果只想在对话中查看 结果，可以明确要求 inline 或 no-files 输出。匹配当前工作区的本地 Claude 会话在可用时会被纳入；缺失的证据保持显式标注，不做推断。

下一步​

生成你的第一份报告。如果安装或发现失败，请使用 故障排查中的限定范围检查。