核心用法
本Skill通过逆向工程实现幕布(mubu.com) API集成，提供完整的文档生命周期管理能力。用户可通过环境变量配置账号凭据后，使用CLI工具或Python函数完成登录认证、文件夹管理、文档CRUD、Markdown导入导出等操作。核心功能包括：手机号密码登录获取JWT Token（2小时有效期，自动刷新机制）、创建/删除/移动文件夹与文档、获取文档大纲结构、Markdown与幕布JSON格式的双向转换。
显著优点
1. Markdown原生支持：真正的Markdown往返转换，支持任务列表- [x]、备注引用> 、多级缩进层级，而非简单的占位实现。
2. 自动化Token管理：本地缓存Token至~/.mubu_token，自动检测过期（leeway 360秒）并重登刷新，写入时采用原子操作+600权限保护。
3. 防御性重试机制：401错误仅重试1次，避免密码错误或账号异常时的死循环；403等非鉴权错误不触发重登。
4. CLI完整覆盖：提供12+条命令，覆盖搜索、批量操作、文件导入等高频场景，支持--json原始输出便于脚本集成。
5. 纯函数设计：核心转换逻辑doc_to_markdown/markdown_to_doc为无状态纯函数，便于单元测试与跨平台移植。
潜在缺点与局限性
1. 非官方API风险：基于逆向分析，存在随官方版本更新失效的风险；无SLA保障，重大变更可能导致服务中断。
2. 功能边界限制：M1版本不支持图片/附件传输、有序列表1.、折叠状态expand保留；多顶层标题时结构归一化为root子节点。
3. 安全依赖本地环境：Token文件权限600仅防护属主泄露，若设备Root被攻破则凭据暴露；密码以明文形式存储于环境变量或配置文件。
4. 频率限制未量化：文档提及"避免频繁调用"，但未给出具体QPS阈值，存在触发限流的风险。
5. 刷新策略简化：未使用标准refresh_token流程，而是直接重新登录，增加账号异常检测概率。
适合人群
- 需要批量管理幕布文档的知识工作者
- 追求Markdown本地编辑+云端同步双工作流的用户
- 自动化构建知识库的技术型用户（需具备Python基础）
- 对API稳定性风险有认知、能接受偶发维护的尝鲜者
常规风险
- 账号安全：非官方授权方式，存在被判定为异常登录导致短期封禁的可能
- 数据一致性：Markdown转换的边界情况（复杂嵌套、混合列表）可能产生与预期不符的结构
- Token泄露：虽文件权限受限，但进程内存中的Token仍可能被恶意程序读取
- 服务可用性：无官方支持渠道，API变更后修复依赖社区维护节奏