dgxay-code-cli 0.0.0-stage → 1.0.0

package/src/commands/run.js

@@ -0,0 +1,172 @@
+'use strict';
+
+/**
+ * run：一次性把提示词交给模型并打印结果。
+ *
+ *   dgxay run -p "帮我整理这个目录" -C ./project -m work --permission auto
+ *   dgxay run -p "生成接口文档" -o json
+ *
+ * 权限提示：带工具的工作模式如果遇到需要确认的操作，单次运行默认拒绝；
+ * 明确加 --yes 才会自动放行（只对本进程生效，不写入配置）。
+ */
+
+const print = require('../cli/print');
+const { parseArgs } = require('../cli/args');
+const { askApproval } = require('../cli/approval');
+const settings = require('../services/settings');
+const { runAgent } = require('../core/agent');
+const { StreamRenderer } = require('../cli/render');
+const { resolveChatArg } = require('./_shared');
+
+const options = [
+  { name: 'prompt', alias: 'p', type: 'string', valueName: 'text', desc: '提示词' },
+  { name: 'mode', alias: 'm', type: 'string', valueName: 'mode', desc: 'chat / work（默认 chat）' },
+  { name: 'permission', type: 'string', valueName: 'level', desc: 'none / normal / auto / full' },
+  { name: 'workspace', alias: 'C', type: 'string', valueName: 'dir', desc: '工作空间目录' },
+  { name: 'provider', type: 'string', valueName: 'name', desc: '供应商 id 或名称' },
+  { name: 'model', type: 'string', valueName: 'id', desc: '模型 id' },
+  { name: 'skill', type: 'string', valueName: 'name', desc: '启用的技能' },
+  { name: 'resume', alias: 'r', type: 'string', valueName: 'id|index', desc: '在指定会话上继续' },
+  { name: 'continue', alias: 'c', type: 'boolean', desc: '在最近的会话上继续' },
+  { name: 'output', alias: 'o', type: 'string', valueName: 'text|json', desc: '输出格式，默认 text' },
+  { name: 'yes', alias: 'y', type: 'boolean', desc: '自动同意授权请求（危险）' },
+  { name: 'quiet', alias: 'q', type: 'boolean', desc: '只输出回答正文' }
+];
+
+async function run({ argv, globalOptions, runtime }) {
+  const { options: opts, positionals } = parseArgs(argv, options);
+  const prompt = String(opts.prompt || positionals.join(' ') || runtime.prompt || '').trim();
+  if (!prompt) {
+    throw Object.assign(new Error('缺少提示词：请使用 -p "..." 或直接跟问题'), { userError: true });
+  }
+
+  const config = settings.readConfig();
+  if (!config.providers?.length) {
+    throw Object.assign(new Error('尚未配置供应商，请先运行 dgxay config init'), { userError: true });
+  }
+
+  const mode = String(opts.mode || runtime.mode || 'chat') === 'work' ? 'work' : 'chat';
+  const permission = String(opts.permission || runtime.permission || settings.currentPermission(config));
+  const workspace = opts.workspace || runtime.workspace || config.work?.workspace || process.cwd();
+  const skill = String(opts.skill || runtime.skill || '');
+  const outputFormat = String(opts.output || runtime.output || 'text');
+  // JSON 输出时把正文让给最终的结构化结果，避免混入流式文本
+  const jsonMode = outputFormat === 'json';
+  const quiet = Boolean(opts.quiet) || jsonMode;
+  // 正文一旦输出就无法回退：提示词只在安静/JSON 模式之外显示
+  if (!quiet) print.write(prompt);
+
+  const chat = resolveChatArg(opts, runtime);
+  const history = chat ? require('../core/sessions').buildHistory(chat) : [];
+  // 关键：本次提问必须进入消息列表，否则模型只会看到历史（甚至只看得到 system）
+  const messages = [...history, { role: 'user', content: prompt }];
+
+  const renderer = new StreamRenderer({
+    output: process.stdout,
+    redraw: Boolean(process.stdout.isTTY) && !quiet
+  });
+  const startedAt = Date.now();
+  const result = await runAgent({
+    config,
+    messages,
+    providerId: opts.provider || runtime.provider,
+    modelId: opts.model || runtime.model,
+    mode,
+    permission,
+    workspace,
+    skill,
+    askUser: async (request) => {
+      if (opts.yes || runtime.yes) return true;
+      return askApproval(request);
+    },
+    onEvent: (event) => {
+      if (jsonMode) {
+        // JSON 模式只保留需要人工介入的过程提示（授权、审查），正文交给最终 JSON
+        if (!['review', 'review-start', 'waiting', 'file'].includes(event.type)) return;
+        if (event.type === 'tool') return;
+      }
+      if (opts.quiet && !['delta', 'done', 'error', 'aborted'].includes(event.type)) return;
+      renderer.handle(event);
+    }
+  });
+
+  if (jsonMode) {
+    process.stdout.write(
+      `${JSON.stringify(
+        {
+          ok: result.ok,
+          aborted: Boolean(result.aborted),
+          text: result.text,
+          reasoning: result.reasoning,
+          usage: result.usage,
+          toolLog: result.toolLog,
+          files: result.files,
+          error: result.error || null,
+          elapsedMs: Date.now() - startedAt
+        },
+        null,
+        2
+      )}\n`
+    );
+  }
+
+  persistChat({ chat, prompt, mode, permission, result, history });
+
+  if (result.error) return 1;
+  if (result.aborted) return 130;
+  return 0;
+}
+
+/**
+ * 单次运行的会话落库（与桌面版一致：每次提问都会出现在历史里）。
+ * 失败不影响命令结果，只在 debug 模式下提示。
+ */
+function persistChat({ chat, prompt, mode, permission, result, history }) {
+  const sessions = require('../core/sessions');
+  try {
+    const target =
+      chat ||
+      sessions.createChat({
+        mode,
+        skill: ''
+      });
+    target.mode = mode;
+    target.messages.push({
+      role: 'user',
+      content: prompt,
+      ts: Date.now(),
+      mode,
+      permission,
+      modeLabel: mode
+    });
+    target.messages.push({
+      role: 'assistant',
+      content: result.text || '',
+      ts: Date.now(),
+      error: result.error || '',
+      toolLog: result.toolLog,
+      files: result.files,
+      usage: result.usage || null
+    });
+    if (!target.title || target.title === '新对话') target.title = sessions.titleFrom(prompt);
+    sessions.saveChat(target);
+    return target;
+  } catch (err) {
+    if (process.env.DGXAY_DEBUG === '1') process.stderr.write(`[session] 保存失败：${err.message}\n`);
+    return null;
+  }
+}
+
+module.exports = {
+  name: 'run',
+  aliases: [],
+  summary: '单次执行：把提示词发给模型并输出结果',
+  usage: 'dgxay run -p "提示词" [-C 目录] [-m work] [--permission auto]',
+  options,
+  examples: [
+    'dgxay run -p "解释这个仓库的目录结构" -C .',
+    'dgxay run -p "给 README 补充安装说明" -m work -C ./project --permission normal',
+    'dgxay run -p "写一个快排函数" -o json'
+  ],
+  run
+};

