chatccc 0.2.259 → 0.2.261

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "chatccc",
3
- "version": "0.2.259",
3
+ "version": "0.2.261",
4
4
  "description": "Feishu bot bridge for Claude Code",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -1,249 +0,0 @@
1
- // =============================================================================
2
- // claude-sdk-installer.ts — Claude Code 引擎(Agent SDK)按需安装器
3
- // =============================================================================
4
- // 背景:@anthropic-ai/claude-agent-sdk 通过 optionalDependencies 内置各平台
5
- // 的原生 CLI 二进制(Windows 上 claude.exe 约 215MB),若作为 chatccc 的硬依赖,
6
- // 所有用户(包括不用 Claude Code 的)都要白白下载 220MB+。
7
- //
8
- // 方案:把 SDK 从 chatccc 的 dependencies 中移除,改为**按需安装**到
9
- // `~/.chatccc/claude-sdk/`:
10
- // - 用户未启用 Claude Code → 完全不下载,npm 包体积大幅下降;
11
- // - 用户在设置页打开 Claude Code 开关时,点「安装引擎」触发后台安装,
12
- // 带进度条(状态式:检测环境 → 下载中 → 安装中 → 完成/失败)。
13
- //
14
- // 设计约束:
15
- // - **不 import config.ts**(config.ts 顶层有 loadConfig 副作用,web-ui.ts
16
- // 依赖本模块,间接 import config.ts 会污染依赖 web-ui.ts 的单测)。
17
- // - 始终使用 SDK 内置的 CLI 二进制(用户拍板档位 b),不依赖用户自装 CLI。
18
- // - 安装目录可注入(dir 参数),便于单测用临时目录,不碰真实用户目录。
19
- // =============================================================================
20
- import { spawn } from "node:child_process";
21
- import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
22
- import { homedir } from "node:os";
23
- import { join } from "node:path";
24
- /** 与当前代码配套的 SDK 版本(package.json 移除依赖后此常量成为唯一版本来源) */
25
- export const CLAUDE_SDK_VERSION = "0.2.133";
26
- /** 按需安装目录:~/.chatccc/claude-sdk */
27
- export const CLAUDE_SDK_DIR = join(homedir(), ".chatccc", "claude-sdk");
28
- const SDK_PKG_REL = join("node_modules", "@anthropic-ai", "claude-agent-sdk", "package.json");
29
- const SDK_ENTRY_REL = join("node_modules", "@anthropic-ai", "claude-agent-sdk", "sdk.mjs");
30
- const LOCK_FILE = ".installing";
31
- /** 估算的完整安装体积(含内置 CLI 二进制),用于进度条展示 */
32
- export const CLAUDE_SDK_EXPECTED_BYTES = 240 * 1024 * 1024;
33
- // ---------------------------------------------------------------------------
34
- // 状态查询
35
- // ---------------------------------------------------------------------------
36
- /** SDK 入口文件绝对路径(供动态 import) */
37
- export function getClaudeSdkEntryPath(dir = CLAUDE_SDK_DIR) {
38
- return join(dir, SDK_ENTRY_REL);
39
- }
40
- /** 是否已安装(node_modules 里存在 SDK package.json 即视为已装) */
41
- export function isClaudeSdkInstalled(dir = CLAUDE_SDK_DIR) {
42
- return existsSync(join(dir, SDK_PKG_REL));
43
- }
44
- /** 已安装版本号;未安装/解析失败返回 null */
45
- export function getClaudeSdkInstalledVersion(dir = CLAUDE_SDK_DIR) {
46
- try {
47
- const raw = readFileSync(join(dir, SDK_PKG_REL), "utf8");
48
- const pkg = JSON.parse(raw);
49
- return typeof pkg.version === "string" ? pkg.version : null;
50
- }
51
- catch {
52
- return null;
53
- }
54
- }
55
- /** 是否正在安装(锁文件存在且 pid 存活);pid 已死视为过期锁并自动清理 */
56
- export function isClaudeSdkInstalling(dir = CLAUDE_SDK_DIR) {
57
- const lockPath = join(dir, LOCK_FILE);
58
- if (!existsSync(lockPath))
59
- return false;
60
- try {
61
- const pid = Number.parseInt(readFileSync(lockPath, "utf8").trim(), 10);
62
- if (Number.isFinite(pid) && pid > 0 && isPidAlive(pid))
63
- return true;
64
- }
65
- catch {
66
- // 锁文件损坏 → 按过期处理,走清理
67
- }
68
- try {
69
- unlinkSync(lockPath);
70
- }
71
- catch {
72
- // 清理失败不阻塞判断
73
- }
74
- return false;
75
- }
76
- function isPidAlive(pid) {
77
- try {
78
- process.kill(pid, 0);
79
- return true;
80
- }
81
- catch (err) {
82
- return err.code === "EPERM";
83
- }
84
- }
85
- // ---------------------------------------------------------------------------
86
- // 安装(后台任务 + 进度)
87
- // ---------------------------------------------------------------------------
88
- /** 最近一次安装的进度快照,供 web-ui 轮询 */
89
- let lastProgress = { phase: "idle", percent: 0, message: "" };
90
- let installInProgress = false;
91
- export function getLastInstallProgress() {
92
- return { ...lastProgress, ...(lastProgress.error ? { error: lastProgress.error } : {}) };
93
- }
94
- export function isInstallRunning() {
95
- return installInProgress;
96
- }
97
- function setProgress(p, onProgress) {
98
- lastProgress = { ...p };
99
- onProgress?.(lastProgress);
100
- }
101
- /**
102
- * 启动按需安装。返回 Promise,安装完成 resolve、失败 reject。
103
- * 调用方通常不 await(后台执行),通过 onProgress / getLastInstallProgress() 获取进度。
104
- */
105
- export async function installClaudeSdk(options = {}) {
106
- const dir = options.dir ?? CLAUDE_SDK_DIR;
107
- const npmCommand = options.npmCommand ?? "npm";
108
- const expected = options.expectedVersion ?? CLAUDE_SDK_VERSION;
109
- const onProgress = options.onProgress;
110
- if (installInProgress) {
111
- throw new Error("Claude Code 引擎正在安装中,请等待完成后再试。");
112
- }
113
- if (isClaudeSdkInstalling(dir)) {
114
- throw new Error("检测到另一个安装任务正在进行(锁文件存在),请稍后再试。");
115
- }
116
- const installedVersion = isClaudeSdkInstalled(dir) ? getClaudeSdkInstalledVersion(dir) : null;
117
- if (installedVersion === expected) {
118
- setProgress({ phase: "done", percent: 100, message: `已安装 v${installedVersion}` }, onProgress);
119
- return;
120
- }
121
- if (installedVersion !== null && installedVersion !== expected) {
122
- setProgress({
123
- phase: "detecting",
124
- percent: 3,
125
- message: `已装 v${installedVersion} ≠ 期望 v${expected},开始重装…`,
126
- }, onProgress);
127
- }
128
- installInProgress = true;
129
- mkdirSync(dir, { recursive: true });
130
- writeFileSync(join(dir, LOCK_FILE), String(process.pid), "utf8");
131
- setProgress({ phase: "detecting", percent: 2, message: "检测环境…" }, onProgress);
132
- return new Promise((resolve, reject) => {
133
- const child = spawn(npmCommand, [
134
- "install",
135
- "--prefix",
136
- dir,
137
- `@anthropic-ai/claude-agent-sdk@${expected}`,
138
- "--no-audit",
139
- "--no-fund",
140
- "--loglevel=http",
141
- ], {
142
- stdio: ["ignore", "pipe", "pipe"],
143
- windowsHide: true,
144
- // Windows 下 npm 是 npm.cmd,需要 shell 才能解析
145
- shell: process.platform === "win32",
146
- });
147
- let stderrBuf = "";
148
- let requestCount = 0;
149
- let sizeTimer = null;
150
- const updateBySize = () => {
151
- const size = dirSizeBytes(dir);
152
- const sizePercent = Math.min((size / CLAUDE_SDK_EXPECTED_BYTES) * 90, 90);
153
- const requestPercent = Math.min(5 + requestCount * 4, 70);
154
- const percent = Math.max(sizePercent, requestPercent);
155
- const mb = (size / 1048576).toFixed(0);
156
- setProgress({
157
- phase: "downloading",
158
- percent: Math.min(percent, 94),
159
- message: `下载中… 已下载 ${mb} MB / 约 220 MB`,
160
- }, onProgress);
161
- };
162
- child.stdout.on("data", (chunk) => {
163
- const text = chunk.toString();
164
- // npm --loglevel=http 每完成一个请求输出一行 "npm http fetch GET 200 ..."
165
- requestCount += (text.match(/http fetch GET|GET \d{3}/g) ?? []).length;
166
- updateBySize();
167
- });
168
- child.stderr.on("data", (chunk) => {
169
- stderrBuf += chunk.toString();
170
- });
171
- child.on("error", (err) => {
172
- cleanupAfterFailure(dir, err, onProgress, () => {
173
- installInProgress = false;
174
- reject(err);
175
- });
176
- });
177
- child.on("close", (code) => {
178
- if (sizeTimer)
179
- clearInterval(sizeTimer);
180
- if (code === 0 && isClaudeSdkInstalled(dir)) {
181
- const version = getClaudeSdkInstalledVersion(dir);
182
- installInProgress = false;
183
- try {
184
- unlinkSync(join(dir, LOCK_FILE));
185
- }
186
- catch {
187
- // 锁文件不存在可忽略
188
- }
189
- setProgress({ phase: "done", percent: 100, message: `安装完成(v${version ?? expected})` }, onProgress);
190
- resolve();
191
- }
192
- else {
193
- const tail = stderrBuf.trim().split("\n").slice(-5).join(" | ");
194
- const detail = code !== 0 ? `npm 退出码 ${code}` : "安装后校验未通过";
195
- const message = tail ? `${detail}:${tail.slice(0, 400)}` : detail;
196
- cleanupAfterFailure(dir, new Error(message), onProgress, () => {
197
- installInProgress = false;
198
- reject(new Error(message));
199
- });
200
- }
201
- });
202
- // 定期按目录体积刷新进度(大文件下载时 stdout 事件稀疏)
203
- sizeTimer = setInterval(() => {
204
- if (installInProgress)
205
- updateBySize();
206
- }, 400);
207
- if (typeof sizeTimer.unref === "function")
208
- sizeTimer.unref();
209
- });
210
- }
211
- function cleanupAfterFailure(dir, err, onProgress, after) {
212
- setProgress({ phase: "error", percent: 0, message: "安装失败", error: err.message.slice(0, 500) }, onProgress);
213
- try {
214
- rmSync(dir, { recursive: true, force: true });
215
- }
216
- catch {
217
- // 清理失败不阻塞
218
- }
219
- after();
220
- }
221
- function dirSizeBytes(dir) {
222
- let total = 0;
223
- const stack = [dir];
224
- while (stack.length > 0) {
225
- const current = stack.pop();
226
- let entries;
227
- try {
228
- entries = readdirSync(current, { withFileTypes: true });
229
- }
230
- catch {
231
- continue;
232
- }
233
- for (const entry of entries) {
234
- const full = join(current, entry.name);
235
- if (entry.isDirectory()) {
236
- stack.push(full);
237
- }
238
- else if (entry.isFile()) {
239
- try {
240
- total += statSync(full).size;
241
- }
242
- catch {
243
- // 文件被并发删除可忽略
244
- }
245
- }
246
- }
247
- }
248
- return total;
249
- }