灵犀AI（v1.2.1:beta）

开源地址：https://github.com/lewis-hui1202/WPS-AI

目前为Beta预览版本，可能有些bug,欢迎大家Star,提交Issues.

WPS Office 多宿主 AI 助手插件，覆盖 WPS 文字 / 表格 / 演示 三端。一个面板调三家 AI（Codex/OpenAI 兼容/Anthropic）+ 一个图像 provider，AI 通过工具调用直接读写文档。

🤖 100% 由 Claude 进行 Vibe Coding 完成：本项目从架构设计、provider 适配、wps-jsapi 封装、12 套 PPT 主题、6 类 SVG 图表、markdown→Word 渲染、双平台安装器（Inno Setup + pkg/dmg），到 README/INSTALL 文档，全程由 Claude（Claude Code CLI + Opus / Sonnet 模型）配合人类提示词节奏 vibe coding 出来。仓库里没有一行代码是”手敲”的，全靠和 AI 来回对话迭代。也欢迎你 fork 下来自己 vibe 着改。

5 分钟跑起来直接看 快速开始。卸载、升级、故障排查、安装器构建在 INSTALL.md。

效果预览

三个宿主的 ribbon + 侧边 TaskPane 实拍：

WPS 文字（Writer）—— AI 助手面板 + 6 组快捷按钮

WPS 表格（Spreadsheet）—— 表格美化 / 自动调宽 / 智能推荐

WPS 演示（Presentation）—— AI 生成 PPT / 大纲转 PPT / 统一风格 / 去 AI 味

快速开始（傻瓜 3 步）

不想看长文档？照着下面三步走，5 分钟跑起来：

1. 下载安装包

两个安装包都内置了 Node 运行时，不需要单独装 Node.js。

2. 安装

Windows 用户：

1. 先关闭杀毒软件 / Windows Defender 实时防护
   
   （未签名 exe 会被误杀，安装完成后可重新打开）
2. 双击 lingxi-ai-1.2.1-beta-setup.exe，一路「下一步」即可
3. 完全退出 WPS
   
   （任务栏右下角 WPS 图标右键退出），重新打开 WPS 文字 / 表格 / 演示
4. 顶部 ribbon 出现「灵犀AI」标签页 = 成功

Mac 用户：

1. 双击 dmg，打开后看到「灵犀AI 安装器.pkg」
2. 右键 .pkg → 打开
   
   （未签名版本被 Gatekeeper 拦时这样开），警告弹窗里再点「打开」
3. 按向导一路下一步，中途输一次系统密码
4. 完全退出 WPS
   
    → 重新打开任意 WPS 应用，顶部出现「灵犀AI」= 成功

详细步骤、卸载、升级、故障排查见 INSTALL.md。

3. 在设置里配置 AI 模型

1. 打开 WPS 文字/表格/演示中任意一个，点 ribbon 上的 「打开灵犀AI」 按钮，右侧 TaskPane 弹出

2. 点 TaskPane 右上角 ⚙ 设置，切到 「设置」 Tab

3. 选一种 provider 配置（任选其一即可，可同时配多个，header 下拉切换）：

   Provider	怎么配
   Codex（ChatGPT OAuth）	点「Sign in with ChatGPT」走浏览器授权，把回调 code 粘回来就行
   OpenAI 兼容 （DeepSeek / Kimi / 通义 / Ollama 等）	填 baseURL + API Key + 模型名，比如 DeepSeek 用 https://api.deepseek.com/v1 + deepseek-chat
   Anthropic Claude	填 API Key，模型推荐 claude-sonnet-4-6 或 claude-opus-4-7
   图像 Provider（toapis）	想让 AI 在文档里插图才需要，填 toapis 的 key

4. 保存后回到「AI 助手」Tab，header 下拉里选刚配好的模型，输入框打字开聊 —— 让 AI 直接读写文档就行了。

配置完想换 provider？header 上的下拉随时切，不用重新登录。

功能一览

三端通用

AI 接入

• 统一 AI 面板
  
  ：单个 TaskPane 兼容三个宿主，自动识别当前是文字 / 表格 / 演示
• 多 provider 切换
  
  ：
• Codex
  
  （ChatGPT OAuth + PKCE）—— 复用 ChatGPT 用户的会话
• OpenAI 兼容端点
  
   —— 自定义 baseURL + API Key（适配 DeepSeek、Kimi、阿里千问、本地 Ollama 等）
• Anthropic Claude
  
   —— 直连或代理
• 图像 provider
  
  （toapis 协议）—— GPT-Image-2 异步任务，实时显示生图百分比 + 已用秒数
• 流式输出 + tool-use 循环
  
  ：AI 一次对话内可连续调多个工具操作文档
• 双模式
  
  ：
• 预览确认模式
  
   —— AI 先生成结果，你确认后再插入/替换
• AI 直接写入模式
  
   —— AI 调工具直接改文档（默认安全栏：调多了会停）

对话体验

• 多对话管理
  
  ：自动按每段对话存档，「+ 新对话」开新的、「📑 历史」下拉切回去继续。本地 localStorage 持久化，重启 WPS 不丢
• 历史完整回放
  
  ：切回旧对话能完整看到当时的过程 —— 你的提问、AI 推理、工具调用与结果、AI 文本回复
• 纯净模式
  
  ：右上角眼睛图标切换，隐藏工具调用 / 推理过程，只看 AI 的自然语言回复
• AI 处理进度条
  
  ：聊天输入框上方实时显示 AI 当前在干什么（思考 / 推理 / 执行某工具 / 生成回复），生图时显示百分比填充
