From ffe714278b8ef88007a60e5eafdd1ecb7f13e2d2 Mon Sep 17 00:00:00 2001 From: BlueRose <378100977@qq.com> Date: Thu, 9 Apr 2026 12:21:49 +0800 Subject: [PATCH] vault backup: 2026-04-09 12:21:49 --- .../WY/MCP&Skill/POPO 云文档MCP&Skill.md | 54 ++++++++----------- 1 file changed, 22 insertions(+), 32 deletions(-) diff --git a/07-Other/AI/AI Agent/WY/MCP&Skill/POPO 云文档MCP&Skill.md b/07-Other/AI/AI Agent/WY/MCP&Skill/POPO 云文档MCP&Skill.md index 25e1a83..b033ff2 100644 --- a/07-Other/AI/AI Agent/WY/MCP&Skill/POPO 云文档MCP&Skill.md +++ b/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)与防火墙规则。 \ No newline at end of file +## 备注 +该Skill现阶段仍处于开发阶段,如果遇到问题请加入 群号:7271072,@楼嘉杰来解决。 \ No newline at end of file