package/src/commands/skill.js

@@ -0,0 +1,94 @@
+'use strict';
+
+/**
+ * skill：技能列表（对应桌面版「/技能」）。
+ *
+ *   dgxay skill list        列出 ~/.dcb/skills 下的技能
+ *   dgxay skill show <名称> 查看技能正文
+ *   dgxay skill path        显示技能目录
+ */
+
+const fs = require('fs');
+const path = require('path');
+const print = require('../cli/print');
+const { parseArgs, actionFirst } = require('../cli/args');
+const skills = require('../services/skills');
+const cfg = require('../services/config');
+const settings = require('../services/settings');
+
+const options = [{ name: 'json', type: 'boolean', desc: '输出 JSON' }];
+
+async function run({ argv }) {
+  const { action: rawAction, rest, options: opts } = actionFirst(argv, options);
+  const action = rawAction || 'list';
+
+  if (action === 'path') {
+    print.write(cfg.SKILLS_DIR);
+    return 0;
+  }
+
+  if (action === 'list' || action === 'ls') {
+    const list = skills.listSkills();
+    if (opts.json) {
+      process.stdout.write(`${JSON.stringify(list, null, 2)}\n`);
+      return 0;
+    }
+    print.blank();
+    print.heading(`技能（${settings.homeRelative(cfg.SKILLS_DIR)}）`);
+    if (!list.length) {
+      print.hint('  还没有技能。放一个 name.md 或 <目录>/SKILL.md 到技能目录即可。');
+      print.blank();
+      return 0;
+    }
+    const rows = list.map((skill, index) => [String(index + 1), skill.name, skill.description, path.basename(skill.path)]);
+    print.table(
+      [
+        { title: '#', max: 3 },
+        { title: '名称', max: 24 },
+        { title: '描述', max: 60 },
+        { title: '文件', max: 24 }
+      ],
+      rows
+    );
+    print.blank();
+    print.hint('在对话中使用 /skill <名称> 启用；单次运行可加 --skill <名称>');
+    print.blank();
+    return 0;
+  }
+
+  if (action === 'show' || action === 'cat') {
+    const name = rest[0];
+    if (!name) throw Object.assign(new Error('用法：dgxay skill show <名称>'), { userError: true });
+    const skill = skills.readSkill(name);
+    if (!skill) {
+      print.fail(`找不到技能：${name}`);
+      return 1;
+    }
+    print.blank();
+    print.heading(`${skill.name}`);
+    print.hint(skill.path);
+    print.blank();
+    print.write(skill.content);
+    print.blank();
+    return 0;
+  }
+
+  print.fail(`未知子命令：${action}`);
+  print.hint('可用：list / show / path');
+  return 1;
+}
+
+module.exports = {
+  name: 'skill',
+  aliases: ['skills'],
+  summary: '技能列表与查看',
+  usage: 'dgxay skill <list|show|path>',
+  options,
+  subcommands: [
+    ['list', '列出技能'],
+    ['show <名称>', '查看技能正文'],
+    ['path', '显示技能目录']
+  ],
+  examples: ['dgxay skill list', 'dgxay skill show review', 'dgxay skill path'],
+  run
+};

