@lancewu602/mihomo-dash 0.6.0 → 0.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lancewu602/mihomo-dash",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "mihomo 管理工具：CLI + 守护进程 + Web 面板",
   "type": "module",
   "license": "MIT",

package/server/CHANGELOG.md

@@ -5,6 +5,20 @@
 
 ## [Unreleased]
 
+## [0.6.2] - 2026-10-31
+
+### 修复
+
+- `service uninstall` / `service start` 回显的动作命令按作用域生成：system 作用域下不再印
+  `systemctl --user …`（真实执行的 argv 本来就不带 `--user`，只有文案错）
+
+## [0.6.1] - 2026-10-31
+
+### 修复
+
+- CLI 与生成的服务定义里不再提「自启」页：`status` 的提示改为 `mihomo-dash service install`，
+  unit 头注释改为「由 `mihomo-dash service install` 生成」；`--help` 里 Debian 作用域不再只写 `--user`
+
 ## [0.6.0] - 2026-10-31
 
 ### 新功能

package/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mihomo-dash-server",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "private": true,
   "type": "module",
   "description": "mihomo-dash 后端源码（作为 mihomo-dash 的一部分发布，不单独发包）",

package/server/src/cli/index.js

@@ -22,13 +22,13 @@ const HELP = `mihomo-dash —— mihomo 管理工具：CLI + Web 面板
 用法: mihomo-dash [命令]
 
   status              总览：内核 / 面板 / 系统代理 / 开机自启（默认命令；内核不通时退出码 1）
-  service <子命令>    开机自启：print / install / uninstall / status（macOS launchd · Debian systemd --user）
+  service <子命令>    开机自启：print / install / uninstall / status（macOS launchd · Debian systemd）
 
   -V, --version       版本
   -h, --help          帮助
 
   面板进程不再由自带的守护进程管理：交给系统服务管理器，服务定义指向 server/src/index.js（面板）
-  与 server/src/kernel/run.js（内核），用上面的 service 子命令或在面板「自启」页安装。
+  与 server/src/kernel/run.js（内核），开机自启用上面的 service 子命令。
   内核的装 / 升 / 卸用面板的「内核」页，进程启停在侧栏底部；系统代理开关也不在 CLI（用面板顶栏的
   胶囊开关或配置页的「系统代理」卡片）。（面板默认 http://127.0.0.1:8981）
 

package/server/src/cli/service.js

@@ -5,11 +5,12 @@
  * 但平台面不一样，**不要照抄 deck 的实现**：
  *
  * - deck 只跑 Linux + **system** 单元（`/etc/systemd/system`，要 root）；
- * - 这里要同时支持 **macOS（launchd）与 Debian（systemd --user）**，而且**是用户级**、不需要 root；
+ * - 这里要同时支持 **macOS（launchd 用户级）与 Debian（systemd system 与 --user 两种）**：
+ *   Debian 默认 system（要 root、开机即起），--user 是备选；macOS 只有用户级；
  *   两个平台都交给 `createServiceManager()`（`server/src/shared/service.js`），CLI 只管打印结果。
  * - 两个 job：`panel`（server/src/index.js）与 `kernel`（server/src/kernel/run.js）。
  *
- * 行为与面板「自启」页保持一致：**装/卸都不停正在跑的进程**（这个面板很可能正是被服务拉起来的），
+ * 行为约定：**装/卸都不停正在跑的进程**（这个面板很可能正是被服务拉起来的），
  * 「只开机拉起一次、不保活」（launchd 不写 KeepAlive、systemd 写 Restart=no）。
  */
 import { ownKernelRunning } from '../kernel/lifecycle.js';

package/server/src/cli/status.js

@@ -197,7 +197,9 @@ export function formatStatus(d) {
       bits.push(`已运行 ${duration(panel.uptime)}`);
     out.push(line('面板', `运行中 · ${panel.url} · ${bits.join(' · ')}`));
   } else {
-    out.push(line('面板', `未运行（端口 ${panel.port}；在面板「自启」页装成系统服务）`));
+    out.push(
+      line('面板', `未运行（端口 ${panel.port}；用 \`mihomo-dash service install\` 装成系统服务）`),
+    );
   }
 
   // 系统代理
