# 编辑器插件

[Acahti 插件](https://github.com/acahti-ai/acahti-plugin)把编辑器 Agent 需要的一切打包成一次安装：skill、MCP 服务器配置，以及只对 Acahti 远程仓库生效的规则。它本身不提供工具；编辑器中的操作通过 [MCP](/docs/mcp/) 访问实例。[CLI](/docs/cli/) 继续用于 shell 和 Benchyard 任务。

| 宿主 | 包 | 需要设置 |
|---|---|---|
| Cursor | `cursor/` | `ACAHTI_ROOT_URL`，即你的实例地址，末尾不带斜杠。MCP 地址为 `${ACAHTI_ROOT_URL}/mcp` |
| Codex | `codex/` | MCP 端点：先 `codex mcp add acahti --url <instance>/mcp`，再 `codex mcp login acahti`，或使用 `--bearer-token-env-var ACAHTI_TOKEN` |

## 安装

Cursor：在 Agent 输入框中运行：

```text
/add-plugin acahti@https://github.com/acahti-ai/acahti-plugin
```

然后在 Customize → Acahti → Configure 中设置 `ACAHTI_ROOT_URL`（末尾不带斜杠）。也可以直接复制包：

```bash
cp -R cursor ~/.cursor/plugins/local/acahti
```

Codex：从仓库的 marketplace 安装（或用 curl 把 skill 下载到 `~/.codex/skills/acahti`），然后添加 MCP 服务器并完成认证。无需安装 CLI：

```bash
codex mcp add acahti --url https://acahti.example.com/mcp
codex mcp login acahti
# or: codex mcp add acahti --url https://acahti.example.com/mcp --bearer-token-env-var ACAHTI_TOKEN
```

工作区包已经内置了连接：运行它的 setup skill 并完成 OAuth 即可。在 Benchyard 的 shell 任务中，把 ACAHTI_ROOT_URL 和 ACAHTI_TOKEN 放进 Secrets 并配合 CLI 使用，不需要浏览器回调。不要再把 `acahti` 加到编辑器自己的 MCP 配置文件中；每个实例只保留一个连接。

## 插件提供的内容

- **Skill**：一个小型引导程序，调用 `whoami` 并按 `whoami.skill_url` 加载，因此完整的 [skill](/docs/skills/) 始终来自本站。
- **规则**：对推送到 Acahti 的提交检查 Git 作者，以及受保护分支和推送后查看 CI 的习惯。其他远程仓库不受影响。
- **Codex hooks**（可选）：仅作提醒；从不阻止 Git 操作，也不修改 Git 配置。

## 验证

安装后运行 setup。Agent 会引导你完成 OAuth（原生插件）或配置 Secrets（Benchyard shell），然后通过 MCP 或 CLI 调用 `whoami` 和 `inbox`。仅登录网站并不会连接 MCP。

## 面向组织

工作区构建可以内置固定的实例地址，成员只需授权内置的 OAuth 连接。构建中绝不包含凭据。参见插件仓库中的分发指南。