cq-viewer 1.4.0: white-model render, conversation folders, orbit around the pressed point

README.md

@@ -68,7 +68,7 @@ The MiniMax Code Agent communicates through the host MCP client. Business reques
 | [Pomodoro Sit Reminder](plugins/1602winxp/pomodoro-sit-timer/) | A Pomodoro timer that only counts: an in-page sit reminder and sound when a segment ends, with no timer lock and no enforced rest length; reminders from a single file or a folder in sequence or shuffled, with single-track loop and loudness matching | [1602WinXP](https://github.com/1602WinXP) |
 | [灵签易占 / Chinese Divination](plugins/weekbin/chinese-divination/) | Cast hexagrams with the Plum Blossom method (time, number, three-coin, or daily), read the result through the classical body/use rules, and browse all sixty-four hexagrams with a ganzhi almanac | [weekbin](https://github.com/weekbin) |
 | [Session Trajectory](plugins/avatasia/mmc-trajectory/) | Browse a conversation's model trajectory: messages, reasoning, tool calls and results, Token usage, and per-turn timing | [avatasia](https://github.com/avatasia) |
-| [CadQuery Viewer](plugins/hanzijie/cq-viewer/) | View STL / STEP models from your project (STEP keeps assembly part names, colours, and real CAD edges), watch models pushed from CadQuery scripts, and mark positions on the model to send to the conversation in one click; MCP tools let the AI add model folders and open models, and a CadQuery parametric-design skill is bundled | [HanZijie](https://github.com/HanZijie) · [flowful-ai](https://github.com/flowful-ai) |
+| [CadQuery Viewer](plugins/hanzijie/cq-viewer/) | Opened in a conversation, lists the STL / STEP models in that conversation's folder (STEP keeps assembly part names, colours, and real CAD edges) and orbits around whatever point you press on; watch models pushed from CadQuery scripts, and mark positions on the model to send to the conversation in one click; one more click has a background Agent render the current view's white model into a finished product image with MiniMax image generation, following your own description; MCP tools let the AI add model folders and open models, and a CadQuery parametric-design skill is bundled | [HanZijie](https://github.com/HanZijie) · [flowful-ai](https://github.com/flowful-ai) |
 | [MiniMax Bot](plugins/minimax-ai/minimax-bot/) | **Official plugin** that turns MiniMax Code into an always-on team of Bots: a Chief Bot builds the team, group chats hand work between members with `@` mentions, and every Bot has its own memory, scheduled tasks, and usage stats. Requires MiniMax Code 3.1.2 or later | [MiniMax-AI](https://github.com/MiniMax-AI) |
 | [心屿 / Xinyu Island](plugins/yujiachen-y/xinyu-daily/) | A cozy daily-mood island that plays like an indie game: an inspiration card shaped by your answers, mood stickers, a joy jar, a decision slot machine, a Book of Answers, and 20 hidden secrets guarded by a grumpy crab. Optionally, Xiaoyu writes you a daily letter and chats with you using your model. Requires MiniMax Code 3.1.2 or later | [yujiachen-y](https://github.com/yujiachen-y) |
 | [MoMo Collab](plugins/amszuidas/momo-collab/) | A project steward that turns stray thoughts, screenshots, and links into ideas, writes clear ideas up as tasks, runs each task in its own Agent session with a full handoff, checks the result against your done criteria, and tracks everything on a board. Requires MiniMax Code 3.1.2 or later | [amszuidas](https://github.com/amszuidas) |

README.zh-CN.md

@@ -68,7 +68,7 @@ MiniMax Code Agent 通过宿主 MCP 客户端与 MiniApp 协作。业务请求
 | [番茄钟 · 久坐提醒](plugins/1602winxp/pomodoro-sit-timer/README.zh-CN.md) | 只计时的番茄钟：工作段结束在页面内弹出久坐提醒并响铃，不锁状态、不限制休息时长；提醒音支持单文件或文件夹、顺序/随机播放、单曲循环与响度匹配 | [1602WinXP](https://github.com/1602WinXP) |
 | [灵签易占](plugins/weekbin/chinese-divination/README.zh-CN.md) | 梅花易数起卦与解卦：时间、数字、铜钱摇卦、每日一卦四法起卦，按体用生克断吉凶，另备六十四卦全文与干支历法 | [weekbin](https://github.com/weekbin) |
 | [会话轨迹](plugins/avatasia/mmc-trajectory/README.zh-CN.md) | 按轮次浏览一段会话的模型轨迹：消息流、思考过程、工具调用与结果、token 用量与每轮耗时 | [avatasia](https://github.com/avatasia) |
-| [CadQuery Viewer](plugins/hanzijie/cq-viewer/README.zh-CN.md) | 本地查看项目里的 STL / STEP（保留装配零件名称、颜色和真实边线），实时显示 CadQuery 脚本推送的模型，在模型上标注位置后一键发给 AI；AI 可通过 MCP 工具添加模型文件夹、打开模型，并内置 CadQuery 参数化建模 skill | [HanZijie](https://github.com/HanZijie) · [flowful-ai](https://github.com/flowful-ai) |
+| [CadQuery Viewer](plugins/hanzijie/cq-viewer/README.zh-CN.md) | 在对话里打开时列出对话所在文件夹里的 STL / STEP（保留装配零件名称、颜色和真实边线），按住哪里就绕哪里旋转；显示 CadQuery 脚本推送的模型，在模型上标注位置后一键发给 AI；再点一下，后台 Agent 用 MiniMax 图像生成把当前视角的白模渲染成成品图，可补充自己的描述；AI 可通过 MCP 工具添加模型文件夹、打开模型，并内置 CadQuery 参数化建模 skill | [HanZijie](https://github.com/HanZijie) · [flowful-ai](https://github.com/flowful-ai) |
 | [MiniMax Bot](plugins/minimax-ai/minimax-bot/) | 【官方插件】把 MiniMax Code 变成常驻的 Bot 团队：总管 Bot 帮你组建团队，群聊里用 `@` 在成员之间交接工作，每个 Bot 有自己的记忆、定时任务和用量统计；需要 MiniMax Code 3.1.2 或更高版本（说明文档为英文） | [MiniMax-AI](https://github.com/MiniMax-AI) |
 | [心屿](plugins/yujiachen-y/xinyu-daily/README.zh-CN.md) | 像独立小游戏的每日心情小岛：由你的回答决定的今日灵感卡、心情贴纸、小确幸罐子、纠结老虎机、答案之书，还有坏脾气螃蟹藏起来的 20 个秘密；可选开启小屿陪伴，借用你的模型每天写信、陪你聊天。需要 MiniMax Code 3.1.2 或更高版本 | [yujiachen-y](https://github.com/yujiachen-y) |
 | [协作 · MoMo](plugins/amszuidas/momo-collab/README.zh-CN.md) | 项目管家 MoMo：把随手的想法、截图和链接攒成想法，写清后变成任务，派 Agent 会话带着完整背景去执行，按验收标准核对结果后交你审核，进展在看板上一眼可见。需要 MiniMax Code 3.1.2 或更高版本 | [amszuidas](https://github.com/amszuidas) |

docs/agent.md

@@ -19,6 +19,12 @@ at runtime; a page that only prepares text for the user to send should use
 
 - `agentAccess` in `miniapp/miniapp.json` is the only grant. Absent or `[]` means no access:
   `context.agent` is absent and page calls reject with `not_permitted`.
+- `"session.read"` (MiniMax Code 3.1.4 or later, observed on 3.1.4-preview) adds read access to
+  sessions: on the page, `agent.session()` with no argument returns the chat the Mini App is open in
+  (`sessionId`, `title`, `agent`, `status`, `workspaceDir`, `isDefaultWorkspace`, `createdAtMs`,
+  `updatedAtMs`, `model`, `lastAssistantText`) and rejects with `not_permitted` when it is not open
+  in a chat; `agent.session(sessionId)` reads one session and `agent.sessions()` lists the user's
+  sessions with their titles and folders. Read only what you need and say so in the README.
 - `agentConcurrency` (1–32, default 4) caps how many turns of this Mini App run at once. Each session
   runs one turn at a time. Further `run` / `answer` calls wait in order, up to four times
   `agentConcurrency`; beyond that they fail with `busy`.

docs/package-contract.md

@@ -115,9 +115,10 @@ No other keys are allowed inside `mcode`. Other top-level keys (`name`, `type`,
 - `hostConnectorAccess` is optional: `{ "providers": string[] }`, each matching
   `^[a-z0-9_-]{1,64}$` and unique. Declared providers are granted by the Host at install time; this
   repository does not document their use.
-- `agentAccess` is optional. The only allowed value is `["session.run"]`, which lets the Mini App
-  run Agent turns; absent or `[]` means no Agent access. See `docs/agent.md` before declaring it.
-  Requires MiniMax Code 3.1.2 or later.
+- `agentAccess` is optional: an array of `"session.run"` (run Agent turns) and `"session.read"`
+  (read sessions: the page's `agent.session()` returns the chat it is open in, see `docs/agent.md`).
+  Absent or `[]` means no Agent access. See `docs/agent.md` before declaring it. Requires MiniMax
+  Code 3.1.2 or later; `"session.read"` requires 3.1.4 or later.
 - `agentConcurrency` is optional: an integer from 1 to 32, default 4. It caps how many Agent turns
   of this Mini App run at once; it has no effect without `agentAccess`. Requires MiniMax Code 3.1.2
   or later.
@@ -172,6 +173,7 @@ the package cannot be installed there at all.
 | --- | --- | --- |
 | `agents` | `plugin.json` | 3.1.2 |
 | `agentAccess` | `miniapp/miniapp.json` | 3.1.2 |
+| `agentAccess` with `"session.read"` | `miniapp/miniapp.json` | 3.1.4 |
 | `agentConcurrency` | `miniapp/miniapp.json` | 3.1.2 |
 | `surface.window` | `miniapp/miniapp.json` | 3.1.2 |
 

plugins/hanzijie/cq-viewer/.minimax-plugin/plugin.json

@@ -2,15 +2,16 @@
   "schemaVersion": 1,
   "name": "cq-viewer",
   "displayName": "CadQuery Viewer",
-  "version": "1.2.1",
-  "description": "本地 3D 模型查看器：浏览项目文件夹里的 STL / STEP（保留装配零件名称、颜色和真实边线），接收 CadQuery 脚本推送的模型，在模型上标注位置并一键发给 AI。AI 可以通过 MCP 工具登记模型文件夹、在查看器里打开模型；内置 flowful-ai 的 CadQuery 参数化建模 skill。",
+  "version": "1.4.0",
+  "description": "本地 3D 模型查看器：在对话里打开时列出对话所在文件夹里的 STL / STEP（保留装配零件名称、颜色和真实边线），勾选才打开，按住哪里就绕哪里旋转，触控板和鼠标都能平移缩放；接收 CadQuery 脚本推送的模型，在模型上标注位置并一键发给 AI；一键把当前视角的白模交给后台 Agent，用 MiniMax 图像生成渲染成成品图，可补充自己的描述。AI 可以通过 MCP 工具登记模型文件夹、在查看器里打开模型；内置 flowful-ai 的 CadQuery 参数化建模 skill。",
   "author": "HanZijie, flowful-ai",
   "icon": "icon.png",
   "category": "Code",
   "exampleQueries": [
     "打开 CadQuery Viewer 看一下这个项目里的模型",
     "用 CadQuery Viewer 打开这个 STEP 装配",
-    "我在 Viewer 里标注了几个位置，读一下再改模型"
+    "我在 Viewer 里标注了几个位置，读一下再改模型",
+    "打开 CadQuery Viewer，把这个模型渲染成产品图"
   ],
   "apps": [],
   "mcpServers": [