# Skill Hub 接入说明

> **致 AI 助手（WorkBuddy / Claude Code 等）**：请帮当前用户完成公司 Skill Hub 的接入初始化。
> 服务器地址：https://skillhub.jsmingyuanyun.com 。按下方步骤顺序执行，每步完成后再进行下一步。

## 步骤

1. **安装客户端**（用户级，无需管理员；命令名 jsmy，旧版叫 skillhub）：
   - Windows：`powershell -c "irm https://skillhub.jsmingyuanyun.com/api/v1/bootstrap/install.ps1 | iex"`
   - macOS / Linux：`curl -fsSL https://skillhub.jsmingyuanyun.com/api/v1/bootstrap/install.sh | sh`
   - 安装后让用户**重开终端**，运行 `jsmy version` 验证。

2. **登录绑定身份**（浏览器确认，无需手动复制 key）：运行 `jsmy login --server https://skillhub.jsmingyuanyun.com`
   （不带 --key）。终端会显示确认码并尝试打开确认页；请提醒用户在自己的浏览器中登录公司 ERP，
   核对页面上的工号、姓名和确认码后点击「确认发放」。确认通过后，客户端会自动获取凭据并保存在本机；
   输出"已连接并保存配置"即成功。确认码几分钟内有效，过期后重新运行命令即可。
   - 没有自动打开浏览器：让用户手动打开终端打印的确认链接；也可以在 ERP「AI 助手」确认页输入确认码。
   - AI 不要代替用户登录 ERP、索取 ERP 账号密码或读取/转述密钥。浏览器确认不可用时，提示用户联系 Skill Hub 管理员获取适用的登录方式；不要引导用户到 ERP 个人中心查找密钥，也不要让用户把密钥发到对话中。

3. **配置本应用的 mcp.json**：先备份原文件，再合并以下条目（已存在 jsmy 条目则跳过；旧的 skillhub 条目请替换为 jsmy）：
   `{"mcpServers":{"jsmy":{"command":"jsmy","args":["mcp"]}}}`
   位置：Windows `%APPDATA%\WorkBuddy\mcp.json` 或 `~/.workbuddy/mcp.json`；
   macOS `~/Library/Application Support/WorkBuddy/mcp.json`。

4. **安装引导技能**：运行 `jsmy install-guide`，把使用说明技能 skillhub-jsmy 落地到
   WorkBuddy 技能目录（输出 workbuddy-direct 即成功；之前装过旧版同样命令即升级）。

5. **验证**：提示用户重启本应用，之后调用 `hub_whoami` 工具，返回用户名、
   且技能列表里出现 skillhub-jsmy，即接入完成。

## 排障

任一步失败：运行 `jsmy doctor` 自检，按输出修复后重试当前步骤；
连接类问题先确认能访问 https://skillhub.jsmingyuanyun.com/healthz。初始化完成后，
"装技能 / 更新技能 / 发布技能 / 提反馈" 都可以直接对你说。