dgxay-code-cli 0.0.0-stage → 1.1.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: 'Prompt' },
+  { name: 'mode', alias: 'm', type: 'string', valueName: 'mode', desc: 'chat / work (default chat)' },
+  { name: 'permission', type: 'string', valueName: 'level', desc: 'none / normal / auto / full' },
+  { name: 'workspace', alias: 'C', type: 'string', valueName: 'dir', desc: 'Workspace directory' },
+  { name: 'provider', type: 'string', valueName: 'name', desc: 'Provider id or name' },
+  { name: 'model', type: 'string', valueName: 'id', desc: 'Model id' },
+  { name: 'skill', type: 'string', valueName: 'name', desc: 'Skill to enable' },
+  { name: 'resume', alias: 'r', type: 'string', valueName: 'id|index', desc: 'Continue a conversation by index or id' },
+  { name: 'continue', alias: 'c', type: 'boolean', desc: 'Continue the most recent conversation' },
+  { name: 'output', alias: 'o', type: 'string', valueName: 'text|json', desc: 'Output format, default text' },
+  { name: 'yes', alias: 'y', type: 'boolean', desc: 'Auto-approve permission requests (dangerous)' },
+  { name: 'quiet', alias: 'q', type: 'boolean', desc: 'Only print the reply text' }
+];
+
+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('Missing prompt: use -p "..." or pass the question directly'), { userError: true });
+  }
+
+  const config = settings.readConfig();
+  if (!config.providers?.length) {
+    throw Object.assign(new Error('No provider configured. Run dgxay config init first'), { 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 === 'New conversation') target.title = sessions.titleFrom(prompt);
+    sessions.saveChat(target);
+    return target;
+  } catch (err) {
+    if (process.env.DGXAY_DEBUG === '1') process.stderr.write(`[session] save failed: ${err.message}\n`);
+    return null;
+  }
+}
+
+module.exports = {
+  name: 'run',
+  aliases: [],
+  summary: 'One-shot: send a prompt and print the reply',
+  usage: 'dgxay run -p "prompt" [-C dir] [-m work] [--permission auto]',
+  options,
+  examples: [
+    'dgxay run -p "explain the structure of this repo" -C .',
+    'dgxay run -p "add install notes to the README" -m work -C ./project',
+    'dgxay run -p "write a quicksort function" -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: 'Output 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(`Skills (${settings.homeRelative(cfg.SKILLS_DIR)})`);
+    if (!list.length) {
+      print.hint('  No skills yet. Drop a name.md or <dir>/SKILL.md into the skills directory.');
+      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: 'Name', max: 24 },
+        { title: 'Description', max: 60 },
+        { title: 'File', max: 24 }
+      ],
+      rows
+    );
+    print.blank();
+    print.hint('Enable with /skill <name> in a conversation; for a single run add --skill <name>');
+    print.blank();
+    return 0;
+  }
+
+  if (action === 'show' || action === 'cat') {
+    const name = rest[0];
+    if (!name) throw Object.assign(new Error('Usage: dgxay skill show <name>'), { userError: true });
+    const skill = skills.readSkill(name);
+    if (!skill) {
+      print.fail(`Skill not found: ${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(`Unknown command: ${action}`);
+  print.hint('Available: list / show / path');
+  return 1;
+}
+
+module.exports = {
+  name: 'skill',
+  aliases: ['skills'],
+  summary: 'List and view skills',
+  usage: 'dgxay skill <list|show|path>',
+  options,
+  subcommands: [
+    ['list', 'List skills'],
+    ['show <name>', 'View skill content'],
+    ['path', 'Show the skills directory']
+  ],
+  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: 'Also persist to config (default only sets the current process)' }];
+
+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: 'Current workspace', value: workspace },
+      { label: 'Process directory', value: process.cwd() },
+      { label: 'Recent', value: (config.work?.recentWorkspaces || []).slice(0, 5).join('\n') || '(none)', multiline: true }
+    ]);
+    print.blank();
+    print.hint('Set it with dgxay workspace set <dir>; inside a conversation use /cd');
+    print.blank();
+    return 0;
+  }
+
+  if (action === 'list' || action === 'ls') {
+    const recents = config.work?.recentWorkspaces || [];
+    print.blank();
+    if (!recents.length) {
+      print.hint('No workspace has been set yet');
+      print.blank();
+      return 0;
+    }
+    print.heading('Recent workspaces');
+    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('Usage: dgxay workspace set <dir>'), { userError: true });
+    const resolved = path.resolve(target);
+    try {
+      if (!fs.statSync(resolved).isDirectory()) throw new Error('Not a directory');
+    } catch {
+      print.fail(`Directory not found: ${resolved}`);
+      return 1;
+    }
+    settings.setWorkspace(resolved);
+    print.ok(`Workspace: ${resolved}`);
+    void opts;
+    return 0;
+  }
+
+  if (action === 'clear' || action === 'unset') {
+    settings.setWorkspace('');
+    print.ok('Workspace cleared');
+    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: 'Workspace management',
+  usage: 'dgxay workspace [set|list|clear] [dir]',
+  options,
+  subcommands: [
+    ['show', 'Show current workspace'],
+    ['set <dir>', 'Set the workspace'],
+    ['list', 'Show recent workspaces'],
+    ['clear', 'Clear']
+  ],
+  examples: ['dgxay workspace set ./project', 'dgxay workspace list'],
+  run
+};