dgxay-code-cli 0.0.0-stage → 1.0.0

package/src/cli/slash.js

@@ -0,0 +1,74 @@
+'use strict';
+
+/**
+ * 交互模式里的斜杠命令（对应桌面版输入框的 / 菜单）。
+ *
+ * 与桌面版的关系：
+ *   桌面版只有 /压缩 与 /技能；CLI 额外提供会话、模型、权限、MCP 等
+ *   「原本在界面按钮上」的操作，保证去掉 UI 后功能不丢。
+ */
+
+const SLASH_COMMANDS = [
+  { name: '/help', desc: '查看所有命令', usage: '/help' },
+  { name: '/new', desc: '开始新对话', usage: '/new' },
+  { name: '/list', desc: '列出历史对话', usage: '/list' },
+  { name: '/resume', desc: '恢复历史对话', usage: '/resume <序号|ID>' },
+  { name: '/delete', desc: '删除一段对话', usage: '/delete <序号|ID>' },
+  { name: '/rename', desc: '重命名当前对话', usage: '/rename <标题>' },
+  { name: '/compress', desc: '压缩上下文（有损，不可撤销）', usage: '/compress', aliases: ['/压缩'] },
+  { name: '/skill', desc: '列出或启用技能', usage: '/skill [名称] [提示词]', aliases: ['/技能'] },
+  { name: '/model', desc: '查看或切换模型', usage: '/model [序号|ID]' },
+  { name: '/provider', desc: '查看或切换供应商', usage: '/provider [序号|名称]' },
+  { name: '/mode', desc: '切换对话 / 工作模式', usage: '/mode [chat|work]' },
+  { name: '/permission', desc: '切换权限档位', usage: '/permission [none|normal|auto|full]' },
+  { name: '/cd', desc: '切换工作空间', usage: '/cd <目录>' },
+  { name: '/ls', desc: '查看工作空间文件', usage: '/ls [目录]' },
+  { name: '/pwd', desc: '显示当前工作空间', usage: '/pwd' },
+  { name: '/term', desc: '执行终端命令（不进模型上下文时用 ! 前缀）', usage: '/term <命令>' },
+  { name: '/context', desc: '查看上下文用量', usage: '/context' },
+  { name: '/mcp', desc: '管理 MCP：list/start/stop/logs/add/rm', usage: '/mcp [子命令]' },
+  { name: '/theme', desc: '开关颜色输出', usage: '/theme [on|off]' },
+  { name: '/clear', desc: '清屏（不删除会话）', usage: '/clear' },
+  { name: '/exit', desc: '退出', usage: '/exit', aliases: ['/quit'] }
+];
+
+function findCommand(text) {
+  const token = String(text || '').trim().split(/\s+/)[0].toLowerCase();
+  if (!token) return null;
+  return (
+    SLASH_COMMANDS.find((cmd) => cmd.name === token) ||
+    SLASH_COMMANDS.find((cmd) => (cmd.aliases || []).includes(token)) ||
+    null
+  );
+}
+
+/**
+ * 行编辑器的补全器：只在输入以 / 开头且光标在首行时弹出。
+ * 返回 { items: [{ label, hint, apply }], title, hint }
+ */
+function completer(value, cursor) {
+  if (!value || !value.startsWith('/')) return null;
+  if (value.includes('\n')) return null;
+  const before = value.slice(0, cursor);
+  if (before.includes(' ')) return null;
+  const query = before.slice(1).toLowerCase();
+  const items = SLASH_COMMANDS.filter(
+    (cmd) =>
+      !query ||
+      cmd.name.slice(1).toLowerCase().startsWith(query) ||
+      (cmd.aliases || []).some((alias) => alias.slice(1).toLowerCase().startsWith(query))
+  ).map((cmd) => ({
+    label: cmd.name,
+    hint: cmd.desc,
+    apply: `${cmd.name} `,
+    command: cmd
+  }));
+  if (!items.length) return null;
+  return {
+    title: '斜杠命令',
+    hint: '↑↓ 选择 · Tab 补全 · Enter 执行 · Esc 关闭',
+    items
+  };
+}
+
+module.exports = { SLASH_COMMANDS, findCommand, completer };

