mingdao-harness 0.1.55 → 0.1.57

package/README.md

@@ -85,7 +85,8 @@ cd MingDao-Harness && bash install.sh
 ### 桌面版（Electron）
 
 ```bash
-npm run desktop          # 源码直跑（自动启动内置 WebUI 并打开窗口）
+mingdao desktop          # 任意目录启动桌面版（首次运行会提示安装 Electron，带镜像指引）
+npm run desktop          # 等价写法（需在仓库目录内）
 ```
 
 - 内置服务零端口暴露（127.0.0.1 随机端口 + 一次性令牌）、系统托盘常驻、窗口状态记忆、

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mingdao-harness",
-  "version": "0.1.55",
+  "version": "0.1.57",
   "description": "明道 MingDao —— 开源智能体框架（Agent Harness）。零依赖、开箱即用，针对 DeepSeek-V4 系列优化，开放主流模型接入。",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -86,6 +86,7 @@ const HELP_LINES = [
   ['  mingdao update [--check]   一键自更新（git 安装形态；--check 只对比版本）', null],
   ['  mingdao rollback           回滚到上次 update 之前的提交', null],
   ['  mingdao audit [数量]       查看工具调用审计日志（默认最近 20 条）', null],
+  ['  mingdao desktop            启动桌面版（Electron，任意目录可用，托盘常驻）', null],
   ['  mingdao --help / --version 帮助 / 版本', null],
   ['', null],
   ['凭证管理（API Key 独立存储，绝不写入 config.json / 仓库）', C.bold + C.yellow],
@@ -302,6 +303,7 @@ async function main() {
       ['sync', 'sync'],
       ['skill', 'skill'], ['web', 'skill'], ['sessions', 'skill'],
       ['key', 'key'],
+      ['desktop', 'desktop'],
     ];
     const hit = dispatchTable.find(([name]) => name === opts.prompt[0]);
     if (hit) {

package/src/commands/desktop.js

@@ -0,0 +1,42 @@
+// 命令族：mingdao desktop —— 任意目录启动 Electron 桌面版
+// 定位仓库 → 检查 desktop/node_modules 里的 electron → 拉起；缺依赖给出镜像安装指引。
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { findRepoRoot } from '../update.js';
+
+export async function handleDesktop(args) {
+  const repo = findRepoRoot();
+  if (!repo) {
+    console.log('mingdao desktop 需要「仓库安装形态」（npm 全局安装不含桌面壳）。');
+    console.log('  方案一（推荐）：下载三平台安装包（GitHub Releases 或 CI 产物，带自动更新）；');
+    console.log('  方案二：git clone 任一平台仓库后，在仓库目录运行 mingdao desktop。');
+    console.log('  克隆地址：https://gitee.com/MingDaoTCM/MingDao-harness · https://gitcode.com/MingDaoTCM/MingDao-Harness');
+    process.exitCode = 1;
+    return true;
+  }
+  const desktopDir = path.join(repo, 'desktop');
+  if (!fs.existsSync(path.join(desktopDir, 'main.js'))) {
+    console.log('[错误] 仓库缺少 desktop/ 目录（版本过旧？先运行 mingdao update）。');
+    process.exitCode = 1;
+    return true;
+  }
+  const isWin = process.platform === 'win32';
+  const localBin = path.join(desktopDir, 'node_modules', '.bin', isWin ? 'electron.cmd' : 'electron');
+  if (!fs.existsSync(localBin)) {
+    console.log('[提示] 首次运行需要安装 Electron（约 120MB，仅桌面版构建依赖，运行时仍零依赖）：');
+    console.log(`  cd "${desktopDir}"`);
+    console.log('  npm install');
+    console.log('  国内网络先执行：export ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/（Windows 用 set）');
+    process.exitCode = 1;
+    return true;
+  }
+  console.log('正在启动 明道 MingDao 桌面版…（窗口弹出即成功；托盘常驻，关闭窗口 = 最小化到托盘）');
+  const child = spawn(localBin, [desktopDir], { cwd: desktopDir, stdio: 'ignore', detached: true });
+  child.on('error', (err) => {
+    console.log('[错误] 启动 Electron 失败：' + (err?.message || err));
+    process.exitCode = 1;
+  });
+  child.unref(); // CLI 退出后应用继续运行
+  return true;
+}