dsh-aftermath 0.0.0-stage → 0.6.4
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/GUIDE.md +277 -0
- package/LICENSE +21 -0
- package/README.md +220 -2
- package/assets/icon-128.png +0 -0
- package/assets/icon-256.png +0 -0
- package/assets/icon-512.png +0 -0
- package/assets/icon-96.png +0 -0
- package/assets/icon-e-dark.html +26 -0
- package/assets/icon-e-light.html +26 -0
- package/assets/icon-light-512.png +0 -0
- package/assets/icon-light-96.png +0 -0
- package/cordis.patch.yml +3 -0
- package/lib/attribution.js +641 -0
- package/lib/client.js +894 -0
- package/lib/command-registration.js +21 -0
- package/lib/commands.js +379 -0
- package/lib/config.js +237 -0
- package/lib/diff.js +231 -0
- package/lib/index.js +603 -0
- package/lib/panel.js +126 -0
- package/lib/report.js +428 -0
- package/lib/scan.js +186 -0
- package/lib/schema.js +196 -0
- package/lib/store.js +188 -0
- package/lib/symptoms.js +148 -0
- package/lib/version.js +22 -0
- package/package.json +72 -4
package/lib/scan.js
ADDED
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 快照:把一个目录树压成 [{rel, dir, size, mtime}]。
|
|
3
|
+
*
|
|
4
|
+
* 设计取舍(追求精度与稳定,不追求吞吐):
|
|
5
|
+
* - 全同步 I/O。深度 2 的桌面约 0.3ms,同步换来“快照之间不可能交错”的确定性。
|
|
6
|
+
* - 目录只记录存在性,不记录 size/mtime:目录 mtime 随子项增删变化,记了就是满屏噪音。
|
|
7
|
+
* - 符号链接/junction 只记一条,不跟进去,避免环与越界。
|
|
8
|
+
* - 单条目失败只计数,不抛:一次权限拒绝不该毁掉整轮观测。
|
|
9
|
+
*/
|
|
10
|
+
import fs from 'node:fs';
|
|
11
|
+
import path from 'node:path';
|
|
12
|
+
|
|
13
|
+
export function isExcluded(name, patterns) {
|
|
14
|
+
if (!patterns || patterns.length === 0) return false;
|
|
15
|
+
const lower = name.toLowerCase();
|
|
16
|
+
for (const raw of patterns) {
|
|
17
|
+
if (typeof raw !== 'string') continue;
|
|
18
|
+
const p = raw.trim().toLowerCase();
|
|
19
|
+
if (!p) continue;
|
|
20
|
+
const star = p.indexOf('*');
|
|
21
|
+
if (star === 0) {
|
|
22
|
+
if (lower.endsWith(p.slice(1))) return true;
|
|
23
|
+
} else if (star === p.length - 1) {
|
|
24
|
+
if (lower.startsWith(p.slice(0, -1))) return true;
|
|
25
|
+
} else if (p.includes('*')) {
|
|
26
|
+
const [head, tail] = [p.slice(0, star), p.slice(star + 1)];
|
|
27
|
+
if (lower.startsWith(head) && lower.endsWith(tail)) return true;
|
|
28
|
+
} else if (lower === p) {
|
|
29
|
+
return true;
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
return false;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* @returns {{ok:boolean,complete:boolean,error:string|null,root:string,entries:Array,count:number,ms:number,truncated:boolean,unreadable:number,links:number}}
|
|
37
|
+
*/
|
|
38
|
+
export function scanRoot(rootPath, options = {}) {
|
|
39
|
+
const depth = Number.isInteger(options.depth) ? options.depth : 2;
|
|
40
|
+
const maxEntries = Number.isInteger(options.maxEntries) ? options.maxEntries : 20000;
|
|
41
|
+
const exclude = Array.isArray(options.exclude) ? options.exclude : [];
|
|
42
|
+
const started = Date.now();
|
|
43
|
+
const state = { entries: [], truncated: false, unreadable: 0, links: 0 };
|
|
44
|
+
let ok = true;
|
|
45
|
+
let error = null;
|
|
46
|
+
|
|
47
|
+
// 根目录自身必须可读,否则视为本次扫描失败(绝不把“读不到”当成“都删了”)。
|
|
48
|
+
try {
|
|
49
|
+
const st = fs.statSync(rootPath, { throwIfNoEntry: false });
|
|
50
|
+
if (!st || !st.isDirectory()) {
|
|
51
|
+
return {
|
|
52
|
+
ok: false,
|
|
53
|
+
complete: false,
|
|
54
|
+
error: st ? 'not-a-directory' : 'missing-root',
|
|
55
|
+
root: rootPath,
|
|
56
|
+
entries: [],
|
|
57
|
+
count: 0,
|
|
58
|
+
ms: Date.now() - started,
|
|
59
|
+
truncated: false,
|
|
60
|
+
unreadable: 0,
|
|
61
|
+
links: 0,
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
} catch (err) {
|
|
65
|
+
return {
|
|
66
|
+
ok: false,
|
|
67
|
+
complete: false,
|
|
68
|
+
error: `root-unreadable:${err?.code || 'error'}`,
|
|
69
|
+
root: rootPath,
|
|
70
|
+
entries: [],
|
|
71
|
+
count: 0,
|
|
72
|
+
ms: Date.now() - started,
|
|
73
|
+
truncated: false,
|
|
74
|
+
unreadable: 0,
|
|
75
|
+
links: 0,
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
const walk = (absDir, relDir, level) => {
|
|
80
|
+
if (state.truncated) return;
|
|
81
|
+
let dirents;
|
|
82
|
+
try {
|
|
83
|
+
dirents = fs.readdirSync(absDir, { withFileTypes: true });
|
|
84
|
+
} catch (err) {
|
|
85
|
+
if (level === 0) {
|
|
86
|
+
ok = false;
|
|
87
|
+
error = `readdir-failed:${err?.code || 'error'}`;
|
|
88
|
+
} else {
|
|
89
|
+
state.unreadable += 1;
|
|
90
|
+
}
|
|
91
|
+
return;
|
|
92
|
+
}
|
|
93
|
+
for (const dirent of dirents) {
|
|
94
|
+
if (state.entries.length >= maxEntries) {
|
|
95
|
+
state.truncated = true;
|
|
96
|
+
return;
|
|
97
|
+
}
|
|
98
|
+
const name = dirent.name;
|
|
99
|
+
if (isExcluded(name, exclude)) continue;
|
|
100
|
+
const rel = relDir ? `${relDir}\\${name}` : name;
|
|
101
|
+
const abs = path.join(absDir, name);
|
|
102
|
+
|
|
103
|
+
let isLink = false;
|
|
104
|
+
let isDir = false;
|
|
105
|
+
try {
|
|
106
|
+
isLink = dirent.isSymbolicLink();
|
|
107
|
+
isDir = dirent.isDirectory();
|
|
108
|
+
} catch {
|
|
109
|
+
state.unreadable += 1;
|
|
110
|
+
continue;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
if (isLink) {
|
|
114
|
+
state.links += 1;
|
|
115
|
+
state.entries.push({ rel, dir: false, size: -1, mtime: 0, link: true });
|
|
116
|
+
continue;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
if (isDir) {
|
|
120
|
+
state.entries.push({ rel, dir: true, size: 0, mtime: 0 });
|
|
121
|
+
if (level < depth) walk(abs, rel, level + 1);
|
|
122
|
+
continue;
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
let st = null;
|
|
126
|
+
try {
|
|
127
|
+
st = fs.statSync(abs, { throwIfNoEntry: false });
|
|
128
|
+
} catch {
|
|
129
|
+
st = null;
|
|
130
|
+
}
|
|
131
|
+
if (!st) {
|
|
132
|
+
state.unreadable += 1;
|
|
133
|
+
state.entries.push({ rel, dir: false, size: -1, mtime: 0, missing: true });
|
|
134
|
+
continue;
|
|
135
|
+
}
|
|
136
|
+
state.entries.push({
|
|
137
|
+
rel,
|
|
138
|
+
dir: false,
|
|
139
|
+
size: st.size,
|
|
140
|
+
mtime: Math.round(Number(st.mtimeMs) || 0),
|
|
141
|
+
});
|
|
142
|
+
}
|
|
143
|
+
};
|
|
144
|
+
|
|
145
|
+
walk(rootPath, '', 0);
|
|
146
|
+
|
|
147
|
+
return {
|
|
148
|
+
ok,
|
|
149
|
+
// complete = 这份名单可以拿来跟上一份比。截断或任何子目录读不到都不算完整:
|
|
150
|
+
// 名单不全时做差,会把"没扫到"误报成"被删除"。
|
|
151
|
+
complete: ok && !state.truncated && state.unreadable === 0,
|
|
152
|
+
error,
|
|
153
|
+
root: rootPath,
|
|
154
|
+
entries: state.entries,
|
|
155
|
+
count: state.entries.length,
|
|
156
|
+
ms: Date.now() - started,
|
|
157
|
+
truncated: state.truncated,
|
|
158
|
+
unreadable: state.unreadable,
|
|
159
|
+
links: state.links,
|
|
160
|
+
};
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
/** 扫描一组已解析的根;单个根失败不影响其它根。 */
|
|
164
|
+
export function scanRoots(roots, config) {
|
|
165
|
+
const out = [];
|
|
166
|
+
for (const root of roots) {
|
|
167
|
+
const snap = scanRoot(root.path, {
|
|
168
|
+
// 根可以自带宽深(cwd 这种大目录只用顶层)
|
|
169
|
+
depth: Number.isInteger(root.depth) ? root.depth : config.depth,
|
|
170
|
+
maxEntries: config.maxEntries,
|
|
171
|
+
exclude: config.exclude,
|
|
172
|
+
});
|
|
173
|
+
out.push({ ...snap, id: root.id });
|
|
174
|
+
}
|
|
175
|
+
return out;
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
export function absOf(rootPath, rel) {
|
|
179
|
+
return path.win32.normalize(path.join(rootPath, rel));
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
export function extOf(name) {
|
|
183
|
+
const idx = name.lastIndexOf('.');
|
|
184
|
+
if (idx <= 0) return '';
|
|
185
|
+
return name.slice(idx).toLowerCase();
|
|
186
|
+
}
|
package/lib/schema.js
ADDED
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 行 Config 的 schema(schemastery)。
|
|
3
|
+
*
|
|
4
|
+
* 为什么需要它:
|
|
5
|
+
* - 没有 Config,插件的设置在宿主里没有命名空间,Plugins 页的配置卡片拿不到表单,
|
|
6
|
+
* 除总开关外都改不动,只能改 yml 再重启。
|
|
7
|
+
* - 所有字段都 `.volatile()`:改完立即生效,不重启插件(重启会丢掉当前基线与本轮状态)。
|
|
8
|
+
*
|
|
9
|
+
* 为什么不要简单 createRequire(import.meta.url):
|
|
10
|
+
* - 插件用 `link:` 装时(DSH 对本地目录就是这么做),node_modules 里是符号链接,
|
|
11
|
+
* 而 Node 默认按 realpath 解析 import.meta.url —— 真实路径可能是别的盘、别的目录,
|
|
12
|
+
* 从那里往上层找不到 `@deepseek-ai/schemastery`,Config 就静默变成 undefined,
|
|
13
|
+
* 表现是「设置页只有总开关能改」。所以这里要显式补上几个搜索根。
|
|
14
|
+
*
|
|
15
|
+
* 为什么 require 而不是 import:
|
|
16
|
+
* - 顶层 `export const Config` 必须同步求值,动态 import 是异步的。
|
|
17
|
+
*/
|
|
18
|
+
import { createRequire } from 'node:module';
|
|
19
|
+
import { dirname, join } from 'node:path';
|
|
20
|
+
import { fileURLToPath } from 'node:url';
|
|
21
|
+
import { DEFAULTS } from './config.js';
|
|
22
|
+
|
|
23
|
+
const PACKAGE = '@deepseek-ai/schemastery';
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* 字段默认值的唯一来源是 `lib/config.js` 的 `DEFAULTS`。
|
|
27
|
+
* 这里曾经手抄一份,结果 `roots` 还写着两个根、`followCwd` 干脆漏了:
|
|
28
|
+
* 宿主拿 schema 默认值填 config,于是插件收到的 roots 是旧的、设置页里也没有 followCwd 开关。
|
|
29
|
+
*/
|
|
30
|
+
export const FIELD_DEFAULTS = { ...DEFAULTS };
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Desktop 版把依赖打进 `resources/app.asar/dsh/node_modules`,路径既不在
|
|
34
|
+
* profile 里也不在环境变量里,只能从运行时自身的位置推出来。这里用 execPath
|
|
35
|
+
* 与 resourcesPath 拼出候选目录;两个都拿不到时返回空数组。
|
|
36
|
+
*/
|
|
37
|
+
export function installDirCandidates(runtime = {}) {
|
|
38
|
+
// 显式传进来的键优先(哪怕是 undefined,代表「这条路径我不提供」),
|
|
39
|
+
// 没传的键才回退到当前运行时。
|
|
40
|
+
const own = Object.prototype.hasOwnProperty;
|
|
41
|
+
const execPath = own.call(runtime, 'execPath') ? runtime.execPath : process.execPath;
|
|
42
|
+
const resourcesPath = own.call(runtime, 'resourcesPath') ? runtime.resourcesPath : process.resourcesPath;
|
|
43
|
+
const out = [];
|
|
44
|
+
const push = (value) => {
|
|
45
|
+
if (typeof value !== 'string') return;
|
|
46
|
+
const dir = value.trim();
|
|
47
|
+
if (dir && !out.includes(dir)) out.push(dir);
|
|
48
|
+
};
|
|
49
|
+
if (typeof resourcesPath === 'string') {
|
|
50
|
+
push(join(resourcesPath, 'app.asar', 'dsh', 'node_modules'));
|
|
51
|
+
push(join(resourcesPath, 'app', 'dsh', 'node_modules'));
|
|
52
|
+
}
|
|
53
|
+
if (typeof execPath === 'string') {
|
|
54
|
+
const dir = dirname(execPath);
|
|
55
|
+
push(join(dir, 'resources', 'app.asar', 'dsh', 'node_modules'));
|
|
56
|
+
push(join(dir, 'resources', 'app', 'dsh', 'node_modules'));
|
|
57
|
+
}
|
|
58
|
+
return out;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* 候选搜索根:Node 的 CJS 解析器会把每个目录当成 node_modules 的搜索起点。
|
|
63
|
+
* 顺序 = 越可能命中越前。全部来自宿主自己的环境,不做任何猜测式遍历。
|
|
64
|
+
*/
|
|
65
|
+
export function resolutionBases(env = process.env) {
|
|
66
|
+
const bases = [];
|
|
67
|
+
const push = (value) => {
|
|
68
|
+
if (typeof value !== 'string') return;
|
|
69
|
+
const dir = value.trim();
|
|
70
|
+
if (!dir || bases.includes(dir)) return;
|
|
71
|
+
bases.push(dir);
|
|
72
|
+
};
|
|
73
|
+
|
|
74
|
+
// 1) 本文件所在目录(常规 node_modules 安装时这一条就够)
|
|
75
|
+
try {
|
|
76
|
+
push(dirname(fileURLToPath(import.meta.url)));
|
|
77
|
+
} catch {
|
|
78
|
+
/* ignore */
|
|
79
|
+
}
|
|
80
|
+
// 2) 宿主明确告知的 profile 目录(link: 安装时依赖都装在这里)
|
|
81
|
+
push(env.DSH_PROFILE_DIR);
|
|
82
|
+
// 3) 安装目录(Desktop 版 @deepseek-ai/* 的另一处来源)
|
|
83
|
+
push(env.DSH_INSTALL_DIR);
|
|
84
|
+
push(env.DSH_INSTALL_DIR ? join(env.DSH_INSTALL_DIR, '..') : undefined);
|
|
85
|
+
// 4) $DSH_HOME/profiles/<当前 profile> 与 $DSH_HOME 下的公共位置
|
|
86
|
+
if (env.DSH_HOME) {
|
|
87
|
+
push(join(env.DSH_HOME, 'profiles', 'desktop', 'node_modules'));
|
|
88
|
+
push(join(env.DSH_HOME, 'node_modules'));
|
|
89
|
+
}
|
|
90
|
+
// 5) Desktop 版安装目录(asar 内自带一份 @deepseek-ai/schemastery)
|
|
91
|
+
for (const dir of installDirCandidates()) push(dir);
|
|
92
|
+
// 6) 老实的兜底:环境里没告知时,按 profile 的常见位置试一次
|
|
93
|
+
if (!env.DSH_PROFILE_DIR && env.DSH_HOME) push(join(env.DSH_HOME, 'profiles', 'desktop'));
|
|
94
|
+
|
|
95
|
+
return bases;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/** 真正的加载器;返回 { schema, source },source 用于自检。 */
|
|
99
|
+
export function loadSchemastery(env = process.env) {
|
|
100
|
+
const require = createRequire(import.meta.url);
|
|
101
|
+
|
|
102
|
+
const accept = (schema, source) => {
|
|
103
|
+
if (!schema || typeof schema.object !== 'function') return null;
|
|
104
|
+
// volatile() 是 live 编辑的前提;没有它的旧副本一律不用(否则字段不会实时生效)
|
|
105
|
+
const probe = typeof schema.string === 'function' ? schema.string() : null;
|
|
106
|
+
if (!probe || typeof probe.volatile !== 'function') return null;
|
|
107
|
+
return { schema, source };
|
|
108
|
+
};
|
|
109
|
+
|
|
110
|
+
// 直接解析(正常安装路径)
|
|
111
|
+
try {
|
|
112
|
+
const direct = accept(require(PACKAGE), 'local');
|
|
113
|
+
if (direct) return direct;
|
|
114
|
+
} catch {
|
|
115
|
+
/* 继续用候选根 */
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
// 从每个候选根解析出文件再加载:require.resolve 的 paths 选项会按
|
|
119
|
+
// node_modules 规则逐级上溯,因此这里传目录即可。
|
|
120
|
+
for (const base of resolutionBases(env)) {
|
|
121
|
+
let file = null;
|
|
122
|
+
try {
|
|
123
|
+
file = require.resolve(PACKAGE, { paths: [base] });
|
|
124
|
+
} catch {
|
|
125
|
+
continue;
|
|
126
|
+
}
|
|
127
|
+
try {
|
|
128
|
+
const resolved = accept(require(file), base);
|
|
129
|
+
if (resolved) return resolved;
|
|
130
|
+
} catch {
|
|
131
|
+
/* 换下一个根 */
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
return null;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/** 按已加载的 schemastery 构造行 Config;拿不到 schemastery 时为 undefined。 */
|
|
139
|
+
function buildSchema(S) {
|
|
140
|
+
if (!S) return undefined;
|
|
141
|
+
try {
|
|
142
|
+
return S.object({
|
|
143
|
+
/** 总开关:关掉后不再快照、不再写记录(命令仍可读历史)。 */
|
|
144
|
+
enabled: S.boolean().default(FIELD_DEFAULTS.enabled).volatile(),
|
|
145
|
+
/** 观测根:内置标识或绝对路径。 */
|
|
146
|
+
roots: S.array(S.string()).default(FIELD_DEFAULTS.roots).volatile(),
|
|
147
|
+
/** 递归层数。 */
|
|
148
|
+
depth: S.number().min(0).max(6).default(FIELD_DEFAULTS.depth).volatile(),
|
|
149
|
+
/** NDJSON 保留天数。 */
|
|
150
|
+
retentionDays: S.number().min(1).max(90).default(FIELD_DEFAULTS.retentionDays).volatile(),
|
|
151
|
+
/** 报告里把家目录打码成 ~。 */
|
|
152
|
+
maskHome: S.boolean().default(FIELD_DEFAULTS.maskHome).volatile(),
|
|
153
|
+
/** 零变更但执行过写操作的回合,也落一条轻记录(判定“这轮动过别处”的唯一线索)。 */
|
|
154
|
+
recordQuietTurns: S.boolean().default(FIELD_DEFAULTS.recordQuietTurns).volatile(),
|
|
155
|
+
/** 额外的绝对路径根。 */
|
|
156
|
+
extraRoots: S.array(S.string()).default(FIELD_DEFAULTS.extraRoots).volatile(),
|
|
157
|
+
/** 名称排除模式。 */
|
|
158
|
+
exclude: S.array(S.string()).default(FIELD_DEFAULTS.exclude).volatile(),
|
|
159
|
+
/** 单根条目上限。 */
|
|
160
|
+
maxEntries: S.number().min(100).max(200000).default(FIELD_DEFAULTS.maxEntries).volatile(),
|
|
161
|
+
/** 一次报告最多列出的变更条数。 */
|
|
162
|
+
maxChangesPerReport: S.number().min(10).max(2000).default(FIELD_DEFAULTS.maxChangesPerReport).volatile(),
|
|
163
|
+
/** 调用区间归因的容差(毫秒)。 */
|
|
164
|
+
intervalSlackMs: S.number().min(0).max(60000).default(FIELD_DEFAULTS.intervalSlackMs).volatile(),
|
|
165
|
+
/** 会话工作目录自动计入观测根。 */
|
|
166
|
+
followCwd: S.boolean().default(FIELD_DEFAULTS.followCwd).volatile(),
|
|
167
|
+
});
|
|
168
|
+
} catch {
|
|
169
|
+
return undefined;
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
const BUILT = loadSchemastery();
|
|
174
|
+
|
|
175
|
+
/** 宿主可见的行 Config(拿不到 schemastery 时为 undefined,宿主则原样透传配置)。 */
|
|
176
|
+
export const Config = buildSchema(BUILT && BUILT.schema);
|
|
177
|
+
|
|
178
|
+
/** schema 来源自检:'local' / 具体搜索根 / null(未加载)。 */
|
|
179
|
+
export const SCHEMA_SOURCE = BUILT ? BUILT.source : null;
|
|
180
|
+
|
|
181
|
+
/** 从可能是 Volatile 引用的配置对象里取一个字段的真值。 */
|
|
182
|
+
export function readField(raw, key) {
|
|
183
|
+
if (!raw || typeof raw !== 'object') return undefined;
|
|
184
|
+
const value = raw[key];
|
|
185
|
+
if (value === undefined || value === null) return undefined;
|
|
186
|
+
if (typeof value === 'object' && !Array.isArray(value) && typeof value.get === 'function') {
|
|
187
|
+
try {
|
|
188
|
+
return value.get();
|
|
189
|
+
} catch {
|
|
190
|
+
return undefined;
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
return value;
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
export { buildSchema };
|
package/lib/store.js
ADDED
|
@@ -0,0 +1,188 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 落盘。全部同步小 I/O,失败一律吞掉并计数——存不下历史不该影响用户干活。
|
|
3
|
+
*
|
|
4
|
+
* 布局:
|
|
5
|
+
* <stateDir>/config-resolved.json 启动时解析出的根与实际参数(排障用)
|
|
6
|
+
* <stateDir>/turns/YYYY-MM-DD.ndjson 每轮一行(JSON)
|
|
7
|
+
* <stateDir>/reports/*.md 显式导出的报告
|
|
8
|
+
*/
|
|
9
|
+
import fs from 'node:fs';
|
|
10
|
+
import path from 'node:path';
|
|
11
|
+
import { stateDir } from './config.js';
|
|
12
|
+
|
|
13
|
+
function pad(n) {
|
|
14
|
+
return String(n).padStart(2, '0');
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
export function dayKey(date = new Date()) {
|
|
18
|
+
return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export function turnsDir() {
|
|
22
|
+
return path.join(stateDir(), 'turns');
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
export function reportsDir() {
|
|
26
|
+
return path.join(stateDir(), 'reports');
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
export function ensureDirs() {
|
|
30
|
+
const result = { ok: true, error: null };
|
|
31
|
+
for (const dir of [stateDir(), turnsDir(), reportsDir()]) {
|
|
32
|
+
try {
|
|
33
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
34
|
+
} catch (err) {
|
|
35
|
+
result.ok = false;
|
|
36
|
+
result.error = `${dir}: ${err?.code || err?.message || 'error'}`;
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
return result;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
function atomicWrite(file, text) {
|
|
43
|
+
const tmp = `${file}.${process.pid}.tmp`;
|
|
44
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
45
|
+
fs.writeFileSync(tmp, text, 'utf8');
|
|
46
|
+
fs.renameSync(tmp, file);
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
export function saveResolvedConfig(config) {
|
|
50
|
+
try {
|
|
51
|
+
ensureDirs();
|
|
52
|
+
atomicWrite(path.join(stateDir(), 'config-resolved.json'), `${JSON.stringify(config, null, 2)}\n`);
|
|
53
|
+
return true;
|
|
54
|
+
} catch {
|
|
55
|
+
return false;
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** 诊断快照:宿主设置服务看到的命名空间(只含 ns 名与字段名,无值)。 */
|
|
60
|
+
export function saveSettingsProbe(probe) {
|
|
61
|
+
try {
|
|
62
|
+
ensureDirs();
|
|
63
|
+
atomicWrite(path.join(stateDir(), 'settings-probe.json'), `${JSON.stringify(probe, null, 2)}\n`);
|
|
64
|
+
return true;
|
|
65
|
+
} catch {
|
|
66
|
+
return false;
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
export function appendTurn(record) {
|
|
71
|
+
try {
|
|
72
|
+
ensureDirs();
|
|
73
|
+
const at = typeof record?.at === 'number' ? record.at : Date.now();
|
|
74
|
+
const file = path.join(turnsDir(), `${dayKey(new Date(at))}.ndjson`);
|
|
75
|
+
fs.appendFileSync(file, `${JSON.stringify(record)}\n`, 'utf8');
|
|
76
|
+
return file;
|
|
77
|
+
} catch {
|
|
78
|
+
return null;
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
function listTurnFiles() {
|
|
83
|
+
try {
|
|
84
|
+
return fs
|
|
85
|
+
.readdirSync(turnsDir())
|
|
86
|
+
.filter((name) => /^\d{4}-\d{2}-\d{2}\.ndjson$/.test(name))
|
|
87
|
+
.sort();
|
|
88
|
+
} catch {
|
|
89
|
+
return [];
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* 读历史。sinceMs 之前的文件整份跳过;单行坏掉只跳过那一行。
|
|
95
|
+
*/
|
|
96
|
+
export function readTurns(options = {}) {
|
|
97
|
+
const sinceMs = Number.isFinite(options.sinceMs) ? options.sinceMs : 0;
|
|
98
|
+
const limit = Number.isInteger(options.limit) && options.limit > 0 ? options.limit : 200;
|
|
99
|
+
const files = listTurnFiles();
|
|
100
|
+
const out = [];
|
|
101
|
+
for (let i = files.length - 1; i >= 0; i -= 1) {
|
|
102
|
+
if (out.length >= limit) break;
|
|
103
|
+
const name = files[i];
|
|
104
|
+
const dayStart = Date.parse(`${name.slice(0, 10)}T00:00:00`);
|
|
105
|
+
// 文件按天命名,若该日整天早于 since 就整份跳过。
|
|
106
|
+
if (Number.isFinite(dayStart) && dayStart + 86400000 < sinceMs) continue;
|
|
107
|
+
let raw = '';
|
|
108
|
+
try {
|
|
109
|
+
raw = fs.readFileSync(path.join(turnsDir(), name), 'utf8');
|
|
110
|
+
} catch {
|
|
111
|
+
continue;
|
|
112
|
+
}
|
|
113
|
+
const lines = raw.split('\n');
|
|
114
|
+
for (let j = lines.length - 1; j >= 0; j -= 1) {
|
|
115
|
+
const line = lines[j].trim();
|
|
116
|
+
if (!line) continue;
|
|
117
|
+
let record = null;
|
|
118
|
+
try {
|
|
119
|
+
record = JSON.parse(line);
|
|
120
|
+
} catch {
|
|
121
|
+
continue;
|
|
122
|
+
}
|
|
123
|
+
const at = typeof record?.at === 'number' ? record.at : 0;
|
|
124
|
+
if (at < sinceMs) continue;
|
|
125
|
+
out.push(record);
|
|
126
|
+
if (out.length >= limit) break;
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
return out;
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
function baselinePath() {
|
|
133
|
+
return path.join(stateDir(), 'baseline.json');
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
/** 基线只存“最近一次观测到的完整快照”,用于 /aftermath scan 查空闲期变更。 */
|
|
137
|
+
export function saveBaseline(baseline) {
|
|
138
|
+
try {
|
|
139
|
+
ensureDirs();
|
|
140
|
+
atomicWrite(baselinePath(), `${JSON.stringify(baseline)}\n`);
|
|
141
|
+
return true;
|
|
142
|
+
} catch {
|
|
143
|
+
return false;
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
export function loadBaseline() {
|
|
148
|
+
try {
|
|
149
|
+
const raw = fs.readFileSync(baselinePath(), 'utf8');
|
|
150
|
+
const parsed = JSON.parse(raw);
|
|
151
|
+
if (!parsed || !Array.isArray(parsed.roots)) return null;
|
|
152
|
+
return parsed;
|
|
153
|
+
} catch {
|
|
154
|
+
return null;
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
export function writeReport(name, text) {
|
|
159
|
+
try {
|
|
160
|
+
ensureDirs();
|
|
161
|
+
const safe = String(name || 'report').replace(/[^a-zA-Z0-9._-]/g, '_');
|
|
162
|
+
const file = path.join(reportsDir(), `${safe}.md`);
|
|
163
|
+
atomicWrite(file, text);
|
|
164
|
+
return file;
|
|
165
|
+
} catch {
|
|
166
|
+
return null;
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
/** 保留 retentionDays 天,返回删掉的文件数。 */
|
|
171
|
+
export function pruneTurns(retentionDays) {
|
|
172
|
+
const days = Number.isFinite(retentionDays) ? Math.max(1, Math.floor(retentionDays)) : 7;
|
|
173
|
+
const cutoff = Date.now() - days * 86400000;
|
|
174
|
+
let removed = 0;
|
|
175
|
+
for (const name of listTurnFiles()) {
|
|
176
|
+
const dayStart = Date.parse(`${name.slice(0, 10)}T00:00:00`);
|
|
177
|
+
if (!Number.isFinite(dayStart)) continue;
|
|
178
|
+
if (dayStart + 86400000 < cutoff) {
|
|
179
|
+
try {
|
|
180
|
+
fs.unlinkSync(path.join(turnsDir(), name));
|
|
181
|
+
removed += 1;
|
|
182
|
+
} catch {
|
|
183
|
+
/* 删不掉就算了 */
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
return removed;
|
|
188
|
+
}
|