package/src/cli/ui.js

@@ -0,0 +1,52 @@
+'use strict';
+
+/**
+ * 上下文用量（对应桌面版的上下文圆环）。
+ */
+
+const { estimateChatTokens, contextLimit, formatTokens } = require('../core/sessions');
+const { COLORS, ring, truncate, displayWidth, termWidth } = require('./ansi');
+
+function contextInfo(chat, model) {
+  const used = estimateChatTokens(chat);
+  const limit = contextLimit(model);
+  const ratio = limit > 0 ? Math.min(1, used / limit) : 0;
+  const messageCount = (chat?.messages || []).filter((msg) => msg.role !== 'terminal').length;
+  return { used, limit, ratio, messageCount, model, skill: chat?.skill || '' };
+}
+
+/** 输入框下方的上下文环（单行） */
+function ringLine(info) {
+  const percent = Math.round(info.ratio * 100);
+  return `${ring(info.ratio)} ${COLORS.faint(`${formatTokens(info.used)}/${formatTokens(info.limit)} · ${percent}%`)}`;
+}
+
+/** /context 命令的详细输出 */
+function contextReport(info) {
+  const lines = [];
+  const percent = (info.ratio * 100).toFixed(info.ratio < 0.1 ? 1 : 0);
+  lines.push(`${COLORS.accent('上下文')} ${COLORS.bold(`${percent}%`)} ${COLORS.faint(
+    `${formatTokens(info.used)} / ${formatTokens(info.limit)}`
+  )}`);
+  const width = Math.max(10, Math.min(40, termWidth() - 12));
+  const filled = Math.round(info.ratio * width);
+  lines.push(`${COLORS.accent('█'.repeat(filled))}${COLORS.faint('░'.repeat(Math.max(0, width - filled)))}`);
+  lines.push('');
+  const rows = [
+    ['对话消息', String(info.messageCount)],
+    ['上下文上限', formatTokens(info.limit)],
+    ['剩余可用', formatTokens(Math.max(0, info.limit - info.used))],
+    ['当前模型', info.model?.name || '未选择'],
+    ['供应商', info.model?.providerName || ''],
+    ['技能', info.skill || '无']
+  ];
+  const labelWidth = Math.max(...rows.map(([label]) => displayWidth(label)));
+  for (const [label, value] of rows) {
+    lines.push(`  ${COLORS.faint(truncate(label, 12).padEnd(labelWidth))}  ${value}`);
+  }
+  lines.push('');
+  lines.push(COLORS.faint('按字符启发式估算，实际 token 以模型 usage 为准；接近上限时用 /compress 保留重要上下文。'));
+  return lines.join('\n');
+}
+
+module.exports = { contextInfo, ringLine, contextReport };

package/src/commands/_shared.js

@@ -0,0 +1,20 @@
+'use strict';
+
+/** 子命令之间共享的小工具。 */
+
+const sessions = require('../core/sessions');
+
+function resolveChatArg(opts = {}, runtime = {}) {
+  if (opts.resume || runtime.resume) return sessions.getChat(String(opts.resume || runtime.resume));
+  if (opts.continue || runtime.continueLast) return sessions.listChats()[0] || null;
+  return null;
+}
+
+/** 失败时给出“下一步”提示而不是直接抛错 */
+function requireProviders(config) {
+  if (!config.providers?.length) {
+    throw Object.assign(new Error('还没有配置供应商。运行 dgxay config init 开始配置'), { userError: true });
+  }
+}
+
+module.exports = { resolveChatArg, requireProviders };

package/src/commands/chat.js

