Skip to content

宿主支持 ​

Harnessmith 当前为七类 Coding Agent 提供 Adapter。Adapter 负责路径与文件格式适配,不会替代宿主自身的 模型循环、工具调度、sandbox 或权限批准。

宿主--agent默认规则入口范围与激活
Codexcodex${CODEX_HOME:-~/.codex}/AGENTS.md全局;宿主默认
Cursorcursor<project>/.cursor/AGENTS.md 与 rules/agent-harness.mdc项目;MDC always
Claude Codeclaude(别名 claude-code)${CLAUDE_CONFIG_DIR:-~/.claude}/AGENTS.md 与 CLAUDE.md全局;宿主默认
OpenCodeopencode${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-~/.config}/opencode}/AGENTS.md全局;宿主默认
Kimi Code CLIkimi(别名 kimi-code)${KIMI_CODE_HOME:-~/.kimi-code}/AGENTS.md全局;宿主默认
DeepSeek Harnessdeepseek(别名 dsh、deepseek-harness)${DSH_HOME:-~/.dsh}/AGENTS.md全局;宿主默认
Pi Agentpi(别名 pi-agent)${PI_CODING_AGENT_DIR:-~/.pi/agent}/AGENTS.md全局;宿主默认

可以用机器可读输出核对当前版本的 Adapter 声明:

bash
npx harnessmith capabilities --json

全局宿主与项目宿主 ​

全局 Adapter 将个人规则与 Harness Runtime 安装到宿主约定的用户目录。Cursor Adapter 则写入明确授权的 项目根;省略 --project 时使用当前工作目录。所有路径会先做 containment 与 symlink 检查。

每个入口同目录还会包含 agent-harness/ 和 .harnessmith/install.json;Cursor 的记录位于 .cursor/.harnessmith/。 环境变量解析、目标文件名和迁移兼容属于外层 Adapter,分发模板保持宿主中立。如需判断本机实际目标,优先运行 --dry-run --json,不要仅依据文档猜测。

Cursor 只把 Harnessmith 自己管理的文件写入 repository-local Git exclude 与 .cursor/.ignore,不会隐藏或覆盖团队已有的 整个 .cursor/ 目录。Kimi Adapter 面向当前 TypeScript/Node.js 实现的 Kimi Code CLI,并使用 KIMI_CODE_HOME;它不接管 旧 Python kimi-cli 使用的 ~/.kimi/ 目录。DeepSeek Adapter 面向官方 dsh / @deepseek-ai/dsh,只托管用户全局 $DSH_HOME/AGENTS.md;项目根/嵌套候选、权限与 sandbox 仍由宿主负责。Pi Adapter 面向官方 @earendil-works/pi-coding-agent,只托管用户全局 $PI_CODING_AGENT_DIR/AGENTS.md(默认 ~/.pi/agent/AGENTS.md)。PI_CODING_AGENT_DIR 同时是 Pi 的可写状态目录(sessions/settings/auth), Harnessmith 只写入指令文件、Runtime 与 .harnessmith/install.json 元数据。Pi 没有内建权限系统,以用户进程权限运行;如果同目录存在 AGENTS.override.md,Pi 会用它替代 AGENTS.md。当前未锁定特定 Pi 版本——Pi 迭代迅速,兼容性声明基于 AGENTS.md 加载契约而非特定 revision。

DeepSeek 兼容性仅针对已验证 revision 声明:@deepseek-ai/dsh@0.1.1-rc.2、 @deepseek-ai/dsh-agent-instructions@0.1.1-rc.2、上游 tag dsh-v0.1.1-rc.2(commit b150a551b8d465e31e418e1b2eaf5e79bbb7d28e)。developer preview 下其他版本在重新验证前不视为已支持。完整边界见 架构设计 — DeepSeek Harness 契约来源与验证边界。

支持状态如何解释 ​

“支持”表示该 Adapter 已实现安装生命周期、能力描述和自动化回归;不表示每个宿主版本都完成了真实运行评测。 逐项声明与证据路径以仓库中的 capability-evidence.yaml 为准。真实 Host Eval 与发布门禁的限制见证据与评测。

Released under the MIT License.