Skip to content

feat(miniapp): add GML practice log project archive manager - #141

Open
basetier-gml wants to merge 1 commit into
MiniMax-AI:mainfrom
basetier-gml:feat/gml-practice-notes-miniapp
Open

basetier-gml wants to merge 1 commit into
MiniMax-AI:mainfrom
basetier-gml:feat/gml-practice-notes-miniapp

Conversation

@basetier-gml

@basetier-gml basetier-gml commented Nov 16, 2026 •

Copy link
Copy Markdown

What

Adds GML 练习记录 · 项目存档管理器 — the check-in web app "Gml代码练习记录"
rebuilt as a Mini App for MiniMax Code 3.1.11 or later.

  • Multi-project archive manager. Each practice notebook is its own JSON save
    file; the list is re-read from disk on every load, so deleting or editing a
    file by hand is picked up. Deleted projects move to a recycle bin tracked in
    trash-index.json and can be restored; projects can be exported and imported.
  • Practice notes. Check-in records (prompt, hint, ordered code carriers —
    操作描述 / 脚本 / 对象), an API library (name, one-line description, parameter
    list, referenced by records), a check-in calendar, daily goals, streaks and a
    shareable long image.
  • Version management. A built-in copy of the web app works offline; "fetch
    latest version" downloads it from the configured source into the Mini App data
    directory, and "restore built-in" drops the cache. Save data always lives in
    the data directory, whichever copy is in use.
  • Agent access. A hosted MCP server (gml-notes) with six tools —
    list_projects, get_project, search_notes, list_api_library,
    create_project, export_backup — plus a matching Skill. Note bodies are
    edited in the page only; MCP deliberately exposes no write path for them.
  • Interface. Chinese/English shell, keyboard-accessible dialogs with focus
    trapping and focus return, verified with NVDA 2026.3.1 and a 480 px viewport.

Layout

plugins/basetier-gml/miniapp-44928b90-e36d-46c5-9f7e-4d3d5ac5cda0/
├── .minimax-plugin/plugin.json     manifest (name = directory name, author = basetier-gml)
├── miniapp/
│   ├── miniapp.json                runtime + surface + mcpEndpoints + engines
│   ├── client/                     the manager UI and the built-in web app copy
│   └── node/                       node:http server, MCP endpoint, API surface
├── skills/gml-practice-notes/      Skill describing the MCP tools and the boundary
├── servers.mcp.json                MCP server declaration
├── README.md  LICENSE  icon.png  package.json

Data and access

Everything is written under the Mini App data directory only
(GML-Saves/, GML-Trash/, GML-App/, exports/); writes are atomic
(temp file + rename). The only network request is the user-initiated
"fetch latest version" download of the web app. No data is uploaded anywhere,
and no Connector, device, navigation or Agent-run access is requested.

Check

npm run validate

→ plugins/basetier-gml/miniapp-44928b90-e36d-46c5-9f7e-4d3d5ac5cda0: OK
→ repository: OK

Tested on MiniMax Code 3.1.16 (Windows x64). The Node runtime uses only
built-in modules — no dependencies, no build step.

Notes

  • The embedded web app comes from
    basetier-gml/gml-practice-log
    (MIT), credited in the package README.
  • The web app is embedded in an iframe, so its own "存档 / 读档 / 清空缓存 /
    新手教程 / 切换语言" menu entries are hidden by the manager; everything is
    driven from the manager instead.

Autofix with [code]smith
Open in [code]smith · Need help on this PR? Tag @codesmith-bot with what you need.

Add the GML Practice Log Mini App (MiniMax Code 3.1.11+):

- Multi-project archive manager for GameMaker (GML) practice notes;
  each project is its own JSON save file with an API library, ordered
  code carriers, a recycle bin and per-project export/import.
- Built-in copy of the check-in web app plus fetch-latest and
  restore-built-in version management, cached in the Mini App data
  directory.
- Hosted MCP server (gml-notes) with 6 tools so the Agent can list,
  read and search practice notes; a matching Skill documents the
  boundary (note bodies are edited in the page, not via MCP).
- Interface shell in Chinese/English, keyboard accessible dialogs with
  focus trapping and focus return.

Register the package in both root README tables.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant