diff --git a/app/AGENTS.md b/app/AGENTS.md index b272baa..f699c71 100644 --- a/app/AGENTS.md +++ b/app/AGENTS.md @@ -52,7 +52,8 @@ AGENT_CONFIG=./config.yml node server/server.js | `server/routes/*.js` | HTTP API,按资源分文件 | | `server/sse.js` | 按会话分组的 SSE 总线(`addClient`/`emit`/`onInternal`) | | `server/auth.js` | HMAC cookie 登录、Basic 兜底、`requireAdmin`、免认证路径 | -| `server/memory.js` | 长期记忆(日记碎片)读写与检索,零业务依赖 | +| `server/memory.js` | 长期记忆(日记碎片)读写与检索,仅依赖 `time.js` | +| `server/time.js` | 业务时区单一入口:`TZ`、`dayString`、`stampString`、`fmtTime`、`fmtIso` | | `server/user-profile.js` | 用户画像读写、会话快照冻结 | | `server/public-files.js` | `mint_public_link` 的短链签发与解析(进程内 Map) | | `server/download-token.js` | 浏览器下载链接的 HMAC 签名(密钥进程内随机) | diff --git a/app/server/db.js b/app/server/db.js index 6c3174a..edd89ce 100644 --- a/app/server/db.js +++ b/app/server/db.js @@ -2,6 +2,7 @@ const Database = require('better-sqlite3'); const path = require('path'); const fs = require('fs'); +const { dayString } = require('./time'); function initDb(dbPath) { fs.mkdirSync(path.dirname(dbPath), { recursive: true }); @@ -116,7 +117,7 @@ function initDb(dbPath) { ); -- 长期记忆(日记,memory.js):一片碎片一行——会话收口(下班)时落库,(user, session_id) 主键即去重。 - -- day = 事件日(Asia/Shanghai 与 cron 同时区):由 last_active_at 派生;人回忆问「哪天干的活」,不是「哪天补记的」。 + -- day = 事件日(上海时区,time.js 固定,与 cron 同源):由 last_active_at 派生;人回忆问「哪天干的活」,不是「哪天补记的」。 -- text = 纯日记正文(- 行列表);来源会话 id 存在 session_id 列,【id】展示样式只在渲染层拼,存储零冗余。 -- 故意不建外键:主键是 (user, session_id),SQLite 要求引用列命中唯一约束,单列 session_id -- 建不了 FK;且删会话的连带清理由 engine.deleteSession 显式 memory.dropFragment 承担 @@ -266,7 +267,6 @@ function initDb(dbPath) { // 搬完即 drop;解析不出【sid】头的块(DAY_MAX 时代削出的孤儿残句)直接丢弃; // 存量碎片的 day 顺手改判为来源会话最后活跃日(事件日语义修正,积压补记自然散布回真实日期)。 if (db.prepare("SELECT 1 FROM sqlite_master WHERE type='table' AND name='memory_entries'").get()) { - const dayFmt = new Intl.DateTimeFormat('en-CA', { timeZone: 'Asia/Shanghai' }); const mf = db.prepare('INSERT OR IGNORE INTO memory_fragments (user, session_id, day, text, created_at) VALUES (?,?,?,?,?)'); const getUpd = db.prepare('SELECT updated_at FROM sessions WHERE id = ?'); for (const r of db.prepare('SELECT user, day, content, updated_at FROM memory_entries').all()) { @@ -276,7 +276,7 @@ function initDb(dbPath) { const sidM = /task-[0-9A-Za-z_-]+/.exec(m[1]); // 兼容三代头格式:【标题 · sid】/【sid】 if (!sidM) continue; const srow = getUpd.get(sidM[0]); - mf.run(r.user, sidM[0], srow && srow.updated_at ? dayFmt.format(new Date(srow.updated_at)) : r.day, m[2].trim(), r.updated_at || Date.now()); + mf.run(r.user, sidM[0], srow && srow.updated_at ? dayString(srow.updated_at) : r.day, m[2].trim(), r.updated_at || Date.now()); } } db.exec('DROP TABLE memory_entries'); @@ -294,7 +294,6 @@ function initDb(dbPath) { try { db.exec('ALTER TABLE memory_fragments ADD COLUMN last_active_at INTEGER'); } catch (_) { /* 已存在 */ } const needStamp = db.prepare('SELECT 1 FROM memory_fragments WHERE last_active_at IS NULL LIMIT 1').get(); if (needStamp) { - const dayFmt = new Intl.DateTimeFormat('en-CA', { timeZone: 'Asia/Shanghai' }); const lastMsg = db.prepare( "SELECT MAX(created_at) AS m FROM messages WHERE session_id = ? AND type IS NULL AND role IN ('user','assistant')" ); @@ -304,7 +303,7 @@ function initDb(dbPath) { const m = lastMsg.get(f.session_id); const s = getUpdated.get(f.session_id); const cands = [m && m.m, s && s.updated_at, f.created_at].filter(Boolean).map(Number); - const pick = cands.find(ms => dayFmt.format(new Date(ms)) === f.day); + const pick = cands.find(ms => dayString(ms) === f.day); if (pick) setStamp.run(pick, f.user, f.session_id); } } diff --git a/app/server/memory.js b/app/server/memory.js index e9dbc59..2e0a34b 100644 --- a/app/server/memory.js +++ b/app/server/memory.js @@ -11,9 +11,9 @@ // - 注入 =「嘴边的工作记忆」:开场只带最近 inject_max 片(day 优先、同日按 last_active_at 倒序);更早的没消失—— // recall 工具 op=search/days/day 走全表;retain_days > 0 才按 day 硬裁(默认 0 = 不按时间删, // 但删会话会连带撕掉它的碎片,见 dropFragment)。 -// 时区与 cron(scheduler.js)对齐 Asia/Shanghai:上海无夏令时,按毫秒日移取 day 字符串安全。 +// 业务时区统一由 time.js 固定为 Asia/Shanghai(与 cron 同源):上海无夏令时,按毫秒日移取 day 字符串安全。 -const TZ = 'Asia/Shanghai'; +const { dayString, stampString } = require('./time'); const INJECT_CAP = 50; // inject_max 硬帽:防配置手滑把整个日记灌进上下文 const FRAG_MAX = 600; // 单碎片正文长度帽 @@ -28,19 +28,6 @@ function injectMax(cfg) { return Math.max(0, Math.min(INJECT_CAP, n)); } -const dayFmt = new Intl.DateTimeFormat('en-CA', { timeZone: TZ }); // en-CA = ISO 'YYYY-MM-DD' -const timeFmt = new Intl.DateTimeFormat('en-GB', { - timeZone: TZ, hour: '2-digit', minute: '2-digit', second: '2-digit', hourCycle: 'h23' -}); -function dayString(ms) { return dayFmt.format(new Date(Number(ms) || Date.now())); } -// 'YYYY-MM-DD HH:MM:SS'(上海时区);脏/空值返 '',由调用方退回只显示 day。 -function stampString(ms) { - const n = Number(ms); - if (!Number.isFinite(n) || n <= 0) return ''; - const d = new Date(n); - return dayFmt.format(d) + ' ' + timeFmt.format(d); -} - // 保留窗最旧一天的日串(retain_days=0 → 空串 = 无下界)。 function cutoffDay(cfg, refMs) { const n = retainDays(cfg); diff --git a/app/server/scheduler.js b/app/server/scheduler.js index aa2c226..28cd139 100644 --- a/app/server/scheduler.js +++ b/app/server/scheduler.js @@ -11,8 +11,8 @@ // 顶层反向 require 会成环拿到半成品 exports。 const { CronExpressionParser } = require('cron-parser'); // 锁定 v5.10.1:API 是 CronExpressionParser.parse(v4 的 parseExpression 已不存在) const log = require('./log'); +const { TZ, fmtTime, fmtIso } = require('./time'); // 业务时区单点;不依赖进程隐式时区 -const TZ = 'Asia/Shanghai'; // 与容器 TZ(docker-compose)一致;显式传入,不依赖进程隐式时区 const TICK_MS = 30000; // 轮询周期:相对 1h 最小间隔足够密,无调优需求,不进 config.yml const MIN_INTERVAL_MS = 3600000; // cron 最小间隔 1 小时:防 AI 排出分钟级任务反复烧模型池 const PROMPT_MAX_LEN = 20000; // prompt 长度上限,与 routes/sessions.js PATCH 口径一致 @@ -21,20 +21,6 @@ let eng = null; // engine 引用(start 注入) let notify = null; // 完成通知投递面(server.js 注入 wechat.notifyTask;缺位则跳过通知) let timer = null; -function fmtTime(t) { - return new Date(t).toLocaleString('zh-CN', { timeZone: TZ, hour12: false }); -} - -// ISO 带时区偏移串(schedule 工具回执用):上海无夏令时,固定 +08:00 安全; -// formatToParts 逐件拼接,不依赖 ICU 区域格式串形状;h23 保证零点为 00:00:00 而非 24 点。 -function fmtIso(t) { - if (!t) return ''; - const p = {}; - const parts = new Intl.DateTimeFormat('en-CA', { timeZone: TZ, year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit', second: '2-digit', hourCycle: 'h23' }).formatToParts(new Date(t)); - for (const { type, value } of parts) p[type] = value; - return p.year + '-' + p.month + '-' + p.day + 'T' + p.hour + ':' + p.minute + ':' + p.second + '+08:00'; -} - // 下次到期时间。一律以当前时刻为基准(而非上次 next_run_at): // 服务器停机跨过若干触发点后重启,算出的自然是「未来最近一次」,天然跳过补跑。 function computeNext(cronExpr) { diff --git a/app/server/time.js b/app/server/time.js new file mode 100644 index 0000000..e0e20bd --- /dev/null +++ b/app/server/time.js @@ -0,0 +1,40 @@ +// 业务时区单一入口:日记 day、定时任务 cron、存量迁移统一从这里取。 +// Dockerfile/compose 的 TZ 只负责进程默认本地时区(日志、文件名、部分统计、第三方工具); +// 业务语义(day/cron)显式固定上海,不随部署环境或 TZ 覆盖漂移。 +// 上海无夏令时:fmtIso 的 +08:00 是安全偏移;Intl 仍用 IANA 时区名。 +const TZ = 'Asia/Shanghai'; + +const dayFmt = new Intl.DateTimeFormat('en-CA', { timeZone: TZ }); // en-CA = ISO 'YYYY-MM-DD' +const timeFmt = new Intl.DateTimeFormat('en-GB', { + timeZone: TZ, hour: '2-digit', minute: '2-digit', second: '2-digit', hourCycle: 'h23' +}); +const isoFmt = new Intl.DateTimeFormat('en-CA', { + timeZone: TZ, year: 'numeric', month: '2-digit', day: '2-digit', + hour: '2-digit', minute: '2-digit', second: '2-digit', hourCycle: 'h23' +}); + +function dayString(ms) { return dayFmt.format(new Date(Number(ms) || Date.now())); } + +// 'YYYY-MM-DD HH:MM:SS'(上海时区);脏/空值返 '',由调用方退回只显示 day。 +function stampString(ms) { + const n = Number(ms); + if (!Number.isFinite(n) || n <= 0) return ''; + const d = new Date(n); + return dayFmt.format(d) + ' ' + timeFmt.format(d); +} + +function fmtTime(t) { + return new Date(t).toLocaleString('zh-CN', { timeZone: TZ, hour12: false }); +} + +// ISO 带时区偏移串(schedule 工具回执用):上海无夏令时,固定 +08:00 安全; +// formatToParts 逐件拼接,不依赖 ICU 区域格式串形状;h23 保证零点为 00:00:00 而非 24 点。 +function fmtIso(t) { + if (!t) return ''; + const p = {}; + const parts = isoFmt.formatToParts(new Date(t)); + for (const { type, value } of parts) p[type] = value; + return p.year + '-' + p.month + '-' + p.day + 'T' + p.hour + ':' + p.minute + ':' + p.second + '+08:00'; +} + +module.exports = { TZ, dayString, stampString, fmtTime, fmtIso }; diff --git a/app/server/tools/executor.js b/app/server/tools/executor.js index 3c3da7d..65da054 100644 --- a/app/server/tools/executor.js +++ b/app/server/tools/executor.js @@ -12,9 +12,9 @@ const Database = require('better-sqlite3'); // db 工具:会话目录下的 da const TurndownService = require('turndown'); // fetch 工具:HTML→Markdown 用真解析器(内置 htmlparser2,容错截断/畸形文档) const rexec = require('../remote-exec'); const publicFiles = require('../public-files'); -const scheduler = require('../scheduler'); // 只依赖 log/cron-parser,不成环(engine→executor→scheduler 单向) +const scheduler = require('../scheduler'); // 只依赖 log/cron-parser/time.js,不成环(engine→executor→scheduler 单向) const profile = require('../user-profile'); // profile 工具的数据面(仅 llm/log 依赖,无环) -const memory = require('../memory'); // recall 工具的数据面(日记翻阅;零依赖模块,无环) +const memory = require('../memory'); // recall 工具的数据面(日记翻阅;仅依赖 time.js,无环) // lab 的 help 伪工具要读全量定义:与 engine 同路径 require → node 缓存同一对象,单一事实源。 const BUILTIN_TOOL_DEFS = require('./definitions.json');