@barryfan2045/dsh-matrix 0.1.0

package/dist/cli/log-filter.js

@@ -0,0 +1,40 @@
+/**
+ * `dsh-matrix logs/status` 的 journalctl argv 构建(纯函数)。
+ *
+ * 移植自 pi-courier src/log-filter.ts(spec #34),改语义:
+ * dsh-matrix 桥是单实例、日志行没有项目标签(logger 输出格式为
+ * `[ISO时间] [LEVEL] 正文`),故去掉 requestedProjects/availableLabels,
+ * 只保留 --level 阈值过滤。级别过滤原理不变:journalctl 不解析自定义字段,
+ * `-p` 在 StandardOutput=inherit 下无效,必须用 `--grep` 锚定行内 `[LEVEL] `。
+ * 要求 journalctl 带 PCRE2(`--grep`/`--case`);缺失时由 journalctl 报错,
+ * 不做静默降级。
+ */
+/** 下限阈值:`--level X` 显示 X 及更高级别。 */
+const LEVEL_ALTERNATIONS = {
+    debug: 'DEBUG|INFO|WARN|ERROR',
+    info: 'INFO|WARN|ERROR',
+    warn: 'WARN|ERROR',
+    error: 'ERROR',
+};
+export function parseFilterLevel(value) {
+    return value === 'debug' || value === 'info' || value === 'warn' || value === 'error'
+        ? value
+        : null;
+}
+export function buildLogFilterArgs(req) {
+    const args = ['--user', '-u', req.unit];
+    if (req.follow)
+        args.push('-f');
+    const level = parseFilterLevel(req.level);
+    if (!level) {
+        return { ok: false, message: `未知日志级别: ${req.level}(可选: debug / info / warn / error)` };
+    }
+    // level=debug 时不加 grep:全量放行(debug 阈值本就包含所有行)。
+    if (level !== 'debug') {
+        args.push('--grep', `\\[(${LEVEL_ALTERNATIONS[level]})\\] `, '--case=0');
+    }
+    if (req.lineCount !== undefined)
+        args.push('-n', String(req.lineCount));
+    return { ok: true, args };
+}
+//# sourceMappingURL=log-filter.js.map

package/dist/cli/log-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-filter.js","sourceRoot":"","sources":["../../src/cli/log-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,mCAAmC;AACnC,MAAM,kBAAkB,GAAgC;IACtD,KAAK,EAAE,uBAAuB;IAC9B,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,OAAO;CACf,CAAA;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO;QACnF,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,IAAI,CAAA;AACV,CAAC;AAeD,MAAM,UAAU,kBAAkB,CAAC,GAAqB;IACtD,MAAM,IAAI,GAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;IACjD,IAAI,GAAG,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAE/B,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,GAAG,CAAC,KAAK,mCAAmC,EAAE,CAAA;IACxF,CAAC;IAED,8CAA8C;IAC9C,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,kBAAkB,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;IAC1E,CAAC;IAED,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAA;IACvE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AAC3B,CAAC"}

package/dist/cli/pnpm-builds.d.ts

@@ -0,0 +1,32 @@
+/**
+ * profile 的 pnpm 构建许可(pnpm-workspace.yaml 的 allowBuilds)计划器(纯函数)。
+ *
+ * 背景:桥依赖 matrix-bot-sdk,后者硬依赖 @matrix-org/matrix-sdk-crypto-nodejs
+ * —— 原生 Rust 加密库,靠 postinstall 下载预编译二进制。pnpm v12 默认不跑依赖
+ * 的构建脚本,于是首次 `dsh plugin --profile <p> add dsh-matrix` 会以
+ * ERR_PNPM_IGNORED_BUILDS 非零退出:依赖其实已经写进 package.json,但命令失败,
+ * dsh 随即中止,profile 的 bundles 也就没挂上 —— 用户看到的现象是「装了却没生效」。
+ *
+ * pnpm 会把占位行留在 profile 的 pnpm-workspace.yaml 里
+ * (`'@matrix-org/matrix-sdk-crypto-nodejs': set this to true or false`),等人改成
+ * true。install-profile 在 `dsh plugin add` 之前先把它写对,首次安装一次过;
+ * 已经卡住的用户重跑 install-profile 同样能修好。
+ *
+ * 前置条件:`dsh plugin` 只在 profile 缺 package.json 时才初始化 profile,
+ * 所以本模块预建 profile 目录 + pnpm-workspace.yaml 不会被 dsh 覆盖。
+ */
+/** 需要构建许可的包(pnpm allowBuilds 的键)。 */
+export declare const CRYPTO_PACKAGE = "@matrix-org/matrix-sdk-crypto-nodejs";
+export interface PnpmWorkspacePlan {
+    action: 'create' | 'patch' | 'skip';
+    /** 要写入目标文件的完整内容(skip 时无意义)。 */
+    text: string;
+    reason: string;
+}
+/**
+ * 幂等计划:文件不存在(或空)→ create 预建模板;已有该键但值非 true(含 pnpm
+ * 留下的占位)→ patch 改成 true;已有 true → skip;无该键但已有 allowBuilds 段
+ * → 插进该段;两者都无 → 追加新段。
+ */
+export declare function planPnpmBuildAllowance(existing: string | null): PnpmWorkspacePlan;
+//# sourceMappingURL=pnpm-builds.d.ts.map

