@super-coding/cli 0.2.2 → 0.2.3

package/dist/setup/prompt.js

@@ -0,0 +1,129 @@
+// 交互式问答：只做 setup 需要的最小能力——带默认值的单行输入 + 密钥不回显 + 输入校验循环。
+//
+// 不引入第三方依赖（仓库只依赖 commander/ws）。密钥遮蔽用 readline 的 _writeToOutput
+// 钩子：它在写提示符与回显输入时被调用，静音期间一律吞掉，提示符由我们自己先打印。
+//
+// 排版目标：每个问题都「先说清楚是什么、默认值是什么」，输入位置用 `› ` 明确指出来，
+// 而不是把所有信息揉在一行里。
+import { createInterface } from "node:readline";
+import { GUTTER, INDENT, paint, symbol } from "./ui.js";
+export function createPrompter(input = process.stdin, output = process.stdout, opts = {}) {
+    const rl = createInterface({ input, output });
+    let muted = false;
+    // readline 关闭后 question() 会直接抛 "readline was closed"；记下来，后续提问降级为默认值
+    let closed = false;
+    rl.once("close", () => {
+        closed = true;
+    });
+    if (opts.onInterrupt)
+        rl.on("SIGINT", () => opts.onInterrupt?.());
+    // 只接管「输出」，不接管行编辑；静音时连同回显一起吞掉
+    rl._writeToOutput = (text) => {
+        if (!muted)
+            output.write(text);
+    };
+    const resolveEmpty = (question, defaultValue, allowEmpty) => {
+        if (defaultValue !== undefined)
+            return defaultValue;
+        if (allowEmpty)
+            return "";
+        throw new Error(`${question} 不能为空`);
+    };
+    const read = async (defaultValue) => {
+        let eof = false;
+        try {
+            return await new Promise((resolve) => {
+                const onClose = () => {
+                    eof = true;
+                    resolve(defaultValue ?? "");
+                };
+                rl.once("close", onClose);
+                rl.question("", (value) => {
+                    rl.removeListener("close", onClose);
+                    resolve(value);
+                });
+            });
+        }
+        finally {
+            if (eof)
+                output.write("\n");
+        }
+    };
+    const ask = async (question, opts = {}) => {
+        const { defaultValue, defaultLabel, hidden = false, allowEmpty = false, hint, suffix, validate, gutter = GUTTER, } = opts;
+        const tail = suffix ??
+            (defaultValue !== undefined
+                ? ` [${(defaultLabel ?? defaultValue) || "空"}]`
+                : allowEmpty
+                    ? ""
+                    : " [必填]");
+        const hints = hint === undefined ? [] : Array.isArray(hint) ? hint : [hint];
+        for (let attempt = 0;; attempt += 1) {
+            output.write(`${gutter}${paint.cyan("?")} ${paint.bold(question)}${paint.dim(tail)}\n`);
+            // 说明只在第一次展示：校验失败重问时再重复一遍会让终端刷屏
+            if (attempt === 0) {
+                for (const line of hints)
+                    output.write(`${gutter}${INDENT}${paint.dim(line)}\n`);
+            }
+            output.write(`${gutter}${INDENT}${paint.dim(`${symbol.arrow} `)}`);
+            // 输入流已结束（Ctrl+D 或管道提前 EOF）：不再提问，直接按默认值/空值收场
+            if (closed) {
+                output.write("\n");
+                return resolveEmpty(question, defaultValue, allowEmpty);
+            }
+            muted = hidden;
+            let answer;
+            try {
+                answer = await read(defaultValue);
+            }
+            finally {
+                muted = false;
+                if (hidden)
+                    output.write("\n");
+            }
+            // 不回显的输入完全没有视觉反馈，容易让人以为没读到；这里只报位数，不泄露内容
+            if (hidden && answer.trim()) {
+                output.write(`${gutter}${INDENT}${paint.dim(`${symbol.skip} 已记录 ${answer.trim().length} 个字符（不回显）`)}\n`);
+            }
+            const trimmed = answer.trim();
+            const value = trimmed ? trimmed : defaultValue !== undefined ? defaultValue : allowEmpty ? "" : null;
+            if (value === null) {
+                output.write(`${gutter}${INDENT}${paint.yellow(`${symbol.warn} ${question} 不能为空`)}\n`);
+                continue;
+            }
+            const error = validate?.(value);
+            if (error) {
+                output.write(`${gutter}${INDENT}${paint.yellow(`${symbol.warn} ${error}`)}\n`);
+                continue;
+            }
+            return value;
+        }
+    };
+    return { ask, close: () => rl.close() };
+}
+/**
+ * 是非题：回车走默认值，只有明确的 y/n 才改判；看不懂的输入重问一次，
+ * 而不是默默当成默认值（那会让人以为自己答了别的意思）。
+ */
+export async function askConfirm(ask, question, defaultYes = true, hint) {
+    for (;;) {
+        const answer = (await ask(question, {
+            allowEmpty: true,
+            defaultValue: "",
+            suffix: defaultYes ? " (Y/n)" : " (y/N)",
+            hint,
+        }))
+            .trim()
+            .toLowerCase();
+        if (!answer)
+            return defaultYes;
+        if (/^(y|yes|是|确认|好)$/.test(answer))
+            return true;
+        if (/^(n|no|否|不|取消)$/.test(answer))
+            return false;
+    }
+}
+/** 非交互模式：参数/环境变量已经决定一切，问题不应被提出 */
+export const noPrompt = (question) => {
+    throw new Error(`需要交互输入（${question}），但当前不是可交互终端；请用命令行参数或环境变量提供`);
+};

