Skip to content

Releases

v0.2.1 — MiMo Desktop Stable Release

Choose a tag to compare

@github-actions github-actions released this 17 Oct 21:03
278930a

MiMo Desktop 本机用量看板(零 AI 参与、纯离线)的稳定版。本版首次把交付链完整走通到实机。

交付链首次完整验收

  • 源码冻结:1848b5d28423735b347ca124ffa8ffecf6e72197
  • 发布提交:278930acf27719e2bbfdd6881cb193294d31b32d
  • 首次在同一版本上完整完成 源码验收 + 安装器验收 + MiMo Desktop 原生客户端验收 三段。
  • 客户端原生加载 B1–B4 全部通过:命令发现 → 执行 /usage → 执行 /usage-open → 卸载后命令消失。
  • P0/P1 缺陷 0 个。

功能

  • /usage:生成静态 HTML 看板快照,含 Token 用量、Session 用量、上下文占用三部分。
  • /usage-open:启动仅监听 127.0.0.1 的只读实时看板,可在页内刷新。
  • 安装 / 升级回滚 / 安全卸载:事务式安装器(Preflight → 备份 → 暂存 → 校验 → 应用 → 复核);任何阶段失败都会回滚本次改动。卸载只移除"能证明属于本项目且未被改动"的文件,报告、数据库与备份一律保留。

已验证环境

  • Windows MiMo Desktop 26.1014.65535.94 为已验证客户端版本。
  • Python ≥ 3.10,Node ≥ 18。

已知问题

  • #35:实时服务偶发启动失败(P2,已记录风险,本次验收未复现)。
  • #39:路径中含点开头的隐藏目录段(如 .mimo-sessions、.config)时,命令输出里的路径在 Markdown 渲染时会被吃掉一个反斜杠,显示路径需手工修补;不影响看板内容与统计正确性(P2)。

平台覆盖说明

除 Windows 外的其它平台尚未取得同等程度的实机验收证据:macOS / Linux 未做 MiMo Desktop 原生客户端验收,请按实验性支持看待。

安装

npm install -g mimo-usage-dashboard
mimo-usage-dashboard install

详细说明见 README.md。


完整变更记录(自动生成)

What's Changed

Full Changelog: v0.2.0...v0.2.1

v0.2.0 — Local-First Dashboard & Reliable Installer

Choose a tag to compare

@Martin-soaring-dev Martin-soaring-dev released this 15 Oct 07:36

MiMo Usage Dashboard v0.2.0

A major update introducing a local-first usage dashboard, a lightweight Python CLI, and a safer installation and upgrade system for MiMo Desktop.

✨ Highlights

📊 Usage Dashboard

  • Token usage statistics, including input, output, reasoning, and cache consumption.
  • Model usage breakdown and cache hit-rate visualization.
  • 12-month activity heatmap and recent usage trends.
  • Three dashboard views: Token Usage, Session Usage, and Context Usage.
  • Self-contained HTML reports that work offline.

⚡ Local-First Architecture

  • Rebuilt "/usage" using MiMo Desktop's native command mechanism.
  • Usage aggregation and HTML generation run locally without AI computation.
  • "/usage" generates a static HTML snapshot without starting a server.
  • "/usage-open" enables an optional loopback-only, read-only refresh service.
  • No telemetry or external data uploads.

🛠️ CLI & Installation

  • Added npm CLI commands for installation, upgrades, diagnostics, reporting, and uninstallation.
  • Introduced a transactional installer with preflight checks, backup, staging, validation, application, verification, and rollback.
  • Preserves existing MiMo configuration, including JSONC comments and formatting.
  • Protects user-modified files and refuses unsafe overwrites.
  • Supports repeatable installation and controlled upgrades.

🔒 Security & Reliability

  • Removed dynamic shell argument interpolation from MiMo slash commands.
  • Added installation ownership verification using file hashes and manifests.
  • Improved Windows path handling and database read-only access.
  • Added safer service lifecycle management and uninstall behavior.
  • Excluded local AI assistant memory from future Git tracking.

✅ Testing

  • Expanded automated tests covering Python, Node.js, CLI, installation, upgrades, rollback, and dashboard behavior.
  • Windows GitHub Actions CI passes on the release commit.

📦 Installation

Requirements:

  • Python 3.10+
  • Node.js 18+ for npm installation
  • MiMo Desktop

npm install -g mimo-usage-dashboard
mimo-usage-dashboard install

Restart MiMo Desktop, open a new session, and run:

/usage

For the refreshable dashboard:

/usage-open

Alternatively, use the Windows PowerShell installer from the repository.

📚 Documentation

See the "README" (https://github.com/Martin-soaring-dev/mimo-usage-dashboard#readme) for installation instructions, CLI usage, architecture details, and troubleshooting.

⚠️ Notes

  • Dashboard data is read from the local MiMo Desktop database.
  • "/usage" performs local processing, but MiMo Desktop may still use model tokens to relay the command result.
  • The optional refresh service listens only on the local loopback interface.
  • Existing installations should be upgraded using the supported installer rather than manually overwriting files.

Full Changelog: "View commits" (v0.1.2...v0.2.0)

What's Changed

New Contributors

Full Changelog: v0.1.0...v0.2.0