package/dist/cli/pnpm-builds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-builds.d.ts","sourceRoot":"","sources":["../../src/cli/pnpm-builds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,qCAAqC;AACrC,eAAO,MAAM,cAAc,yCAAyC,CAAA;AAkBpE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAA;IACnC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,CAqCjF"}

package/dist/cli/pnpm-builds.js

@@ -0,0 +1,73 @@
+/**
+ * profile 的 pnpm 构建许可(pnpm-workspace.yaml 的 allowBuilds)计划器(纯函数)。
+ *
+ * 背景:桥依赖 matrix-bot-sdk,后者硬依赖 @matrix-org/matrix-sdk-crypto-nodejs
+ * —— 原生 Rust 加密库,靠 postinstall 下载预编译二进制。pnpm v12 默认不跑依赖
+ * 的构建脚本,于是首次 `dsh plugin --profile <p> add dsh-matrix` 会以
+ * ERR_PNPM_IGNORED_BUILDS 非零退出:依赖其实已经写进 package.json,但命令失败,
+ * dsh 随即中止,profile 的 bundles 也就没挂上 —— 用户看到的现象是「装了却没生效」。
+ *
+ * pnpm 会把占位行留在 profile 的 pnpm-workspace.yaml 里
+ * (`'@matrix-org/matrix-sdk-crypto-nodejs': set this to true or false`),等人改成
+ * true。install-profile 在 `dsh plugin add` 之前先把它写对,首次安装一次过;
+ * 已经卡住的用户重跑 install-profile 同样能修好。
+ *
+ * 前置条件:`dsh plugin` 只在 profile 缺 package.json 时才初始化 profile,
+ * 所以本模块预建 profile 目录 + pnpm-workspace.yaml 不会被 dsh 覆盖。
+ */
+/** 需要构建许可的包(pnpm allowBuilds 的键)。 */
+export const CRYPTO_PACKAGE = '@matrix-org/matrix-sdk-crypto-nodejs';
+/** dsh 初始化 profile 时写的 pnpm-workspace.yaml 模板(我们补上 allowBuilds)。 */
+const BASE_TEMPLATE = `packages:
+  - .
+
+nodeLinker: hoisted
+autoInstallPeers: false
+`;
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+const KEY_RE = new RegExp(`^(\\s*)['"]?${escapeRegExp(CRYPTO_PACKAGE)}['"]?\\s*:\\s*(.*)$`);
+const ALLOW_LINE = `  '${CRYPTO_PACKAGE}': true`;
+/**
+ * 幂等计划:文件不存在(或空)→ create 预建模板;已有该键但值非 true(含 pnpm
+ * 留下的占位)→ patch 改成 true;已有 true → skip;无该键但已有 allowBuilds 段
+ * → 插进该段;两者都无 → 追加新段。
+ */
+export function planPnpmBuildAllowance(existing) {
+    if (existing === null || existing.trim() === '') {
+        return {
+            action: 'create',
+            text: `${BASE_TEMPLATE}allowBuilds:\n${ALLOW_LINE}\n`,
+            reason: `已预建 pnpm-workspace.yaml 并放行 ${CRYPTO_PACKAGE} 的构建脚本(否则首次安装会以 ERR_PNPM_IGNORED_BUILDS 失败)`,
+        };
+    }
+    const lines = existing.split('\n');
+    for (let i = 0; i < lines.length; i += 1) {
+        const matched = KEY_RE.exec(lines[i] ?? '');
+        if (matched === null)
+            continue;
+        const current = (matched[2] ?? '').trim();
+        if (current === 'true') {
+            return { action: 'skip', text: existing, reason: `${CRYPTO_PACKAGE} 的构建脚本已放行,未改动` };
+        }
+        lines[i] = `${matched[1]}'${CRYPTO_PACKAGE}': true`;
+        return {
+            action: 'patch',
+            text: lines.join('\n'),
+            reason: `已把 ${CRYPTO_PACKAGE} 的构建许可改为 true(原值「${current === '' ? '空' : current}」会挡住首次安装)`,
+        };
+    }
+    const allowIndex = lines.findIndex((line) => /^allowBuilds\s*:\s*$/.test(line));
+    if (allowIndex !== -1) {
+        lines.splice(allowIndex + 1, 0, ALLOW_LINE);
+        return { action: 'patch', text: lines.join('\n'), reason: `已在现有 allowBuilds 段补上 ${CRYPTO_PACKAGE}: true` };
+    }
+    const base = existing.endsWith('\n') ? existing : `${existing}\n`;
+    return {
+        action: 'patch',
+        text: `${base}allowBuilds:\n${ALLOW_LINE}\n`,
+        reason: `已新增 allowBuilds 段放行 ${CRYPTO_PACKAGE}`,
+    };
+}
+//# sourceMappingURL=pnpm-builds.js.map

