chatccc 0.2.224 → 0.2.225

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.224",
+  "version": "0.2.225",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",

package/src/__tests__/builtin-chat-session.test.ts

@@ -339,7 +339,7 @@ describe("ChatSession effort passthrough", () => {
     streamTextMock.mockReturnValueOnce({ textStream: textStream("done") });
 
     const session = new ChatSession(
-      { apiKey: "sk-test" },
+      { apiKey: "sk-test", effort: "" },
       { cwd: dir, sessionId: "effort-none" },
     );
     await collect(session.chat("hi"));

package/src/__tests__/terminal-renderer.test.ts

@@ -2,6 +2,8 @@ import { afterEach, describe, expect, it, vi } from "vitest";
 
 import {
   buildBlockLines,
+  charWidth,
+  clipToWidth,
   TerminalProgressRenderer,
 } from "../progress/terminal-renderer.ts";
 import { progressView } from "../progress/view.ts";
@@ -41,6 +43,7 @@ describe("buildBlockLines", () => {
   it("renders done / stopped / error status lines", () => {
     const done = buildBlockLines(progressView({ status: "done", text: "ok" }), 100);
     expect(done[0]).toContain("✅ 完成");
+    expect(done[0]).toContain("\x1b[1m"); // 完成状态行加粗，不用浅色
     const stopped = buildBlockLines(progressView({ status: "stopped", text: "x" }), 100);
     expect(stopped[0]).toContain("⏹ 已停止");
     const error = buildBlockLines(progressView({ status: "error", text: "x" }), 100);
@@ -66,6 +69,10 @@ describe("buildBlockLines", () => {
     expect(lines[2]).toContain("npm test passed");
     expect(lines[3]).toContain("✗");
     expect(lines[3]).toContain("regex error");
+    // 工具行摘要不用浅色字体（回复内容可读性优先）
+    for (const line of [lines[1], lines[2], lines[3]]) {
+      expect(line).not.toContain("\x1b[2m");
+    }
   });
 
   it("truncates long body to maxBodyLines", () => {
@@ -84,6 +91,46 @@ describe("buildBlockLines", () => {
       expect(line.length).toBeLessThanOrEqual(30);
     }
   });
+
+  it("charWidth counts CJK/emoji as 2 columns and control/ZWJ as 0", () => {
+    expect(charWidth("a")).toBe(1);
+    expect(charWidth("中")).toBe(2);
+    expect(charWidth("📂")).toBe(2);
+    expect(charWidth("\u200d")).toBe(0); // ZWJ
+  });
+
+  it("clipToWidth truncates by display width, not string length", () => {
+    expect(clipToWidth("中文abc", 4)).toBe("中文");
+    expect(clipToWidth("中文abc", 5)).toBe("中文a");
+    expect(clipToWidth("📂 x", 2)).toBe("📂");
+    expect(clipToWidth("📂 x", 3)).toBe("📂 ");
+  });
+
+  it("clipToWidth keeps ANSI tokens whole and closes colors at the cut", () => {
+    const ansi = "\x1b[32m📂\x1b[0m abc";
+    expect(clipToWidth(ansi, 6)).toBe("\x1b[32m📂\x1b[0m abc");
+    expect(clipToWidth(ansi, 5)).toBe("\x1b[32m📂\x1b[0m ab");
+    // 截断发生在未闭合颜色内时自动补 reset，避免颜色泄漏
+    expect(clipToWidth("\x1b[1m\x1b[32m✅ 完成\x1b[0m", 6)).toBe("\x1b[1m\x1b[32m✅ 完\x1b[0m");
+  });
+
+  it("emoji tool lines are clipped by display width so the block never wraps", () => {
+    // 模拟用户示例：emoji + 超长 JSON 工具行，宽 40 的终端必须整行不折行
+    const lines = buildBlockLines(
+      progressView({
+        text: "",
+        tools: [
+          { id: "t1", name: "list_dir", status: "ok", summary: `{"path":"C:\\Users\\weizhangjian\\.chatccc","entries":[{"name":"builtin","path":"C:\\Users${'x'.repeat(300)}"}]}` },
+        ],
+      }),
+      40,
+    );
+    const toolLine = lines.find((l) => l.includes("list_dir"))!;
+    // 显示宽度（剥离 ANSI 后按 charWidth 计算）不超过终端列宽，永不折行
+    const visible = [...toolLine.replace(/\x1b\[[0-9;]*m/g, "")].reduce((w, ch) => w + charWidth(ch), 0);
+    expect(visible).toBeLessThanOrEqual(40);
+    expect(toolLine).toContain("\x1b[0m"); // ANSI 完整闭合
+  });
 });
 
 describe("TerminalProgressRenderer", () => {
@@ -93,6 +140,7 @@ describe("TerminalProgressRenderer", () => {
     r.begin(progressView({ text: "hello" }));
     expect(out.output.startsWith("\x1b[?25l")).toBe(true);
     expect(out.output).toContain("hello");
+    r.dispose();
   });
 
   it("end finalizes the block and restores cursor, keeping block on screen", () => {
@@ -140,4 +188,60 @@ describe("TerminalProgressRenderer", () => {
     expect(out.output).toContain("\x1b[2K\n");
     expect(out.output).toContain("\x1b[J");
   });
+
+  it("heartbeat animates generating dots so the block never freezes", () => {
+    vi.useFakeTimers();
+    const out = new FakeOut();
+    const r = new TerminalProgressRenderer({ out: asOut(out), animMs: 100 });
+    r.begin(progressView({ headerTitle: "生成中...", text: "" }));
+    const frame0 = out.output;
+    expect(frame0).toContain("·"); // 首帧即带动画点
+    vi.advanceTimersByTime(100);
+    const frame1 = out.output;
+    expect(frame1).not.toBe(frame0); // 无新事件也持续重绘
+    expect(frame1).toContain("··"); // 第二帧点号增长
+    r.dispose();
+  });
+
+  it("stops the heartbeat after end so the final block stays static", () => {
+    vi.useFakeTimers();
+    const out = new FakeOut();
+    const r = new TerminalProgressRenderer({ out: asOut(out), animMs: 100 });
+    r.begin(progressView({ text: "" }));
+    r.end(progressView({ status: "done", text: "final" }));
+    const afterEnd = out.output.length;
+    vi.advanceTimersByTime(500);
+    expect(out.output.length).toBe(afterEnd);
+  });
+
+  it("redraw moves up exactly blockLines-1 rows, never eating history above", () => {
+    // 回归测试：光标在区块最后一行时，回到第一行只需上移 N-1 行。
+    // 上移 N 行会每帧多上移 1 行，把上方历史内容逐行吃掉。
+    const out = new FakeOut();
+    const r = new TerminalProgressRenderer({ out: asOut(out), animMs: 0 });
+    // 状态行 1 行 + 正文 4 行 = 5 行区块
+    r.begin(progressView({ text: "a\nb\nc\nd" }));
+    const afterBegin = out.output;
+    r.flush(); // 第二帧强制重绘
+    const delta = out.output.slice(afterBegin.length);
+    expect(delta).toContain("\x1b[4A"); // 上移 5-1=4 行
+    expect(delta).not.toContain("\x1b[5A"); // 绝不出现上移 N 行
+    r.dispose();
+  });
+
+  it("multi-frame redraws keep moving up N-1 rows each time (no drift)", () => {
+    const out = new FakeOut();
+    const r = new TerminalProgressRenderer({ out: asOut(out), animMs: 0 });
+    r.begin(progressView({ text: "a\nb\nc\nd" }));
+    for (let i = 0; i < 3; i++) {
+      r.flush();
+    }
+    // 连续多帧重绘，每帧上移都是 4 行（5 行区块），不是 5/6/7... 逐帧递增
+    const moves = out.output.match(/\x1b\[(\d+)A/g) ?? [];
+    expect(moves.length).toBe(3);
+    for (const move of moves) {
+      expect(move).toBe("\x1b[4A");
+    }
+    r.dispose();
+  });
 });

package/src/__tests__/web-ui.test.ts

@@ -95,6 +95,7 @@ describe("unflattenConfig", () => {
         CHATCCC_CCC_BASE_URL: "https://api.deepseek.com/v1",
         CHATCCC_CCC_MODEL: "deepseek-v4-flash",
         CHATCCC_CCC_ALTERNATIVE_MODEL: "deepseek-v4-pro",
+        CHATCCC_CCC_EFFORT: "max",
       }),
     ).toEqual({
       ccc: {
@@ -104,6 +105,7 @@ describe("unflattenConfig", () => {
         DEEPSEEK_BASE_URL: "https://api.deepseek.com/v1",
         model: "deepseek-v4-flash",
         alternativeModel: "deepseek-v4-pro",
+        effort: "max",
       },
     });
   });
@@ -251,6 +253,7 @@ describe("dashboard edit modal", () => {
     expect(PAGE_HTML).toContain('id="agent-default-ccc"');
     expect(PAGE_HTML).toContain('id="field-CHATCCC_CCC_MODEL"');
     expect(PAGE_HTML).toContain('id="field-CHATCCC_CCC_ALTERNATIVE_MODEL"');
+    expect(PAGE_HTML).toContain('id="field-CHATCCC_CCC_EFFORT"');
     expect(PAGE_HTML).toContain('id="dash-ccc"');
     expect(PAGE_HTML).toContain("editSection('ccc')");
   });

package/src/builtin/cli.ts

@@ -13,6 +13,7 @@
 
 import * as readline from "node:readline";
 import * as process from "node:process";
+import { appendFileSync } from "node:fs";
 import { resolve as resolvePath } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -32,11 +33,14 @@ interface ParsedArgs {
   help: boolean;
   streamJson: boolean;
   prompt: string | null;
+  /** 强制纯文本流式输出（不用过程区块渲染器），渲染异常时的兜底通道 */
+  plain: boolean;
 }
 
 interface RuntimeDeps {
   ChatSession: typeof import("./index.js").ChatSession;
   appConfig: typeof import("../config.ts").config;
+  fileLog: typeof import("../config.ts").fileLog;
 }
 
 interface JsonLine {
@@ -60,6 +64,7 @@ function parseArgs(argv = process.argv.slice(2)): ParsedArgs {
   let help = false;
   let streamJson = false;
   let prompt: string | null = null;
+  let plain = false;
 
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
@@ -96,20 +101,22 @@ function parseArgs(argv = process.argv.slice(2)): ParsedArgs {
     } else if (arg === "--prompt" && next !== undefined) {
       prompt = next;
       i++;
+    } else if (arg === "--plain") {
+      plain = true;
     } else if (arg === "--help" || arg === "-h") {
       help = true;
     }
   }
 
-  return { config, options, listSessions, resume, help, streamJson, prompt };
+  return { config, options, listSessions, resume, help, streamJson, prompt, plain };
 }
 
 async function loadRuntime(): Promise<RuntimeDeps> {
-  const [{ ChatSession }, { config: appConfig }] = await Promise.all([
+  const [{ ChatSession }, { config: appConfig, fileLog }] = await Promise.all([
     import("./index.js"),
     import("../config.ts"),
   ]);
-  return { ChatSession, appConfig };
+  return { ChatSession, appConfig, fileLog };
 }
 
 function printHelp(appConfig: RuntimeDeps["appConfig"]): void {
@@ -129,6 +136,7 @@ function printHelp(appConfig: RuntimeDeps["appConfig"]): void {
     "  --list-sessions      List saved ccc sessions and exit",
     "  --stream-json        One-shot mode: write JSONL events to stdout",
     "  --prompt <text>      Prompt text for --stream-json",
+    "  --plain              Force plain streaming output (no progress block renderer)",
     "  --help, -h           Show help",
     "",
     "Default config source:",
@@ -311,8 +319,32 @@ const C = {
   yellow: "\x1b[33m",
 };
 
+/**
+ * 交互模式下渲染器独占终端 stdout：普通日志只写日志文件、不回显到终端，
+ * 避免生成过程中任何 console 输出混入过程区块、破坏行数计数（导致重绘
+ * 上移不足、把上方历史内容"吃掉"）。错误提示（console.error）保留回显。
+ */
+function muteConsoleLogToFile(logPath: string): void {
+  const writeFile = (level: string, args: unknown[]): void => {
+    try {
+      const text = args
+        .map((a) =>
+          typeof a === "string" ? a
+            : a instanceof Error ? (a.stack ?? a.message)
+            : JSON.stringify(a))
+        .join(" ");
+      appendFileSync(logPath, `[${new Date().toISOString()}] [${level}] ${text}\n`, "utf8");
+    } catch {
+      // 日志系统自身失败不影响主流程
+    }
+  };
+  console.log = (...args: unknown[]) => writeFile("LOG", args);
+  console.info = (...args: unknown[]) => writeFile("INFO", args);
+  console.warn = (...args: unknown[]) => writeFile("WARN", args);
+}
+
 async function runRepl(args: ParsedArgs): Promise<void> {
-  const { ChatSession, appConfig } = await loadRuntime();
+  const { ChatSession, appConfig, fileLog } = await loadRuntime();
 
   const cwd = resolvePath(args.options.cwd ?? process.cwd());
   let resolvedSession;
@@ -330,6 +362,12 @@ async function runRepl(args: ParsedArgs): Promise<void> {
   console.log(`${C.dim}Type a message to chat. Double Ctrl+C interrupts generation or exits. Type exit to quit.${C.reset}`);
   console.log("");
 
+  // 交互渲染模式下 console 输出只写日志文件、不回显到终端（渲染器独占 stdout，
+  // 避免生成中日志混入区块破坏行数）。--plain 无渲染器，不需要静音。
+  if (process.stdout.isTTY === true && !args.plain) {
+    muteConsoleLogToFile(fileLog.logPath);
+  }
+
   let session: InstanceType<typeof ChatSession>;
   try {
     session = new ChatSession(args.config, {
@@ -363,20 +401,20 @@ async function runRepl(args: ParsedArgs): Promise<void> {
     }
 
     if (input === "exit") {
-      console.log(`${C.dim}bye${C.reset}`);
+      process.stdout.write(`${C.dim}bye${C.reset}\n`);
       rl.close();
       return;
     }
 
     if (input === "/clear") {
       session.reset();
-      console.log(`${C.dim}session cleared${C.reset}`);
+      process.stdout.write(`${C.dim}session cleared${C.reset}\n`);
       rl.prompt();
       return;
     }
 
     if (input === "/history") {
-      console.log(`${C.dim}${session.turnCount} conversation turns${C.reset}`);
+      process.stdout.write(`${C.dim}${session.turnCount} conversation turns${C.reset}\n`);
       rl.prompt();
       return;
     }
@@ -385,12 +423,16 @@ async function runRepl(args: ParsedArgs): Promise<void> {
     const signal = currentAbort.signal;
 
     // TTY 下用"过程区块"（飞书过程卡片的终端形态）：固定区域原地更新、
-    // 工具调用折叠为单行；非 TTY（管道/CI）回退为纯文本流式输出。
-    const useTerminalBlock = process.stdout.isTTY === true;
+    // 工具调用折叠为单行；非 TTY（管道/CI）或 --plain 回退为纯文本流式输出。
+    const useTerminalBlock = process.stdout.isTTY === true && !args.plain;
     const renderer = useTerminalBlock ? new TerminalProgressRenderer() : null;
     let view: ProgressView | null = null;
     if (renderer) {
       view = progressView({ headerTitle: "生成中..." });
+      // 先回行首换行再 begin：让过程区块从输入行下方开始，避免首帧 \r\x1b[2K
+      // 清掉用户刚输入的问题行（历史文本不被刷掉）。\r\n 兼容 readline
+      // 行提交后光标仍停在输入行行尾的情况。
+      process.stdout.write("\r\n");
       renderer.begin(view);
     }
     let rendererEnded = false;
@@ -429,14 +471,14 @@ async function runRepl(args: ParsedArgs): Promise<void> {
         view = progressView({ ...view, status: aborted ? "stopped" : "error", showStop: false });
         renderer.end(view);
         rendererEnded = true;
-        console.log("");
+        process.stdout.write("\n");
       }
-      console.log(`\n${C.yellow}[error] ${(err as Error).message}${C.reset}`);
+      console.error(`\n${C.yellow}[error] ${(err as Error).message}${C.reset}`);
     } finally {
       if (renderer && view && !rendererEnded) {
         // 定型终态区块（完成/已停止/异常结束）留在屏幕上，恢复光标
         renderer.end(view);
-        console.log("");
+        process.stdout.write("\n");
       }
       currentAbort = null;
       ctrlCState.reset();
@@ -449,31 +491,31 @@ async function runRepl(args: ParsedArgs): Promise<void> {
     const action = ctrlCState.press(currentAbort !== null);
 
     if (action === "exit") {
-      console.log(`\n${C.dim}bye${C.reset}`);
+      console.error(`\n${C.dim}bye${C.reset}`);
       rl.close();
       return;
     }
 
     if (action === "interrupt") {
-      console.log(`\n${C.yellow}[interrupting...]${C.reset}`);
+      console.error(`\n${C.yellow}[interrupting...]${C.reset}`);
       currentAbort?.abort();
       currentAbort = null;
       return;
     }
 
     if (action === "arm-interrupt") {
-      console.log(`\n${C.dim}Press Ctrl+C again to interrupt current response${C.reset}`);
+      console.error(`\n${C.dim}Press Ctrl+C again to interrupt current response${C.reset}`);
       return;
     }
 
     if (action === "arm-exit") {
-      console.log(`\n${C.dim}Press Ctrl+C again to exit, or type exit${C.reset}`);
+      console.error(`\n${C.dim}Press Ctrl+C again to exit, or type exit${C.reset}`);
       rl.prompt();
     }
   });
 
   rl.on("close", () => {
-    console.log("");
+    process.stdout.write("\n");
     process.exit(0);
   });
 }

package/src/progress/terminal-renderer.ts

@@ -9,6 +9,9 @@
  * 实现要点：
  *   - 隐藏光标（\x1b[?25l）→ 每帧整块重绘（\x1b[{n}A 上移 + \x1b[2K 清行 + \x1b[J 清下方）
  *   - 帧节流合并重绘，避免高频文本增量导致闪烁
+ *   - 每行按显示宽度截断（CJK/emoji 算 2 列），保证永不折行：一旦折行，
+ *     实际占用的屏幕行数会超过 blockLines 计数，下次重绘上移行数不足，
+ *     会清掉区块上方的历史内容（用户输入的问题被"吃掉"）。
  *   - end() 时把终态区块定型留在屏幕上（与飞书完成卡片留在消息流语义一致），恢复光标
  */
 
@@ -17,6 +20,7 @@ import { progressView, type ProgressToolCall, type ProgressView } from "./view.t
 
 const RESET = "\x1b[0m";
 const DIM = "\x1b[2m";
+const BOLD = "\x1b[1m";
 const GREEN = "\x1b[32m";
 const YELLOW = "\x1b[33m";
 const RED = "\x1b[31m";
@@ -24,11 +28,72 @@ const RED = "\x1b[31m";
 const HIDE_CURSOR = "\x1b[?25l";
 const SHOW_CURSOR = "\x1b[?25h";
 
+/** 生成中标题后的心跳点号动画帧（1 → 2 → 3 → 2 循环，避免跳变感） */
+const ANIM_FRAMES = ["·", "··", "···", "··"];
+
+const ANSI_TOKEN = /\x1b\[[0-9;]*m/;
+
+/** 单个字符在终端里的显示列宽：CJK/emoji 占 2 列，控制符/ZWJ/变体选择符占 0 列 */
+export function charWidth(ch: string): number {
+  const code = ch.codePointAt(0)!;
+  if (code < 32 || (code >= 0x7f && code <= 0xa0)) return 0; // 控制字符
+  if (code === 0x200d || code === 0xfe0e || code === 0xfe0f) return 0; // ZWJ / VS15 / VS16
+  if (
+    (code >= 0x1100 && code <= 0x115f) || // 谚文 Jamo
+    (code >= 0x2e80 && code <= 0x303f) || // CJK 部首 / 标点
+    (code >= 0x3040 && code <= 0xa4cf) || // 假名 / 汉字 / 谚文 / 彝文
+    (code >= 0xac00 && code <= 0xd7a3) || // 谚文音节
+    (code >= 0xf900 && code <= 0xfaff) || // CJK 兼容汉字
+    (code >= 0xfe30 && code <= 0xfe6f) || // CJK 兼容形式
+    (code >= 0xff00 && code <= 0xff60) || // 全角形式
+    (code >= 0xffe0 && code <= 0xffe6) || // 全角符号
+    (code >= 0x2600 && code <= 0x27bf) || // 杂项符号 + Dingbats（emoji 呈现 2 列）
+    (code >= 0x1f000 && code <= 0x1faff)  // emoji 补充区
+  ) {
+    return 2;
+  }
+  return 1;
+}
+
+/**
+ * 按终端显示宽度截断一行（CJK/emoji 计 2 列），ANSI 序列零宽且永不截断。
+ * 截断位置若处于未闭合的颜色状态，自动补 \x1b[0m，避免颜色泄漏到后续输出。
+ */
+export function clipToWidth(s: string, maxCols: number): string {
+  if (maxCols <= 0) return "";
+  let out = "";
+  let visible = 0;
+  let colorOpen = false;
+  let i = 0;
+  while (i < s.length) {
+    if (s.charCodeAt(i) === 0x1b) {
+      const m = ANSI_TOKEN.exec(s.slice(i));
+      if (m && m.index === 0) {
+        out += m[0];
+        colorOpen = m[0] !== "\x1b[0m";
+        i += m[0].length;
+        continue;
+      }
+    }
+    const cp = s.codePointAt(i)!;
+    const ch = String.fromCodePoint(cp);
+    const w = charWidth(ch);
+    if (visible + w > maxCols) break;
+    out += ch;
+    visible += w;
+    i += ch.length;
+  }
+  if (colorOpen) out += "\x1b[0m";
+  return out;
+}
+
 export interface TerminalRendererOptions {
   /** 输出流，默认 process.stdout */
   out?: NodeJS.WritableStream & { columns?: number };
   /** 帧节流毫秒数，默认 66（约 15fps） */
   frameMs?: number;
+  /** 生成中心跳动画毫秒数，默认 300；<=0 禁用动画 */
+  animMs?: number;
   /** 正文最大行数（超出截断，保留首行+末段） */
   maxBodyLines?: number;
   /** 正文最大字符数 */
@@ -38,7 +103,7 @@ export interface TerminalRendererOptions {
 function buildStatusLine(view: ProgressView): string {
   switch (view.status) {
     case "done":
-      return `${GREEN}✅ 完成${RESET}`;
+      return `${BOLD}${GREEN}✅ 完成${RESET}`;
     case "stopped":
       return `${YELLOW}⏹ 已停止${RESET}`;
     case "error":
@@ -54,12 +119,13 @@ function buildToolLine(tool: ProgressToolCall): string {
   const emoji = getToolEmoji(tool.name);
   const mark =
     tool.status === "running"
-      ? `${DIM}…${RESET}`
+      ? "…"
       : tool.status === "ok"
         ? `${GREEN}✓${RESET}`
         : `${RED}✗${RESET}`;
   const info = tool.status === "running" ? (tool.detail ?? "") : (tool.summary ?? "");
-  return `  ${emoji} ${tool.name} ${mark} ${DIM}${info}${RESET}`;
+  // 摘要/详情用正常色：最终区块里不出现浅色文字（可读性优先）
+  return `  ${emoji} ${tool.name} ${mark} ${info}`;
 }
 
 /**
@@ -72,7 +138,7 @@ export function buildBlockLines(
   maxBodyLines = 30,
   maxBodyChars = 12000,
 ): string[] {
-  const clip = (s: string) => (s.length > width ? s.slice(0, Math.max(0, width - 1)) : s);
+  const clip = (s: string) => clipToWidth(s, width);
   const lines: string[] = [];
   lines.push(clip(buildStatusLine(view)));
   for (const tool of view.tools) {
@@ -92,6 +158,7 @@ export function buildBlockLines(
 export class TerminalProgressRenderer {
   private readonly out: NodeJS.WritableStream & { columns?: number };
   private readonly frameMs: number;
+  private readonly animMs: number;
   private readonly maxBodyLines: number;
   private readonly maxBodyChars: number;
   private view: ProgressView;
@@ -99,20 +166,24 @@ export class TerminalProgressRenderer {
   private dirty = false;
   private timer: NodeJS.Timeout | null = null;
   private ended = false;
+  private animFrame = 0;
+  private animTimer: NodeJS.Timeout | null = null;
 
   constructor(opts: TerminalRendererOptions = {}) {
     this.out = opts.out ?? process.stdout;
     this.frameMs = opts.frameMs ?? 66;
+    this.animMs = opts.animMs ?? 300;
     this.maxBodyLines = opts.maxBodyLines ?? 30;
     this.maxBodyChars = opts.maxBodyChars ?? 12000;
     this.view = progressView();
   }
 
-  /** 开始一轮区块：隐藏光标并渲染首帧 */
+  /** 开始一轮区块：隐藏光标并渲染首帧，随后启动生成中心跳动画 */
   begin(view: ProgressView): void {
     this.view = view;
     this.out.write(HIDE_CURSOR);
     this.renderNow(view);
+    this.startAnimation();
   }
 
   /** 标记视图已更新，按帧节流合并重绘（高频增量不闪烁） */
@@ -141,12 +212,13 @@ export class TerminalProgressRenderer {
     this.renderNow(this.view);
   }
 
-  /** 结束一轮：定型终态区块（留在屏幕上），恢复光标 */
+  /** 结束一轮：定型终态区块（留在屏幕上），恢复光标，停止动画 */
   end(view: ProgressView): void {
     if (this.timer) {
       clearTimeout(this.timer);
       this.timer = null;
     }
+    this.stopAnimation();
     this.ended = true;
     this.renderNow(view);
     this.out.write(SHOW_CURSOR);
@@ -158,18 +230,42 @@ export class TerminalProgressRenderer {
       clearTimeout(this.timer);
       this.timer = null;
     }
+    this.stopAnimation();
     if (!this.ended) {
       this.out.write(SHOW_CURSOR);
     }
   }
 
+  private startAnimation(): void {
+    if (this.animMs <= 0 || this.animTimer) return;
+    this.animTimer = setInterval(() => {
+      this.animFrame++;
+      // 终态（done/stopped/error）由 end() 停止；此处兜底跳过，避免结束后还在重绘
+      if (this.ended || this.view.status !== "generating") return;
+      // 无新事件也持续重绘，点号动画让静止期（思考/工具运行中）也有动态感
+      this.renderNow(this.view);
+    }, this.animMs);
+    this.animTimer.unref?.();
+  }
+
+  private stopAnimation(): void {
+    if (this.animTimer) {
+      clearInterval(this.animTimer);
+      this.animTimer = null;
+    }
+  }
+
   private renderNow(view: ProgressView): void {
     const width = this.out.columns && this.out.columns > 0 ? this.out.columns : 80;
-    const lines = buildBlockLines(view, width, this.maxBodyLines, this.maxBodyChars);
+    const lines = buildBlockLines(this.applyAnimation(view), width, this.maxBodyLines, this.maxBodyChars);
     const newLines = lines.length;
 
     if (this.blockLines > 0) {
-      this.out.write(`\x1b[${this.blockLines}A`);
+      // 关键：光标此刻停在区块【最后一行】行尾，回到区块第一行只需上移
+      // blockLines - 1 行。上移 blockLines 行会每帧多上移 1 行，把区块上方
+      // 的历史内容逐行"吃掉"（用户看到的"一行一行往上吃"）。
+      this.out.write(`\x1b[${this.blockLines - 1}A`);
+      this.out.write("\r");
     }
     for (let i = 0; i < lines.length; i++) {
       this.out.write(`\r\x1b[2K${lines[i]}`);
@@ -187,4 +283,12 @@ export class TerminalProgressRenderer {
     this.out.write("\x1b[J");
     this.blockLines = newLines;
   }
+
+  /** 生成中阶段在标题后叠加心跳点号动画；终态原样返回（buildBlockLines 保持纯函数可测） */
+  private applyAnimation(view: ProgressView): ProgressView {
+    if (view.status !== "generating") return view;
+    const base = view.headerTitle.replace(/\.\.\.\s*$/, "").trim();
+    const dots = ANIM_FRAMES[this.animFrame % ANIM_FRAMES.length];
+    return { ...view, headerTitle: `${base} ${dots}` };
+  }
 }

package/src/web-ui.ts

@@ -1004,6 +1004,19 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
               <label>备选模型（选填）</label>
               <input type="text" id="field-CHATCCC_CCC_ALTERNATIVE_MODEL" placeholder="加入 /model 列表，便于会话内切换">
             </div>
+            <div class="form-group">
+              <label>Effort（推理强度，选填）</label>
+              <select id="field-CHATCCC_CCC_EFFORT">
+                <option value="">(留空/默认，服务端 medium)</option>
+                <option value="none">none - 直接作答，最省 token</option>
+                <option value="minimal">minimal</option>
+                <option value="low">low</option>
+                <option value="medium">medium</option>
+                <option value="high">high</option>
+                <option value="xhigh">xhigh</option>
+                <option value="max">max - 最强推理</option>
+              </select>
+            </div>
           </fieldset>
         </div>
 
@@ -1196,7 +1209,7 @@ const AGENT_FIELDS = {
   claude: ['CHATCCC_ANTHROPIC_MODEL','CHATCCC_ANTHROPIC_SUBAGENT_MODEL','CHATCCC_ANTHROPIC_EFFORT','CHATCCC_ANTHROPIC_API_KEY','CHATCCC_ANTHROPIC_BASE_URL','CHATCCC_ANTHROPIC_MAX_TURN'],
   cursor: ['CHATCCC_CURSOR_PATH','CHATCCC_CURSOR_MODEL','CHATCCC_CURSOR_ALTERNATIVE_MODEL','CHATCCC_CURSOR_AVATAR_BATTERY_MODE','CHATCCC_CURSOR_ON_DEMAND_MONTHLY_BUDGET'],
   codex: ['CHATCCC_CODEX_PATH','CHATCCC_CODEX_MODEL','CHATCCC_CODEX_ALTERNATIVE_MODEL','CHATCCC_CODEX_EFFORT','CHATCCC_CODEX_FAST_MODE'],
-  ccc: ['CHATCCC_CCC_API_KEY','CHATCCC_CCC_BASE_URL','CHATCCC_CCC_MODEL','CHATCCC_CCC_ALTERNATIVE_MODEL']
+  ccc: ['CHATCCC_CCC_API_KEY','CHATCCC_CCC_BASE_URL','CHATCCC_CCC_MODEL','CHATCCC_CCC_ALTERNATIVE_MODEL','CHATCCC_CCC_EFFORT']
 };
 const FEISHU_FIELDS = ['CHATCCC_APP_ID','CHATCCC_APP_SECRET'];
 const WEB_UI_FIELDS = ['CHATCCC_WEB_UI_OPEN_ON_START'];
@@ -1531,6 +1544,7 @@ function renderStep2() {
     prefillNested('field-CHATCCC_CCC_BASE_URL', c.ccc.DEEPSEEK_BASE_URL);
     prefillNested('field-CHATCCC_CCC_MODEL', c.ccc.model);
     prefillNested('field-CHATCCC_CCC_ALTERNATIVE_MODEL', c.ccc.alternativeModel);
+    prefillNested('field-CHATCCC_CCC_EFFORT', c.ccc.effort);
   }
 
   // 按已有 config 决定每个 Agent 默认是否开启：优先 enabled 字段，缺省时按"任一字段非空"
@@ -1706,6 +1720,7 @@ function renderStep3() {
       lines.push('<div class="config-row"><span class="key">Base URL</span><span class="val">' + (vars.CHATCCC_CCC_BASE_URL || '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">模型</span><span class="val">' + (vars.CHATCCC_CCC_MODEL || '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">备选模型</span><span class="val">' + (vars.CHATCCC_CCC_ALTERNATIVE_MODEL || '(留空)') + '</span></div>');
+      lines.push('<div class="config-row"><span class="key">Effort</span><span class="val">' + (vars.CHATCCC_CCC_EFFORT || '(留空)') + '</span></div>');
     }
   });
   document.getElementById('review-content').innerHTML = lines.join('');
@@ -1999,7 +2014,7 @@ function editSection(section) {
     'CHATCCC_CODEX_PATH': 'CLI 路径', 'CHATCCC_CODEX_MODEL': '模型', 'CHATCCC_CODEX_ALTERNATIVE_MODEL': '备选模型', 'CHATCCC_CODEX_EFFORT': 'Effort',
     'CHATCCC_CODEX_FAST_MODE': 'Fast 模式',
     'CHATCCC_CCC_API_KEY': 'API Key', 'CHATCCC_CCC_BASE_URL': 'Base URL',
-    'CHATCCC_CCC_MODEL': '模型', 'CHATCCC_CCC_ALTERNATIVE_MODEL': '备选模型'
+    'CHATCCC_CCC_MODEL': '模型', 'CHATCCC_CCC_ALTERNATIVE_MODEL': '备选模型', 'CHATCCC_CCC_EFFORT': 'Effort'
   };
   var hintMap = {
     'CHATCCC_WEB_UI_OPEN_ON_START': '关闭后可继续手动访问 http://localhost:<端口>/；/restart、/update 和 Web UI 重启无论此项为何值都不会自动打开。',
@@ -2049,6 +2064,7 @@ function editSection(section) {
         else if (key === 'CHATCCC_CCC_BASE_URL') val = state.config.ccc.DEEPSEEK_BASE_URL || '';
         else if (key === 'CHATCCC_CCC_MODEL') val = state.config.ccc.model || '';
         else if (key === 'CHATCCC_CCC_ALTERNATIVE_MODEL') val = state.config.ccc.alternativeModel || '';
+        else if (key === 'CHATCCC_CCC_EFFORT') val = state.config.ccc.effort || '';
       }
     }
     var isSecret = key.includes('SECRET') || key.includes('API_KEY');