前言¶
调用墨墨记忆卡做批量维护时，常见两条路都不够顺：一是人工在 App 里逐张改，二是自己对着开放 API 现拼请求，字段、鉴权、权限报错都要自己试。MaiMemo Markji API 这个 Skill 把墨墨官方开放 API 的常用操作收拢成一套可直接调用的能力，并额外提供专业版会员权限识别，减少来回试错。下面介绍它的定位、能力和使用方式。
这是什么¶
MaiMemo Markji API（墨墨记忆卡）是一个基于通用 SKILL.md 格式的 Agent Skill，坐标 @user_f5bfb364/maimemo-markji-api，由 user_f5bfb364 发布，来源为 community，分类 dev-programming，当前版本 1.0.0。
它解决的问题是：让 Agent 通过墨墨官方开放 API 完成记忆卡的查询、媒体上传、以及预览确认后的卡片创建与更新，而不是让开发者自己写脚本对接。Skill 需要 API Key（标签中标注 requires_api_key=true），并在提供能力的同时识别专业版会员权限，给出中文操作引导。
核心功能¶
按 SkillHub 页面已核实的简介，能力包括：
1、查询文件夹、牌组、章节和卡片，覆盖墨墨记忆卡的主要组织层级。
2、上传图片和音频文件，用于给卡片补充媒体素材。
3、上传或查询媒体文件，可回查已上传内容。
4、在预览确认后安全创建或更新卡片，避免误写。
5、直接输入 Token，不依赖隐式环境配置。
6、专业版权限诊断，识别当前账号是否具备所需权限。
7、中文操作引导，降低上手门槛。
适用触发词按官方介绍包括：墨墨记忆卡官方 API、MaiMemo OpenAPI、Markji 牌组/章节/卡片、OpenAPI ID、MAIMEMO_TOKEN、403 或 markji plus required。出现这些表述时可以考虑启用该 Skill。
安装与启用¶
已抓取资料中未给出官方安装命令、目录或配置项写法。以下为核实路径，不要照抄占位内容：
- Skill 页面：https://www.skillhub.cn/skills/user_f5bfb364/maimemo-markji-api
- 官方地址：https://api.skillhub.cn/user_f5bfb364/maimemo-markji-api
- 坐标：
@user_f5bfb364/maimemo-markji-api
需要说明的是，该 Skill 标注 requires_api_key=true，启用前应准备好墨墨开放 API 的访问凭据。是否支持 Cursor、Codex CLI、Claude Code 等具体环境，已抓取资料没有分别说明，本文不展开；请在 SkillHub 页面查看安装与启用方式。
典型用法¶
已抓取资料给出的是能力清单，没有逐条命令示例。按能力划分，可复现的操作路径如下：
1、需要先看账号权限时，走专业版权限诊断，判断当前 Token 是否满足操作所需。
2、需要了解资料结构时，先查文件夹，再查牌组、章节，最后落到卡片。
3、需要补充素材时，先上传图片或音频，再查询媒体文件确认结果。
4、需要写卡片时，先走预览确认，再执行创建或更新，避免直接落库造成误改。
命令、路径和接口名以 Skill 页面与墨墨开放 API 文档为准。遇到 403 或 markji plus required 这类响应时，先做权限诊断，再决定是补专业版权限还是换操作方式。
适用场景与注意¶
适合需要程序化管理墨墨记忆卡的开发者：批量查询结构、补充媒体素材、在受控预览后更新卡片，以及排查专业版权限问题。
需要注意：
1、该 Skill 属于 community 来源，发布者为 user_f5bfb364，使用前按官方页面确认最新能力与限制。
2、需要 API Key，凭据管理要自己负责，不要写进公开仓库。
3、写操作走预览确认，适合对一致性有要求的场景；追求全自动写入的流程要自行评估风险。
4、资料中未给出安装命令与跨编辑器差异说明，环境兼容性需要在实际使用环境验证。
结束¶
MaiMemo Markji API 的价值在于把墨墨官方开放 API 的查询、媒体和卡片写入收拢为可调用的 Skill，并提供权限诊断与中文引导，减少对接与排错时间。官方地址：https://api.skillhub.cn/user_f5bfb364/maimemo-markji-api。
