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.
Files changed (85) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +128 -2
  3. package/README.zh-CN.md +130 -0
  4. package/assets/icon.svg +9 -0
  5. package/cordis.patch.yml +7 -0
  6. package/lib/agentActivity.js +1180 -0
  7. package/lib/agentContext.js +146 -0
  8. package/lib/agentTranscript.js +1398 -0
  9. package/lib/analyze.js +625 -0
  10. package/lib/attribute.js +205 -0
  11. package/lib/backup.js +366 -0
  12. package/lib/desktopAgents.js +123 -0
  13. package/lib/diary.js +333 -0
  14. package/lib/dingtalk.js +412 -0
  15. package/lib/feishu.js +580 -0
  16. package/lib/giteaClient.js +810 -0
  17. package/lib/giteeClient.js +372 -0
  18. package/lib/githubClient.js +361 -0
  19. package/lib/heatmap.js +99 -0
  20. package/lib/imNotify.js +378 -0
  21. package/lib/inbox.js +438 -0
  22. package/lib/instanceLock.js +122 -0
  23. package/lib/jobs.js +56 -0
  24. package/lib/learn.js +1388 -0
  25. package/lib/learnImport.js +283 -0
  26. package/lib/learnSeeds.js +97 -0
  27. package/lib/learnSeedsAiEng.js +77 -0
  28. package/lib/mcpCore.js +135 -0
  29. package/lib/members.js +160 -0
  30. package/lib/migration.js +403 -0
  31. package/lib/overview.js +376 -0
  32. package/lib/postmortem.js +148 -0
  33. package/lib/radarIgnore.js +134 -0
  34. package/lib/redact.js +76 -0
  35. package/lib/router.js +246 -0
  36. package/lib/routes-gitea.js +262 -0
  37. package/lib/routes-setup.js +40 -0
  38. package/lib/scorecard.js +111 -0
  39. package/lib/sessionRef.js +227 -0
  40. package/lib/sessionSnapshot.js +67 -0
  41. package/lib/sessionSuggest.js +186 -0
  42. package/lib/settings.js +783 -0
  43. package/lib/setupCheck.js +330 -0
  44. package/lib/ssrfGuard.js +145 -0
  45. package/lib/store.js +564 -0
  46. package/lib/storeDb.js +418 -0
  47. package/lib/taskEvents.js +243 -0
  48. package/lib/webhookOut.js +125 -0
  49. package/lib/weekly.js +439 -0
  50. package/lib/workSearch.js +220 -0
  51. package/locale/en.json +6 -0
  52. package/locale/zh.json +6 -0
  53. package/package.json +46 -4
  54. package/plugin/adapter.js +157 -0
  55. package/plugin/client.js +282 -0
  56. package/plugin/index.mjs +116 -0
  57. package/plugin/static.js +99 -0
  58. package/scripts/backup-data.js +41 -0
  59. package/scripts/mcp-server.mjs +68 -0
  60. package/scripts/migrate-data.js +301 -0
  61. package/scripts/migrate-storage.js +47 -0
  62. package/scripts/seed-demo.js +200 -0
  63. package/scripts/write-agent-context.js +43 -0
  64. package/test/helpers/appAssembler.js +1078 -0
  65. package/web/client/fde-client.js +292 -0
  66. package/web/css/app.css +1510 -0
  67. package/web/index.html +69 -0
  68. package/web/js/api.js +72 -0
  69. package/web/js/app.js +313 -0
  70. package/web/js/icons.js +48 -0
  71. package/web/js/mock.js +1150 -0
  72. package/web/js/state.js +7 -0
  73. package/web/js/ui.js +276 -0
  74. package/web/js/views/activity.js +410 -0
  75. package/web/js/views/agents.js +892 -0
  76. package/web/js/views/board.js +1656 -0
  77. package/web/js/views/learn.js +530 -0
  78. package/web/js/views/members.js +344 -0
  79. package/web/js/views/onboarding.js +103 -0
  80. package/web/js/views/overview.js +508 -0
  81. package/web/js/views/radar.js +1359 -0
  82. package/web/js/views/search.js +149 -0
  83. package/web/js/views/settings.js +1351 -0
  84. package/web/js/views/topology.js +471 -0
  85. package/web/mock.json +2363 -0
