refactor(schedule): 回执去教学化——编号条目 + key=value 分行,时间 ISO+08:00,prompt 截断

用户实看吐槽:回执啰嗦不直观,教学反复塞(规范 §六:怎么做写在 schema description,
运行时回执只给事实)。教学文案全部清除(触发存档说明/brief 提醒/改删指引/空清单教程尾巴),
只留纯事实。

- list/get:编号条目(list 才有标题行与序号),字段逐行 key=value——
  id/name/brief/cron/next/last+last_status/last_note/prompt;时间统一 fmtIso()
  (formatToParts 手拼 + hourCycle h23,零点 00:00:00 非 24 点,不踩 ICU 格式串形状;
  上海无夏令时固定 +08:00);prompt 截 160 字加省略号,防 2 万字提示词污染上下文;
- create/update/delete:一行到三行的 k=v 短确认;create 保留「本会话即收口为专柜」
  一句——那是新发生的事实(模型需知),非教程;错误仍 throw 'Error:'(§五 回显惯例);
- scheduler.fmtIso 新增导出;探针 9 项全过(编号/ISO/截断/零教学残留/三行确认,
  一条 FAIL 为探针断言把 09-30 猜成 10 月,产品输出正确)。
This commit is contained in:
2026-09-29 17:25:49 +08:00
parent 81025a7929
commit 4de159c896
2 changed files with 38 additions and 27 deletions
+11 -1
View File
@@ -24,6 +24,16 @@ 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) {
@@ -202,4 +212,4 @@ function start(engine) {
if (timer.unref) timer.unref(); // 不阻止进程退出
}
module.exports = { start, createTask, getTask, listUserTasks, updateTask, deleteTask, computeNext, validateCron, fmtTime };
module.exports = { start, createTask, getTask, listUserTasks, updateTask, deleteTask, computeNext, validateCron, fmtTime, fmtIso };
+27 -26
View File
@@ -897,7 +897,23 @@ async function toolMintPublicLink(ctx, args) {
// 任务住会话(表主键 session_id → 每会话至多一条),「哪个任务」就用所属会话 id 指认:
// id 省略/'0' = 本会话(兼容旧调用);跨会话操作带 op=list 里看到的 id,同用户校验——
// 用户不切会话,AI 代办一切。create 只落当前会话(定时即下班,建完本会话收口退位成专柜)。
// 条件必填在代码里校验(schema 只 required op),错误回显 op 与缺失字段;delete 不落 scheduler_note。
// 回执只给事实,零教学(怎么做写在 schema description 里,不每次复读):
// 列表/详情用编号条目 + key=value 分行,时间 ISO+08:00,prompt 截断;写操单一行短确认。
function schedEntry(t, idx) {
const clip = s => { s = String(s || '').replace(/\s+/g, ' ').trim(); return s.length > 160 ? s.slice(0, 160) + '…' : s; };
const lines = [];
if (idx) lines.push((idx) + '. ' + (t.brief || t.title || t.session_id));
lines.push('id=' + t.session_id + (t.current ? '(本会话)' : ''));
if (t.title) lines.push('name=' + t.title);
if (t.brief) lines.push('brief=' + t.brief);
lines.push('cron="' + t.cron_expr + '"');
lines.push('next=' + scheduler.fmtIso(t.next_run_at));
if (t.last_run_at) lines.push('last=' + scheduler.fmtIso(t.last_run_at) + ' last_status=' + (t.last_status || '-'));
else lines.push('last=尚未执行');
if (t.last_note) lines.push('last_note=' + clip(t.last_note));
if (t.prompt) lines.push('prompt="' + clip(t.prompt) + '"');
return lines.join('\n');
}
function toolScheduleTask(ctx, args) {
const op = String(args.op || '').trim().toLowerCase();
const cronExpr = String(args.cron_expr || '').trim();
@@ -913,17 +929,12 @@ function toolScheduleTask(ctx, args) {
if (String(s.user || '') !== curUser()) throw new Error('无权操作其他用户的会话任务');
return raw;
};
const where = sid => sid === ctx.sessionId ? '' : '(会话 ' + sid + ')';
switch (op) {
case 'get': {
const sid = target();
const t = scheduler.getTask(db, sid);
if (!t) return '该会话' + (sid === ctx.sessionId ? '' : '(' + sid + ')') + '没有定时任务。要创建用 op=create(只落当前会话)。';
const last = t.last_run_at
? scheduler.fmtTime(t.last_run_at) + '(状态 ' + (t.last_status || '-') + (t.last_note ? ',' + t.last_note : '') + ')'
: '尚未执行';
return '定时任务' + where(sid) + (t.brief ? '「' + t.brief + '」' : '') + ':cron=' + t.cron_expr + '(Asia/Shanghai),下次执行 ' +
scheduler.fmtTime(t.next_run_at) + ',上次执行 ' + last + '。提示词:' + t.prompt;
if (!t) return sid === ctx.sessionId ? '本会话没有定时任务。' : '会话 ' + sid + ' 没有定时任务。';
return schedEntry(Object.assign({ session_id: sid, current: sid === ctx.sessionId }, t), 0);
}
case 'create': {
const raw = String(args.id == null ? '' : args.id).trim();
@@ -934,9 +945,8 @@ function toolScheduleTask(ctx, args) {
const t = scheduler.createTask(db, ctx.sessionId, cronExpr, prompt, brief);
// 定时即下班:标记本回合收尾时由 engine 收口(brief 碎片 + 归档 + 通道解绑,见 engine.taskClockOut)。
if (ctx.onTaskCreated) ctx.onTaskCreated();
return '定时任务已创建:' + t.cron_expr + ',下次执行 ' + t.next_text + '(Asia/Shanghai)。' +
'注意:每次触发前本会话的历史消息会被存档(AI 只看到任务 prompt),因此 prompt 需自包含;' +
'后续改动用 op=update,取消用 op=delete。' + (brief ? '' : '(下次创建记得带 brief:一句话说明任务干什么,它会写进你的长期记忆。)');
return '已创建 id=' + ctx.sessionId + '\ncron="' + t.cron_expr + '"\nnext=' + scheduler.fmtIso(t.next_run_at)
+ '\n本会话即收口为该任务专柜(用户无感知,下条消息自动进新会话)。';
}
case 'update': {
if (!cronExpr && !prompt) throw new Error('op=update 需要 cron_expr 和 prompt 至少提供一个');
@@ -945,28 +955,19 @@ function toolScheduleTask(ctx, args) {
cronExpr: cronExpr || null,
prompt: prompt || null,
});
return '定时任务已更新' + where(sid) + ':' + t.cron_expr + ',下次执行 ' + t.next_text + '(Asia/Shanghai)。';
return '已更新 id=' + sid + '\ncron="' + t.cron_expr + '"\nnext=' + scheduler.fmtIso(t.next_run_at);
}
case 'list': {
// 跨会话全览:每行尾挂所属会话 id,AI 拿 id 直接代办改删——不再出现任何
//「让用户切会话」式引导(用户不会切)。
// 跨会话全览:编号条目 + key=value 行,id 即行动把手(无任何教学/切会话引导)。
const rows = scheduler.listUserTasks(db, curUser());
if (!rows.length) return '你目前没有任何定时任务。要创建用 op=create(落在本会话,建成后本会话退位成该任务专柜)。';
const lines = rows.map(t => {
const last = t.last_run_at
? scheduler.fmtTime(t.last_run_at) + '(' + (t.last_status || '-') + (t.last_note ? ',' + t.last_note : '') + ')'
: '尚未执行';
return '- id=' + t.session_id + (t.session_id === ctx.sessionId ? '(本会话)' : '')
+ ' 「' + (t.brief || String(t.prompt).slice(0, 40)) + '」 cron=' + t.cron_expr
+ ',下次 ' + scheduler.fmtTime(t.next_run_at) + ',上次 ' + last;
});
return '全部定时任务(' + rows.length + ' 个,按下次执行排序):\n' + lines.join('\n')
+ '\n改/删直接 op=update / op=delete 并带对应 id;新建闹钟用 op=create(只落本会话,定时即下班)。';
if (!rows.length) return '当前没有任何定时任务。';
return '定时任务×' + rows.length + '(按下次执行排序)\n\n'
+ rows.map((t, i) => schedEntry(Object.assign({}, t, { current: t.session_id === ctx.sessionId }), i + 1)).join('\n\n');
}
case 'delete': {
const sid = target();
const old = scheduler.deleteTask(db, sid);
return '定时任务已删除' + where(sid) + '(原定 ' + old + ')。要建新任务用 op=create(本会话)。';
return '已删除 id=' + sid + '(原定 cron="' + old + '")';
}
default:
throw new Error('未知的 op:"' + op + '"。可用:get / list(跨会话全览,每行带 id)/ create(仅当前会话;需 cron_expr、prompt、brief)/ update(需 cron_expr、prompt 至少一个,可选 id)/ delete(可选 id)');