@minko-ai/minko 0.1.0 → 0.1.1

package/dist/commands/registry.js

@@ -0,0 +1,99 @@
+export const SLASH_COMMANDS = [
+    { name: 'help', aliases: ['?'], description: '显示命令帮助', category: '会话' },
+    { name: 'new', description: '新建会话', category: '会话' },
+    { name: 'clear', description: '清空当前上下文', category: '上下文' },
+    { name: 'compact', usage: '[保留条数]', description: '把较早对话折叠成摘要', category: '上下文', examples: ['/compact', '/compact 2'] },
+    { name: 'plan', description: '切换只读计划模式', category: '上下文', examples: ['/plan'] },
+    { name: 'todos', description: '查看待办清单', category: '上下文' },
+    { name: 'fork', usage: '[名字]', description: '从当前会话复制一个分支', category: '会话', examples: ['/fork', '/fork 尝试A'] },
+    { name: 'model', usage: '<id>', description: '临时切换模型', category: '设置' },
+    { name: 'cwd', description: '显示当前工作目录', category: '状态' },
+    { name: 'sessions', description: '列出最近会话', category: '会话' },
+    { name: 'export', usage: '[路径]', description: '导出当前会话为 Markdown', category: '会话', examples: ['/export', '/export chat.md'] },
+    { name: 'status', description: '查看配置、模型、会话和插件状态', category: '状态' },
+    { name: 'usage', description: '查看本会话 token 用量', category: '状态' },
+    { name: 'workers', description: '列出后台 worker', category: '工具' },
+    { name: 'tasks', description: '列出任务板', category: '工具' },
+    { name: 'crons', description: '列出定时任务', category: '工具' },
+    { name: 'lanes', description: '列出 git worktree lane', category: '工具' },
+    { name: 'approvals', description: '列出审批令牌', category: '工具' },
+    { name: 'plugins', description: '列出已安装插件', category: '工具' },
+    { name: 'skills', description: '列出技能包', category: '工具' },
+    { name: 'memory', description: '查看长期记忆索引', category: '上下文' },
+    { name: 'sandbox', description: '查看 Docker 沙箱状态', category: '设置' },
+    { name: 'exit', aliases: ['quit'], description: '退出 Minko', category: '会话' },
+];
+export function listCommands() {
+    return SLASH_COMMANDS.map((command) => ({
+        ...command,
+        aliases: command.aliases ? [...command.aliases] : undefined,
+        examples: command.examples ? [...command.examples] : undefined,
+    }));
+}
+export function parseSlash(input) {
+    const trimmed = input.trim();
+    if (!trimmed.startsWith('/')) {
+        return null;
+    }
+    const [first, ...rest] = trimmed.slice(1).split(/\s+/);
+    if (!first) {
+        return null;
+    }
+    return { name: first.toLowerCase(), argument: rest.join(' ').trim() };
+}
+export function findCommand(name) {
+    const wanted = name.toLowerCase();
+    return SLASH_COMMANDS.find((command) => command.name === wanted
+        || command.aliases?.includes(wanted));
+}
+export function commandHelp() {
+    const categories = ['会话', '上下文', '状态', '工具', '设置'];
+    const lines = ['命令'];
+    for (const category of categories) {
+        const commands = SLASH_COMMANDS.filter((command) => command.category === category);
+        if (commands.length === 0) {
+            continue;
+        }
+        lines.push('', '  [' + category + ']');
+        for (const command of commands) {
+            const usage = command.usage ? ' ' + command.usage : '';
+            lines.push('    /' + command.name + usage + '  ' + command.description);
+        }
+    }
+    return lines.join('\n');
+}
+/** Levenshtein-based suggestion for a mistyped command. */
+export function suggestCommand(name) {
+    const wanted = name.toLowerCase();
+    let best = null;
+    let bestDistance = 3;
+    for (const command of SLASH_COMMANDS) {
+        const candidates = [command.name, ...(command.aliases ?? [])];
+        for (const candidate of candidates) {
+            const distance = levenshtein(wanted, candidate);
+            if (distance < bestDistance) {
+                bestDistance = distance;
+                best = command.name;
+            }
+        }
+    }
+    return bestDistance <= 2 ? best : null;
+}
+function levenshtein(a, b) {
+    const rows = a.length + 1;
+    const cols = b.length + 1;
+    const matrix = Array.from({ length: rows }, () => new Array(cols).fill(0));
+    for (let row = 0; row < rows; row += 1) {
+        matrix[row][0] = row;
+    }
+    for (let col = 0; col < cols; col += 1) {
+        matrix[0][col] = col;
+    }
+    for (let row = 1; row < rows; row += 1) {
+        for (let col = 1; col < cols; col += 1) {
+            const cost = a[row - 1] === b[col - 1] ? 0 : 1;
+            matrix[row][col] = Math.min(matrix[row - 1][col] + 1, matrix[row][col - 1] + 1, matrix[row - 1][col - 1] + cost);
+        }
+    }
+    return matrix[rows - 1][cols - 1];
+}

package/dist/config/paths.js

@@ -0,0 +1,81 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+let resolved = null;
+let fallback = null;
+function canWrite(dir) {
+    try {
+        fs.mkdirSync(dir, { recursive: true });
+        const probe = path.join(dir, '.minko-write-' + Date.now() + '-'
+            + Math.random().toString(36).slice(2, 6));
+        fs.writeFileSync(probe, '');
+        fs.unlinkSync(probe);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function safeUser() {
+    try {
+        return os.userInfo().username || 'user';
+    }
+    catch {
+        return 'user';
+    }
+}
+/**
+ * Picks a writable data directory. Some locked-down Windows profiles reject
+ * writes to the whole user folder (even AppData), so fall back instead of
+ * dying on the first session save.
+ */
+export function minkoHome() {
+    if (resolved) {
+        return resolved;
+    }
+    const candidates = [];
+    const custom = process.env.MINKO_HOME;
+    if (custom && custom.trim().length > 0) {
+        candidates.push({ dir: path.resolve(custom), note: 'MINKO_HOME 不可写，改用 ' });
+    }
+    candidates.push({ dir: path.join(os.homedir(), '.minko'), note: '主目录不可写，改用 ' });
+    candidates.push({
+        dir: path.join(os.tmpdir(), 'minko-' + safeUser()),
+        note: '主目录不可写，数据暂存到临时目录 ',
+    });
+    for (const candidate of candidates) {
+        if (canWrite(candidate.dir)) {
+            resolved = candidate.dir;
+            fallback = candidate.note.length > 0 ? candidate.note + candidate.dir : null;
+            return candidate.dir;
+        }
+    }
+    throw new Error('找不到可写的数据目录，请设置环境变量 MINKO_HOME 指向一个可写文件夹');
+}
+/** Non-null when the default home was unusable and a fallback is in effect. */
+export function homeFallbackWarning() {
+    minkoHome();
+    return fallback;
+}
+export function configPath() {
+    // Read an existing config from the default home even when that folder is
+    // read-only; only new configs go to the writable fallback.
+    const preferred = path.join(preferredHome(), 'config.json');
+    if (fs.existsSync(preferred)) {
+        return preferred;
+    }
+    return path.join(minkoHome(), 'config.json');
+}
+function preferredHome() {
+    const custom = process.env.MINKO_HOME;
+    if (custom && custom.trim().length > 0) {
+        return path.resolve(custom);
+    }
+    return path.join(os.homedir(), '.minko');
+}
+export function sessionsDir() {
+    return path.join(minkoHome(), 'sessions');
+}
+export function historyFile() {
+    return path.join(minkoHome(), 'history.jsonl');
+}