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,205 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * attribute.js — v1.9 分支约定最小切片②:Gitea 轮询落盘后的成果自动归因
5
+ *
6
+ * - 输入:data/tasks.json × data/activities.json 全量扫描(≤500 条动态 × 全部任务)
7
+ * - 精确规则(命中任一即归因;与 §3 matchedTaskIds 的 ≥4 字模糊子串口径不同,宁缺勿滥):
8
+ * a) activity.branch === task.branch(双方非空)
9
+ * b) activity.branch 以 task/<task.id> 开头(历史:已退役的本地 CLI 启动注入约定曾产生的分支)
10
+ * c) activity.title 含 [#<task.id>](约定的提交信息前缀)
11
+ * - 类型映射 kind:feeds 词表 commit→commit、pr→pr;存量词表 commit_pushed→commit、
12
+ * pr_opened/pr_merged→pr 保留(存量 activities.json 旧条目继续可归因);
13
+ * branch_created/branch_deleted 与未知类型跳过;无 url(或非 http(s) 伪协议,防 javascript: 流入前端渲染)跳过
14
+ * - 幂等:task.artifacts 已含同 url 一律跳过——轮询重复落盘/全量重扫不重复挂
15
+ * - 命中:artifacts 追加 {url, kind, repo, ref, at, title, messageBody, attributedBy:'auto'}
16
+ * (v2.9.15 起 title/messageBody 随归因落库,提交说明成果区直读)+ 事件流 type:'artifact'
17
+ * (detail=自动归因:branch <branch> / 自动归因:提交 [#<taskId>])+ updatedAt 刷新;
18
+ * 无任务/无命中零写盘
19
+ * - 调用点:lib/giteaClient.js pollActivities 落盘后(轮询器与 GET /api/activities?refresh=1
20
+ * 两路自动生效);归因异常由调用方记日志,绝不影响轮询成败
21
+ */
22
+
23
+ const path = require('path');
24
+ const store = require('./store');
25
+ const taskEvents = require('./taskEvents');
26
+
27
+ const PROJECT_ROOT = path.resolve(__dirname, '..');
28
+
29
+ /**
30
+ * activity.type → artifact.kind 映射;不在表内(branch_created/branch_deleted 等)不归因。
31
+ * feeds 词表(giteaClient activities/feeds 数据源):commit/pr;
32
+ * 旧词表 commit_pushed/pr_opened/pr_merged 保留容错——存量 activities.json 旧条目继续可归因。
33
+ */
34
+ const KIND_BY_TYPE = {
35
+ commit: 'commit',
36
+ pr: 'pr',
37
+ commit_pushed: 'commit',
38
+ pr_opened: 'pr',
39
+ pr_merged: 'pr',
40
+ };
41
+
42
+ // 与 server.js 手动挂接口径一致:仅接受 http(s) URL,杜绝 javascript: 等伪协议进 artifacts
43
+ const HTTP_URL_RE = /^https?:\/\/\S+$/i;
44
+
45
+ /** 成果内提交说明上限(与 v2.0 activity.messageBody ≤300 字同口径,title 同帽防超长落库) */
46
+ const ARTIFACT_TEXT_CAP = 300;
47
+
48
+ /** activity 文本 → 成果存储形态(null 容错 + 截帽) */
49
+ function artifactText(v) {
50
+ return v == null ? null : String(v).slice(0, ARTIFACT_TEXT_CAP);
51
+ }
52
+
53
+ /** 约定分支名:task/<taskId>(与前端「复制分支名」按钮复制内容同构) */
54
+ function taskBranchName(taskId) {
55
+ return `task/${taskId}`;
56
+ }
57
+
58
+ /**
59
+ * 仓库护栏:双方 repo 已知且不同 → 一切匹配规则不出。
60
+ * branch 名只在仓库内有意义——跨仓同名 branch(各仓都叫 main)曾把 demo-plan/
61
+ * tds/demo-hub 的提交全灌进 fde-console 的任务(2026-10-30 业主实测报错,40 条脏归因)。
62
+ * 任一方 repo 未知时不拦(无更强证据可用的,维持旧口径宁缺勿滥精神不打折:读侧
63
+ * matchedTaskIds 同款护栏)。规则 b/c(task/<id> 前缀与 [#id] 标记)自带任务 id 本不可能
64
+ * 跨仓,护栏放最前统一拦截。
65
+ */
66
+ function repoMismatch(activity, task) {
67
+ const ar = activity && typeof activity.repo === 'string' ? activity.repo.trim() : '';
68
+ const tr = task && typeof task.repo === 'string' ? task.repo.trim() : '';
69
+ return ar !== '' && tr !== '' && ar !== tr;
70
+ }
71
+
72
+ /**
73
+ * 单条 activity × 单个任务的精确匹配(仓库护栏 → 规则 a → b → c,先命中先得)。
74
+ * @param {{branch?:string|null, title?:string, repo?:string|null}} activity
75
+ * @param {{id:string, branch?:string|null, repo?:string|null}} task
76
+ * @returns {{rule:'branch_equal'|'branch_prefix'|'commit_ref', detail:string}|null} null=不命中
77
+ */
78
+ function matchReason(activity, task) {
79
+ if (repoMismatch(activity, task)) return null;
80
+ const branch = activity && typeof activity.branch === 'string' ? activity.branch : '';
81
+ const title = activity && typeof activity.title === 'string' ? activity.title : '';
82
+ if (branch && task.branch && branch === task.branch) {
83
+ return { rule: 'branch_equal', detail: `自动归因:branch ${branch}` };
84
+ }
85
+ if (branch && branch.startsWith(taskBranchName(task.id))) {
86
+ return { rule: 'branch_prefix', detail: `自动归因:branch ${branch}` };
87
+ }
88
+ if (title && title.includes(`[#${task.id}]`)) {
89
+ return { rule: 'commit_ref', detail: `自动归因:提交 [#${task.id}]` };
90
+ }
91
+ return null;
92
+ }
93
+
94
+ /**
95
+ * 全量归因扫描(同步)。读 activities.json × 全部任务,命中即写 tasks.json + task_events.json。
96
+ * url 去重保证幂等:重复扫描/重复轮询不产生重复成果;无任务/无动态/无命中均零写盘。
97
+ * @param {{tasksPath:string, taskEventsPath:string, activitiesPath:string}} paths
98
+ * @returns {{attributed:number, touched:number}} 新增成果数 / 被更新的任务数
99
+ */
100
+ function attributeActivities(paths) {
101
+ const ctx = {
102
+ tasksPath: paths.tasksPath,
103
+ taskEventsPath: paths.taskEventsPath,
104
+ activitiesPath: paths.activitiesPath,
105
+ };
106
+ const data = store.loadTasks(ctx);
107
+ if (!Array.isArray(data.tasks) || data.tasks.length === 0) return { attributed: 0, touched: 0 };
108
+ const activities = store.loadActivities(ctx);
109
+ if (activities.length === 0) return { attributed: 0, touched: 0 };
110
+
111
+ const now = new Date().toISOString();
112
+ const events = [];
113
+ let attributed = 0;
114
+ let touched = 0;
115
+
116
+ for (const task of data.tasks) {
117
+ if (!task || typeof task.id !== 'string' || !task.id) continue;
118
+ const artifacts = Array.isArray(task.artifacts) ? task.artifacts : [];
119
+ const seenUrls = new Set(
120
+ artifacts.map((a) => (a && typeof a.url === 'string' ? a.url : '')).filter(Boolean)
121
+ );
122
+ const before = artifacts.length;
123
+
124
+ for (const act of activities) {
125
+ const kind = KIND_BY_TYPE[act && act.type];
126
+ if (!kind) continue; // branch_created/branch_deleted 与未知类型:跳过
127
+ const url = typeof act.url === 'string' ? act.url : '';
128
+ if (!url || !HTTP_URL_RE.test(url)) continue; // 无 url 跳过(顺带拦伪协议)
129
+ if (seenUrls.has(url)) continue; // 幂等:同 url 已挂过(含同 PR 的 opened/merged 双动态)
130
+ const hit = matchReason(act, task);
131
+ if (!hit) continue;
132
+ artifacts.push({
133
+ url,
134
+ kind,
135
+ repo: act.repo == null ? null : String(act.repo),
136
+ ref: act.branch == null ? null : String(act.branch),
137
+ at: String(act.occurredAt || ''),
138
+ // v2.9.15:提交说明随归因落库(成果区直接可读,不再只有裸 URL);活动窗口滚动后仍可溯源
139
+ title: artifactText(act.title),
140
+ messageBody: artifactText(act.messageBody),
141
+ attributedBy: 'auto',
142
+ });
143
+ seenUrls.add(url);
144
+ events.push(taskEvents.makeEvent(task.id, 'artifact', null, null, hit.detail, now));
145
+ }
146
+
147
+ if (artifacts.length !== before) {
148
+ task.artifacts = artifacts; // 存量任务无字段容错:首次归因时初始化
149
+ task.updatedAt = now;
150
+ touched += 1;
151
+ attributed += artifacts.length - before;
152
+ }
153
+ }
154
+
155
+ if (attributed === 0) return { attributed, touched }; // 无命中零写盘
156
+ store.saveTasks(ctx, data);
157
+ taskEvents.appendEvents(ctx, events);
158
+ return { attributed, touched };
159
+ }
160
+
161
+ /**
162
+ * v2.9.15 读取时回填(纯内存,不落盘):按 url 从当前活动窗口补齐存量/手动成果缺的提交说明。
163
+ * 历史部署的 tasks.json 在仓库外,归因写路径加字段不会回溯存量——与「按 config 过滤产出的键改动
164
+ * 必须配读取时归一」同一纪律。会话成果自带 title 不参与;已有值不覆盖。
165
+ * @returns {number} 回填的成果条数(测试观测用)
166
+ */
167
+ function backfillArtifactMeta(tasks, activities) {
168
+ const byUrl = new Map();
169
+ for (const act of Array.isArray(activities) ? activities : []) {
170
+ if (act && typeof act.url === 'string' && act.url) {
171
+ byUrl.set(act.url, { title: artifactText(act.title), messageBody: artifactText(act.messageBody) });
172
+ }
173
+ }
174
+ let filled = 0;
175
+ for (const task of Array.isArray(tasks) ? tasks : []) {
176
+ const arts = task && Array.isArray(task.artifacts) ? task.artifacts : [];
177
+ for (const a of arts) {
178
+ if (!a || a.kind === 'session' || !a.url) continue;
179
+ const hasTitle = typeof a.title === 'string' && a.title.trim();
180
+ if (hasTitle || !byUrl.has(a.url)) continue;
181
+ const meta = byUrl.get(a.url);
182
+ a.title = meta.title;
183
+ a.messageBody = meta.messageBody;
184
+ filled += 1;
185
+ }
186
+ }
187
+ return filled;
188
+ }
189
+
190
+ /** 相对 dataDir 以项目根兜底(与 lib/giteaClient.js resolveDataPath 同口径;只拼路径不建目录) */
191
+ function dataPath(cfg, name) {
192
+ const dir = path.isAbsolute(cfg.dataDir) ? cfg.dataDir : path.join(PROJECT_ROOT, cfg.dataDir);
193
+ return path.join(dir, name);
194
+ }
195
+
196
+ /** pollActivities 落盘后的便捷入口:从 config 解析三个存储路径后扫描 */
197
+ function attributeAfterPoll(cfg) {
198
+ return attributeActivities({
199
+ tasksPath: dataPath(cfg, 'tasks.json'),
200
+ taskEventsPath: dataPath(cfg, 'task_events.json'),
201
+ activitiesPath: dataPath(cfg, 'activities.json'),
202
+ });
203
+ }
204
+
205
+ module.exports = { KIND_BY_TYPE, taskBranchName, repoMismatch, matchReason, attributeActivities, attributeAfterPoll, backfillArtifactMeta, ARTIFACT_TEXT_CAP };
package/lib/backup.js ADDED
@@ -0,0 +1,366 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * backup.js — v2.9.41 数据备份与恢复(唯一不可逆损失缺口的收口)
5
+ *
6
+ * 背景(AGENTS 红线 3):`data/` 运行态是唯一副本,task_events/diary 不可重建;
7
+ * 此前只有手动脚本 scripts/backup-data.js,没有任何调度与恢复入口。
8
+ *
9
+ * 本模块同时服务三处(一条代码路径,禁止各写一份):
10
+ * ① CLI scripts/backup-data.js(薄壳,转调这里)
11
+ * ② 每日自动备份:pollTick → maybeDailyBackup(到点且当日未跑才跑)
12
+ * ③ REST API:GET /api/backup/list · POST /api/backup/now · POST /api/backup/restore
13
+ *
14
+ * 纪律:
15
+ * - **源目录只读**:备份/恢复都不删除 data/ 下任何文件;恢复只是覆盖同名文件
16
+ * - 落点 = `<base>/backups/`(data 的兄弟目录),不进 data,避免污染数据目录
17
+ * - 恢复是破坏性操作:必须 `confirm:"RESTORE"`;**先给当前状态拍快照再覆盖**,可回滚
18
+ * - 备份名严格白名单 `backup-YYYYMMDD-HHMMSS(-n)`:恢复接口不吃任意路径
19
+ * - 失败留痕:任何一步抛错都向上抛(调用方 catch 后写日志),绝不静默吞
20
+ */
21
+
22
+ const fs = require('node:fs');
23
+ const os = require('node:os');
24
+ const path = require('node:path');
25
+
26
+ const store = require('./store');
27
+ const { HttpError, sendJSON } = require('./router');
28
+
29
+ const KEEP_DEFAULT = 14;
30
+ const BACKUP_PREFIX = 'backup-';
31
+ const NAME_RE = /^backup-\d{8}-\d{6}(-\d+)?$/;
32
+ const STATE_FILE = '.state.json';
33
+ const RESTORE_FILE = '.last-restore.json';
34
+
35
+ // ---------- 基础 ----------
36
+
37
+ function pad2(n) {
38
+ return String(n).padStart(2, '0');
39
+ }
40
+
41
+ function ymd(date) {
42
+ return `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())}`;
43
+ }
44
+
45
+ function hhmm(date) {
46
+ return `${pad2(date.getHours())}:${pad2(date.getMinutes())}`;
47
+ }
48
+
49
+ /** 默认源:DSH_HOME|~/.dsh 下的 fde-console/data(部署形态真实落点);不存在则回退仓库 data/ */
50
+ function defaultSource() {
51
+ const home = (process.env.DSH_HOME && process.env.DSH_HOME.trim()) || path.join(os.homedir(), '.dsh');
52
+ const deployed = path.join(home, 'fde-console', 'data');
53
+ if (fs.existsSync(deployed)) return deployed;
54
+ return path.resolve(__dirname, '..', 'data');
55
+ }
56
+
57
+ /** 备份落点:data 的兄弟目录(<base>/backups),不进 data */
58
+ function backupsDirOf(ctx) {
59
+ return path.join(path.dirname(path.resolve(ctx.dataDir)), 'backups');
60
+ }
61
+
62
+ function listBackupDirs(outDir) {
63
+ try {
64
+ return fs.readdirSync(outDir)
65
+ .filter((n) => n.startsWith(BACKUP_PREFIX))
66
+ .filter((n) => {
67
+ try {
68
+ return fs.statSync(path.join(outDir, n)).isDirectory();
69
+ } catch (e) {
70
+ return false;
71
+ }
72
+ })
73
+ .sort()
74
+ .reverse(); // 时间戳名天然可排序,新→旧
75
+ } catch (e) {
76
+ return []; // 目录不存在 = 还没备份过
77
+ }
78
+ }
79
+
80
+ function readManifest(dir) {
81
+ try {
82
+ const d = JSON.parse(fs.readFileSync(path.join(dir, 'manifest.json'), 'utf8'));
83
+ return d && typeof d === 'object' ? d : null;
84
+ } catch (e) {
85
+ return null;
86
+ }
87
+ }
88
+
89
+ // ---------- 备份 ----------
90
+
91
+ /**
92
+ * 执行一次备份。返回 {dir, files:[{name,bytes}], pruned:[被清理的旧备份名]}。
93
+ * 幂等:同一秒重复调用会生成 -<序号> 目录,绝不覆盖已有备份。
94
+ */
95
+ function backupOnce(options) {
96
+ const o = options || {};
97
+ const src = path.resolve(o.source || defaultSource());
98
+ if (!fs.existsSync(src)) throw new Error(`数据目录不存在: ${src}`);
99
+ const ts = new Date(Number(o.now) || Date.now());
100
+ const stamp = `${ts.getFullYear()}${pad2(ts.getMonth() + 1)}${pad2(ts.getDate())}-${pad2(ts.getHours())}${pad2(ts.getMinutes())}${pad2(ts.getSeconds())}`;
101
+ const outDir = path.resolve(o.out || path.join(path.dirname(src), 'backups'));
102
+ fs.mkdirSync(outDir, { recursive: true });
103
+ let dir = path.join(outDir, `${BACKUP_PREFIX}${stamp}`);
104
+ let suffix = 0;
105
+ while (fs.existsSync(dir)) dir = path.join(outDir, `${BACKUP_PREFIX}${stamp}-${++suffix}`);
106
+ fs.mkdirSync(dir, { recursive: true });
107
+
108
+ // v2.9.33 存储迁移配套:data/fde.db 存在时先 WAL checkpoint(合并进主文件,拷贝瞬间一致)。
109
+ // 用完即关的短连接,不进 storeDb 单例(备份与运行态读写互不持锁)
110
+ const dbFile = path.join(src, 'fde.db');
111
+ if (fs.existsSync(dbFile)) {
112
+ const { DatabaseSync } = require('node:sqlite');
113
+ const db = new DatabaseSync(dbFile);
114
+ try {
115
+ db.exec('PRAGMA wal_checkpoint(TRUNCATE)');
116
+ } finally {
117
+ db.close();
118
+ }
119
+ }
120
+
121
+ const files = [];
122
+ for (const name of fs.readdirSync(src)) {
123
+ const p = path.join(src, name);
124
+ if (!fs.statSync(p).isFile()) continue; // 只备数据文件;子目录(如 session-logs/)不备
125
+ if (/\.migrated-/.test(name) || /\.tmp-/.test(name) || /\.corrupt-/.test(name)) continue; // 归档/残留不进滚动备份
126
+ fs.copyFileSync(p, path.join(dir, name));
127
+ files.push({ name, bytes: fs.statSync(p).size });
128
+ }
129
+ fs.writeFileSync(path.join(dir, 'manifest.json'), JSON.stringify({
130
+ backedUpAt: ts.toISOString(),
131
+ source: src,
132
+ files,
133
+ }, null, 2));
134
+
135
+ const keepN = Number(o.keep) > 0 ? Number(o.keep) : KEEP_DEFAULT;
136
+ // 直接按目录名倒序(时间戳可排序;同秒的 -1/-2 后缀按字典序排在前面 = 更新)取前 keepN 份
137
+ const all = listBackupDirs(outDir);
138
+ const pruned = all.slice(keepN);
139
+ for (const name of pruned) {
140
+ try {
141
+ fs.rmSync(path.join(outDir, name), { recursive: true, force: true });
142
+ } catch (e) {
143
+ /* 清理失败不阻断本次备份(下次还会再试) */
144
+ }
145
+ }
146
+ return { dir, files, pruned };
147
+ }
148
+
149
+ function keepOf(ctx) {
150
+ const k = Number(ctx && ctx.config && ctx.config.backup && ctx.config.backup.keep);
151
+ return k > 0 ? k : KEEP_DEFAULT;
152
+ }
153
+
154
+ /** API/调度用:以 ctx 定位源与落点 */
155
+ function backupNow(ctx, opts) {
156
+ const o = opts || {};
157
+ return backupOnce({ source: ctx.dataDir, out: backupsDirOf(ctx), keep: keepOf(ctx), now: o.now });
158
+ }
159
+
160
+ /** 备份清单(新→旧),附带 manifest 里的时间与体积;损坏的备份不隐藏,标记 unreadable */
161
+ function listBackups(ctx) {
162
+ const out = backupsDirOf(ctx);
163
+ return listBackupDirs(out).map((name) => {
164
+ const dir = path.join(out, name);
165
+ const manifest = readManifest(dir);
166
+ let bytes = 0;
167
+ let files = 0;
168
+ if (manifest && Array.isArray(manifest.files)) {
169
+ files = manifest.files.length;
170
+ bytes = manifest.files.reduce((s, f) => s + (Number(f && f.bytes) || 0), 0);
171
+ }
172
+ return {
173
+ name,
174
+ backedUpAt: (manifest && manifest.backedUpAt) || null,
175
+ files,
176
+ bytes,
177
+ unreadable: !manifest,
178
+ };
179
+ });
180
+ }
181
+
182
+ // ---------- 恢复 ----------
183
+
184
+ /**
185
+ * 从备份恢复(破坏性):先给当前 data 拍快照,再按清单覆盖同名文件。
186
+ * 只覆盖、不删除 —— 备份里没有而 data 里有的文件原样保留(宁可多余,不可误删)。
187
+ */
188
+ function restoreBackup(ctx, name, opts) {
189
+ const o = opts || {};
190
+ if (o.confirm !== 'RESTORE') {
191
+ throw new HttpError(400, 'CONFIRM_REQUIRED', '恢复是破坏性操作:请求体需带 {"confirm":"RESTORE"}');
192
+ }
193
+ if (typeof name !== 'string' || !NAME_RE.test(name)) {
194
+ throw new HttpError(400, 'BACKUP_INVALID', '备份名非法(只接受 backups 目录下的 backup-YYYYMMDD-HHMMSS[-n])');
195
+ }
196
+ const out = backupsDirOf(ctx);
197
+ const dir = path.join(out, name);
198
+ if (!fs.existsSync(dir)) throw new HttpError(404, 'BACKUP_NOT_FOUND', `备份不存在: ${name}`);
199
+
200
+ const manifest = readManifest(dir);
201
+ const names = manifest && Array.isArray(manifest.files)
202
+ ? manifest.files.map((f) => f && f.name).filter((n) => typeof n === 'string' && (n.endsWith('.json') || n === 'fde.db'))
203
+ : fs.readdirSync(dir).filter((n) => (n.endsWith('.json') && n !== 'manifest.json') || n === 'fde.db');
204
+
205
+ // 先拍当前状态的快照(恢复错了还能再恢复回来);data 目录不存在时无状态可保,跳过
206
+ const snapshot = fs.existsSync(ctx.dataDir)
207
+ ? backupOnce({ source: ctx.dataDir, out, keep: keepOf(ctx), now: o.now })
208
+ : null;
209
+
210
+ fs.mkdirSync(ctx.dataDir, { recursive: true });
211
+ const restored = [];
212
+ for (const fileName of names) {
213
+ if (fileName.includes('/') || fileName.includes('\\') || fileName.includes('..')) continue; // 清单被篡改也不越界
214
+ const from = path.join(dir, fileName);
215
+ if (!fs.existsSync(from)) continue;
216
+ fs.copyFileSync(from, path.join(ctx.dataDir, fileName));
217
+ restored.push(fileName);
218
+ }
219
+
220
+ // v2.9.33 存储迁移配套(SPEC-STORAGE §5 双格式恢复):
221
+ // ① 档案含 fde.db → 拷回后清 storeDb 连接/台账缓存(下次访问重开新库)
222
+ // ② 旧代纯 JSON 档案 + 当前已有已迁移单元 → 把恢复出的 JSON 自动重导入 db(恢复后系统可用承诺)
223
+ if (restored.includes('fde.db')) {
224
+ require('./storeDb').clearCache();
225
+ } else if (fs.existsSync(path.join(ctx.dataDir, 'fde.db'))) {
226
+ const storeDb = require('./storeDb');
227
+ const dbPath = path.join(ctx.dataDir, 'fde.db');
228
+ const units = [...(storeDb.unitsMigrated(dbPath) || [])]
229
+ .filter((u) => fs.existsSync(path.join(ctx.dataDir, unitFileOf(u))));
230
+ if (units.length) {
231
+ require('./migration').runMigration({ dataDir: ctx.dataDir, units, force: true, now: o.now });
232
+ }
233
+ }
234
+
235
+ store.writeJSON(path.join(out, RESTORE_FILE), {
236
+ at: new Date().toISOString(),
237
+ from: name,
238
+ files: restored,
239
+ snapshot: snapshot ? path.basename(snapshot.dir) : null,
240
+ });
241
+ return { name, files: restored, snapshot: snapshot ? snapshot.dir : null };
242
+ }
243
+
244
+ /** 迁移单元名 → 源 JSON 文件名(恢复重导入用;与 lib/migration.UNITS 同源) */
245
+ function unitFileOf(unit) {
246
+ const map = { messages: 'messages.json', task_events: 'task_events.json' };
247
+ return map[unit] || `${unit}.json`;
248
+ }
249
+
250
+ // ---------- 每日自动备份 ----------
251
+
252
+ function statePath(ctx) {
253
+ return path.join(backupsDirOf(ctx), STATE_FILE);
254
+ }
255
+
256
+ function readState(ctx) {
257
+ try {
258
+ const d = store.readJSON(statePath(ctx), null);
259
+ return store.isPlainObject(d) ? d : {};
260
+ } catch (e) {
261
+ return {};
262
+ }
263
+ }
264
+
265
+ /**
266
+ * 每日自动备份(pollTick 每分钟调用):到点 + 当日未跑才跑。
267
+ * 默认开启(本地拷贝,无出站),失败只影响当天这一次。
268
+ */
269
+ function maybeDailyBackup(ctx, opts) {
270
+ const o = opts || {};
271
+ const cfg = (ctx && ctx.config && ctx.config.backup) || {};
272
+ if (cfg.enabled === false) return { ran: false, reason: 'disabled' };
273
+ const at = /^([01]\d|2[0-3]):[0-5]\d$/.test(String(cfg.at || '')) ? cfg.at : '09:05';
274
+ const now = o.now instanceof Date ? o.now : new Date();
275
+ if (hhmm(now) < at) return { ran: false, reason: '未到点' };
276
+
277
+ const today = ymd(now);
278
+ const state = readState(ctx);
279
+ if (state.lastDate === today) return { ran: false, reason: '今日已备份' };
280
+
281
+ // 空目录(首启/数据被清)不产垃圾备份:没有 .json 就当没东西可备
282
+ let hasData = false;
283
+ try {
284
+ hasData = fs.readdirSync(ctx.dataDir).some((n) => n.endsWith('.json'));
285
+ } catch (e) {
286
+ hasData = false;
287
+ }
288
+ if (!hasData) return { ran: false, reason: '数据目录为空' };
289
+
290
+ const r = backupOnce({ source: ctx.dataDir, out: backupsDirOf(ctx), keep: keepOf(ctx), now: now.getTime() });
291
+ store.writeJSON(statePath(ctx), {
292
+ lastDate: today,
293
+ lastAt: new Date().toISOString(),
294
+ dir: path.basename(r.dir),
295
+ pruned: r.pruned.length,
296
+ });
297
+ return { ran: true, dir: r.dir, pruned: r.pruned.length };
298
+ }
299
+
300
+ /** 备份状态(给设置页/体检用;读不到就如实说「从未备份」) */
301
+ function backupStatus(ctx) {
302
+ const state = readState(ctx);
303
+ const items = listBackups(ctx);
304
+ const last = items[0] || null;
305
+ let restore = null;
306
+ try {
307
+ restore = store.readJSON(path.join(backupsDirOf(ctx), RESTORE_FILE), null);
308
+ } catch (e) {
309
+ restore = null;
310
+ }
311
+ return {
312
+ enabled: !((ctx.config && ctx.config.backup && ctx.config.backup.enabled) === false),
313
+ keep: keepOf(ctx),
314
+ at: (ctx.config && ctx.config.backup && ctx.config.backup.at) || '09:05',
315
+ dir: backupsDirOf(ctx),
316
+ count: items.length,
317
+ lastBackupAt: (last && last.backedUpAt) || state.lastAt || null,
318
+ lastBackupName: (last && last.name) || state.dir || null,
319
+ lastRestore: restore && typeof restore === 'object' ? { at: restore.at, from: restore.from, files: Array.isArray(restore.files) ? restore.files.length : 0 } : null,
320
+ };
321
+ }
322
+
323
+ // ---------- 路由 ----------
324
+
325
+ function registerBackupRoutes(router, ctx) {
326
+ router.add('GET', '/api/backup/list', (c) => {
327
+ sendJSON(c.res, 200, Object.assign(backupStatus(ctx), { items: listBackups(ctx) }));
328
+ });
329
+
330
+ router.add('POST', '/api/backup/now', (c) => {
331
+ const r = backupNow(ctx);
332
+ sendJSON(c.res, 200, {
333
+ ok: true,
334
+ name: path.basename(r.dir),
335
+ files: r.files.length,
336
+ bytes: r.files.reduce((s, f) => s + f.bytes, 0),
337
+ pruned: r.pruned.length,
338
+ });
339
+ });
340
+
341
+ // 破坏性:必须显式 confirm;服务端先快照再覆盖(出错可再恢复)
342
+ router.add('POST', '/api/backup/restore', (c) => {
343
+ const body = c.body || {};
344
+ const r = restoreBackup(ctx, body.name, { confirm: body.confirm });
345
+ sendJSON(c.res, 200, {
346
+ ok: true,
347
+ name: r.name,
348
+ files: r.files.length,
349
+ snapshot: r.snapshot ? path.basename(r.snapshot) : null,
350
+ });
351
+ });
352
+ }
353
+
354
+ module.exports = {
355
+ KEEP_DEFAULT,
356
+ NAME_RE,
357
+ defaultSource,
358
+ backupsDirOf,
359
+ backupOnce,
360
+ backupNow,
361
+ listBackups,
362
+ restoreBackup,
363
+ maybeDailyBackup,
364
+ backupStatus,
365
+ registerBackupRoutes,
366
+ };