vault backup: 2026-04-09 12:21:49

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

@@ -1,38 +1,28 @@
-# 提示词
-我想使用Nodejs构建一个能帮用户操作POPO云文档的MCP以及对应的Skill。请帮我分析./docs/har 下的har文件，之后帮我编写。
+# 简介
+**MATRIX-AITA POPO 云文档操作 Skill** 是公司内部首个公开的云文档编辑Skill。它彻底解决了以往 AI Agent “只能看、不能写”的痛点，通过强大的自动化能力，让 AI 助手真正拥有了替你处理文档、整理表格、甚至管理多维数据的“双手”，是提升团队办公效率的硬核神器。
 
-## 技术选型
-我打算使用：
-后端技术：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 能够像人类专家一样精准、丝滑地操控文档。
+## 功能介绍
+- 📄 **文档（深度创作与排版）** 你可以指挥 AI 从零开始撰写项目建议书或会议纪要，它不仅能生成文字，还精通排版逻辑。它支持自动插入 1 到 5 级标题、符号列表以及有序列表，让文档结构层次分明。除了创建新文档，你还可以让它在现有文档末尾追加灵感，或者随时远程重命名文档，让文档管理变得动动嘴就能搞定。
+- 📊 **表格（智能数据录入）** 繁琐的数据录入和报表更新现在可以全权交给 AI 处理，它能精准地在指定的单元格中填入内容。你可以要求它为关键数据标记背景色以示提醒，或者批量修改某一区域的字体格式，快速生成美观的进度表。即便面对海量数据，它也能通过“精准定位”修改特定数值，再也不用在大表中拉动滚动条寻找目标了。
+- 📝 **Markdown（专业技术文档生成）** 这是为开发者和技术同学准备的排版利器，AI 可以为你生成包含代码块、数学公式以及 Mermaid 流程图的高质量内容。它支持标准的 Markdown 语法，能够完美处理复杂的引用、分割线和链接，确保技术文档既专业又易读。无论是编写 README 还是整理技术方案，它都能确保输出的内容格式工整、开箱即用。
+- **🗄️ 多维表格（自动化数据中心）** 你可以把复杂的任务追踪、资产管理或人员名单交给 AI 来打理，它支持多维表格的各项核心操作。无论是新增一条任务记录，还是修改某个单选、日期字段的状态，AI 都能像数据库管理员一样精准执行。它还能帮你快速查询表内的现有记录，并根据逻辑自动汇总信息，让你的多维表格真正变成一个能自我更新的智能系统。
+- **👥 团队空间（无缝跨部门协作）** 该 Skill 突破了个人文档的限制，能够直接在公司各级“团队空间”中大显身手。它能自动识别团队的目录结构，在指定的页面或文件夹下创建子文档，并自动处理复杂的协作权限验证。这意味着你可以授权 AI 自动更新团队周报、维护公共知识库，让所有团队成员都能实时共享到 AI 辅助生成的最新成果。
 
 ---
 
-## 🛠️ 技术亮点与“降维打击”优势
-### 1. 协议级深度集成 (Protocol-Level Mastery)
-不同于市面上常见的简单 HTTP 模拟，该 Skill 深度实现了 **ShareJS OT (Operational Transformation)** 协议。
-- **毫秒级同步**：支持 WebSocket 实时连接，直接在文档树（Leaves）上进行原子级操作。
-- **冲突无感解决**：内置 `opSent` 防护与版本验证，彻底告绝 OT 冲突导致的标题丢失或内容混乱。
-    
+## 操作步骤介绍
+### 1. 安装Skill
+进入 https://skills.netease.com/skills/skill_b67793104fac
+复制安装命令给Agent或者下载该Skill，最后让Agent帮你安装。
+### 2. 自动化授权（获取 Cookie）
+无需手动查代码，直接运行我们提供的脚本即可（也可让Agent帮忙运行）：
+- **双击运行**：在 `tools` 目录中找到 `collect-cookies_GBK.bat` 并双击。
+- **告知 Agent**：登录完成后，回到对话窗口对 Agent 说 **“我登录了”**，它将自动完成后续的 Token 采集与保存。    
 
-### 2. 恐怖的场景覆盖力 (Universal Support)
-一个 Skill，搞定所有文档类型：
-- **文档**：
-- **表格**：完美处理复杂的嵌套块结构与单元格属性。
-- **Markdown**：支持 ProseMirror 模型，精准操控标题、代码块及 Mermaid 图表。
-- **多维表格 (MTable)**：攻克了最复杂的 Socket.IO `/room` 命名空间连接与 `location-param` 鉴权难题。
-### 3. 企业级团队空间兼容性
-专门针对**团队空间 (Team Space)** 开发了降级策略：
-- 当标准 HTTP API 返回 403 权限限制时，Skill 会自动切换至 **WS Connect -> Snapshot -> Disconnect** 的“潜行模式”，确保在复杂权限体系下依然稳健运行。
+### 3. 开始使用
+授权完成后，你就可以尝试给 Agent 下达类似下方的指令了：
+- _“把这个表格里 A1 到 D1 的背景色改成黄色。”_
+- _“读取多维表格‘项目进展’中所有状态为‘进行中’的记录。”_
 
-### 4. “零门槛”的自动化运维
-- **智能 Cookie 采集**：内置基于 Chrome DevTools Protocol 的双版本 `.bat` 工具，自动处理端口转发（Portproxy）与防火墙规则。 
+## 备注
+该Skill现阶段仍处于开发阶段，如果遇到问题请加入 群号：7271072，@楼嘉杰来解决。