schedule_task改名schedule:工具名即资源,动词已在op;definitions/HANDLERS与scheduler/db/routes/前端注释/ARCHITECTURE同步(表名scheduled_tasks与路由/id/schedule不动)
This commit is contained in:
+1
-1
@@ -81,7 +81,7 @@ function initDb(dbPath) {
|
||||
value TEXT
|
||||
);
|
||||
|
||||
-- 定时任务:AI 通过 schedule_task 工具为会话创建周期任务(每会话至多一个),
|
||||
-- 定时任务:AI 通过 schedule 工具为会话创建周期任务(每会话至多一个),
|
||||
-- 由 scheduler.js 轮询投递。session_id 作主键:一行代码同时实现「1 会话 1 任务」
|
||||
-- 与「防重复插入」(重复 INSERT 直接撞主键);REFERENCES ... ON DELETE CASCADE
|
||||
-- 让删会话时任务自动消失(db 已开 foreign_keys)。next_run_at 创建时即算好,
|
||||
|
||||
@@ -56,7 +56,7 @@
|
||||
.stop-link.icon-only.icon-primary:hover { color: #2854d6; }
|
||||
/* 推到 phase-bar 最右侧(独立动作,与左侧状态/选择模型区分) */
|
||||
.phase-bar .phase-bar-right { margin-left: auto; }
|
||||
/* 定时任务状态条:整条可点,弹详情窗(改频次/提示词、删除;创建走 AI 的 schedule_task 工具),紫色调区别于状态栏;
|
||||
/* 定时任务状态条:整条可点,弹详情窗(改频次/提示词、删除;创建走 AI 的 schedule 工具),紫色调区别于状态栏;
|
||||
左侧 3px 竖条与侧边栏定时任务会话的紫色标记同一语义。
|
||||
高度与 phase-bar 对齐:同 6px 上下内边距,sched-text 用与 stop-link 同构的 12px 字 + 4px 上下 padding(天然同 line-box),eye 同 icon-only 钮 */
|
||||
.schedule-bar {
|
||||
|
||||
@@ -206,7 +206,7 @@ router.get('/:id', wrap((req, res) => {
|
||||
}
|
||||
|
||||
const taskDir = engine.taskDirOf(session.id);
|
||||
// 定时任务状态(scheduler.js / schedule_task 工具;每会话至多一行,无则 null)。
|
||||
// 定时任务状态(scheduler.js / schedule 工具;每会话至多一行,无则 null)。
|
||||
// 列表接口故意不带此字段,避免 N+1;前端进会话详情时才拉。
|
||||
const schedule = db.prepare(
|
||||
'SELECT cron_expr, prompt, next_run_at, last_run_at, last_status, last_note FROM scheduled_tasks WHERE session_id = ?'
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
// 定时任务调度器:AI 通过 schedule_task 工具为所在会话创建一个周期性任务
|
||||
// 定时任务调度器:AI 通过 schedule 工具为所在会话创建一个周期性任务
|
||||
// (scheduled_tasks 表,生命周期绑定会话,CASCADE 随删),本模块常驻轮询到期任务:
|
||||
// 先把会话历史整体存档(type='archived',llm.buildMessages 会跳过 → AI 只看到本次
|
||||
// prompt,等价全新会话),再经 engine.postUserMessage 投递任务 prompt 自动开跑,
|
||||
@@ -30,7 +30,7 @@ function computeNext(cronExpr) {
|
||||
return CronExpressionParser.parse(cronExpr, { tz: TZ }).next().getTime();
|
||||
}
|
||||
|
||||
// ---------- schedule_task 工具实现(tools/executor.js 调) ----------
|
||||
// ---------- schedule 工具实现(tools/executor.js 调) ----------
|
||||
// cron 校验:可解析 + 连续两次 next() 间隔 ≥ 1h(防分钟级任务反复烧模型池);
|
||||
// 返回下次到期时间(以 now 为基准)。创建(createTask)与会话详情弹窗改频次(PATCH /:id/schedule)共用。
|
||||
// 失败抛中文 Error:工具路径由 engine 转 'Error: ...' 回给 AI,HTTP 路径由 wrap 转 4xx/500 给前端 toast。
|
||||
|
||||
@@ -102,7 +102,7 @@
|
||||
{
|
||||
"type": "function",
|
||||
"function": {
|
||||
"name": "schedule_task",
|
||||
"name": "schedule",
|
||||
"description": "Manage the recurring scheduled task bound to the CURRENT session. At most one task per session; it is deleted together with the session. At each trigger, the prompt is sent to this session as a new user message. Schedule times are interpreted in Asia/Shanghai (UTC+8). Call this ONLY when the user explicitly asks for something to run periodically or at a specific time.\n\nop=get No arguments.\nop=create Requires cron_expr and prompt.\nop=update Requires at least one of cron_expr, prompt; only the given fields change.\nop=delete No arguments.",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
|
||||
@@ -756,7 +756,7 @@ async function toolMintPublicLink(ctx, args) {
|
||||
return pl.base_url + '/p/' + id;
|
||||
}
|
||||
|
||||
// schedule_task:当前会话定时任务的完整生命周期(op 分派,规范见 docs/tool-design.md)。
|
||||
// schedule:当前会话定时任务的完整生命周期(op 分派,规范见 docs/tool-design.md)。
|
||||
// sessionId 取自 ctx(AI 无法指定别的会话);表主键 session_id → 每会话至多一条,
|
||||
// 资源即「本会话的任务」,无 id 参数。条件必填在代码里校验(schema 只 required op),
|
||||
// 错误回显 op 与缺失字段;delete 不落 scheduler_note(返回文本本身已进会话记录)。
|
||||
@@ -831,7 +831,7 @@ const HANDLERS = {
|
||||
mint_public_link: toolMintPublicLink,
|
||||
terminal: toolTerminal,
|
||||
fetch: toolFetch,
|
||||
schedule_task: toolScheduleTask,
|
||||
schedule: toolScheduleTask,
|
||||
skill: toolSkill,
|
||||
};
|
||||
|
||||
|
||||
@@ -192,7 +192,7 @@ scheduled_tasks session_id PK (FK sessions, ON DELETE CASCADE) / cron_expr /
|
||||
prompt / next_run_at / last_run_at / last_status (ok|error|skipped|running) /
|
||||
last_note (给人看的中文说明,UI 原样展示) / created_at
|
||||
# 定时任务:每会话至多一个(session_id 主键兼防重),按 next_run_at 索引;
|
||||
# 创建只经 AI 工具 schedule_task;频次/提示词可在会话详情弹窗改(PATCH /:id/schedule,
|
||||
# 创建只经 AI 工具 schedule;频次/提示词可在会话详情弹窗改(PATCH /:id/schedule,
|
||||
# 改频次后端重校验并重算 next_run_at);删除走 CASCADE 或 DELETE /:id/schedule(见 §5.12)
|
||||
```
|
||||
|
||||
@@ -292,7 +292,7 @@ stateDiagram-v2
|
||||
| `fetch` | `AbortController` 覆盖全生命周期(响应头之后的 body 读流同样被超时/取消打断,取消用与 terminal 同款的 200ms 轮询);content-type 先行,非文本只回状态/类型/尺寸不读 body;流式读到 `cfg.fetch.max_bytes`(默认 1MB)即断开并标注截断;按响应 charset 解码(full-icu 支持 gbk/gb18030 等,未知编码退回 UTF-8);HTML 用 `htmlToMarkdown` 转;HTML 实体单遍解码(常见命名实体+数字实体通吃,修 `&` 双重解码);网络错误解包 `err.cause` 直述 ENOTFOUND/TLS 等真因;engine 不截工具结果,返回值末尾另有 `truncate` 1MB 字符护栏 |
|
||||
| `mint_public_link` | **唯一的 mint 入口**:与 core 同进程,直接 `publicFiles.mint()`,不绕任何 HTTP;`ctx.taskDir` 就是会话目录,`relOf` 的结果正是取用侧要的 `rel`。校验:`public_link.base_url` 已配 + `resolveInTask` 沙箱 + 确认是文件 + `realpath` 未沿符号链接跳出任务目录;返回单行 URL |
|
||||
| `skill` | op 分派 list/get/run(三件套合并:同一 `skill_name` 标识空间 + 同一生命周期,见 `docs/tool-design.md` §一);委托 `tools/skills.js`;`input_args` 仅 op=run 且可缺省 `{}`,缺参由各技能 `input_schema` 校验点名报错 |
|
||||
| `schedule_task` | **当前会话**(`ctx.sessionId`,AI 不可指定他会话)定时任务的完整生命周期:op 分派 get/create/update/delete(表主键 session_id → 每会话至多一条,无 id 参数);条件必填在代码里校验、错误回显 op 与缺失字段;数据层在 `scheduler.js`(cron 可解析 → 间隔 ≥1h → prompt ≤20000 → 查重/存在性检查),delete 不落 scheduler_note;描述里限定「仅用户明确要求时调用」(安全缓解,见 §5.12) |
|
||||
| `schedule` | **当前会话**(`ctx.sessionId`,AI 不可指定他会话)定时任务的完整生命周期:op 分派 get/create/update/delete(表主键 session_id → 每会话至多一条,无 id 参数);条件必填在代码里校验、错误回显 op 与缺失字段;数据层在 `scheduler.js`(cron 可解析 → 间隔 ≥1h → prompt ≤20000 → 查重/存在性检查),delete 不落 scheduler_note;描述里限定「仅用户明确要求时调用」(安全缓解,见 §5.12) |
|
||||
|
||||
`resolveInTask(taskDir, relOrAbs)`:把相对路径或绝对路径解析为绝对路径并校验落在 `taskDir` 之内(含根),防穿越。
|
||||
|
||||
@@ -361,7 +361,7 @@ stateDiagram-v2
|
||||
|
||||
### 5.12 `scheduler.js` —— 定时任务调度器
|
||||
|
||||
AI 通过 `schedule_task` 工具为所在会话建周期性任务(`scheduled_tasks` 表,生命周期绑定会话),无人值守时(典型是半夜)自动执行,结果留在会话里供用户次日查看。
|
||||
AI 通过 `schedule` 工具为所在会话建周期性任务(`scheduled_tasks` 表,生命周期绑定会话),无人值守时(典型是半夜)自动执行,结果留在会话里供用户次日查看。
|
||||
|
||||
- **形态**照抄 `startHoldSweeper`:`start(engine)` 注入 engine(避免 engine→executor→scheduler 顶层循环 require),`setInterval` 30s + `unref`,单次异常只 `log.error` 不中断定时器。周期/最小间隔是模块常量,不进 config.yml。
|
||||
- **cron**:`cron-parser@5.10.1`(锁版;v5 API 是 `CronExpressionParser.parse`,与 v4 的 `parseExpression` 不兼容),显式 `tz: 'Asia/Shanghai'`(与容器 TZ 一致,不靠隐式时区)。最小间隔 1h 在创建时校验。
|
||||
|
||||
Reference in New Issue
Block a user