察元AI文档助手 · vv6.1.2 · 更新于 2026-10-16
本手册覆盖察元AI文档助手 v6.1.0 的安装、模板编制（按你的模板出整套 PPT / Word / Excel）、三端助手（文字 / 表格 / 演示）、三级生图与网络资源搜索、文档智能体、多文档会话隔离与跨文档对话交接、面板任意停放（磁吸拖动）、知识库（含察元AI OS 自动发现）、保密与外部 MCP 协同。文档持续更新，以应用内「帮助」为准。
图：WPS 内的「察元AI助理」选项卡与浮窗对话面板实拍
察元AI文档助手是运行在 WPS 文字 / 表格 / 演示三端内的智能加载项（Apache-2.0 开源），安装后在 WPS 顶部出现「察元AI助理」与「察元AI编审」选项卡（按宿主自动切换）。它把大模型对话、模板编制（按你的模板出整套文档）、三端内置助手（文字 4526 个 / 表格 29 个 / 演示 25 个）、域内知识库检索和 9 种文档写回动作装进编辑器，并提供内置文档智能体与外部智能体（MCP）两条自动化通道。6.0 起 Ribbon 全面语义化：三端助手图标 118 枚 SVG 全量覆盖、按助手语义配色，常驻入口一眼可辨；6.1 起模板编制升级为主线能力，对话里给模板文件即可按版面对位出稿。
| 能力 | 说明 |
|---|---|
| 模板编制 | 对话给模板文件（.pptx / .docx / .xlsx）+ 一句话要求：按类型路由宿主（离线自动拉起）、形状级角色剖析对位落内容、打开前多轮核对（机器审计三维 + 自愈 + AI 审查，默认 3 轮）、交付保留模板母版 / 背景 / 字体 |
| 三端助手 | 文字 4526 个 / 228 领域；表格 29 配方；演示 25 配方（含 3 个配图配方），按宿主自动分流 |
| 三级生图 | 模型生图 → 网络搜图（网络资源清单：Serper / Pexels 等 keyed 优先，必应 / Openverse 免Key兜底）→ SVG 矢量；auto / model / web / svg 四种图源模式 |
| 网络资源搜索 | 10 项搜图 / 搜索资源清单（默认设置内）：独立开关、API Key 本地落盘、一键测活，启用清单驱动本机搜图链 |
| 本机知识库自动发现 | 装有察元AI OS 的机器零配置自动接入本机知识库；端口注册表严格固定，库列表实时同步 |
| 多文档会话隔离 | 对话跟随文档（三宿主文件内身份），面板跨窗口切换自动跟随；busy 安全切换 / 跨文档拒发 / 孤儿回合回收三重防线；会话按属主快照持久化，切文档不丢对话 |
| 面板停放 | 浮窗 / 停靠左 / 右 / 底 / 关闭五形态三宿主一致；浮窗拖到屏幕左 / 右 / 底缘磁吸自动停靠，任务执行中防误切 |
| 文档智能体 | ReAct 自循环最多 16 轮，任务清单 + 快照撤销 + 权限三档，跨宿主只读编排 |
| 写回动作 | 替换 / 插入光标 / 插入每段后 / 插入文首 / 批注 / 链接批注 / 批注+替换 / 追加文末 / 仅生成（共 9 种） |
| 知识库 | 远程 KB 三鉴权 + RAG 引用气泡 + 原文下载 |
| 安全 | 保密检查、文档脱密/复原、密钥本地落盘、可完全断网 |
| 升级与反馈 | 应用内官网升级提醒（对话窗内提醒条，静默检查、断网跳过）+ 意见反馈直达官网 |
| 开放 | 本机 MCP Server（127.0.0.1:62588）对外 51 个工具 + wps-skill-chayuan 技能包 |
数据目录：Windows %AppData%\Roaming\chayuan；macOS ~/Library/Application Support/chayuan；Linux ~/.config/chayuan。卸载不删数据目录；5.1.7 起模型配置经设置桥播种进面板，6.0.0 起网络资源 Key 同样本地落盘，升级后无需重新填写。
一行命令安装（同时装好加载项 + MCP 自启 + 技能）：
curl -fsSL https://gitee.com/cloudshd/chayuan-wps-releases/raw/master/scripts/install-wps-skill-chayuan.sh | bash
图：WPS 表格端：助手面板按行业分组，Ribbon 一键直达高频工序
在 WPS 表格里打开 AI 助手面板，侧栏自动切换为表格助手；顶部「察元AI助理」选项卡常驻 5 个高频入口：AI表格助手、公式助手、数据洞察、一键图表、数据清洗。点击即把配方填进对话（部分直接发送，部分预填等你补充数据范围）。
| 通用配方 | 做什么 |
|---|---|
| 数据洞察 | 概况、趋势、异常值、TOP5 要点一次读懂，只读不改表 |
| 一键图表 | 读数据推荐最合适的图型（柱 / 折线 / 饼 / 散点 / 雷达等 9 种）并创建 |
| 公式助手 | 大白话变 Excel 公式写进单元格，优先标准函数，可复核 |
| 数据清洗 | 查重复行 / 空值 / 格式混写，先报告，确认后才清理 |
| 排序汇总 | 按维度排序、筛选、分类汇总一句话搞定 |
| 报表结论 | 核心数字 + 环比 + 风险点，≤300 字简明结论 |
| 表格创建 | 描述用途 → 自动建表头结构 + 示例数据 |
| 导出转换 | 当前表一键导出 PDF / CSV |
行业配方 21 个：财务（费用归类汇总 / 流水对账 / 发票整理 / 三大报表指标 / 预算差异表）、电商运营（销售汇总 / 直播复盘 / 竞品价格对比 / 留言情绪归类 / 进销存统计）、HR（花名册 / 考勤 / 薪酬核算 / 招聘漏斗）、销售（业绩排名 / 销售预测 / 客户跟进 / 提成计算）、教育（成绩统计 / 考勤统计 / 家庭记账）。
公式纪律：计算类产出优先写入 SUMIF / VLOOKUP / RANK 等标准公式，让表格自己算——数字永远可点开复核；财务场景完成后主动提醒「数字请人工复核」。所有写操作（改数 / 插行列 / 排序）先回预览信封，确认才落盘。
图：WPS 演示端：AI 生成 PPT 大纲确认后逐页生成，配图自动编排
在 WPS 演示里打开 AI 助手面板，侧栏自动切换为演示助手；Ribbon 常驻 5 个入口：AI演示助手、生成PPT、整套摘要、美化统一、口播稿。
| 通用配方 | 做什么 |
|---|---|
| AI 生成 PPT | 一句话主题 → 大纲确认 → 逐页生成整套演示稿，支持三级配图 |
| 文档转 PPT | 跨宿主编排：读当前 Word 提炼大纲，直接写成演示稿 |
| 整套摘要 | 通读全部页面，自动插一页「核心要点」 |
| 美化统一 | 全套字体字号一键统一（表格形状跳过），完成后报告触及页数 |
| 大纲调整 | 增删移页、改标题、换版式 |
| 数据页 | 新增战报 / 对比 / 汇总类表格页 |
| 口播稿 | 每页自动生成口语化演讲者备注 |
行业配方 15 个：政企汇报（年终总结 / 述职报告 / 党建课件 / 会议纪要）、销售提案（产品提案 / 竞品对比页 / 案例展示页）、咨询方案（方案框架 / 项目复盘 / 商业计划骨架）、教育培训（课件生成 / 答辩模板 / 习题互动页）、通用职场（周报转汇报页 / 行动项页）。
| 图源 | 说明 |
|---|---|
| ① 模型生图 | 调用你配置的生图模型（OpenAI 兼容 /images/generations），提示词、尺寸可指定，插画背景都行 |
| ② 网络搜图 | 按「网络资源搜索」启用的资源清单依次搜索：Serper / Tavily / SearXNG / Pexels / Pixabay / Unsplash（填 Key 启用）→ 必应图片 / Openverse 免 Key 兜底；下载前校验图片有效性 |
| ③ SVG 矢量 | 语义图标矢量图形直接插入，零成本、缩放不糊、还能改；生成后自动消毒（去脚本 / 外链） |
手上有公司统一模板（.pptx 演示 / .docx 文档 / .xlsx 表格），不想手动逐页套版？v6.1 起在对话里给出模板文件和一句话要求即可：模板编制覆盖三宿主——Word 文档交给文字端、表格交给表格端、演示交给演示端，对应组件没有打开时自动拉起并等待就绪，生成完成后自动打开产物。
编制前逐页剖析模板：每个形状标记角色（标题 / 副标题 / 正文 / 装饰）并记录字号、字体、坐标——封面页吃文档标题、内容页吃章节标题、目录条目按序号对位，阅读顺序与模板设计全对位；隐形水印（超小字号 / URL）识别为装饰保持原样。新内容按原形状容量截断，不撑爆版式；文字写入形状「主文本 run」，继承模板正确的中文字体 / 加粗 / 颜色，不会串到英文装饰字体上。
| 核对维度 | 做什么 |
|---|---|
| 机器审计 · 占位残留 | 扫描模板占位符是否清干净，有残留自动再清扫 |
| 机器审计 · 文本溢出 | 按形状宽高 × 字号容量估算（中文全角 / 半角加权），溢出按容量句读截断重写 |
| 机器审计 · 字体一致性 | 以模板字体普查为基准比对成品，偏离即修 |
| AI 审查 · 需求符合性 | 逐条对照你的要求与生成前勾选的契约项 |
| AI 审查 · 文案质量 | 空洞 / 拼接 / 语病 / 过长四项检查 |
模板从哪来：模板编制基于你提供的模板文件——公司 VI 模板、往年年终总结、行业下发的格式样例都可以。想让智能体「从零建稿 + 自动配封面」，请使用察元AI Office（封面库 + 真目录域）。
在 AI 助手对话框中开启「文档智能体」（机器人按钮），整轮对话即进入智能体车道：由 AgentLoop 内核驱动，自动调用三宿主文档工具完成任务，消息带「文档智能体」徽标。智能体不可用时自动回落普通助手并说明原因。
复合任务（两步以上）首轮必须先列出任务清单，边执行边勾选，跨回合沿用同一份清单。你随时能看到它打算做什么、做到哪一步。
首次写操作前自动为文档建立快照；任务结束出现撤销卡，一键回滚智能体本回合的全部改动。末轮还有「声称核对」：智能体自述改了 N 处，系统与实际执行数比对，不一致会提醒你复查。
能力边界：智能体只操作当前打开的文档 / 表格 / 演示稿，不会自动新建文件或另存副本（工具层明确禁止）；「封面页」没有专用工具，需要时用插入空白页 + 页眉页脚 / 水印组合实现。要从零生成含封面的成稿，请使用察元AI Office；手上有模板文件时用模板编制（上一章），基于你的模板产出整套新文档并自动打开。跨宿主时一个回合内只写当前宿主，可只读其它宿主作数据源（文档转 PPT、数据战报页就是这么实现的）。
图：助手设置：系统助手 / 文本分析分组，智能推荐提示词，拖拽排序
助手目录分四大主分组：系统助手（核心工序）、文本分析、工具助手（条形码生成等不耗 token 的确定性工具）、自定义。行业助手按 228 个领域分包：政务/公文 24 个、法定公文 24 个、党建、军队、法院、检察、教育、医疗、跨境电商、影视编剧、网文小说……每个领域约 21-24 个。
外部智能体同样能检索这套目录：assistants_list_domains / assistants_search / assistants_get 三个 MCP 工具按需检索导出提示词，不必把 4500 个助手全注册成工具。
AI 助手面板支持五种形态：浮窗、停靠左、停靠右、停靠底部、关闭（窗口右上角单按钮下拉菜单）。6.0 起三宿主停靠能力统一：文字 / 表格 / 演示同一套菜单行为——在哪个组件打开，助手侧栏就自动分流为对应配方；不支持的方向自动隐藏，当前形态置灰打勾。
| 形态 | 适合场景 |
|---|---|
| 停靠右侧 | 写长文对照改稿（默认写作位） |
| 停靠底部 | 表格批量操作，当工具条用 |
| 停靠左侧 | 参考另一份材料时腾出右手 |
| 浮窗 | 临时查个资料、问一句话 |
| 关闭 | 纯阅读；浮动球随时唤回 |
生成循环跟随文档：切换文档自动重挂载，长任务不中断。会话数据按属主快照持久化，切走再切回，对话与任务进度原样恢复。6.1 起生成类任务完成后若自动打开了新文档，对话历史会跟着交接过去（15 分钟内有效）——在原稿里下的生成指令，到新文档窗格里继续追问，上下文不断；上次生成的输入也会被记住，改个要求就能再生成一版。
对话内点知识库图标即可绑定知识库。检索管线：问题改写 → 批量召回 → 去重 → 重排 → 拼引用上下文 → 带引用作答。
装有察元AI OS（察元AI超级智能体桌面端）的机器，打开知识库设置即自动发现本机 chatop-kb 服务并接入，无需填地址配端口。服务端口按察元统一端口注册表严格固定（一格一号、永不漂移）；重启自动重连，察元AI OS 侧新增 / 删除知识库实时同步到助手。本机回环直连零出网，公私文档都可放心检索。
图：「察元AI编审」选项卡：表单辅助填报 / 文档审计 / 模板与规则管理
图：模型设置：30+ 供应商开关式接入，密钥本地落盘
加载项启动后由 sidecar 提供 MCP 服务（Streamable HTTP，默认 127.0.0.1:62588，v5.1 起带最小 Token 鉴权）。Claude Code、Codex、Cursor、Hermes、OpenClaw 等客户端把该地址配进 mcpServers 即可读写当前打开的文档 / 表格 / 演示稿。
{
"mcpServers": {
"chayuan-wps": { "url": "http://127.0.0.1:62588/mcp" }
}
}
工具目录 v0.13.0 对外 51 个工具：文字域细粒度工具 + 域聚合（comment / revision / layout / nav / toc / bookmark / table（12 动作）/ caption / field / image / hyperlink / headerfooter / watermark / style / export）+ 表格域 21 个动作（只读 6 + 写 15：sheet / range / row / column / sort / autofilter / format / chart / export）+ 演示域 20 个动作（只读 4 + 写 16：slide / text / textbox / picture / table / slideshow / notes / format_uniform / svg_add / export）+ 图像工具（generate_image 模型生图 / image_search 网络搜图——按网络资源清单 keyed 优先、免 Key 兜底）。写操作统一「先预览再确认」。服务开机自启（Windows 注册表 / macOS LaunchAgent / Linux systemd --user），sidecar 为单文件二进制，无需另装 Node.js。