🦞 yzj-reply 开通手册

云之家（yzj）自动回复机器人 · 4 步搞定

适用：金蝶内部同事
1
扫码进入门户
⏱ 30 秒
  1. 浏览器打开 https://itonline.cloud/yzj/
  2. 页面会直接显示一个二维码（无需点任何按钮）
  3. 打开云之家 APP 扫码：首次扫码 = 注册，再次扫码 = 登录（系统自动识别）
  4. 扫码成功后系统自动分配一个端口（10001+），跳转到你的工作台
💡 老用户再次扫码时会看到「欢迎回来，xxx！」提示，2 秒后自动跳转到你的工作台。
2
找到你的云之家 userId
⏱ 1 分钟
  1. 在 admin 后台「首页配置」tab 找到「🔍 查找 ID」按钮
  2. 输入你的名字（比如 周炜），点搜索
  3. 找到你的条目，复制 id 字段（比如 509367ba24ac46fb94fe50e4）
  4. 把 userId 填到首页配置里的 myUserId 字段，点保存
💡 myUserId 是机器人在云之家的唯一身份标识，必填且不可改——填错会导致机器人无法识别消息来源。
3
配置机器人参数
⏱ 2 分钟

在 admin 后台把以下字段填好：

字段填什么说明
myName * 周总 机器人称呼你用的名字（仅作显示，可随意）
myUserId * 509367ba...（从 Step 2 复制） 你的云之家 userId（系统唯一身份）
triggerKeywords 你好, 介绍, 帮助 私聊含这些词才触发（留空 = 全部私聊都触发）
groups []（留空） 想监听的群聊名（从「监控群管理」tab 复制）
knowledgeBase 在「知识库编辑」tab 添加 Q/A 机器人回复的知识来源（支持 MD / Excel）
LLM → SN（API Key） 你的 API Key baseUrl / model 默认已填 MiniMax-M3
💡 没自己的 API Key？先用平台默认 Key 测试，长期用再换。打包备份时 API Key 不会被打入（安全设计）。

点「保存配置」

4
验证机器人
⏱ 30 秒
  1. admin 后台「📊 运行状态」tab → 确认显示「✅ 进程运行中」
  2. 打开云之家 APP，给机器人私聊发一条消息（比如 你好 或 测试）
  3. 看到机器人自动回复 = 链路通畅 ✅
  4. 如果 1 分钟内没回复，检查「⚙️ 设置」tab 里 Cookie 是否有效（点「健康检查」按钮）
✅ 测试通过标志：私聊发「你好」「介绍产品」「活动方案」等任意含 triggerKeywords 的词，都收到机器人回复，即 4 步全部完成。

❓ 常见问题

Q：找不到我的二维码？
A：访问 https://itonline.cloud/yzj/ 页面会直接显示二维码，无需点任何按钮。如果 2 分钟内未扫码，二维码会过期，刷新页面即可。
Q：扫码后跳到奇怪的页面？
A：可能是 myUserId 没填对。回 admin 后台「首页配置」→ 重新查找你的 userId → 保存 → 再扫一次码。
Q：想监听某个群聊？
A：admin 后台「👥 监控群管理」tab 里加群聊名（不是群号），保存后重启 bot 生效。
Q：知识库怎么导入？
A：admin 后台「📚 知识库编辑」tab 支持「导入 MD」「导出 MD」「导入 Excel」「导出 Excel」4 种方式。注意：关键词本身（triggerKeywords）不支持导入导出，只能手动逐个添加。
Q：数据怎么备份？
A：admin 后台「⚙️ 设置」tab →「📦 打包个人数据」会下载 yzj-reply-backup.tar.gz（含配置 + 知识库），不含 API Key（安全设计）。
Q：bot 没反应怎么办？
A：依次检查：①「📊 运行状态」显示「✅ 进程运行中」 ② 私聊消息含 triggerKeywords ③「⚙️ 设置」→「🍪 Cookie 健康检查」通过 ④ 知识库里有匹配内容
Q：端口是固定的还是随机的？
A：系统自动分配 10001 起的空闲端口，用户不需要也不能手动指定。每次启动端口不变（绑在 myUserId 上）。
Q：怎么删除账号？
A：admin 后台「⚙️ 设置」tab →「🗑️ 删除账号」会彻底清除所有个人数据（配置、知识库、Cookie），不可恢复，请提前备份。
🚀 立即开通

点击进入 yzj-reply 门户（首次扫码 = 注册，再次扫码 = 登录）

有问题找 Jeff 🦞 · ITOnline · 2026
粤ICP备2026041089号-1