@hit-sudomaker/ccw 0.4.1 → 0.5.0

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/dist/work.js ADDED
@@ -0,0 +1,135 @@
1
+ import { errorCode } from './machine.js';
2
+ import { cancelled } from './model.js';
3
+ /**
4
+ * 构造先观察、至多派发一次、再核验的执行步骤
5
+ *
6
+ * @param changes - 准备时可展示的变更说明
7
+ * @param check - 只读核验函数;接收执行历史并返回当前事实
8
+ * @param apply - 可选写入函数;接收取消信号及独立核验能力,返回回执
9
+ * @returns 延迟执行并保存核验结果的步骤
10
+ * @remarks 写入异常先记为未知回执,仍可通过事实核验确认完成;成功退出码也不单独证明完成
11
+ * 目标漂移后不自动重发
12
+ */
13
+ export function step(changes, check, apply) {
14
+ let attempt = {};
15
+ let complete = false;
16
+ let effects = [];
17
+ let problem;
18
+ const assess = async () => {
19
+ try {
20
+ return await check(attempt);
21
+ }
22
+ catch (error) {
23
+ return { state: 'blocked', problem: errorCode(error) };
24
+ }
25
+ };
26
+ const accept = (result) => {
27
+ complete = result.state === 'complete';
28
+ problem = result.state === 'blocked' ? result.problem : undefined;
29
+ if (result.state === 'complete') {
30
+ attempt = { ...attempt, confirmed: true };
31
+ effects = result.effects ?? effects;
32
+ }
33
+ };
34
+ return {
35
+ changes,
36
+ result: () => ({ complete, effects, problems: problem ? [problem] : [] }),
37
+ async run(execution, allowed = true) {
38
+ cancelled(execution.signal);
39
+ if (!allowed) {
40
+ problem = 'dependency-not-ready';
41
+ return;
42
+ }
43
+ const before = await assess();
44
+ accept(before);
45
+ if (before.state !== 'ready') {
46
+ for (const effect of effects)
47
+ execution.report(effect);
48
+ return;
49
+ }
50
+ if (!apply || attempt.dispatched) {
51
+ problem = 'operation-unconfirmed';
52
+ return;
53
+ }
54
+ execution.started();
55
+ cancelled(execution.signal);
56
+ attempt = { ...attempt, dispatched: true };
57
+ let outcome;
58
+ try {
59
+ outcome = await execution.perform(() => apply(execution.signal, read => execution.verify(read)));
60
+ }
61
+ catch (error) {
62
+ outcome = { receipt: { kind: 'unknown', failure: errorCode(error) } };
63
+ }
64
+ attempt = { ...attempt, receipt: outcome.receipt };
65
+ effects = outcome.effects ?? [];
66
+ for (const effect of effects)
67
+ execution.report(effect);
68
+ const after = await execution.verify(assess);
69
+ const reported = effects;
70
+ accept(after);
71
+ if (after.state === 'ready')
72
+ problem = outcome.receipt.failure ?? 'operation-unconfirmed';
73
+ for (const effect of effects)
74
+ if (!reported.some(previous => previous.code === effect.code && previous.state === effect.state && previous.detail === effect.detail))
75
+ execution.report(effect);
76
+ },
77
+ async verify() {
78
+ if (complete) {
79
+ const result = await assess();
80
+ accept(result);
81
+ if (result.state === 'ready')
82
+ problem = 'target-changed';
83
+ }
84
+ },
85
+ };
86
+ }
87
+ /**
88
+ * 按次序执行独立子项,结果中记录的失败不阻断其他项
89
+ *
90
+ * @param children - 本次执行的子项,空数组表示无变更
91
+ * @returns 汇总全部子项状态与效果的工作项
92
+ * @remarks 子项 run 的拒绝会中止后续项;已发生的效果不回滚
93
+ */
94
+ export const work = (children) => combine(children, false);
95
+ /**
96
+ * 按前置依赖执行子项,前项未就绪时阻止后继写入
97
+ *
98
+ * @param children - 按依赖先后排列的子项
99
+ * @returns 保留已发生效果并汇总依赖问题的工作项
100
+ */
101
+ export const sequence = (children) => combine(children, true);
102
+ /** 汇总子步骤;顺序流程在每个后继步骤前重新核验前置项 */
103
+ function combine(children, sequential) {
104
+ return {
105
+ changes: children.flatMap(child => child.changes),
106
+ result: () => {
107
+ const results = children.map(child => child.result());
108
+ const problems = results.flatMap(result => result.problems);
109
+ return {
110
+ complete: results.every(result => result.complete),
111
+ effects: results.flatMap(result => result.effects),
112
+ problems: problems.some(problem => problem !== 'dependency-not-ready')
113
+ ? problems.filter(problem => problem !== 'dependency-not-ready')
114
+ : problems,
115
+ };
116
+ },
117
+ async run(execution, allowed = true) {
118
+ let ready = allowed;
119
+ let previous;
120
+ for (const child of children) {
121
+ if (sequential && previous) {
122
+ const predecessor = previous;
123
+ await execution.verify(() => predecessor.verify());
124
+ ready &&= predecessor.result().complete;
125
+ }
126
+ await child.run(execution, ready);
127
+ previous = child;
128
+ }
129
+ },
130
+ async verify() {
131
+ for (const child of children)
132
+ await child.verify();
133
+ },
134
+ };
135
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hit-sudomaker/ccw",
3
- "version": "0.4.1",
3
+ "version": "0.5.0",
4
4
  "description": "Claude Code lifecycle management terminal",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -36,7 +36,6 @@
36
36
  "dependencies": {
37
37
  "ink": "8.0.0",
38
38
  "react": "19.3.1",
39
- "smol-toml": "1.9.1",
40
39
  "string-width": "8.3.0",
41
40
  "wrap-ansi": "10.0.2"
42
41
  },
@@ -1,349 +0,0 @@
1
- import { knownTitle } from './titles.js';
2
- import { isObject } from './machine.js';
3
- import { apiConfigurationProblem, cancelled, json, object, sequence, success, unchanged } from './model.js';
4
- import { claudeCommand, prepareProgram, programs } from './programs.js';
5
- /** 创建 Claude 程序域渠道:裸 id 与 claude: 余段 id 都归本域 */
6
- export function createClaudeDomain(ctx) {
7
- return {
8
- inspect: () => inspectClaudePrograms(ctx),
9
- prepare: selection => prepareClaudeProgram(ctx, selection),
10
- };
11
- }
12
- /** 创建设置域渠道:settings 无前缀单项入口,检查归一为聚合 */
13
- export function createSettingsDomain(ctx) {
14
- return {
15
- async inspect() {
16
- return { items: [await inspectSettings(ctx)], problems: [] };
17
- },
18
- prepare: selection => {
19
- if (selection.id !== 'settings')
20
- throw new Error('unknown-selection');
21
- return prepareSettings(ctx, selection);
22
- },
23
- };
24
- }
25
- /** 检查 Claude 程序:实际副本,或无副本时的同形方案壳 */
26
- async function inspectClaudePrograms(ctx) {
27
- const found = await programs(ctx, 'claude');
28
- return {
29
- items: found.items.length
30
- ? found.items
31
- : [
32
- {
33
- id: 'claude',
34
- title: knownTitle('claude'),
35
- kind: 'claude',
36
- canInstall: true,
37
- facts: [{ code: found.problems.length ? 'inspection-incomplete' : 'not-installed' }],
38
- actions: ['install'],
39
- },
40
- ],
41
- problems: found.problems.map(code => ({ code, detail: 'claude' })),
42
- };
43
- }
44
- /** 编排 Claude 程序准备:实例解析、保留分支复核与默认偏好合并 */
45
- async function prepareClaudeProgram(ctx, selection) {
46
- const { id, action } = selection;
47
- const kind = 'claude';
48
- const found = await programs(ctx, kind);
49
- const program = found.values.get(id) ?? (id === kind && found.values.size === 1 ? [...found.values.values()][0] : undefined);
50
- if (id !== kind && program === undefined)
51
- throw new Error('program-changed');
52
- if (id === kind && found.values.size > 1)
53
- throw new Error('program-selection-required');
54
- if (found.problems.length && !(action === 'uninstall' && program && program.channel !== 'npm'))
55
- throw new Error('installation-state-unconfirmed');
56
- if (action === 'detach')
57
- throw new Error('action-unavailable');
58
- const programStamp = program ? await ctx.machine.treeStamp(program.binary) : null;
59
- // 两次读取之间二进制消失时不允许"保留程序"空转通过
60
- if (action === 'install' && program && !program.isMissing && programStamp === null)
61
- throw new Error('program-changed');
62
- const operation = action === 'install' && program && !program.isMissing
63
- ? {
64
- targetVersion: program.version,
65
- changes: [{ code: 'program-kept' }],
66
- async run(report) {
67
- if ((await ctx.machine.treeStamp(program.binary)) !== programStamp)
68
- throw new Error('program-changed');
69
- report({ state: 'kept', code: 'program-kept' });
70
- },
71
- async verify() {
72
- if ((await ctx.machine.treeStamp(program.binary)) !== programStamp)
73
- throw new Error('program-changed');
74
- },
75
- }
76
- : await prepareProgram(ctx, kind, selection, program);
77
- if ((action !== 'install' && action !== 'reinstall') || (action === 'install' && program && !program.isMissing))
78
- return operation;
79
- const defaults = await prepareSettings(ctx, { id: 'settings', action: 'configure' });
80
- return sequence([operation, defaults]);
81
- }
82
- // 保留字段只定位已有键;偏好默认值由编辑器提交,不能变成 initializer 默认值
83
- /** settings 内用户插件启停表的键名:字段表、插件域与配套插件探测共用 */
84
- export const ENABLED_PLUGINS_KEY = 'enabledPlugins';
85
- const ROOT_FIELDS = {
86
- $schema: { placement: 'prefix', role: 'preserve' },
87
- defaultShell: { placement: 'prefix', role: 'preserve' },
88
- permissions: { placement: 'prefix', role: 'preserve' },
89
- includeCoAuthoredBy: { placement: 'prefix', role: 'preserve' },
90
- attribution: { placement: 'prefix', role: 'attribution', value: { commit: '', pr: '', sessionUrl: false } },
91
- language: { placement: 'prefix', role: 'preference' },
92
- outputStyle: { placement: 'prefix', role: 'preference' },
93
- statusLine: { placement: 'prefix', role: 'preserve' },
94
- [ENABLED_PLUGINS_KEY]: { placement: 'prefix', role: 'preserve' },
95
- autoCompactEnabled: { placement: 'prefix', role: 'preserve' },
96
- autoCompactWindow: { placement: 'prefix', role: 'preserve' },
97
- apiKeyHelper: { placement: 'suffix', role: 'helper' },
98
- env: { placement: 'suffix', role: 'environment' },
99
- model: { placement: 'suffix', role: 'preserve' },
100
- };
101
- const ENV_FIELDS = {
102
- DISABLE_TELEMETRY: { placement: 'prefix', role: 'default', when: 'configure', value: '1' },
103
- DISABLE_ERROR_REPORTING: { placement: 'prefix', role: 'default', when: 'configure', value: '1' },
104
- DISABLE_INSTALLATION_CHECKS: { placement: 'prefix', role: 'default', when: 'configure', value: '1' },
105
- CLAUDE_AUTOCOMPACT_PCT_OVERRIDE: { placement: 'prefix', role: 'default', when: 'configure', value: '80' },
106
- CLAUDE_CODE_USE_POWERSHELL_TOOL: { placement: 'prefix', role: 'default', when: 'win32', value: '1' },
107
- CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: { placement: 'prefix', role: 'default', when: 'configure', value: '1' },
108
- CLAUDE_CODE_ATTRIBUTION_HEADER: { placement: 'prefix', role: 'default', when: 'custom-base', value: '0' },
109
- MCP_TIMEOUT: { placement: 'prefix', role: 'preserve' },
110
- ANTHROPIC_BASE_URL: { placement: 'suffix', role: 'base' },
111
- ANTHROPIC_CUSTOM_HEADERS: { placement: 'suffix', role: 'preserve' },
112
- ANTHROPIC_API_KEY: { placement: 'suffix', role: 'key' },
113
- ANTHROPIC_AUTH_TOKEN: { placement: 'suffix', role: 'token' },
114
- ANTHROPIC_MODEL: { placement: 'suffix', role: 'model', editor: 'model' },
115
- ANTHROPIC_DEFAULT_MODEL: { placement: 'suffix', role: 'preserve' },
116
- ANTHROPIC_DEFAULT_FABLE_MODEL: { placement: 'suffix', role: 'model', editor: 'fable' },
117
- ANTHROPIC_DEFAULT_OPUS_MODEL: { placement: 'suffix', role: 'model', editor: 'opus' },
118
- ANTHROPIC_DEFAULT_SONNET_MODEL: { placement: 'suffix', role: 'model', editor: 'sonnet' },
119
- ANTHROPIC_DEFAULT_HAIKU_MODEL: { placement: 'suffix', role: 'model', editor: 'haiku' },
120
- };
121
- const rootFields = Object.entries(ROOT_FIELDS);
122
- const envFields = Object.entries(ENV_FIELDS);
123
- const connectionKeys = envFields
124
- .filter(([, field]) => ['base', 'key', 'token', 'model'].includes(field.role))
125
- .map(([key]) => key);
126
- const helperKeys = rootFields.filter(([, field]) => field.role === 'helper').map(([key]) => key);
127
- /** 只重排 root/env 自身属性;未知键保持相对顺序,嵌套值保持原样 */
128
- function orderFields(value, fields) {
129
- const known = new Set(fields.map(([key]) => key));
130
- const ordered = Object.fromEntries([
131
- ...fields.filter(([key, field]) => field.placement === 'prefix' && Object.hasOwn(value, key)),
132
- ...Object.entries(value).filter(([key]) => !known.has(key)),
133
- ...fields.filter(([key, field]) => field.placement === 'suffix' && Object.hasOwn(value, key)),
134
- ].map(([key]) => [key, value[key]]));
135
- for (const key of Object.keys(value))
136
- delete value[key];
137
- // JSON 可包含 __proto__;以自身属性重建,不触发原型 setter
138
- Object.defineProperties(value, Object.getOwnPropertyDescriptors(ordered));
139
- }
140
- /** 补齐安装默认值;保留显式值和继承变量声明 */
141
- function initializeDefaults(settings, ctx) {
142
- const env = object(settings.env);
143
- const hasCustomBase = envFields.some(([key, field]) => {
144
- const base = env[key];
145
- return (field.role === 'base' &&
146
- typeof base === 'string' &&
147
- apiConfigurationProblem(base, true) === null &&
148
- new URL(base).hostname !== 'api.anthropic.com');
149
- });
150
- const added = {};
151
- for (const [key, field] of envFields)
152
- if (field.role === 'default' &&
153
- env[key] === undefined &&
154
- !ctx.inheritedKeys?.includes(key) &&
155
- (field.when !== 'win32' || ctx.platform === 'win32') &&
156
- (field.when !== 'custom-base' || hasCustomBase)) {
157
- env[key] = field.value;
158
- added[key] = field.value;
159
- }
160
- settings.env = env;
161
- const root = {};
162
- for (const [key, field] of rootFields)
163
- if (field.role === 'attribution' && settings[key] === undefined && settings.includeCoAuthoredBy !== true) {
164
- settings[key] = { ...field.value };
165
- root[key] = settings[key];
166
- }
167
- // 权限默认模式只在缺失时补齐;已有选择(含更保守模式)不覆盖,allow/ask/deny 原样保留
168
- const permissions = object(settings.permissions);
169
- if (permissions.defaultMode === undefined) {
170
- permissions.defaultMode = 'bypassPermissions';
171
- settings.permissions = permissions;
172
- root.permissions = permissions;
173
- }
174
- return { env: added, root };
175
- }
176
- async function inspectSettings(ctx) {
177
- const settings = await json(ctx.machine, ctx.settingsFile);
178
- const env = object(settings.env);
179
- const hasApiConfiguration = envFields.some(([key, field]) => ['base', 'key', 'token'].includes(field.role) && typeof env[key] === 'string');
180
- const values = {};
181
- // 仅提示本文件的编辑选择,不代表已解析当前会话的认证来源
182
- values.auth = envFields.some(([key, field]) => field.role === 'token' && typeof env[key] === 'string' && env[key] !== '')
183
- ? 'token'
184
- : 'key';
185
- for (const [key, field] of envFields) {
186
- const value = env[key];
187
- if (typeof value === 'string') {
188
- if (field.role === 'base')
189
- values.baseUrl = value;
190
- if (field.role === 'model')
191
- values[field.editor] = value;
192
- }
193
- }
194
- for (const [key, field] of rootFields)
195
- if (field.role === 'preference' && typeof settings[key] === 'string')
196
- values[key] = settings[key];
197
- if (values.baseUrl !== undefined) {
198
- try {
199
- const url = new URL(values.baseUrl);
200
- if (url.username || url.password || url.search || url.hash)
201
- delete values.baseUrl;
202
- }
203
- catch {
204
- delete values.baseUrl;
205
- }
206
- }
207
- return {
208
- id: 'settings',
209
- title: knownTitle('settings'),
210
- kind: 'settings',
211
- canInstall: true,
212
- location: ctx.settingsFile,
213
- values,
214
- facts: [{ code: hasApiConfiguration ? 'api-configured' : 'official-connection' }],
215
- actions: [
216
- 'configure',
217
- 'login',
218
- ...(connectionKeys.some(key => env[key] !== undefined) || helperKeys.some(key => settings[key] !== undefined)
219
- ? ['detach']
220
- : []),
221
- ],
222
- };
223
- }
224
- async function prepareSettings(ctx, selection) {
225
- if (!['configure', 'login', 'detach'].includes(selection.action))
226
- throw new Error('action-unavailable');
227
- const settings = await json(ctx.machine, ctx.settingsFile);
228
- const env = object(settings.env);
229
- if (selection.action === 'detach' &&
230
- !connectionKeys.some(key => env[key] !== undefined) &&
231
- !helperKeys.some(key => settings[key] !== undefined))
232
- throw new Error('no-connection');
233
- const fields = selection.action === 'detach' ? {} : (selection.fields ?? {});
234
- const changes = {};
235
- const preferences = {};
236
- const login = async (report) => {
237
- success(await claudeCommand(ctx, ['auth', 'login'], true), 'login-failed');
238
- const status = JSON.parse(success(await claudeCommand(ctx, ['auth', 'status', '--json'])));
239
- if (!isObject(status) || status.loggedIn !== true)
240
- throw new Error('login-unconfirmed');
241
- report({ state: 'done', code: 'logged-in' });
242
- };
243
- if (selection.action === 'login')
244
- return { changes: [{ code: 'login-browser' }], run: login };
245
- const shouldLogin = fields.mode === 'official' && fields.login === 'yes';
246
- const shouldControlHelper = selection.action === 'detach' || fields.mode === 'official' || fields.mode === 'api';
247
- if (selection.action === 'detach' || fields.mode === 'official') {
248
- for (const key of connectionKeys)
249
- changes[key] = undefined;
250
- }
251
- if (fields.mode === 'api') {
252
- const selectedCredential = fields.auth === 'token' ? 'token' : 'key';
253
- let base = fields.baseUrl?.trim();
254
- let credential = fields.secret?.trim();
255
- for (const [key, field] of envFields) {
256
- const value = env[key];
257
- if (typeof value !== 'string')
258
- continue;
259
- if (field.role === 'base')
260
- base ??= value.trim();
261
- if (field.role === selectedCredential)
262
- credential ||= value;
263
- }
264
- const problem = apiConfigurationProblem(base, Boolean(credential?.trim()));
265
- if (problem)
266
- throw new Error(problem);
267
- for (const [key, field] of envFields) {
268
- if (field.role === 'base')
269
- changes[key] = base;
270
- if (field.role === 'key' || field.role === 'token')
271
- changes[key] = field.role === selectedCredential ? credential : undefined;
272
- }
273
- }
274
- if (shouldControlHelper)
275
- for (const key of helperKeys)
276
- if (settings[key] !== undefined)
277
- preferences[key] = undefined;
278
- for (const [key, field] of envFields)
279
- if (field.role === 'model' && fields[field.editor] !== undefined)
280
- changes[key] = fields[field.editor]?.trim() || undefined;
281
- for (const [key, field] of rootFields)
282
- if (field.role === 'preference' && fields[key] !== undefined)
283
- preferences[key] = fields[key] || undefined;
284
- if ((ctx.inheritedKeys ?? []).some(key => Object.hasOwn(changes, key)))
285
- throw new Error('inherited-configuration-conflict');
286
- let isSaved = false;
287
- let isComplete = false;
288
- let defaults;
289
- const verify = async () => {
290
- const after = await json(ctx.machine, ctx.settingsFile);
291
- for (const [key, value] of Object.entries(changes))
292
- unchanged(object(after.env)[key], value);
293
- for (const [key, value] of Object.entries(preferences))
294
- unchanged(after[key], value);
295
- for (const [key, value] of Object.entries(defaults?.env ?? {}))
296
- unchanged(object(after.env)[key], value);
297
- for (const [key, value] of Object.entries(defaults?.root ?? {}))
298
- unchanged(after[key], value);
299
- };
300
- const operation = {
301
- writes: [ctx.settingsFile],
302
- changes: [
303
- { code: selection.action === 'detach' ? 'settings-disconnect' : 'settings-edit', detail: ctx.settingsFile },
304
- ...(shouldLogin ? [{ code: 'login-browser' }] : []),
305
- ],
306
- async run(report, signal) {
307
- if (isSaved)
308
- await verify();
309
- else {
310
- await ctx.machine.editJson(ctx.settingsFile, current => {
311
- const currentEnv = object(current.env);
312
- if (shouldControlHelper)
313
- for (const key of helperKeys)
314
- unchanged(current[key], settings[key]);
315
- for (const [key, value] of Object.entries(changes)) {
316
- unchanged(currentEnv[key], env[key]);
317
- if (value === undefined)
318
- delete currentEnv[key];
319
- else
320
- currentEnv[key] = value;
321
- }
322
- for (const [key, value] of Object.entries(preferences)) {
323
- unchanged(current[key], settings[key]);
324
- if (value === undefined)
325
- delete current[key];
326
- else
327
- current[key] = value;
328
- }
329
- current.env = currentEnv;
330
- if (selection.action === 'configure')
331
- defaults = initializeDefaults(current, ctx);
332
- orderFields(currentEnv, envFields);
333
- orderFields(current, rootFields);
334
- });
335
- isSaved = true;
336
- report({ state: 'done', code: 'settings-saved' });
337
- await verify();
338
- }
339
- if (shouldLogin) {
340
- cancelled(signal);
341
- await login(report, signal);
342
- }
343
- isComplete = true;
344
- },
345
- remaining: () => (isComplete ? undefined : operation),
346
- verify,
347
- };
348
- return operation;
349
- }
package/dist/collect.js DELETED
@@ -1,147 +0,0 @@
1
- import path from 'node:path';
2
- import { dataSizeDetailOf, isEmptyDataSize } from './cleanup.js';
3
- import { errorCode, isObject } from './machine.js';
4
- import { context, json } from './model.js';
5
- import { BRAND, describeInspection, platformSummary, PROBLEM_MARK, UNCONFIRMED } from './render.js';
6
- import { INSTALL_SCRATCH_PREFIX, disabledDirectory, logsDirectory, readLastRun, replacedDirectory, sourcesFile, } from './storage.js';
7
- import { knownTitle } from './titles.js';
8
- /** 路径折叠:配置根 → <claude>,主目录 → ~;先长后短,且仅折叠后继为分隔符或结尾的完整前缀 */
9
- export function foldText(ctx, text) {
10
- let folded = text;
11
- for (const directory of [ctx.claudeRoot, ctx.home]) {
12
- const token = directory === ctx.claudeRoot ? '<claude>' : '~';
13
- for (const separator of ['\\', '/']) {
14
- const prefix = directory.replaceAll('\\', separator).replaceAll('/', separator);
15
- if (prefix)
16
- folded = folded.replace(new RegExp(`${prefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(?=[\\\\/]|$)`, 'g'), token);
17
- }
18
- }
19
- return folded;
20
- }
21
- /** 凭据打码:常见令牌形态只保留前缀提示 */
22
- export function redactText(text) {
23
- return text
24
- .replace(/(Authorization:\s*\S+\s+)\S+/gi, '$1<redacted>')
25
- .replace(/\b(sk-ant-[A-Za-z0-9_-]{4})[A-Za-z0-9_-]+/g, '$1…<redacted>')
26
- .replace(/\b(ghp_[A-Za-z0-9]{4})[A-Za-z0-9]+/g, '$1…<redacted>')
27
- .replace(/\b(sk-[A-Za-z0-9]{4})[A-Za-z0-9]{8,}\b/g, '$1…<redacted>');
28
- }
29
- async function directoryCount(ctx, directory) {
30
- try {
31
- return (await ctx.machine.entries(directory)).length;
32
- }
33
- catch (error) {
34
- return errorCode(error) === 'ENOENT' ? 0 : null;
35
- }
36
- }
37
- /** 收集诊断日志:只读本地事实,生成一个脱敏报告文件;不上传、不做网络请求 */
38
- export async function collectLogs(ccw, options) {
39
- const ctx = context(options);
40
- // 展示层兜底词:读取未知不用空串或「无」代替
41
- const UNKNOWN = '未知';
42
- // 两路检查顺序执行(各 5 秒预算)
43
- const view = await ccw.inspect('contents');
44
- const data = await ccw.inspect('data');
45
- const problems = [
46
- ...view.problems.map(problem => problem.code),
47
- ...view.items.flatMap(item => (item.problem ? [item.problem] : [])),
48
- ];
49
- const sources = await json(ctx.machine, sourcesFile(ctx)).catch(() => null);
50
- // 记录不可读时保留未知(不以"无历史"代替查无):读取对缺失文件返回空对象,抛错即为损坏或不可读
51
- let lastRun = {};
52
- let lastRunReadable = true;
53
- try {
54
- lastRun = await readLastRun(ctx);
55
- }
56
- catch {
57
- lastRunReadable = false;
58
- }
59
- const runItems = Array.isArray(lastRun.items)
60
- ? lastRun.items.filter(isObject).map(entry => ({
61
- title: typeof entry.title === 'string' ? entry.title : typeof entry.id === 'string' ? entry.id : UNKNOWN,
62
- state: typeof entry.state === 'string' ? entry.state : UNKNOWN,
63
- }))
64
- : [];
65
- const runAt = typeof lastRun.finishedAt === 'string' ? lastRun.finishedAt : undefined;
66
- const runState = typeof lastRun.state === 'string' ? lastRun.state : undefined;
67
- const replaced = await directoryCount(ctx, replacedDirectory(ctx));
68
- const disabled = await directoryCount(ctx, disabledDirectory(ctx));
69
- const storageEntries = await ctx.machine.entries(ctx.storage).catch(() => null);
70
- const installLeftovers = storageEntries?.filter(entry => entry.name.startsWith(INSTALL_SCRATCH_PREFIX)).length ?? null;
71
- const customConfigRoot = ctx.claudeRoot !== path.join(ctx.home, '.claude');
72
- const stamp = new Date();
73
- const environment = [
74
- `生成时间:${stamp.toISOString()}`,
75
- `版本:CCW ${BRAND.versionNumber}`,
76
- `环境:${platformSummary(ctx.platform, ctx.arch ?? process.arch)}${ctx.libc ? ` · ${ctx.libc}` : ''} · Node ${process.version}`,
77
- `配置根:${customConfigRoot ? '自定义(CLAUDE_CONFIG_DIR)' : '默认'} · 状态文件与存储见下方折叠路径`,
78
- ];
79
- const dataLines = data.items.map(item => {
80
- const size = dataSizeDetailOf(item);
81
- return `- ${knownTitle(item.id)}:${size ?? '无数据'}${item.problem ? ` · ${UNCONFIRMED}(${item.problem})` : ''}`;
82
- });
83
- const report = [
84
- '# CCW 诊断报告',
85
- '',
86
- ...environment,
87
- `存储位置:${path.join(ctx.storage, '')}(来源记录 ${sources === null ? '不可读' : `${Object.keys(sources).length} 条`},替换备份 ${replaced ?? UNKNOWN} 份,停用备份 ${disabled ?? UNKNOWN} 份,安装残留 ${installLeftovers ?? UNKNOWN} 项)`,
88
- '',
89
- '## 检查结果(完整明细)',
90
- '',
91
- describeInspection(view, true) || '(无条目)',
92
- '',
93
- '## 最近一次执行',
94
- '',
95
- ...(lastRunReadable
96
- ? runItems.length || runState !== undefined
97
- ? [
98
- `时间:${runAt ?? UNKNOWN} · 状态:${runState ?? UNKNOWN}`,
99
- ...runItems.map(entry => `- ${entry.title}:${entry.state}`),
100
- ]
101
- : ['(无执行历史)']
102
- : ['(最近执行状态未知:记录不可读)']),
103
- '',
104
- '## 运行数据体量',
105
- '',
106
- ...(dataLines.length ? dataLines : ['(无数据)']),
107
- ...data.problems.map(problem => `- ${PROBLEM_MARK}${problem.code}${problem.detail ? `:${problem.detail}` : ''}`),
108
- '',
109
- '## 隐私声明',
110
- '',
111
- '- 本报告只在本地生成;CCW 不会自动上传任何内容,是否提供给他人由你决定',
112
- '- 报告中的主目录与配置根路径已折叠,常见凭据形态已打码',
113
- '- 检查过程会读取 settings.json 与 .claude.json 以派生状态;报告只收录派生事实码,不收录原文与凭据值',
114
- '- 未读取任何日志文件的内容,仅统计存在性与体量',
115
- '',
116
- ].join('\n');
117
- const directory = logsDirectory(ctx);
118
- const base = `ccw-collect-${stamp.toISOString().replace(/[-:]/g, '').replace('T', '').slice(0, 14)}`;
119
- const text = redactText(foldText(ctx, report));
120
- let file = path.join(directory, `${base}.md`);
121
- let attempt = 0;
122
- while (!(await ctx.machine.initialize(file, text))) {
123
- if (++attempt >= 100)
124
- throw new Error('report-name-conflict');
125
- file = path.join(directory, `${base}-${attempt}.md`);
126
- }
127
- const summary = [
128
- 'CCW 诊断摘要',
129
- `版本:CCW ${BRAND.versionNumber} · ${platformSummary(ctx.platform, ctx.arch ?? process.arch)} · Node ${process.version}`,
130
- `检查:${view.items.length} 项,${problems.length} 个问题${problems.length ? `(${[...new Set(problems)].join('、')})` : ''}`,
131
- ...(lastRunReadable && runState !== undefined ? [`最近执行:${runState}`] : []),
132
- ...(data.items.length
133
- ? [
134
- `数据:${data.items
135
- .map(item => {
136
- const size = dataSizeDetailOf(item);
137
- return size !== undefined && !isEmptyDataSize(size) ? `${knownTitle(item.id)} ${size}` : '';
138
- })
139
- .filter(Boolean)
140
- .join(' · ')}`,
141
- ]
142
- : []),
143
- `完整报告:${file}`,
144
- '报障时请把上面的完整报告文件一并附上',
145
- ].join('\n');
146
- return { file, summary };
147
- }