[codex] 新增微信小程序开发者 Mini App

README.md

@@ -57,6 +57,7 @@ The MiniMax Code Agent communicates through the host MCP client. Business reques
 
 | MiniApp | What it does | Author |
 | --- | --- | --- |
+| [WeChat Mini Program Developer](plugins/adherez/wechat-miniprogram-preview/) | Develop and preview WeChat Mini Programs and Mini Games locally, with page interaction, live updates, runtime logs and error diagnostics | [AdhereZ](https://github.com/AdhereZ) |
 | [Dynamic Workflow Console](plugins/stevenjj33/workflow-console/) | Run and supervise MiniMax Code dynamic workflows from one page: live status, a stage-and-dependency flow graph, per-node output, approval and control, templates, and report export | [stevenjj33](https://github.com/stevenjj33) |
 | [MiniMax Photo](plugins/webguhui/minimax-photo/) | Layered image editing with an in-app AI assistant, local recovery and programmatic editing tools | [WebGuHui](https://github.com/WebGuHui) |
 | [MiniMax Video](plugins/webguhui/minimax-video/) | Local video editing with captions, a host Agent assistant, reviewable timeline edits, and MP4/MP3 export | [WebGuHui](https://github.com/WebGuHui) |

README.zh-CN.md

@@ -57,6 +57,7 @@ MiniMax Code Agent 通过宿主 MCP 客户端与 MiniApp 协作。业务请求
 
 | MiniApp | 功能 | 作者 |
 | --- | --- | --- |
+| [微信小程序开发者](plugins/adherez/wechat-miniprogram-preview/README.zh-CN.md) | 用于微信小程序与小游戏的本地开发预览，支持页面交互、自动更新、运行日志和错误排查 | [AdhereZ](https://github.com/AdhereZ) |
 | [动态工作流控制台](plugins/stevenjj33/workflow-console/README.zh-CN.md) | 在一个页面里运行并盯住 MiniMax Code 动态工作流：实时状态、按阶段与依赖画出的流程图、节点输出、审核与控制、模板与报告导出 | [stevenjj33](https://github.com/stevenjj33) |
 | [MiniMax Photo](plugins/webguhui/minimax-photo/) | 图层图片编辑、应用内 AI 助手、本地恢复与程序化编辑工具 | [WebGuHui](https://github.com/WebGuHui) |
 | [MiniMax Video](plugins/webguhui/minimax-video/) | 本地视频剪辑、字幕、宿主 Agent 助手、可预览的时间线修改与 MP4/MP3 导出 | [WebGuHui](https://github.com/WebGuHui) |

plugins/adherez/wechat-miniprogram-preview/.gitignore

@@ -0,0 +1,4 @@
+node_modules/
+tests/.scratch/
+.DS_Store
+*.zip

plugins/adherez/wechat-miniprogram-preview/.minimax-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "schemaVersion": 1,
+  "name": "wechat-miniprogram-preview",
+  "displayName": "微信小程序开发者",
+  "version": "0.5.0-rc.4",
+  "description": "用于微信小程序与小游戏的本地开发预览，支持页面交互、自动更新、运行日志和错误排查。",
+  "author": "开发者insider",
+  "icon": "icon-wechat-devtools-6dae8e16.png",
+  "category": "Code",
+  "exampleQueries": [
+    "一句话生成像素风飞机大战微信小游戏，并预览试玩",
+    "一句话生成贪吃蛇微信小游戏，并预览试玩",
+    "一句话生成待办清单微信小程序，并预览交互"
+  ],
+  "apps": [],
+  "mcpServers": [
+    "servers.mcp.json"
+  ],
+  "skills": [
+    "skills/wechat-project-preview/SKILL.md"
+  ]
+}

plugins/adherez/wechat-miniprogram-preview/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 AdhereZ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Asset exception: icon-wechat-devtools-6dae8e16.png is Tencent WeChat DevTools brand material and is not
+covered by this MIT license. See docs/assets.md for provenance and usage limits.

plugins/adherez/wechat-miniprogram-preview/README.md

@@ -0,0 +1,145 @@
+# WeChat Mini Program Developer
+
+English | [简体中文](README.zh-CN.md)
+
+**微信小程序开发者** is a community MiniMax Code Mini App for developing and previewing an
+**existing native WeChat project**. It compiles
+WXML/WXSS/JavaScript/TypeScript into a browser approximation, or runs a Canvas2D/WebGL mini game,
+inside the same preview plugin. It does not replace your project with a generated HTML app.
+
+The page contains a phone preview and one **Refresh preview** button. Project selection, build
+errors, runtime logs and recovery are handled through the chat's MCP tools. The interface and
+bundled workflow skill are currently in Chinese.
+
+## Features
+
+- Native project discovery from `project.config.json`, `app.json`, or `game.json`; JS/TS, CommonJS,
+  ESM and prebuilt npm module graphs. Taro/uni-app projects must first produce native output.
+- Page/component rendering using bundled glass-easel 1.2.0 and its miniprogram adapter, with a
+  custom WXML/WXSS bridge and a limited `wx` API implementation.
+- Retained page stacks: `navigateTo`, `navigateBack`, `redirectTo`, `switchTab`, `reLaunch` and
+  `getCurrentPages`. Returning preserves instances, native input drafts, scroll positions and
+  animation timelines, rather than replaying the page's initial animation.
+- Separate Canvas2D/WebGL mini-game runtime, local images, orientation/DPR handling and chat-side
+  pause/resume/restart controls.
+- Source watching, debounced rebuilds, immutable build resources and project-scoped persistent
+  Storage with revision checks. Automatic rebuilds are **not state-preserving HMR**.
+- A fixed, decorative WeChat-style capsule and device notch. Capsule colors follow navigation
+  configuration (default white, explicit black supported), not scrolling page content. The
+  simulated status bar shows time, Wi-Fi and battery, without a cellular signal icon.
+
+## Install and open
+
+The runtime bundles are committed: **installation requires no npm install or build**.
+
+1. Copy this complete directory, including `.minimax-plugin`, into
+   `<dataDir>/plugins/wechat-miniprogram-preview/`. The default `dataDir` is `~/.minimax`; use your
+   configured directory if different. Do not include the `adherez` parent directory.
+2. Follow the repository's [installation instructions](../../../README.md#2-install). Do not
+   copy over a running plugin without first saving/exporting any pending preview data.
+3. In your project chat, ask:
+
+   ```text
+   Use the installed wechat-miniprogram-preview Mini App to preview this native WeChat project.
+   Reuse this plugin; do not create a replacement HTML Mini App or modify project code just to open it.
+   ```
+
+The bundled `wechat-project-preview` skill tells the Agent to list existing previews, open the
+explicit project path, and execute the returned **`hostOpenAction`** with the Host's `miniapp`
+tool. A successful compile alone does not open the side panel. Internal paths such as
+`/preview?previewId=...` are Host routes, not public links or ordinary browser URLs.
+
+Opening `/preview` without a preview ID shows an empty-state instruction; it never selects another
+chat's project automatically. Normal explicit project opens do not require a second directory
+authorization dialog. An occupied preview is not automatically taken over.
+
+## Tested environment
+
+- MiniMax Code **3.1.4**, macOS on Apple Silicon; Node.js 22 for development checks.
+- The local development version has been installed and started through the desktop Host. Native
+  Mini Program and Canvas2D/WebGL demo previews have been exercised during development.
+- Page-stack, capsule/default-color and notch changes have focused Node/jsdom tests and isolated
+  Chromium checks. The final cellular-icon removal was installed without an additional visual
+  acceptance pass; do not interpret that as a new full Host acceptance run.
+- Windows, Linux desktop hosts, real-device rendering, large game engines, and the exact
+  public-package install flow have not been manually verified. No claim of complete parity with
+  WeChat DevTools or a WeChat device is made.
+
+## Data & access
+
+- **Files read:** the explicit project directory's supported source/configuration/media files,
+  its configured source root and referenced local dependencies; the plugin's own runtime/demo
+  assets. No project scripts, package install commands, or Node business modules are executed by
+  the compiler. It checks canonical paths, directory identity and resource/size limits, rejecting
+  broad system/home/configuration roots and escaping links. These checks are not a per-chat
+  filesystem permission sandbox; only preview projects you trust.
+- **Files written:** preview descriptors (including canonical project paths), Storage and migration
+  metadata under the Host-provided **`context.dataDir`**. This directory is treated as opaque.
+  The runtime does not edit your project, read Host credentials, inspect chat history, or depend on
+  Host database locations. User-requested Storage export downloads a JSON file through the browser.
+- **Network:** Node makes no outbound requests. Its HTTP/MCP/SSE server binds only the Host-assigned
+  loopback address/port. The preview iframe allows **HTTPS image URLs authored by the project**
+  (`img-src https:`), which can contact arbitrary project-chosen image hosts and disclose usual
+  network metadata; there is no fixed host allowlist. `wx.request` and other network APIs are not
+  implemented; iframe `connect-src` is `none`. There is no analytics or upload service.
+- **Processes:** the plugin spawns none. MiniMax Code starts its Node runtime. Development-only
+  build/test commands are run explicitly by contributors, not during installation or startup.
+- **Agent turns:** the Mini App page does not run Agent turns and declares no `agentAccess` or
+  `hostConnectorAccess`. The surrounding chat Agent can invoke the declared `wechat-preview` MCP
+  tools and read build diagnostics/logs. Logs may contain application text; do not log secrets in
+  a project you preview. Storage recovery passes metadata to the Agent, not saved business data.
+- **Execution boundary:** project JavaScript runs in an opaque sandboxed iframe (`allow-scripts`,
+  no `allow-same-origin`), without Node or Host credentials. The interpreter requires CSP
+  `unsafe-eval`. This is not an arbitrary-malicious-code sandbox: loops can stall rendering,
+  HTTPS images can make requests, and browser scheduling is not a native debugger.
+
+## Refresh, state and recovery
+
+Within one live preview, navigation retains up to 10 page entries. Returning calls `onShow`; it
+does not suppress project code that deliberately reloads data there. Rebuild, manual refresh,
+device changes and runtime restarts replace the iframe: page-stack memory and uncommitted input
+are lost, while confirmed Storage and the last route persist.
+
+Storage is scoped by canonical project directory, not chat. Multiple previews of the same
+directory share saved data and use revision/CAS checks. A project has a 1 MiB JSON Storage limit.
+The process permits at most 8 preview descriptors, 4 active projects and 4 connected preview
+pages. Resource limits return diagnostics rather than silently closing another preview.
+
+On conflicts, lost responses or occupied previews, use `preview_status` / `preview_logs` and the
+reported recovery actions. `takeover`, `discard_local` and `close` require explicit confirmation.
+Do not keep creating new previews or editing private state files to bypass ownership. Before
+updates, export valuable pending data; stop/start only this Mini App if the Host retains an old
+runtime. Reopen its original `previewId` after restart. Saved Storage is not a backup of page memory.
+
+## Known limitations
+
+This is an H5 approximation, not the WeChat runtime or compiler. It does not implement login,
+payment, cloud services, scanning, real-device preview, upload/release, Worker/WASM, open-data
+contexts, game subpackage loading or the full WeChat API. WebAudio and several native controls
+are unsupported. Custom tab bars, complex WXS/CSS, native navigation transitions and EventChannel
+are not fully reproduced. The capsule is decoration, not a working WeChat menu/exit button.
+
+## Development
+
+From this package directory, use Node.js 22 and pnpm 9.15.9:
+
+```sh
+pnpm install --frozen-lockfile
+pnpm run build
+node --test tests/client.test.mjs tests/page-stack.test.mjs tests/viewport-controls.test.mjs
+node --test tests/project-access.test.mjs tests/preview-service.test.mjs tests/project-storage.test.mjs
+node --test tests/preview-http.test.mjs tests/game-http.test.mjs tests/shell-protocol.test.mjs
+node scripts/package.mjs /absolute/path/to/wechat-preview.zip
+```
+
+The build regenerates the committed vendor bundles and their notices. The packaging script
+includes the runtime, skill, README files, LICENSE and docs, but not dependencies, tests or build
+sources. Its isolated import/compile/jsdom checks do not prove Host rendering. From the repository
+root also run `npm run check` before contributing.
+
+[Architecture and tools](docs/architecture.md) · [MIT License](LICENSE) (code only; the application
+icon is excluded, see [asset attribution](docs/assets.md)). Third-party bundle
+licenses are preserved in `miniapp/client/vendor/THIRD-PARTY-NOTICES.txt` and
+`miniapp/node/vendor/THIRD-PARTY-NOTICES.txt`. No WeChat DevTools/WorkBuddy executable, SDK bundle or user project is included. The application
+icon comes from WeChat DevTools; it remains Tencent brand material, not MIT-licensed code. This
+is not a Tencent product and is not affiliated with or endorsed by Tencent.