dgxay-code-cli 1.0.0 → 1.1.0

package/README-zh.md

@@ -66,17 +66,48 @@ dgxay run -p "总结这个仓库的架构" -o json | jq -r .text
 
 ## 交互模式
 
-进��� `dgxay` 后：
+进入 `dgxay` 后，界面由三部分组成：
+
+- **输入框**：一个带边框的方框，宽度随终端自适应，长文本自动折行
+- **命令菜单**：输入 `/` 时在输入框上方/下方弹出，可上下选择
+- **思考区**：模型思考时实时显示计时与思考内容
 
 | 输入 | 作用 |
 | --- | --- |
 | 直接输入文字 | 发送给模型 |
+| `/` | 弹出命令菜单 |
+| `↑` / `↓` | 菜单打开时选择命令；菜单关闭时 `↑` 回填上一条提问 |
+| `Tab` | 补全当前选中的命令 |
+| `Enter` | 菜单打开时执行选中命令；否则发送消息 |
+| `Esc` | 关闭菜单 |
 | `!命令` | 执行终端命令，输出进入对话上下文，例如 `!git status` |
-| `/` | 打开斜杠命令补全 |
 | 行尾 `\` | 续行，输入多行消息 |
 | `Ctrl+C` | 生成中中断；空闲时退出；输入框有内容时清空 |
 | `Ctrl+D` | 退出 |
-| `↑` / `↓` | 浏览历史输入 |
+
+### 语言
+
+界面默认英文。想切回中文：`DGXAY_LANG=zh dgxay`。
+AI 的回复语言跟随你的提问语言。
+
+### 思考过程
+
+模型返回思考内容时，终端会实时显示：
+
+```
+  ⠿ Thinking 2.4s 当前正在考虑的部分…
+```
+
+思考结束后折叠为一行摘要，并把完整思考内容以灰色缩进段落列出：
+
+```
+  ⌁ Thought for 12.8s · 1450 chars
+  │ 先看一下目录结构……
+  │ 然后读入口文件……
+```
+
+想只看摘要不显示详细内容：`DGXAY_SHOW_REASONING=0`。
+
 
 ### 斜杠命令
 
@@ -155,7 +186,11 @@ dgxay doctor               自检
 | `DGXAY_HOME` | 覆盖数据目录 |
 | `DGXAY_API_KEY` | `config init` 时用作 API Key |
 | `DGXAY_TOKEN_KEY` | 给 OAuth 令牌加解密口令（不设置则按明文 base64 保存） |
-| `DGXAY_SHOW_REASONING=1` | 实时显示思考过程（默认折叠为一行摘要） |
+| `DGXAY_LANG=zh` | 界面切成中文（默认英文） |
+| `DGXAY_SHOW_REASONING=0` | 只显示思考摘要，不列出思考内容 |
+| `DGXAY_REASONING_LINES=6` | 思考内容最多显示几行 |
+| `DGXAY_NO_CURSOR_UP=1` | 强制降级为单行输入框 |
+| `DGXAY_ASCII=1` | 强制用 ASCII 框线（+ - |） |
 | `DGXAY_COLOR=always\|never` | 强制开关颜色 |
 | `NO_COLOR` | 关闭颜色 |
 | `DGXAY_DEBUG=1` | 输出调试信息与堆栈 |
@@ -163,11 +198,18 @@ dgxay doctor               自检
 
 ## 终端兼容性
 
-流式输出只使用 `\r`（回到行首）和空格覆盖两种所有终端都支持的能力，**不依赖光标上移或清行序列**——
-这两类序列在部分 Windows 控制台组合下会被忽略，导致每段增量都变成新的一行。
+启动时会探测终端能力，分两种模式：
+
+**支持光标上移（Windows Terminal、VSCode、iTerm、大多数 Linux 终端）**
+输入框是真正的方框，命令菜单可以原地刷新、上下选择不残留。
+
+**不支持光标上移（老式 conhost）**
+自动降级为单行 `❯` 提示，只做行内刷新，不会出现无法擦除的叠加错位。
+
+流式正文始终只使用 `\r` 回行首 + 空格擦尾，不依赖光标上移；生成过程中只在最后一行刷新预览，
+结束时一次性按 Markdown 完整排版。所以正文每段只会出现一次。
 
-渲染分两步：生成过程中只在最后一行实时刷新预览；生成结束时一次性地按 Markdown 完整排版输出
-（标题、列表、表格、代码块对齐）。所以在任何终端里每段正文都只会出现一次，不会堆积。
+想强制降级：`DGXAY_NO_CURSOR_UP=1`；想强制 ASCII 框线：`DGXAY_ASCII=1`。
 
 ## 与桌面版的差异
 

package/README.md

@@ -66,15 +66,47 @@ dgxay run -p "summarize this repo's architecture" -o json | jq -r .text
 
 ## Interactive mode
 
+The interface has three parts:
+
+- **Input box** — a bordered box that adapts to the terminal width and wraps long input
+- **Command menu** — appears when you type `/`, navigable with the arrow keys
+- **Thinking area** — shows a live timer and the model's reasoning while it works
+
 | Input | Action |
 | --- | --- |
 | text | Send to the model |
+| `/` | Open the command menu |
+| `↑` / `↓` | Menu open: move the selection. Menu closed: `↑` recalls your previous prompt |
+| `Tab` | Complete the selected command |
+| `Enter` | Menu open: run the selected command. Otherwise: send the message |
+| `Esc` | Close the menu |
 | `!command` | Run a shell command; output joins the context, e.g. `!git status` |
-| `/` | Slash-command completion |
 | trailing `\` | Continue on the next line |
 | `Ctrl+C` | Abort while generating; clear the input when non-empty; exit when idle |
 | `Ctrl+D` | Exit |
-| `↑` / `↓` | Input history |
+
+### Language
+
+The interface is English by default. Switch to Chinese with `DGXAY_LANG=zh dgxay`.
+The AI replies in the language you write in.
+
+### Thinking
+
+While the model reasons, the terminal shows a live timer:
+
+```
+  ⠿ Thinking 2.4s latest reasoning fragment…
+```
+
+When it finishes, that folds into a one-line summary followed by the full reasoning in grey:
+
+```
+  ⌁ Thought for 12.8s · 1450 chars
+  │ First I'll look at the directory layout…
+  │ Then read the entry file…
+```
+
+Set `DGXAY_SHOW_REASONING=0` to keep only the summary.
 
 ### Slash commands
 
@@ -138,7 +170,11 @@ API keys are stored **in plain text** in `config.json`. Use `DGXAY_HOME=/tmp/tes
 | `DGXAY_HOME` | Override the data directory |
 | `DGXAY_API_KEY` | API key used by `config init` |
 | `DGXAY_TOKEN_KEY` | Passphrase that encrypts OAuth tokens (plain base64 otherwise) |
