WorkBuddy 飞书账号切换(权限问题)与重装指南

📅 2026/7/2 14:45:21 👁️ 阅读次数 📝 编程学习
WorkBuddy 飞书账号切换(权限问题)与重装指南

📌 问题背景

在使用 WorkBuddy 连接飞书时,如果本地环境残留了旧账号的登录信息(Cookies/Token),直接切换新账号可能会导致鉴权失败,提示“无使用权限”或无法获取云盘内容。

解决方案核心:通过 WorkBuddy 彻底卸载飞书 CLI 工具以清除本地缓存,然后重新安装并授权新账号。


🛠️ 操作步骤

第一步:卸载旧的飞书 CLI
  1. 打开 WorkBuddy 对话窗口。
  2. 发送指令或点击按钮:“删除飞书 CLI”
  3. 等待 WorkBuddy 执行卸载程序。
    • 成功标志:系统提示“飞书 CLI (@larksuite/cli) 已成功删除。全局 npm 包已卸载,共移除了 X 个相关包。”

第二步:重新发起安装
  1. 在对话框中发送指令:“帮我安装飞书 CLI”(或点击相应的安装卡片)。
  2. WorkBuddy 会启动配置流程,并提供一个配置链接。
    • 注意:此时不要急着点击,确保你准备好要登录的新飞书账号。
第三步:浏览器授权(关键步骤)
  1. 点击 WorkBuddy 提供的配置链接(通常包含user_code)。
  2. 浏览器将跳转至飞书开放平台授权页。
  3. 重要操作
    • 检查当前浏览器登录的飞书账号是否为你想要绑定的新账号
    • 如果显示的是旧账号,请先在网页版飞书退出登录,或直接在授权页切换账号。
  4. 按照页面指引完成应用配置(选择或创建飞书应用,授权 CLI 访问权限)。
第四步:验证与确认
  1. 回到 WorkBuddy 对话窗口,发送:“已配置”
  2. WorkBuddy 会进行登录验证。此时可能会再次弹出一个授权链接(用于 Device Verification)。
  3. 点击链接,确认授权,并在完成后回复“已授权”
  4. 如果需要读取云盘或知识库,系统可能会请求额外的space:document:retrieve等权限,请同样复制链接完成授权并回复“已授权”。
第五步:检查状态

当看到类似以下的总结表格时,说明切换成功:

  • ✅ CLI 安装 (v1.0.61)
  • ✅ 应用配置
  • ✅ 登录授权 (新用户ID)
  • ✅ Bot 身份 / User 身份 Ready


💡 常见问题排查

Q: 为什么还是提示“无使用权限”?
A:这通常是因为浏览器自动填充了旧账号的 Cookies。

  • 解决方法:在点击 WorkBuddy 给出的链接前,先打开浏览器的无痕模式/隐私模式,或者手动清除飞书域名的 Cookies,确保授权页面加载出来时是未登录状态或正确的新账号状态。

Q: 卸载 CLI 会影响我的飞书客户端吗?
A:不会。这只是卸载了用于命令行交互的开发工具包 (@larksuite/cli),不会影响你电脑上安装的飞书桌面客户端及其聊天记录。