项目范围
全局的 skill、MCP server 和设置在所有位置都会被 agent 使用;此外,每个项目还可以有自己的一套配置。切换到某个项目,即可查看和修改该项目的配置。
各个范围显示什么
Section titled “各个范围显示什么”范围选择器位于侧边栏下方,紧邻设置之上。其中包含全局、每个已注册的项目和添加项目…;注册项目之后,还会出现全部范围。HarnessKit 会记住所选的范围,下次启动时保持不变。
- 全局。agent 在所有位置都会使用的配置,即各 agent 主目录中的文件。
- 某个项目。该项目自身的文件,位于项目文件夹中。
- 全部范围。同时显示所有内容。
各个页面跟随范围的方式不同:
- 智能体、扩展和审计只显示当前范围中的内容。
- 工具集在项目范围下只列出安装在该项目中的工具集;在全局和全部范围下显示完整的工具集库。
- 市场会为当前范围中已有该 skill 的 agent 显示对勾标记。在全部范围下,选定安装范围之前,安装在任何范围都计入。
- 概览不跟随范围。它是整台机器的总览,切换范围时其中的数字保持不变。
项目的判定条件
Section titled “项目的判定条件”如果一个文件夹中包含任一受支持 agent 的项目文件或文件夹,例如 .claude、.codex 文件夹或 .mcp.json 文件,它即被视为项目。仅有 AGENTS.md 或 CLAUDE.md 不足以构成项目。
项目在设置 → 项目路径中添加。点击范围选择器中的添加项目…会打开设置,项目路径是其中第二部分。
- 粘贴路径或浏览。粘贴文件夹路径,点击添加。在桌面应用中也可以浏览选择。
- 包含多个项目的文件夹。如果该文件夹本身不是项目,HarnessKit 会在其中查找,并列出找到的项目。勾选需要的项目,点击添加所选。
- 扫描。HarnessKit 会扫描新项目中的扩展和文件,并将其加入范围选择器。
- 丢失。项目文件夹被移动或删除后,该项目标记为丢失。
- 移除。移除项目只会将其从 HarnessKit 的列表中删除,不改动其中的文件。如果它正是当前范围,应用会切换回全局。
见设置。
安装位置取决于安装的入口:
- 安装到智能体。在扩展页面,单个安装和批量安装都有安装范围选择器,默认为当前范围。无需切换范围,即可选择其他项目或全局。在全部范围下必须手动选择。
- 市场、从 Git 安装和从本地安装。安装到当前范围;在全部范围下需要先选择一个范围。
- 工具集。工具集只能安装到项目,不能安装到全局。见工具集。
部分 agent 不支持在项目中安装某些类型的扩展。在扩展详情的安装到智能体中,这类 agent 显示为灰色,并标有 (N/A),鼠标悬停可查看原因。在市场以及从 Git 安装和从本地安装的对话框中,这类 agent 同样显示为灰色。批量安装到智能体会跳过它们,并在结果中标记为该范围不支持。
原地管理文件,以及何时联网 HarnessKit 如何直接编辑各个 agent 自己的目录,以及何时联网。
工具集 将 skill、MCP server、规则和记忆打包,安装到项目中。