HarnessKit

RealZST/HarnessKit

Stars★ 472

Forks⑂ 49

主语言Rust

分类智能体框架与编排

作者RealZST

License—

增长趋势

周增量

过去 7 天新增 Star

月增量

+33

过去 30 天新增 Star

起始2762026-05-24

净增长+196(71.01%)

最新4722026-10-26

基于 132 天采样数据 · 2026-05-24 → 2026-10-26

社区活跃度

社区活跃 · PR驱动

主仓库近 12 天前更新，18 个 PR 维持社区活跃，核心维护者 RealZST 审核把关质量

数据更新于 2026-10-18 07:13:15

活跃信号偶发性提交

周提交次数

最近 52 周，每周提交次数趋势

PR / Issue 产出

近 30 天 / 近 90 天统计

近 30 天 PR

近 30 天 Issue

近 90 天 PR

近 90 天 Issue

维护者结构独立维护 · RealZST 主导

Top1 占全部95%

Top3 占全部99%

RealZST

632

github-actions[bot]

Orchardxyz

SherlockSalvatore

lishuaibinpublic

HarnessKit：AI 编码 Agent 的全能控制台> 「Claude Code 装 Skill，Cursor 配 MCP，Codex 调 Hooks……每换一个 Agent，就得重新折腾一遍配置？」如果你同时用两个以上的 AI 编程工具，这种碎片化之苦一定不陌生：Skill 的写法每个 Agent 各有一套，配置文件散落在不同的隐藏目录，插件和 MCP 服务器的管理方式完全不同，每次换机器或换项目，所有配置都要手动重建。HarnessKit 正是为解决这个问题而生：它是一个跨平台的统一管理面板，把九种主流 AI 编程 Agent 的扩展、配置、规则、内存和 Hook 全部收拢到一个界面，让你在一个地方完成所有 Agent 的管理工作。---## 一、项目背景：为什么需要 HarnessKitAI 编程工具生态在 2025 年呈现爆发式增长：Anthropic 的 Claude Code、OpenAI 的 Codex、Google 的 Gemini CLI、Cursor、Windsurf、Copilot……每个工具都有自己独特的扩展体系——Skill、MCP Server、Plugin、Hook、Agent-first CLI——但它们的存储路径、配置文件格式、命名约定各不相同。这种碎片化带来三个现实痛点：1. 配置分散难管理：Claude Code 的 Skill 在 `~/.claude/skills/` 下，Cursor 的在 `~/.cursor/plugins/`，OpenCode 又在另一处。想看看自己装了哪些 Skill，得打开三四个目录。2. 跨 Agent 部署繁琐：好不容易找到一个好用的 Skill，想在另一个 Agent 里也装上，需要手动查找该 Agent 对应的配置位置和文件格式，重复劳动。3. 安全盲区：第三方 Skill 和 MCP 服务器本质上是可执行代码，可以读取文件、调用命令甚至访问网络，但大多数 Agent 没有统一的安全审计机制，用户很难判断一个扩展是否可信。HarnessKit 由开发者 RealZST 于 2025 年 3 月创建（Star 增长曲线显示 2026 年加速），Apache-2.0 开源协议，目前支持 9 种主流 AI 编程 Agent，在 GitHub 上已获得 344 Stars，正处于快速增长期。---## 二、核心功能：从安装到审计的全链路覆盖### 2.1 扩展管理（Extensions）HarnessKit 的核心能力是统一管理五种扩展类型：- Skills：Agent 的指令集，决定 AI 的行为风格和工作方式- MCP Servers：Model Context Protocol 服务器，为 Agent 提供外部工具和数据源- Plugins：Agent 的功能插件- Hooks：执行前后的钩子，可干预 Agent 的行为流程- Agent-first CLIs：专为 Agent 设计的命令行工具每种扩展类型都支持跨 Agent 批量部署——同一个 Skill，勾选多个 Agent，点一下按钮就能同时安装到 Claude Code、Codex、Cursor 等多个 Agent 的对应目录。HarnessKit 会自动处理格式差异（JSON/TOML/YAML），不需要用户手动转换。扩展列表页提供信任评分（Trust Score，0-100 分）、权限说明、来源出处，以及详细的审计发现（Audit Findings），让用户对每个扩展的能力边界一目了然。### 2.2 安全审计引擎这是 HarnessKit 最具差异化的功能之一。项目内置了一套基于 Rust 编写的安全审计引擎，包含 18 条静态分析规则，分为六大类：- CLI 规则：检测可能执行危险命令的扩展- 内容规则：识别隐写术、零宽字符、恶意编码等隐匿威胁- MCP 规则：审计 MCP 服务器的权限暴露风险- 权限规则：检测超出必要范围的系统权限申请- Plugin 规则：分析插件代码的潜在安全风险- 共享规则：跨类型通用的安全模式检测审计引擎的核心实现借鉴了 AgentSeal 的去混淆技术，能够检测零宽空格（U+200B）、方向格式化字符（U+202A）、字节顺序标记（BOM）等常被用于隐藏恶意内容的 Unicode 技巧。Trust Score 低于 60 分的扩展会被标记为「需要审核」，帮助用户在安装前做出判断。### 2.3 Kits：打包部署的创新方案Kits 是 HarnessKit 的一个创新设计：用户可以将一套精心配置的 Skill、MCP 服务器、规则和内存文件打包成一个 `.hk-kit.zip` 文件，然后一键部署到任意项目。这解决了两个问题：一是团队内部的配置共享——不同开发者拿到同一个 Kit，就获得完全一致的 Agent 环境；二是项目级配置的版本化管理——每个项目可以有自己独立的 Kit，与全局配置隔离。Kit 打包时会自动计算内容哈希（SHA-256），记录每个扩展的 Git 修订版本号，确保部署的可复现性。### 2.4 Marketplace 生态系统HarnessKit 内置了三合一的市场平台，提供 Trending 榜单和搜索功能，每个 Skill 列表展示描述、安装量和第三方安全审计评分。---## 三、技术架构：Rust + Tauri 的高性能跨平台方案### 3.1 三层架构设计项目采用 Rust Monorepo 组织，分为三个核心 Crate：- `hk-core`（核心库）：包含所有业务逻辑——适配器层（adapter）、审计引擎（auditor）、部署器（deployer）、存储层（store）、包管理（kits）。这是纯 Rust 库，无 UI 依赖，可被其他 Rust 项目直接复用。- `hk-desktop`（桌面应用）：基于 Tauri 框架构建的原生桌面 GUI，支持 macOS 原生 DMG 安装，文件体积小（Rust 编译产物），启动速度快。- `hk-web`（Web 服务）：提供 HTTP API 接口，实现与桌面版完全一致的功能集。通过 `hk` CLI 启动本地 Web 服务，在 Linux 服务器、HPC 集群或无头（headless）机器上使用。这种架构设计意味着：同一套代码，既是桌面 App，又是 Web 服务，还能作为库被集成。Web 模式的实现方式是将 Tauri 的 WebView 替换为本地 HTTP 服务，配合轻量前端即可。### 3.2 适配器模式（Adapter Pattern）适配器层（`crates/hk-core/src/adapter/`）是整个系统的核心抽象。每种 Agent 都有一个对应的适配器文件：`adapter/claude.rs # Claude Codeadapter/codex.rs # OpenAI Codexadapter/cursor.rs # Cursoradapter/gemini.rs # Gemini CLIadapter/windsurf.rs # Windsurfadapter/copilot.rs # GitHub Copilotadapter/antigravity.rs # Antigravityadapter/opencode.rs # OpenCodeadapter/hermes.rs # Hermes Agent`适配器负责将不同 Agent 的文件系统布局、配置文件格式和扩展安装机制抽象为统一的内部模型（`models.rs`）。新增一种 Agent 支持，只需实现对应的适配器，不需要改动核心逻辑。### 3.3 安装路径解析（Paths）每种 Agent 的配置散落在不同的隐藏目录，适配器层的 Paths 模块负责这些路径的发现和解析。例如：- Claude Code：`~/.claude/`, `~/.claude/settings.local.json`- Cursor：`~/.cursor/`, `~/.cursor/mcp.json`- Windsurf：`~/.windsurf/`HarnessKit 自动扫描这些目录，同时也支持用户自定义路径——在 Settings → Agent Paths 中添加任意文件或目录。### 3.4 部署器的安全保障`deployer.rs` 中的文件复制逻辑包含了安全考量：- 使用 `symlink_metadata`（而非 `metadata`）进行 TOCTOU 安全检查，防止竞态条件下的符号链接攻击- 明确跳过 `.git` 目录，防止将 Git 仓库元数据一并打包- 跳过符号链接本身（而非解析后复制），防止链接指向恶意路径---## 四、部署体验：开箱即用的极简安装HarnessKit 不提供 Docker 支持，也没有 Kubernetes 部署方案，但安装过程极其简单：- macOS：下载 DMG 文件（Apple Silicon 或 Intel），拖入 Applications 即可- Linux/Windows：下载对应平台的二进制可执行文件，直接运行安装后无需配置，HarnessKit 会自动检测系统上已安装的 AI 编码 Agent 并扫描其扩展。用户可以在 Settings → Agent Paths 中切换「显示全部」或「仅显示已检测到」两种模式。Web 模式只需运行 `hk` 命令，服务默认启动在本地端口，提供与桌面版功能完全一致的 Web 界面。适合在远程服务器上使用，或通过反向代理（如 Nginx）暴露到内网供团队共享。内存占用极低（实测约 512MB RAM），不需要 GPU，适合作为常驻工具运行在开发机上。---## 五、局限与争议尽管功能丰富，HarnessKit 仍有明显局限：1. 平台锁定：适配器层虽然抽象良好，但新增 Agent 支持需要修改 Rust 代码并发布新版本，普通用户无法自行添加不支持的 Agent。2. Trust Score 的主观性：安全审计基于静态规则，Trust Score 高不代表绝对安全，低于 60 分的扩展也不一定有问题。用户仍需具备基本的安全判断能力。3. 市场平台依赖：Marketplace 功能需要访问 HarnessKit 自建的服务端，若服务不可用，市场搜索和排名功能将受影响。4. GitHub Token 的必要性：GitHub API 请求需要认证令牌，未配置令牌的用户可能无法获取完整的扩展信息和更新检测。---## 六、行业意义与趋势判断HarnessKit 的出现反映了一个正在形成的新范式：AI Agent 的配置管理正在从「手动维护」向「平台化管理」演进。随着 Claude Code、Codex、Cursor 等专业级 AI 编程工具的用户群体扩大，扩展生态（Skill、MCP、Plugin）越来越丰富，分散的配置管理成为制约效率的瓶颈。类比软件包管理的历史——从手工下载 `.tar.gz` 到 apt/npm 的演进——HarnessKit 正在做 AI Agent 领域的「包管理器」工作。从 Star 增长曲线看，2026 年项目进入加速增长期，月增长率达到 62.31%（根据 PIFS 数据），说明随着 Agent 生态持续扩张，这一需求正在被更多开发者认可。未来可能出现类似的标准化组织（如 CNCF 之于云原生），而提前构建这类基础设施的项目将占据先发优势。---总结：HarnessKit 用 Rust+Tauri 构建了一套覆盖 9 种主流 AI 编码 Agent 的统一扩展管理平台，包含安全审计、Kits 打包部署、Marketplace 生态等完整功能，安装简单、运行轻量，适合作为 AI 开发者的常驻效率工具。对于多 Agent 用户而言，它是目前市面上最完整的统一管理方案。

