
WorkAny
用 WorkAny 本地智能体生成 PPT、表格与网站
WorkAny 是一款可在本地运行的开源 AI 桌面智能体,用自然语言下达指令即可生成幻灯片、Excel、Word、代码与网站,代码在隔离沙箱中执行。本教程从安装方式、模型与密钥配置讲起,逐步演示如何下达任务、查看实时预览、并行处理多个任务,并给出一个从零生成市场分析 PPT 的完整示例。
WorkAny 是一款可在本地运行的开源 AI 桌面智能体。它的核心价值在于把「说一句话」变成「拿到一个能用的文件」:你用自然语言描述需求,它在本地生成幻灯片、Excel 表格、Word 文档、代码或网站,并在生成过程中实时预览效果。代码类任务在由 Codex CLI 驱动的隔离沙箱中执行,避免直接操作本机环境带来的风险。它适合需要频繁产出文档与表格的办公人群、需要快速搭出代码框架与前端页面的开发者,以及希望把重复性文件整理工作交给智能体处理的个人用户。如果你更想先了解这类桌面智能体的整体定位,可以查看 WorkAny 的工具条目,再回到本文按步骤操作。
需要先说明一点:WorkAny 的 GitHub 版本目前是开发版,需要自行编译可执行文件,并依赖本地的 Node.js 环境。也就是说,它有两种获取路径——下载官方安装包,或者从源码编译。两条路径的准备工作不同,下文会分别说明。
准备工作
确认获取方式
WorkAny 提供两种安装途径,先决定走哪一条,再准备对应的环境:
- 安装包方式:从官网下载对应系统的安装包,覆盖 Windows、macOS、Linux 三个平台。适合不想折腾构建流程的用户。
- 源码编译方式:从开源仓库获取代码,在本机安装依赖并构建。适合需要跟进开发版、或希望自行修改代码的用户。
源码编译方式的环境要求
如果选择源码编译,需要先准备好以下条件:
- 本机已安装 Node.js 环境。构建与启动都依赖它,版本过低会导致依赖安装或构建失败。
- 已安装 Git,用于克隆仓库;也可以直接在仓库页面下载代码压缩包后解压。
- 具备可用的网络环境,能够拉取 npm 依赖。
- 准备好至少一个 AI 供应商的 API 密钥,或本机已有的 Claude Code 订阅。
模型与密钥
WorkAny 支持多家主流 AI 供应商,包括 OpenRouter、Anthropic、OpenAI,可以在应用内自由选择和切换模型。此外它还支持直接复用本地的 Claude Code 订阅套餐,这样不必额外为 API 调用付费。具体支持哪些模型、各供应商的计费方式与配额,请以官网和各供应商的当前信息为准。
通过安装包安装的用户,通常需要在首次启动后进入设置界面填写密钥或完成供应商授权;通过源码编译的用户,则可能在构建前就需要配置环境变量,例如设置 API 密钥或指定要连接的模型。两种方式最终都要落到「应用能调用到一个可用模型」这个状态上。
可选:MCP 与自定义技能
如果计划让 WorkAny 调用外部工具或服务,需要提前准备 MCP(模型上下文协议)服务器的连接信息。若打算沉淀自己的固定工作流,可以规划自定义 Agent 技能,这类技能支持创建与分享。这两项不是跑通基础任务的必要条件,可以先用默认能力验证流程,再逐步扩展。
操作步骤
第一步:获取并安装 WorkAny
路径 A:使用安装包
访问 WorkAny 官网,按你的操作系统选择对应的安装包下载,然后运行安装程序,按提示完成安装即可。安装完成后直接启动应用。
路径 B:从源码编译
先克隆或下载代码到本地,进入项目目录后依次执行依赖安装、构建与启动:
npm install
npm run build
npm start
三条命令分别对应安装依赖、编译代码、启动应用。如果 npm install 阶段报错,优先检查 Node.js 版本与网络连通性;如果 npm run build 失败,先确认依赖是否完整安装成功,再重新构建。
第二步:完成模型配置
启动应用后,进入设置区域完成模型相关配置。需要做的事情包括:
- 选择 AI 供应商(OpenRouter、Anthropic、OpenAI 等)。
- 填入对应的 API 密钥,或选择复用本地已有的 Claude Code 订阅。
- 指定默认使用的模型。
配置完成后建议先发一条最简单的指令验证链路是否通畅,例如让它生成一段说明文字。如果这一步没有响应,先排查密钥是否有效、账户是否有可用额度,再检查网络是否能访问所选供应商的接口。
第三步:用自然语言下达任务
WorkAny 的交互入口就是自然语言输入框。你不需要选择「PPT 模式」或「代码模式」,直接把想要的结果描述清楚即可。素材中给出的典型指令包括:
- 「整理我的桌面文件」——文件整理类任务。
- 「生成一个关于市场分析的 PPT」——幻灯片生成类任务。
- 「创建一个简单的 React 网站」——代码与网站生成类任务。
指令写得越具体,产出越接近预期。建议在指令中明确三件事:产出物类型(PPT、Excel、Word、代码、网站)、主题与内容范围、结构或格式要求(页数、章节、字段、技术栈)。例如不要只说「做个表格」,而要说「生成一个 Excel 表格,列出本月各项支出,包含日期、类别、金额、备注四列」。
第四步:观察实时预览并调整
在生成代码、网站和文档的过程中,WorkAny 会实时展示效果。这意味着你不必等任务全部结束才发现方向不对,可以在过程中即时查看,并进行编辑调整。对于幻灯片和文档类任务,可以据此修正章节顺序与内容侧重;对于网站类任务,可以据此调整布局与组件。
第五步:处理并行任务
WorkAny 支持同时运行多个任务,并可以异步查看各个任务的执行结果。实际使用中,可以把互不依赖的需求拆成多个任务并行推进,例如一边生成市场分析 PPT,一边生成配套的数据表格,再一边搭建展示网站。异步查看的好处是不必守在某个任务前面等待,可以先去处理其他事情,回头再逐个验收。
第六步:按需扩展能力
基础任务跑通后,可以按两个方向扩展:
- MCP 集成:通过模型上下文协议连接外部工具和服务,把 WorkAny 的能力延伸到更多应用场景。
- 自定义技能:创建并分享自定义 Agent 技能,把反复使用的流程固化成可复用的个性化工作流。
此外,应用提供多种主题样式,可按个人偏好调整界面外观。
一个完整示例:从零生成一份市场分析 PPT
下面用一个最小但完整的流程,串起安装、配置、执行与验收。
1. 准备环境
选择安装包方式:从官网下载对应系统的安装包并完成安装。若选择源码方式,则先确认 Node.js 已就绪,然后在项目目录执行:
npm install
npm run build
npm start
2. 配置模型
启动应用后进入设置,选择供应商并填入密钥,或复用本地 Claude Code 订阅,指定默认模型。发一条简短指令确认模型能正常响应。
3. 下达 PPT 生成指令
在输入框中描述需求。相比「生成一个关于市场分析的 PPT」,更完整的写法是:
生成一份市场分析演示文稿,面向管理层汇报。结构包括:行业概况、目标市场规模与增长趋势、主要竞争者对比、我们的机会点、下一步建议。每个部分控制在两到三页,重点数据用图表呈现。
这样的指令明确了受众、章节结构与呈现方式,产出更容易直接使用。
4. 在预览中调整
生成过程中查看实时预览,发现章节顺序不合适或某页内容偏薄时,直接提出修改要求,例如调整章节顺序、补充某一节的论据、把某段文字改为图表。预览与编辑是同一个循环里的动作,不必等全部生成完再返工。
5. 并行补齐配套材料
PPT 主体确定后,可以同时发起两个任务:一个生成配套的 Excel 数据表,一个生成用于内部分享的说明文档。三个任务并行推进,完成后异步查看各自结果。
6. 验收产出
逐个打开生成的文件,核对数据口径、章节完整性与格式一致性。代码类产出还需要在沙箱之外的实际环境中再跑一遍,确认依赖与运行条件匹配。
注意事项
开发版与安装包的区别
GitHub 上的版本目前是开发版,需要自行编译可执行文件,并依赖本地 Node.js 环境。如果你需要稳定使用,优先考虑官网提供的安装包;如果你需要最新特性或打算改代码,再走源码路径。两条路径的功能与配置项可能不完全一致。
沙箱的边界
所有代码都在由 Codex CLI 驱动的隔离沙箱环境中运行,目的是让执行过程安全、可控。这意味着代码类任务的实际执行环境与你的本机环境是隔离的,涉及本机特定路径、本机已安装的私有依赖或需要访问本机服务的任务,可能无法在沙箱内直接完成,需要在沙箱外另行验证。
模型与成本
WorkAny 本身支持多供应商切换,但不同供应商的模型能力、计费方式与配额差异较大,且会随时间调整。复用本地 Claude Code 订阅可以节省成本,但可用范围取决于该订阅本身的条款。所有价格、配额与可用模型,请以官网及对应供应商的当前信息为准。
指令质量决定产出质量
自然语言任务执行依赖对上下文的理解,多步骤工作流尤其如此。指令中缺少约束条件时,智能体会自行补全,结果未必符合预期。把产出物类型、内容范围、结构要求写清楚,是提升成功率最直接的手段。
文件整理类任务的谨慎处理
「整理我的桌面文件」这类指令会涉及对本地文件的分类与移动。执行前建议先确认目标目录,必要时先备份重要文件,避免因分类规则与个人习惯不一致而打乱原有结构。
扩展能力的额外配置
MCP 集成与自定义技能都需要额外的配置与维护成本。建议先用内置能力把日常任务跑顺,确认哪些环节确实需要外部工具或固定工作流,再逐步引入,避免一开始就堆叠过多配置导致排查困难。