chatccc 0.2.231 → 0.2.232

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 (127) hide show
  1. package/.agents/skills/create-chatccc-feishu-app/SKILL.md +85 -85
  2. package/.claude/skills/create-chatccc-feishu-app/SKILL.md +85 -85
  3. package/.cursor/skills/create-chatccc-feishu-app/SKILL.md +85 -85
  4. package/README.md +90 -90
  5. package/agent-prompts/claude_specific.md +45 -45
  6. package/agent-prompts/codex_specific.md +2 -2
  7. package/agent-prompts/cursor_specific.md +13 -13
  8. package/bin/cccagent.mjs +17 -17
  9. package/im-skills/feishu-skill/receive-send-file.md +63 -63
  10. package/im-skills/feishu-skill/receive-send-image.md +24 -24
  11. package/im-skills/feishu-skill/skill.md +3 -3
  12. package/im-skills/wechat-file-skill/receive-send-file.md +38 -38
  13. package/im-skills/wechat-file-skill/send-file.mjs +83 -83
  14. package/im-skills/wechat-file-skill/skill.md +10 -10
  15. package/im-skills/wechat-image-skill/skill.md +10 -10
  16. package/im-skills/wechat-video-skill/receive-send-video.md +38 -38
  17. package/im-skills/wechat-video-skill/send-video.mjs +79 -79
  18. package/im-skills/wechat-video-skill/skill.md +10 -10
  19. package/package.json +1 -1
  20. package/scripts/postinstall-sharp-check.mjs +58 -58
  21. package/src/__tests__/agent-activity.test.ts +86 -86
  22. package/src/__tests__/agent-delegate-task-rpc.test.ts +165 -165
  23. package/src/__tests__/agent-reload-config-rpc.test.ts +99 -99
  24. package/src/__tests__/builtin-chat-session.test.ts +449 -393
  25. package/src/__tests__/builtin-cli-json.test.ts +39 -39
  26. package/src/__tests__/builtin-config.test.ts +26 -26
  27. package/src/__tests__/builtin-context.test.ts +319 -202
  28. package/src/__tests__/builtin-file-tools.test.ts +240 -240
  29. package/src/__tests__/builtin-permissions.test.ts +211 -211
  30. package/src/__tests__/builtin-session-search.test.ts +228 -0
  31. package/src/__tests__/builtin-session-select.test.ts +116 -116
  32. package/src/__tests__/builtin-sigint.test.ts +56 -56
  33. package/src/__tests__/builtin-skills.test.ts +284 -284
  34. package/src/__tests__/builtin-web-tools.test.ts +220 -220
  35. package/src/__tests__/card-action-routing.test.ts +18 -18
  36. package/src/__tests__/cardkit.test.ts +60 -60
  37. package/src/__tests__/ccc-adapter.test.ts +170 -170
  38. package/src/__tests__/chatgpt-subscription-rpc.test.ts +89 -89
  39. package/src/__tests__/chatgpt-subscription.test.ts +135 -135
  40. package/src/__tests__/chrome-devtools-guard.test.ts +165 -165
  41. package/src/__tests__/claude-adapter.test.ts +614 -614
  42. package/src/__tests__/claude-raw-stream-log.test.ts +87 -87
  43. package/src/__tests__/codex-adapter.test.ts +58 -58
  44. package/src/__tests__/codex-raw-stream-log.test.ts +170 -170
  45. package/src/__tests__/codex-reset-actions.test.ts +146 -146
  46. package/src/__tests__/cursor-adapter.test.ts +268 -268
  47. package/src/__tests__/feishu-api.test.ts +60 -60
  48. package/src/__tests__/feishu-avatar.test.ts +164 -164
  49. package/src/__tests__/feishu-message-ingress.test.ts +138 -138
  50. package/src/__tests__/feishu-platform.test.ts +22 -22
  51. package/src/__tests__/format-message.test.ts +47 -47
  52. package/src/__tests__/jsonl-stream.test.ts +79 -79
  53. package/src/__tests__/package-files.test.ts +24 -24
  54. package/src/__tests__/privacy.test.ts +198 -198
  55. package/src/__tests__/progress-reducer.test.ts +121 -121
  56. package/src/__tests__/raw-stream-log.test.ts +106 -106
  57. package/src/__tests__/response-stall.test.ts +49 -49
  58. package/src/__tests__/restart.test.ts +132 -132
  59. package/src/__tests__/session.test.ts +199 -199
  60. package/src/__tests__/shared-prefix.test.ts +36 -36
  61. package/src/__tests__/sim-platform.test.ts +16 -16
  62. package/src/__tests__/startup-lifecycle.test.ts +231 -231
  63. package/src/__tests__/stop-session.test.ts +34 -34
  64. package/src/__tests__/stream-state.test.ts +42 -42
  65. package/src/__tests__/terminal-error.test.ts +54 -54
  66. package/src/__tests__/terminal-renderer.test.ts +247 -247
  67. package/src/__tests__/update-command-guard.test.ts +144 -144
  68. package/src/__tests__/web-ui.test.ts +326 -326
  69. package/src/adapters/adapter-interface.ts +33 -33
  70. package/src/adapters/ccc-adapter.ts +141 -141
  71. package/src/adapters/claude-adapter.ts +620 -620
  72. package/src/adapters/claude-session-meta-store.ts +120 -120
  73. package/src/adapters/codex-adapter.ts +426 -426
  74. package/src/adapters/cursor-adapter.ts +681 -681
  75. package/src/adapters/jsonl-stream.ts +157 -157
  76. package/src/adapters/raw-stream-log.ts +124 -124
  77. package/src/adapters/resource-monitor.ts +140 -140
  78. package/src/agent-activity.ts +175 -175
  79. package/src/agent-delegate-task-rpc.ts +153 -153
  80. package/src/agent-delegate-task.ts +91 -91
  81. package/src/agent-reload-config-rpc.ts +34 -34
  82. package/src/agent-stop-stuck.ts +129 -129
  83. package/src/builtin/cli.ts +6 -0
  84. package/src/builtin/config.ts +84 -84
  85. package/src/builtin/context.ts +465 -391
  86. package/src/builtin/file-log.ts +38 -38
  87. package/src/builtin/file-tools.ts +34 -0
  88. package/src/builtin/index.ts +24 -23
  89. package/src/builtin/proc-tree-kill.ts +61 -61
  90. package/src/builtin/progress/cards-helpers.ts +76 -76
  91. package/src/builtin/progress/reducer.ts +113 -113
  92. package/src/builtin/progress/terminal-renderer.ts +294 -294
  93. package/src/builtin/progress/view.ts +77 -77
  94. package/src/builtin/raw-stream-log.ts +124 -124
  95. package/src/builtin/session-search.ts +363 -0
  96. package/src/builtin/session-select.ts +48 -48
  97. package/src/builtin/sigint.ts +50 -50
  98. package/src/builtin/skills.ts +205 -205
  99. package/src/builtin/web-tools.ts +313 -313
  100. package/src/card-action-routing.ts +14 -14
  101. package/src/chatgpt-subscription-rpc.ts +27 -27
  102. package/src/chatgpt-subscription.ts +299 -299
  103. package/src/chrome-devtools-guard.ts +318 -318
  104. package/src/codex-reset-actions.ts +184 -184
  105. package/src/feishu-api.ts +193 -193
  106. package/src/feishu-message-ingress.ts +195 -195
  107. package/src/feishu-platform.ts +20 -20
  108. package/src/format-message.ts +293 -293
  109. package/src/litellm-proxy.ts +374 -374
  110. package/src/orchestrator.ts +2494 -2494
  111. package/src/platform-adapter.ts +6 -6
  112. package/src/privacy.ts +118 -118
  113. package/src/progress/reducer.ts +113 -113
  114. package/src/progress/terminal-renderer.ts +294 -294
  115. package/src/progress/view.ts +77 -77
  116. package/src/response-stall.ts +28 -28
  117. package/src/runtime-reload.ts +34 -34
  118. package/src/session-chat-binding.ts +82 -82
  119. package/src/session-name.ts +8 -8
  120. package/src/session.ts +201 -201
  121. package/src/shared-prefix.ts +29 -29
  122. package/src/sim-platform.ts +20 -20
  123. package/src/startup-lifecycle.ts +250 -250
  124. package/src/stream-state.ts +21 -21
  125. package/src/terminal-error.ts +129 -129
  126. package/src/turn-cards.ts +117 -117
  127. package/src/update-command-guard.ts +165 -165
