核心用法
幕布集成 Skill 提供完整的幕布笔记 API 封装，以 MubuClient 类为核心，支持手机号登录、文档/文件夹全生命周期管理、Markdown 双向转换。用户通过环境变量配置凭据后，可调用 Python API 或 CLI 完成：创建文档/文件夹、递归搜索、内容更新、批量导出等操作。Token 采用本地缓存+自动刷新策略（2小时有效期，到期前5分钟自动重登），并实施原子写入与权限隔离（0600）保障安全。
显著优点
- Markdown 完整往返：真正的双向转换，支持任务列表
[ ]/[x]、备注引用>、多级缩进，而非早期占位实现 - 智能鉴权机制：Token 自动刷新、401 仅重试1次防死循环、403 不触发重登，兼顾稳定性与安全性
- CLI 友好：15+ 命令覆盖完整工作流，支持
--json原始输出与--export markdown直接导出 - 本地搜索能力：递归遍历所有子文件夹，大小写不敏感匹配，无需反复调用远程列表接口
- 安全加固：Token 文件原子写入+600权限，避免并发损坏与权限泄露
潜在局限
- 非官方 API：基于逆向分析，存在随官方更新失效的风险，稳定性依赖维护跟进
- 功能边界：折叠状态
expand、有序列表1.、图片/附件、多标题嵌套逻辑等未完全支持 - 凭据依赖：必须提供明文手机号/密码，无 OAuth 等更安全的授权方式
- 频率风险：官方未公开限流策略，高频调用可能触发封禁
适合人群
幕布重度用户、知识管理自动化需求者、需要将幕布纳入本地工作流的技术工作者，以及追求大纲笔记与 Markdown/Git 生态互通的效率工具爱好者。
常规风险
- 账号安全风险：密码明文存储于环境变量或本地文件，多用户系统需额外防护
- API 变更风险：非官方接口无兼容性承诺，建议锁定 Skill 版本并关注更新
- 数据丢失风险：Markdown 导入时媒体内容、复杂格式可能丢失，关键文档建议先备份
- Token 泄露风险：虽文件权限已限制，但本地磁盘加密仍需用户自行保障