@@ -220,7 +222,7 @@ export function formatStatus(d) {
   if (!autostart.supported) {
     out.push(line('开机自启', autostart.hint ? `不支持（${autostart.hint}）` : '不支持'));
   } else if (!autostart.installed) {
-    out.push(line('开机自启', '未安装（面板「自启」页打开开关即可）'));
+    out.push(line('开机自启', '未安装（`mihomo-dash service install`）'));
   } else {
     const where = autostart.platform === 'darwin' ? 'macOS LaunchAgent' : 'systemd --user';
     out.push(

package/server/src/shared/service.js

@@ -143,7 +143,7 @@ export function renderUnit(job, opts) {
   const entry = opts.entry ?? opts.entries[job];
   const argv = [opts.node, entry, ...def.args({ port, host })];
   const log = def.log(opts.cliDir);
-  return `# 由面板「自启」页生成（server/src/shared/service.js），勿手改 —— 重新点「安装」会覆盖
+  return `# 由 \`mihomo-dash service install\` 生成（server/src/shared/service.js），勿手改 —— 重新安装会覆盖
 # 作用域：${scope === 'system' ? 'system（/etc/systemd/system，以 root 运行，开机即起）' : 'user（~/.config/systemd/user，登录后启动 or linger）'}
 [Unit]
 Description=${def.description}
@@ -227,6 +227,8 @@ export function createServiceManager(options = {}) {
   const scope = platform === 'linux' ? (options.scope ?? (isRoot ? 'system' : 'user')) : 'user';
   /** systemd 的公共参数：system 作用域不带 `--user` */
   const systemdArgs = scope === 'system' ? [] : ['--user'];
+  /** 回显给人看的 systemctl 前缀，必须与 systemdArgs 一致 */
+  const systemctlCmd = ['systemctl', ...systemdArgs].join(' ');
   /** launchd 的域：GUI 会话固定在 gui/<uid>，只有 SSH 时会话里退到 user/<uid> */
   const domains = [`gui/${uid}`, `user/${uid}`];
   const dir = serviceDir({ platform, home, scope, systemDir: options.systemDir });
@@ -433,7 +435,7 @@ export function createServiceManager(options = {}) {
       const stillLoaded = platform === 'darwin' && !!(await loadedDomain(job));
       if (platform === 'linux') {
         const r = await run('systemctl', [...systemdArgs, 'disable', jobOf(job).unit]);
-        if (r.ok) actions.push(`systemctl --user disable ${jobOf(job).unit}`);
+        if (r.ok) actions.push(`${systemctlCmd} disable ${jobOf(job).unit}`);
         else if (r.stderr && !/not loaded|does not exist|No such file/i.test(r.stderr)) {
           errors.push(`${job}: ${r.stderr.trim()}`);
         }
@@ -541,7 +543,7 @@ export function createServiceManager(options = {}) {
         else errors.push(`${j}: ${r.stderr.trim() || 'launchctl kickstart 失败'}`);
       } else {
         const r = await run('systemctl', [...systemdArgs, 'start', jobOf(j).unit]);
-        if (r.ok) started.push(`systemctl --user start ${jobOf(j).unit}`);
+        if (r.ok) started.push(`${systemctlCmd} start ${jobOf(j).unit}`);
         else errors.push(`${j}: ${r.stderr.trim() || 'systemctl start 失败'}`);
       }
     }

package/server/tests/service.test.js

@@ -106,7 +106,7 @@ test('plist：路径里的 XML 特殊字符会被转义', () => {
 
 test('systemd 单元：ExecStart 固定 argv、Restart=no、日志 append', () => {
   const unit = renderUnit('panel', OPTS());
-  assert.match(unit, /^# 由面板「自启」页生成/m);
+  assert.match(unit, /^# 由 `mihomo-dash service install` 生成/m);
   assert.match(unit, /Description=mihomo-dash 面板/);
   assert.match(
     unit,
@@ -252,6 +252,36 @@ test('Linux 安装/卸载：daemon-reload + enable --now / disable（不 --now
   assert.ok(!calls.some((c) => c.includes('--now') && c.includes('disable')));
 });
 
+test('Linux system 作用域：回显的动作命令不带 --user', async () => {
+  const { run, calls } = stubRun();
+  // system 作用域默认写 /etc（测试里换成临时目录，别碰本机）
+  const systemDir = path.join(tmpDir, 'etc-systemd');
+  const svc = createServiceManager({
+    run,
+    platform: 'linux',
+    scope: 'system',
+    systemDir,
+    home,
+    cliDir,
+  });
+  await svc.install({ port: 8982, host: '0.0.0.0' });
+  // 真正执行的命令本来就不带 --user；回显文案以前写死了 --user，照着抄会失败
+  assert.ok(calls.some((c) => c.join(' ') === 'systemctl enable --now mihomo-dash-panel.service'));
+
+  const started = await svc.start();
+  assert.deepEqual(started.started, [
+    'systemctl start mihomo-dash-panel.service',
+    'systemctl start mihomo-dash-kernel.service',
+  ]);
+
+  const res = await svc.uninstall();
+  assert.deepEqual(res.actions, [
+    'systemctl disable mihomo-dash-panel.service',
+    'systemctl disable mihomo-dash-kernel.service',
+  ]);
+  assert.deepEqual(res.errors, []);
+});
+
 test('Linux 安装：manualRunning 的 job 只 enable（不 --now），不拉第二个实例', async () => {
   const { run, calls } = stubRun();
   const svc = createServiceManager({ run, platform: 'linux', home, cliDir });

package/server/tests/status.test.js

@@ -194,7 +194,7 @@ test('内核不通：如实说原因 + 给启动去处（退出码由 cmdStatus
   assert.match(out, /^开机自启\s+/m);
 });
 
-test('面板没起：如实说，并指向「自启」页', async () => {
+test('面板没起：如实说，并指向 service install', async () => {
   const closed = await new Promise((resolve) => {
     const srv = http.createServer();
     srv.listen(0, '127.0.0.1', () => {
@@ -207,7 +207,10 @@ test('面板没起：如实说，并指向「自启」页', async () => {
   const out = mods.status.formatStatus(d);
   assert.match(
     out,
-    new RegExp(`^面板\\s+未运行（端口 ${closed}；在面板「自启」页装成系统服务）$`, 'm'),
+    new RegExp(
+      '^面板\\s+未运行（端口 ' + closed + '；用 `mihomo-dash service install` 装成系统服务）$',
+      'm',
+    ),
   );
 });
 
@@ -247,7 +250,7 @@ test('平台不支持 / 没装：系统代理与开机自启各写一行，不
   });
   const out2 = mods.status.formatStatus(off);
   assert.match(out2, /^系统代理\s+关（系统直连，内核照跑）$/m);
-  assert.match(out2, /^开机自启\s+未安装（面板「自启」页打开开关即可）$/m);
+  assert.match(out2, /^开机自启\s+未安装（`mihomo-dash service install`）$/m);
 });
 
 test('某个块抛错：只记下原因，不连累别的块', async () => {