核心功能
幕布集成 Skill 提供对极简大纲工具幕布(mubu.com)的完整 API 封装,实现大纲与思维导图的自动化管理。
主要能力:
- 认证管理:手机号密码登录,JWT Token 自动刷新与本地安全缓存(
~/.mubu_token,权限0o600+ 跨进程锁) - 文档操作:创建/读取/更新/删除文档,文件夹层级管理,文档移动与搜索
- 格式转换:幕布 JSON 大纲 ↔ Markdown 双向无损转换,支持任务列表(
[ ]/[x])和备注(>) - CLI 工具:完整的命令行接口,支持脚本化批量操作
显著优点:
- Token 管理安全可靠,原子写入、权限隔离、自动过期处理
- Markdown 往返格式完整,保留大纲层级结构和任务状态
- 重试机制完善,401 错误自动重登(限1次),避免死循环
- 无第三方依赖,仅使用标准库 + requests
潜在局限:
- 基于逆向分析的非官方 API,存在接口变更风险
- 不支持图片/附件、有序列表、
expand折叠状态 - 多顶层标题导入时结构简化(首个为 root,其余为 children)
- 需用户自行承担频率控制和账号安全责任
适合人群:幕布重度用户、需要自动化大纲管理的知识工作者、追求 Markdown 工作流与思维导图联动的效率爱好者。
常规风险:API 稳定性无官方保障;Token 本地存储需防范文件泄露;delete 操作为不可逆真实删除,CLI 强制 --yes 确认;账号密码以环境变量或本地文件配置,需避免版本控制误提交。