跳转到内容
EN

项目范围

全局的 skill、MCP server 和设置在所有位置都会被 agent 使用;此外,每个项目还可以有自己的一套配置。切换到某个项目,即可查看和修改该项目的配置。

范围选择器位于侧边栏下方,紧邻设置之上。其中包含全局、每个已注册的项目和添加项目…;注册项目之后,还会出现全部范围。HarnessKit 会记住所选的范围,下次启动时保持不变。

  • 全局。agent 在所有位置都会使用的配置,即各 agent 主目录中的文件。
  • 某个项目。该项目自身的文件,位于项目文件夹中。
  • 全部范围。同时显示所有内容。

各个页面跟随范围的方式不同:

  • 智能体、扩展和审计只显示当前范围中的内容。
  • 工具集在项目范围下只列出安装在该项目中的工具集;在全局和全部范围下显示完整的工具集库。
  • 市场会为当前范围中已有该 skill 的 agent 显示对勾标记。在全部范围下,选定安装范围之前,安装在任何范围都计入。
  • 概览不跟随范围。它是整台机器的总览,切换范围时其中的数字保持不变。

如果一个文件夹中包含任一受支持 agent 的项目文件或文件夹,例如 .claude、.codex 文件夹或 .mcp.json 文件,它即被视为项目。仅有 AGENTS.md 或 CLAUDE.md 不足以构成项目。

项目在设置 → 项目路径中添加。点击范围选择器中的添加项目…会打开设置,项目路径是其中第二部分。

  • 粘贴路径或浏览。粘贴文件夹路径,点击添加。在桌面应用中也可以浏览选择。
  • 包含多个项目的文件夹。如果该文件夹本身不是项目,HarnessKit 会在其中查找,并列出找到的项目。勾选需要的项目,点击添加所选。
  • 扫描。HarnessKit 会扫描新项目中的扩展和文件,并将其加入范围选择器。
  • 丢失。项目文件夹被移动或删除后,该项目标记为丢失。
  • 移除。移除项目只会将其从 HarnessKit 的列表中删除,不改动其中的文件。如果它正是当前范围,应用会切换回全局。

见设置。

安装位置取决于安装的入口:

  • 安装到智能体。在扩展页面,单个安装和批量安装都有安装范围选择器,默认为当前范围。无需切换范围,即可选择其他项目或全局。在全部范围下必须手动选择。
  • 市场、从 Git 安装和从本地安装。安装到当前范围;在全部范围下需要先选择一个范围。
  • 工具集。工具集只能安装到项目,不能安装到全局。见工具集。

部分 agent 不支持在项目中安装某些类型的扩展。在扩展详情的安装到智能体中,这类 agent 显示为灰色,并标有 (N/A),鼠标悬停可查看原因。在市场以及从 Git 安装和从本地安装的对话框中,这类 agent 同样显示为灰色。批量安装到智能体会跳过它们,并在结果中标记为该范围不支持。