2026年WPS-AirPage-Skill的介绍

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

WPS AirPage Skill 是金山办公 SmartDocs 团队开源的 AI Agent 技能插件，让 Claude Code、Cursor、Codex、Gemini CLI 等 AI 编程助手能够。

它本质上是一个运行在本地的 Node.js CLI 工具，充当 AI Agent 与 WPS 365 在线文档平台之间的桥梁。用户无需学习任何 API 或命令，只需用日常语言描述需求——”帮我在那个 kdocs 文档里加一段周报”、”创建一个新的 AirPage 文档并把这份 Markdown **去”——Agent 就会自动调用 CLI 命令完成文档的搜索、创建、编辑、图片上传、评论管理等全部操作，大幅降低了智能文档的操作门槛。

WPS AirPage Skill 覆盖了智能文档操作的完整生命周期：

前置条件：Node.js 18+ 和 WPS 365 账号。

执行，提及关键词即自动激活

将复制为

对话中提及、、或时，Skill 自动激活。用户无需记忆任何命令，用自然语言描述需求即可。

鉴权是连接 Agent 与 WPS 365 的关键环节。

通过 Chrome DevTools MCP 自动检测登录状态、打开浏览器、等待用户完成登录后提取 Cookie 和 CSRF Token，整个过程用户只需做一次登录操作。凭据自动保存，后续操作零感知。

执行。若登录态有效，无头模式静默提取；若过期则弹出浏览器窗口，用户登录后自动保存 Profile，下次复用。

从浏览器 DevTools 复制 Cookie 和 CSRF Token，通过命令行直接写入：。

凭据存储在，权限模式 0600，超过 8 小时自动提示刷新。

Agent 收到 AirPage 相关请求后，严格按五步流程执行，每一步都有明确的完成条件：

调用命令确认凭据有效。缺失、过期或 API 返回鉴权错误时，自动触发刷新流程。凭据有效前禁止进入下一步。

file_id 是所有文档操作的核心标识。支持三种输入形式：数字 ID 直接使用；短链和完整链接均由 CLI 自动解析。若用户提供了关键词，则调用搜索；未明确目标时主动询问是搜索已有文档还是新建。

优先使用高层 CLI 命令（如），仅在 CLI 无法满足时才读取 API 参考文件构造底层 payload。

写操作必须回读确认——内容变更用复查，评论变更用验证。需特别注意：对新文档有索引延迟（可能返回空列表），验证写入应使用而非。

说明操作结果，包括文档名称、file_id、变更内容和验证状态。失败则明确告知卡在哪一步及原因。

node scripts/cli.js auth node scripts/cli.js search “周报” # 搜索获取 file_id node scripts/cli.js insert-markdown 
          
            –content “# 本周进展 正文内容…” –pos end node scripts/cli.js query 
           
             # 回读验证写入结果

node scripts/cli.js new-doc –name “Q2 季度总结” # 返回 file_id + URL node scripts/cli.js insert-markdown 
          
            –content @content.md # 支持读文件 node scripts/cli.js query 
           
             # 验证

node scripts/cli.js comments 
          
            # 查看评论 node scripts/cli.js comment-add 
           
             –sid 
            
              –text “评审意见” node scripts/cli.js comments 
             
               # 验证

所有块操作通过 WPS 365 内部封装的统一 API 端点完成：

POST https://365.kdocs.cn/api/v3/office/file/{file_id}/core/execute

与原始 WPS 开放平台 API 相比，无需复杂的 KSO-1 签名，参数直接用 JSON 格式传递，大幅简化了 Agent 的调用难度。API 使用两种 Command 类型区分操作：

— 写操作（创建 / 更新 / 删除），参数为 +

— 读操作（查询 / 转换），参数为 +

智能文档的核心数据模型是。文档由多个块节点组成，每个块包含类型（type）、属性（attrs）和内容（content），内容可嵌套子块形成树形结构。支持的块类型包括：标题、段落（支持列表）、标题 H1-H6、代码块（43 种语言）、表格、图片、视频、引用块、分栏布局（1-10 栏）、多维表格、流程图等十余种。

在 SKILL.md 的”Critical Gotchas”部分：

新建文档后可能返回空列表，即使内容已写入。服务端索引存在数秒到数十秒的延迟。验证写入用命令过滤 heading 块。

即使只更新一个块，也要传数组格式，传单对象会报参数错误（错误码 -152）。

正确写法为，写成会导致静默失败——API 不报错但内容不会更新。

/ 是评论锚点标记，非真实块。计算时必须跳过；执行时若需保留评论锚点，需将其一并带回 content 数组。

图片上传端点必须附带请求头，否则会被服务器拒绝。CLI 已内置处理，但手动构造 API 时需注意。

凭据仅存本地，权限 0600；HttpOnly Cookie 通过拦截浏览器网络请求获取，不走 JavaScript；凭据超 8 小时自动提示刷新，避免长期暴露陈旧会话。

WPS 365 AirPage / 智能文档 / kdocs 在线文档的块级 CRUD、Markdown 转换、评论协作、文档搜索与管理。

本地 / 文件操作、WPS 桌面应用问题排查、Notion / Google Docs 等其他平台、与 AirPage 无关的通用浏览器自动化。

2026年WPS-AirPage-Skill的介绍

相关推荐