围绕 DeepSeek API 与 WPS 宏、加载项，讲清环境准备、调用流程、插件封装和排错安全，让办公 AI 落地可复现。
DeepSeek 与 WPS 的结合，本质上是用大模型补齐办公套件在自然语言处理上的短板。WPS 负责文本、表格、演示的上下文与操作入口，DeepSeek 负责理解、生成和推理，二者通过 API 请求建立连接。对 AI 指导老师来说，重点不是堆砌概念，而是把接入过程拆成可以照做的步骤，并解释每个环节为什么需要这样处理。
1. 准备 DeepSeek API 与 WPS 宏环境
在动手接入之前，需要先确认两个基础条件是否满足。DeepSeek 侧要拥有可用的 API Key，登录 DeepSeek 开放平台后创建密钥，并核对账户余额与调用额度。接口兼容 OpenAI 的 chat completions 格式，基础地址通常为 ，常用模型包括 deepseek-chat 与 deepseek-reasoner，前者适合日常润色、翻译、摘要，后者适合复杂推理与长文本分析。创建 Key 后应先用 Postman 或 curl 测试一次请求，确认返回 JSON 中包含 choices 与 message.content 字段，避免把鉴权问题带进 WPS 环境。Key 不要写死在共享文档里，可以放入系统环境变量或独立配置文件，并限制可见范围。
WPS 侧首先要确认版本支持开发工具与 JS 宏。Windows 版 WPS Office 较新版本通常在“开发工具”选项卡中提供 JS 宏编辑器，如果界面没有该入口，可以在设置中心或信任中心里启用宏相关权限。企业设备可能由管理员统一关闭宏功能，需要提前申请策略放行。JS 宏适合快速验证与个人自动化，原因在于它能直接读取当前文档选区、活动工作表或演示文稿对象，再把 API 返回内容写回光标位置，形成最小闭环。对于 Mac 或部分受限环境，如果 ActiveX 不可用，可以改用 VBA 发起 HTTP 请求，或者转向 Web 加载项方案。
环境准备还包括网络与安全策略。部分办公网络会拦截外部 HTTPS 请求，导致宏内请求超时，此时需要检查代理设置、证书信任和防火墙白名单。建议先在浏览器或命令行中访问 API 域名，确认网络连通，再进入 WPS 宏编辑器测试同样请求。若团队规模较大，应统一管理 API Key，按成员或项目分配子密钥，记录调用量，避免个人密钥泄露后无法追踪。这个阶段看似繁琐，却决定了后续接入是否稳定，尤其是当文档中涉及合同、财务、教学资料时，密钥管理和网络合规必须前置完成。
2. 用 JS 宏把 DeepSeek 接入 WPS 文档
打开 WPS 的 JS 宏编辑器后，可以新建一个模块，编写一个接收选区文本的函数。在 Windows 环境下，常见做法是创建 WinHttp.WinHttpRequest.5.1 对象，设置请求地址为 ，请求头包含 Content-Type: application/json 与 Authorization: Bearer 你的APIKey，请求体则按 OpenAI 兼容格式组织，其中 model 指定为 deepseek-chat，messages 数组放入 system 与 user 两条消息。system 消息可以设定为“你是 WPS 办公助手，只输出修改后的文本”，user 消息则传入当前选区内容。发送选择 POST，同步等待返回后解析 JSON，再读取 choices[0].message.content 写入文档。
把 API 返回写回 WPS 时，要根据场景选择替换、插入或新建批注。润色场景可以直接替换当前选区，翻译场景可以在原文后插入译文，摘要场景则新建文档或写入指定单元格。为了让操作更顺手，可以在宏编辑器中把函数绑定到工具栏按钮、快捷键或自定义 Ribbon 菜单，用户选中一段文字后点击按钮，几秒内就能看到结果。表格场景同样适用，例如读取活动单元格的文本，调用 DeepSeek 生成公式解释、分类标签或数据清洗建议，再把结果写入相邻列。演示文稿中可以提取当前幻灯片标题与备注，让模型生成讲稿提纲。
宏方案的关键在于错误处理与交互反馈。请求可能因为 Key 失效、余额不足、网络抖动或模型过载而失败，函数中应判断状态码并给出可读提示，而不是让 WPS 直接弹出一长串错误。对于长文本，要控制传入长度，必要时分段调用，避免超出模型上下文限制。返回内容如果包含 Markdown 标记，可以在写入前做简单清理，保证文档排版整洁。由于宏代码运行在本地，权限较高，分享给同事时要提醒对方检查代码内容，不要运行来源不明的宏文件。完成这一节的最小闭环后，DeepSeek 已经可以在 WPS 中完成润色、翻译、摘要和问答等基础任务。
3. 借助加载项打造可复用的 WPS AI 面板
当个人宏验证通过后，如果希望团队共用、跨设备同步或拥有更友好的界面，可以采用 WPS 加载项方案。WPS 开放平台支持基于 Web 技术构建任务窗格与 Ribbon 按钮，开发者用 HTML、CSS 和 JavaScript 编写界面，通过 WPS 提供的 JS API 读取文档选区、表格数据和演示对象。相比宏，加载项更容易做版本管理、权限控制和界面美化，也能在 Windows、Linux 和部分 Mac 环境中保持一致性。常见做法是用 wpsjs 脚手架创建项目，在 manifest 中声明所需权限与菜单入口，再把构建产物发布到企业内应用中心或 WPS 插件市场。
加载项调用 DeepSeek 时，不建议在前端直接写入 API Key，因为网页代码可以被查看，密钥容易泄露。更稳妥的架构是让加载项请求企业自建的后端代理，由代理服务持有 DeepSeek Key，并负责鉴权、限流、日志和内容过滤。后端可以用 Node.js、Python FastAPI 或 Serverless 函数实现，收到前端请求后转发到 DeepSeek API，再把结果返回任务窗格。这样既能统一计费与审计，也能在代理层加入缓存，减少重复请求。若需要流式输出，可以让后端以 SSE 转发模型返回，任务窗格逐步显示文字，体验接近主流 AI 助手。
在交互设计上，加载项可以把 DeepSeek 能力封装成几个高频动作，例如“润色选中段落”“生成表格公式”“提炼会议纪要”“翻译并保留格式”。用户点击动作后，面板显示原文、模型输出和替换按钮，避免直接覆盖造成误操作。对于 AI 指导老师，还可以在面板中内置提示词模板，把教学场景常用的评语生成、课件大纲、题目解析做成可配置选项。加载项发布后，更新只需替换前端资源或后端版本，不必让每位用户重新导入宏。企业若对数据敏感，可把 DeepSeek 替换为私有化部署模型，只要保持 OpenAI 兼容接口，前端代码几乎不用改动。
4. 调试、权限与内容安全的关键处理
接入过程中最常见的问题集中在鉴权、网络和格式三个方面。状态码 401 通常表示 API Key 错误或请求头缺少 Bearer 前缀，402 往往与余额不足有关，429 说明触发限流，400 则可能是模型名写错、JSON 结构不合法或消息角色不符合要求。WPS 宏里的请求超时可能来自代理、证书或防火墙，加载项里的跨域错误则要检查后端 CORS 配置。排查时先在命令行复现请求，再对比宏或加载项发送的 Header 与 Body，能够快速定位差异。建议为每次调用记录时间、模型、耗时和状态码，但不要记录完整敏感原文。
权限管理需要遵循最小可用原则。个人使用时，API Key 只保存在本机环境变量或加密配置中；团队使用时，通过后端代理分配令牌，按项目限制额度和模型。WPS 宏本身具有较高系统权限，企业应禁用来源不明的宏，只允许签名或内网分发的加载项。对于合同、成绩、财务数据等敏感内容，调用公共 API 前要做脱敏处理，或者改用私有化模型与企业网关。AI 输出也需要人工复核，尤其是数字、法条、引用和统计结论，模型可能生成看似合理但实际错误的内容。教学中应明确告知学生哪些环节可以借助 AI，哪些环节必须独立完成。
内容安全与合规同样不能忽视。把文档内容发送到外部 API 前，要确认服务条款、数据保留政策和所在地区的数据出境要求。若组织有严格合规要求，可以在代理层增加敏感词检测、字段掩码和审计日志，并设置自动清理周期。对于生成结果，建议保留原始输入与修改痕迹，方便追溯。真正稳定的 DeepSeek 接入 WPS 方案，不是一次性配置，而是持续维护的流程，包括密钥轮换、版本升级、模型切换和用户培训，管理员需要定期检查日志与额度，确保加载项和宏始终指向正确的模型端点。
