墨墨记忆卡

要解决的问题

手动维护墨墨记忆卡时，开发者和自动化脚本常要在网页、牌组目录、章节列表和卡片正文之间反复切换。复制牌组名、章节链接或网页 ID 很容易把内部 ID 当成 OpenAPI ID；上传图片和音频后的引用语法也缺少统一验证；请求体格式、认证方式和专业版权限边界散落在文档各处，写错后往往只返回权限或校验错误。这个技能把官方开放接口收敛成一组 Python 子命令，让 Codex 在对话中按只读优先、预览确认的方式执行操作。

核心能力与关键步骤

• 认证：支持网页版 API Key、开放平台 24 小时临时 Token、App 内长期 Token；凭证只在当前进程内存中使用，并通过 Authorization: Bearer 调用接口。
• 只读查询：使用 folders、decks、deck、chapters、chapter、card 先获取 OpenAPI ID，再查询章节、文件或卡片内容。
• 文件上传：upload-file 与 query-files 支持图片 [Pic#ID/#] 和音频 [Audio#A,ID/#]；默认先预览，不加 --execute 不会发送请求。
• 卡片写入：create-card、update-card 把牌组和章节 OpenAPI ID 放在 URL 路径中，JSON 请求体只发 card，可选 order；先预览，再创建测试卡回查，确认后才继续批量。
• 权限检查：先运行 folders 或 decks --limit 1；遇到 common.permission_denied 且 markji plus required 时，应提示专业版会员权限不足，而不是让用户先重置 Token 或改请求格式。

适用边界

• 生产地址固定为 https://open.maimemo.com/open/api/v1，除非用户明确要求测试环境。
• 只实现官方 OpenAPI 文档公开的接口和字段；不创建文件夹、牌组、章节，也不删除卡片。
• 文档未定义卡片正文语法、媒体引用语法时，不自行推断。
• 遵守频控：10 秒 20 次、60 秒 40 次、5 小时 2000 次；写入必须先预览确认，创建超时或连接中断后不自动重试。