将 OpenCode 与 Agent Redactor 搭配使用

先决条件:Microsoft Store 安装 Agent Redactor,或通过 PowerShell 单行命令安装。您还需要安装 OpenCode
  1. 创建配置文件并配置 API 代理

    配置文件 侧边栏中,选择或创建一个配置文件。设置 配置文件名称,选择一个空闲的 本地 URL 端口(例如 8080),输入提供商真实的 转发到 端点(例如 https://openrouter.ai/api/v1),并粘贴您的真实 API 密钥。该密钥在本地加密,永远不会离开您的机器。

    Agent Redactor API 代理部分,包含配置文件名称 OpenRouter Provider、本地 URL localhost:8080、转发到 openrouter.ai/api/v1 以及 API 密钥字段
    配置配置文件。本地 URL 是 OpenCode 将连接的位置,转发到是真实的 API 端点。
  2. 启用 AI 驱动的检测和脱敏规则

    选择您想要脱敏的 PII 类别。您还可以为项目专属机密添加正则规则关键词

    Agent Redactor 显示 AI 驱动检测模型已启用、PII 类别已勾选、统计信息面板以及显示检测到的 PII 的会话脱敏日志
    AI 检测已开启并选中所有类别。会话脱敏日志 面板会显示被拦截的 PII(例如将“Bob”检测为 private_person)。
  3. 打开 OpenCode

    启动 OpenCode。您将看到主界面,包含聊天输入框和当前模型选择器。

    OpenCode 主屏幕显示 New session,包含聊天输入框和显示 Big Pickle 的模型选择器
    OpenCode 主屏幕,包含聊天输入框和模型选择器。
  4. 打开模型选择器

    在聊天输入框中输入 /model 以打开模型选择对话框。您也可以按 Ctrl+' 作为快捷键。

    OpenCode 在聊天输入框中输入 /model,显示模型选择提示
    输入 /model 以打开模型选择器。
  5. 点击“Connect provider”

    在模型选择对话框中,点击右上角的 Connect provider 按钮以添加新的提供商连接。

    OpenCode 模型选择对话框,右上角有 Connect provider 按钮
    点击 Connect provider 以添加 Agent Redactor。
  6. 选择“Custom OpenAI-compatible provider”

    在提供商列表中,滚动到 Other 部分并选择 Custom OpenAI-compatible provider。这使您可以将 OpenCode 指向任何兼容 OpenAI 的端点。

    OpenCode Connect provider 对话框显示提供商列表,其中 Custom OpenAI-compatible provider 位于 Other 部分下
    从 Other 部分中选择 Custom OpenAI-compatible provider
  7. 填写提供商详情

    在自定义提供商表单中输入以下内容:

    • Provider ID: agent-redactor
    • Display name: Agent Redactor
    • Base URL: http://localhost:8080/(必须与 Agent Redactor 中的端口一致)
    • API key: 留空。Agent Redactor 通过请求头管理身份验证
    OpenCode 自定义提供商表单,包含 Provider ID agent-redactor、Display name Agent Redactor 和 Base URL http://localhost:8080/
    填写提供商详情。Base URL 必须与您的 Agent Redactor 代理端口一致。
  8. 添加您的模型并提交

    向下滚动到 Models 部分。输入模型 ID(例如 nvidia/nemotron-3-ultra-550b-a55b:free)和显示名称(例如“Nemotron 3 Ultra”)。点击 Submit 保存。

    OpenCode 自定义提供商表单的 Models 部分,包含模型 ID nvidia/nemotron-3-ultra-550b-a55b:free 和 Submit 按钮
    添加模型并点击 Submit
  9. 选择您的模型

    回到 /model 对话框,搜索“agent”,您会看到您的 Agent Redactor 提供商及其下方的模型。选择它以将所有请求路由到代理。

    OpenCode 模型选择器搜索 agent,显示带 Nemotron 3 Ultra (Free) 的 Agent Redactor 提供商
    搜索“agent”以找到您的 Agent Redactor 提供商并选择模型。
  10. 开始聊天

    发送一条消息。在此示例中,用户说了“My name is Bob”。Agent Redactor 将“Bob”检测为 PII,在转发到 LLM 之前将其脱敏,并在响应中将其还原。

    通过 Agent Redactor 的 OpenCode 聊天,其中名字 Bob 被脱敏并在响应中还原
    “Bob”在发送时被脱敏,并在返回时被透明还原。

验证脱敏

检查 Agent Redactor 中的会话脱敏日志面板,以准确查看被拦截的内容。

Agent Redactor 统计信息显示 Requests: 1, PII: 1,会话脱敏日志显示 PII private_person Bob
统计信息面板显示“Requests: 1, PII: 1”,会话脱敏日志列出带时间戳和类型的被拦截值。
提示:在您的配置文件中使用正则规则关键词,以捕获 AI 模型可能遗漏的项目专属机密,例如内部主机名、专有 ID 或项目代号。