这是什么
WorkFly 是一个桌面工作台，把消息、邮件、时间表、研发管理、小程序与 AI 助手放在同一处。你可以直接处理日常事务，也可以把查找、整理和重复操作交给助手。
安装
- 到首页安装区，页面会根据当前系统推荐 macOS 或 Windows 版本。
- 复制一键安装命令，或直接下载安装包。
- 首次启动时按系统提示完成安装与权限确认。
WorkFly 目前是实验性项目，仅供内部技术验证。安装前请阅读首页的风险提示，不要对外分发或用于生产环境。
登录与首次进入
启动后使用工作账号登录。登录成功后，左侧是应用入口，顶部可打开搜索与 AI 助手；应用内容显示在中央工作区。
第一次使用建议完成三件事：
- 打开“消息”，确认常用会话可以正常读取；
- 打开“时间表”，确认日历和待办范围正确；
- 在主会话里输入一个只读请求，例如“看看我今天的日程”。
开始一次工作
直接打开应用
从左侧进入消息、邮件、时间表或研发管理。切换应用时，已打开页面会尽量保留当前状态，方便来回处理任务。
用搜索快速到达
使用 Spotlight 搜索应用、联系人或可执行入口。安装的小程序也可以声明 Spotlight 启动方式，在同一位置被找到。
把任务交给 AI 助手
在主会话里直接说清对象与目标，例如：
- “汇总我今天需要处理的研发事项”；
- “找出这周还没回复的重要邮件”；
- “查询我的红火台订单”。
查询类任务可以直接执行；发送、提交、删除等会改变数据的动作会要求你再次确认。未开通或未授权的能力不会出现在助手可调用范围里。
应用与小程序
在“小程序”面板打开已经安装的应用；同一个小程序可以在面板标签中运行，也可以被固定到主侧边栏。
安装包使用 .wfapp.zip 后缀。把文件拖进小程序面板即可开始安装，也可以在 IM 文件卡上点击“安装小程序”。
- Sandbox 完整页运行在隔离 webview 中，只能调用 Manifest 已声明并获准的能力。
- React UI Module用于会话卡或磁贴等宿主 Surface，属于高信任能力，安装前会显示额外风险确认。
只安装来源可信的小程序。需要移除时，从小程序管理入口卸载；卸载会同时清理该应用的私有数据。
连接外部 AI 或终端
WorkFly 可以通过标准 MCP 桥接包 @workfly/mcp，把你明确授权的能力提供给 Claude Code、Codex、Cursor 等外部工具。配置中不需要填写 WorkFly Token；首次实际调用时，客户端会弹出连接授权卡片。
Claude Code：
claude mcp add --transport stdio --scope user workfly -- npx -y @workfly/mcp
Codex / Codex App：
codex mcp add workfly -- npx -y @workfly/mcp
其它支持 MCP 的客户端：
{
"mcpServers": {
"workfly": {
"command": "npx",
"args": ["-y", "@workfly/mcp"]
}
}
}
连接只走本机回环地址。你可以在“设置 → AI 设置 → MCP 连接”查看授权范围或撤销连接；任何写操作仍会逐次确认。
更新
客户端会按当前更新频道检查新版本。Stable 频道只接收已经验证并晋级的版本；Beta 频道可以提前测试新版本。
新版本下载完成后按提示重启。也可以返回首页重新下载安装包。
常见问题
安装后打不开
确认下载的平台与芯片架构正确，重新下载安装包后再试。macOS 或 Windows 出现系统拦截时，按安装页给出的系统提示完成确认。
登录后看不到数据
先确认网络与当前租户，再退出并重新登录。只在某个应用中缺数据时，检查该应用自己的权限与账号范围。
小程序装不上
确认文件名以 .wfapp.zip 结尾，并且客户端版本满足小程序声明的 minClient。高信任 UI Module 还需要在安装时明确确认风险。
AI 助手说没有某项能力
能力可能尚未安装、未授权或不在当前账号范围。先打开对应应用确认能否正常使用，再检查设置中的权限和 MCP 连接范围。
数据保存在哪里
应用数据保存在本机并按登录账号隔离。清理浏览器缓存不会删除小程序包与业务数据；卸载应用或清除对应存储会移除它们。
仍然无法解决
请通过邮件反馈，说明系统版本、客户端版本、出现问题的页面和操作步骤。不要在邮件里发送密码、Token、Cookie 或业务敏感数据。