package/dist/setup/ui.js

@@ -0,0 +1,78 @@
+// setup 的输出层：颜色、图标、对齐。
+//
+// 只解决「看不出这一步在干什么 / 输出像流水账」的问题，不掺业务判断。
+//
+// 颜色规则：FORCE_COLOR 强制开；NO_COLOR、TERM=dumb、非 TTY 一律关 —— 重定向到文件或
+// CI 里不应该出现一堆 ESC 序列。ANSI 用自写的包装函数，不引第三方依赖（仓库只有 commander/ws）。
+const env = process.env;
+const forceColor = env.FORCE_COLOR !== undefined && env.FORCE_COLOR !== "0";
+const colorEnabled = forceColor || (!!process.stdout.isTTY && env.NO_COLOR === undefined && env.TERM !== "dumb");
+function style(open, close) {
+    return colorEnabled ? (text) => `\x1b[${open}m${text}\x1b[${close}m` : (text) => text;
+}
+export const paint = {
+    bold: style("1", "22"),
+    dim: style("2", "22"),
+    red: style("31", "39"),
+    green: style("32", "39"),
+    yellow: style("33", "39"),
+    cyan: style("36", "39"),
+};
+export const symbol = {
+    step: "◆",
+    done: "✓",
+    skip: "·",
+    warn: "!",
+    fail: "✗",
+    arrow: "›",
+    bullet: "•",
+};
+/** 左侧导轨：把每一步的内容都挂在一条竖线上，视觉上归拢到当前步骤 */
+export const GUTTER = "  │  ";
+/** 步骤内容里的二级缩进（提示、输入游标用） */
+export const INDENT = "  ";
+const WIDE_RANGES = [
+    [0x1100, 0x115f], // 谚文字母
+    [0x2e80, 0x303e], // 部首、康熙部首、CJK 标点
+    [0x3041, 0x33ff], // 假名、注音、CJK 兼容
+    [0x3400, 0x4dbf], // CJK 扩展 A
+    [0x4e00, 0x9fff], // CJK 基本区
+    [0xa000, 0xa4cf], // 彝文
+    [0xac00, 0xd7a3], // 谚文音节
+    [0xf900, 0xfaff], // CJK 兼容表意
+    [0xfe30, 0xfe6f], // CJK 兼容形式
+    [0xff00, 0xff60], // 全角 ASCII
+    [0xffe0, 0xffe6], // 全角符号
+    [0x1f300, 0x1f64f], // emoji
+    [0x20000, 0x3fffd], // CJK 扩展 B 及以上
+];
+function isWide(code) {
+    return WIDE_RANGES.some(([lo, hi]) => code >= lo && code <= hi);
+}
+/**
+ * 显示宽度：中文/全角占 2 列。
+ * 直接用 `String.length` 对齐会让中英混排的列歪掉（「设备」是 2 个字符但占 4 列）。
+ */
+export function displayWidth(text) {
+    let width = 0;
+    for (const ch of text) {
+        const code = ch.codePointAt(0) ?? 0;
+        width += isWide(code) ? 2 : 1;
+    }
+    return width;
+}
+/** 按显示宽度右补空格，把 `text` 撑到 `width` 列 */
+export function pad(text, width) {
+    const gap = width - displayWidth(text);
+    return gap > 0 ? text + " ".repeat(gap) : text;
+}
+/** 终端宽度（取不到或不合理时退回 72），用于画分隔线 */
+export function terminalWidth() {
+    const columns = process.stdout.columns;
+    if (!columns || columns < 40)
+        return 72;
+    return Math.min(columns, 100) - 2;
+}
+export function rule() {
+    return paint.dim("─".repeat(terminalWidth()));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@super-coding/cli",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Super Coding CLI：把本机 Claude Code / Cursor 接入远程控制台（scode 命令与后台 daemon）",
   "license": "UNLICENSED",
   "type": "module",
@@ -35,11 +35,12 @@
   "dependencies": {
     "commander": "^14.0.2",
     "ws": "^8.21.3",
-    "@super-coding/protocol": "0.1.0"
+    "@super-coding/protocol": "0.1.1"
   },
   "scripts": {
     "dev": "tsx watch src/cli.ts",
     "build": "pnpm --filter @super-coding/protocol build && rm -rf dist && tsc -p tsconfig.build.json && node scripts/copy-assets.mjs",
+    "fetch-pc": "node scripts/fetch-pc.mjs",
     "link:local": "node scripts/link-local.mjs",
     "start": "node dist/cli.js daemon run",
     "test": "vitest run",