# @agentguardx/helper-win32-x64 中文文档 规范地址：https://npmcn.com/package/%40agentguardx/helper-win32-x64/ 版本：0\.3\.103 npm 元数据更新时间：2026-11-03T06:49:35.060Z 中文译文更新时间：2026-11-06T16:51:11.597Z 软件包许可：UNLICENSED 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40agentguardx/helper-win32-x64 原文对照：https://npmcn.com/package/%40agentguardx/helper-win32-x64/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：9.9 MB，5 个文件 - TypeScript 类型：未声明 - Node.js 要求：\>=18 - 运行依赖：0 个 - 首次发布：2026-10-23T07:49:56.665Z - 最新版本发布：2026-11-03T06:49:34.895Z - 近 30 天下载量：2697（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：16（近 12 个月 16 个） ## 中文简介 AgentGuard在本地的CLI上签字 ## 安装 ```sh npm install @agentguardx/helper-win32-x64 ``` 也可以使用：`pnpm add @agentguardx/helper-win32-x64`、`yarn add @agentguardx/helper-win32-x64`、`bun add @agentguardx/helper-win32-x64` ## README # AgentGuard 员工接入助手 需要 Node.js 18 或更新版本。企业将包发布到可信 npm 仓库后，可使用： ```sh 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 自动安装属于交互向导步骤。 ```sh 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`）： ```sh 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-x64 是什么？ AgentGuard在本地的CLI上签字 ### 如何安装 @agentguardx/helper-win32-x64？ 在项目目录运行 npm install @agentguardx/helper-win32-x64，或使用 pnpm add / yarn add / bun add。 ### @agentguardx/helper-win32-x64 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/agentguardx\_\_helper-win32-x64 是否存在。 ### @agentguardx/helper-win32-x64 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @agentguardx/helper-win32-x64 可以商用吗？ @agentguardx/helper-win32-x64 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。 ### @agentguardx/helper-win32-x64 的下载量有多少？ 根据 npm 官方下载统计，@agentguardx/helper-win32-x64 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,697 次，日均约 90 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @agentguardx/helper-win32-x64 还在维护吗？ 最新版本 0\.3\.103 发布于 2026/11/03（4 天前）；至今共发布 16 个版本，其中过去 12 个月发布了 16 个；首次发布于 2026/10/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。