ai-cli-log 1.0.5 → 1.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/README.md +50 -85
  2. package/dist/index.js +46 -30
  3. package/package.json +3 -1
  4. package/src/index.ts +48 -38
  5. package/.ai-cli-log/0001.txt +0 -360
  6. package/.ai-cli-log/0002.txt +0 -1791
  7. package/.ai-cli-log/0003.txt +0 -338
  8. package/.ai-cli-log/0004.txt +0 -116
  9. package/.ai-cli-log/0005.txt +0 -105
  10. package/.ai-cli-log/config.json +0 -32
  11. package/.ai-cli-log/gemini-2025-07-13T13-33-13-a-quick-gemini-test.txt +0 -174
  12. package/.ai-cli-log/gemini-2025-07-13T13-37-00-typescript-check-pass.txt +0 -105
  13. package/.ai-cli-log/gemini-2025-07-13T13-44-15-rename-ai-cli-logs-to-log.txt +0 -164
  14. package/.ai-cli-log/gemini-20250705-154601.txt +0 -1320
  15. package/.ai-cli-log/gemini-20250705-155547.txt +0 -726
  16. package/.ai-cli-log/gemini-20250705-165038.txt +0 -66
  17. package/.ai-cli-log/gemini-20250705-171429.txt +0 -216
  18. package/.ai-cli-log/gemini-20250705-191202.txt +0 -448
  19. package/.ai-cli-log/gemini-20250705-193741.txt +0 -901
  20. package/.ai-cli-log/gemini-20250705-194435.txt +0 -110
  21. package/.ai-cli-log/gemini-20250705-195926.txt +0 -415
  22. package/.ai-cli-log/gemini-20250705-201738.txt +0 -246
  23. package/.ai-cli-log/gemini-20250713-204921.txt +0 -3036
  24. package/.ai-cli-log/gemini-20250713-215941-update-ai-cli-log-documentation.txt +0 -400
  25. package/.ai-cli-log/gemini-20250713-220544-removed-debug-logs-successfully.txt +0 -258
  26. package/.ai-cli-log/gemini-20250713-221128-sessionsummarytxt.txt +0 -112
  27. package/.ai-cli-log/gemini-20250714-084659.txt +0 -86
  28. package/.ai-cli-log/gemini-20250714-085847-update-prompt-configuration.txt +0 -189
  29. package/.ai-cli-log/gemini-20250714-090905-add-sgpt-custom-summarizer.txt +0 -284
  30. package/.ai-cli-log/gemini-20250714-092329.txt +0 -110
  31. package/.ai-cli-log/gemini-20250714-092935.txt +0 -183
  32. package/.ai-cli-log/gemini-20250714-093205-heres-a-concise-summary-of-the-terminal-session-fix-sgpt-option-error-this-captures-1-the-action-fix-2-the-tool-involved-sgpt-3-the-issue-option-error-4-follows-the-requested-lowercase-hyphenated-format.txt +0 -140
  33. package/.ai-cli-log/gemini-20250714-094141-heres-the-concise-summary-build-check-clean-this-captures-1.txt +0 -111
  34. package/.ai-cli-log/gemini-20250714-094405-heres-the-concise-summary-clean-build-check-this-captures-1.txt +0 -111
  35. package/.ai-cli-log/gemini-20250714-094816-json-summary-format.txt +0 -132
  36. package/.ai-cli-log/gemini-20250714-094833-optimize-summary-logic.txt +0 -342
  37. package/.ai-cli-log/gemini-20250714-133202-refactor-config-initialization.txt +0 -1729
  38. package/.ai-cli-log/gemini-20250714-134138-update-summary-logic.txt +0 -153
  39. package/.ai-cli-log/gemini-20250714-134749-json-summary-format.txt +0 -214
  40. package/.ai-cli-log/gemini-20250714-140527.txt +0 -715
  41. package/.ai-cli-log/gemini-20250714-142018.txt +0 -86
  42. package/.ai-cli-log/gemini-20250714-142027-update-summary-format.txt +0 -86
  43. package/.ai-cli-log/gemini-20250714-142100-session-complete.txt +0 -86
  44. package/.ai-cli-log/gemini-20250714-142129-refactor-readme-structure.txt +0 -584
  45. package/.ai-cli-log/gemini-20250714-213153.txt +0 -1195
  46. package/.ai-cli-log/session-20250705-150655.txt +0 -174
  47. package/.ai-cli-log/session-20250705-151726.txt +0 -313
  48. package/.github/workflows/node.js.yml +0 -30
  49. package/GEMINI.md +0 -54