• 快捷键
  
  ：Enter 发送 / Shift+Enter 换行 / Cmd-Ctrl+Enter 兼容；中文输入法候选时按 Enter 不误发
• 对话打断
  
  ：长任务跑过头随时点圆形停止按钮
• 附件支持
  
  ：聊天输入框 ➕ 图标上传图片或文本文件给 AI 当参考（图片支持 png/jpg/gif/webp，文本支持 txt/md/csv/json/js 等多种；单文件 ≤ 5MB；自动检测模型是否多模态，非多模态时图片自动忽略并提示）
• 系统提示词配置
  
  ：设置里可定制 AI 的全局回答风格（默认配了一套”简洁直接、不堆 emoji、不带 AI 套话、直接调工具改文档”的规则，可一键重置）

操作安全 / 改动追踪

• AI 工作期间锁定文档
  
  ：调工具期间通过 Document.Protect（Word）+ Worksheet.Protect(UserInterfaceOnly=true)（Excel）硬锁，用户输入不进文档；工具调用前后自动解锁/重锁。锁用固定 token，启动时自动清理残留卡锁
• 临时文档拒绝操作
  
  ：AI 修改型工具调用前检测文档是否已存盘，未存盘直接拒绝并提示用户先 Ctrl-S
• 改动记录 Tab
  
  ：每次 AI 对文档的修改都记一条（按文件分组，只看当前文件的）。展开看入参、改动前后快照、错误信息（弹窗显示，scroll 完整）
• per-turn 文档备份 + 一键回退
  
  ：每轮 AI 对话开始时自动备份当前文档到 ~/.lingxi-ai/backups/<doc>/<时间>.<ext>；不满意可一键恢复到本轮前的状态；自动 GC 保留最近 20 份
• 配置导入/导出
  
  ：API Key 等敏感字段加密（enc:v1: 前缀 + XOR 混淆）；带版本号，导入时自动检测兼容性，老版本配置无 version 视为 0.0

渲染 / 写入

• markdown→Word 原生格式
  
  ：AI 输出的 Markdown 写回 Word 时按 Word 原生样式渲染 —— 标题层级 / 加粗 / 列表 / 代码块 / 真表格（带边框 + 表头浅灰底 + AutoFit）/ 嵌套列表（按字符单位缩进）；段落级缩进强制清零（含中文 Word 专有的 CharacterUnitFirstLineIndent，根治”扩写后段首 16 字符缩进”）
• 聊天内 markdown 渲染
  
  ：支持标题 / 加粗 / 代码块 / 表格（聊天气泡里也是真 <table> 渲染）

文字（WPS Writer）

• 6 组快捷按钮
  
  ：写作（帮我写 / 续写 / 扩写 / 缩写）/ 改写（重写 / 帮我改）/ 润色（快速润色 / 更学术 / 更活泼 / 更正式 / 党政风 / 口语化 / 全文润色）/ 翻译（中文 / 英文）/ 总结（全文总结 / AI 排版）/ 智能（AI 生成图片 / 文档脑图 / 文档问答 / 智能推荐操作）
• AI 工具：读写选区 / 段落 / 全文，插入图片，插入表格，应用样式

表格（WPS Spreadsheet）

• 单元格读写、范围批量、格式化
• 自动调整高列宽、表格美化样式（带预设主题）
• 数据透视、列筛选辅助
• AI 生成公式、转表、批量校对

演示（WPS Presentation）

• 12 套带设计理念的色板
  
  （每套带灵感来源）：
• Bold Signal · Pitch Deck/主题演讲（Apple keynote 风）
• Electric Studio · 工作室作品集（R/GA + Pentagram）
• Creative Voltage · 复古活力（Eames + Massimo Vignelli）
• Dark Botanical · 高端品牌（Hermès + RH catalog）
• Notebook Tabs · 评测报告（Field Notes + Moleskine）
• Pastel Geometry · 产品介绍（Stripe Atlas + Memphis）
• Split Pastel · 创意机构（Spotify Wrapped 美学）
• Vintage Editorial · 个人品牌（Wes Anderson + Vogue 老调）
• Neon Cyber · 科技初创（Apple Vision Pro 克制霓虹）
• Terminal Green · Dev 工具（GitHub Dark + 终端绿）
• Swiss Modern · 企业汇报（Helvetica + Müller-Brockmann）
• Paper & Ink · 深度叙事（Penguin Classics 文人气）
• 方案 A 模板
  
  （纯形状拼，全可编辑）：cover-split / cover-band / section-fullbleed / content-sidebar / stat-hero / quote-block / two-column / closing-thanks
• 方案 B 视觉模板
  
  （SVG 渲染图作背景，文字仍可编辑）：v-cover-gradient / v-section-modern / v-stat-bigtype / v-content-modern
• 6 类数据可视化图表
  
  （SVG → PNG → AddPicture 链路，配色跟主题色板）：bar / donut / line / radar / gauge / heatmap
• 大纲生成 PPT
  
  ：贴大纲 → 自动选模板生成全套
• 统一风格
  
  ：现有 PPT 一键统一字体/色板/装饰/动画 + 适合页插图表
• 去 AI 味
  
  ：AI 改写让生成内容更自然
• ribbon 快捷键：AI 生成 PPT / 大纲生成 / 封面 / 单页 / 多页 / 配图 / 帮我写 / 帮我改 / 扩写 / 缩写 / 润色 / 校对 / 演讲稿 / 智能推荐