ai-cli-log 1.0.4 → 1.0.5

package/.ai-cli-log/session-20250705-150655.txt

@@ -0,0 +1,174 @@
+
+ ███            █████████  ██████████ ██████   ██████ █████ ██████   █████ █████
+░░░███         ███░░░░░███░░███░░░░░█░░██████ ██████ ░░███ ░░██████ ░░███ ░░███
+  ░░░███      ███     ░░░  ░███  █ ░  ░███░█████░███  ░███  ░███░███ ░███  ░███
+    ░░░███   ░███          ░██████    ░███░░███ ░███  ░███  ░███░░███░███  ░███
+     ███░    ░███    █████ ░███░░█    ░███ ░░░  ░███  ░███  ░███ ░░██████  ░███
+   ███░      ░░███  ░░███  ░███ ░   █ ░███      ░███  ░███  ░███  ░░█████  ░███
+ ███░         ░░█████████  ██████████ █████     █████ █████ █████  ░░█████ █████
+░░░            ░░░░░░░░░  ░░░░░░░░░░ ░░░░░     ░░░░░ ░░░░░ ░░░░░    ░░░░░ ░░░░░
+
+
+Tips for getting started:
+1. Ask questions, edit files, or run commands.
+2. Be specific for the best results.
+3. Create GEMINI.md files to customize your interactions with Gemini.
+4. /help for more information.
+
+
+> 请你提交当前的代码改动。
+
+✦ 好的，我将提交当前的代码改动。首先，我会检查状态并查看改动。
+ ╭────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+ │ ✔  Shell git status && git diff HEAD && git log -n 3                                                       │
+ │                                                                                                            │
+ │    位于分支 main                                                                                           │
+ │    您的分支领先 'origin/main' 共 3 个提交。                                                                │
+ │      （使用 "git push" 来发布您的本地提交）                                                                │
+ │                                                                                                            │
+ │    尚未暂存以备提交的变更：                                                                                │
+ │      （使用 "git add <文件>..." 更新要提交的内容）                                                         │
+ │      （使用 "git restore <文件>..." 丢弃工作区的改动）                                                     │
+ │      修改：     src/index.ts                                                                                │
+ │                                                                                                            │
+ │    修改尚未加入提交（使用 "git add" 和/或 "git commit -a"）                                                │
+ │    diff --git a/src/index.ts b/src/index.ts                                                                │
+ │    index 6e37ac7..c0103f5 100644                                                                           │
+ │    --- a/src/index.ts                                                                                      │
+ │    +++ b/src/index.ts                                                                                      │
+ │    @@ -48,28 +48,40 @@ process.stdin.setRawMode(true);                                                     │
+ │     process.stdin.resume();                                                                                │
+ │                                                                                                            │
+ │     term.onExit(({ exitCode, signal }) => {                                                                │
+ │    +  // Add a small delay to ensure xterm.js has processed all output                                     │
+ │    +  setTimeout(() => {                                                                                   │
+ │    +    // Extract rendered text from xterm.js buffer                                                      │
+ │    +    let renderedOutput = '';                                                                           │
+ │    +    // Iterate over the entire buffer, including scrollback.                                           │
+ │    +    // The total number of lines is the sum of lines in scrollback (baseY) and visible rows.           │
+ │    +    for (let i = 0; i < xterm.buffer.active.baseY + xterm.rows; i++) {                                 │
+ │    +      const line = xterm.buffer.active.getLine(i);                                                     │
+ │    +      if (line) {                                                                                      │
+ │    +        // translateToString(true) gets the line content, and we trim trailing whitespace.             │
+ │    +        const lineText = line.translateToString(true).replace(/\s+$/, '');                             │
+ │    +        renderedOutput += lineText + '\n';                                                             │
+ │    +      }                                                                                                │
+ │    +    }                                                                                                  │
+ │                                                                                                            │
+ │    -  // Extract rendered text from xterm.js buffer                                                        │
+ │    -  let renderedOutput = '';  // Iterate over the entire buffer, including scrollback  for (let i = 0;   │
+ │    i < xterm.buffer.active.baseY + xterm.rows; i++) {    const line = xterm.buffer.active.getLine(i);      │
+ │    if (line) {      renderedOutput += line.translateToString(true) + '\n';    }  }                         │
+ │    -                                                                                                       │
+ │    -  const now = new Date();                                                                              │
+ │    -  const year = now.getFullYear();                                                                      │
+ │    -  const month = (now.getMonth() + 1).toString().padStart(2, '0');                                      │
+ │    -  const day = now.getDate().toString().padStart(2, '0');                                               │
+ │    -  const hours = now.getHours().toString().padStart(2, '0');                                            │
+ │    -  const minutes = now.getMinutes().toString().padStart(2, '0');                                        │
+ │    -  const seconds = now.getSeconds().toString().padStart(2, '0');                                        │
+ │    -  const logFileName = `session-${year}${month}${day}-${hours}:${minutes}:${seconds}.md`;               │
+ │    -  const logFilePath = path.join(logsDir, logFileName);                                                 │
+ │    +    const now = new Date();                                                                            │
+ │    +    const year = now.getFullYear();                                                                    │
+ │    +    const month = (now.getMonth() + 1).toString().padStart(2, '0');                                    │
+ │    +    const day = now.getDate().toString().padStart(2, '0');                                             │
+ │    +    const hours = now.getHours().toString().padStart(2, '0');                                          │
+ │    +    const minutes = now.getMinutes().toString().padStart(2, '0');                                      │
+ │    +    const seconds = now.getSeconds().toString().padStart(2, '0');                                      │
+ │    +    const logFileName = `session-${year}${month}${day}-${hours}:${minutes}:${seconds}.md`;             │
+ │    +    const logFilePath = path.join(logsDir, logFileName);                                               │
+ │                                                                                                            │
+ │    -  fs.writeFile(logFilePath, renderedOutput, (err: NodeJS.ErrnoException | null) => {                   │
+ │    -    if (err) {                                                                                         │
+ │    -      console.error('Error writing log file:', err);                                                   │
+ │    -    } else {                                                                                           │
+ │    -      console.log(`Session logged to ${path.relative(process.cwd(), logFilePath)}`);                   │
+ │    -    }                                                                                                  │
+ │    -    process.exit(exitCode);                                                                            │
+ │    -  });                                                                                                  │
+ │    +    fs.writeFile(logFilePath, renderedOutput, (err: NodeJS.ErrnoException | null) => {                 │
+ │    +      if (err) {                                                                                       │
+ │    +        console.error('Error writing log file:', err);                                                 │
+ │    +      } else {                                                                                         │
+ │    +        console.log(`Session logged to ${path.relative(process.cwd(), logFilePath)}`);                 │
+ │    +      }                                                                                                │
+ │    +      process.exit(exitCode);                                                                          │
+ │    +    });                                                                                                │
+ │    +  }, 500); // 500ms delay                                                                              │
+ │     });                                                                                                    │
+ │                                                                                                            │
+ │     process.on('SIGINT', () => {                                                                           │
+ │    commit 7ca53e9b569dec92f618251871b2f725fc61c081                                                         │
+ │    Author: alingse <alingse@foxmail.com>                                                                   │
+ │    Date:   Sat Jul 5 14:27:15 2025 +0800                                                                   │
+ │                                                                                                            │
+ │        feat: Improve logging and xterm.js configuration                                                    │
+ │                                                                                                            │
+ │        - Remove "Child process exited" log message.                                                        │
+ │        - Format session log filenames with date and time (YYYYMMDD-HH:mm:ss).                              │
+ │        - Use relative paths for session log files.                                                         │
+ │        - Set xterm.js scrollback to Infinity for unlimited buffer.                                         │
+ │                                                                                                            │
+ │    commit fa6327a30f8d0ee54f7974d4484ea276c4365f8e                                                         │
+ │    Author: alingse <alingse@foxmail.com>                                                                   │
+ │    Date:   Sat Jul 5 14:07:39 2025 +0800                                                                   │
+ │                                                                                                            │
+ │        Add .gitignore to ignore dist/ and node_modules/                                                    │
+ │                                                                                                            │
+ │    commit 1d0a2fb274885bf75a92b176899c26ddcfd70fa7                                                         │
+ │    Author: alingse <alingse@foxmail.com>                                                                   │
+ │    Date:   Sat Jul 5 14:06:42 2025 +0800                                                                   │
+ │                                                                                                            │
+ │        Update README.md with CLI features and characteristics in English and Chinese.                      │
+ │                                                                                                            │
+ ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+✦ 好的，我看到了 src/index.ts 文件中的改动。这个改动在提取 xterm.js
+  缓冲区内容之前增加了一个延迟，并清除了每行末尾的空格。
+
+
+  我将使用以下提交信息来提交这些改动：
+
+
+
+   1 fix: Ensure complete log capture and trim whitespace
+   2
+   3 - Add a 500ms delay before capturing the xterm.js buffer to prevent race conditions and ensure all output
+     is processed.
+   4 - Trim trailing whitespace from each line in the captured output for cleaner logs.
+
+
+
+  我现在就暂存并提交这些改动。
+ ╭────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+ │ ✔  Shell git add src/index.ts && git commit -m 'fix: Ensure complete log capture and trim whitespac…       │
+ │                                                                                                            │
+ │                                                                                                            │
+ │                                                                                                            │
+ │    [main f36e63e] fix: Ensure complete log capture and trim whitespace                                     │
+ │     1 file changed, 32 insertions(+), 20 deletions(-)                                                      │
+ │                                                                                                            │
+ ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+✦ 改动已提交。还有什么可以帮您的吗？
+
+> /quit
+
+╭─────────────────────────────────╮
+│                                 │
+│  Agent powering down. Goodbye!  │
+│                                 │
+│                                 │
+│  Cumulative Stats (1 Turns)     │
+│                                 │
+│  Input Tokens           24,759  │
+│  Output Tokens             251  │
+│  Thoughts Tokens           325  │
+│  ─────────────────────────────  │
+│  Total Tokens           25,335  │
+│                                 │
+│  Total duration (API)    12.7s  │
+│  Total duration (wall)  1m 29s  │
+│                                 │
+╰─────────────────────────────────╯
+
+

package/.ai-cli-log/session-20250705-151726.txt

@@ -0,0 +1,313 @@
+
+ ███            █████████  ██████████ ██████   ██████ █████ ██████   █████ █████
+░░░███         ███░░░░░███░░███░░░░░█░░██████ ██████ ░░███ ░░██████ ░░███ ░░███
+  ░░░███      ███     ░░░  ░███  █ ░  ░███░█████░███  ░███  ░███░███ ░███  ░███
+    ░░░███   ░███          ░██████    ░███░░███ ░███  ░███  ░███░░███░███  ░███
+     ███░    ░███    █████ ░███░░█    ░███ ░░░  ░███  ░███  ░███ ░░██████  ░███
+   ███░      ░░███  ░░███  ░███ ░   █ ░███      ░███  ░███  ░███  ░░█████  ░███
+ ███░         ░░█████████  ██████████ █████     █████ █████ █████  ░░█████ █████
+░░░            ░░░░░░░░░  ░░░░░░░░░░ ░░░░░     ░░░░░ ░░░░░ ░░░░░    ░░░░░ ░░░░░
+
+
+Tips for getting started:
+1. Ask questions, edit files, or run commands.
+2. Be specific for the best results.
+3. Create GEMINI.md files to customize your interactions with Gemini.
+4. /help for more information.
+
+
+> 现在需要一个调整，我想调整一下 session-20250705-15:06:55.md 这里面 session
+  的前缀，能否根据启动的不同的命令来实现呢？比如 gemini 或者claude 。请你调整。
+
+✦ 好的，我可以帮你调整。
+
+
+  为了实现这个功能，我们需要让脚本知道它是通过哪个命令（gemini 或
+  claude）启动的。一个简单的方法是将命令名作为参数传递给脚本。
+
+  我将修改 src/index.ts 来读取这个参数，并用它作为日志文件的前缀。如果未提供任何参数，它将默认使用 "session"。
+
+
+  首先，我需要读取 src/index.ts 文件的内容。
+ ╭───────────────────────────╮
+ │ ✔  ReadFile src/index.ts  │
+ ╰───────────────────────────╯
+✦ 好的，我已经阅读了 src/index.ts 的内容。
+
+
+  现在我将修改它，使用启动命令（如 gemini 或 claude）作为日志文件名的前缀。如果命令不存在，它将默认使用 "session"。
+ ╭────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+ │ ✔  Edit src/index.ts:     const now = new Date();... =>     const now = new Date();...                     │
+ │                                                                                                            │
+ │    70     const hours = now.getHours().toString().padStart(2, '0');                                        │
+ │    71     const minutes = now.getMinutes().toString().padStart(2, '0');                                    │
+ │    72     const seconds = now.getSeconds().toString().padStart(2, '0');                                    │
+ │    73   - const logFileName = `session-${year}${month}${day}-${hours}:${minutes}:${seconds}.md`;           │
+ │    73   + const prefix = command || 'session';                                                             │
+ │    74   + const logFileName = `${prefix}-${year}${month}${day}-${hours}:${minutes}:${seconds}.md`;         │
+ │    75     const logFilePath = path.join(logsDir, logFileName);                                             │
+ │    76                                                                                                      │
+ │    77     fs.writeFile(logFilePath, renderedOutput, (err: NodeJS.ErrnoException | null) => {               │
+ ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+✦ 我已经修改了 src/index.ts。现在，日志文件将根据启动命令（gemini、claude 等）或在没有命令时默认为 session 进行命名。
+
+
+  接下来，我需要编译 TypeScript 代码。
+ ╭────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+ │ ✔  Shell npm install -g typescript                                                                         │
+ │                                                                                                            │
+ │                                                                                                            │
+ │    added 1 package in 3s                                                                                   │
+ │                                                                                                            │
+ ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+ ╭───────────────╮
+ │ ✔  Shell tsc  │
+ ╰───────────────╯
+✦ 代码已成功编译。现在，当你运行 ai-cli-log 并使用不同的命令时，日志文件将以相应的命令名作为前缀。
+
+
+  例如，运行 ai-cli-log gemini 将创建一个名为 gemini-YYYYMMDD-HH:MM:SS.md 的日志文件。如果直接运行
+  ai-cli-log，它将创建一个名为 session-YYYYMMDD-HH:MM:SS.md 的文件。
+
+
+  还有什么需要我帮忙的吗？
+
+> 另外一个问题，.ai-cli-log 目录可能第一次启动时不存在，请你调整。
+
+✦ 你提出的问题非常关键。不过，根据我之前读取的代码，这个问题实际上已经处理了。
+
+
+  在 src/index.ts 文件中，有这样一段代码：
+
+
+   1 const logsDir = path.join(process.cwd(), '.ai-cli-logs');
+   2 if (!fs.existsSync(logsDir)) {
+   3   fs.mkdirSync(logsDir);
+   4 }
+
+
+
+  这段代码的作用是：
+   1. 定义日志目录的路径。
+   2. 使用 fs.existsSync 检查该目录是否存在。
+   3. 如果目录不存在（!fs.existsSync(logsDir)），则使用 fs.mkdirSync 创建它。
+
+
+  所以，程序在每次启动时都会确保 .ai-cli-logs 目录存在，如果不存在就会自动创建。你无需担心这个问题。
+
+
+  如果还有其他问题，请随时提出。
+
+> 那请你将文档和代码改动都提交一下吧
+
+✦ 好的，我来提交这些更改。首先，我需要查看当前的状态和改动。
+ ╭──────────────────────────────────╮
+ │ -  Shell git status && git diff  │
+ ╰──────────────────────────────────╯
+
+> 你可以读取 git diff 但是能不能不对我输出 git diff 的内容呢
+
+✦ 好的，我明白了。我将查看 git diff 来了解更改，但不会将差异内容输出给您。
+
+
+  首先，我检查一下当前仓库的状态。
+ ╭────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+ │ ✔  Shell git status                                                                                        │
+ │                                                                                                            │
+ │    位于分支 main                                                                                           │
+ │    您的分支领先 'origin/main' 共 4 个提交。                                                                │
+ │      （使用 "git push" 来发布您的本地提交）                                                                │
+ │                                                                                                            │
+ │    尚未暂存以备提交的变更：                                                                                │
+ │      （使用 "git add <文件>..." 更新要提交的内容）                                                         │
+ │      （使用 "git restore <文件>..." 丢弃工作区的改动）                                                     │
+ │      修改：     src/index.ts                                                                                │
+ │                                                                                                            │
+ │    未跟踪的文件:                                                                                           │
+ │      （使用 "git add <文件>..." 以包含要提交的内容）                                                       │
+ │      .ai-cli-logs/session-20250705-15:06:55.md                                                              │
+ │                                                                                                            │
+ │    修改尚未加入提交（使用 "git add" 和/或 "git commit -a"）                                                │
+ │                                                                                                            │
+ ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+✦ 好的，我看到了状态。src/index.ts 文件已被修改。我现在将暂存该文件，然后提交。
+ ╭────────────────────────────────╮
+ │ ✔  Shell git add src/index.ts  │
+ ╰────────────────────────────────╯
+✦ 文件已暂存。现在我将提交它，并附上一条描述性的提交信息。
+ ╭────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+ │ ✔  Shell git commit -m 'feat: Use command as log file prefix'                                              │
+ │                                                                                                            │
+ │    [main b2adf01] feat: Use command as log file prefix                                                     │
+ │     1 file changed, 2 insertions(+), 1 deletion(-)                                                         │
+ │                                                                                                            │
+ ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+✦ 提交已成功创建。现在，您的代码更改已记录在版本历史中。
+
+
+  还有什么需要我帮忙的吗？
+
+> 如果 command 带参数的时候文件名是不是不友好，能否提取第一个不为空的命令作为文件前缀呢？另外文件名里面的 :
+  在分享链接时容易被转义，请你推荐另外一个分割符，或者不需要分割符？你决定。
+
+✦ 你提的建议很好，文件名对可移植性和URL友好性确实很重要。
+
+
+   1. 提取命令作为前缀：当前的代码 const command = args[0]; 已经实现了提取第一个词作为命令，所以即使你运行 gemini
+      -v，文件前缀也只会是 gemini。这一点已经符合你的要求。
+
+
+   2. 文件名中的分隔符：你说得对，文件名中的冒号 :
+      在很多系统和URL中确实会引起问题。一个更安全、更常见的做法是完全不使用分隔符，或者使用连字符 -。
+
+
+  我建议将时间格式从 HH:MM:SS 改为
+  HHMMSS。这样，文件名会像这样：gemini-20250705-150655.md。这种格式清晰、安全且易于排序。
+
+
+  我将为你修改 src/index.ts 来实现这个改动。
+ ╭────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+ │ ✔  Edit src/index.ts:     const logFileName = `${pre... =>     const logFileName = `${pre...               │
+ │                                                                                                            │
+ │    71     const minutes = now.getMinutes().toString().padStart(2, '0');                                    │
+ │    72     const seconds = now.getSeconds().toString().padStart(2, '0');                                    │
+ │    73     const prefix = command || 'session';                                                             │
+ │    74   - const logFileName = `${prefix}-${year}${month}${day}-${hours}:${minutes}:${seconds}.md`;         │
+ │    74   + const logFileName = `${prefix}-${year}${month}${day}-${hours}${minutes}${seconds}.md`;           │
+ │    75     const logFilePath = path.join(logsDir, logFileName);                                             │
+ │    76                                                                                                      │
+ │    77     fs.writeFile(logFilePath, renderedOutput, (err: NodeJS.ErrnoException | null) => {               │
+ ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+✦ 我已经更新了 src/index.ts 文件，移除了时间中的冒号。
+
+
+  现在，我需要重新编译 TypeScript 代码。
+ ╭───────────────╮
+ │ ✔  Shell tsc  │
+ ╰───────────────╯
+✦ 编译完成。现在，新生成的日志文件名将采用 命令-YYYYMMDD-HHMMSS.md 的格式，例如 gemini-20250705-150655.md。
+
+
+  需要我把这个改动也提交吗？
+
+> 可以的，请你提交代码吧
+
+✦ 好的，我来提交代码。
+
+
+  首先，暂存已修改的文件。
+ ╭────────────────────────────────╮
+ │ ✔  Shell git add src/index.ts  │
+ ╰────────────────────────────────╯
+✦ 文件已暂存。现在，我将提交这个改动。
+ ╭────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+ │ ✔  Shell git commit -m 'fix: Use URL-friendly log file names'                                              │
+ │                                                                                                            │
+ │    [main 3510950] fix: Use URL-friendly log file names                                                     │
+ │     1 file changed, 1 insertion(+), 1 deletion(-)                                                          │
+ │                                                                                                            │
+ ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+✦ 代码已成功提交。
+
+
+  还有其他可以帮助你的吗？
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+> /quit
+
+╭─────────────────────────────────╮
+│                                 │
+│  Agent powering down. Goodbye!  │
+│                                 │
+│                                 │
+│  Cumulative Stats (6 Turns)     │
+│                                 │
+│  Input Tokens          157,662  │
+│  Output Tokens           1,536  │
+│  Thoughts Tokens        10,807  │
+│  ─────────────────────────────  │
+│  Total Tokens          170,005  │
+│                                 │
+│  Total duration (API)   1m 52s  │
+│  Total duration (wall)  9m 47s  │
+│                                 │
+╰─────────────────────────────────╯
+
+

package/.github/workflows/node.js.yml

@@ -0,0 +1,30 @@
+# This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs
+
+name: Node.js CI
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [22.x]
+        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+    - run: npm ci
+    - run: npm run build --if-present

package/GEMINI.md

@@ -25,16 +25,18 @@
 *   **文件结构:**
     *   `src/index.ts`: 包含主应用程序逻辑。
     *   `dist/`: 编译后的 JavaScript 输出目录。
-    *   `.ai-cli-logs/`: 用于存储生成的会话日志 Markdown 文件的目录。如果该目录不存在，则会自动创建。
+    *   `.ai-cli-log/`: 用于存储生成的会话日志 Markdown 文件的目录。如果该目录不存在，则会自动创建。
     *   `bin/`: 包含 CLI 工具的启动脚本。
 *   **日志格式:**
     *   **内容:** 日志文件捕获来自 `xterm/headless` 缓冲区的“渲染后”终端输出，真实地呈现用户所看到的内容。这包括所有交互元素、输入和输出。
-    *   **格式:** Markdown (`.md`) 文件，便于阅读和文档化。
-    *   **文件名约定:** `[command_prefix]-YYYYMMDD-HHMMSS.md`。`command_prefix` 来自于被包装的命令（例如 `gemini`、`claude`），如果未提供命令，则默认为 `session`。时间戳使用 `YYYYMMDD-HHMMSS` 格式（不含冒号），以提高 URL 友好性。
+    *   **格式:** 当前为纯文本 (`.txt`) 文件。未来计划支持 Markdown (`.md`) 以提供更丰富的渲染能力。
+    *   **文件名约定:** 基础格式为 `[command_prefix]-YYYYMMDD-HHMMSS.txt`。当使用 `-s` 或 `--with-summary` 标志启用 AI 摘要时，文件名将扩展为 `[command_prefix]-YYYYMMDD-HHMMSS-[summary_slug].txt`。其中 `[summary_slug]` 是由配置的 AI 摘要器（支持 `gemini`, `ollama`, `claude`, `sgpt` 及自定义脚本）根据会话内容生成的、由连字符分隔的简短描述（例如 `fix-database-error`）。`command_prefix` 来自于被包装的命令（例如 `gemini`、`claude`），如果未提供命令，则默认为 `session`。时间戳使用 `YYYYMMDD-HHMMSS` 格式（不含冒号），以提高 URL 友好性。
 *   **Xterm.js 配置:**
     *   `scrollback: Infinity`: 确保捕获整个回滚缓冲区，而不仅仅是可见屏幕。
     *   `allowProposedApi: true`: 明确启用 `@xterm/headless` 中的实验性 API。
 *   **Polyfills:** 避免使用浏览器特定的 polyfills（如 `global.self` 或 `global.document` 模拟），如果存在 Node.js 原生或无头版本的库（例如，优先选择 `@xterm/headless` 而非 `xterm`）。
+*   **文档中的命令语法:** 在 `README.md` 等面向用户的文档中，即使在中文说明部分，命令的语法示例（例如 `ai-cli-log <command> [args...]`）也应保持英文，以确保技术上的精确性和一致性。
+*   **代码输出:** 在生成或修改代码时，应尽量避免包含行号，除非行号对于理解上下文至关重要。这有助于保持代码片段的简洁性和可重用性。
 
 ## 4. 开发工作流
 
@@ -49,5 +51,4 @@
 *   **命名约定:** 偏好清晰、简洁和现代的名称，能准确反映工具的用途（例如，`ai-cli-log` 因其在 AI、CLI 和日志方面的清晰性而被选中）。
 *   **用户体验:** 优先考虑无缝和直观的用户体验，特别是对于交互式 CLI 工具。
 *   **可维护性:** 代码应保持整洁、结构良好且易于理解，以便于未来的维护。
-*   **文档语言:** `README.md` 等面向用户的文档应提供中英文双语说明，以覆盖更广泛的用户群体。
 *   **文档语言:** `README.md` 等面向用户的文档应提供中英文双语说明，以覆盖更广泛的用户群体。