Agent 对外共享助手（VOKO）
简介
把你的 WorkBuddy Agent 发布给客户、粉丝和朋友，无需安装 WorkBuddy、无需注册，打开分享地址即可使用。
当你已经在 WorkBuddy 中创建了一个很好用的专家 Agent，想把它分享给普通客户、粉丝或朋友时，通常会遇到一个现实问题：对方也要安装 WorkBuddy，并在自己的电脑上完成相应操作。这个过程太复杂了。
VOKO 解决的是 Agent 的“最后一公里”问题。本 Skill 会先自动检测环境、安装 VOKO 与 CodeBuddy CLI，然后一步步引导你完成 Agent 发布。完成后，你会获得一个可以分享的访问地址，外部用户打开后即可与 Agent 对话。
适用场景
- 把这个 Agent 发布出去
- 我想把 WorkBuddy Agent 分享给客户
- 让别人不用安装 WorkBuddy 也能使用
- 给 Agent 生成一个访问地址
- 发布 WorkBuddy 智能体
- 创建 Agent 访客入口
- 怎么让外部用户访问我的 Agent
- 把专家 Agent 放到网页上
- 生成 Agent 短链
- 配置 VOKO
工作流（一键安装 + 分步引导）
第 1 步：环境检测
运行同目录 scripts\status.ps1：
powershell -ExecutionPolicy Bypass -File "<skill>\scripts\status.ps1"
检测项：
- Node.js 是否已安装
- npm 是否已安装
- VOKO 是否已安装
- CodeBuddy CLI 是否已安装
- VOKO 是否已经在运行
- 当前 PowerShell 是否已提升管理员权限
如果 Node.js 或 npm 缺失：
- 脚本会先尝试通过
winget自动安装 Node.js LTS（需要管理员权限，且系统中已安装 winget）； - 如果自动安装成功，刷新 PATH 后继续安装 VOKO；
- 如果自动安装失败（winget 不存在、安装报错或安装后仍无法检测到 Node.js），则给出 Node.js LTS 下载地址：https://nodejs.org/
- 提示用户手动安装完成后重新说“继续配置 VOKO”或“发布 Agent”
- 在未成功检测到 Node.js 和 npm 前，不要继续执行
npm install
第 2 步：自动安装与启动
如果环境满足，运行同目录 scripts\install.ps1：
powershell -ExecutionPolicy Bypass -File "<skill>\scripts\install.ps1"
脚本会自动完成：
- 安装 VOKO：
npm install --global @voko/lite - 安装 CodeBuddy CLI：
npm install --global @tencent-ai/codebuddy-code - 如果 VOKO 未运行，用
Start-Process独立启动voko start - 返回 VOKO 管理页面地址，如
http://localhost:3100
> 注意：
> - 全局 npm 安装需要管理员权限，普通终端可能失败。脚本会自动检测是否已提升权限，未提升时给出警告。
> - voko start 用独立进程启动，避免随 Agent 会话结束被清理。
> - 如果 VOKO 已经在运行，脚本会跳过启动并返回当前地址。
第 3 步：打开 VOKO 管理页面
用浏览器打开脚本返回的地址（如 http://localhost:3100）。
在页面中完成以下必须由用户亲自操作的部分：
- 登录或创建 VOKO 账号；
- 完成邮箱验证；
- 选择要发布的 WorkBuddy Agent；
- 补充并确认 Agent 的公开资料（名称、头像、简介、分类、标签）。
> 必须暂停：在涉及账号、验证码、授权和公开资料确认时，必须停下来让用户亲自完成，不要代替用户读取或发送验证码。
用户完成页面操作后，回复“已完成页面配置”或“继续”，进入下一步。
第 4 步：连接 WorkBuddy 投递通道
如果需要 VOKO 自动把外部访客的消息投递给 WorkBuddy，必须单独完成 CodeBuddy CLI 的登录和授权：
-
在终端执行：
bash codebuddy-code login
按提示完成扫码或授权。 -
在 VOKO 管理页面点击“连通检测”或类似按钮，确认 WorkBuddy Agent 能收到测试消息。
> 注意：WorkBuddy Desktop 的登录状态不能代替独立 CodeBuddy CLI 的登录状态。即使 WorkBuddy Desktop 已登录，首次使用 CLI 时通常仍需单独授权。
第 5 步：获取对外访问地址
Agent 注册成功后，在 VOKO 管理页面找到对应 Agent：
- 复制其聊天短链或对外访问地址；
- 将该地址发送给测试用户。
测试用户不需要安装 WorkBuddy，也不需要注册 VOKO。
第 6 步：正式分享前进行端到端测试
建议使用一台没有安装 WorkBuddy、没有登录 VOKO 的设备进行完整验证：
- 打开分享地址；
- 确认无需注册即可进入；
- 发送一条真实问题；
- 确认 WorkBuddy Agent 收到消息；
- 确认访客页面收到正确回复；
- 检查回复中没有泄露本机路径、账号、密钥、历史会话或其他敏感信息。
只有完成以上闭环，才应对外宣布 Agent 已经可以使用。
手动安装说明（当脚本无法自动执行时）
如果 WorkBuddy 环境不允许直接调用 PowerShell 脚本，可以手动执行：
安装 VOKO
npm install --global @voko/lite
启动 VOKO
voko start
VOKO 默认会打开本地管理页面。如果页面没有自动打开，可以执行：
voko status --json
查看输出中的 port，然后在浏览器访问：
http://localhost:<port>
说明：3100 只是默认端口，不应将它写死为固定地址。
安装 CodeBuddy CLI
npm install --global @tencent-ai/codebuddy-code
核心能力
- 检测 Node.js、npm、VOKO 和 CodeBuddy CLI 的实际状态；
- 环境满足时自动安装 VOKO 与 CodeBuddy CLI；
- 自动启动 VOKO 并返回管理页面地址；
- 使用真实检测结果指导安装与配置；
- 对已经完成的步骤明确提示，无需重复安装；
- 在涉及登录、验证码、授权和公开资料确认时暂停，让用户亲自完成或确认；
- 创建访问地址后提醒用户进行未登录设备的端到端测试；
- 清楚区分“检测到 Agent”“创建了访问地址”和“访客已成功收到回复”。
注意事项与边界
- VOKO 连接的是你本机的 WorkBuddy Agent，因此提供服务期间，承载 Agent 的电脑、VOKO 运行时以及对应的 WorkBuddy 投递通道需要保持可用。
- WorkBuddy Desktop 的登录状态不能代替独立 CodeBuddy CLI 的登录状态。若要让 VOKO 自动将访客消息投递给 WorkBuddy，需要按照引导完成相关组件的安装、登录和真实连通检测。
- 不建议在 Agent 中开放文件删除、任意命令执行、敏感数据读取等高风险能力。发布前应使用专门的测试 Agent 验证对外服务边界。
- 不应未经检测就声称发布成功；
- 不应代替用户读取或发送验证码；
- 不应上传用户未确认的敏感资料；
- 不应将本机路径、密钥、令牌、原生会话 ID 或聊天记录写入公开资料；
- 不应把“WorkBuddy Desktop 已登录”当作“CodeBuddy CLI 已登录”；
- 不应在真实访客消息闭环未通过时宣称 Agent 已经可以对外服务。
版本信息
v1.0.0
- 提供 VOKO 安装和启动指导；
- 增加
scripts/status.ps1环境检测脚本； - 增加
scripts/install.ps1自动安装与启动脚本； - 引导发现并选择 WorkBuddy Agent；
- 引导完成 Agent 公开资料确认和注册；
- 引导获取对外访问地址；
- 提供访客端真实收发验证和隐私检查流程。
相关链接
- VOKO 官网地址：
https://www.vokovoko.com/ - VOKO 项目仓库：
https://github.com/laoyudashu/voko/ - 隐私政策地址：
https://github.com/laoyudashu/voko/blob/main/PRIVACY.md - 用户协议地址：
https://github.com/laoyudashu/voko/blob/main/LICENSE - 技术支持或反馈方式：
1095063159@qq.com
