refactor(schedule): 评审落地——schema 去重提级、script 语义澄清、'0' 魔法值移除、brief 帽对齐文档

砖家评审逐条处置(采纳为主,两处按项目现实驳回):
- ①冗余合并:时区/id 规则/每会话一任务各只说一次;但 Required with op=X 的双写
  (description 行 + 参数一句)是 tool-design.md §四 明文规范,保留;
- ②create 副作用提级为独立 'Side effect:' 行,不再夹在句中;
- ③轻补返回语义一行(k=v 块 / 'Error: ...' 可修正重试),不枚举错误场景(现场回显即真语义);
- ④驳回 allOf/if-then:多平台 function-calling 子集不保证支持,严格端点 400、宽容端点忽略,
  收益归零风险为正;§四 紧凑格式就是本环境的答案;
- ⑤script 澄清三点写进描述:提供即「本回合把它写出来」、创建后不可改、缺失脚本由触发回合
  报错现场处理(非静默);
- ⑥'0' 删除(用户拍板:莫名其妙):target()/create 检查/schema 三处同步,omit 即本会话;
- ⑦揪出真 bug:文档说 brief<=40 字符、代码截 80——统一到 40,并注明 CJK 按字计、创建后不可变。

探针 6 项:省略 id 全链路正常、id='0' get/create 均拒、brief 实际截 40、list/get 无回归。
This commit is contained in:
2026-09-29 19:00:54 +08:00
parent 337f79c653
commit 23ede0fe61
3 changed files with 11 additions and 11 deletions
+1 -1
View File
@@ -68,7 +68,7 @@ function createTask(db, sessionId, cronExpr, prompt, brief, script) {
try {
db.prepare(
'INSERT INTO scheduled_tasks (session_id, cron_expr, prompt, brief, script, next_run_at, created_at) VALUES (?,?,?,?,?,?,?)'
).run(sessionId, cronExpr, prompt, String(brief || '').slice(0, 80), String(script || '').replace(/\s+/g, ' ').trim().slice(0, 80), first, Date.now());
).run(sessionId, cronExpr, prompt, String(brief || '').slice(0, 40), String(script || '').replace(/\s+/g, ' ').trim().slice(0, 80), first, Date.now());
} catch (_) {
// 单进程同步 API 下正常到不了这里(上一步已查重),仅作主键约束重复报错的兜底
const ex = db.prepare('SELECT cron_expr FROM scheduled_tasks WHERE session_id = ?').get(sessionId);