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,125 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * webhookOut.js — v2.9.27 Webhook 事件出口(把钉钉专有雷达泛化成开放集成)
5
+ *
6
+ * 任务事件(artifact/memo/diary/status…)落盘后向用户自配 webhook POST JSON——
7
+ * Slack/Discord/飞书/自建机器人皆可接。纪律:
8
+ * - fire-and-forget:绝不阻塞任务写路径;任何失败只 console.error(message 过 redact)
9
+ * - enabled !== true 或 url 空 → 零出网
10
+ * - URL 校验:仅 http(s);拒绝回环/私网/链路本地字面量(SSRF 出站末级闸;与数据源白名单
11
+ * 机制不同源——webhook 是用户主动出站,本模块自带私网闸,不经 ssrfGuard 白名单)
12
+ * - 凭据红线:url 里可含 token(如 Discord ?wait=true&token=xxx)——config.json 是既有
13
+ * 配置落点(同钉钉 dws 凭据先例);错误出口 scrubUrl 剥 query 值 + redact 双防线
14
+ * - 超时 8s AbortController;失败不重试(事件流有 500 条滚动窗兜底,下游自行对账)
15
+ */
16
+
17
+ const gitea = require('./giteaClient');
18
+ const { redact } = require('./redact');
19
+
20
+ const TIMEOUT_MS = 8000;
21
+ const MAX_EVENTS_PER_POST = 20;
22
+
23
+ /** webhook URL 出站闸:http(s) + 私网/回环/链路本地字面量拒绝(返回 {ok, reason}) */
24
+ function guardWebhookUrl(rawUrl) {
25
+ let u;
26
+ try {
27
+ u = new URL(String(rawUrl || ''));
28
+ } catch (e) {
29
+ return { ok: false, reason: 'URL 无法解析' };
30
+ }
31
+ if (u.protocol !== 'http:' && u.protocol !== 'https:') return { ok: false, reason: '仅放行 http/https' };
32
+ const host = String(u.hostname || '').toLowerCase();
33
+ if (host === 'localhost' || host.endsWith('.localhost') || host === '[::1]' || host === '::1') {
34
+ return { ok: false, reason: '回环地址禁止' };
35
+ }
36
+ // IPv4 字面量:回环/私网/链路本地(IPv6 完整校验不做——字面量级闸 + 文档声明)
37
+ const m = host.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
38
+ if (m) {
39
+ const o = m.slice(1).map(Number);
40
+ if (o.some((x) => x > 255)) return { ok: false, reason: '非法 IPv4' };
41
+ const [a, b] = o;
42
+ const isPrivate =
43
+ a === 127 || a === 10 || a === 0 ||
44
+ (a === 172 && b >= 16 && b <= 31) ||
45
+ (a === 192 && b === 168) ||
46
+ (a === 169 && b === 254);
47
+ if (isPrivate) return { ok: false, reason: '私网/链路本地地址禁止(webhook 目标应为公网可达端点)' };
48
+ }
49
+ return { ok: true, url: u };
50
+ }
51
+
52
+ /** 错误 URL 脱敏:query 值剥为 [REDACTED](webhook token 常在 query),再过 redact */
53
+ function scrubUrl(u) {
54
+ try {
55
+ const c = new URL(String(u));
56
+ for (const k of [...c.searchParams.keys()]) c.searchParams.set(k, '[REDACTED]');
57
+ return redact(c.toString());
58
+ } catch (e) {
59
+ return '[URL]';
60
+ }
61
+ }
62
+
63
+ /**
64
+ * fireTaskEvents(configOrLoader, events, opts) — 同步入口、异步派发(不 await、不抛出)。
65
+ * @param {object|function} configOrLoader cfg 对象(测试直传)或 config 懒加载器(生产:TTL 缓存,
66
+ * D1 修复——appendEvents 是全系统最热的写路径,禁用态也不该每事件一次 readFileSync)
67
+ * @param {Array<{taskId,type,detail,at}>} events taskEvents.makeEvent 形态
68
+ * @param {{fetcher?:function}} opts fetcher 注入缝(测试用;默认全局 fetch)
69
+ */
70
+ const CONFIG_TTL_MS = 60 * 1000; // webhookOut 仅手改 config.json,60s 缓存延迟可接受(与轮询周期同量级)
71
+ let cfgCache = { at: 0, sec: null };
72
+
73
+ function webhookSecOf(configOrLoader) {
74
+ if (typeof configOrLoader !== 'function') {
75
+ return (configOrLoader && configOrLoader.webhookOut) || {};
76
+ }
77
+ const now = Date.now();
78
+ if (now - cfgCache.at < CONFIG_TTL_MS && cfgCache.sec) return cfgCache.sec;
79
+ let sec = {};
80
+ try {
81
+ const cfg = configOrLoader();
82
+ sec = (cfg && cfg.webhookOut) || {};
83
+ } catch (e) {
84
+ sec = {}; // 读配置失败=视为关闭(写路径绝不因出口故障失败)
85
+ }
86
+ cfgCache = { at: now, sec };
87
+ return sec;
88
+ }
89
+
90
+ function fireTaskEvents(configOrLoader, events, opts) {
91
+ const o = opts || {};
92
+ const list = Array.isArray(events) ? events.filter(Boolean).slice(0, MAX_EVENTS_PER_POST) : [];
93
+ if (!list.length) return { fired: 0, reason: '无事件' }; // 先走零成本闸,再碰配置
94
+ const sec = webhookSecOf(configOrLoader);
95
+ if (sec.enabled !== true) return { fired: 0, reason: 'disabled' };
96
+ const url = String(sec.url || '').trim();
97
+ if (!url) return { fired: 0, reason: 'url 未配置' };
98
+ const guard = guardWebhookUrl(url);
99
+ if (!guard.ok) return { fired: 0, reason: guard.reason };
100
+
101
+ const fetcher = typeof o.fetcher === 'function' ? o.fetcher : globalThis.fetch;
102
+ if (typeof fetcher !== 'function') return { fired: 0, reason: '无 fetch 实现' };
103
+
104
+ const payload = JSON.stringify({ source: 'fde-console', sentAt: new Date().toISOString(), events: list });
105
+ Promise.resolve()
106
+ .then(() =>
107
+ fetcher(url, {
108
+ method: 'POST',
109
+ headers: { 'Content-Type': 'application/json', 'User-Agent': 'fde-console-webhook/1.0' },
110
+ body: payload,
111
+ signal: AbortSignal.timeout(TIMEOUT_MS),
112
+ })
113
+ )
114
+ .then((res) => {
115
+ if (!res || res.status >= 300) {
116
+ console.error(`[webhook] 下游响应异常 status=${res ? res.status : '无'} url=${scrubUrl(url)}`);
117
+ }
118
+ })
119
+ .catch((e) => {
120
+ console.error(`[webhook] 派发失败 url=${scrubUrl(url)}:`, redact(String((e && e.message) || e)));
121
+ });
122
+ return { fired: list.length };
123
+ }
124
+
125
+ module.exports = { fireTaskEvents, guardWebhookUrl, scrubUrl, MAX_EVENTS_PER_POST, TIMEOUT_MS, clearConfigCache: () => { cfgCache = { at: 0, sec: null }; } };
package/lib/weekly.js ADDED
@@ -0,0 +1,439 @@
1
+ 'use strict';
2
+ /**
3
+ * weekly.js — v2.9.6 数字员工报告(日报 + 周报):聚合「智能体动态」会话数据做养料,
4
+ * 经 harness 引擎(dsh --profile headless,与雷达拆解同一通道)萃取蒸馏成 Markdown。
5
+ *
6
+ * 两种报告共用一条管线,仅参数不同:
7
+ * 日报 daily:时间窗 1 天,内容抽样 20 条,≤300 字;自动档——每天 ≥08:00 首个轮询 tick
8
+ * 自动生成(当日已有/未到点/失败未满 1h 则跳过),落 data/report-daily.json
9
+ * 周报 weekly:时间窗 7 天,内容抽样 35 条,≤600 字;手动生成,落 data/weekly.json
10
+ *
11
+ * 养料四路(全部只读本地数据,零新采集):
12
+ * ① 各桌面源会话(agentTranscript 六源列表:标题/项目/状态 + 首问⇒末答内容萃取)
13
+ * ② Gitea 提交/PR(activities.json,滤除 [demo-team] 机器人统计提交)
14
+ * ③ 任务动态(完成/进行中)
15
+ * ④ 人工日报(diary.json)
16
+ *
17
+ * 引擎红线与 analyze 完全一致:DSH_FIXTURE 离线替代 stdout(测试零出网);
18
+ * 引擎超时 600s(雷达实证:推理模型大 prompt 300s 不够);日志经 redact。
19
+ */
20
+
21
+ const fs = require('node:fs');
22
+ const { redact } = require('./redact.js');
23
+ const store = require('./store.js');
24
+ const diaryMod = require('./diary.js');
25
+ const gitea = require('./giteaClient.js');
26
+ const jobs = require('./jobs.js');
27
+ const { listAgentSessions, getAgentTranscript, normalizeProjectKey } = require('./agentTranscript.js');
28
+ const { runHeadless, runHeadlessFixture } = require('./analyze.js');
29
+ const { HttpError, sendJSON } = require('./router.js');
30
+
31
+ const SOURCE_IDS = ['zcode', 'claude', 'dsh', 'codex', 'opencode', 'workbuddy'];
32
+ const MAX_SESSION_LINES = 120; // 喂给引擎的会话行数上限(防爆 prompt)
33
+ const WEEKLY_TIMEOUT_SEC = 600; // 引擎超时(雷达实证:推理模型大 prompt 300s 不够)
34
+ const TITLE_CLIP = 80;
35
+ const COMMIT_TITLE_CLIP = 60;
36
+ const DIARY_CLIP = 200;
37
+
38
+ /** 两种报告的参数档 */
39
+ const KINDS = {
40
+ daily: {
41
+ rangeDays: 1,
42
+ file: 'report-daily.json',
43
+ maxContent: 20, firstClip: 120, lastClip: 100,
44
+ keyField: 'dayKey', timeoutSec: WEEKLY_TIMEOUT_SEC,
45
+ },
46
+ weekly: {
47
+ rangeDays: 7,
48
+ file: 'weekly.json',
49
+ maxContent: 35, firstClip: 150, lastClip: 120,
50
+ keyField: 'weekKey', timeoutSec: WEEKLY_TIMEOUT_SEC,
51
+ },
52
+ };
53
+
54
+ function clip(s, n) {
55
+ const t = String(s || '').replace(/\s+/g, ' ').trim();
56
+ return t.length > n ? `${t.slice(0, n)}…` : t;
57
+ }
58
+
59
+ function dataPath(cfg, name) {
60
+ return gitea.resolveDataPath(cfg, name);
61
+ }
62
+
63
+ function readJsonArray(file) {
64
+ try {
65
+ const j = JSON.parse(fs.readFileSync(file, 'utf8'));
66
+ return Array.isArray(j) ? j : [];
67
+ } catch {
68
+ return [];
69
+ }
70
+ }
71
+
72
+ // bot 统计提交标记(读取时归一,AGENTS 词表纪律):开源换名 [demo-team] 与存量部署历史 [teamai]
73
+ // 双认——bot 工具产出的标题不随本仓改名,只滤新词会漏滤历史/未来真机提交(评审 P1)
74
+ const BOT_MARKERS = ['[demo-team]', '[teamai]'];
75
+ function isBotCommit(a) {
76
+ const title = String((a && a.title) || '');
77
+ return BOT_MARKERS.some((m) => title.toLowerCase().startsWith(m.toLowerCase()));
78
+ }
79
+
80
+ /** 服务器本地日期 YYYY-MM-DD(日报自动档「今日已有」判定与 dayKey 用) */
81
+ function localYmd(d) {
82
+ const x = d instanceof Date ? d : new Date(d || Date.now());
83
+ return `${x.getFullYear()}-${String(x.getMonth() + 1).padStart(2, '0')}-${String(x.getDate()).padStart(2, '0')}`;
84
+ }
85
+
86
+ /** 今日本地 00:00 的毫秒值 */
87
+ function todayStartMs(now) {
88
+ const d = new Date(now);
89
+ d.setHours(0, 0, 0, 0);
90
+ return d.getTime();
91
+ }
92
+
93
+ /**
94
+ * 自然时间窗(业主拍板口径:报告严格只含其名义周期,绝不混入周期外数据):
95
+ * 日报 = 昨日自然日(昨日 00:00 → 今日 00:00);周报 = 上周自然周(上周一 00:00 → 本周一 00:00)。
96
+ */
97
+ function naturalRange(kind, now) {
98
+ const start = todayStartMs(now);
99
+ if (kind === 'daily') return { since: start - 24 * 3600 * 1000, until: start };
100
+ const dow = (new Date(start).getDay() + 6) % 7; // 周一=0
101
+ const thisMonday = start - dow * 24 * 3600 * 1000;
102
+ return { since: thisMonday - 7 * 24 * 3600 * 1000, until: thisMonday };
103
+ }
104
+
105
+ // ---------------------------------------------------------------- 养料聚合
106
+
107
+ /**
108
+ * 聚合最近 rangeDays 天的四路养料(纯确定性,可单测)。
109
+ * opts: {now, days, maxContent, firstClip, lastClip, listSessions, getTranscript}
110
+ * bot 提交(title 以 [demo-team] 开头)一律排除。
111
+ */
112
+ function collectWeeklyFacts(ctx, opts = {}) {
113
+ const kind = KINDS[opts.kind || 'weekly'] || KINDS.weekly;
114
+ const now = Number.isFinite(opts.now) ? opts.now : Date.now();
115
+ // 窗口优先级:显式 range(自然日/自然周,generateReport 传入)> days 滚动窗(兼容旧测试)。
116
+ // until 为开区间上界(自然窗口严格不含周期外数据)
117
+ let since;
118
+ let until;
119
+ if (opts.range && Number.isFinite(opts.range.since) && Number.isFinite(opts.range.until)) {
120
+ since = opts.range.since;
121
+ until = opts.range.until;
122
+ } else {
123
+ since = now - (Number(opts.days) || kind.rangeDays) * 24 * 3600 * 1000;
124
+ until = now + 60000;
125
+ }
126
+ const inRange = (iso) => {
127
+ const t = Date.parse(iso);
128
+ return Number.isFinite(t) && t >= since && t < until;
129
+ };
130
+ const maxContent = Number.isFinite(opts.maxContent) ? opts.maxContent : kind.maxContent;
131
+ const firstClipN = Number.isFinite(opts.firstClip) ? opts.firstClip : kind.firstClip;
132
+ const lastClipN = Number.isFinite(opts.lastClip) ? opts.lastClip : kind.lastClip;
133
+ // 会话取数可注入(测试确定性;缺省走真实六源 listAgentSessions)
134
+ const fetchPage = typeof opts.listSessions === 'function'
135
+ ? opts.listSessions
136
+ : (agent, cursor) => listAgentSessions(ctx.config, { agent, limit: 50, cursor, now });
137
+ // 转录取样可注入(默认真实 getAgentTranscript;workbuddy 等无转录源 degraded 自然跳过)
138
+ const fetchTranscript = typeof opts.getTranscript === 'function'
139
+ ? opts.getTranscript
140
+ : (ref) => getAgentTranscript(ctx.config, ref, {});
141
+
142
+ // ① 数字员工会话(六源,逐源翻页拉到时间窗外或翻尽;单源故障该源缺席不拖垮报告)
143
+ const sessions = [];
144
+ const perAgent = {};
145
+ for (const agent of SOURCE_IDS) {
146
+ let collected = 0;
147
+ let cursor = null;
148
+ let exhausted = false;
149
+ for (let page = 0; page < 4 && !exhausted && sessions.length < MAX_SESSION_LINES; page++) {
150
+ let r;
151
+ try {
152
+ r = fetchPage(agent, cursor);
153
+ } catch (e) {
154
+ break; // 单源故障隔离
155
+ }
156
+ let outOfRange = false;
157
+ let unparsable = 0;
158
+ for (const it of r.items || []) {
159
+ const t = Date.parse(it.lastActiveAt);
160
+ // 列表新→旧:比窗口新的条目(日报/周报生成时的「今天」)只能跳过不能止——
161
+ // 止了就把整窗漏掉(2026-11-03 真机事故:日报采 zcode/codex 全 0,因当天会话排最前触发出窗即止)
162
+ if (!Number.isFinite(t)) {
163
+ unparsable += 1; // 时间不可解析静默跳过=红线 8 盲区(评审 P2):留痕一条,防「源坏了表现成没干活」
164
+ continue;
165
+ }
166
+ if (t >= until) continue;
167
+ if (t < since) { outOfRange = true; break; } // 越过窗口下界:该源采集结束
168
+ if (sessions.length >= MAX_SESSION_LINES) break;
169
+ sessions.push({
170
+ agent,
171
+ ref: it.ref || '',
172
+ title: clip(it.title, TITLE_CLIP),
173
+ project: it.projectId || '',
174
+ state: it.state || '',
175
+ lastActiveAt: it.lastActiveAt,
176
+ });
177
+ collected += 1;
178
+ }
179
+ perAgent[agent] = (perAgent[agent] || 0) + collected;
180
+ if (outOfRange || !r.nextCursor || sessions.length >= MAX_SESSION_LINES) exhausted = true;
181
+ cursor = r.nextCursor;
182
+ if (unparsable > 0) {
183
+ console.error(`[weekly] ${agent} 有 ${unparsable} 条会话 lastActiveAt 不可解析(已跳过,不进报告)`);
184
+ }
185
+ }
186
+ if (!perAgent[agent]) perAgent[agent] = 0;
187
+ }
188
+
189
+ // ①b 内容机械萃取(两级蒸馏的第一层):按最近优先抽 maxContent 条,逐条读转录抽
190
+ // 「首条用户消息(任务指令)⇒ 末条助手消息(交付结果)」。单会话转录失败跳过不炸整体。
191
+ const byRecent = sessions.filter((s) => s.ref).sort((a, b) => Date.parse(b.lastActiveAt) - Date.parse(a.lastActiveAt));
192
+ let contentSessions = 0;
193
+ for (const s of byRecent.slice(0, maxContent)) {
194
+ try {
195
+ const t = fetchTranscript(s.ref);
196
+ if (!t || t.degraded || !Array.isArray(t.messages) || t.messages.length === 0) continue;
197
+ const firstUser = t.messages.find((m) => m.role === 'user');
198
+ const lastAssistant = t.messages.slice().reverse().find((m) => m.role === 'assistant');
199
+ const digest = [
200
+ firstUser ? clip(firstUser.text, firstClipN) : '',
201
+ lastAssistant ? clip(lastAssistant.text, lastClipN) : '',
202
+ ].filter(Boolean).join(' ⇒ ');
203
+ if (digest) { s.digest = digest; contentSessions += 1; }
204
+ } catch (e) { /* 单会话失败跳过 */ }
205
+ }
206
+
207
+ // ② Gitea 提交/PR(滤 bot;读走 store 路由——2026-11-03 评审 P1:直读 JSON 在已迁移实例上静默断粮)
208
+ const acts = store
209
+ .loadActivities(ctx)
210
+ .filter((a) => (a.type === 'commit' || a.type === 'pr' || a.type === 'commit_pushed' || a.type === 'pr_opened' || a.type === 'pr_merged'))
211
+ .filter((a) => inRange(a.occurredAt))
212
+ .filter((a) => !isBotCommit(a));
213
+ const byActor = new Map();
214
+ for (const a of acts) {
215
+ const actor = a.actor || 'unknown';
216
+ if (!byActor.has(actor)) byActor.set(actor, { count: 0, titles: [] });
217
+ const e = byActor.get(actor);
218
+ e.count += 1;
219
+ if (e.titles.length < 8) e.titles.push(clip(a.title, COMMIT_TITLE_CLIP));
220
+ }
221
+
222
+ // ③ 任务动态
223
+ const { tasks } = store.loadTasks(ctx);
224
+ const done = tasks.filter((t) => t.status === 'done' && inRange(t.completedAt)).map((t) => clip(t.title, 60));
225
+ const doing = tasks.filter((t) => t.status === 'doing').map((t) => clip(t.title, 60));
226
+
227
+ // ④ 人工日报(窗内有更新的条目,content 截 200;读走 diary 路由——同上评审 P1)
228
+ const diaries = diaryMod
229
+ .loadDiaries(ctx)
230
+ .filter((d) => inRange(d.updatedAt))
231
+ .slice(0, 10)
232
+ .map((d) => {
233
+ const t = tasks.find((x) => x.id === d.taskId);
234
+ return { taskTitle: clip(t ? t.title : d.taskId, 40), date: d.date, content: clip(d.content, DIARY_CLIP) };
235
+ });
236
+
237
+ return {
238
+ rangeStart: new Date(since).toISOString(),
239
+ rangeEnd: new Date(now).toISOString(),
240
+ sessions,
241
+ commits: [...byActor.entries()].map(([actor, e]) => ({ actor, count: e.count, titles: e.titles })),
242
+ tasksDone: done,
243
+ tasksDoing: doing,
244
+ diaries,
245
+ stats: {
246
+ perAgent: perAgent,
247
+ sessionsTotal: sessions.length,
248
+ contentSessions,
249
+ commitsTotal: acts.length,
250
+ doneTotal: done.length,
251
+ doingTotal: doing.length,
252
+ diaryTotal: diaries.length,
253
+ truncated: sessions.length >= MAX_SESSION_LINES,
254
+ },
255
+ };
256
+ }
257
+
258
+ // ---------------------------------------------------------------- prompt
259
+
260
+ /** 养料事实 → 蒸馏 prompt(日报/周报结构与篇幅不同) */
261
+ function buildReportPrompt(facts, kind) {
262
+ const lines = [];
263
+ if (kind === 'daily') {
264
+ lines.push('【任务】你是 AI 数字员工团队的日报撰稿人。仅依据下方「过去 24 小时事实素材」萃取蒸馏一份中文日报(Markdown)。');
265
+ lines.push('要求:');
266
+ lines.push('- 只依据素材事实归纳,不编造、不臆测;素材未覆盖的不写;');
267
+ lines.push('- 结构固定:## 摘要(一段≤80字)→ ## 昨日进展(3-5 条,每条一句话带证据)→ ## 进行中 → ## 值得注意(风险/阻塞,没有写"无");');
268
+ lines.push('- 正文 ≤300 字;直接输出 Markdown 正文,不要代码围栏,不要寒暄。');
269
+ } else {
270
+ lines.push('【任务】你是 AI 数字员工团队的周报撰稿人。仅依据下方「本周事实素材」萃取蒸馏一份中文周报(Markdown)。');
271
+ lines.push('要求:');
272
+ lines.push('- 只依据素材事实归纳,不编造、不臆测;素材未覆盖的不写;');
273
+ lines.push('- 结构固定:## 总览(一段≤120字,开头以「本周期(<素材时间窗起> 至 <素材时间窗止>)」标注精确周期,日期逐字采用【素材 · 时间窗】给出的起止,禁止自行推算)→ ## 工作亮点(按项目/主题分 3-6 条,每条一句话带证据)→ ## 各数字员工动态(每人 1-3 句)→ ## 任务与交付(完成/进行中)→ ## 值得注意(风险/阻塞/建议 2-3 条,没有写"无");');
274
+ lines.push('- 正文 ≤600 字;直接输出 Markdown 正文,不要代码围栏,不要寒暄。');
275
+ }
276
+ lines.push('');
277
+ // 时间窗用本地日期标签(facts 里是 UTC ISO,直接喂会被引擎误读日期,如上周一 00:00+08 显示为 10-11)
278
+ lines.push(`【素材 · 时间窗】${localYmd(facts.rangeStart)} 至 ${localYmd(facts.rangeEnd)}(本地时间,截止点不含);归纳时一律以此窗口表述,不得外推`);
279
+ lines.push('【素材 · 数字员工会话】格式:智能体 | 项目 | 标题;「内容」行为该会话首条任务指令与末条交付结果的机械萃取(两层蒸馏的第一层),是归纳的主要依据');
280
+ for (const s of facts.sessions) {
281
+ const proj = normalizeProjectKey(s.project).split('\\').filter(Boolean).pop() || '未知';
282
+ lines.push(`- ${s.agent} | ${proj} | ${s.title}`);
283
+ if (s.digest) lines.push(` · 内容:${s.digest}`);
284
+ }
285
+ if (!facts.sessions.length) lines.push('-(窗内无会话记录)');
286
+ lines.push('【素材 · Gitea 提交/PR(已滤机器人)】');
287
+ for (const c of facts.commits) lines.push(`- ${c.actor}:${c.count} 条,如「${c.titles.join('」「')}」`);
288
+ if (!facts.commits.length) lines.push('-(窗内无提交)');
289
+ lines.push(`【素材 · 任务】完成 ${facts.tasksDone.length}:${facts.tasksDone.join('、') || '无'};进行中 ${facts.tasksDoing.length}:${facts.tasksDoing.join('、') || '无'}`);
290
+ lines.push('【素材 · 人工日报】');
291
+ for (const d of facts.diaries) lines.push(`- ${d.date}《${d.taskTitle}》:${d.content}`);
292
+ if (!facts.diaries.length) lines.push('-(窗内无日报)');
293
+ return lines.join('\n');
294
+ }
295
+
296
+ /** 兼容保留:周报 prompt(既有测试/调用方口径) */
297
+ function buildWeeklyPrompt(facts) {
298
+ return buildReportPrompt(facts, 'weekly');
299
+ }
300
+
301
+ /** 引擎输出清理:去首尾代码围栏与空白(模型偶尔包 ```markdown) */
302
+ function cleanReport(text) {
303
+ let t = String(text || '').trim();
304
+ t = t.replace(/^```(?:markdown|md)?\s*\n/i, '').replace(/\n```\s*$/i, '');
305
+ return t.trim();
306
+ }
307
+
308
+ // ---------------------------------------------------------------- 生成与落盘
309
+
310
+ /** 聚合 → 引擎蒸馏 → 落盘(daily→report-daily.json / weekly→weekly.json,各仅存最新一份)。
311
+ * 窗口口径(业主拍板):日报=昨日自然日、周报=上周自然周——严格不含名义周期外数据。 */
312
+ async function generateReport(ctx, kind) {
313
+ const k = KINDS[kind];
314
+ if (!k) throw new HttpError(400, 'BAD_KIND', 'kind 必须为 daily/weekly');
315
+ const now = Date.now();
316
+ const range = naturalRange(kind, now);
317
+ const facts = collectWeeklyFacts(ctx, {
318
+ kind, range,
319
+ days: k.rangeDays, maxContent: k.maxContent, firstClip: k.firstClip, lastClip: k.lastClip,
320
+ });
321
+ const prompt = buildReportPrompt(facts, kind);
322
+ let output;
323
+ const fx = runHeadlessFixture();
324
+ if (fx !== null) {
325
+ output = fx; // fixture 模式零 spawn(测试离线)
326
+ } else {
327
+ output = await runHeadless(ctx.config, prompt, { timeoutSec: k.timeoutSec });
328
+ }
329
+ const report = cleanReport(output);
330
+ if (!report) throw Object.assign(new Error('引擎输出为空'), { code: 'WEEKLY_EMPTY' });
331
+ const doc = {
332
+ generatedAt: new Date().toISOString(),
333
+ generatedDay: localYmd(now), // 日报自动档「今日已生成」判定键
334
+ report,
335
+ stats: facts.stats,
336
+ };
337
+ // 键=报告覆盖的起始自然日:日报=昨日、周报=上周一(绝不含周期外数据的口径锚点)
338
+ doc[k.keyField] = localYmd(range.since);
339
+ store.writeJSON(dataPath(ctx.config, k.file), doc);
340
+ return doc;
341
+ }
342
+
343
+ /** 兼容保留:周报生成 */
344
+ function generateWeekly(ctx) {
345
+ return generateReport(ctx, 'weekly');
346
+ }
347
+
348
+ function readReport(ctx, kind) {
349
+ const k = KINDS[kind];
350
+ if (!k) return null;
351
+ try {
352
+ const j = JSON.parse(fs.readFileSync(dataPath(ctx.config, k.file), 'utf8'));
353
+ return j && j.report ? j : null;
354
+ } catch {
355
+ return null;
356
+ }
357
+ }
358
+
359
+ /** 兼容保留:读周报 */
360
+ function readWeekly(ctx) {
361
+ return readReport(ctx, 'weekly');
362
+ }
363
+
364
+ // ---------------------------------------------------------------- 日报自动档
365
+
366
+ let lastAutoAttempt = 0; // 进程内:失败后每小时最多重试一次(成功当天直接被 dayKey 守卫拦下)
367
+
368
+ /**
369
+ * 日报自动档(挂轮询 tick):本地时间 ≥08:00 且今天尚未生成过 → 自动生成昨日自然日窗口日报。
370
+ * 守卫顺序:今天已生成(generatedDay=今天)→ 跳过;未到 08:00 → 跳过;失败后 1h 内不重试。
371
+ * opts.now 可注入(测试)。返回 'generated' | 'exists' | 'too-early' | 'throttled'(供测试断言)。
372
+ */
373
+ async function maybeAutoDaily(ctx, opts = {}) {
374
+ const now = Number.isFinite(opts.now) ? opts.now : Date.now();
375
+ const doc = readReport(ctx, 'daily');
376
+ if (doc && doc.generatedDay === localYmd(now)) return 'exists';
377
+ const hour = new Date(now).getHours();
378
+ if (hour < 8) return 'too-early';
379
+ if (Date.now() - lastAutoAttempt < 3600e3) return 'throttled';
380
+ lastAutoAttempt = Date.now();
381
+ await generateReport(ctx, 'daily');
382
+ return 'generated';
383
+ }
384
+
385
+ // ---------------------------------------------------------------- 路由
386
+
387
+ /** 报告路由(weekly 三条既有端点不动;daily 三条平行新增) */
388
+ function registerWeeklyRoutes(router, ctx) {
389
+ // POST /api/weekly/generate | /api/daily/generate → 202 {jobId}(引擎蒸馏 30~120s+,走雷达同款 job 轮询)
390
+ for (const kind of ['weekly', 'daily']) {
391
+ router.add('POST', `/api/${kind}/generate`, (c) => {
392
+ const job = jobs.createJob(kind, 1);
393
+ (async () => {
394
+ try {
395
+ const doc = await generateReport(ctx, kind);
396
+ job.current = null;
397
+ job.done = 1;
398
+ job.results.push({ item: doc[kind === 'daily' ? 'dayKey' : 'weekKey'], ok: true, stats: doc.stats });
399
+ job.state = 'done';
400
+ } catch (err) {
401
+ job.results.push({ item: kind, ok: false, error: redact((err && err.message) || String(err)) });
402
+ job.state = 'failed';
403
+ } finally {
404
+ jobs.finishJob(job);
405
+ }
406
+ })().catch(() => {});
407
+ sendJSON(c.res, 202, { jobId: job.id });
408
+ });
409
+
410
+ // GET /api/<kind>/job/:id → 进度轮询
411
+ router.add('GET', `/api/${kind}/job/:id`, (c) => {
412
+ const job = jobs.getJob(c.params.id);
413
+ if (!job) throw new HttpError(404, 'JOB_NOT_FOUND', '任务不存在或已过期');
414
+ sendJSON(c.res, 200, jobs.jobView(job));
415
+ });
416
+
417
+ // GET /api/<kind> → 最新报告(404 NOT_FOUND = 从未生成)
418
+ router.add('GET', `/api/${kind}`, (c) => {
419
+ const doc = readReport(ctx, kind);
420
+ if (!doc) throw new HttpError(404, kind === 'daily' ? 'DAILY_NOT_FOUND' : 'WEEKLY_NOT_FOUND', kind === 'daily' ? '尚未生成日报' : '尚未生成周报');
421
+ sendJSON(c.res, 200, doc);
422
+ });
423
+ }
424
+ }
425
+
426
+ module.exports = {
427
+ collectWeeklyFacts,
428
+ buildReportPrompt,
429
+ buildWeeklyPrompt,
430
+ generateReport,
431
+ generateWeekly,
432
+ readReport,
433
+ readWeekly,
434
+ maybeAutoDaily,
435
+ localYmd,
436
+ naturalRange,
437
+ cleanReport,
438
+ registerWeeklyRoutes,
439
+ };