Files
BlueRoseNote/07-Other/AI/AI Agent/WY/MCP&Skill/POPO 云文档MCP&Skill.md

2.2 KiB
Raw Blame History

提示词

我想使用Nodejs构建一个能帮用户操作POPO云文档的MCP以及对应的Skill。请帮我分析./docs/har 下的har文件之后帮我编写。

技术选型

我打算使用: 后端技术nodejs、Fastify、Mongoose、fastify-jwt 数据库MongoDB 工具函数Axios、pnpm

🚀 POPO 云文档 Skill (popo-docs-skill) 介绍文档

🌟 核心愿景:重新定义云办公自动化

popo-docs-skill 是公司内部首个实现全协议栈覆盖全生命周期管理的公开云文档编辑 Skill。它不仅仅是一个简单的 API 包装器,而是一套深入 POPO 云文档底层逻辑ShareJS OT 协议、Socket.IO的生产力引擎。

通过 55 个精雕细琢的原子化工具,它彻底打破了 AI 与企业协同软件之间的“最后一公里”障碍,让 AI 能够像人类专家一样精准、丝滑地操控文档。


🛠️ 技术亮点与“降维打击”优势

1. 协议级深度集成 (Protocol-Level Mastery)

不同于市面上常见的简单 HTTP 模拟,该 Skill 深度实现了 ShareJS OT (Operational Transformation) 协议。

  • 毫秒级同步:支持 WebSocket 实时连接直接在文档树Leaves上进行原子级操作。
  • 冲突无感解决:内置 opSent 防护与版本验证,彻底告绝 OT 冲突导致的标题丢失或内容混乱。

2. 恐怖的场景覆盖力 (Universal Support)

一个 Skill搞定所有文档类型

  • 文档
  • 表格:完美处理复杂的嵌套块结构与单元格属性。
  • Markdown:支持 ProseMirror 模型,精准操控标题、代码块及 Mermaid 图表。
  • 多维表格 (MTable):攻克了最复杂的 Socket.IO /room 命名空间连接与 location-param 鉴权难题。

3. 企业级团队空间兼容性

专门针对团队空间 (Team Space) 开发了降级策略:

  • 当标准 HTTP API 返回 403 权限限制时Skill 会自动切换至 WS Connect -> Snapshot -> Disconnect 的“潜行模式”,确保在复杂权限体系下依然稳健运行。

4. “零门槛”的自动化运维

  • 智能 Cookie 采集:内置基于 Chrome DevTools Protocol 的双版本 .bat 工具自动处理端口转发Portproxy与防火墙规则。