让开源，少一点语言距离。
npm包中文文档

@agentguardx/helper-win32-arm64

中文文档
0.3.103发布于 2026/11/03UNLICENSED零依赖近 30 天下载 2665

AgentGuard signed native CLI

原始使用文档
中文原文

AgentGuard 员工接入助手

需要 Node.js 18 或更新版本。企业将包发布到可信 npm 仓库后，可使用：

npx @agentguardx/helper
npm i -g @agentguardx/helper
agentguard init --server https://企业服务器域名

企业私有仓库使用 npx --registry <仓库地址> @agentguardx/helper（见 docs/client/B13_INSTALLATION.md 的发布步骤），也可使用管理员分发的离线 tgz。离线安装时同时安装主包和本机对应的平台包；全局命令仍为 agentguard。包不固定企业服务器地址；可交互填写，或使用 --server / AGENTGUARD_SERVER。支持 HTTP/HTTPS；HTTP 每个新服务器先明确确认明文风险，确认前不发送令牌。本版包含 WorkBuddy Hook 向导安装、独立配置核验与退出清理；公开发布状态以 npm registry 为准。

npx 即用不会创建全局 agentguard 命令；后续使用 npx @agentguardx/helper launch opencode（OpenCode 已原生接入时也可直接运行 opencode）、npx @agentguardx/helper uninstall，或全局安装后使用短命令。

向导先显示当前服务器地址（优先级：--server 参数 > 环境变量 AGENTGUARD_SERVER > 上次保存的配置）作为默认值：回车沿用，也可直接输入别的 IP 或域名；输入后重新校验 /client/v1/config，HTTP 只提示一次明文风险。已有登录属于旧服务器时，向导提示需要重新登录，并在你确认后先退出旧登录（撤销旧令牌、恢复已接入工具配置）；旧令牌绝不会发给新服务器。命令行同样可用：agentguard server show 查看当前地址，agentguard server set <地址> 修改（加 --switch 同时退出旧登录并恢复工具配置；旧服务器无法访问时可再加 --local-only，只清除本机登录，旧令牌在服务端仍有效直到到期或由管理员撤销）。

登录方式为“浏览器网页授权”（agentguard login）：命令行在本机回环地址开一次性回调，打开控制台 /client-authorize 授权页，由控制台当前登录的人点“授权”，成功后显示“已登录为 姓名（账号）”。无浏览器时命令行会打印授权链接，须在本机浏览器打开（回调只监听 127.0.0.1）。也可以隐藏输入个人令牌。令牌只通过匿名标准输入交给 Go 核心，经网关校验后写系统钥匙串，不进入命令行或普通配置文件。方向键移动，空格多选已检测的工具，Enter 确认；配置完成后显示实际 doctor 结果。

企业对话正文留存不要求员工告知或确认，向导不展示告知步骤、不提交已读；正常对话不会因告知流程被阻断。留存开启仍须独立双审，正文访问按当前角色与服务端审批结果执行，平台管理员可审核本人申请；正式环境默认关闭。

支持入口为 OpenCode、WorkBuddy（自定义模型写入 ~/.workbuddy/models.json、远程 MCP 写入 mcp.json，本机安全 MCP 为 agentguard_local；对话需在应用内选“AgentGuard / …”模型）、OpenClaw、Cursor 远程 MCP 及 Cherry Studio 手动说明（Claude Desktop 向导不再提供，2026-10-23 用户决定）；厂商原生实测范围以企业兼容记录为准。Codex 暂缓，Gemini、Claude Code、Claude Desktop 不接入。B15 为 OpenCode 同时注册本机安全 stdio MCP，并写入关闭自带本机工具的配置；仅经 ag_* 入口的调用由服务端逐次授权、执行上报和输出检查。其他厂商未验证关闭原生工具时，其自带本机终端、文件操作不受该 MCP 管控。客户端可被员工修改的边界不等同操作系统强制隔离。

WorkBuddy 向导会在模型/MCP 接入成功后，增量安装 settings.json 中的 PreToolUse、PostToolUse、PostToolUseFailure Hook，再独立读回核验；WORKBUDDY_CONFIG_DIR 可指定目录。保留已有模型、MCP、其他 Hook 和未知设置。安装失败、配置被修改或状态无法核验时，模型/MCP 接入保留，向导显示 Hook 未完成并以非零状态结束，不自动重试或覆盖。Windows 当前不支持 Hook 安装，向导单独提示未完成；macOS 已有隔离验证，Linux 尚未做 WorkBuddy 宿主实机验证。

管理员须先部署对应的 WorkBuddy Hook 网关接口、工具登记与规则，并为其他 MCP 配置精确工具映射；未知工具会拒绝。Hook 配置核验不代表宿主已经加载，也不代表工具调用已通过真实验收；需另做允许/拒绝与服务异常测试。WorkBuddy 后置 allow 仍可能覆盖拒绝，Hook 未加载也不能保证停止执行，当前不是不可绕过的受控执行模式。