@@ -123,25 +123,25 @@ export const SimulatedPlatform: FeishuPlatform = {
123
123
  },
124
124
 
125
125
  // ---- 头像 ----
126
- async setChatAvatar(_token, _chatId, _tool, _status) {
127
- // 模拟模式不需要头像
128
- },
129
-
130
- async getCodexUsageSummary() {
131
- return {
132
- fiveHour: { usedPercent: 0, remainingPercent: 100, resetAtEpochSeconds: null, resetAfterSeconds: null },
133
- weekly: { usedPercent: 0, remainingPercent: 100, resetAtEpochSeconds: null, resetAfterSeconds: null },
134
- rateLimitResetCreditsAvailable: null,
135
- rateLimitResetCredits: null,
136
- };
137
- },
138
-
139
- async consumeCodexRateLimitResetCredit(_redeemRequestId) {
140
- return { code: "no_credit" as const, windowsReset: 0 };
141
- },
142
-
143
- // ---- 图片下载 ----
144
- async getOrDownloadImage(_token, _messageId, fileKey) {
126
+ async setChatAvatar(_token, _chatId, _tool, _status) {
127
+ // 模拟模式不需要头像
128
+ },
129
+
130
+ async getCodexUsageSummary() {
131
+ return {
132
+ fiveHour: { usedPercent: 0, remainingPercent: 100, resetAtEpochSeconds: null, resetAfterSeconds: null },
133
+ weekly: { usedPercent: 0, remainingPercent: 100, resetAtEpochSeconds: null, resetAfterSeconds: null },
134
+ rateLimitResetCreditsAvailable: null,
135
+ rateLimitResetCredits: null,
136
+ };
137
+ },
138
+
139
+ async consumeCodexRateLimitResetCredit(_redeemRequestId) {
140
+ return { code: "no_credit" as const, windowsReset: 0 };
141
+ },
142
+
143
+ // ---- 图片下载 ----
144
+ async getOrDownloadImage(_token, _messageId, fileKey) {
145
145
  return join(SIM_DIR, "images", fileKey);
146
146
  },
147
147
 
@@ -174,4 +174,4 @@ export const SimulatedPlatform: FeishuPlatform = {
174
174
  };
175
175
 
176
176
  /** 模拟模式下的默认 chat_id(重新导出以保持向后兼容) */
177
- export { SIM_DEFAULT_CHAT_ID } from "./sim-store.ts";
177
+ export { SIM_DEFAULT_CHAT_ID } from "./sim-store.ts";
@@ -1,250 +1,250 @@
1
- import { spawn, type ChildProcess } from "node:child_process";
2
-
3
- const DEFAULT_SERVICE_HEALTH_INTERVAL_MS = 10_000;
4
-
5
- interface RefTimer {
6
- ref?: () => unknown;
7
- }
8
-
9
- export interface ServiceLifecycleServer {
10
- listening: boolean;
11
- address: () => unknown;
12
- ref: () => unknown;
13
- }
14
-
15
- interface ServiceLifecycleGuardOptions {
16
- intervalMs?: number;
17
- setIntervalImpl?: (callback: () => void, delayMs: number) => RefTimer;
18
- clearIntervalImpl?: (timer: RefTimer) => void;
19
- tracer?: (message: string, extra?: Record<string, unknown>) => void;
20
- getActiveResourcesInfo?: () => string[];
21
- }
22
-
23
- export interface ServiceLifecycleGuard {
24
- start: () => void;
25
- attachServer: (
26
- server: ServiceLifecycleServer,
27
- recoverServer?: () => void | Promise<void>,
28
- ) => void;
29
- checkNow: () => Promise<void>;
30
- handleBeforeExit: (code: number) => void;
31
- beginShutdown: (reason: string) => void;
32
- }
33
-
34
- /**
35
- * 为 ChatCCC 这种常驻服务建立一个明确的进程生命周期锚点。
36
- *
37
- * 正常情况下,正在 listen 的 HTTP Server 自己就足以维持事件循环;额外的
38
- * referenced timer 是最后一道保险,避免某个依赖升级或异常 close/unref 让进程在
39
- * 没有信号、异常或退出码的情况下静默消失。定时检查同时会重新 ref Server,并在
40
- * Server 确实停止监听时串行触发恢复,避免只把一个失去服务能力的僵尸进程留下来。
41
- */
42
- export function createServiceLifecycleGuard(
43
- options: ServiceLifecycleGuardOptions = {},
44
- ): ServiceLifecycleGuard {
45
- const intervalMs = options.intervalMs ?? DEFAULT_SERVICE_HEALTH_INTERVAL_MS;
46
- const setIntervalImpl = options.setIntervalImpl
47
- ?? ((callback, delayMs) => setInterval(callback, delayMs));
48
- const clearIntervalImpl = options.clearIntervalImpl
49
- ?? ((timer) => clearInterval(timer as NodeJS.Timeout));
50
- const tracer = options.tracer ?? (() => {});
51
- const getActiveResourcesInfo = options.getActiveResourcesInfo
52
- ?? (() => process.getActiveResourcesInfo());
53
-
54
- let timer: RefTimer | null = null;
55
- let server: ServiceLifecycleServer | null = null;
56
- let recoverServer: (() => void | Promise<void>) | undefined;
57
- let recoveryPromise: Promise<void> | null = null;
58
- let shuttingDown = false;
59
-
60
- const trace = (message: string, extra?: Record<string, unknown>): void => {
61
- try { tracer(message, extra); } catch { /* 诊断路径不能反过来打断服务 */ }
62
- };
63
-
64
- const serverAddress = (): unknown => {
65
- try { return server?.address() ?? null; } catch { return null; }
66
- };
67
-
68
- const activeResources = (): string[] => {
69
- try { return getActiveResourcesInfo(); } catch { return []; }
70
- };
71
-
72
- const diagnostics = (extra: Record<string, unknown> = {}): Record<string, unknown> => ({
73
- ...extra,
74
- uptimeSeconds: Math.floor(process.uptime()),
75
- activeResources: activeResources(),
76
- serverAttached: server !== null,
77
- serverListening: server?.listening ?? false,
78
- serverAddress: serverAddress(),
79
- });
80
-
81
- const start = (): void => {
82
- if (shuttingDown || timer) return;
83
- timer = setIntervalImpl(() => { void checkNow(); }, intervalMs);
84
- // Node 的 Timeout 默认就是 ref 状态;显式 ref 让常驻服务契约不会依赖默认值。
85
- try { timer.ref?.(); } catch { /* ignore */ }
86
- trace("service-lifecycle: guard started", { intervalMs });
87
- };
88
-
89
- const checkNow = async (): Promise<void> => {
90
- if (shuttingDown || !server) return;
91
- if (server.listening) {
92
- try { server.ref(); } catch (err) {
93
- trace("service-lifecycle: HTTP server ref failed", diagnostics({
94
- error: (err as Error).message,
95
- }));
96
- }
97
- return;
98
- }
99
-
100
- if (recoveryPromise) return recoveryPromise;
101
- trace("service-lifecycle: HTTP server inactive", diagnostics());
102
- if (!recoverServer) return;
103
-
104
- recoveryPromise = Promise.resolve()
105
- .then(() => recoverServer?.())
106
- .then(() => {
107
- if (server?.listening) {
108
- try { server.ref(); } catch { /* 下一轮健康检查会再次尝试 */ }
109
- trace("service-lifecycle: HTTP server recovered", diagnostics());
110
- } else {
111
- trace("service-lifecycle: HTTP recovery completed without listening", diagnostics());
112
- }
113
- })
114
- .catch((err: unknown) => {
115
- trace("service-lifecycle: HTTP server recovery failed", diagnostics({
116
- error: err instanceof Error ? err.message : String(err),
117
- }));
118
- })
119
- .finally(() => {
120
- recoveryPromise = null;
121
- });
122
- return recoveryPromise;
123
- };
124
-
125
- const attachServer = (
126
- nextServer: ServiceLifecycleServer,
127
- nextRecoverServer?: () => void | Promise<void>,
128
- ): void => {
129
- server = nextServer;
130
- recoverServer = nextRecoverServer;
131
- if (server.listening) {
132
- try { server.ref(); } catch { /* 下一轮健康检查会记录 */ }
133
- }
134
- trace("service-lifecycle: HTTP server attached", diagnostics());
135
- };
136
-
137
- const handleBeforeExit = (code: number): void => {
138
- if (shuttingDown) return;
139
- trace("service-lifecycle: unexpected beforeExit", diagnostics({ code }));
140
- start();
141
- void checkNow();
142
- };
143
-
144
- const beginShutdown = (reason: string): void => {
145
- if (shuttingDown) return;
146
- shuttingDown = true;
147
- if (timer) {
148
- try { clearIntervalImpl(timer); } catch { /* process 即将退出 */ }
149
- timer = null;
150
- }
151
- trace("service-lifecycle: shutdown requested", { reason });
152
- };
153
-
154
- return { start, attachServer, checkNow, handleBeforeExit, beginShutdown };
155
- }
156
-
157
- /**
158
- * ChatCCC 自己拉起替代进程时使用的内部标记。
159
- *
160
- * 不能用“是否已有配置”判断是否打开控制台:首次配置和日常直接启动都应该
161
- * 打开,而 `/restart`、`/update` 和 Web UI 重启都不应该打扰用户。环境变量
162
- * 会自然穿过 cmd/bash/npx 这几层启动器,因此也适用于 Windows 与 Linux。
163
- */
164
- export const INTERNAL_RESTART_ENV_VAR = "CHATCCC_INTERNAL_RESTART";
165
-
166
- type Environment = Record<string, string | undefined>;
167
-
168
- export function createInternalRestartEnv(
169
- inherited: Environment = process.env,
170
- ): NodeJS.ProcessEnv {
171
- return {
172
- ...inherited,
173
- [INTERNAL_RESTART_ENV_VAR]: "1",
174
- };
175
- }
176
-
177
- /** 用户直接启动时打开;ChatCCC 内部重启产生的替代进程不打开。 */
178
- interface AutoOpenWebUiOptions {
179
- env?: Environment;
180
- openOnStart?: boolean;
181
- }
182
-
183
- export function shouldAutoOpenWebUi(options: AutoOpenWebUiOptions = {}): boolean {
184
- const env = options.env ?? process.env;
185
- return options.openOnStart !== false && env[INTERNAL_RESTART_ENV_VAR] !== "1";
186
- }
187
-
188
- /** Web UI 始终使用 localhost,并跟随实际配置端口。 */
189
- export function buildWebUiUrl(port: number): string {
190
- return `http://localhost:${port}/`;
191
- }
192
-
193
- interface OpenBrowserDeps {
194
- platform?: NodeJS.Platform;
195
- env?: Environment;
196
- spawnImpl?: typeof spawn;
197
- onError?: (message: string) => void;
198
- onInfo?: (message: string) => void;
199
- }
200
-
201
- /**
202
- * 调用操作系统默认浏览器打开 Web UI,与 Chrome CDP 守护功能完全独立。
203
- * 返回值仅表示打开请求是否成功发起;浏览器是否复用标签页由系统浏览器决定。
204
- */
205
- export function openWebUiInDefaultBrowser(
206
- port: number,
207
- deps: OpenBrowserDeps = {},
208
- ): boolean {
209
- const url = buildWebUiUrl(port);
210
- const platform = deps.platform ?? process.platform;
211
- const env = deps.env ?? process.env;
212
- const spawnImpl = deps.spawnImpl ?? spawn;
213
- const onError = deps.onError ?? ((message: string) => console.error(message));
214
- const onInfo = deps.onInfo ?? ((message: string) => console.log(message));
215
-
216
- // Linux 服务器通常没有图形会话。此时调用 xdg-open 只会制造噪音;
217
- // 直接给出可复制的 SSH 隧道命令,让用户从自己的电脑访问本地 Web UI。
218
- if (platform === "linux" && !env.DISPLAY && !env.WAYLAND_DISPLAY) {
219
- onInfo(
220
- `[WEB-UI] 未检测到 Linux 图形桌面,跳过自动打开浏览器。` +
221
- `可在本机执行 ssh -L ${port}:127.0.0.1:${port} <user>@<server>,` +
222
- `然后访问 ${url}`,
223
- );
224
- return false;
225
- }
226
-
227
- try {
228
- let child: ChildProcess;
229
- if (platform === "win32") {
230
- // `start` 会把第一个带引号的参数当窗口标题,空字符串是必要占位符。
231
- child = spawnImpl("cmd.exe", ["/c", "start", "", url], {
232
- detached: true,
233
- stdio: "ignore",
234
- windowsHide: true,
235
- });
236
- } else if (platform === "darwin") {
237
- child = spawnImpl("open", [url], { detached: true, stdio: "ignore" });
238
- } else {
239
- child = spawnImpl("xdg-open", [url], { detached: true, stdio: "ignore" });
240
- }
241
- child.on("error", (err) => {
242
- onError(`[WEB-UI] 自动打开浏览器失败: ${err.message}`);
243
- });
244
- child.unref();
245
- return true;
246
- } catch (err) {
247
- onError(`[WEB-UI] 自动打开浏览器失败: ${(err as Error).message}`);
248
- return false;
249
- }
250
- }
1
+ import { spawn, type ChildProcess } from "node:child_process";
2
+
3
+ const DEFAULT_SERVICE_HEALTH_INTERVAL_MS = 10_000;
4
+
5
+ interface RefTimer {
6
+ ref?: () => unknown;
7
+ }
8
+
9
+ export interface ServiceLifecycleServer {
10
+ listening: boolean;
11
+ address: () => unknown;
12
+ ref: () => unknown;
13
+ }
14
+
15
+ interface ServiceLifecycleGuardOptions {
16
+ intervalMs?: number;
17
+ setIntervalImpl?: (callback: () => void, delayMs: number) => RefTimer;
18
+ clearIntervalImpl?: (timer: RefTimer) => void;
19
+ tracer?: (message: string, extra?: Record<string, unknown>) => void;
20
+ getActiveResourcesInfo?: () => string[];
21
+ }
22
+
23
+ export interface ServiceLifecycleGuard {
24
+ start: () => void;
25
+ attachServer: (
26
+ server: ServiceLifecycleServer,
27
+ recoverServer?: () => void | Promise<void>,
28
+ ) => void;
29
+ checkNow: () => Promise<void>;
30
+ handleBeforeExit: (code: number) => void;
31
+ beginShutdown: (reason: string) => void;
32
+ }
33
+
34
+ /**
35
+ * 为 ChatCCC 这种常驻服务建立一个明确的进程生命周期锚点。
36
+ *
37
+ * 正常情况下,正在 listen 的 HTTP Server 自己就足以维持事件循环;额外的
38
+ * referenced timer 是最后一道保险,避免某个依赖升级或异常 close/unref 让进程在
39
+ * 没有信号、异常或退出码的情况下静默消失。定时检查同时会重新 ref Server,并在
40
+ * Server 确实停止监听时串行触发恢复,避免只把一个失去服务能力的僵尸进程留下来。
41
+ */
42
+ export function createServiceLifecycleGuard(
43
+ options: ServiceLifecycleGuardOptions = {},
44
+ ): ServiceLifecycleGuard {
45
+ const intervalMs = options.intervalMs ?? DEFAULT_SERVICE_HEALTH_INTERVAL_MS;
46
+ const setIntervalImpl = options.setIntervalImpl
47
+ ?? ((callback, delayMs) => setInterval(callback, delayMs));
48
+ const clearIntervalImpl = options.clearIntervalImpl
49
+ ?? ((timer) => clearInterval(timer as NodeJS.Timeout));
50
+ const tracer = options.tracer ?? (() => {});
51
+ const getActiveResourcesInfo = options.getActiveResourcesInfo
52
+ ?? (() => process.getActiveResourcesInfo());
53
+
54
+ let timer: RefTimer | null = null;
55
+ let server: ServiceLifecycleServer | null = null;
56
+ let recoverServer: (() => void | Promise<void>) | undefined;
57
+ let recoveryPromise: Promise<void> | null = null;
58
+ let shuttingDown = false;
59
+
60
+ const trace = (message: string, extra?: Record<string, unknown>): void => {
61
+ try { tracer(message, extra); } catch { /* 诊断路径不能反过来打断服务 */ }
62
+ };
63
+
64
+ const serverAddress = (): unknown => {
65
+ try { return server?.address() ?? null; } catch { return null; }
66
+ };
67
+
68
+ const activeResources = (): string[] => {
69
+ try { return getActiveResourcesInfo(); } catch { return []; }
70
+ };
71
+
72
+ const diagnostics = (extra: Record<string, unknown> = {}): Record<string, unknown> => ({
73
+ ...extra,
74
+ uptimeSeconds: Math.floor(process.uptime()),
75
+ activeResources: activeResources(),
76
+ serverAttached: server !== null,
77
+ serverListening: server?.listening ?? false,
78
+ serverAddress: serverAddress(),
79
+ });
80
+
81
+ const start = (): void => {
82
+ if (shuttingDown || timer) return;
83
+ timer = setIntervalImpl(() => { void checkNow(); }, intervalMs);
84
+ // Node 的 Timeout 默认就是 ref 状态;显式 ref 让常驻服务契约不会依赖默认值。
85
+ try { timer.ref?.(); } catch { /* ignore */ }
86
+ trace("service-lifecycle: guard started", { intervalMs });
87
+ };
88
+
89
+ const checkNow = async (): Promise<void> => {
90
+ if (shuttingDown || !server) return;
91
+ if (server.listening) {
92
+ try { server.ref(); } catch (err) {
93
+ trace("service-lifecycle: HTTP server ref failed", diagnostics({
94
+ error: (err as Error).message,
95
+ }));
96
+ }
97
+ return;
98
+ }
99
+
100
+ if (recoveryPromise) return recoveryPromise;
101
+ trace("service-lifecycle: HTTP server inactive", diagnostics());
102
+ if (!recoverServer) return;
103
+
104
+ recoveryPromise = Promise.resolve()
105
+ .then(() => recoverServer?.())
106
+ .then(() => {
107
+ if (server?.listening) {
108
+ try { server.ref(); } catch { /* 下一轮健康检查会再次尝试 */ }
109
+ trace("service-lifecycle: HTTP server recovered", diagnostics());
110
+ } else {
111
+ trace("service-lifecycle: HTTP recovery completed without listening", diagnostics());
112
+ }
113
+ })
114
+ .catch((err: unknown) => {
115
+ trace("service-lifecycle: HTTP server recovery failed", diagnostics({
116
+ error: err instanceof Error ? err.message : String(err),
117
+ }));
118
+ })
119
+ .finally(() => {
120
+ recoveryPromise = null;
121
+ });
122
+ return recoveryPromise;
123
+ };
124
+
125
+ const attachServer = (
126
+ nextServer: ServiceLifecycleServer,
127
+ nextRecoverServer?: () => void | Promise<void>,
128
+ ): void => {
129
+ server = nextServer;
130
+ recoverServer = nextRecoverServer;
131
+ if (server.listening) {
132
+ try { server.ref(); } catch { /* 下一轮健康检查会记录 */ }
133
+ }
134
+ trace("service-lifecycle: HTTP server attached", diagnostics());
135
+ };
136
+
137
+ const handleBeforeExit = (code: number): void => {
138
+ if (shuttingDown) return;
139
+ trace("service-lifecycle: unexpected beforeExit", diagnostics({ code }));
140
+ start();
141
+ void checkNow();
142
+ };
143
+
144
+ const beginShutdown = (reason: string): void => {
145
+ if (shuttingDown) return;
146
+ shuttingDown = true;
147
+ if (timer) {
148
+ try { clearIntervalImpl(timer); } catch { /* process 即将退出 */ }
149
+ timer = null;
150
+ }
151
+ trace("service-lifecycle: shutdown requested", { reason });
152
+ };
153
+
154
+ return { start, attachServer, checkNow, handleBeforeExit, beginShutdown };
155
+ }
156
+
157
+ /**
158
+ * ChatCCC 自己拉起替代进程时使用的内部标记。
159
+ *
160
+ * 不能用“是否已有配置”判断是否打开控制台:首次配置和日常直接启动都应该
161
+ * 打开,而 `/restart`、`/update` 和 Web UI 重启都不应该打扰用户。环境变量
162
+ * 会自然穿过 cmd/bash/npx 这几层启动器,因此也适用于 Windows 与 Linux。
163
+ */
164
+ export const INTERNAL_RESTART_ENV_VAR = "CHATCCC_INTERNAL_RESTART";
165
+
166
+ type Environment = Record<string, string | undefined>;
167
+
168
+ export function createInternalRestartEnv(
169
+ inherited: Environment = process.env,
170
+ ): NodeJS.ProcessEnv {
171
+ return {
172
+ ...inherited,
173
+ [INTERNAL_RESTART_ENV_VAR]: "1",
174
+ };
175
+ }
176
+
177
+ /** 用户直接启动时打开;ChatCCC 内部重启产生的替代进程不打开。 */
178
+ interface AutoOpenWebUiOptions {
179
+ env?: Environment;
180
+ openOnStart?: boolean;
181
+ }
182
+
183
+ export function shouldAutoOpenWebUi(options: AutoOpenWebUiOptions = {}): boolean {
184
+ const env = options.env ?? process.env;
185
+ return options.openOnStart !== false && env[INTERNAL_RESTART_ENV_VAR] !== "1";
186
+ }
187
+
188
+ /** Web UI 始终使用 localhost,并跟随实际配置端口。 */
189
+ export function buildWebUiUrl(port: number): string {
190
+ return `http://localhost:${port}/`;
191
+ }
192
+
193
+ interface OpenBrowserDeps {
194
+ platform?: NodeJS.Platform;
195
+ env?: Environment;
196
+ spawnImpl?: typeof spawn;
197
+ onError?: (message: string) => void;
198
+ onInfo?: (message: string) => void;
199
+ }
200
+
201
+ /**
202
+ * 调用操作系统默认浏览器打开 Web UI,与 Chrome CDP 守护功能完全独立。
203
+ * 返回值仅表示打开请求是否成功发起;浏览器是否复用标签页由系统浏览器决定。
204
+ */
205
+ export function openWebUiInDefaultBrowser(
206
+ port: number,
207
+ deps: OpenBrowserDeps = {},
208
+ ): boolean {
209
+ const url = buildWebUiUrl(port);
210
+ const platform = deps.platform ?? process.platform;
211
+ const env = deps.env ?? process.env;
212
+ const spawnImpl = deps.spawnImpl ?? spawn;
213
+ const onError = deps.onError ?? ((message: string) => console.error(message));
214
+ const onInfo = deps.onInfo ?? ((message: string) => console.log(message));
215
+
216
+ // Linux 服务器通常没有图形会话。此时调用 xdg-open 只会制造噪音;
217
+ // 直接给出可复制的 SSH 隧道命令,让用户从自己的电脑访问本地 Web UI。
218
+ if (platform === "linux" && !env.DISPLAY && !env.WAYLAND_DISPLAY) {
219
+ onInfo(
220
+ `[WEB-UI] 未检测到 Linux 图形桌面,跳过自动打开浏览器。` +
221
+ `可在本机执行 ssh -L ${port}:127.0.0.1:${port} <user>@<server>,` +
222
+ `然后访问 ${url}`,
223
+ );
224
+ return false;
225
+ }
226
+
227
+ try {
228
+ let child: ChildProcess;
229
+ if (platform === "win32") {
230
+ // `start` 会把第一个带引号的参数当窗口标题,空字符串是必要占位符。
231
+ child = spawnImpl("cmd.exe", ["/c", "start", "", url], {
232
+ detached: true,
233
+ stdio: "ignore",
234
+ windowsHide: true,
235
+ });
236
+ } else if (platform === "darwin") {
237
+ child = spawnImpl("open", [url], { detached: true, stdio: "ignore" });
238
+ } else {
239
+ child = spawnImpl("xdg-open", [url], { detached: true, stdio: "ignore" });
240
+ }
241
+ child.on("error", (err) => {
242
+ onError(`[WEB-UI] 自动打开浏览器失败: ${err.message}`);
243
+ });
244
+ child.unref();
245
+ return true;
246
+ } catch (err) {
247
+ onError(`[WEB-UI] 自动打开浏览器失败: ${(err as Error).message}`);
248
+ return false;
249
+ }
250
+ }
@@ -1,10 +1,10 @@
1
1
  import { readFile, writeFile, mkdir, rename, unlink } from "node:fs/promises";
2
2
  import { dirname, join } from "node:path";
3
3
 
4
- import { USER_DATA_DIR, ts } from "./config.ts";
5
- import { createAgentActivityTracker } from "./agent-activity.ts";
6
- import type { AgentActivity } from "./agent-activity.ts";
7
- import type { TerminalErrorInfo } from "./terminal-error.ts";
4
+ import { USER_DATA_DIR, ts } from "./config.ts";
5
+ import { createAgentActivityTracker } from "./agent-activity.ts";
6
+ import type { AgentActivity } from "./agent-activity.ts";
7
+ import type { TerminalErrorInfo } from "./terminal-error.ts";
8
8
 
9
9
  // ---------------------------------------------------------------------------
10
10
  // stream-state.json — 每个 session 的流式输出持久化文件
@@ -14,14 +14,14 @@ export const STREAMS_DIR = join(USER_DATA_DIR, "state", "streams");
14
14
 
15
15
  export interface StreamState {
16
16
  sessionId: string;
17
- status: "running" | "done" | "stopped" | "error" | "auto_ended";
17
+ status: "running" | "done" | "stopped" | "error" | "auto_ended";
18
18
  accumulatedContent: string;
19
19
  /** 本轮会话中 LLM 输出的全部文本内容(所有 text block 的累加)。
20
20
  * 命名含 "final" 但实为"全部累积文本",并非仅"最终一段回复"。
21
21
  * 参见 session.ts 的 AccumulatorState 注释。 */
22
- finalReply: string;
23
- /** Current user-visible work phase for running progress cards. */
24
- activity?: AgentActivity;
22
+ finalReply: string;
23
+ /** Current user-visible work phase for running progress cards. */
24
+ activity?: AgentActivity;
25
25
  /** The turn whose terminal text reply has already been delivered to IM. */
26
26
  finalReplySentTurn?: number;
27
27
  finalReplySentAt?: number;
@@ -33,12 +33,12 @@ export interface StreamState {
33
33
  tool: string;
34
34
  /** Set by stop-stuck-loop to prevent the session from being resumed.
35
35
  * The orchestrator checks this before resuming and creates a new session instead. */
36
- stuckAt?: number;
37
- /** Set when the shared response watchdog ends a turn after three minutes without new characters. */
38
- autoEndedAt?: number;
39
- /** 脱敏后的用户可见根因;完整原始异常只保留在运行日志中。 */
40
- terminalError?: TerminalErrorInfo;
41
- }
36
+ stuckAt?: number;
37
+ /** Set when the shared response watchdog ends a turn after three minutes without new characters. */
38
+ autoEndedAt?: number;
39
+ /** 脱敏后的用户可见根因;完整原始异常只保留在运行日志中。 */
40
+ terminalError?: TerminalErrorInfo;
41
+ }
42
42
 
43
43
  function getStreamStatePath(sessionId: string): string {
44
44
  return join(STREAMS_DIR, `${sessionId}.json`);
@@ -131,18 +131,18 @@ export async function markFinalReplySent(sessionId: string, turnCount: number, s
131
131
  await writeStreamState(state);
132
132
  }
133
133
 
134
- export function createEmptyStreamState(sessionId: string, cwd: string, tool: string, turnCount: number): StreamState {
135
- const now = Date.now();
136
- return {
134
+ export function createEmptyStreamState(sessionId: string, cwd: string, tool: string, turnCount: number): StreamState {
135
+ const now = Date.now();
136
+ return {
137
137
  sessionId,
138
138
  status: "running",
139
- accumulatedContent: "",
140
- finalReply: "",
141
- activity: createAgentActivityTracker(now).activity,
139
+ accumulatedContent: "",
140
+ finalReply: "",
141
+ activity: createAgentActivityTracker(now).activity,
142
142
  chunkCount: 0,
143
143
  turnCount,
144
144
  contextTokens: 0,
145
- updatedAt: now,
145
+ updatedAt: now,
146
146
  cwd,
147
147
  tool,
148
148
  };