前言¶
調用墨墨記憶卡做批量維護時，常見兩條路都不夠順：一是人工在 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。