手工检查与修复入口如下；自定义助手目录时，在 workbuddy-hooks 前加 --config-dir <目录>。用户修改过的 Hook 不会被覆盖；先核对 status 和应用设置，确需重装时再执行 remove、install。connect workbuddy 命令本身只配置模型/MCP，Hook 自动安装属于交互向导步骤。

npx @agentguardx/helper workbuddy-hooks status
npx @agentguardx/helper workbuddy-hooks remove
npx @agentguardx/helper workbuddy-hooks install

disconnect workbuddy、退出登录、切换服务器及 uninstall 会按保存的绝对路径移除助手拥有的 Hook，保留其他 Hook 和用户修改并提示；无模型连接记录时也会清理独立安装的 Hook。若归属记录无效或配置无法安全修改，不会把清理报告为成功。Hook 和本机 MCP 保存 Node 与 npm 启动器的绝对路径；npx 缓存被清理后需重新接入，不能保证缓存永久存在。Hook 每次执行仍经过 npm 验签入口，启动失败转换为明确拒绝；这不覆盖宿主未加载 Hook 的情形。

启动器每次执行 Go 核心前，使用内置固定公钥验证 originless npm 清单的 RSA-3072/SHA-256 签名，再检查平台二进制与 macOS 钥匙串 helper 的大小和 SHA-256。验证失败拒绝执行，不下载替换公钥。

卸载先执行 agentguard uninstall，确认配置恢复、令牌撤销和钥匙串清理后，再执行 npm rm -g @agentguardx/helper。直接 npm 卸载不会清理用户数据；preuninstall 仅作提示，部分 npm 版本不会运行卸载生命周期，不能依赖该提示代替清理。

离线安装若将主包与平台 tgz 同时全局安装，npm 可能把平台包登记为显式根依赖。移除主包后若该平台包仍在，请同时 npm rm -g @agentguardx/helper-<平台>-<架构>；正常 registry 安装的 optional 依赖由 npm 管理。卸载检查只确认命令消失和用户凭据/配置清理，不声称清空全部 npm 缓存。

Claude Desktop 的 stdio 桥接保存当前 Node 程序与主包启动器的绝对路径，复用同一个执行前验签入口，再由 Go 自行复核自身和 helper。若清理了对应 npx 缓存，或原 Node 路径已失效，须重新接入；可全局安装后再接入，不能保证 npx 缓存永久保留。

本机安全工具命令（全局安装示例；仅 npx 使用时替换为 npx -- @agentguardx/helper）：

agentguard connect opencode   # 原生模式（默认）：把 OpenCode 默认模型设为 AgentGuard，之后直接运行 opencode 即可
agentguard connect opencode --launch-only   # 旧方式：不改默认模型、不落地令牌，只能经 launch 启动
agentguard launch opencode    # 仍可用，令牌只交给本次子进程
agentguard connect workbuddy  # WorkBuddy：把授权模型写入 models.json、远程 MCP 写入 mcp.json（令牌字面写入，0600；disconnect/logout 精确移除）
agentguard disconnect opencode   # 恢复原默认模型，删除写入的令牌
agentguard mcp serve
agentguard pause
agentguard resume
agentguard activity

OpenCode 原生模式的令牌与 GLM 编程助手同类，写入 OpenCode 自己的 auth.json（键 agentguard，0600，保留其他条目）和 AgentGuard 配置目录下 0600 的令牌文件（供远程 MCP 请求头的 {file:} 引用）；opencode.json 不含令牌。disconnect、uninstall、logout 会清除这些副本并恢复原 model/small_model。

mcp serve 的 stdout 专用于 stdio MCP 协议，工作根固定为进程启动目录，不接受模型自报身份或 root。pause 是本机应急停用，不是企业级一键暂停，也不能撤回已发生的副作用。

版本与发布记录

@agentguardx/helper-win32-arm64 共发布 16 个版本，首次发布于 2026/10/23；过去 12 个月发布了 16 个版本。

版本发布日期距今
0.3.103latest2026/11/034 天前
0.3.1022026/11/034 天前
0.3.1012026/11/034 天前
0.3.1002026/11/034 天前
0.3.992026/11/025 天前
0.3.982026/10/2513 天前

关于 @agentguardx/helper-win32-arm64 的常见问题

@agentguardx/helper-win32-arm64 是什么？

AgentGuard signed native CLI

如何安装 @agentguardx/helper-win32-arm64？

在项目目录运行 npm install @agentguardx/helper-win32-arm64，或使用 pnpm add / yarn add / bun add。

@agentguardx/helper-win32-arm64 支持 TypeScript 吗？

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

@agentguardx/helper-win32-arm64 需要什么版本的 Node.js？

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

@agentguardx/helper-win32-arm64 可以商用吗？

@agentguardx/helper-win32-arm64 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

@agentguardx/helper-win32-arm64 的下载量有多少？

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

@agentguardx/helper-win32-arm64 还在维护吗？

最新版本 0.3.103 发布于 2026/11/03（4 天前）；至今共发布 16 个版本，其中过去 12 个月发布了 16 个；首次发布于 2026/10/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。