@agentapprove/opencode

中文文档
0.1.26发布于 2026/11/10SEE LICENSE IN LICENSECommonJS零依赖近 30 天下载 3959

代理批准 OpenCode 的插件 - 批准或拒绝您的 iPhone 和 Apple Watch 的 AI 代理工具呼叫

中文使用文档
文档目录9 节
  1. 为什么代理批准?
  2. 重要
  3. 如何运作
  4. 安装
  5. 手动设置( 高级)
  6. 配置
  7. 所需资源
  8. 支助代理人
  9. 链接

@ agentapprove/ 打开代码

代理核准 用于 打开代码. 批准或拒绝您的iPhone和Apple Watch的AI代理工具呼叫.

为什么代理批准?

  • 可见度 - 看看你的 OpenCode 代理正在从您的移动设备中实时做什么
  • 集中政策 -- 定义您的默认位置( 允许、 拒绝或询问) 并管理工具、 参数和命令的自定义允许列表和拒绝列表
  • 移动核准 - 当需要人类批准时, 由您的 iPhone 或 Apple Watch 以水龙头审查并回复

规矩由你决定 代理批准执行它们.

重要

  • 使用此插件需要有效的代理批准订阅 .
  • 您必须下载 iOS 应用程序, 运行 npx agentapprove,并配对您的设备.
  • 如果未配置一个有效符号,则拒绝权限检查,并在当地打印设置指导.

如何运作

此插件连接到 OpenCode 的事件系统, 以强制执行您的批准政策 :

  • 工具。执行 - 根据您的政策和块评价每个工具调用,直到允许/拒绝
  • 权限。 use - 本地 OpenCode 许可的倒置提示
  • 工具。执行 -- 日志工具完成活动
  • 聊天. 消息 -- 日志用户快速活动
  • 事件/实验.session.compacting -- 日志会话周期和压缩事件

安装

  1. 下载代理批准 从 应用程序存储 7天免费开庭
  2. 运行安装器 在您使用 OpenCode 的每台机器上:
npx agentapprove

安装者处理对接,令牌设置,以及OpenCode插件活化. 在提示要配置代理时选择 OpenCode .

  1. 重新启动打开代码 装入插件

就是这样。 现在将对照您的政策评估工具调用, 并在需要时在您的配对设备上显示批准请求 .

手动设置( 高级)

如果您已经配置了代理批准并只需要添加 OpenCode 插件, 请用 OpenCode 的插件命令安装 :

opencode plugin @agentapprove/[email protected] --global --force

这将安装 npm 插件并更新您的全球 OpenCode 配置 。 如果您需要手动编辑配置, 请确保版本代理核准插件在您的 OpenCode 配置中列出 :

~/.config/opencode/opencode.json

{
  "plugin": [
    "@agentapprove/[email protected]"
  ]
}

重新启动 OpenCode 以激活插件 .

配置

插件行为通过代理批准环境设置在 :

~/.agentapprove/env

设置默认说明
AGENTAPPROVE_TIMEOUT300等待批准答复的秒数
AGENTAPPROVE_FAIL_BEHAVIORaskAPI 无法到达时的默认策略 : allow, (中文(简体) ), deny,或 ask
AGENTAPPROVE_PRIVACYfull在事件日志中存储哪些工具数据 : minimal, (中文(简体) ), summary,或 full
AGENTAPPROVE_DEBUGfalse将调试日志写入 ~/.agentapprove/hook-debug.log
AGENTAPPROVE_AGENT_NAME 编号 : AGENTAPPROVE_OPENCODE_NAMEOpenCode显示此代理的名称
AGENTAPPROVE_E2E_ENABLEDfalse对未批准的事件内容启用端到端加密

所需资源

  • 打开代码运行时间
  • 代理批准iOS应用和主动订阅(每月14.99美元,免费审判7天)

支助代理人

代理批准与OpenCode,OpenClaw,Claude Code,Cursor,OpenAI Codex,Google反重力,VS代码副驾驶,副驾驶CLI,Windsurf,Pi,Hermes,OpenHands等合作. 运行 npx agentapprove 以同时配置多个代理.

版本与发布记录

@agentapprove/opencode 共发布 22 个版本,首次发布于 2026/03/01;过去 12 个月发布了 22 个版本。

版本发布日期距今
0.1.26latest2026/11/10今天
0.1.25beta2026/10/071 个月前
0.1.242026/08/312 个月前
0.1.232026/07/203 个月前
0.1.222026/07/193 个月前
0.1.212026/07/044 个月前

关于 @agentapprove/opencode 的常见问题

@agentapprove/opencode 是什么?

代理批准 OpenCode 的插件 - 批准或拒绝您的 iPhone 和 Apple Watch 的 AI 代理工具呼叫

如何安装 @agentapprove/opencode?

在项目目录运行 npm install @agentapprove/opencode,或使用 pnpm add / yarn add / bun add。

@agentapprove/opencode 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/agentapprove__opencode 是否存在。

@agentapprove/opencode 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@agentapprove/opencode 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@agentapprove/opencode 可以商用吗?

@agentapprove/opencode 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@agentapprove/opencode 的下载量有多少?

根据 npm 官方下载统计,@agentapprove/opencode 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,959 次,日均约 132 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agentapprove/opencode 还在维护吗?

最新版本 0.1.26 发布于 2026/11/10(今天);至今共发布 22 个版本,其中过去 12 个月发布了 22 个;首次发布于 2026/03/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。