package/dist/cli/pnpm-builds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-builds.js","sourceRoot":"","sources":["../../src/cli/pnpm-builds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,qCAAqC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,sCAAsC,CAAA;AAEpE,oEAAoE;AACpE,MAAM,aAAa,GAAG;;;;;CAKrB,CAAA;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;AACpD,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,eAAe,YAAY,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAA;AAE3F,MAAM,UAAU,GAAG,MAAM,cAAc,SAAS,CAAA;AAShD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAuB;IAC5D,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChD,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,GAAG,aAAa,iBAAiB,UAAU,IAAI;YACrD,MAAM,EAAE,+BAA+B,cAAc,6CAA6C;SACnG,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC3C,IAAI,OAAO,KAAK,IAAI;YAAE,SAAQ;QAC9B,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACzC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACvB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,cAAc,eAAe,EAAE,CAAA;QACrF,CAAC;QACD,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,cAAc,SAAS,CAAA;QACnD,OAAO;YACL,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YACtB,MAAM,EAAE,MAAM,cAAc,oBAAoB,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,WAAW;SAC1F,CAAA;IACH,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAC/E,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAA;QAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,wBAAwB,cAAc,QAAQ,EAAE,CAAA;IAC5G,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,CAAA;IACjE,OAAO;QACL,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,GAAG,IAAI,iBAAiB,UAAU,IAAI;QAC5C,MAAM,EAAE,uBAAuB,cAAc,EAAE;KAChD,CAAA;AACH,CAAC"}

package/dist/cli/profile-patch.d.ts

@@ -0,0 +1,26 @@
+/**
+ * profile 用户层 cordis.patch.yml 的 matrix-bridge 覆盖块生成(纯函数)。
+ *
+ * 桥插件以 bundle 方式挂进 profile 后,凭据/偏好由 profile 自己的
+ * cordis.patch.yml 按行 id `matrix-bridge` 覆盖 config(整 config 替换语义,
+ * spike 实测,见 docs/dsh-matrix-port-feasibility.md §9)。install-profile
+ * 用本模块把 ~/.dsh/dsh-matrix.json 变成那段 YAML。
+ *
+ * 所有标量用 JSON 字符串形式写出(YAML 双引号标量与其兼容),避免密码/URL
+ * 里的特殊字符破坏 YAML。
+ */
+import type { OpsConfig } from './config-store.ts';
+/** 生成 `- id: matrix-bridge …` 覆盖块(不含既有内容)。 */
+export declare function renderBridgePatch(cfg: OpsConfig): string;
+export interface ProfilePatchPlan {
+    action: 'create' | 'append' | 'skip';
+    /** 要写入目标文件的完整内容(skip 时无意义)。 */
+    text: string;
+    reason: string;
+}
+/**
+ * 幂等计划:文件不存在/为空/只剩 `[]` 占位→create;已有 matrix-bridge 行→skip
+ * (绝不覆盖用户手改的 profile);存在真实内容但无该行→append。
+ */
+export declare function planProfilePatch(existing: string | null, cfg: OpsConfig): ProfilePatchPlan;
+//# sourceMappingURL=profile-patch.d.ts.map

package/dist/cli/profile-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-patch.d.ts","sourceRoot":"","sources":["../../src/cli/profile-patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AASlD,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAUxD;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;IACpC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAoBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,SAAS,GAAG,gBAAgB,CAa1F"}

package/dist/cli/profile-patch.js

@@ -0,0 +1,56 @@
+const HEADER = '# 由 dsh-matrix install-profile 生成:桥凭据与偏好(整 config 替换语义)。';
+const ROW_ID = 'matrix-bridge';
+function yamlString(value) {
+    return JSON.stringify(value);
+}
+/** 生成 `- id: matrix-bridge …` 覆盖块(不含既有内容)。 */
+export function renderBridgePatch(cfg) {
+    const lines = [`- id: ${ROW_ID}`, '  config:'];
+    lines.push(`    homeserver: ${yamlString(cfg.homeserver)}`);
+    if (cfg.accessToken)
+        lines.push(`    accessToken: ${yamlString(cfg.accessToken)}`);
+    if (cfg.username)
+        lines.push(`    username: ${yamlString(cfg.username)}`);
+    if (cfg.password)
+        lines.push(`    password: ${yamlString(cfg.password)}`);
+    lines.push(`    trustedUsers: [${cfg.trustedUsers.map(yamlString).join(', ')}]`);
+    lines.push(`    workdir: ${yamlString(cfg.workdir)}`);
+    lines.push(`    logLevel: ${yamlString(cfg.logLevel ?? 'info')}`);
+    return `${HEADER}\n${lines.join('\n')}\n`;
+}
+/**
+ * 文件里除了注释和空行，是否只剩一个空数组占位 `[]`。
+ *
+ * dsh 初始化 profile 时写的模板正是「三段注释 + 一行 `[]`」（见 dsh-app-boot 的
+ * PROFILE_PATCH_TEMPLATE）。它**不是空文件**，语义上却等于"没有用户层配置"。
+ * 早先只判断 `trim() === ''`，于是模板会掉进 append 分支，产出
+ * `[]` 后面再跟 `- id: …` —— 那是**非法 YAML**（一个文档不能既结束于 flow
+ * sequence 又接着 block sequence），profile 直接解析失败、桥起不来。
+ */
+function isPlaceholderOnly(text) {
+    const meaningful = text
+        .split('\n')
+        .filter((line) => line.trim() !== '' && !line.trim().startsWith('#'))
+        .join('\n')
+        .trim();
+    return meaningful === '' || meaningful === '[]';
+}
+/**
+ * 幂等计划:文件不存在/为空/只剩 `[]` 占位→create;已有 matrix-bridge 行→skip
+ * (绝不覆盖用户手改的 profile);存在真实内容但无该行→append。
+ */
+export function planProfilePatch(existing, cfg) {
+    const block = renderBridgePatch(cfg);
+    if (existing === null || existing.trim() === '') {
+        return { action: 'create', text: block, reason: existing === null ? 'profile 尚无 cordis.patch.yml,已生成' : 'cordis.patch.yml 为空,已写入覆盖块' };
+    }
+    if (/-\s+id:\s*matrix-bridge/.test(existing) || /^id:\s*matrix-bridge/m.test(existing)) {
+        return { action: 'skip', text: '', reason: 'profile 的 cordis.patch.yml 已含 matrix-bridge 覆盖行,未改动(尊重用户编辑)' };
+    }
+    if (isPlaceholderOnly(existing)) {
+        return { action: 'create', text: block, reason: 'cordis.patch.yml 只有 dsh 的空数组占位([]),已整份替换为覆盖块(直接追加会产出非法 YAML)' };
+    }
+    const base = existing.endsWith('\n') ? existing : `${existing}\n`;
+    return { action: 'append', text: `${base}\n${block}`, reason: '已把 matrix-bridge 覆盖行追加到现有 cordis.patch.yml 末尾' };
+}
+//# sourceMappingURL=profile-patch.js.map

