宝藏阁计划任务模块使用说明

计划任务用于定时触发站内的自动化执行。项目中所有“定时能力”统一复用同一套调度器：/api/admin/automation/scheduler，避免多套调度冲突。

一分钟上手（3步创建 + 1步验收）

1. 在 /admin/automation 建一个 workflow

   • 目标设为 publish

   • 平台先选 site + wechat + zhihu（先跑通主链路）

2. 在 /admin/schedules 的意图沟通面板输入你的任务目标

   • 让智能体评估并生成计划

   • 确认“流程预览”后点击按建议新建计划

3. 设定 Cron/间隔并启用计划

   • 保存后不会立即执行，会等触发窗口

4. 去 /admin/automation 看执行报告验收

   • 确认阶段连续成功：采集 ->（可选评估）-> 改写 -> 发布

   • 确认站内是“已发布”且平台返回成功/可诊断失败信息

两类计划任务

A. 工作流模板定时（Workflow Templates）

入口：后台「流程设置」/admin/automation

工作流模板支持：

• scheduleEnabled：是否启用

• scheduleMode：cron / interval

• cronExpr / intervalMinutes

• 执行动作：publish.plan 或 agent.reflect.tick

• flowDsl：用于推导改写/发布/公众号发布等开关

B. 自定义计划任务（Custom Schedules）

入口：后台「计划任务」/admin/schedules

自定义计划任务支持：

• 触发时间：Cron / 间隔

• 计划内容：Markdown 文本（作为本次执行的 rawContent 输入）

• 引用工作流：选择一个既有 workflow template（用于复用平台/提示词/DSL 等能力）

• 站内搜索关键词：自动抓取站内热度最高的相关文章（views 最大）作为素材拼接进计划内容

• 完成提醒：左右滑动开关；完成后走推送渠道 + SMTP 邮件（SMTP 已配置时）

存储位置（Settings key）：

• automation.schedules.items

调度执行入口（Scheduler API）

路径：/api/admin/automation/scheduler

POST /api/admin/automation/scheduler

用途：

• 由内部调度器（docker sidecar / cron）每分钟触发

• 后台也可手动触发（用于排障/预演）

Headers（二选一即可）：

• x-scheduler-token: <SCHEDULER_TOKEN>（内部调度器触发）

• 或管理员登录态/Token（后台手动触发）

Query：

• dryRun=true：只预演输出 due 列表，不实际执行

• templateId=<id>：只强制执行某个 workflow template（自定义计划不使用该参数）

返回：

• data.runDetails：本次执行明细（success/failed/dry-run 等）

• data.skippedByReason：未触发原因计数

• data.historyEntry：本次运行汇总

执行链路（协同工作方式）

计划任务最终会落入 Fusion 的“发布计划”能力：

1. Scheduler 判定 due

2. 创建发布计划 createPublishPlan(...)（可携带 rawContent/prompt/flowDsl）

3. 若开启直连执行，则 scheduler 会调用 Fusion 执行 publish.plan.execute

关键实现：

• Scheduler：/scheduler/route.ts

• 创建发布计划：/fusion.ts

• Fusion API：/fusion/route.ts

多平台发布与采集渠道说明

• 工作流模板支持 publishPlatforms 多选字段，可同时投递到站内、公众号、抖音、B站等平台（由平台连接配置决定是否可用）。

• 调度执行时：

  • 若最终目标是 draft，只会落站内草稿；

  • 若最终目标是 publish，会按 publishPlatforms 批量创建发布任务。

• 联合检索内置渠道已包含 Google provider，可作为采集来源之一参与后续流程。

关键实现：

• 模板与平台配置：/automation/page.tsx

• 调度平台解析：/scheduler/route.ts

• 内置搜索 provider：/fusion.ts

完成提醒（推送渠道 + SMTP）

当某个自定义计划任务开启「启用提醒」后：

• 推送渠道：复用现有“通知推送”系统（webhook/telegram/钉钉/飞书/企微/twitter 等），由 sendNotification(...) 分发。

  • 配置页：/admin/settings/notification

  • 实现：/notification/index.ts

• SMTP 邮件：若已配置 SMTP，会额外发送一封邮件到 smtp.from（视作管理员邮箱）。

  • 配置页：/admin/settings

  • 实现：/email.ts

提醒内容包含：

