mimo-workbuddy-connect

将 WorkBuddy 桌面 App 已登录账号中的模型（GLM、DeepSeek 等）以 OpenAI 兼容本地服务 接入 MiMo Desktop / MiMoCode，零配置复用桌面登录态。

WorkBuddy 桌面 App ──读凭据──► mimo-workbuddy-connect ──/v1──► MiMo Desktop
                              └──调用 WorkBuddy 云端──► WorkBuddy 服务

功能

• 开箱即用：检测本机 WorkBuddy 登录态，自动解密凭据
• OpenAI 兼容：/v1/models、/v1/chat/completions（SSE 流式）
• 写入 MiMo 配置：init 自动写入全局 provider
• 图片输入：支持图片的模型会带上 modalities
• 推理参数：reasoning_effort 透传
• 双版本：workbuddy（国内）/ workbuddy-ai（国际）
• 积分查询：credits 命令与仪表盘卡片显示剩余积分 / 套餐余量
• 菜单同步：模型名带倍率与促销徽章，可逐模型显隐
• 本地状态页：http://127.0.0.1:<port>/
• CLI：status / models / credits / menu / doctor / logout / config
• 仅监听 127.0.0.1，/v1 使用本地 bearer key

前置条件

1. 已安装并登录 WorkBuddy 桌面 App（国内版或国际版）
2. Node.js ≥ 20
3. 已安装 MiMo Desktop / MiMoCode

安装

# 免安装
npx mimo-workbuddy-connect init

# 或全局安装
npm install -g mimo-workbuddy-connect

快速开始

# 1) 检测登录 + 拉取模型 + 写入 MiMo provider
mimo-workbuddy-connect init

# 2) 启动桥接（保持运行）
mimo-workbuddy-connect start

# 3) 可选：诊断
mimo-workbuddy-connect doctor
mimo-workbuddy-connect models
mimo-workbuddy-connect status

init 成功后，MiMo 模型选择器中会出现 WorkBuddy 分组（provider id workbuddy）。
保持 start 运行后即可对话。

自动启停（推荐）

不想每次手动启动桥接，装一次跟随守护即可：

mimo-workbuddy-connect autostart

之后 MiMo 打开时桥接自动启动，MiMo 关闭时自动停止，不占用后台资源。
卸载：mimo-workbuddy-connect autostart --remove

想看它运行就用前台模式：mimo-workbuddy-connect daemon

国际版 / 双版本

mimo-workbuddy-connect init --variant workbuddy-ai
mimo-workbuddy-connect init --all
mimo-workbuddy-connect start --all

WorkBuddy AI 若装在非默认目录（如 D:\WorkBuddyAI），会自动从 Windows 卸载注册表定位可执行文件；也可手动指定 MIMO_WB_AI_ELECTRON_BIN。

设为 MiMo 默认模型

mimo-workbuddy-connect init --default

可选：导入 MiMo 插件页技能

包内附带 skills/mimo-workbuddy-connect/。在 MiMo Desktop 的插件页导入该目录后，即可用自然语言完成接入与排障，无需记命令：

• 「把 WorkBuddy 接入 MiMo」
• 「模型列表里没有 WorkBuddy」
• 「WorkBuddy AI 没识别出来」

技能只是操作手册，仍需要本包提供的 init / start 才能真正工作。

命令

| 命令 | 说明 | |------|------| | init | 检测登录、拉模型、写入 MiMo provider | | start | 启动本地 OpenAI 兼容桥接 | | status | 登录状态与配置摘要（--json） | | models | 列出可用模型（--json） | | credits | 查询剩余积分与套餐余量（--all 含已用尽） | | menu | 模型菜单与倍率；--model <id> --hide/--show 切换显隐 | | doctor | 诊断凭据 / 解密助手 / 配置 | | logout | 清除本工具的凭据副本（不动桌面 App） | | config | 显示配置路径与监听地址 |

常用选项：--variant <workbuddy|workbuddy-ai>、--all、--port <n>、--default、--refresh。

积分与模型菜单

# 剩余积分（只列还有额度的套餐）
mimo-workbuddy-connect credits

# 模型菜单：显示名带倍率，✓/✗ 表示是否出现在 MiMo 选择器
mimo-workbuddy-connect menu

# 隐藏某个模型（重新 init 后生效于 MiMo 配置）
mimo-workbuddy-connect menu --model kimi-k3-1 --hide

积分不自动轮询——每次读取都是真实计费查询。仪表盘页 http://127.0.0.1:18790/ 提供「刷新积分」按钮与同样信息。

配置文件

| 文件 | 作用 | |------|------| | Windows：%APPDATA%\mimo-workbuddy-connect\config.json | 端口、apiKey、启用变体 | | 其他平台：~/.config/mimo-workbuddy-connect/config.json | 同上 | | 同目录 .mimo-workbuddy-auth.json | token 刷新副本 | | MiMo 全局配置 mimocode.jsonc | provider.workbuddy 等 |

环境变量：

• MIMO_WB_AUTH_FILE / MIMO_WB_AI_AUTH_FILE — 桌面凭据文件路径
• MIMO_WB_ELECTRON_BIN / MIMO_WB_AI_ELECTRON_BIN — 解密用可执行文件
• MIMO_WB_HOME — 本工具数据目录

HTTP 接口

| 方法 | 路径 | 说明 | |------|------|------| | GET | / | HTML 状态页（账号 / 积分 / 模型） | | GET | /status | JSON 状态（登录 + 积分 + 模型） | | GET | /credits | 积分与套餐余量（?refresh=1 强制刷新） | | GET | /menu | 全部模型含隐藏标记 | | POST | /menu/toggle | {variant, model, visible} 切换显隐 | | GET | /health | 存活检查 | | GET | /v1/models | OpenAI 模型列表（?refresh=1 强制刷新） | | POST | /v1/chat/completions | OpenAI 对话（流式） |

/v1/*、/credits、/menu 需要 Authorization: Bearer <config.apiKey>。

更新内容

• 0.5.0：修复国际版报 11128（自动附带官方会话头，24 个国际模型全部可用）；模型 id 加 cn/ / ai/ 前缀避免两版本串台；仪表盘按版本分组、行首图片图标
• 0.4.x：跟随 MiMo 生命周期自动启停（daemon / autostart）；start 复用已有实例
• 0.3.0：积分显示（按官方口径分组）与模型菜单同步（倍率、徽章、显隐、可用性探测）
• 0.2.x：MiMo 插件页 Skill；修复 --version 版本号
• 0.1.x：首个版本；修复 WorkBuddy AI 安装目录识别

免责声明

• 仅供个人学习研究，复用本人本机 WorkBuddy 登录态
• 依赖 WorkBuddy 非公开接口，上游更新可能导致失效
• 请遵守 WorkBuddy 用户协议；使用风险自负
• 本项目与腾讯 / WorkBuddy / 小米无官方关联

许可证

MIT