fde-console 0.0.0-stage → 2.9.68
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/LICENSE +21 -0
- package/README.md +128 -2
- package/README.zh-CN.md +130 -0
- package/assets/icon.svg +9 -0
- package/cordis.patch.yml +7 -0
- package/lib/agentActivity.js +1180 -0
- package/lib/agentContext.js +146 -0
- package/lib/agentTranscript.js +1398 -0
- package/lib/analyze.js +625 -0
- package/lib/attribute.js +205 -0
- package/lib/backup.js +366 -0
- package/lib/desktopAgents.js +123 -0
- package/lib/diary.js +333 -0
- package/lib/dingtalk.js +412 -0
- package/lib/feishu.js +580 -0
- package/lib/giteaClient.js +810 -0
- package/lib/giteeClient.js +372 -0
- package/lib/githubClient.js +361 -0
- package/lib/heatmap.js +99 -0
- package/lib/imNotify.js +378 -0
- package/lib/inbox.js +438 -0
- package/lib/instanceLock.js +122 -0
- package/lib/jobs.js +56 -0
- package/lib/learn.js +1388 -0
- package/lib/learnImport.js +283 -0
- package/lib/learnSeeds.js +97 -0
- package/lib/learnSeedsAiEng.js +77 -0
- package/lib/mcpCore.js +135 -0
- package/lib/members.js +160 -0
- package/lib/migration.js +403 -0
- package/lib/overview.js +376 -0
- package/lib/postmortem.js +148 -0
- package/lib/radarIgnore.js +134 -0
- package/lib/redact.js +76 -0
- package/lib/router.js +246 -0
- package/lib/routes-gitea.js +262 -0
- package/lib/routes-setup.js +40 -0
- package/lib/scorecard.js +111 -0
- package/lib/sessionRef.js +227 -0
- package/lib/sessionSnapshot.js +67 -0
- package/lib/sessionSuggest.js +186 -0
- package/lib/settings.js +783 -0
- package/lib/setupCheck.js +330 -0
- package/lib/ssrfGuard.js +145 -0
- package/lib/store.js +564 -0
- package/lib/storeDb.js +418 -0
- package/lib/taskEvents.js +243 -0
- package/lib/webhookOut.js +125 -0
- package/lib/weekly.js +439 -0
- package/lib/workSearch.js +220 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +46 -4
- package/plugin/adapter.js +157 -0
- package/plugin/client.js +282 -0
- package/plugin/index.mjs +116 -0
- package/plugin/static.js +99 -0
- package/scripts/backup-data.js +41 -0
- package/scripts/mcp-server.mjs +68 -0
- package/scripts/migrate-data.js +301 -0
- package/scripts/migrate-storage.js +47 -0
- package/scripts/seed-demo.js +200 -0
- package/scripts/write-agent-context.js +43 -0
- package/test/helpers/appAssembler.js +1078 -0
- package/web/client/fde-client.js +292 -0
- package/web/css/app.css +1510 -0
- package/web/index.html +69 -0
- package/web/js/api.js +72 -0
- package/web/js/app.js +313 -0
- package/web/js/icons.js +48 -0
- package/web/js/mock.js +1150 -0
- package/web/js/state.js +7 -0
- package/web/js/ui.js +276 -0
- package/web/js/views/activity.js +410 -0
- package/web/js/views/agents.js +892 -0
- package/web/js/views/board.js +1656 -0
- package/web/js/views/learn.js +530 -0
- package/web/js/views/members.js +344 -0
- package/web/js/views/onboarding.js +103 -0
- package/web/js/views/overview.js +508 -0
- package/web/js/views/radar.js +1359 -0
- package/web/js/views/search.js +149 -0
- package/web/js/views/settings.js +1351 -0
- package/web/js/views/topology.js +471 -0
- package/web/mock.json +2363 -0
|
@@ -0,0 +1,330 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* setupCheck.js — 环境体检聚合(分发部署自检,GET /api/setup/check)
|
|
5
|
+
*
|
|
6
|
+
* 目的:fde-console 分发给新机器时,新人在设置页一键体检即可知道缺什么、怎么修。
|
|
7
|
+
* 五项探测互不阻塞(各自 try/catch,单项失败/抛错不影响其余项):
|
|
8
|
+
* 1. node —— 运行时版本展示(恒 ok)
|
|
9
|
+
* 2. dws —— 钉钉采集 CLI 可执行性(spawnSync --version/--help,5s 超时)
|
|
10
|
+
* 3. dsh —— 分析引擎入口可解析性(resolveDshBin + --version)
|
|
11
|
+
* 4. llmRoute —— dsh 的 LLM 路由文件存在性(~/.dsh/settings.yaml + .credentials.yaml,
|
|
12
|
+
* 文件级检查,不做真实 LLM 调用)
|
|
13
|
+
* 5. gitea —— 复用 giteaClient.testConnection(3s 预算,超时按失败表达)
|
|
14
|
+
* v2.2:cliGateway 项已随 网关集成整体移除(业主 2026-10-20;六项收敛为五项)
|
|
15
|
+
* 脱敏:所有 detail 经 redact()(探测输出可能夹带路径/环境信息);hint 为静态文案不含凭据;
|
|
16
|
+
* 本端点绝不回显凭据值(凭据仍仅内存,见 redact.js)。
|
|
17
|
+
* 可测性:runSetupCheck(config, deps) 支持逐项注入探测替换与 existsSync/giteaTest 注入
|
|
18
|
+
* (离线测试不 spawn 真实二进制、不出网)。
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
const fs = require('node:fs');
|
|
22
|
+
const os = require('node:os');
|
|
23
|
+
const path = require('node:path');
|
|
24
|
+
const { spawnSync } = require('node:child_process');
|
|
25
|
+
const giteaClient = require('./giteaClient');
|
|
26
|
+
const { redact } = require('./redact');
|
|
27
|
+
|
|
28
|
+
const HINTS = {
|
|
29
|
+
dws: '钉钉工作台 CLI 未安装或未登录,请先安装 dws 并完成钉钉登录',
|
|
30
|
+
dsh: 'dsh 未安装(npm i -g @deepseek-ai/dsh)',
|
|
31
|
+
llmRoute: '未找到默认模型路由:0.2.1+ 在 profiles/<name>/cordis.patch.yml 配置 agent-default-model(provider/model);旧版为 ~/.dsh/settings.yaml + .credentials.yaml',
|
|
32
|
+
giteaUnreachable: '无法连接 Gitea:检查网络连通性与 baseUrl 是否可达',
|
|
33
|
+
larkcli: 'lark-cli 未安装(npm i -g @larksuite/cli),安装后运行 lark-cli config init 完成飞书应用配置并 lark-cli auth login 完成用户授权',
|
|
34
|
+
};
|
|
35
|
+
|
|
36
|
+
/** 探测抛错时的兜底 hint(与各项主失败 hint 同源,保证任何路径都有修复指引) */
|
|
37
|
+
const FALLBACK_HINT = {
|
|
38
|
+
node: null,
|
|
39
|
+
dws: HINTS.dws,
|
|
40
|
+
dsh: HINTS.dsh,
|
|
41
|
+
llmRoute: HINTS.llmRoute,
|
|
42
|
+
gitea: HINTS.giteaUnreachable,
|
|
43
|
+
larkcli: HINTS.larkcli,
|
|
44
|
+
};
|
|
45
|
+
|
|
46
|
+
/** 从任意命令输出提取语义版本号("dws version v1.0.59 (…)"、"0.1.0-rc.7" 均命中) */
|
|
47
|
+
function versionOf(text) {
|
|
48
|
+
const m = /(\d+\.\d+\.\d+(?:[^\s\r\n]*))/.exec(String(text || ''));
|
|
49
|
+
return m ? m[1] : null;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** dsh 配置目录:~/.dsh(DSH_HOME 设置时为 <DSH_HOME>/.dsh,与插件配置落点同一约定) */
|
|
53
|
+
function dshHomeDir() {
|
|
54
|
+
const envHome = process.env.DSH_HOME && String(process.env.DSH_HOME).trim();
|
|
55
|
+
return path.join(envHome || os.homedir(), '.dsh');
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
// ------------------------------------------------------------------ 探测实现
|
|
59
|
+
|
|
60
|
+
/** ① Node 运行时:恒 ok(展示用,本服务就跑在它上面) */
|
|
61
|
+
function probeNode() {
|
|
62
|
+
return {
|
|
63
|
+
ok: true,
|
|
64
|
+
detail: `Node.js ${process.version}(${process.platform}-${process.arch})`,
|
|
65
|
+
hint: null,
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/** ② dws(钉钉采集,可选组件):bin 可解析 + 可执行;未安装 = ok:true + optional(开源用户零噪音,
|
|
70
|
+
* 只损失雷达钉钉同步,其余功能不受影响——2026-11-03 开源发布工程口径) */
|
|
71
|
+
function probeDws(config) {
|
|
72
|
+
if (process.env.DINGTALK_FIXTURE) {
|
|
73
|
+
return { ok: true, detail: 'fixture 模式(零进程采集,未探测真实 CLI)', hint: null };
|
|
74
|
+
}
|
|
75
|
+
// 延迟 require:与 radar 引擎端点同款,避免模块图在装配期展开
|
|
76
|
+
const { resolveDwsBin } = require('./dingtalk');
|
|
77
|
+
const bin = resolveDwsBin(config);
|
|
78
|
+
if (!bin) {
|
|
79
|
+
return {
|
|
80
|
+
ok: true,
|
|
81
|
+
optional: true,
|
|
82
|
+
detail: '未安装(可选)——任务雷达钉钉同步不可用,其余功能不受影响',
|
|
83
|
+
hint: HINTS.dws,
|
|
84
|
+
};
|
|
85
|
+
}
|
|
86
|
+
let v = spawnSync(bin, ['--version'], { timeout: 5000, windowsHide: true });
|
|
87
|
+
if (v.error || v.status !== 0) {
|
|
88
|
+
v = spawnSync(bin, ['--help'], { timeout: 5000, windowsHide: true });
|
|
89
|
+
}
|
|
90
|
+
if (v.error) {
|
|
91
|
+
return {
|
|
92
|
+
ok: false,
|
|
93
|
+
detail: `dws 不可执行:${v.error.code || v.error.message}(${bin})`,
|
|
94
|
+
hint: HINTS.dws,
|
|
95
|
+
};
|
|
96
|
+
}
|
|
97
|
+
const version = versionOf(String(v.stdout || '') + String(v.stderr || ''));
|
|
98
|
+
return { ok: true, detail: `dws${version ? ` ${version}` : ''} 可执行(${bin})`, hint: null };
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/** ②-b lark-cli(飞书妙记采集,可选组件):bin 可解析 + 原生 exe 存在性(文件级检查,零 spawn);
|
|
102
|
+
* 未安装 = ok:true + optional(与 dws 同款开源口径;可执行性由雷达同步真实兜底) */
|
|
103
|
+
function probeLarkCli(config) {
|
|
104
|
+
if (process.env.LARK_FIXTURE) {
|
|
105
|
+
return { ok: true, detail: 'fixture 模式(零进程采集,未探测真实 CLI)', hint: null };
|
|
106
|
+
}
|
|
107
|
+
// 延迟 require:与雷达引擎端点同款,避免模块图在装配期展开
|
|
108
|
+
const { resolveLarkBin } = require('./feishu');
|
|
109
|
+
const bin = resolveLarkBin(config);
|
|
110
|
+
if (!bin) {
|
|
111
|
+
return {
|
|
112
|
+
ok: true,
|
|
113
|
+
optional: true,
|
|
114
|
+
detail: '未安装(可选)——任务雷达飞书同步不可用,其余功能不受影响',
|
|
115
|
+
hint: HINTS.larkcli,
|
|
116
|
+
};
|
|
117
|
+
}
|
|
118
|
+
// 解析红线在调用侧复查:只认真实存在的原生 exe(与 feishu.js 的 exe-only 口径一致)
|
|
119
|
+
if (!/\.exe$/i.test(bin) || !fs.existsSync(bin)) {
|
|
120
|
+
return {
|
|
121
|
+
ok: false,
|
|
122
|
+
detail: `lark-cli 路径不是原生 exe 或文件不存在:${bin}`,
|
|
123
|
+
hint: HINTS.larkcli,
|
|
124
|
+
};
|
|
125
|
+
}
|
|
126
|
+
return { ok: true, detail: `lark-cli 可解析(${bin})`, hint: null };
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/** ③ dsh(分析引擎):入口 bin 可解析即为 ok;--version 能取到就附版本(5s 超时) */
|
|
130
|
+
function probeDsh(config) {
|
|
131
|
+
if (process.env.DSH_FIXTURE) {
|
|
132
|
+
return { ok: true, detail: 'fixture 模式(零进程分析,未探测真实引擎)', hint: null };
|
|
133
|
+
}
|
|
134
|
+
const { resolveDshBin } = require('./analyze');
|
|
135
|
+
const bin = resolveDshBin(config);
|
|
136
|
+
if (!bin) {
|
|
137
|
+
return {
|
|
138
|
+
ok: false,
|
|
139
|
+
detail: '未找到 dsh 引擎入口(config.analyze.dshBin / %APPDATA%\\npm\\node_modules\\@deepseek-ai\\dsh)',
|
|
140
|
+
hint: HINTS.dsh,
|
|
141
|
+
};
|
|
142
|
+
}
|
|
143
|
+
const v = spawnSync(process.execPath, [bin, '--version'], { timeout: 5000, windowsHide: true });
|
|
144
|
+
const version = v.error ? null : versionOf(String(v.stdout || '') + String(v.stderr || ''));
|
|
145
|
+
return { ok: true, detail: `dsh${version ? ` ${version}` : ''} 入口可解析(${bin})`, hint: null };
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
/**
|
|
149
|
+
* ④ LLM 路由:两种口径都要认(文件级,零调用)
|
|
150
|
+
* ① 旧版(≤0.2.0):`<dshHome>/settings.yaml` 与 `.credentials.yaml` 均存在;
|
|
151
|
+
* ② 0.2.1+:模型路由搬进 **profile** 的 `cordis.patch.yml`,由 `agent-default-model` 行承载
|
|
152
|
+
* (provider/model),`~/.dsh/settings.yaml` 根本不存在——旧口径会误报「未配置」,
|
|
153
|
+
* 而宿主明明在跑(2026-10-31 业主实测:桌面 profile 里 provider=deepseek-account)。
|
|
154
|
+
* 因此先看旧文件,再扫 profile;两者都没有才判失败。找不到只代表「没找到」,措辞要诚实。
|
|
155
|
+
*/
|
|
156
|
+
function readModelRoute(file, readFile) {
|
|
157
|
+
try {
|
|
158
|
+
const text = String(readFile(file, 'utf8'));
|
|
159
|
+
const at = text.indexOf('agent-default-model');
|
|
160
|
+
if (at === -1) return null;
|
|
161
|
+
const block = text.slice(at, at + 600);
|
|
162
|
+
const provider = /provider:\s*["']?([A-Za-z0-9._-]+)/.exec(block);
|
|
163
|
+
const model = /model:\s*["']?([A-Za-z0-9._/.:-]+)/.exec(block);
|
|
164
|
+
if (!model) return null;
|
|
165
|
+
return { provider: provider ? provider[1] : '', model: model[1] };
|
|
166
|
+
} catch (e) {
|
|
167
|
+
return null;
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
/** profiles 目录下的子目录名(读不到就是空数组:体检绝不因枚举失败而炸) */
|
|
172
|
+
function listProfileDirs(dir, readdir) {
|
|
173
|
+
try {
|
|
174
|
+
return readdir(dir, { withFileTypes: true })
|
|
175
|
+
.filter((d) => d && d.isDirectory && d.isDirectory())
|
|
176
|
+
.map((d) => d.name);
|
|
177
|
+
} catch (e) {
|
|
178
|
+
return [];
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
function probeLlmRoute(config, deps) {
|
|
183
|
+
const d = deps || {};
|
|
184
|
+
const exists = d.existsSync || fs.existsSync;
|
|
185
|
+
const readFile = d.readFileSync || fs.readFileSync;
|
|
186
|
+
const readdir = d.readdirSync || fs.readdirSync;
|
|
187
|
+
const dir = d.dshHomeDir || dshHomeDir();
|
|
188
|
+
const hasSettings = !!exists(path.join(dir, 'settings.yaml'));
|
|
189
|
+
const hasCreds = !!exists(path.join(dir, '.credentials.yaml'));
|
|
190
|
+
|
|
191
|
+
// ① 旧版全局口径:两个文件齐了即通过(历史部署不受影响)
|
|
192
|
+
if (hasSettings && hasCreds) {
|
|
193
|
+
return { ok: true, detail: `settings.yaml 与 .credentials.yaml 均存在(${dir})`, hint: null };
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
// ② 0.2.1+:profile 的 cordis.patch.yml 里 agent-default-model 行
|
|
197
|
+
// 先试当前 profile(DSH_PROFILE),再兜底扫其余 profile——插件可能跑在被 profile 起的实例里,
|
|
198
|
+
// 而模型路由配在另一个 profile(例如桌面端 desktop)上
|
|
199
|
+
const envProfile = typeof d.profile === 'string' ? d.profile : (process.env.DSH_PROFILE || '');
|
|
200
|
+
const profilesDir = path.join(dir, 'profiles');
|
|
201
|
+
const all = typeof d.listProfiles === 'function' ? d.listProfiles(profilesDir) : listProfileDirs(profilesDir, readdir);
|
|
202
|
+
const names = envProfile ? [envProfile].concat((all || []).filter((n) => n !== envProfile)) : (all || []);
|
|
203
|
+
for (const name of names || []) {
|
|
204
|
+
const route = readModelRoute(path.join(profilesDir, name, 'cordis.patch.yml'), readFile);
|
|
205
|
+
if (route) {
|
|
206
|
+
const who = route.provider ? `${route.provider} / ${route.model}` : route.model;
|
|
207
|
+
const credNote = hasCreds ? '' : '(未发现 .credentials.yaml:密钥可能由宿主自身托管)';
|
|
208
|
+
return { ok: true, detail: `profile "${name}" 默认模型 ${who}${credNote}`, hint: null };
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
// ③ 都没找到:如实说明看过哪里,不假装知道原因
|
|
213
|
+
const missing = [!hasSettings && 'settings.yaml', !hasCreds && '.credentials.yaml'].filter(Boolean).join('、');
|
|
214
|
+
return {
|
|
215
|
+
ok: false,
|
|
216
|
+
detail: `缺少 ${missing}(目录 ${dir});profiles/*/cordis.patch.yml 也未见 agent-default-model 行`,
|
|
217
|
+
hint: HINTS.llmRoute,
|
|
218
|
+
};
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
/** gitea 失败 hint 按 HTTP 状态区分(testConnection 只回错误文本,状态码从中提取) */
|
|
222
|
+
function giteaHint(err) {
|
|
223
|
+
const code = err && err.code;
|
|
224
|
+
if (code === 'HOST_NOT_ALLOWED') return 'baseUrl 不在 hostWhitelist:在设置页将该域名加入 host 白名单';
|
|
225
|
+
const m = /HTTP (\d{3})/.exec(String((err && err.message) || err || ''));
|
|
226
|
+
const status = m ? Number(m[1]) : null;
|
|
227
|
+
if (status === 401 || status === 403) {
|
|
228
|
+
return 'Gitea 凭据不可用:二选一——① 在系统凭据管理器配置(git credential.helper 已接管 gitea 域名);② 执行 git config --global http.<baseUrl>/.extraheader "Authorization: Basic <base64(用户名:令牌)>";改完重启服务';
|
|
229
|
+
}
|
|
230
|
+
if (status === 404) return 'Gitea 地址或 API 前缀不正确:检查设置页 baseUrl / apiPrefix';
|
|
231
|
+
if (status && status >= 500) return `Gitea 服务端错误(HTTP ${status}):稍后重试或联系 Gitea 管理员`;
|
|
232
|
+
return HINTS.giteaUnreachable;
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
/** Promise 竞速超时(giteaClient.testConnection 内部 5s 固定,体检预算 3s 更紧) */
|
|
236
|
+
function withTimeout(promise, ms, timeoutValue) {
|
|
237
|
+
let timer;
|
|
238
|
+
const t = new Promise((resolve) => {
|
|
239
|
+
timer = setTimeout(() => resolve(timeoutValue), ms);
|
|
240
|
+
});
|
|
241
|
+
return Promise.race([promise, t]).finally(() => clearTimeout(timer));
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
/** ⑤ Gitea:复用 giteaClient.testConnection(带 3s 预算;fixture 模式零出网直接 ok) */
|
|
245
|
+
async function probeGitea(config, deps) {
|
|
246
|
+
const d = deps || {};
|
|
247
|
+
const timeoutMs = Number(d.giteaTimeoutMs) || 3000;
|
|
248
|
+
const giteaTest = d.giteaTest || giteaClient.testConnection;
|
|
249
|
+
const base = config && config.gitea && config.gitea.baseUrl;
|
|
250
|
+
if (typeof base !== 'string' || base.trim() === '') {
|
|
251
|
+
return { ok: false, detail: '未配置 gitea.baseUrl', hint: '请在设置页填写 Gitea 地址(baseUrl)后重试' };
|
|
252
|
+
}
|
|
253
|
+
let res;
|
|
254
|
+
try {
|
|
255
|
+
res = await withTimeout(Promise.resolve().then(() => giteaTest(base, config)), timeoutMs, { timedOut: true });
|
|
256
|
+
} catch (e) {
|
|
257
|
+
return { ok: false, detail: redact((e && e.message) || String(e)), hint: giteaHint(e) };
|
|
258
|
+
}
|
|
259
|
+
if (res && res.timedOut) {
|
|
260
|
+
return { ok: false, detail: `连接超时(>${timeoutMs}ms)`, hint: '连接超时:检查网络连通性与 Gitea 服务可达性' };
|
|
261
|
+
}
|
|
262
|
+
if (res && res.ok) {
|
|
263
|
+
return {
|
|
264
|
+
ok: true,
|
|
265
|
+
detail: `已连接(${Number(res.latencyMs) || 0}ms,API ${res.apiVersion || '版本未知'})`,
|
|
266
|
+
hint: null,
|
|
267
|
+
};
|
|
268
|
+
}
|
|
269
|
+
const err = new Error((res && res.error) || 'GITEA_TEST_FAILED');
|
|
270
|
+
return { ok: false, detail: redact(err.message), hint: giteaHint(err) };
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
// ------------------------------------------------------------------ 聚合
|
|
274
|
+
|
|
275
|
+
/** 五项清单:id 固定(前端/测试契约),name 为中文展示名,depKey 为可注入探测的 deps 键
|
|
276
|
+
* (v2.2:cliGateway 项随 网关集成移除,六项收敛为五项) */
|
|
277
|
+
const ITEM_META = [
|
|
278
|
+
['node', 'Node.js 运行时', 'probeNode', probeNode],
|
|
279
|
+
['dws', '钉钉采集(dws)', 'probeDws', probeDws],
|
|
280
|
+
['larkcli', '飞书采集(lark-cli)', 'probeLarkCli', probeLarkCli],
|
|
281
|
+
['dsh', '分析引擎(dsh)', 'probeDsh', probeDsh],
|
|
282
|
+
['llmRoute', 'LLM 路由配置', 'probeLlmRoute', probeLlmRoute],
|
|
283
|
+
['gitea', 'Gitea 连接', 'probeGitea', probeGitea],
|
|
284
|
+
];
|
|
285
|
+
|
|
286
|
+
/**
|
|
287
|
+
* 聚合体检。deps 可注入:probeNode/probeDws/probeDsh/probeLlmRoute/probeGitea
|
|
288
|
+
* (逐项替换探测)、existsSync/dshHomeDir(llmRoute 文件级判定注入)、giteaTimeoutMs/giteaTest
|
|
289
|
+
* (gitea 超时与连接测试注入)。全部缺省 = 真实探测。
|
|
290
|
+
* @returns {Promise<{allOk:boolean, items:Array<{id,name,ok,detail,hint}>, checkedAt:string}>}
|
|
291
|
+
*/
|
|
292
|
+
async function runSetupCheck(config, deps) {
|
|
293
|
+
const d = deps || {};
|
|
294
|
+
const items = await Promise.all(
|
|
295
|
+
ITEM_META.map(async ([id, name, depKey, defaultProbe]) => {
|
|
296
|
+
const probe = d[depKey] || defaultProbe;
|
|
297
|
+
let r;
|
|
298
|
+
try {
|
|
299
|
+
r = (await probe(config, d)) || {};
|
|
300
|
+
} catch (e) {
|
|
301
|
+
r = { ok: false, detail: redact((e && e.message) || String(e)), hint: FALLBACK_HINT[id] };
|
|
302
|
+
}
|
|
303
|
+
return {
|
|
304
|
+
id,
|
|
305
|
+
name,
|
|
306
|
+
ok: !!r.ok,
|
|
307
|
+
optional: !!r.optional, // 可选组件(dws/lark-cli)未安装 → ok:true + optional:true,不卡 allOk
|
|
308
|
+
detail: redact(String(r.detail || '')),
|
|
309
|
+
hint: r.hint || null,
|
|
310
|
+
};
|
|
311
|
+
})
|
|
312
|
+
);
|
|
313
|
+
return {
|
|
314
|
+
allOk: items.every((i) => i.ok),
|
|
315
|
+
items,
|
|
316
|
+
checkedAt: new Date().toISOString(),
|
|
317
|
+
};
|
|
318
|
+
}
|
|
319
|
+
|
|
320
|
+
module.exports = {
|
|
321
|
+
runSetupCheck,
|
|
322
|
+
probeNode,
|
|
323
|
+
probeDws,
|
|
324
|
+
probeDsh,
|
|
325
|
+
probeLlmRoute,
|
|
326
|
+
probeGitea,
|
|
327
|
+
dshHomeDir,
|
|
328
|
+
versionOf,
|
|
329
|
+
HINTS,
|
|
330
|
+
};
|
package/lib/ssrfGuard.js
ADDED
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
// ssrfGuard.js — 出站 SSRF 防护(SPEC §5-②)。
|
|
3
|
+
// 规则:
|
|
4
|
+
// 1. 出站协议必须 ∈ config.security.allowedProtocols(默认 ["https"]);
|
|
5
|
+
// 2. URL host(不分大小写)必须 === config.gitea.hostWhitelist 某项(精确匹配,天然免疫子域伪装);
|
|
6
|
+
// 3. 白名单含 localhost/环回/私有段/保留段字面量时启动即抛错;
|
|
7
|
+
// 4. 任何违规都在发起请求之前完成——本模块纯同步、零 IO、零出站。
|
|
8
|
+
// 对外错误统一 code='HOST_NOT_ALLOWED'(§3 /api/gitea/test 白名单外 → 400 HOST_NOT_ALLOWED)。
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* host 是否为危险字面量(localhost/环回/私有/保留段)。
|
|
12
|
+
* 支持 IPv4 点分十进制与 IPv6 字面量(含方括号形式)。
|
|
13
|
+
* @param {string} host
|
|
14
|
+
* @returns {boolean}
|
|
15
|
+
*/
|
|
16
|
+
function isDangerousHost(host) {
|
|
17
|
+
const h = String(host || '').toLowerCase().trim().replace(/\.$/, '');
|
|
18
|
+
if (!h) return true;
|
|
19
|
+
if (h === 'localhost' || h.endsWith('.localhost') || h === 'localhost.localdomain') return true;
|
|
20
|
+
|
|
21
|
+
if (h.includes(':')) {
|
|
22
|
+
// IPv6 字面量
|
|
23
|
+
const v6 = h.replace(/^\[/, '').replace(/\]$/, '');
|
|
24
|
+
if (v6 === '::' || v6 === '::1') return true; // 未指定 / 环回
|
|
25
|
+
const low = v6.toLowerCase();
|
|
26
|
+
if (/^f[cd][0-9a-f]{2}:/.test(low)) return true; // fc00::/7 唯一本地
|
|
27
|
+
if (/^fe[89ab][0-9a-f]:/.test(low)) return true; // fe80::/10 链路本地
|
|
28
|
+
return false;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
const m = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(h);
|
|
32
|
+
if (!m) return false; // 普通域名
|
|
33
|
+
const a = Number(m[1]);
|
|
34
|
+
const b = Number(m[2]);
|
|
35
|
+
if (!Number.isInteger(a) || !Number.isInteger(b) || a > 255 || b > 255) return true; // 非法即拒
|
|
36
|
+
if (a === 0) return true; // 0.0.0.0/8 "本网络"
|
|
37
|
+
if (a === 10) return true; // 私有
|
|
38
|
+
if (a === 127) return true; // 环回
|
|
39
|
+
if (a === 169 && b === 254) return true; // 链路本地(含 169.254.169.254 元数据)
|
|
40
|
+
if (a === 172 && b >= 16 && b <= 31) return true; // 私有
|
|
41
|
+
if (a === 192 && b === 168) return true; // 私有
|
|
42
|
+
if (a === 100 && b >= 64 && b <= 127) return true; // CGNAT
|
|
43
|
+
if (a === 192 && b === 0) return true; // 192.0.0.x / 192.0.2.x 保留
|
|
44
|
+
if (a === 198 && (b === 18 || b === 19)) return true; // 基准测试
|
|
45
|
+
if (a === 198 && b === 51) return true; // 198.51.100.x 保留
|
|
46
|
+
if (a === 203 && b === 0) return true; // 203.0.113.x 保留
|
|
47
|
+
if (a >= 224) return true; // 组播/保留/广播
|
|
48
|
+
return false;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* 校验出站 URL;违规抛 Error({code:'HOST_NOT_ALLOWED'})。纯同步,零出站。
|
|
53
|
+
* @param {string} rawUrl
|
|
54
|
+
* @param {{security?:{allowedProtocols?:string[]}, gitea?:{hostWhitelist?:string[]}}} cfg
|
|
55
|
+
* @returns {URL} 解析后的 URL
|
|
56
|
+
*/
|
|
57
|
+
function assertSafeUrl(rawUrl, cfg) {
|
|
58
|
+
let url;
|
|
59
|
+
try {
|
|
60
|
+
url = new URL(String(rawUrl));
|
|
61
|
+
} catch {
|
|
62
|
+
const err = new Error(`URL 非法: ${String(rawUrl)}`);
|
|
63
|
+
err.code = 'HOST_NOT_ALLOWED';
|
|
64
|
+
throw err;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
const protocols = ((cfg && cfg.security && cfg.security.allowedProtocols) || ['https'])
|
|
68
|
+
.map((p) => String(p).toLowerCase());
|
|
69
|
+
const proto = url.protocol.replace(/:$/, '').toLowerCase();
|
|
70
|
+
if (!protocols.includes(proto)) {
|
|
71
|
+
const err = new Error(`协议不允许: ${proto}(仅允许 ${protocols.join(', ')})`);
|
|
72
|
+
err.code = 'HOST_NOT_ALLOWED';
|
|
73
|
+
throw err;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
// v2.9:白名单 = gitea 节 ∪ github 节 ∪ gitee 节(v2.9.18 加 gitee;cfg 无某节时行为与旧版一致)
|
|
77
|
+
const whitelist = [
|
|
78
|
+
...((cfg && cfg.gitea && cfg.gitea.hostWhitelist) || []),
|
|
79
|
+
...((cfg && cfg.github && cfg.github.hostWhitelist) || []),
|
|
80
|
+
...((cfg && cfg.gitee && cfg.gitee.hostWhitelist) || [])
|
|
81
|
+
];
|
|
82
|
+
const host = url.hostname.toLowerCase(); // WHATWG URL hostname 已小写化、IPv6 去方括号
|
|
83
|
+
const ok = whitelist.some((w) => String(w).toLowerCase() === host);
|
|
84
|
+
if (!ok) {
|
|
85
|
+
const err = new Error(`host 不在白名单: ${host}`);
|
|
86
|
+
err.code = 'HOST_NOT_ALLOWED';
|
|
87
|
+
throw err;
|
|
88
|
+
}
|
|
89
|
+
return url;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* 白名单体检:gitea/github/gitee 三节任一项命中 localhost/环回/私有/保留段字面量即抛错(启动期调用)。
|
|
94
|
+
* @param {{gitea?:{hostWhitelist?:string[]}, github?:{hostWhitelist?:string[]}}} cfg
|
|
95
|
+
* @returns {true}
|
|
96
|
+
*/
|
|
97
|
+
function validateWhitelist(cfg) {
|
|
98
|
+
validateWhitelistEntries((cfg && cfg.gitea && cfg.gitea.hostWhitelist) || []);
|
|
99
|
+
validateWhitelistEntries((cfg && cfg.github && cfg.github.hostWhitelist) || []);
|
|
100
|
+
return validateWhitelistEntries((cfg && cfg.gitee && cfg.gitee.hostWhitelist) || []);
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/**
|
|
104
|
+
* 白名单条目体检(通用形态,任务雷达 dingtalk.hostWhitelist 复用同一红线):
|
|
105
|
+
* 任一项命中 localhost/环回/私有/保留段字面量、或含协议前缀即抛错。
|
|
106
|
+
* @param {string[]} entries
|
|
107
|
+
* @returns {true}
|
|
108
|
+
*/
|
|
109
|
+
function validateWhitelistEntries(entries) {
|
|
110
|
+
const whitelist = entries || [];
|
|
111
|
+
for (const w of whitelist) {
|
|
112
|
+
if (isDangerousHost(w)) {
|
|
113
|
+
const err = new Error(`白名单含禁止的主机字面量: ${w}(localhost/环回/私有/保留段不得入白名单)`);
|
|
114
|
+
err.code = 'DANGEROUS_WHITELIST_ENTRY';
|
|
115
|
+
throw err;
|
|
116
|
+
}
|
|
117
|
+
// 白名单项若形如 http://xxx,说明写法错误,一并拒绝
|
|
118
|
+
if (String(w).includes('://')) {
|
|
119
|
+
const err = new Error(`白名单项必须是纯 host,不得含协议: ${w}`);
|
|
120
|
+
err.code = 'DANGEROUS_WHITELIST_ENTRY';
|
|
121
|
+
throw err;
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
return true;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/**
|
|
128
|
+
* host 是否命中白名单:精确相等,或为某条目的子域(点边界后缀匹配,如
|
|
129
|
+
* shanji.dingtalk.com 命中 dingtalk.com;evil-dingtalk.com 不命中)。
|
|
130
|
+
* 大小写不敏感。gitea 主链路继续走 assertSafeUrl 的精确匹配,行为不变。
|
|
131
|
+
* @param {string} host
|
|
132
|
+
* @param {string[]} entries
|
|
133
|
+
* @returns {boolean}
|
|
134
|
+
*/
|
|
135
|
+
function hostAllowed(host, entries) {
|
|
136
|
+
const h = String(host || '').toLowerCase().replace(/\.$/, '');
|
|
137
|
+
if (!h) return false;
|
|
138
|
+
return (entries || []).some((w) => {
|
|
139
|
+
const e = String(w || '').toLowerCase().trim().replace(/\.$/, '');
|
|
140
|
+
if (!e) return false;
|
|
141
|
+
return h === e || h.endsWith('.' + e);
|
|
142
|
+
});
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
module.exports = { assertSafeUrl, validateWhitelist, validateWhitelistEntries, hostAllowed, isDangerousHost };
|