• 计划任务标题

• 成功/失败状态

• 引用工作流 ID

• 执行信息（planId 或 error message）

• 后台入口（若已配置站点 URL）

全链路回归验收脚本（手工）

建议按下面顺序验收“意图评估 -> 采集 -> 可选评估 -> 改写 -> 定时触发 -> 多平台发布”。

1. 在 /admin/automation 新建流程模板

   • 选择 publishPlatforms（至少站内 + 公众号/抖音/B站之一）

   • 配置采集源（可选 union）并启用/关闭评估门禁各测一次

2. 在 /admin/schedules 创建计划

   • 先在意图沟通区确认“执行流程预览”

   • 再设置 Cron 或间隔，并绑定上一步 workflow

3. 保存后立即检查

   • 预期：不会立刻执行（创建即执行应已禁用）

4. 触发窗口到达后检查执行结果

   • 在 automation 调度报告查看阶段轨迹、触发来源、失败分型、修复提示

5. 发布结果核对

   • 发布模式：应在目标平台/通道返回发布成功信息

   • 草稿模式：应仅落站内草稿，不应误发布

6. 异常路径回归

   • 采集为空、评估不通过、平台未接入、凭证错误各验证一次，确认提示可诊断且可恢复

全平台一次性配置清单（站内 -> 所有支持平台）

目标链路：采集 ->（可选评估）-> 改写 -> 站内发布 -> 多平台分发

阶段 1：基础必配

1. 进入 /admin/automation 新建或编辑 workflow

2. 发布目标设为 publish

3. 多平台分发先勾选：site + wechat + zhihu

4. 采集源开启联合检索（含 Google）和内置信息源

5. 首轮建议先关闭评估门禁以验证链路稳定，再开启门禁做质量控制

阶段 2：平台连接器逐项测通

在 automation 的平台连接区逐个平台“保存并测试”：

• site：站内发布可创建文章

• wechat：公众号 token/发布测试通过

• zhihu：连接测试通过并可返回发布结果

• douyin / bilibili / xiaohongshu / toutiao / x / telegram：按接入方式配置凭证或 webhook，逐一测试

说明：

• 站内与公众号链路通常最稳定；

• 其他平台的自动发布能力取决于连接器、凭证和外部执行通道是否可用。

阶段 3：计划任务落地

1. 进入 /admin/schedules 的“计划意图沟通面板”

2. 让智能体评估并生成可执行计划

3. 确认流程预览（阶段、评估策略、发布目标、触发方式）

4. 按建议新建计划并启用

5. 注意：保存后不会立即执行，等待调度窗口触发

阶段 4：验收标准

• 阶段连续成功：采集、评估（可选）、改写、发布

• 站内为“已发布”而非草稿

• 多平台有成功回执或可诊断失败信息

• 调度报告可看到触发来源、阶段轨迹与最终结果

阶段 5：灰度上线建议

1. 第 1 轮：site + wechat + zhihu 连续运行 2~3 次

2. 第 2 轮：追加 x + telegram

3. 第 3 轮：追加 douyin + bilibili + xiaohongshu + toutiao

4. 逐步扩容可快速判断是流程问题还是平台接入问题

计划意图模板（可直接粘贴）

模板 1：日更版（每天固定时间）

请帮我创建一个可执行的自动化计划任务：
目标：每天 17:00 自动产出并发布 1 篇“AI与自动化工具”主题内容。
流程要求：采集 -> 可选质量评估 -> 改写 -> 发布。
采集要求：
- 使用联合搜索与内置信息源；
- 关键词：AI 自动化、Agent 工作流、开源 AI 工具；
- 优先近 24 小时内容，去重后选热度最高候选。
改写要求：
- 产出中文，结构清晰（摘要、要点、实操建议）；
- 保留关键事实，不编造来源；
- 标题可读性优先。
发布要求：
- 发布目标为 publish（不是草稿）；
- 平台：site、wechat、zhihu、xiaohongshu、toutiao、douyin、bilibili、x、telegram；
- 如果某平台未接通，记录失败原因但不影响其他已接通平台继续发布。
调度要求：
- Cron 执行；
- 不要创建即执行，只在调度窗口触发。
请给出可直接落地的计划参数，并展示执行流程预览。

模板 2：周刊版（每周深度）

