@minko-ai/minko 0.1.0 → 0.1.1

package/dist/cli/doctorCommand.js

@@ -0,0 +1,112 @@
+import { execFileSync } from 'node:child_process';
+import { activeProvider, loadConfig } from "../config/store.js";
+import { minkoHome } from "../config/paths.js";
+import { listPlugins, pluginsDir } from "../plugins/loader.js";
+import { dockerAvailable, resolveSandbox } from "../sandbox/index.js";
+import { Painter } from "../ui/ansi.js";
+export function collectChecks(config, error, deps = {}) {
+    const checks = [];
+    const nodeVersion = deps.nodeVersion ?? process.version;
+    const parts = nodeVersion.replace(/^v/, '').split('.').map(Number);
+    const nodeOk = parts[0] > 18 || (parts[0] === 18 && parts[1] >= 17);
+    checks.push({
+        name: 'node',
+        ok: nodeOk,
+        detail: nodeVersion + '（需要 >=18.17）',
+    });
+    checks.push({
+        name: 'config',
+        ok: config !== null,
+        detail: error ?? (config ? '已加载' : '不可用'),
+    });
+    if (config) {
+        const active = activeProvider(config);
+        checks.push({
+            name: 'provider',
+            ok: Boolean(active && active.provider.apiKey.length > 0),
+            detail: active
+                ? active.name + ' · ' + active.provider.model
+                    + (active.provider.apiKey.length > 0 ? ' · key ✓' : ' · key 缺失')
+                : '还没有配置模型',
+        });
+        const plugins = listPlugins(pluginsDir(), config.plugins.disabled);
+        checks.push({
+            name: 'plugins',
+            ok: plugins.errors.length === 0,
+            detail: plugins.plugins.length + ' 个插件'
+                + (plugins.errors.length > 0 ? '，' + plugins.errors.length + ' 个错误' : ''),
+        });
+        checks.push({
+            name: 'mcp',
+            ok: true,
+            detail: Object.keys(config.mcpServers).length + ' 个 server 配置',
+        });
+        checks.push({
+            name: 'lsp',
+            ok: true,
+            detail: Object.keys(config.lsp.servers ?? {}).length + ' 个自定义 server'
+                + '（未配置时使用内置默认）',
+        });
+        const sandbox = resolveSandbox(config);
+        if (sandbox) {
+            const docker = dockerAvailable();
+            checks.push({
+                name: 'sandbox',
+                ok: docker || sandbox.allowFallback,
+                detail: docker
+                    ? 'Docker 可用 · ' + sandbox.image
+                    : sandbox.allowFallback
+                        ? 'Docker 不可用，将回退普通 shell'
+                        : 'Docker 不可用，run_shell 会拒绝执行',
+            });
+        }
+    }
+    try {
+        const home = deps.home ? deps.home() : minkoHome();
+        checks.push({ name: 'data-dir', ok: true, detail: home });
+    }
+    catch (error) {
+        checks.push({
+            name: 'data-dir',
+            ok: false,
+            detail: error instanceof Error ? error.message : String(error),
+        });
+    }
+    try {
+        const version = deps.gitVersion
+            ? deps.gitVersion()
+            : execFileSync('git', ['--version'], {
+                encoding: 'utf8',
+                timeout: 5_000,
+                windowsHide: true,
+            }).trim();
+        checks.push({ name: 'git', ok: version.length > 0, detail: version || 'git 不可用' });
+    }
+    catch {
+        checks.push({ name: 'git', ok: false, detail: '未安装 git（lane 功能不可用）' });
+    }
+    return checks;
+}
+export async function runDoctorCommand(json) {
+    const painter = new Painter();
+    let config = null;
+    let error = null;
+    try {
+        config = loadConfig();
+    }
+    catch (caught) {
+        error = caught instanceof Error ? caught.message : String(caught);
+    }
+    const checks = collectChecks(config, error);
+    const ok = checks.every((check) => check.ok);
+    if (json) {
+        process.stdout.write(JSON.stringify({ ok, checks }, null, 2) + '\n');
+        return ok ? 0 : 1;
+    }
+    for (const check of checks) {
+        process.stdout.write('  ' + (check.ok ? painter.ok('✓ ') : painter.error('✗ '))
+            + painter.soft(check.name.padEnd(10)) + painter.dimmed(check.detail) + '\n');
+    }
+    process.stdout.write('\n  ' + (ok ? painter.ok('全部通过') : painter.error('有项目需要处理')) + '\n');
+    return ok ? 0 : 1;
+}

