快速开始

Install extension

安装 c-harness

1. 下载扩展安装包

   前往 GitHub Releases， 下载最新版本的 c-harness-*-chrome.zip，然后把 ZIP 完整解压到一个固定目录。

2. 打开 Chrome 扩展管理页

   在地址栏输入 chrome://extensions，打开页面右上角的“开发者模式”。

3. 加载已解压的扩展

   点击“加载已解压的扩展程序”，选择刚才解压的目录。安装后可从扩展详情页进入“扩展程序选项”。

Local environment

准备本地开发环境

c-harness 本身不会直接访问本地文件或执行命令。本指南以 CodexPro 作为本地开发环境 MCP 的示例：它把你明确选择的工作区作为 MCP 服务开放给扩展。CodexPro 要求 Node.js 20 或更高版本。

nvm install 20
nvm use 20
node --version
npm --version

nvm install 20
nvm use 20
node --version
npm --version

Example: CodexPro

示例：初始化工作区并启动本地开发环境 MCP

1. 安装示例服务 CodexPro

   npm install -g codexpro
   codexpro --version

2. 在自定义工作区目录中初始化

   把示例路径替换成你允许网页模型访问的项目目录。Windows 用户继续在 Git Bash 中使用正斜杠路径。

   macOS

   cd /Users/your-name/code/my-project
   codexpro setup --tunnel none --no-auth

   Windows · Git Bash

   cd /c/Users/your-name/code/my-project
   codexpro setup --tunnel none --no-auth

   命令会把当前目录保存为工作区，并明确使用仅绑定本机回环地址的无鉴权本地模式。

   默认键入 Enter 选择推荐配置即可。

3. 以本地模式启动

   以后只需进入同一工作区并运行：

   codexpro start --tunnel none --no-auth

   保持这个终端窗口运行。默认的无鉴权 Streamable HTTP 地址为：

   http://127.0.0.1:8787/mcp

Connect MCP

把本地开发环境 MCP 添加到扩展

1. 打开 MCP 管理

   进入 c-harness 的“扩展程序选项”，在左侧选择“MCP 管理”。

2. 添加服务地址

   本示例在“添加 MCP 服务”中粘贴 http://127.0.0.1:8787/mcp，点击“添加”。该地址使用 Streamable HTTP，无需填写鉴权信息。

3. 确认本地环境识别

   c-harness 会读取 MCP 初始化信息中的 serverName，以忽略大小写的精确匹配识别当前支持的本地开发环境 MCP，而不是根据服务地址或服务 ID 推断。本示例中的 CodexPro 使用 codexpro。识别成功后，模型在文件、本地、工作区、文件目录和本地 Skill 场景会收到使用该服务的提示。

4. 开始网页对话

   打开 DeepSeek 或 Z.ai 的 Chat 模式正常提问。模型需要本地能力时会先读取本地开发环境 MCP 的详情，再请求调用具体 Tool；检查参数后选择仅本次允许、信任当前会话并允许或拒绝。若同时启用了 Skill，模型会先向你确认 Skill 来源，确认前不会发出 Harness 命令。