workbuddy 是深度集成微信/企业微信生态的执行型智能体，需账号实名绑定且企业开通第三方权限；本地模式受windows权限限制，须指定白名单路径；云端定时任务依赖华北地域scf触发器，且本地与云端运行时环境隔离。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 不是另一个聊天窗口，它是在微信里能遥控你电脑、在云端替你跑定时任务、还能从飞书钉钉里直接抓文件的执行型智能体。它的“懂腾讯生态”，不是指界面风格像微信，而是真正把账号、消息、文件、权限、安全模型都嵌进了微信和企业微信的底层链路里。
为什么 WorkBuddy 登录后总卡在“连接企业微信”这一步
这不是网络问题，而是账号体系没对齐。WorkBuddy 的登录态依赖腾讯统一账号（即微信/QQ 账号），但“连接企业微信”动作实际触发的是企业微信的 OAuth2.0 授权流程，它要求当前微信账号必须已在目标企业微信中完成实名绑定，且该企业已开通「第三方应用」权限。
常见错误现象包括：40018 invalid user、errcode: 40001、页面白屏或反复跳回授权页。
实操建议：
- 确认你用的微信账号，在企业微信管理后台的「通讯录」里存在且状态为“已激活”
- 管理员需进入企业微信管理后台 → 应用管理 → 自建应用 → 找到 WorkBuddy 对应的应用 → 开启「可见范围」并勾选你的部门/成员
- 若使用个人微信（非企业微信）想远程操控本机，应改用
QQ或微信小程序直连模式，跳过企业微信授权环节 - 首次连接失败后，务必清除小程序缓存（微信 → 发现 → 小程序 → 右上角三个点 → 清除缓存），否则重试仍会复现旧错误
本地模式下 readFile 报错 “Access denied” 怎么办
这是 Windows 权限沙箱导致的典型问题。WorkBuddy 本地客户端默认以受限用户身份运行，即使你是管理员，它也无法直接读取 C:UsersXXXDocuments 或 OneDrive 同步目录下的文件——系统级 UAC 和 Windows Defender Application Control 都会拦截。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
实操建议：
- 把待处理文件临时复制到
C:WorkBuddyinbox（该路径被预设为白名单目录） - 在技能配置中显式声明
allowPaths: ["C:\WorkBuddy\inbox"]，避免使用通配符* - Windows 用户务必安装
.NET 6.0 Runtime（非 SDK），否则部分文件 I/O 技能会静默失败，错误日志只显示exit code 2147483647 - 不要尝试用管理员身份右键启动 WorkBuddy.exe——这会破坏与微信小程序的 IPC 通信通道，导致远程指令完全收不到
scheduleTask 在云端模式下不触发，但控制台显示“已创建”
定时任务依赖腾讯云函数（SCF）触发器，而该触发器默认只在华北地区（北京）可用。如果你账号主体注册地在华南或海外，且未手动指定地域，scheduleTask 会被创建但无法绑定有效触发器，表现为“状态正常，但从不执行”。
实操建议：
- 在小程序中进入「定时任务」页 → 点击右上角「设置」→ 显式选择地域为
ap-beijing - 检查任务时间格式是否为 ISO 8601 标准，例如
"2026-04-10T09:00:00+08:00"，不能用中文描述如“每天早上九点” - 免费额度用尽后，
scheduleTask不会报错，只会静默跳过。可在「账户中心 → Credits 使用记录」中确认是否还有余额 - 任务结果默认推送到小程序通知栏；若想转发到微信群，需在任务配置中启用
notifyToGroup并提前在群内输入/workbuddy bind完成群授权
最易被忽略的一点：WorkBuddy 的“本地执行”和“云端执行”不是简单的开关切换，而是两套完全隔离的运行时环境。你在本地模式下调试好的技能包，直接切到云端模式大概率会因缺少 fs、child_process 等 Node.js 原生模块而崩溃——这时候得换用 @workbuddy/cloud-sdk 提供的封装 API。