package/.ai-cli-log/gemini-2025-07-13T13-33-13-a-quick-gemini-test.txt DELETED
@@ -1,174 +0,0 @@
1
- ███ █████████ ██████████ ██████ ██████ █████ ██████ █████ █████
2
- ░░░███ ███░░░░░███░░███░░░░░█░░██████ ██████ ░░███ ░░██████ ░░███ ░░███
3
- ░░░███ ███ ░░░ ░███ █ ░ ░███░█████░███ ░███ ░███░███ ░███ ░███
4
- ░░░███ ░███ ░██████ ░███░░███ ░███ ░███ ░███░░███░███ ░███
5
- ███░ ░███ █████ ░███░░█ ░███ ░░░ ░███ ░███ ░███ ░░██████ ░███
6
- ███░ ░░███ ░░███ ░███ ░ █ ░███ ░███ ░███ ░███ ░░█████ ░███
7
- ███░ ░░█████████ ██████████ █████ █████ █████ █████ ░░█████ █████
8
- ░░░ ░░░░░░░░░ ░░░░░░░░░░ ░░░░░ ░░░░░ ░░░░░ ░░░░░ ░░░░░ ░░░░░
9
-
10
-
11
- Tips for getting started:
12
- 1. Ask questions, edit files, or run commands.
13
- 2. Be specific for the best results.
14
- 3. /help for more information.
15
-
16
-
17
- ╭───────────────────────────────────╮
18
- │ > 阅读 src/的代码，帮我分析一下 │
19
- ╰───────────────────────────────────╯
20
-
21
- ✦ 好的，我来阅读并分析 src/index.ts 的代码。
22
- ╭───────────────────────────╮
23
- │ ✔ ReadFile src/index.ts │
24
- ╰───────────────────────────╯
25
- ✦ 好的，我已经阅读了 src/index.ts 的代码。这是一个功能相当完整的 CLI 工具，用于记录和（可选地）总结终端会话。
26
-
27
- 代码主要可以分为三个部分：配置管理、会话日志记录 和 AI 总结。
28
-
29
- 1. 核心功能
30
-
31
-
32
- 这个脚本的核心功能是启动一个子进程（用户指定的任何命令，例如 gemini 或
33
- bash），并精确地记录下该进程在终端中的所有输入和输出。它通过模拟一个伪终端（PTY）来实现这一点，确保了交互式应用的正
34
- 确渲染（比如命令行提示符、颜色、光标移动等）。
35
-
36
- 记录完成后，它会将“渲染后”的终端屏幕内容保存到一个日志文件中。
37
-
38
- 2. 代码结构分析
39
-
40
- a. 配置管理 (`Configuration & Type Definitions`)
41
-
42
-
43
- * 配置文件: 工具支持两种配置文件：
44
- * 本地配置: .ai-cli-logs/config.json (在当前工作目录下)
45
- * 全局配置: ~/.config/ai-cli-log/config.json (在用户的主目录下)
46
- * 本地配置会覆盖全局配置。
47
- * `--init` 命令:
48
- * 提供了一个初始化命令 ai-cli-log --init 来帮助用户创建配置文件。
49
- * 它会自动检测系统中是否安装了 gemini 或 ollama 这类 AI 工具。
50
- * 然后，它会引导用户为找到的工具创建“总结器 (summarizer)”配置，并可以设置一个默认的总结器。
51
- * 配置结构 (`AppConfig`):
52
- * 主要用于定义不同的 summarizer。每个 summarizer 包含名称、所用工具 (gemini, ollama
53
- 等)、模型、以及一个用于生成摘要的提示 (prompt)。
54
-
55
- b. 会话日志记录 (`runLoggingSession`)
56
-
57
-
58
- * 伪终端 (PTY): 使用 node-pty 库来创建伪终端，这是实现会话捕获的关键。它能模拟一个真实的终端环境。
59
- * 屏幕渲染: 使用 @xterm/headless 库来维护一个虚拟的终端屏幕缓冲区。当子进程输出 ANSI
60
- 转义码（用于控制颜色、光标位置等）时，@xterm/headless 会解释这些代码并更新其内部的屏幕状态。
61
- * 输入/输出流:
62
- * 用户的标准输入 (process.stdin) 被转发给伪终端。
63
- * 伪终端的输出同时被发送到用户的标准输出 (process.stdout，这样用户可以实时看到交互) 和 @xterm/headless
64
- 的实例（用于最终记录）。
65
- * 日志保存:
66
- * 当被记录的命令退出时，程序会从 @xterm/headless 的缓冲区中提取出最终渲染的文本内容。
67
- * 这部分内容会被保存到 .ai-cli-logs/ 目录下的一个 .txt 文件中。
68
- * 文件名格式为 [command]-[timestamp].txt 或 [command]-[timestamp]-[summary].txt。
69
-
70
- c. AI 总结 (`getAiSummary`)
71
-
72
-
73
- * 触发方式: 当用户在运行命令时提供了 --with-summary 或 -s 参数时，此功能被激活。
74
- * 工作流程:
75
- 1. 读取配置，找到用户指定的（或默认的）summarizer。
76
- 2. 根据 summarizer 的配置，构建一个命令行调用（例如 gemini -p "prompt..." 或 ollama run llama3 "prompt..."）。
77
- 3. 为了效率，如果会话内容过长，它会截取开头和结尾的一部分内容（sampledContent）作为摘要的输入。
78
- 4. 通过 spawn 启动对应的 AI 工具进程。
79
- 5. 将截取后的会话内容通过 stdin 发送给 AI 工具。
80
- 6. 捕获 AI 工具的 stdout 输出，将其作为摘要。
81
- 7. 最后，将摘要文本进行“slugify”处理（转换为小写、用连字符替换空格等），使其适合用作文件名的一部分。
82
-
83
- 3. 总体评价
84
-
85
-
86
- * 架构清晰: 代码将配置、日志记录和 AI 摘要功能清晰地分离开来，易于理解和维护。
87
- * 技术选型得当: node-pty 和 @xterm/headless
88
- 是实现这种终端会话记录功能的理想选择，它们能够精确地还原用户所见的终端状态，而不仅仅是原始的 stdout 流。
89
- * 用户体验良好: 提供了 --init 命令来简化配置过程，并且支持本地和全局配置，非常灵活。
90
- * 健壮性: 代码中包含了对各种退出情况、错误处理和进程信号的处理，例如确保在子进程退出后正确清理监听器和恢复终端模式。
91
- * 可扩展性: summarizer 的配置是基于数组的，很容易通过修改配置文件来添加对新 AI 工具或模型的支持。
92
-
93
-
94
- 总的来说，这是一个设计良好、功能强大的 CLI
95
- 工具。它准确地解决了记录交互式终端会话这一核心问题，并在此基础上增加了实用且灵活的 AI 总结功能。
96
-
97
-
98
-
99
-
100
-
101
-
102
-
103
-
104
-
105
-
106
-
107
-
108
-
109
-
110
-
111
-
112
-
113
-
114
-
115
-
116
-
117
-
118
-
119
-
120
-
121
-
122
-
123
-
124
-
125
-
126
-
127
-
128
-
129
-
130
-
131
-
132
-
133
-
134
-
135
-
136
-
137
-
138
-
139
-
140
-
141
-
142
-
143
-
144
-
145
-
146
-
147
-
148
-
149
-
150
-
151
- ╭───────────╮
152
- │ > /quit │
153
- ╰───────────╯
154
-
155
- ╭────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
156
- │ │
157
- │ Agent powering down. Goodbye! │
158
- │ │
159
- │ Interaction Summary │
160
- │ Tool Calls: 1 ( ✔ 1 ✖ 0 ) │
161
- │ Success Rate: 100.0% │
162
- │ │
163
- │ Performance │
164
- │ Wall Time: 17m 50s │
165
- │ Agent Active: 37.6s │
166
- │ » API Time: 37.6s (100.0%) │
167
- │ » Tool Time: 17ms (0.0%) │
168
- │ │
169
- │ │
170
- │ Model Usage Reqs Input Tokens Output Tokens │
171
- │ ─────────────────────────────────────────────────────────────── │
172
- │ gemini-2.5-pro 2 21,032 1,213 │
173
- │ │
174
- ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
package/.ai-cli-log/gemini-2025-07-13T13-37-00-typescript-check-pass.txt DELETED
@@ -1,105 +0,0 @@
1
- ███ █████████ ██████████ ██████ ██████ █████ ██████ █████ █████
2
- ░░░███ ███░░░░░███░░███░░░░░█░░██████ ██████ ░░███ ░░██████ ░░███ ░░███
3
- ░░░███ ███ ░░░ ░███ █ ░ ░███░█████░███ ░███ ░███░███ ░███ ░███
4
- ░░░███ ░███ ░██████ ░███░░███ ░███ ░███ ░███░░███░███ ░███
5
- ███░ ░███ █████ ░███░░█ ░███ ░░░ ░███ ░███ ░███ ░░██████ ░███
6
- ███░ ░░███ ░░███ ░███ ░ █ ░███ ░███ ░███ ░███ ░░█████ ░███
7
- ███░ ░░█████████ ██████████ █████ █████ █████ █████ ░░█████ █████
8
- ░░░ ░░░░░░░░░ ░░░░░░░░░░ ░░░░░ ░░░░░ ░░░░░ ░░░░░ ░░░░░ ░░░░░
9
-
10
-
11
- Tips for getting started:
12
- 1. Ask questions, edit files, or run commands.
13
- 2. Be specific for the best results.
14
- 3. /help for more information.
15
-
16
-
17
- ╭──────────────────────────────────────────────╮
18
- │ > 检查一下 src/index.ts 里面是否有语法错误 │
19
- ╰──────────────────────────────────────────────╯
20
-
21
- ✦ 好的，我将使用 TypeScript 编译器来检查 src/index.ts 文件是否存在语法错误。
22
- ╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
23
- │ ✔ Shell npx tsc --noEmit --project tsconfig.json (Run the TypeScript compiler to check for errors in the project.) │
24
- ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
25
- ✦ src/index.ts 文件中没有发现语法错误。
26
-
27
-
28
-
29
-
30
-
31
-
32
-
33
-
34
-
35
-
36
-
37
-
38
-
39
-
40
-
41
-
42
-
43
-
44
-
45
-
46
-
47
-
48
-
49
-
50
-
51
-
52
-
53
-
54
-
55
-
56
-
57
-
58
-
59
-
60
-
61
-
62
-
63
-
64
-
65
-
66
-
67
-
68
-
69
-
70
-
71
-
72
-
73
-
74
-
75
-
76
-
77
-
78
-
79
-
80
-
81
- ╭───────────╮
82
- │ > /quit │
83
- ╰───────────╯
84
-
85
- ╭────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
86
- │ │
87
- │ Agent powering down. Goodbye! │
88
- │ │
89
- │ Interaction Summary │
90
- │ Tool Calls: 1 ( ✔ 1 ✖ 0 ) │
91
- │ Success Rate: 100.0% │
92
- │ User Agreement: 100.0% (1 reviewed) │
93
- │ │
94
- │ Performance │
95
- │ Wall Time: 1m 3s │
96
- │ Agent Active: 22.8s │
97
- │ » API Time: 6.5s (28.7%) │
98
- │ » Tool Time: 16.2s (71.3%) │
99
- │ │
100
- │ │
101
- │ Model Usage Reqs Input Tokens Output Tokens │
102
- │ ─────────────────────────────────────────────────────────────── │
103
- │ gemini-2.5-pro 2 17,398 69 │
104
- │ │
105
- ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
package/.ai-cli-log/gemini-2025-07-13T13-44-15-rename-ai-cli-logs-to-log.txt DELETED
@@ -1,164 +0,0 @@
1
- ███ █████████ ██████████ ██████ ██████ █████ ██████ █████ █████
2
- ░░░███ ███░░░░░███░░███░░░░░█░░██████ ██████ ░░███ ░░██████ ░░███ ░░███
3
- ░░░███ ███ ░░░ ░███ █ ░ ░███░█████░███ ░███ ░███░███ ░███ ░███
4
- ░░░███ ░███ ░██████ ░███░░███ ░███ ░███ ░███░░███░███ ░███
5
- ███░ ░███ █████ ░███░░█ ░███ ░░░ ░███ ░███ ░███ ░░██████ ░███
6
- ███░ ░░███ ░░███ ░███ ░ █ ░███ ░███ ░███ ░███ ░░█████ ░███
7
- ███░ ░░█████████ ██████████ █████ █████ █████ █████ ░░█████ █████
8
- ░░░ ░░░░░░░░░ ░░░░░░░░░░ ░░░░░ ░░░░░ ░░░░░ ░░░░░ ░░░░░ ░░░░░
9
-
10
-
11
- Tips for getting started:
12
- 1. Ask questions, edit files, or run commands.
13
- 2. Be specific for the best results.
14
- 3. /help for more information.
15
-
16
-
17
- ╭─────────────────────────────────────────────────────────────────────────────────────────────────────────╮
18
- │ > 我需要将本地目录的 .ai-cli-logs 调整为 .ai-cli-log 这样全局都是一样的了。你调整 src/index.ts 代码吧 │
19
- ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────╯
20
-
21
- ✦ 好的，我将 src/index.ts 中对日志目录的引用从 .ai-cli-logs 调整为 .ai-cli-log。
22
-
23
-
24
- 首先，我需要读取 src/index.ts 文件的内容。
25
- ╭───────────────────────────╮
26
- │ ✔ ReadFile src/index.ts │
27
- ╰───────────────────────────╯
28
- ✦ 好的，我将把 src/index.ts 中的 .ai-cli-logs 目录修改为 .ai-cli-log。
29
- ╭────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
30
- │ ✔ Edit src/index.ts: const GLOBAL_CONFIG_DIR = path... => const GLOBAL_CONFIG_DIR = path... │
31
- │ │
32
- │ 12 │
33
- │ 13 const GLOBAL_CONFIG_DIR = path.join(os.homedir(), '.config', 'ai-cli-log'); │
34
- │ 14 const GLOBAL_CONFIG_PATH = path.join(GLOBAL_CONFIG_DIR, 'config.json'); │
35
- │ 15 - const LOCAL_CONFIG_PATH = path.join(process.cwd(), '.ai-cli-logs', 'config.json'); │
36
- │ 15 + const LOCAL_CONFIG_PATH = path.join(process.cwd(), '.ai-cli-log', 'config.json'); │
37
- │ 16 │
38
- │ 17 interface Summarizer { │
39
- │ 18 name: string; │
40
- ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
41
- ✦ 我已将 src/index.ts 中的 .ai-cli-logs 替换为 .ai-cli-log。
42
-
43
-
44
- 接下来，我将重命名该目录。
45
- ╭────────────────────────────────────────────────────────────────────────────────────────────────────╮
46
- │ - Shell mv .ai-cli-logs .ai-cli-log (Rename the log directory from .ai-cli-logs to .ai-cli-log.) │
47
- ╰────────────────────────────────────────────────────────────────────────────────────────────────────╯
48
-
49
- ╭────────────────────────────────────────────╮
50
- │ > 应该还有一个地方需要修改，请你检查代码 │
51
- ╰────────────────────────────────────────────╯
52
-
53
- ✦ 好的，您说得对。我将再次检查 src/index.ts 文件，确保没有遗漏任何需要修改的地方。
54
- ╭───────────────────────────╮
55
- │ ✔ ReadFile src/index.ts │
56
- ╰───────────────────────────╯
57
- ✦ 您是对的，我重新检查了代码，发现 GEMINI.md 文件中也定义了 .ai-cli-logs 目录。为了保持一致性，我将同步修改 GEMINI.md
58
- 文件。
59
- ╭────────────────────────╮
60
- │ ✔ ReadFile GEMINI.md │
61
- ╰────────────────────────╯
62
- ✦ 好的，我将 GEMINI.md 中的 .ai-cli-logs 目录修改为 .ai-cli-log。
63
- ╭────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
64
- │ ✔ Edit GEMINI.md: * `.ai-cli-logs/`: 用于存储生... => * `.ai-cli-log/`: 用于存储生成... │
65
- │ │
66
- │ 25 * **文件结构:** │
67
- │ 26 * `src/index.ts`: 包含主应用程序逻辑。 │
68
- │ 27 * `dist/`: 编译后的 JavaScript 输出目录。 │
69
- │ 28 - * `.ai-cli-logs/`: 用于存储生成的会话日志 Markdown │
70
- │ 文件的目录。如果该目录不存在，则会自动创建。 │
71
- │ 28 + * `.ai-cli-log/`: 用于存储生成的会话日志 Markdown │
72
- │ 文件的目录。如果该目录不存在，则会自动创建。 │
73
- │ 29 * `bin/`: 包含 CLI 工具的启动脚本。 │
74
- │ 30 * **日志格式:** │
75
- │ 31 * **内容:** 日志文件捕获来自 `xterm/headless` │
76
- │ 缓冲区的“渲染后”终端输出，真实地呈现用户所看到的内容。这包括所有交互元素、输入和输出。 │
77
- ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
78
- ✦ 我已将 GEMINI.md 中的 .ai-cli-logs 替换为 .ai-cli-log。
79
-
80
-
81
- 现在，我将重命名该目录。
82
- ╭────────────────────────────────────────────────────────────────────────────────────────────────────╮
83
- │ - Shell mv .ai-cli-logs .ai-cli-log (Rename the log directory from .ai-cli-logs to .ai-cli-log.) │
84
- ╰────────────────────────────────────────────────────────────────────────────────────────────────────╯
85
-
86
-
87
-
88
-
89
-
90
-
91
-
92
-
93
-
94
-
95
-
96
-
97
-
98
-
99
-
100
-
101
-
102
-
103
-
104
-
105
-
106
-
107
-
108
-
109
-
110
-
111
-
112
-
113
-
114
-
115
-
116
-
117
-
118
-
119
-
120
-
121
-
122
-
123
-
124
-
125
-
126
-
127
-
128
-
129
-
130
-
131
-
132
-
133
-
134
-
135
-
136
-
137
-
138
-
139
-
140
- ╭───────────╮
141
- │ > /quit │
142
- ╰───────────╯
143
-
144
- ╭────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
145
- │ │
146
- │ Agent powering down. Goodbye! │
147
- │ │
148
- │ Interaction Summary │
149
- │ Tool Calls: 7 ( ✔ 5 ✖ 2 ) │
150
- │ Success Rate: 71.4% │
151
- │ User Agreement: 50.0% (4 reviewed) │
152
- │ │
153
- │ Performance │
154
- │ Wall Time: 5m 15s │
155
- │ Agent Active: 3m 9s │
156
- │ » API Time: 35.1s (18.5%) │
157
- │ » Tool Time: 2m 34s (81.5%) │
158
- │ │
159
- │ │
160
- │ Model Usage Reqs Input Tokens Output Tokens │
161
- │ ─────────────────────────────────────────────────────────────── │
162
- │ gemini-2.5-pro 7 101,125 709 │
163
- │ │
164
- ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