加载项目详情…

本应用为开源项目，仅供学习研究，请遵守其开源协议。

HarnessKit：AI 编码 Agent 的全能控制台> 「Claude Code 装 Skill，Cursor 配 MCP，Codex 调 Hooks……每换一个 Agent，就得重新折腾一遍配置？」如果你同时用两个以上的 AI 编程工具，这种碎片化之苦一定不陌生：Skill 的写法每个 Agent 各有一套，配置文件散落在不同的隐藏目录，插件和 MCP 服务器的管理方式完全不同，每次换机器或换项目，所有配置都要手动重建。HarnessKit 正是为解决这个问题而生：它是一个跨平台的统一管理面板，把九种主流 AI 编程 Agent 的扩展、配置、规则、内存和 Hook 全部收拢到一个界面，让你在一个地方完成所有 Agent 的管理工作。---## 一、项目背景：为什么需要 HarnessKitAI 编程工具生态在 2025 年呈现爆发式增长：Anthropic 的 Claude Code、OpenAI 的 Codex、Google 的 Gemini CLI、Cursor、Windsurf、Copilot……每个工具都有自己独特的扩展体系——Skill、MCP Server、Plugin、Hook、Agent-first CLI——但它们的存储路径、配置文件格式、命名约定各不相同。这种碎片化带来三个现实痛点：1. 配置分散难管理：Claude Code 的 Skill 在 `~/.claude/skills/` 下，Cursor 的在 `~/.cursor/plugins/`，OpenCode 又在另一处。想看看自己装了哪些 Skill，得打开三四个目录。2. 跨 Agent 部署繁琐：好不容易找到一个好用的 Skill，想在另一个 Agent 里也装上，需要手动查找该 Agent 对应的配置位置和文件格式，重复劳动。3. 安全盲区：第三方 Skill 和 MCP 服务器本质上是可执行代码，可以读取文件、调用命令甚至访问网络，但大多数 Agent 没有统一的安全审计机制，用户很难判断一个扩展是否可信。HarnessKit 由开发者 RealZST 于 2025 年 3 月创建（Star 增长曲线显示 2026 年加速），Apache-2.0 开源协议，目前支持 9 种主流 AI 编程 Agent，在 GitHub 上已获得 344 Stars，正处于快速增长期。---## 二、核心功能：从安装到审计的全链路覆盖### 2.1 扩展管理（Extensions）HarnessKit 的核心能力是统一管理五种扩展类型：- Skills：Agent 的指令集，决定 AI 的行为风格和工作方式- MCP Servers：Model Context Protocol 服务器，为 Agent 提供外部工具和数据源- Plugins：Agent 的功能插件- Hooks：执行前后的钩子，可干预 Agent 的行为流程- Agent-first CLIs：专为 Agent 设计的命令行工具每种扩展类型都支持跨 Agent 批量部署——同一个 Skill，勾选多个 Agent，点一下按钮就能同时安装到 Claude Code、Codex、Cursor 等多个 Agent 的对应目录。HarnessKit 会自动处理格式差异（JSON/TOML/YAML），不需要用户手动转换。扩展列表页提供信任评分（Trust Score，0-100 分）、权限说明、来源出处，以及详细的审计发现（Audit Findings），让用户对每个扩展的能力边界一目了然。### 2.2 安全审计引擎这是 HarnessKit 最具差异化的功能之一。项目内置了一套基于 Rust 编写的安全审计引擎，包含 18 条静态分析规则，分为六大类：- CLI 规则：检测可能执行危险命令的扩展- 内容规则：识别隐写术、零宽字符、恶意编码等隐匿威胁- MCP 规则：审计 MCP 服务器的权限暴露风险- 权限规则：检测超出必要范围的系统权限申请- Plugin 规则：分析插件代码的潜在安全风险- 共享规则：跨类型通用的安全模式检测审计引擎的核心实现借鉴了 AgentSeal 的去混淆技术，能够检测零宽空格（U+200B）、方向格式化字符（U+202A）、字节顺序标记（BOM）等常被用于隐藏恶意内容的 Unicode 技巧。Trust Score 低于 60 分的扩展会被标记为「需要审核」，帮助用户在安装前做出判断。### 2.3 Kits：打包部署的创新方案Kits 是 HarnessKit 的一个创新设计：用户可以将一套精心配置的 Skill、MCP 服务器、规则和内存文件打包成一个 `.hk-kit.zip` 文件，然后一键部署到任意项目。这解决了两个问题：一是团队内部的配置共享——不同开发者拿到同一个 Kit，就获得完全一致的 Agent 环境；二是项目级配置的版本化管理——每个项目可以有自己独立的 Kit，与全局配置隔离。Kit 打包时会自动计算内容哈希（SHA-256），记录每个扩展的 Git 修订版本号，确保部署的可复现性。### 2.4 Marketplace 生态系统HarnessKit 内置了三合一的市场平台，提供 Trending 榜单和搜索功能，每个 Skill 列表展示描述、安装量和第三方安全审计评分。---## 三、技术架构：Rust + Tauri 的高性能跨平台方案### 3.1 三层架构设计项目采用 Rust Monorepo 组织，分为三个核心 Crate：- `hk-core`（核心库）：包含所有业务逻辑——适配器层（adapter）、审计引擎（auditor）、部署器（deployer）、存储层（store）、包管理（kits）。这是纯 Rust 库，无 UI 依赖，可被其他 Rust 项目直接复用。- `hk-desktop`（桌面应用）：基于 Tauri 框架构建的原生桌面 GUI，支持 macOS 原生 DMG 安装，文件体积小（Rust 编译产物），启动速度快。- `hk-web`（Web 服务）：提供 HTTP API 接口，实现与桌面版完全一致的功能集。通过 `hk` CLI 启动本地 Web 服务，在 Linux 服务器、HPC 集群或无头（headless）机器上使用。这种架构设计意味着：同一套代码，既是桌面 App，又是 Web 服务，还能作为库被集成。Web 模式的实现方式是将 Tauri 的 WebView 替换为本地 HTTP 服务，配合轻量前端即可。### 3.2 适配器模式（Adapter Pattern）适配器层（`crates/hk-core/src/adapter/`）是整个系统的核心抽象。每种 Agent 都有一个对应的适配器文件：`adapter/claude.rs # Claude Codeadapter/codex.rs # OpenAI Codexadapter/cursor.rs # Cursoradapter/gemini.rs # Gemini CLIadapter/windsurf.rs # Windsurfadapter/copilot.rs # GitHub Copilotadapter/antigravity.rs # Antigravityadapter/opencode.rs # OpenCodeadapter/hermes.rs # Hermes Agent`适配器负责将不同 Agent 的文件系统布局、配置文件格式和扩展安装机制抽象为统一的内部模型（`models.rs`）。新增一种 Agent 支持，只需实现对应的适配器，不需要改动核心逻辑。### 3.3 安装路径解析（Paths）每种 Agent 的配置散落在不同的隐藏目录，适配器层的 Paths 模块负责这些路径的发现和解析。例如：- Claude Code：`~/.claude/`, `~/.claude/settings.local.json`- Cursor：`~/.cursor/`, `~/.cursor/mcp.json`- Windsurf：`~/.windsurf/`HarnessKit 自动扫描这些目录，同时也支持用户自定义路径——在 Settings → Agent Paths 中添加任意文件或目录。### 3.4 部署器的安全保障`deployer.rs` 中的文件复制逻辑包含了安全考量：- 使用 `symlink_metadata`（而非 `metadata`）进行 TOCTOU 安全检查，防止竞态条件下的符号链接攻击- 明确跳过 `.git` 目录，防止将 Git 仓库元数据一并打包- 跳过符号链接本身（而非解析后复制），防止链接指向恶意路径---## 四、部署体验：开箱即用的极简安装HarnessKit 不提供 Docker 支持，也没有 Kubernetes 部署方案，但安装过程极其简单：- macOS：下载 DMG 文件（Apple Silicon 或 Intel），拖入 Applications 即可- Linux/Windows：下载对应平台的二进制可执行文件，直接运行安装后无需配置，HarnessKit 会自动检测系统上已安装的 AI 编码 Agent 并扫描其扩展。用户可以在 Settings → Agent Paths 中切换「显示全部」或「仅显示已检测到」两种模式。Web 模式只需运行 `hk` 命令，服务默认启动在本地端口，提供与桌面版功能完全一致的 Web 界面。适合在远程服务器上使用，或通过反向代理（如 Nginx）暴露到内网供团队共享。内存占用极低（实测约 512MB RAM），不需要 GPU，适合作为常驻工具运行在开发机上。---## 五、局限与争议尽管功能丰富，HarnessKit 仍有明显局限：1. 平台锁定：适配器层虽然抽象良好，但新增 Agent 支持需要修改 Rust 代码并发布新版本，普通用户无法自行添加不支持的 Agent。2. Trust Score 的主观性：安全审计基于静态规则，Trust Score 高不代表绝对安全，低于 60 分的扩展也不一定有问题。用户仍需具备基本的安全判断能力。3. 市场平台依赖：Marketplace 功能需要访问 HarnessKit 自建的服务端，若服务不可用，市场搜索和排名功能将受影响。4. GitHub Token 的必要性：GitHub API 请求需要认证令牌，未配置令牌的用户可能无法获取完整的扩展信息和更新检测。---## 六、行业意义与趋势判断HarnessKit 的出现反映了一个正在形成的新范式：AI Agent 的配置管理正在从「手动维护」向「平台化管理」演进。随着 Claude Code、Codex、Cursor 等专业级 AI 编程工具的用户群体扩大，扩展生态（Skill、MCP、Plugin）越来越丰富，分散的配置管理成为制约效率的瓶颈。类比软件包管理的历史——从手工下载 `.tar.gz` 到 apt/npm 的演进——HarnessKit 正在做 AI Agent 领域的「包管理器」工作。从 Star 增长曲线看，2026 年项目进入加速增长期，月增长率达到 62.31%（根据 PIFS 数据），说明随着 Agent 生态持续扩张，这一需求正在被更多开发者认可。未来可能出现类似的标准化组织（如 CNCF 之于云原生），而提前构建这类基础设施的项目将占据先发优势。---总结：HarnessKit 用 Rust+Tauri 构建了一套覆盖 9 种主流 AI 编码 Agent 的统一扩展管理平台，包含安全审计、Kits 打包部署、Marketplace 生态等完整功能，安装简单、运行轻量，适合作为 AI 开发者的常驻效率工具。对于多 Agent 用户而言，它是目前市面上最完整的统一管理方案。