package/dist/cli/profile-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-patch.js","sourceRoot":"","sources":["../../src/cli/profile-patch.ts"],"names":[],"mappings":"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"}

package/dist/cli/setup.d.ts

@@ -0,0 +1,39 @@
+import type { OpsConfig } from './config-store.ts';
+export interface SetupFlags {
+    yes?: boolean;
+    homeserver?: string;
+    username?: string;
+    password?: string;
+    token?: string;
+    trusted?: string;
+    workdir?: string;
+    profile?: string;
+    logLevel?: string;
+}
+/** 交互问输入器(可注入 fake 供测试)。 */
+export type Ask = (prompt: string, opts?: {
+    silent?: boolean;
+}) => Promise<string>;
+export interface SetupDeps {
+    homedir: string;
+    ask: Ask;
+    log: (line: string) => void;
+    close: () => void;
+}
+export declare function defaultProfileName(): string;
+export declare function defaultWorkdir(homedir: string): string;
+/** 校验 + 组装 flag 配置(非交互路径,纯函数,可单测)。 */
+export declare function configFromFlags(flags: SetupFlags, homedir: string): OpsConfig | {
+    error: string;
+};
+/**
+ * TTY 逐行问输入器;silent 用不回显(星号)模式。
+ * 移植自 pi-courier src/setup.ts createPrompter 的 TTY 分支。
+ */
+export declare function createTTYAsk(): {
+    ask: Ask;
+    close: () => void;
+};
+/** 向导入口:--yes 走 flag;否则 TTY 交互。返回 0/1 退出码。 */
+export declare function runSetup(flags: SetupFlags, deps?: Partial<SetupDeps>): Promise<number>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,mBAAmB,CAAA;AAG/D,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,4BAA4B;AAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAElF,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,GAAG,CAAA;IACR,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAMD,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAmCjG;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CA4C9D;AA0FD,8CAA8C;AAC9C,wBAAsB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB5F"}

package/dist/cli/setup.js