package/dist/cli/exportCommand.js

@@ -0,0 +1,85 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { SessionStore } from "../session/store.js";
+import { Painter } from "../ui/ansi.js";
+export function sessionToMarkdown(record) {
+    const lines = [
+        '# ' + record.meta.title,
+        '',
+        '- 会话：' + record.meta.id,
+        '- 目录：' + record.meta.cwd,
+        '- 模型：' + record.meta.model,
+        '- 时间：' + record.meta.createdAt + ' → ' + record.meta.updatedAt,
+    ];
+    if (record.meta.forkedFrom) {
+        lines.push('- 分支自：' + record.meta.forkedFrom);
+    }
+    lines.push('', '---', '');
+    for (const message of record.messages) {
+        if (message.role === 'user') {
+            lines.push('## 用户', '', message.content, '');
+        }
+        else if (message.role === 'assistant') {
+            lines.push('## 助手', '');
+            if (message.content.length > 0) {
+                lines.push(message.content, '');
+            }
+            for (const call of message.toolCalls) {
+                lines.push('- 工具调用：`' + call.name + '` `' + oneLine(call.arguments, 300) + '`');
+            }
+            if (message.toolCalls.length > 0) {
+                lines.push('');
+            }
+        }
+        else if (message.role === 'system') {
+            lines.push('## 系统', '', message.content, '');
+        }
+        else {
+            lines.push('## 工具 · ' + message.name, '');
+            const fence = fenceFor(message.content);
+            lines.push(fence + 'text', message.content, fence, '');
+        }
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+export async function runExportCommand(id, format = 'md', out) {
+    const painter = new Painter();
+    const store = new SessionStore();
+    const sourceId = !id || id.trim() === 'latest' ? store.latest()?.id : id.trim();
+    if (!sourceId) {
+        process.stderr.write(painter.error('找不到可用的会话') + '\n');
+        return 1;
+    }
+    const record = store.load(sourceId);
+    if (!record) {
+        process.stderr.write(painter.error('找不到会话：' + sourceId) + '\n');
+        return 1;
+    }
+    const payload = format === 'json'
+        ? JSON.stringify(record, null, 2) + '\n'
+        : sessionToMarkdown(record);
+    if (out && out.trim().length > 0) {
+        const target = path.resolve(out.trim());
+        try {
+            fs.writeFileSync(target, payload, 'utf8');
+        }
+        catch (error) {
+            process.stderr.write(painter.error('写入失败：'
+                + (error instanceof Error ? error.message : String(error))) + '\n');
+            return 1;
+        }
+        process.stdout.write(painter.ok('✓ ') + '已导出到 ' + painter.soft(target) + '\n');
+        return 0;
+    }
+    process.stdout.write(payload);
+    return 0;
+}
+function fenceFor(text) {
+    const matches = text.match(/`{3,}/g) ?? [];
+    const longest = matches.reduce((max, fence) => Math.max(max, fence.length), 2);
+    return '`'.repeat(Math.max(3, longest + 1));
+}
+function oneLine(text, max) {
+    const compact = text.replace(/\s+/g, ' ').trim();
+    return compact.length > max ? compact.slice(0, max) + '…' : compact;
+}

package/dist/cli/forkCommand.js

@@ -0,0 +1,24 @@
+import { SessionStore } from "../session/store.js";
+import { Painter } from "../ui/ansi.js";
+export async function runForkCommand(id, name) {
+    const painter = new Painter();
+    if (!id || id.trim().length === 0) {
+        process.stderr.write(painter.error('用法：minko fork <会话id|latest> [名字]') + '\n');
+        return 1;
+    }
+    const store = new SessionStore();
+    const sourceId = id.trim() === 'latest' ? store.latest()?.id : id.trim();
+    if (!sourceId) {
+        process.stderr.write(painter.error('找不到可用的会话：' + id) + '\n');
+        return 1;
+    }
+    const forked = store.fork(sourceId, name);
+    if (!forked) {
+        process.stderr.write(painter.error('找不到会话：' + sourceId) + '\n');
+        return 1;
+    }
+    process.stdout.write(painter.ok('✓ ') + '已创建分支 ' + painter.soft(forked.meta.id)
+        + painter.dimmed('（来自 ' + sourceId + '）') + '\n');
+    process.stdout.write('  ' + painter.dimmed('继续这个分支：minko -r ' + forked.meta.id) + '\n');
+    return 0;
+}

package/dist/cli/linkCommand.js

@@ -0,0 +1,272 @@
+import QRCode from 'qrcode';
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { Painter } from "../ui/ansi.js";
+import { configProblems, loadConfig } from "../config/store.js";
+import { encodeLink, lanAddress, loadOrCreateDevice, newToken, saveDevice, pidFilePath } from "../link/protocol.js";
+import { minkoHome } from "../config/paths.js";
+import { readVersion } from "../util/version.js";
+import { SERVE_PORT } from "./serveCommand.js";
+/** Default public relay so cross-network works without extra flags. */
+const DEFAULT_RELAY = 'http://81.70.41.250:8787';
+/**
+ * One-time device pairing: makes sure the background service is running,
+ * shows the QR, then exits once the phone confirms.
+ */
+export async function runLinkCommand(_portArg, hostArg, relayArg, lanOnly) {
+    const painter = new Painter();
+    const config = loadConfig();
+    const problems = configProblems(config);
+    if (problems.length > 0) {
+        for (const problem of problems) {
+            process.stderr.write(painter.error('· ' + problem + '\n'));
+        }
+        return 1;
+    }
+    const device = loadOrCreateDevice();
+    const relay = lanOnly
+        ? ''
+        : ((relayArg && relayArg.trim().length > 0)
+            ? relayArg.trim().replace(/\/+$/, '')
+            : (device.relay ?? DEFAULT_RELAY));
+    if (relay.length > 0) {
+        device.relay = relay;
+        if (!device.room) {
+            device.room = crypto.randomBytes(4).toString('hex');
+        }
+    }
+    else {
+        delete device.relay;
+        delete device.room;
+    }
+    if (!device.token) {
+        device.token = newToken();
+    }
+    saveDevice(device);
+    let running = await isServeRunning();
+    const version = await serveVersion();
+    if (running && version !== readVersion()) {
+        // Older daemon from a previous install: restart it so it serves new APIs.
+        stopServe();
+        running = await waitForServeDown(4000);
+    }
+    if (!running) {
+        startServeDetached();
+        running = await waitForServe(8000);
+    }
+    if (!running) {
+        process.stderr.write(painter.error('后台服务没有启动，原因如下：\n'));
+        process.stderr.write(serveLogTail());
+        process.stderr.write(painter.dimmed('也可以手动运行 minko serve 查看完整输出\n'));
+        return 1;
+    }
+    const autostart = ensureAutostart();
+    const host = hostArg && hostArg.trim().length > 0 ? hostArg.trim() : lanAddress();
+    const payload = encodeLink({
+        v: 1,
+        host,
+        port: SERVE_PORT,
+        token: device.token,
+        name: device.name.slice(0, 10),
+        relay: device.relay,
+        room: device.room,
+    });
+    const qr = await QRCode.toString(payload, {
+        type: 'terminal',
+        small: true,
+        margin: 1,
+        errorCorrectionLevel: 'L',
+    });
+    const lines = [
+        '',
+        '  ' + painter.bold(painter.soft('手机配对')) + painter.dimmed('  ·  仅绑定设备，后台服务已常驻'),
+        '  ' + painter.dimmed('─'.repeat(46)),
+        '  ' + painter.muted('电脑   ') + painter.primary(device.name),
+        '  ' + painter.muted(relay.length > 0 ? '中转   ' : '地址   ')
+            + painter.primary(relay.length > 0 ? relay : host + ':' + SERVE_PORT),
+        relay.length > 0
+            ? '  ' + painter.muted('房间   ') + painter.primary(device.room ?? '')
+            : '',
+        '  ' + painter.muted('常驻   ') + painter.soft('后台服务已启动' + (autostart ? '，登录时自动运行' : '')),
+        '',
+        '  ' + painter.dimmed('用手机 Minko 的「远程」扫码；令牌：') + painter.muted(device.token),
+        '',
+    ].filter((line) => line.length > 0);
+    process.stdout.write(lines.join('\n') + '\n');
+    process.stdout.write(qr + '\n');
+    process.stdout.write('  ' + painter.dimmed('等待手机扫码… 配对完成后自动退出，服务继续在后台运行') + '\n\n');
+    const before = (device.phones ?? []).length;
+    return await new Promise((resolve) => {
+        let done = false;
+        const finish = (code) => {
+            if (done) {
+                return;
+            }
+            done = true;
+            clearInterval(timer);
+            process.removeListener('SIGINT', onSigint);
+            resolve(code);
+        };
+        const onSigint = () => {
+            process.stdout.write('\n  ' + painter.dimmed('已退出配对界面，后台服务继续运行') + '\n');
+            finish(0);
+        };
+        process.on('SIGINT', onSigint);
+        const timer = setInterval(() => {
+            void fetchPhones(device).then((phones) => {
+                if (phones.length > before) {
+                    const latest = phones[phones.length - 1];
+                    process.stdout.write('\n  ' + painter.ok('✓ ') + '已与 ' + painter.soft(latest.name)
+                        + ' 配对，后台服务继续运行\n\n');
+                    finish(0);
+                }
+            });
+        }, 1000);
+    });
+}
+async function isServeRunning() {
+    try {
+        const response = await fetch('http://127.0.0.1:' + SERVE_PORT + '/health', {
+            signal: AbortSignal.timeout(1500),
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+async function serveVersion() {
+    try {
+        const response = await fetch('http://127.0.0.1:' + SERVE_PORT + '/health', {
+            signal: AbortSignal.timeout(1500),
+        });
+        const data = await response.json();
+        return data.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function stopServe() {
+    try {
+        const pid = Number(fs.readFileSync(pidFilePath(), 'utf8').trim());
+        if (Number.isInteger(pid) && pid > 0) {
+            process.kill(pid);
+        }
+    }
+    catch {
+        // no pid file, nothing to stop
+    }
+}
+async function waitForServeDown(ms) {
+    const deadline = Date.now() + ms;
+    while (Date.now() < deadline) {
+        if (!(await isServeRunning())) {
+            return true;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 300));
+    }
+    return false;
+}
+async function waitForServe(ms) {
+    const deadline = Date.now() + ms;
+    while (Date.now() < deadline) {
+        if (await isServeRunning()) {
+            return true;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 400));
+    }
+    return false;
+}
+function binPath() {
+    return fileURLToPath(new URL('../../bin/minko.js', import.meta.url));
+}
+function startServeDetached() {
+    if (process.platform === 'win32') {
+        try {
+            // `start /min` hands the process to the shell: it is not a child of this
+            // window, so closing the pairing terminal cannot kill it. wscript was
+            // silently blocked on some machines, so this is the reliable path.
+            const child = spawn('cmd.exe', [
+                '/c', 'start', '', '/min', process.execPath, binPath(), 'serve',
+            ], { detached: true, stdio: 'ignore', windowsHide: true });
+            child.unref();
+            return;
+        }
+        catch {
+            // fall through to a plain detached spawn
+        }
+    }
+    try {
+        const child = spawn(process.execPath, [binPath(), 'serve'], {
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: true,
+            cwd: process.cwd(),
+        });
+        child.unref();
+    }
+    catch {
+        // reported by waitForServe
+    }
+}
+function serveLogTail() {
+    try {
+        const file = path.join(minkoHome(), 'serve.log');
+        if (!fs.existsSync(file)) {
+            return '  （没有 serve.log：守护进程可能根本没启动，检查 ' + process.execPath + ' 是否存在）\n';
+        }
+        const text = fs.readFileSync(file, 'utf8').trimEnd();
+        const tail = text.length > 1500 ? text.slice(text.length - 1500) : text;
+        return tail.split('\n').map((line) => '  ' + line).join('\n') + '\n';
+    }
+    catch {
+        return '  （读取 serve.log 失败）\n';
+    }
+}
+async function fetchPhones(device) {
+    try {
+        const response = await fetch('http://127.0.0.1:' + SERVE_PORT + '/pair', {
+            headers: { authorization: 'Bearer ' + (device.token ?? '') },
+            signal: AbortSignal.timeout(2000),
+        });
+        const data = await response.json();
+        return data.phones ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Adds a login-time starter so the daemon comes back after a reboot. */
+function ensureAutostart() {
+    if (process.platform !== 'win32') {
+        return false;
+    }
+    const appData = process.env.APPDATA ?? '';
+    if (appData.length === 0) {
+        return false;
+    }
+    const dir = path.join(appData, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup');
+    if (!fs.existsSync(dir)) {
+        return false;
+    }
+    const file = path.join(dir, 'minko-serve.cmd');
+    const content = '@echo off\r\nstart "" /min "' + process.execPath + '" "'
+        + binPath() + '" serve\r\n';
+    try {
+        fs.writeFileSync(file, content, 'utf8');
+        // Remove the older VBS starter if a previous version wrote one.
+        const legacy = path.join(dir, 'minko-serve.vbs');
+        if (fs.existsSync(legacy)) {
+            fs.unlinkSync(legacy);
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/cli/loginCommand.js

@@ -0,0 +1,69 @@
+import { loadConfig, saveConfig } from "../config/store.js";
+import { deviceLogin } from "../oauth/device.js";
+import { saveOAuthToken } from "../oauth/store.js";
+import { Painter } from "../ui/ansi.js";
+export async function runLoginCommand() {
+    const painter = new Painter();
+    const config = loadConfig();
+    const oauth = config.oauth;
+    if (!oauth.deviceAuthorizationUrl || !oauth.tokenUrl || !oauth.clientId) {
+        process.stderr.write(painter.error('还没有配置 OAuth。请在 ~/.minko/config.json 添加：') + '\n');
+        process.stderr.write('  "oauth": {\n'
+            + '    "deviceAuthorizationUrl": "https://id.example/device",\n'
+            + '    "tokenUrl": "https://id.example/token",\n'
+            + '    "clientId": "...",\n'
+            + '    "scopes": ["openid", "profile"],\n'
+            + '    "provider": "你的服务商名"\n'
+            + '  }\n');
+        return 1;
+    }
+    try {
+        const tokens = await deviceLogin({
+            deviceAuthorizationUrl: oauth.deviceAuthorizationUrl,
+            tokenUrl: oauth.tokenUrl,
+            clientId: oauth.clientId,
+            scopes: oauth.scopes,
+        }, {
+            onUserCode: (info) => {
+                process.stdout.write('\n  ' + painter.bold('OAuth 登录') + '\n');
+                process.stdout.write('  1. 打开：' + painter.primary(info.verificationUri) + '\n');
+                if (info.verificationUriComplete) {
+                    process.stdout.write('     或直接打开：' + painter.soft(info.verificationUriComplete) + '\n');
+                }
+                process.stdout.write('  2. 输入代码：' + painter.primary(info.userCode) + '\n');
+                process.stdout.write('  ' + painter.dimmed('等待授权…（Ctrl+C 取消）') + '\n\n');
+            },
+        });
+        const profile = oauth.name || oauth.provider || config.active || 'default';
+        saveOAuthToken(profile, tokens);
+        const providerName = oauth.provider || config.active;
+        if (providerName && config.providers[providerName]) {
+            saveConfig({
+                ...config,
+                providers: {
+                    ...config.providers,
+                    [providerName]: {
+                        ...config.providers[providerName],
+                        apiKey: tokens.accessToken,
+                        auth: 'bearer',
+                    },
+                },
+            });
+            process.stdout.write(painter.ok('✓ ') + '已登录，并更新服务商 '
+                + painter.soft(providerName) + painter.dimmed('（auth: bearer）') + '\n');
+        }
+        else {
+            process.stdout.write(painter.ok('✓ ') + '已保存 OAuth 令牌（profile '
+                + painter.soft(profile) + '），但没有可更新的服务商\n');
+        }
+        if (tokens.expiresAt) {
+            process.stdout.write('  ' + painter.dimmed('令牌过期时间：'
+                + new Date(tokens.expiresAt).toISOString().slice(0, 16).replace('T', ' ')) + '\n');
+        }
+        return 0;
+    }
+    catch (error) {
+        process.stderr.write(painter.error(error instanceof Error ? error.message : String(error)) + '\n');
+        return 1;
+    }
+}

package/dist/cli/mcpLoginCommand.js

@@ -0,0 +1,68 @@
+import { loadConfig, saveConfig } from "../config/store.js";
+import { deviceLogin } from "../oauth/device.js";
+import { saveOAuthToken } from "../oauth/store.js";
+import { Painter } from "../ui/ansi.js";
+export function withMcpToken(config, server, token) {
+    const current = config.mcpServers[server];
+    if (!current) {
+        return config;
+    }
+    return {
+        ...config,
+        mcpServers: {
+            ...config.mcpServers,
+            [server]: { ...current, token },
+        },
+    };
+}
+export async function runMcpLoginCommand(serverName) {
+    const painter = new Painter();
+    const config = loadConfig();
+    const names = Object.keys(config.mcpServers);
+    if (!serverName || serverName.trim().length === 0) {
+        process.stderr.write(painter.error('用法：minko mcp-login <server>') + '\n');
+        if (names.length > 0) {
+            process.stderr.write('  可用 server：' + names.join('、') + '\n');
+        }
+        return 1;
+    }
+    const name = serverName.trim();
+    const server = config.mcpServers[name];
+    if (!server) {
+        process.stderr.write(painter.error('找不到 MCP server：' + name) + '\n');
+        return 1;
+    }
+    if (!server.oauth) {
+        process.stderr.write(painter.error('这个 MCP server 没有配置 oauth：' + name) + '\n');
+        return 1;
+    }
+    try {
+        const tokens = await deviceLogin({
+            deviceAuthorizationUrl: server.oauth.deviceAuthorizationUrl,
+            tokenUrl: server.oauth.tokenUrl,
+            clientId: server.oauth.clientId,
+            scopes: server.oauth.scopes,
+        }, {
+            onUserCode: (info) => {
+                process.stdout.write('\n  ' + painter.bold('MCP OAuth 登录') + ' · ' + name + '\n');
+                process.stdout.write('  1. 打开：' + painter.primary(info.verificationUri) + '\n');
+                if (info.verificationUriComplete) {
+                    process.stdout.write('     或直接打开：' + painter.soft(info.verificationUriComplete) + '\n');
+                }
+                process.stdout.write('  2. 输入代码：' + painter.primary(info.userCode) + '\n');
+                process.stdout.write('  ' + painter.dimmed('等待授权…（Ctrl+C 取消）') + '\n\n');
+            },
+        });
+        saveConfig(withMcpToken(config, name, tokens.accessToken));
+        saveOAuthToken('mcp:' + name, tokens);
+        process.stdout.write(painter.ok('✓ ') + '已为 MCP server ' + painter.soft(name)
+            + ' 保存令牌' + (tokens.expiresAt
+            ? painter.dimmed('（' + new Date(tokens.expiresAt).toISOString().slice(0, 16).replace('T', ' ') + ' 过期）')
+            : '') + '\n');
+        return 0;
+    }
+    catch (error) {
+        process.stderr.write(painter.error(error instanceof Error ? error.message : String(error)) + '\n');
+        return 1;
+    }
+}