@@ -0,0 +1,212 @@
+'use strict';
+
+/**
+ * chat：会话管理与在新会话中提问。
+ *
+ *   dgxay chat new               新建会话
+ *   dgxay chat list              列出历史会话
+ *   dgxay chat show <序号|ID>    查看某个会话
+ *   dgxay chat resume <序号|ID>  进入交互模式并恢复该会话
+ *   dgxay chat rm <序号|ID>      删除会话
+ *   dgxay chat rename <序号|ID> <标题>
+ *   dgxay chat clear             清空全部会话
+ *   dgxay chat "问题"            在最近会话上继续提问
+ */
+
+const fs = require('fs');
+const print = require('../cli/print');
+const { parseArgs, actionFirst } = require('../cli/args');
+const { COLORS, renderMarkdown, termWidth } = require('../cli/ansi');
+const sessions = require('../core/sessions');
+
+const options = [
+  { name: 'print', alias: 'p', type: 'string', valueName: 'text', desc: '直接提问（等同 dgxay run）' },
+  { name: 'mode', alias: 'm', type: 'string', valueName: 'mode', desc: 'chat / work' },
+  { name: 'permission', type: 'string', valueName: 'level', desc: 'none / normal / auto / full' },
+  { name: 'workspace', alias: 'C', type: 'string', valueName: 'dir', desc: '工作空间目录' },
+  { name: 'yes', alias: 'y', type: 'boolean', desc: '自动同意授权请求' },
+  { name: 'yes-all', type: 'boolean', desc: '清空会话时跳过确认' }
+];
+
+function relativeTime(ts) {
+  const diff = Date.now() - Number(ts || 0);
+  if (diff < 60000) return '刚刚';
+  if (diff < 3600000) return `${Math.floor(diff / 60000)} 分钟前`;
+  if (diff < 86400000) return `${Math.floor(diff / 3600000)} 小时前`;
+  const date = new Date(ts);
+  return `${date.getMonth() + 1} 月 ${date.getDate()} 日`;
+}
+
+function listChats() {
+  const chats = sessions.listChats();
+  print.blank();
+  if (!chats.length) {
+    print.hint('还没有保存的会话');
+    return 0;
+  }
+  print.heading(`历史会话（${chats.length}，最多保留 ${sessions.MAX_CHATS} 段）`);
+  const rows = chats.map((chat, index) => {
+    const messages = chat.messages.filter((m) => m.role !== 'terminal');
+    const last = messages[messages.length - 1];
+    return [
+      String(index + 1),
+      chat.title || '新对话',
+      String(messages.length),
+      relativeTime(chat.updatedAt),
+      chat.mode === 'work' ? '工作' : '对话',
+      chat.skill || '',
+      last ? String(last.content || '').replace(/\s+/g, ' ').slice(0, 40) : ''
+    ];
+  });
+  print.table(
+    [
+      { title: '#', max: 3 },
+      { title: '标题', max: 30 },
+      { title: '消息', max: 4 },
+      { title: '更新时间', max: 10 },
+      { title: '模式', max: 4 },
+      { title: '技能', max: 12 },
+      { title: '最后内容', max: 40 }
+    ],
+    rows
+  );
+  print.blank();
+  print.hint('dgxay chat resume 1        恢复第 1 个会话');
+  print.hint('dgxay -r 1                 直接恢复并进入交互模式');
+  print.hint('dgxay chat show 1          只查看内容');
+  print.blank();
+  return 0;
+}
+
+function showChat(ref) {
+  const chat = sessions.resolveChat(ref);
+  if (!chat) {
+    print.fail(`找不到会话：${ref}`);
+    return 1;
+  }
+  print.blank();
+  print.write(`${COLORS.bold(chat.title)} ${COLORS.faint(`${chat.id} · ${relativeTime(chat.updatedAt)}`)}`);
+  for (const message of chat.messages) {
+    if (message.role === 'user') {
+      print.write(`\n${COLORS.accent('▍你')}`);
+      print.write(message.content || '');
+    } else if (message.role === 'assistant') {
+      print.write(`\n${COLORS.accent('▍DgxayCode')}`);
+      process.stdout.write(renderMarkdown(message.content || '', { width: termWidth() }));
+      if (message.error) print.write(COLORS.red(message.error));
+      if (message.tools?.length) {
+        for (const tool of message.tools) {
+          print.write(COLORS.faint(`  · ${tool.name} ${tool.ok ? '成功' : '失败'}`));
+        }
+      }
+    } else if (message.role === 'terminal') {
+      print.write(`\n${COLORS.faint(`▍终端 $ ${message.command}`)}`);
+      const output = `${message.output || ''}${message.stderr ? `\n${message.stderr}` : ''}`;
+      print.write(output.slice(0, 4000));
+      print.write(COLORS.faint(`  exit=${message.exitCode ?? '?'}`));
+    }
+  }
+  print.blank();
+  return 0;
+}
+
+async function run({ argv, runtime }) {
+  const { action: rawAction, rest, options: opts } = actionFirst(argv, options);
+  const action = rawAction || 'list';
+
+  switch (action) {
+    case 'list':
+    case 'ls':
+      return listChats();
+
+    case 'show':
+    case 'view': {
+      if (!rest[0]) throw Object.assign(new Error('用法：dgxay chat show <序号|ID>'), { userError: true });
+      return showChat(rest[0]);
+    }
+
+    case 'new': {
+      print.ok(opts.print ? '新会话已建立（单次提问，不会保存到历史）' : '进入交互模式后将自动创建会话');
+      return 0;
+    }
+
+    case 'resume': {
+      if (!rest[0]) throw Object.assign(new Error('用法：dgxay chat resume <序号|ID>'), { userError: true });
+      const chat = sessions.resolveChat(rest[0]);
+      if (!chat) {
+        print.fail(`找不到会话：${rest[0]}`);
+        return 1;
+      }
+      const repl = require('../cli/repl');
+      return repl.start({ ...runtime, resume: chat.id, single: false });
+    }
+
+    case 'rm':
+    case 'delete': {
+      if (!rest[0]) throw Object.assign(new Error('用法：dgxay chat rm <序号|ID>'), { userError: true });
+      const chat = sessions.resolveChat(rest[0]);
+      if (!chat) {
+        print.fail(`找不到会话：${rest[0]}`);
+        return 1;
+      }
+      sessions.deleteChat(chat.id);
+      print.ok(`已删除「${chat.title}」`);
+      return 0;
+    }
+
+    case 'rename': {
+      const ref = rest[0];
+      const title = rest.slice(1).join(' ').trim();
+      if (!ref || !title) throw Object.assign(new Error('用法：dgxay chat rename <序号|ID> <新标题>'), { userError: true });
+      const chat = sessions.resolveChat(ref);
+      if (!chat) {
+        print.fail(`找不到会话：${ref}`);
+        return 1;
+      }
+      chat.title = title;
+      chat.updatedAt = Date.now();
+      sessions.saveChat(chat);
+      print.ok(`已重命名为「${title}」`);
+      return 0;
+    }
+
+    case 'clear': {
+      if (!opts.yesAll && process.stdin.isTTY) {
+        const { confirm } = require('../services/input');
+        const ok = await confirm('清空全部会话记录？（不可恢复）', false);
+        if (!ok) {
+          print.hint('已取消');
+          return 1;
+        }
+      }
+      sessions.clearChats();
+      print.ok('全部会话已清空');
+      return 0;
+    }
+
+    default: {
+      // 非子命令：当作提示词，在最近会话上继续提问
+      const prompt = positionals.join(' ').trim();
+      const repl = require('../cli/repl');
+      return repl.start({ ...runtime, initialPrompt: prompt, single: true, continueLast: true });
+    }
+  }
+}
+
+module.exports = {
+  name: 'chat',
+  aliases: ['c'],
+  summary: '会话管理：列表、查看、恢复、删除',
+  usage: 'dgxay chat <list|show|resume|rm|rename|clear>',
+  options,
+  subcommands: [
+    ['list', '列出历史会话'],
+    ['show <序号|ID>', '查看会话内容'],
+    ['resume <序号|ID>', '进入交互模式并恢复'],
+    ['rm <序号|ID>', '删除会话'],
+    ['rename <序号|ID> <标题>', '重命名会话'],
+    ['clear', '清空全部会话']
+  ],
+  examples: ['dgxay chat list', 'dgxay chat resume 1', 'dgxay chat rm 2', 'dgxay chat show 1'],
+  run
+};