请创建一个每周自动执行的周刊计划任务：
目标：每周五 18:00 发布“本周 AI 工程与产品实践周刊”。
流程：采集 -> 质量评估（启用，阈值 70）-> 改写 -> 发布。
采集范围：
- 联合搜索 + RSS + 内置信息源；
- 关键词：AI工程、Agent、RAG、模型评测、生产化部署；
- 时间范围近 7 天，去重并按相关性与可信度排序。
改写要求：
- 形成周刊结构：本周趋势、重点工具、落地建议、风险提示；
- 语言专业但可读；
- 文章字数适中，适合多平台分发。
发布要求：
- publish 模式；
- 平台：site、wechat、zhihu、x、telegram（其余平台按接通情况可选）。
调度要求：
- Cron 周期执行；
- 保存后等待调度，不立即触发。
请输出：计划名称、workflow 绑定、Cron、平台配置、失败重试建议、流程预览。

模板 3：突发热点版（高频巡检）

请创建一个高频巡检计划任务，用于突发热点快速发布：
目标：每 120 分钟巡检一次热点，命中后自动生成并发布快讯。
流程：采集 -> （可选评估）-> 改写 -> 发布。
采集要求：
- 联合搜索关键词：AI 热点、模型发布、重要产品更新；
- 优先时效性，近 6 小时；
- 若无高质量候选，终止并记录“无可发布内容”。
改写要求：
- 输出快讯体：结论先行 + 3 个关键点 + 影响判断；
- 减少冗长背景。
发布要求：
- publish；
- 平台优先：site、wechat、x、telegram（其他平台按接通情况追加）。
调度要求：
- interval 120 分钟；
- 严禁创建即执行；
- 同窗口避免重复执行。
请返回可执行参数与流程预览，并标注每一步失败时的处理策略。

模板 4：偏营销风格（增长转化导向）

请帮我创建一个可执行的自动化发布计划，目标偏营销增长：
目标：每天 19:00 产出 1 篇“AI工具/工作流”高转化内容，用于引导咨询或产品试用。
流程：采集 -> 质量评估（启用，阈值 65）-> 改写 -> 发布。
采集要求：
- 联合搜索 + 信息源；
- 关键词：AI效率、自动化提效、工作流模板、真实案例；
- 优先“有数据、有案例、有结论”的内容。
改写要求（营销向）：
- 开头 3 句内给出痛点与收益；
- 结构：痛点 -> 方案 -> 案例 -> 行动建议；
- 标题强调收益和结果；
- 结尾附带明确 CTA（私信/咨询/试用引导）。
发布要求：
- publish 模式，禁止落草稿；
- 平台：site、wechat、zhihu、xiaohongshu、toutiao、douyin、bilibili、x、telegram；
- 平台失败互不阻塞，记录失败原因并继续其他平台。
调度要求：
- Cron 执行；
- 不创建即执行，只在触发窗口执行。
请输出：可落地计划参数、workflow 绑定、发布平台策略、流程预览、失败重试建议。

模板 5：偏技术教程风格（工程可信导向）

请创建一个技术教程导向的自动化计划任务：
目标：每周二、四 20:00 发布“可复现的 AI 工程教程”。
流程：采集 -> 质量评估（启用，阈值 75）-> 改写 -> 发布。
采集要求：
- 联合搜索 + RSS；
- 关键词：Agent 架构、RAG、模型推理、部署、评测；
- 仅保留技术细节充分、可复现的信息源。
改写要求（技术向）：
- 固定结构：背景 -> 前置条件 -> 步骤 -> 核心代码/配置说明 -> 常见问题；
- 明确边界条件与风险；
- 不夸大，不编造，不省略关键参数。
发布要求：
- publish；
- 平台：site、wechat、zhihu、x、telegram（稳定后再加其他平台）。
调度要求：
- Cron 周期执行；
- 保存后等待调度触发，不立即执行。
请返回：计划名称、Cron、workflow、评估阈值、平台分发列表、流程预览、回滚/补发建议。

使用建议

• 建议把“营销风格”和“技术教程风格”分别做成固定 workflow，后续只调整关键词和发布时间。

• 首次上线建议先跑 site + wechat + zhihu，稳定后逐步扩到全平台。

• 每次扩平台后至少观察 2~3 次执行结果，再进入下一批扩容。