package/src/commands/workspace.js

@@ -0,0 +1,100 @@
+'use strict';
+
+/**
+ * workspace：工作空间管理。
+ *
+ *   dgxay workspace             显示当前工作空间
+ *   dgxay workspace set <目录>  设置工作空间（会记录到最近列表）
+ *   dgxay workspace list        查看最近使用的工作空间
+ *   dgxay workspace clear       清除工作空间
+ */
+
+const fs = require('fs');
+const path = require('path');
+const print = require('../cli/print');
+const { parseArgs, actionFirst } = require('../cli/args');
+const { COLORS } = require('../cli/ansi');
+const settings = require('../services/settings');
+
+const options = [{ name: 'both', alias: 'b', type: 'boolean', desc: '同时写入配置（默认只设当前进程）' }];
+
+async function run({ argv }) {
+  const { action, rest, options: opts } = actionFirst(argv, options);
+  const config = settings.readConfig();
+
+  if (!action || action === 'show' || action === 'current') {
+    const workspace = config.work?.workspace || process.cwd();
+    print.blank();
+    print.keyValue([
+      { label: '当前工作空间', value: workspace },
+      { label: '进程目录', value: process.cwd() },
+      { label: '最近使用', value: (config.work?.recentWorkspaces || []).slice(0, 5).join('\n') || '（无）', multiline: true }
+    ]);
+    print.blank();
+    print.hint('dgxay workspace set <目录> 设置；对话中可用 /cd');
+    print.blank();
+    return 0;
+  }
+
+  if (action === 'list' || action === 'ls') {
+    const recents = config.work?.recentWorkspaces || [];
+    print.blank();
+    if (!recents.length) {
+      print.hint('还没有设置过工作空间');
+      print.blank();
+      return 0;
+    }
+    print.heading('最近使用的工作空间');
+    recents.forEach((item, index) => {
+      const exists = fs.existsSync(item) ? COLORS.green('✓') : COLORS.red('✗');
+      print.write(`  ${status(index + 1)}  ${exists} ${item}`);
+    });
+    print.blank();
+    return 0;
+  }
+
+  if (action === 'set' || action === 'use' || action === 'cd') {
+    const target = rest[0] || '';
+    if (!target) throw Object.assign(new Error('用法：dgxay workspace set <目录>'), { userError: true });
+    const resolved = path.resolve(target);
+    try {
+      if (!fs.statSync(resolved).isDirectory()) throw new Error('不是文件夹');
+    } catch {
+      print.fail(`目录不存在：${resolved}`);
+      return 1;
+    }
+    settings.setWorkspace(resolved);
+    print.ok(`工作空间：${resolved}`);
+    void opts;
+    return 0;
+  }
+
+  if (action === 'clear' || action === 'unset') {
+    settings.setWorkspace('');
+    print.ok('已清除工作空间');
+    return 0;
+  }
+
+  // 其他情况当作路径直接设置
+  return run({ argv: ['set', action, ...rest] });
+}
+
+function status(index) {
+  return COLORS.faint(String(index).padStart(2));
+}
+
+module.exports = {
+  name: 'workspace',
+  aliases: ['ws'],
+  summary: '工作空间管理',
+  usage: 'dgxay workspace [set|list|clear] [目录]',
+  options,
+  subcommands: [
+    ['show', '显示当前工作空间'],
+    ['set <目录>', '设置工作空间'],
+    ['list', '查看最近使用'],
+    ['clear', '清除']
+  ],
+  examples: ['dgxay workspace set ./project', 'dgxay workspace list'],
+  run
+};