-| `DGXAY_SHOW_REASONING=1` | Stream the reasoning text (collapsed to one line by default) |
+| `DGXAY_LANG=zh` | Use the Chinese interface (English by default) |
+| `DGXAY_SHOW_REASONING=0` | Show only the thinking summary, not the reasoning text |
+| `DGXAY_REASONING_LINES=6` | How many reasoning lines to display |
+| `DGXAY_NO_CURSOR_UP=1` | Force the single-line fallback input |
+| `DGXAY_ASCII=1` | Force ASCII box drawing characters |
 | `DGXAY_COLOR=always\|never` | Force colours on/off |
 | `NO_COLOR` | Disable colours |
 | `DGXAY_DEBUG=1` | Debug output and stack traces |
@@ -146,13 +182,18 @@ API keys are stored **in plain text** in `config.json`. Use `DGXAY_HOME=/tmp/tes
 
 ## Terminal compatibility
 
-Streaming output relies only on `\r` (carriage return) and space padding — capabilities every terminal supports.
-It never uses cursor-up or erase-line sequences: some Windows console combinations silently ignore them, which
-makes every delta arrive as a new line.
+The terminal is probed at startup and the UI adapts:
+
+**Cursor-up supported** (Windows Terminal, VSCode, iTerm, most Linux terminals)
+The input is a real box and the command menu refreshes in place without leftovers.
+
+**Cursor-up unsupported** (legacy conhost)
+Falls back to a single-line `❯` prompt with in-place redraw, so nothing can stack up.
+
+Streaming text always uses only `\r` and space padding; while generating, just the last line is refreshed, and
+the whole reply is laid out once as Markdown at the end. Every paragraph appears exactly once.
 
-Rendering happens in two steps: while generating, only the current line is refreshed as a plain-text preview;
-when generation ends, the whole reply is laid out once as Markdown (headings, lists, tables, code blocks).
-Every paragraph therefore appears exactly once in any terminal.
+Force the fallback with `DGXAY_NO_CURSOR_UP=1`, or ASCII borders with `DGXAY_ASCII=1`.
 
 ## Differences from the desktop app
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dgxay-code-cli",
   "productName": "DgxayCode CLI",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "DgxayCode 命令行版：多协议 AI 编码助手，支持工作空间、四档权限、自动审查、技能与 MCP。",
   "author": "Dgxay",
   "license": "GPL-3.0-only",

package/src/cli/ansi.js

@@ -87,25 +87,51 @@ function isInteractive() {
   return Boolean(process.stdin.isTTY && process.stdout.isTTY);
 }
 
-function termWidth() {
-  const width = Number(process.stdout.columns) || 0;
+function termWidth(stream = process.stdout) {
+  const width = Number(stream.columns) || 0;
   if (width > 0) return Math.max(20, width);
   return 80;
 }
 
-function useUnicode() {
+/**
+ * 终端能否安全输出 Unicode 框线字符。
+ * Windows Terminal / VSCode / 现代 shell 都支持；只有老的 conhost 需要降级成 ASCII。
+ */
+function useUnicode(stream = process.stdout) {
   if (process.env.DGXAY_ASCII === '1') return false;
-  if (process.platform === 'win32') {
-    const cp = process.stdout.isTTY ? 65001 : 0;
-    return cp === 65001 || Number(process.stdout.columns) > 0;
-  }
-  return true;
+  if (process.platform !== 'win32') return true;
+  if (process.env.WT_SESSION || process.env.TERM_PROGRAM || process.env.ConEmuANSI) return true;
+  if (/UTF-?8/i.test(process.env.LANG || process.env.LC_ALL || '')) return true;
+  // 能拿到列数说明是真实交互终端；Windows 10+ 的 PowerShell 用 Consolas 渲染框线没有问题
+  return Boolean(stream.columns);
 }
 
 function clearLine() {
   if (process.stdout.isTTY) process.stdout.write('\r\x1b[2K');
 }
 
+/* --- 光标与屏幕控制（供输入框 / 区域重绘使用） --- */
+
+/** 上移 n 行（n <= 0 时返回空串） */
+function cursorUp(n = 1) {
+  return n > 0 ? `\x1b[${n}A` : '';
+}
+
+/** 下移 n 行 */
+function cursorDown(n = 1) {
+  return n > 0 ? `\x1b[${n}B` : '';
+}
+
+/** 清整行（光标不动） */
+function eraseLine() {
+  return '\x1b[2K';
+}
+
+/** 清屏并把光标移到左上角 */
+function clearScreen(stream = process.stdout) {
+  stream.write('\x1b[2J\x1b[H');
+}
+
 function hideCursor() {
   if (process.stdout.isTTY) process.stdout.write('\x1b[?25l');
 }
@@ -493,6 +519,10 @@ module.exports = {
   termWidth,
   useUnicode,
   clearLine,
+  eraseLine,
+  clearScreen,
+  cursorUp,
+  cursorDown,
   hideCursor,
   showCursor,
   stripAnsi,

package/src/cli/approval.js

@@ -126,14 +126,14 @@ async function askApproval(request, options = {}) {
   if (!interactive) {
     // 非交互：一律拒绝，并提示如何绕过
     process.stderr.write(
-      `${COLORS.yellow('[需授权]')} ${request.title}：${request.operation}\n` +
-        `${COLORS.dim('  当前不是交互终端，已自动拒绝。请改用完全权限（--permission full）或交互式运行。')}\n`
+      `${COLORS.yellow('[permission]')} ${request.title}：${request.operation}\n` +
+        `${COLORS.dim('  Not an interactive terminal — denied. Use --permission full or run interactively.')}\n`
     );
     return false;
   }
 
   const lines = [];
-  lines.push({ text: `${COLORS.faint('操作')}  ${COLORS.bold(request.operation)}`, raw: `操作  ${request.operation}` });
+  lines.push({ text: `${COLORS.faint('op')}  ${COLORS.bold(request.operation)}`, raw: `op  ${request.operation}` });
   for (const line of String(request.detail || '').split('\n')) {
     if (!line.trim()) continue;
     const idx = line.indexOf('：');
@@ -152,12 +152,12 @@ async function askApproval(request, options = {}) {
   }
   if (request.workspace) {
     lines.push({ text: '', raw: '' });
-    lines.push({ text: COLORS.faint(`工作空间 ${request.workspace}`), raw: `工作空间 ${request.workspace}` });
+    lines.push({ text: COLORS.faint(`workspace ${request.workspace}`), raw: `workspace ${request.workspace}` });
   }
   if (request.review) {
     lines.push({ text: '', raw: '' });
-    const who = request.reviewer ? `审查模型 ${request.reviewer}` : '自动审查';
-    lines.push({ text: COLORS.red(`${who} 判定可疑`), raw: `${who} 判定可疑` });
+    const who = request.reviewer ? `reviewer ${request.reviewer}` : 'auto-review';
+    lines.push({ text: COLORS.red(`${who} flagged this`), raw: `${who} flagged this` });
     for (const piece of wrapText(request.review, 58)) {
       lines.push({ text: COLORS.dim(`  ${piece}`), raw: `  ${piece}` });
     }
@@ -165,20 +165,20 @@ async function askApproval(request, options = {}) {
 
   process.stdout.write(`${frameText(lines, { title: request.title })}\n`);
 
-  const promptText = `${COLORS.accent('允许执行吗？')} ${COLORS.faint('[y] 允许  [n] 拒绝')} `;
+  const promptText = `${COLORS.accent('Allow this?')} ${COLORS.faint('[y] yes  [n] no')} `;
   process.stdout.write(promptText);
   const result = await readKey({ timeout: options.timeout || APPROVAL_TIMEOUT });
 
   if (result.key === 'y') {
-    process.stdout.write(`${COLORS.green('允许')}\n`);
+    process.stdout.write(`${COLORS.green('allowed')}\n`);
     return true;
   }
   const label =
     result.key === 'timeout'
-      ? COLORS.yellow('等待超时，已拒绝')
+      ? COLORS.yellow('timed out — denied')
       : result.key === 'escape'
-        ? COLORS.dim('已拒绝')
-        : COLORS.red('已拒绝');
+        ? COLORS.dim('denied')
+        : COLORS.red('denied');
   process.stdout.write(`${label}\n`);
   return false;
 }