dsh-ops-cron/FORK.md

dsh-ops-cron（运维 fork）

本仓库是 Whale-Zhang/dsh-cron-tasks 的 运维 fork，用于：

• Agent 自建定时任务（cron_create / cron_list / …）
• 按创建来源默认投递：WhatsApp 会话 → IM；Web/DSH 会话 → 侧栏新会话
• 与 dsh-im-ops 的 ctx.dshIm.send(botId, targetId, text) 打通
• 可选会话镜像（默认关闭）：mirrorToSession / mirror_to_session=true 时才把摘要写入创建时的有效会话（Web / WhatsApp 绑定会话）

不要与上游 @dsh-external/dsh-cron-tasks 装进同一 profile（工具名冲突）。

安装

# 建议顺序：先 im，再 cron
dsh plugin --profile web add -w "github:hansjone/dsh-im-ops"
dsh plugin --profile web add -w "github:hansjone/dsh-ops-cron"
# 重启 dsh web

本地开发：

dsh plugin --profile web add -w "D:\project\chatgpt\dsh-ops-cron"

相对上游的改动

1. 包名 / cordis id / HTTP 前缀仍为 dsh-ops-cron；侧栏产品文案为「定时任务」
2. Job 增加 delivery: { kind: 'dsh'|'im', botId?, targetId? }
3. Job 增加 origin: { kind: 'web'|'im', sessionId?, peer? }（创建时钉死；IM 开火时优先按 conversationKey 解析当前绑定会话）
4. Job 增加 mirrorToSession: boolean（默认 false；侧栏勾选 / cron_create 的 mirror_to_session）
5. cron_create 支持 delivery / im_bot_id / im_target_id；未显式指定时，若当前会话能 resolveSessionPeer 且已有匹配投递目标 → 默认 IM
6. 开火后若 delivery.kind === 'im'，把 assistant 摘要经 ctx.dshIm.send 投回
7. 开火终态且 mirrorToSession === true 时，把同构摘要镜像进有效会话（agents.get 或 agents.resume 后 session.append，不另开一轮模型；不用 agents.create，避免覆盖已有会话）

执行会话 vs 有效会话

角色	是什么	用途
执行会话	每次开火新建的 root Session（侧栏历史可打开）	跑 Agent、保留工具轨迹
有效会话	创建时的 Web 会话，或 WhatsApp/IM conversationKey 当前绑定的 Session	用户日常追问所在处；仅当 mirrorToSession 开启时才写入摘要

dshIm.send 只保证平台侧可见，不会自动写 Harness 会话日志；镜像是 cron 层可选的额外一步。

关键告警推送仍在 netxops，不经过本插件。