核心用法
幕布集成 Skill 提供对幕布(mubu.com)极简大纲笔记工具的 API 自动化能力。该 Skill 基于逆向分析实现,非官方开放平台支持。核心功能包括:手机号密码登录获取 JWT Token、文件夹与文档的 CRUD 操作、大纲结构的 JSON 数据交互,以及 Markdown 格式导出转换。
用户通过配置 MUBU_PHONE 和 MUBU_PASSWORD 环境变量完成认证,Token 有效期为 2 小时(access_token)/ 30 天(refresh_token),建议本地缓存并自动刷新。文档内容采用嵌套 JSON 结构表示大纲层级,支持递归转换为 Markdown 格式。
显著优点
1. 大纲思维工具集成:幕布本身以"极简大纲 + 一键思维导图"著称,适合结构化知识管理
2. 完整 CRUD 能力:覆盖登录、文件夹管理、文档创建/读取/更新/删除全流程
3. 格式互通:内置 Markdown 与幕布 JSON 格式的双向转换逻辑
4. 自动化工作流:支持批量创建项目文档结构、自动同步笔记内容等场景
潜在缺点与局限性
1. 非官方 API 风险:基于逆向分析,无官方文档支持,API 可能随版本更新失效
2. 稳定性隐患:未承诺向后兼容,存在服务中断或接口变更风险
3. 功能受限:无法实现幕布 Web 端的完整功能(如协作、分享、样式设置等)
4. Token 管理成本:短有效期 Token 需要额外的本地缓存与自动刷新机制
适合人群
- 需要将外部内容(如 AI 生成的大纲、Markdown 笔记)自动同步到幕布的重度用户
- 追求知识管理工作流自动化的开发者、产品经理、内容创作者
- 熟悉 Python 脚本操作、能接受非官方 API 风险的技术用户
常规风险
- 服务可用性:API 变更可能导致 Skill 突然失效,需关注维护更新
- 账号安全:密码以环境变量或明文形式存储,存在泄露风险;Token 本地存储需防止未授权访问
- 数据安全:非官方渠道的数据传输缺乏加密保障承诺
- 频率限制:频繁调用可能触发幕布的反爬机制导致账号受限