@@ -0,0 +1,234 @@
+/**
+ * setup 向导:交互式或非交互(--yes + 全 flag)生成 ~/.dsh/dsh-matrix.json。
+ *
+ * 交互器移植自 pi-courier src/setup.ts 的 createPrompter(TTY readline +
+ * 静默密码星号回显,MIT),问项按 DSH 语义收缩:homeserver → 登录方式
+ * (1 密码 / 2 token)→ 信任用户 → 工作目录 → 实例名(= dsh profile 名)。
+ * 写的是运维配置文件,profile 挂载由 install-profile/指引完成。
+ */
+import { stdin, stdout } from 'node:process';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { createInterface } from 'node:readline';
+import { loadOpsConfig, saveOpsConfig } from "./config-store.js";
+export function defaultProfileName() {
+    return 'matrix';
+}
+export function defaultWorkdir(homedir) {
+    return path.join(homedir, 'dsh-matrix-work');
+}
+function isOpsLevel(v) {
+    return v === 'debug' || v === 'info' || v === 'warn' || v === 'error';
+}
+/** 校验 + 组装 flag 配置(非交互路径,纯函数,可单测)。 */
+export function configFromFlags(flags, homedir) {
+    const missing = [];
+    if (!flags.homeserver)
+        missing.push('--homeserver');
+    const hasPassword = Boolean(flags.username && flags.password);
+    const hasToken = Boolean(flags.token);
+    if (!hasPassword && !hasToken)
+        missing.push('--token 或 --username+--password');
+    if (!flags.trusted)
+        missing.push('--trusted');
+    if (missing.length > 0) {
+        return { error: `--yes 非交互模式需要补齐: ${missing.join(' ')}` };
+    }
+    if (flags.logLevel && !isOpsLevel(flags.logLevel)) {
+        return { error: `--log-level 非法: ${flags.logLevel}(可选 debug / info / warn / error)` };
+    }
+    const trustedUsers = (flags.trusted ?? '')
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+    if (trustedUsers.length === 0)
+        return { error: '--trusted 不能为空' };
+    const bad = trustedUsers.filter((u) => !u.startsWith('@'));
+    if (bad.length > 0) {
+        return { error: `信任用户 MXID 应以 @ 开头(如 @barry:example.com),收到: ${bad.join(', ')}` };
+    }
+    const cfg = {
+        profile: flags.profile ?? defaultProfileName(),
+        homeserver: String(flags.homeserver),
+        trustedUsers,
+        workdir: flags.workdir ?? defaultWorkdir(homedir),
+    };
+    if (hasToken)
+        cfg.accessToken = String(flags.token);
+    else {
+        cfg.username = String(flags.username);
+        cfg.password = String(flags.password);
+    }
+    if (flags.logLevel)
+        cfg.logLevel = flags.logLevel;
+    return cfg;
+}
+/**
+ * TTY 逐行问输入器;silent 用不回显(星号)模式。
+ * 移植自 pi-courier src/setup.ts createPrompter 的 TTY 分支。
+ */
+export function createTTYAsk() {
+    const rl = createInterface({ input: stdin, output: stdout });
+    // 每次 ask 都注册一个 once close 监听,向导问十余次会触默认 10 上限告警,放开。
+    rl.setMaxListeners(0);
+    return {
+        ask: (prompt, opts) => new Promise((resolve) => {
+            let done = false;
+            const finish = (answer) => {
+                if (!done) {
+                    done = true;
+                    resolve(answer);
+                }
+            };
+            if (opts?.silent) {
+                // Node 文档化的 _writeToOutput 遮写法:提示语放行,输入渲染为 *。
+                const output = rl;
+                const origWrite = output._writeToOutput;
+                let stars = 0;
+                output._writeToOutput = (str) => {
+                    if (str === prompt)
+                        origWrite.call(rl, prompt);
+                    else if (str === '\x7f' || str === '\b') {
+                        if (stars > 0) {
+                            origWrite.call(rl, '\b \b');
+                            stars--;
+                        }
+                    }
+                    else if (/^[\x20-\x7e\u00a0-\uffff]$/.test(str)) {
+                        origWrite.call(rl, '*');
+                        stars++;
+                    }
+                    // 其余控制序列吞掉(不回显、不动光标)
+                };
+                rl.question(prompt, (answer) => {
+                    output._writeToOutput = origWrite;
+                    origWrite.call(rl, '\n');
+                    finish(answer);
+                });
+            }
+            else {
+                rl.question(prompt, finish);
+            }
+            rl.once('close', () => finish(''));
+        }),
+        close: () => rl.close(),
+    };
+}
+async function interactiveConfig(deps) {
+    const { ask, log } = deps;
+    const existing = loadOpsConfig(deps.homedir) ?? undefined;
+    const d = (v) => (v ?? '').trim();
+    // 1. homeserver
+    const hsDefault = existing?.homeserver ?? '';
+    const homeserver = d(await ask(hsDefault ? `Matrix homeserver URL [默认 ${hsDefault}]: ` : 'Matrix homeserver URL (如 https://matrix.example.com): ')) || hsDefault;
+    if (!homeserver)
+        return { error: 'homeserver URL 不能为空' };
+    // 2. 登录方式
+    const mode = d(await ask('登录方式 [1=用户名密码, 2=粘贴 access token] (1): ')) || '1';
+    let username;
+    let password;
+    let accessToken;
+    if (mode === '2') {
+        accessToken = d(await ask('粘贴 access token (syt_...): '));
+        if (!accessToken)
+            return { error: 'token 不能为空' };
+    }
+    else if (mode === '1') {
+        username = d(await ask(`bot 用户名${existing?.username ? ` [默认 ${existing.username}]` : ''}: `)) || (existing?.username ?? '');
+        if (!username)
+            return { error: '用户名不能为空' };
+        password = (await ask('bot 密码(不回显): ', { silent: true })).trim() || (existing?.password ?? '');
+        if (!password)
+            return { error: '密码不能为空' };
+    }
+    else {
+        return { error: `未知登录方式: ${mode}(只支持 1 或 2)` };
+    }
+    // 3. 信任用户
+    const trustedDefault = existing?.trustedUsers?.join(', ') ?? '';
+    const trustedRaw = d(await ask(`信任用户(管理员)MXID${trustedDefault ? ` [默认 ${trustedDefault}]` : ''},逗号分隔: `)) || trustedDefault;
+    if (!trustedRaw)
+        return { error: '至少要有一个信任用户' };
+    const trustedUsers = trustedRaw.split(',').map((s) => s.trim()).filter(Boolean);
+    const bad = trustedUsers.filter((u) => !u.startsWith('@'));
+    if (bad.length > 0)
+        return { error: `MXID 应以 @ 开头(如 @barry:example.com),收到: ${bad.join(', ')}` };
+    // 4. 工作目录
+    const workdirDefault = existing?.workdir ?? defaultWorkdir(deps.homedir);
+    const workdir = d(await ask(`DSH agent 工作目录 [默认 ${workdirDefault}]: `)) || workdirDefault;
+    // 5. 实例名(= dsh profile 名)
+    const profileDefault = existing?.profile ?? defaultProfileName();
+    const profile = d(await ask(`实例名(dsh profile 名,多台部署用来区分)[默认 ${profileDefault}]: `)) || profileDefault;
+    if (!/^[a-z0-9][a-z0-9._-]*$/.test(profile)) {
+        return { error: `实例名需为小写字母/数字/._- 且以字母数字开头,收到: ${profile}` };
+    }
+    log('');
+    return {
+        profile,
+        homeserver,
+        trustedUsers,
+        workdir,
+        ...(accessToken ? { accessToken } : { username, password }),
+        ...(existing?.logLevel ? { logLevel: existing.logLevel } : {}),
+    };
+}
+/** setup 收尾打印:profile 挂载指引 + 后续命令。 */
+function printNextSteps(cfg, file, log) {
+    const loginDesc = cfg.accessToken ? 'token 登录' : `密码登录(${cfg.username})`;
+    log(`✅ 运维配置已写入 ${file}(权限 0600)`);
+    log(`   homeserver: ${cfg.homeserver}(${loginDesc})`);
+    log(`   信任用户: ${cfg.trustedUsers.join(', ')}`);
+    log(`   工作目录: ${cfg.workdir}`);
+    log(`   实例名: ${cfg.profile}(对应 dsh profile ~/.dsh/profiles/${cfg.profile})`);
+    log('');
+    log('下一步(二选一):');
+    log('  A. 一键挂载:  dsh-matrix install-profile');
+    log(`     (等价手动三步: dsh plugin --profile ${cfg.profile} add <本包>` + ',写 profile patch,再启动)');
+    log(`  B. 手动:  1) dsh plugin --profile ${cfg.profile} add dsh-matrix`);
+    log('            2) 编辑 ~/.dsh/profiles/' + cfg.profile + '/cordis.patch.yml,加入:');
+    const block = [
+        `               - id: matrix-bridge`,
+        `                 config:`,
+        `                   homeserver: ${JSON.stringify(cfg.homeserver)}`,
+    ];
+    if (cfg.accessToken)
+        block.push(`                   accessToken: ${JSON.stringify(cfg.accessToken)}`);
+    else {
+        block.push(`                   username: ${JSON.stringify(cfg.username)}`);
+        block.push(`                   password: ${JSON.stringify(cfg.password)}`);
+    }
+    block.push(`                   trustedUsers: [${cfg.trustedUsers.map((u) => JSON.stringify(u)).join(', ')}]`);
+    block.push(`                   workdir: ${JSON.stringify(cfg.workdir)}`);
+    block.push(`                   logLevel: ${JSON.stringify(cfg.logLevel ?? 'info')}`);
+    for (const l of block)
+        log(l);
+    log(`  然后: dsh-matrix run(前台试跑)或 dsh-matrix enable(systemd 自启)`);
+}
+/** 向导入口:--yes 走 flag;否则 TTY 交互。返回 0/1 退出码。 */
+export async function runSetup(flags, deps) {
+    const homedir = deps?.homedir ?? os.homedir();
+    let cfg;
+    let close = () => { };
+    const log = deps?.log ?? ((l) => console.log(l));
+    if (flags.yes) {
+        cfg = configFromFlags(flags, homedir);
+    }
+    else {
+        const tty = deps?.ask ? { ask: deps.ask, close: () => { } } : createTTYAsk();
+        close = tty.close;
+        cfg = await interactiveConfig({ homedir, ask: tty.ask, log, close });
+    }
+    try {
+        if ('error' in cfg) {
+            log(`❌ ${cfg.error}`);
+            return 1;
+        }
+        const file = saveOpsConfig(cfg, homedir);
+        printNextSteps(cfg, file, log);
+        return 0;
+    }
+    finally {
+        close(); // 释放 stdin 监听,让进程自然退出
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAwBhE,MAAM,UAAU,kBAAkB;IAChC,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAA;AAC9C,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,OAAO,CAAA;AACvE,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,eAAe,CAAC,KAAiB,EAAE,OAAe;IAChE,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,IAAI,CAAC,KAAK,CAAC,UAAU;QAAE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IACnD,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACrC,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAA;IAC9E,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC7C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,oBAAoB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAA;IAC3D,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,KAAK,EAAE,mBAAmB,KAAK,CAAC,QAAQ,kCAAkC,EAAE,CAAA;IACvF,CAAC;IACD,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;SACvC,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAA;IAClB,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACjE,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1D,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,KAAK,EAAE,+CAA+C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAA;IACnF,CAAC;IACD,MAAM,GAAG,GAAc;QACrB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,kBAAkB,EAAE;QAC9C,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;QACpC,YAAY;QACZ,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC;KAClD,CAAA;IACD,IAAI,QAAQ;QAAE,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;SAC9C,CAAC;QACJ,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QACrC,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACvC,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ;QAAE,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAuB,CAAA;IAChE,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAC5D,oDAAoD;IACpD,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;IACrB,OAAO;QACL,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CACpB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACtB,IAAI,IAAI,GAAG,KAAK,CAAA;YAChB,MAAM,MAAM,GAAG,CAAC,MAAc,EAAQ,EAAE;gBACtC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,IAAI,GAAG,IAAI,CAAA;oBACX,OAAO,CAAC,MAAM,CAAC,CAAA;gBACjB,CAAC;YACH,CAAC,CAAA;YACD,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;gBACjB,8CAA8C;gBAC9C,MAAM,MAAM,GAAG,EAAwD,CAAA;gBACvE,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAA;gBACvC,IAAI,KAAK,GAAG,CAAC,CAAA;gBACb,MAAM,CAAC,cAAc,GAAG,CAAC,GAAW,EAAE,EAAE;oBACtC,IAAI,GAAG,KAAK,MAAM;wBAAE,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;yBACzC,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;wBACxC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;4BACd,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;4BAC3B,KAAK,EAAE,CAAA;wBACT,CAAC;oBACH,CAAC;yBAAM,IAAI,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;wBAClD,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;wBACvB,KAAK,EAAE,CAAA;oBACT,CAAC;oBACD,qBAAqB;gBACvB,CAAC,CAAA;gBACD,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;oBAC7B,MAAM,CAAC,cAAc,GAAG,SAAS,CAAA;oBACjC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;oBACxB,MAAM,CAAC,MAAM,CAAC,CAAA;gBAChB,CAAC,CAAC,CAAA;YACJ,CAAC;iBAAM,CAAC;gBACN,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YAC7B,CAAC;YACD,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;QACpC,CAAC,CAAC;QACJ,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE;KACxB,CAAA;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,IAAe;IAC9C,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IACzB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,SAAS,CAAA;IACzD,MAAM,CAAC,GAAG,CAAC,CAAqB,EAAU,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAE7D,gBAAgB;IAChB,MAAM,SAAS,GAAG,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAA;IAC5C,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,6BAA6B,SAAS,KAAK,CAAC,CAAC,CAAC,wDAAwD,CAAC,CAAC,IAAI,SAAS,CAAA;IAChK,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAA;IAExD,UAAU;IACV,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,yCAAyC,CAAC,CAAC,IAAI,GAAG,CAAA;IAC3E,IAAI,QAA4B,CAAA;IAChC,IAAI,QAA4B,CAAA;IAChC,IAAI,WAA+B,CAAA;IACnC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,WAAW,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,6BAA6B,CAAC,CAAC,CAAA;QACzD,IAAI,CAAC,WAAW;YAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAA;IAClD,CAAC;SAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACxB,QAAQ,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,UAAU,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAA;QAC3H,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;QAC1C,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAA;QAC9F,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;IAC3C,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,KAAK,EAAE,WAAW,IAAI,aAAa,EAAE,CAAA;IAChD,CAAC;IAED,UAAU;IACV,MAAM,cAAc,GAAG,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;IAC/D,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,gBAAgB,cAAc,CAAC,CAAC,CAAC,QAAQ,cAAc,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,cAAc,CAAA;IAC3H,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAA;IAC/C,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC/E,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1D,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,0CAA0C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAA;IAEhG,UAAU;IACV,MAAM,cAAc,GAAG,QAAQ,EAAE,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACxE,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,sBAAsB,cAAc,KAAK,CAAC,CAAC,IAAI,cAAc,CAAA;IAEzF,0BAA0B;IAC1B,MAAM,cAAc,GAAG,QAAQ,EAAE,OAAO,IAAI,kBAAkB,EAAE,CAAA;IAChE,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,kCAAkC,cAAc,KAAK,CAAC,CAAC,IAAI,cAAc,CAAA;IACrG,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,OAAO,EAAE,KAAK,EAAE,iCAAiC,OAAO,EAAE,EAAE,CAAA;IAC9D,CAAC;IAED,GAAG,CAAC,EAAE,CAAC,CAAA;IACP,OAAO;QACL,OAAO;QACP,UAAU;QACV,YAAY;QACZ,OAAO;QACP,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAC3D,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAA;AACH,CAAC;AAED,sCAAsC;AACtC,SAAS,cAAc,CAAC,GAAc,EAAE,IAAY,EAAE,GAAwB;IAC5E,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,QAAQ,GAAG,CAAA;IACxE,GAAG,CAAC,aAAa,IAAI,WAAW,CAAC,CAAA;IACjC,GAAG,CAAC,kBAAkB,GAAG,CAAC,UAAU,IAAI,SAAS,GAAG,CAAC,CAAA;IACrD,GAAG,CAAC,YAAY,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC9C,GAAG,CAAC,YAAY,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;IAC9B,GAAG,CAAC,WAAW,GAAG,CAAC,OAAO,mCAAmC,GAAG,CAAC,OAAO,GAAG,CAAC,CAAA;IAC5E,GAAG,CAAC,EAAE,CAAC,CAAA;IACP,GAAG,CAAC,WAAW,CAAC,CAAA;IAChB,GAAG,CAAC,wCAAwC,CAAC,CAAA;IAC7C,GAAG,CAAC,sCAAsC,GAAG,CAAC,OAAO,WAAW,GAAG,uBAAuB,CAAC,CAAA;IAC3F,GAAG,CAAC,qCAAqC,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAA;IACtE,GAAG,CAAC,oCAAoC,GAAG,GAAG,CAAC,OAAO,GAAG,uBAAuB,CAAC,CAAA;IACjF,MAAM,KAAK,GAAG;QACZ,oCAAoC;QACpC,0BAA0B;QAC1B,kCAAkC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE;KACnE,CAAA;IACD,IAAI,GAAG,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,mCAAmC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;SAChG,CAAC;QACJ,KAAK,CAAC,IAAI,CAAC,gCAAgC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QAC1E,KAAK,CAAC,IAAI,CAAC,gCAAgC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC5E,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,qCAAqC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC7G,KAAK,CAAC,IAAI,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IACxE,KAAK,CAAC,IAAI,CAAC,gCAAgC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,CAAC,EAAE,CAAC,CAAA;IACpF,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,GAAG,CAAC,CAAC,CAAC,CAAA;IAC7B,GAAG,CAAC,2DAA2D,CAAC,CAAA;AAClE,CAAC;AAED,8CAA8C;AAC9C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAiB,EAAE,IAAyB;IACzE,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,CAAA;IAC7C,IAAI,GAAkC,CAAA;IACtC,IAAI,KAAK,GAAG,GAAS,EAAE,GAAE,CAAC,CAAA;IAC1B,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAExD,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,GAAG,GAAG,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACvC,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAA;QAC3E,KAAK,GAAG,GAAG,CAAC,KAAK,CAAA;QACjB,GAAG,GAAG,MAAM,iBAAiB,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;IACtE,CAAC;IACD,IAAI,CAAC;QACH,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;YACnB,GAAG,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAA;YACrB,OAAO,CAAC,CAAA;QACV,CAAC;QACD,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACxC,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;QAC9B,OAAO,CAAC,CAAA;IACV,CAAC;YAAS,CAAC;QACT,KAAK,EAAE,CAAA,CAAC,sBAAsB;IAChC,CAAC;AACH,CAAC"}

package/dist/cli/systemd-hint.d.ts

@@ -0,0 +1,11 @@
+export interface BusFailureHintInput {
+    euid: number;
+    xdgRuntimeDir?: string;
+    xdgOwnerUid?: number | null;
+    stderr?: string;
+}
+/** 纯判断:这次 systemctl 失败是不是"总线属主错位"陷阱;不是则返回 null。 */
+export declare function busFailureHint(input: BusFailureHintInput): string | null;
+/** 目录属主 uid;无法解析(不存在/不可达)返回 null。 */
+export declare function dirOwnerUid(dir: string | undefined): number | null;
+//# sourceMappingURL=systemd-hint.d.ts.map

package/dist/cli/systemd-hint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemd-hint.d.ts","sourceRoot":"","sources":["../../src/cli/systemd-hint.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CA6BxE;AAED,qCAAqC;AACrC,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAOlE"}

package/dist/cli/systemd-hint.js

@@ -0,0 +1,46 @@
+/**
+ * `su <用户>`(不带 -)导致的 systemctl --user 总线错配提示。
+ * 整文件移植自 pi-courier src/systemd-hint.ts(MIT,issue #59),仅改注释语言。
+ */
+import * as fs from 'node:fs';
+/** 纯判断:这次 systemctl 失败是不是"总线属主错位"陷阱;不是则返回 null。 */
+export function busFailureHint(input) {
+    const { euid, xdgRuntimeDir, xdgOwnerUid, stderr } = input;
+    const stderrText = typeof stderr === 'string' ? stderr : undefined;
+    const stderrPointsAtBus = !!stderrText &&
+        (/connect to bus of other user/i.test(stderrText) ||
+            (/user scope bus/i.test(stderrText) && /not permitted/i.test(stderrText)));
+    const ownerMismatchWithEperm = typeof xdgOwnerUid === 'number' &&
+        xdgOwnerUid !== euid &&
+        !!stderrText &&
+        /not permitted|EPERM/i.test(stderrText);
+    if (!stderrPointsAtBus && !ownerMismatchWithEperm)
+        return null;
+    const tail = [
+        '   常见原因:用 `su <用户>`(不带 -)切换用户时继承了原用户的环境,或当前 shell 缺少完整登录会话。',
+        '   解决:export XDG_RUNTIME_DIR=/run/user/$(id -u) 后重试,或改用 `su - <用户>` 重新切换;',
+        '   若 /run/user/$(id -u) 不存在,请以该用户登录一次,或由 root 执行 loginctl enable-linger <用户>。',
+    ];
+    if (typeof xdgOwnerUid === 'number' && xdgOwnerUid !== euid) {
+        return [
+            `💡 检测到 XDG_RUNTIME_DIR=${xdgRuntimeDir ?? '(未设置)'}(属主 uid ${xdgOwnerUid})指向其他用户的会话总线,而当前用户是 uid ${euid}。`,
+            ...tail,
+        ].join('\n');
+    }
+    return [
+        `💡 未能连接到当前用户的 systemd 会话总线(XDG_RUNTIME_DIR=${xdgRuntimeDir ?? '未设置'})。`,
+        ...tail,
+    ].join('\n');
+}
+/** 目录属主 uid;无法解析(不存在/不可达)返回 null。 */
+export function dirOwnerUid(dir) {
+    if (!dir)
+        return null;
+    try {
+        return fs.statSync(dir).uid;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=systemd-hint.js.map

package/dist/cli/systemd-hint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemd-hint.js","sourceRoot":"","sources":["../../src/cli/systemd-hint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAS7B,mDAAmD;AACnD,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IAC1D,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;IAClE,MAAM,iBAAiB,GACrB,CAAC,CAAC,UAAU;QACZ,CAAC,+BAA+B,CAAC,IAAI,CAAC,UAAU,CAAC;YAC/C,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IAC9E,MAAM,sBAAsB,GAC1B,OAAO,WAAW,KAAK,QAAQ;QAC/B,WAAW,KAAK,IAAI;QACpB,CAAC,CAAC,UAAU;QACZ,sBAAsB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACzC,IAAI,CAAC,iBAAiB,IAAI,CAAC,sBAAsB;QAAE,OAAO,IAAI,CAAA;IAE9D,MAAM,IAAI,GAAG;QACX,6DAA6D;QAC7D,2EAA2E;QAC3E,+EAA+E;KAChF,CAAA;IACD,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QAC5D,OAAO;YACL,0BAA0B,aAAa,IAAI,OAAO,WAAW,WAAW,2BAA2B,IAAI,GAAG;YAC1G,GAAG,IAAI;SACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACd,CAAC;IACD,OAAO;QACL,8CAA8C,aAAa,IAAI,KAAK,IAAI;QACxE,GAAG,IAAI;KACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,WAAW,CAAC,GAAuB;IACjD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IACrB,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,CAAA;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}