@@ -0,0 +1,361 @@
1
+ 'use strict';
2
+ // githubClient.js — v2.9 GitHub 组织动态源适配器。
3
+ // 数据源:GET {baseUrl}/orgs/{org}/events(组织级事件流,最新在前,per_page=100 × eventsPages),
4
+ // 事件映射到与 giteaClient 完全相同的 11 字段活动模型与词表(commit/pr/branch_created/branch_deleted):
5
+ // PushEvent.payload.commits[] 逐条 → 'commit'(sha/message 首行+正文首段/commit timestamp)
6
+ // PullRequestEvent action=opened|reopened → 'pr';action=closed 且 merged → 'pr'(同 url 经
7
+ // type|url 去重与 gitea 口径一致地坍缩为一条,occurredAt 取最新一次事件)
8
+ // CreateEvent ref_type=branch → 'branch_created';DeleteEvent ref_type=branch → 'branch_deleted'
9
+ // 其他事件类型(Watch/Fork/Issues/Release…)跳过 → skippedEventTypes 计数与 distinct 名单
10
+ // 红线(与 giteaClient 同一套):
11
+ // - 凭据 key:git config --global http.<github.baseUrl>/.extraheader(值形如 "Authorization: Bearer ghp_xxx")
12
+ // - 凭据仅存本模块内存(credCache)+ 注册进 redact;绝不写文件、不进子进程 env、不进日志
13
+ // - 出站前 assertSafeUrl(白名单 = cfg.github.hostWhitelist)+ redirect:'error'
14
+ // 状态落盘:data/github-status.json(独立文件,绝不与 gitea-status.json 互相覆盖)。
15
+ // enabled !== true 时零出网、零写盘(pollActivities 直接返回 null)。
16
+
17
+ const path = require('node:path');
18
+ const { execFileSync } = require('node:child_process');
19
+ const { redact, registerSecret } = require('./redact.js');
20
+ const { assertSafeUrl, validateWhitelist } = require('./ssrfGuard.js');
21
+ const gitea = require('./giteaClient.js');
22
+
23
+ const SEVEN_DAYS_MS = 7 * 24 * 3600 * 1000;
24
+ const REDACTED = '[REDACTED]';
25
+
26
+ // ---------------------------------------------------------------- credential
27
+
28
+ /** 凭据缓存:gitKey -> value|null。仅内存,进程退出即消失。 */
29
+ const credCache = new Map();
30
+
31
+ function credentialGitKey(cfg) {
32
+ return `http.${cfg.github.baseUrl}/.extraheader`;
33
+ }
34
+
35
+ /**
36
+ * 读 GitHub 预授权凭据(git config --global http.<baseUrl>/.extraheader)。
37
+ * 纪律与 giteaClient.readCredential 一致:execFileSync 直调、不经 shell、不注入 env、注册脱敏。
38
+ * @returns {string|null} 形如 "Authorization: Bearer ghp_xxx",未配置返回 null(匿名拉公共组织)
39
+ */
40
+ function readCredential(cfg) {
41
+ const gitKey = credentialGitKey(cfg);
42
+ if (credCache.has(gitKey)) return credCache.get(gitKey);
43
+ let value = null;
44
+ try {
45
+ const out = execFileSync('git', ['config', '--global', gitKey], {
46
+ encoding: 'utf8',
47
+ timeout: 5000,
48
+ windowsHide: true
49
+ // 不传 env —— 子进程环境变量里绝不出现凭据
50
+ });
51
+ value = String(out || '').trim() || null;
52
+ } catch {
53
+ value = null; // 未配置 = 无凭据,真实请求以匿名发出(公共组织可读,限流 60 次/时/IP)
54
+ }
55
+ if (value) {
56
+ registerSecret(value);
57
+ const idx = value.indexOf(':');
58
+ if (idx > 0) registerSecret(value.slice(idx + 1).trim());
59
+ }
60
+ credCache.set(gitKey, value);
61
+ return value;
62
+ }
63
+
64
+ function authHeaders(credential) {
65
+ const headers = {
66
+ Accept: 'application/vnd.github+json',
67
+ 'User-Agent': 'fde-console-activity-poller' // GitHub API 要求 UA,缺失返回 403
68
+ };
69
+ if (!credential) return headers;
70
+ const idx = credential.indexOf(':');
71
+ if (idx > 0) headers[credential.slice(0, idx).trim()] = credential.slice(idx + 1).trim();
72
+ else headers.Authorization = credential;
73
+ return headers;
74
+ }
75
+
76
+ // -------------------------------------------------------------------- http
77
+
78
+ async function fetchJson(url, credential, cfg, timeoutMs = 15000) {
79
+ assertSafeUrl(url, cfg); // 出站末级复检(白名单 = gitea ∪ github 两节)
80
+ const ac = new AbortController();
81
+ const timer = setTimeout(() => ac.abort(), timeoutMs);
82
+ try {
83
+ const res = await fetch(url, {
84
+ method: 'GET',
85
+ headers: authHeaders(credential),
86
+ signal: ac.signal,
87
+ redirect: 'error'
88
+ });
89
+ if (!res.ok) {
90
+ let detail = '';
91
+ try { detail = (await res.text()).slice(0, 200); } catch { /* ignore */ }
92
+ const err = new Error(redact(`GitHub HTTP ${res.status} ${res.statusText} ${detail} (${url})`));
93
+ err.status = res.status;
94
+ throw err;
95
+ }
96
+ return await res.json();
97
+ } catch (err) {
98
+ if (err instanceof Error && !err.message.includes(REDACTED)) err.message = redact(err.message);
99
+ throw err;
100
+ } finally {
101
+ clearTimeout(timer);
102
+ }
103
+ }
104
+
105
+ // ------------------------------------------------------------------ mapping
106
+
107
+ /** api 基址 → 网页基址(https://api.github.com → https://github.com;GHES https://host/api/v3 → https://host) */
108
+ function webBaseOf(baseUrl) {
109
+ const u = new URL(String(baseUrl));
110
+ const host = u.hostname.startsWith('api.') ? u.hostname.slice(4) : u.hostname;
111
+ return `${u.protocol}//${host}`;
112
+ }
113
+
114
+ function firstLine(s) {
115
+ return String(s || '').split('\n')[0].trim();
116
+ }
117
+
118
+ /** 提交说明正文首段(与 giteaClient.messageBodyOf 同口径:跳过首行与开头空行,收至下一空行,≤300 字) */
119
+ function messageBodyOf(message) {
120
+ const lines = String(message || '').split('\n').slice(1);
121
+ let i = 0;
122
+ while (i < lines.length && lines[i].trim() === '') i += 1;
123
+ const para = [];
124
+ while (i < lines.length && lines[i].trim() !== '') { para.push(lines[i]); i += 1; }
125
+ const text = para.join('\n').trim();
126
+ return text.length > 300 ? text.slice(0, 300) : text;
127
+ }
128
+
129
+ function stripRefsPrefix(ref) {
130
+ return String(ref || '').replace(/^refs\/heads\//, '');
131
+ }
132
+
133
+ /**
134
+ * GitHub org events → 活动数组(统一 11 字段,词表与 gitea 一致)。
135
+ * @returns {{activities: object[], skippedEventCount: number, skippedEventTypes: string[]}}
136
+ */
137
+ function mapEvents(events, sinceMs, fetchedAt, webBase) {
138
+ const activities = [];
139
+ const skippedTypes = new Set();
140
+ let skippedEventCount = 0;
141
+
142
+ for (const e of events || []) {
143
+ if (!e) continue;
144
+ const type = String(e.type || '');
145
+ const actor = (e.actor && e.actor.login) || null;
146
+ const repo = (e.repo && e.repo.name) || '';
147
+ const created = String(e.created_at || '');
148
+ const createdMs = Date.parse(created);
149
+ if (Number.isFinite(createdMs) && createdMs < sinceMs) continue; // 条目整体落窗外
150
+
151
+ if (type === 'PushEvent') {
152
+ const payload = e.payload || {};
153
+ const branch = stripRefsPrefix(payload.ref) || null;
154
+ const commits = Array.isArray(payload.commits) ? payload.commits : [];
155
+ for (const c of commits) {
156
+ if (!c || !c.sha) continue;
157
+ const ts = Date.parse(c.timestamp);
158
+ const occurredAt = Number.isFinite(ts) ? String(c.timestamp) : created;
159
+ const occMs = Number.isFinite(ts) ? ts : createdMs;
160
+ if (Number.isFinite(occMs) && occMs < sinceMs) continue;
161
+ activities.push({
162
+ type: 'commit',
163
+ actor,
164
+ repo: repo || null,
165
+ branch,
166
+ sha: String(c.sha),
167
+ title: firstLine(c.message),
168
+ messageBody: messageBodyOf(c.message),
169
+ url: `${webBase}/${repo}/commit/${c.sha}`,
170
+ occurredAt,
171
+ fetchedAt
172
+ });
173
+ }
174
+ continue;
175
+ }
176
+
177
+ if (type === 'PullRequestEvent') {
178
+ const payload = e.payload || {};
179
+ const pr = payload.pull_request || {};
180
+ const opened = payload.action === 'opened' || payload.action === 'reopened';
181
+ // 真机探针实证:GitHub 会发 action:"merged"(文档未列)——与 closed+merged 同样映射为 pr
182
+ const merged = (payload.action === 'closed' && pr.merged === true) || payload.action === 'merged';
183
+ if (opened || merged) {
184
+ const num = payload.number != null ? payload.number : pr.number;
185
+ activities.push({
186
+ type: 'pr',
187
+ actor,
188
+ repo: repo || null,
189
+ branch: null,
190
+ sha: null,
191
+ title: firstLine(pr.title) || (num != null ? `PR #${num}` : 'PR'),
192
+ messageBody: '',
193
+ url: String(pr.html_url || (num != null && repo ? `${webBase}/${repo}/pulls/${num}` : '')),
194
+ occurredAt: created,
195
+ fetchedAt
196
+ });
197
+ } else {
198
+ skippedEventCount += 1; // synchronize/closed(未合并)/assigned 等不进动态流
199
+ skippedTypes.add(`${type}:${payload.action || '?'}`);
200
+ }
201
+ continue;
202
+ }
203
+
204
+ if (type === 'CreateEvent' || type === 'DeleteEvent') {
205
+ const payload = e.payload || {};
206
+ if (payload.ref_type === 'branch' && payload.ref) {
207
+ const branch = String(payload.ref);
208
+ activities.push({
209
+ type: type === 'CreateEvent' ? 'branch_created' : 'branch_deleted',
210
+ actor,
211
+ repo: repo || null,
212
+ branch,
213
+ sha: null,
214
+ title: branch,
215
+ messageBody: '',
216
+ url: `${webBase}/${repo}/tree/${branch.split('/').map(encodeURIComponent).join('/')}`,
217
+ occurredAt: created,
218
+ fetchedAt
219
+ });
220
+ continue;
221
+ }
222
+ skippedEventCount += 1; // ref_type=repository/tag 等
223
+ skippedTypes.add(`${type}:${payload.ref_type || '?'}`);
224
+ continue;
225
+ }
226
+
227
+ skippedEventCount += 1;
228
+ if (type) skippedTypes.add(type);
229
+ }
230
+ return { activities, skippedEventCount, skippedEventTypes: [...skippedTypes] };
231
+ }
232
+
233
+ // -------------------------------------------------------------------- poll
234
+
235
+ /**
236
+ * 轮询 GitHub 组织事件 → 与 Gitea 源共写同一 data/activities.json(mergeActivities 口径一致)。
237
+ * 状态写 data/github-status.json(独立文件)。enabled !== true 时零出网零写盘返回 null。
238
+ * @param {object} [cfg] 缺省 gitea.loadConfig()
239
+ * @returns {Promise<object[]|null>} 落盘后的全量 activity 数组(倒序);源未启用返回 null
240
+ * @throws HOST_NOT_ALLOWED / DANGEROUS_WHITELIST_ENTRY / GITHUB_ERROR(message 已脱敏)
241
+ */
242
+ async function pollActivities(cfg) {
243
+ const conf = cfg || gitea.loadConfig();
244
+ const gh = conf.github || {};
245
+ if (gh.enabled !== true) return null;
246
+ validateWhitelist(conf);
247
+
248
+ const fetchedAt = new Date().toISOString();
249
+ const sinceMs = Date.now() - SEVEN_DAYS_MS;
250
+ const base = String(gh.baseUrl || 'https://api.github.com').replace(/\/+$/, '');
251
+ const org = String(gh.org || '').trim();
252
+ const pages = Number(gh.eventsPages) > 0 ? Math.min(Number(gh.eventsPages), 10) : 3;
253
+
254
+ let ok = true;
255
+ let lastError = null;
256
+ let rawEvents = [];
257
+ let skippedEventCount = 0;
258
+ const skippedTypeSet = new Set();
259
+
260
+ try {
261
+ if (!org) throw new Error('github.org 未配置');
262
+ const credential = readCredential(conf);
263
+ for (let page = 1; page <= pages; page++) {
264
+ const arr = await fetchJson(`${base}/orgs/${encodeURIComponent(org)}/events?per_page=100&page=${page}`, credential, conf);
265
+ const list = Array.isArray(arr) ? arr : [];
266
+ const mapped = mapEvents(list, sinceMs, fetchedAt, webBaseOf(base));
267
+ rawEvents.push(...mapped.activities);
268
+ skippedEventCount += mapped.skippedEventCount;
269
+ for (const t of mapped.skippedEventTypes) skippedTypeSet.add(t);
270
+ if (list.length < 100) break; // 末页
271
+ }
272
+ } catch (err) {
273
+ ok = false;
274
+ lastError = redact((err && err.message) || String(err));
275
+ if (err && (err.code === 'HOST_NOT_ALLOWED' || err.code === 'DANGEROUS_WHITELIST_ENTRY')) {
276
+ // 守卫错误:状态照记,错误原码上抛(路由映射 400 而非 502)
277
+ writeStatus(conf, { enabled: true, ok: false, lastPollAt: fetchedAt, lastError, skippedEventCount, skippedEventTypes: [...skippedTypeSet] });
278
+ throw err;
279
+ }
280
+ }
281
+
282
+ // 与 Gitea 源同一存储:读现库 → 合并去重(type|url)→ 滚动 ≤maxActivities → 原子写回
283
+ const max = (conf.gitea && conf.gitea.maxActivities) || 500;
284
+ const merged = gitea.mergeActivities(gitea.readExistingActivities(conf), rawEvents, max);
285
+ // v2.9.33 批次 2:activities 写统一出口(存储迁移后经 store.saveActivities 路由)
286
+ require('./store.js').saveActivities({ activitiesPath: gitea.resolveDataPath(conf, 'activities.json') }, merged);
287
+ writeStatus(conf, {
288
+ enabled: true,
289
+ ok,
290
+ lastPollAt: fetchedAt,
291
+ lastError,
292
+ skippedEventCount,
293
+ skippedEventTypes: [...skippedTypeSet]
294
+ });
295
+
296
+ // 归因钩子与 Gitea 轮询同款:失败只记日志,不影响已落盘数据
297
+ try {
298
+ require('./attribute.js').attributeAfterPoll(conf);
299
+ } catch (err) {
300
+ console.error('[attribute] GitHub 轮询后归因失败(不影响轮询):', redact((err && err.message) || String(err)));
301
+ }
302
+
303
+ if (!ok) {
304
+ const err = new Error(lastError || 'GitHub 拉取失败');
305
+ err.code = 'GITHUB_ERROR';
306
+ throw err;
307
+ }
308
+ return merged;
309
+ }
310
+
311
+ function writeStatus(cfg, status) {
312
+ try {
313
+ gitea.atomicWrite(gitea.resolveDataPath(cfg, 'github-status.json'), JSON.stringify(status, null, 2));
314
+ } catch (err) {
315
+ console.error('[github] 状态文件写入失败:', redact((err && err.message) || String(err)));
316
+ }
317
+ }
318
+
319
+ /**
320
+ * 连接探测(v2.9.19 设置页「测试连接」后端):拉 events 第 1 页 per_page=1(最小流量),
321
+ * 返回 ok/延迟/是否带令牌/最新一条摘要。**不改任何状态文件、与 enabled 开关无关**(开之前先试)。
322
+ * @param {object} cfg 运行期配置
323
+ * @param {{org?:string, baseUrl?:string}} [override] 表单当前值覆盖(保存前先测)
324
+ * @returns {Promise<{ok:boolean, latencyMs:number, hasToken:boolean, total?:number,
325
+ * latest?:{type:string,repo:string,occurredAt:string}, error?:string, code?:string}>} 永不 throw
326
+ */
327
+ async function testConnection(cfg, override = {}) {
328
+ const gh = { ...(cfg.github || {}) };
329
+ if (override.org !== undefined && String(override.org).trim()) gh.org = String(override.org).trim();
330
+ if (override.baseUrl !== undefined && String(override.baseUrl).trim()) gh.baseUrl = String(override.baseUrl).trim();
331
+ const conf = { ...cfg, github: gh };
332
+ const started = Date.now();
333
+ const org = String(gh.org || '').trim();
334
+ if (!org) return { ok: false, latencyMs: 0, hasToken: false, error: 'org 未配置(先填组织名)' };
335
+ try {
336
+ const credential = readCredential(conf);
337
+ const base = String(gh.baseUrl || 'https://api.github.com').replace(/\/+$/, '');
338
+ const arr = await fetchJson(`${base}/orgs/${encodeURIComponent(org)}/events?per_page=1&page=1`, credential, conf);
339
+ const list = Array.isArray(arr) ? arr : [];
340
+ const latest = list[0];
341
+ return {
342
+ ok: true,
343
+ latencyMs: Date.now() - started,
344
+ hasToken: !!credential,
345
+ total: list.length,
346
+ latest: latest
347
+ ? { type: String(latest.type || ''), repo: (latest.repo && latest.repo.name) || '', occurredAt: String(latest.created_at || '') }
348
+ : null
349
+ };
350
+ } catch (err) {
351
+ return {
352
+ ok: false,
353
+ latencyMs: Date.now() - started,
354
+ hasToken: !!readCredential(conf),
355
+ error: redact((err && err.message) || String(err)),
356
+ code: err && err.code
357
+ };
358
+ }
359
+ }
360
+
361
+ module.exports = { pollActivities, readCredential, mapEvents, webBaseOf, testConnection };
package/lib/heatmap.js ADDED
@@ -0,0 +1,99 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * heatmap.js — v2.9.26 Agent 时间线热力图(「AI 编码时代的 WakaTime」)
5
+ *
6
+ * 六源会话按「日 × agent」聚合会话数与活跃时长。数据面=listAgentSessions 每源最近 50 条
7
+ * (startedAt/lastActiveAt 现成,零新读入;50 条帽=概览口径,审计走会话阅读器)。
8
+ * 口径:会话计入 lastActiveAt 所在日(本地时区);时长=clamp(lastActive-started, 1min, 6h)——
9
+ * 跨夜挂起会话整段计入最后活跃日、钳 6h 防单会话撑爆一格。
10
+ * 输出:{days:[{date, agents:{<agent>:{sessions,minutes}}}], agents, totalSessions, totalMinutes, generatedAt}
11
+ * 全只读零写盘零出网;单源故障该源零贡献不拖垮整体。
12
+ */
13
+
14
+ const { sendJSON } = require('./router');
15
+ const at = require('./agentTranscript');
16
+ const snapshot = require('./sessionSnapshot');
17
+
18
+ const DAY_MS = 24 * 3600 * 1000;
19
+ const DEFAULT_DAYS = 28;
20
+ const MAX_DAYS = 90;
21
+ const MINUTES_CAP_PER_SESSION = 360; // 单会话时长钳制 6h
22
+ const MINUTES_FLOOR = 1; // 有会话活动至少计 1 分钟
23
+
24
+ /** 本地时区 YYYY-MM-DD(与日报/周报 dayKey 同口径) */
25
+ function localYmd(ts) {
26
+ const d = new Date(ts);
27
+ return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
28
+ }
29
+
30
+ /**
31
+ * buildHeatmap(config, opts) → 聚合结果(见文件头)
32
+ * @param {{days?:number, now?:number, adapters?:object}} opts
33
+ * adapters: 源 id → () => items[] 注入缝(测试用;返回与 listAgentSessions.items 同形状)
34
+ */
35
+ function buildHeatmap(config, opts) {
36
+ const o = opts || {};
37
+ const now = Number.isFinite(o.now) ? o.now : Date.now();
38
+ const days = Math.min(Math.max(Number(o.days) || DEFAULT_DAYS, 1), MAX_DAYS);
39
+ const sinceDayStart = new Date(now - (days - 1) * DAY_MS);
40
+ sinceDayStart.setHours(0, 0, 0, 0);
41
+ const sinceMs = sinceDayStart.getTime();
42
+
43
+ const perDayAgent = new Map(); // ymd -> Map(agent -> {sessions, minutes})
44
+ const agentSet = new Set();
45
+ let totalSessions = 0;
46
+ let totalMinutes = 0;
47
+
48
+ // v2.9.29 D3:六源会话统一走 sessionSnapshot(60s TTL 共享快照;adapters 纯注入语义不变)
49
+ const { byAgent: snapByAgent } = snapshot.getSnapshot(config, { now, adapters: o.adapters });
50
+
51
+ for (const agent of at.SOURCE_IDS) {
52
+ const items = snapByAgent[agent] || [];
53
+ for (const it of items) {
54
+ const lastMs = Date.parse(it.lastActiveAt);
55
+ if (!Number.isFinite(lastMs) || lastMs < sinceMs) continue;
56
+ const startMs = Date.parse(it.startedAt);
57
+ let minutes = MINUTES_FLOOR;
58
+ if (Number.isFinite(startMs) && lastMs > startMs) {
59
+ minutes = Math.min(Math.max(Math.round((lastMs - startMs) / 60000), MINUTES_FLOOR), MINUTES_CAP_PER_SESSION);
60
+ }
61
+ const ymd = localYmd(lastMs);
62
+ if (!perDayAgent.has(ymd)) perDayAgent.set(ymd, new Map());
63
+ const byAgent = perDayAgent.get(ymd);
64
+ if (!byAgent.has(agent)) byAgent.set(agent, { sessions: 0, minutes: 0 });
65
+ const entry = byAgent.get(agent);
66
+ entry.sessions += 1;
67
+ entry.minutes += minutes;
68
+ agentSet.add(agent);
69
+ totalSessions += 1;
70
+ totalMinutes += minutes;
71
+ }
72
+ }
73
+
74
+ return {
75
+ days: Array.from({ length: days }, (_, i) => {
76
+ const ymd = localYmd(sinceMs + i * DAY_MS);
77
+ const byAgent = perDayAgent.get(ymd) || new Map();
78
+ return {
79
+ date: ymd,
80
+ agents: Object.fromEntries([...byAgent].map(([a, c]) => [a, { sessions: c.sessions, minutes: c.minutes }])),
81
+ };
82
+ }),
83
+ agents: [...agentSet],
84
+ totalSessions,
85
+ totalMinutes,
86
+ generatedAt: new Date(now).toISOString(),
87
+ };
88
+ }
89
+
90
+ /** 路由挂载:GET /api/agent-heatmap?days=28(days 钳 1..90) */
91
+ function registerHeatmapRoute(router, ctx) {
92
+ router.add('GET', '/api/agent-heatmap', (c) => {
93
+ const raw = c.query.get('days');
94
+ const n = raw === null || raw === '' ? undefined : Number(raw);
95
+ sendJSON(c.res, 200, buildHeatmap(ctx.config, { days: n }));
96
+ });
97
+ }
98
+
99
+ module.exports = { buildHeatmap, registerHeatmapRoute, localYmd, DEFAULT_DAYS, MAX_DAYS };