Office 文档
让 Halo 用内置的文档技能生成和修改 Word、Excel、PowerPoint 和 PDF 文件，不用另装任何软件；文件保存在工作区文件夹里，多数可以直接在画布中预览。
直接对 Halo 说
把这些数据做成 Excel，再出一份 Word 总结和 5 页 PPT
Halo 会读你给的数据，依次做出 .xlsx、.docx 和 .pptx 三个文件，放进当前工作区的文件夹，并在回复里告诉你文件名。
前提：无。文档技能和运行环境都随 Halo 安装好了。
做一份新文档
Halo 自带 4 个文档技能，你说要什么文件，AI 会自己选用对应的技能，不需要点名。
| 你要的文件 | 技能 | 能做的事 |
|---|---|---|
Word（.docx） | docx | 新建报告、备忘录、信函、合同；读取和总结；替换文字、填模板 |
Excel（.xlsx、.csv、.tsv） | xlsx | 从数据或从零新建表格；读取和总结；改单元格、公式和格式；整理杂乱数据；格式互转 |
PowerPoint（.pptx） | pptx | 新建演示文稿；读取文字和备注；修改已有幻灯片；填模板 |
PDF（.pdf） | pdf | 读取文字；合并、拆分、旋转页面；加水印；填表单；新建 PDF；查看页数、元数据和表单字段 |
这些技能在 Halo 自带的运行环境里执行，你不需要安装 Office、Node.js、npm 或 Python。
- 打开要放文件的工作区。想把文件归到某个项目里，先切到那个项目的工作区。
- 在输入框里说清楚要什么文件、多少页、什么风格，例如：「帮我做一份 5 页的 PPT，介绍下季度部门工作计划，风格简洁」。按 Enter 发送。
- 等 AI 做完。做 Office 文件比纯文字回复慢一些，期间你可以继续补充要求，AI 做完当前这一步就会看到。
- 回复里出现文件名。点它，文件在右侧画布中打开；需要改的地方，直接接着说「第 3 页换成表格」之类。
没提样式要求时，技能会按内置的设计规范排版：Word 有统一的标题层级和带样式的表格，PPT 从 5 套设计风格里选一套贯穿全篇，Excel 的表头着色并冻结首行。
完成
回复里有新文件的名字，点开能在画布中看到内容（PPT 除外，见在画布中预览）。在 文件 列表里双击它，会用系统默认的应用（如 Word、WPS、PowerPoint）打开。
修改已有文档
先让 AI 拿到文件，再说要改什么。
- 把文件交给 AI，三种方式任选：
- 点输入框的 ＋ › 文件和文件夹，选中电脑上的文件。桌面版里 AI 直接读取原位置的文件，不会复制。
- 文件已经在工作区里：在输入框输入
@加文件名，从 文件 分组里选；或者把文件从右侧 文件 列表拖进输入框。 - 在网页版或安卓 App 里，＋ › 文件 会把文件上传到工作区文件夹（单个文件最大 100 MB）。
- 说出要改的内容，例如：「把这份合同里的“甲方”全部换成“示例公司”」「在这张表最后加一行合计」。
- 想保留原件，就说一声「另存一份，不要覆盖原文件」。
附加文件和 @ 的完整用法见文件和图片。
文件保存在哪里
AI 做的文档默认保存在当前工作区的文件夹里：
| 工作区 | 文件位置 |
|---|---|
| 你新建的工作区 | 这个工作区的工作目录（新建时选的默认位置或自定义文件夹） |
| Halo 工作区 | Halo 为它准备的专用文件夹；在 管理工作区 页的 Halo 工作区卡片上点 在文件夹中显示 可以打开 |
找到文件的办法：
- 点回复里的文件名，直接在画布中打开。
- 点顶栏的 展开工作区资源，在 文件 标签页里找。列表会自动刷新，新文件出现时不用手动刷新。单击预览，双击用系统应用打开。
INFO
文件 列表里的 新 / 改 标记只跟踪 AI 用文件编辑工具写入的文件。Office 文档是技能运行脚本生成的，不一定带这个标记，也不会计入回复下方的「修改了 N 个文件」。找文件时以回复里的文件名为准。
列表、画布标签页和右键菜单的用法见文件与画布。
在画布中预览
在画布里打开的 Office 文档都是只读的。要改内容，告诉 Halo，或者用系统应用打开后自己改。
| 文件类型 | 画布里看到的 | 说明 |
|---|---|---|
Word（.docx） | 按页面渲染的文档 | 只读 |
Excel（.xlsx、.xls） | 表格，底部切换工作表，支持合并单元格 | 只读；每个工作表最多显示 20,000 行 × 256 列，超出时提示「大型工作表 — 仅显示部分视图」 |
PDF（.pdf） | 桌面版用内置的 PDF 阅读器；网页版和安卓 App 有翻页、25 %–400 % 缩放和 适应宽度 | 只读 |
PowerPoint（.pptx） | 不渲染，显示「暂不支持预览演示文稿」 | 点 在外部应用中打开（桌面版）或 下载 |
旧格式 .doc、.ppt | 不在画布中打开 | 直接用系统应用打开（网页版为下载） |
.docx、.xlsx、.xls、.pptx、.pdf 超过 25 MB 时不预览，请用系统应用打开。在网页版和安卓 App 里，这些文档在 文件 列表中始终带一个下载按钮。
内置文档技能
docx、xlsx、pptx、pdf 和一个诊断用的 office-runtime-check 都是全局技能：所有工作区的对话和数字人都能用。
- 在 数字人 › 能力库 › 技能 里能看到它们，卡片上有 捆绑 标记；来源筛选选 内置 只看内置技能。
- 想手动指定，在输入框里输入
/docx、/xlsx、/pptx或/pdf。/菜单是否出现取决于 AI Agent 引擎，详见命令与快捷键。 - 用不到某个技能，可以在卡片的 更多 菜单里点 卸载。卸载后重启 Halo 也不会自动装回；以后需要时，在 已卸载 分组里重新安装。
让数字人做文档
数字人同样能用这些技能，适合按计划交付的文件，例如每周一份 .xlsx 销售汇总、每月一份 .docx 工作报告。
帮我建一个数字人：每周一早上 9 点把上周的销售数据整理成 Excel，再写一份 Word 总结，发到 zhangsan@example.com
Halo 会先问你几个问题（比如数据从哪里取），再建好数字人。做好的文件保存在数字人所在工作区的文件夹里。
- 要用邮件发出去，先在 设置 › 消息通道 › 电子邮件 配好邮箱，数字人才能把文件作为附件发送。见邮件与日历。
- 接了企业微信、飞书或微信机器人的数字人，可以在聊天里把文件直接发给你。只有数字人工作区文件夹或系统临时目录里的文件才能发出去。见消息通道概览。
- 别人通过机器人找数字人时，默认只能读取文件，不能运行命令，而文档技能要运行命令才能生成文件。要让访客也能拿到文档，需要在权限控制里放开 更改文件并运行命令，这一项标记为高风险，开之前想清楚。
建数字人的完整步骤见创建数字人，定时设置见运行计划与触发方式。
限制与提示
AI 看不到文档渲染后的样子，它靠读回文字和检查文件结构确认结果。重要文件请用 Word、WPS 或 PowerPoint 打开过一遍再发出去。
| 场景 | 限制 | 可以怎么做 |
|---|---|---|
旧格式 .doc、.xls、.ppt | 技能读不了也写不了（.xls 只能在画布里看） | 在 Office 里另存为 .docx、.xlsx、.pptx 后再交给 Halo |
| Word 修订和批注 | 不能接受或拒绝修订，不能写修订；批注读写都不可靠 | 让 AI 给一份改好的干净版本，并列出改了哪里 |
| Excel 公式 | 没有重新计算引擎：AI 写公式时会同时算好结果；改了已有表格的输入值后，部分公式结果要在 Excel 里打开才会刷新 | AI 会告诉你哪些公式需要刷新 |
Excel 图表、数据透视表、宏（.xlsm） | 修改含这些内容的工作簿会丢掉它们，AI 会先问你怎么处理；不能在表格里生成图表 | 另存一份不含它们的副本，或让 AI 先把数据表做好，你在 Excel 里插图表 |
| PPT 图表 | 支持柱状图、折线图、饼图等常见类型 | 打开含图表的页面检查一遍 |
| 扫描版 PDF | 没有文字层，读不出字 | AI 会请你在 ＋ › 能力 里打开 文字识别，见文字识别 |
| 加密 PDF | 打不开 | 提供密码或未加密的副本 |
| 改 PDF 里的原有文字 | 不支持原位改写 | 让 AI 提取全文后重新生成 PDF 或 Word |
| PDF 里的表格 | 提取出的是按阅读顺序排的文字，表格结构只能尽量还原 | 有原始表格时直接给原表格 |
| 带数字签名的 PDF | 任何修改都会让签名失效 | 改之前确认是否还需要签名 |
中文 PDF 使用 Halo 自带的中文字体生成，不依赖电脑上装了哪些字体。
遇到问题
PPT 在画布里显示「暂不支持预览演示文稿」
3.0 的画布还不能渲染 PowerPoint。点 在外部应用中打开，用 PowerPoint、WPS 或 Keynote 查看；网页版点 下载。
画布显示「无法预览此文档」或「无法预览此电子表格」
下方说明里如果写着 File too large to preview，说明文件超过了 25 MB；如果写着「该文件可能已损坏，或格式不受支持。」，可能是文件损坏或格式不对。两种情况都可以点 在外部应用中打开 或 下载。
Halo 说打不开旧版 .doc / .xls / .ppt 文件
文档技能只支持新格式。用 Office 或 WPS 把文件另存为 .docx、.xlsx 或 .pptx，再交给 Halo。
做文档时报错，提到找不到模块
对 Halo 说「运行 /office-runtime-check」，它会检查内置运行环境里的每个库并报告结果。只有文档技能受影响，聊天本身照常可用。
Halo 不做文件，只回了一段文字
可能是对应的技能被卸载了。到 数字人 › 能力库 › 技能 看看，在 已卸载 分组里把它重新安装。也可以在消息里直接写明「做成 .docx 文件」。