dsh-flutter-tools
用于 DSH 侧边栏的 Flutter 面板：VM Service 连接、热重载/热重启、重建跟踪、性能分析、内存和网络捕获，以及基于 flutter-devtools-mcp 的一键性能会话
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:nikitafedorov008/dsh-flutter-tools#83f540a34216fdc89331e6abd5157bfcae1e917eFlutter Tools 以 dsh-flutter-tools 发布，当前版本为 0.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A Flutter panel for the DeepSeek Harness sidebar: run, inspect and profile a Flutter app without leaving the conversation.
Devices come from a long-lived flutter daemon, launching is flutter run --machine with the VM
Service URI picked up automatically, and everything else goes through the running app's own VM
Service and flutter-devtools-mcp.
flutter daemon (events, not polling): a phone plugged in appears by
itself. The section shows one selected device with its OS logo (Apple, Android, Windows, Linux, or
a browser for web targets) plus a small kind icon; clicking opens the list to switch, and the
choice is remembered per project. Emulators come from the same daemon.--dart-define pairs, then one
button that runs or stops depending on the state. The panel reads app.debugPort and connects
itself; app logs land in the panel.productFlavors,
non-default Xcode schemes); defines are a key/value editor. Both are remembered per project and
validated before they reach the command line.debugPaint,
showPerformanceOverlay, repaintRainbow, debugPaintBaselinesEnabled, timeDilation,
inspector.show.collect_performance_session with the workspace root filled in.pub get, pub outdated, flutter doctor with rendered output:
pub outdated becomes a table with the upgradable rows highlighted, flutter doctor a checklist..fvm/flutter_sdk, then .fvmrc) wins over whatever is on
PATH.DeepSeek Harness → Settings → Add plugin, then paste this repository's address. That field takes
a plugin package name, a GitHub repository address or a local directory. The CLI takes the same spec
(dsh plugin add …); note that a profile the desktop app manages refuses CLI changes, so the plugin
manager is the usual route.
Requirements:
PATH is the fallback);npx on PATH — flutter-devtools-mcp is fetched on first use;dsh-better-sidebar for the sidebar tab;debug (rebuild tracking) or profile (metrics).| File | Half | Role |
|---|---|---|
index.js | host (Cordis) | registers the /flutter routes, owns the flutter daemon, the flutter run child and the flutter-devtools-mcp child, serves panel.html |
panel.html | served page | the whole UI, plain HTML/CSS/JS — no build step |
client.js | client bundle | registers the sidebar tab whose body is an iframe onto /flutter |
icon.svg | manifest asset | the icon the plugin manager shows, declared as icon in package.json |
cordis.patch.yml | bundle patch | the mount row; its name must equal the package name so the client bundle is served at /plugins/dsh-flutter-tools/client.js |
dev-server.mjs | development | runs the same routes outside DSH for UI iteration |
docs/ | development | the screenshots above |
All under /flutter, loopback Host only.
| Route | Purpose |
|---|---|
GET /flutter | the panel page (?cwd=&sessionId=) |
GET /flutter/config | workspace cwd, fvm pin, resolved Flutter, toggle labels |
GET /flutter/devices | live device list (daemon) |
GET /flutter/emulators | emulators from the daemon |
GET /flutter/flavors | flavors found in the project (Android blocks + Xcode schemes) |
GET /flutter/run | launch state: running, appId, mode, flavor, defines, VM Service URI, log tail |
POST /flutter/run | launch on a device: { deviceId, mode, flavor, defines } |
POST /flutter/run/stop | stop the launched app |
POST /flutter/run/detach | leave the app running, stop tracking it |
POST /flutter/emulator/launch | boot an emulator: { emulatorId } |
GET /flutter/devtools | DevTools page URL: ?page=…&uri= |
GET /flutter/extensions | registered debug extensions plus their current state |
POST /flutter/extension | toggle one extension: { name, value } (allowlist only) |
GET /flutter/heap | heap usage of the main isolate (?uri=) |
POST /flutter/gc | collect garbage, then report heap usage |
POST /flutter/command | one-shot CLI: pub_get | pub_outdated | doctor |
POST /flutter/call | flutter-devtools-mcp tool call: { tool, arguments } (allowlist only) |
Things that cost time, recorded so nobody pays twice.
flutter daemon --machine is not a valid flag: it exits 2 with no output. The daemon speaks
the same protocol without it.flutter emulators --machine does not exist either.--show-web-server-device is deliberately not passed: measured, it changes exactly one thing — the
synthetic web-server device appears in the list — and nothing here depends on it.flutter run, flutter daemon and npx are wrappers: the real process is a grandchild (dartvm),
so a plain child.kill() leaves it running. Children are spawned detached and killed by process
group — except after app.detach, where a group kill would take the detached app down with it, so
the tool is killed by pid instead.app.detach (still alive 20 s later), while
the app it launched survives on its own.isolateId for getMemoryUsage, and has no collectAllGarbage RPC —
that is what getAllocationProfile(gc: true) is for.ext.flutter.brightnessOverride is not offered as a toggle: it reports the platform's effective
brightness, so "off" still reads as dark on a dark system and the switch would lie.--dart-define is compile-time: a changed define takes effect on the next launch, not on a hot
restart.pub outdated keeps its column header at the top, and a tail
clip left the panel with rows it could not parse.icon in package.json; there
is no HTTP route for it, and the path must stay inside the manifest directory.MIT — see LICENSE.
node dev-server.mjs 9100 /path/to/flutter/project # the panel, outside DSH
Screenshots in docs/ were taken from that dev server with Chrome in dark mode at device scale 2.
The tab icon and the plugin icon are Flutter's mark, taken from simple-icons (CC0). Flutter is a trademark of Google; the mark is used here only to label Flutter tooling.