vault backup: 2026-04-09 11:11:59

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

@@ -5,4 +5,34 @@
 我打算使用：
 后端技术：nodejs、Fastify、Mongoose、fastify-jwt
 数据库：MongoDB
-工具函数：Axios、pnpm
+工具函数：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）与防火墙规则。