dsh-timed-goal

> 在任意 DSH 对话中配置定时任务，到点后自动通过 /goal 执行你预设的提示词——支持斜杠命令与完整的 Web 界面。

![npm version](https://www.npmjs.com/package/dsh-timed-goal) ![license](LICENSE)

DSH（DeepSeek Harness） Web 插件：在任意对话中配置一次性（或每日重复）任务——一个绝对时间加上要执行的提示词。到点时，插件把对话权限固定为任务配置的等级（full access / workspace write，默认 full access）并创建一个已设置的 goal，让预设提示词以 /goal 语义自动执行。

!dsh-timed-goal Web 界面

---

功能一览

按对话配置定时任务 —— 填写绝对时间（年 / 月 / 日 / 时 / 分 / 秒），支持服务器本地时间或 UTC。
到点自动执行 —— 到点时会话被固定为任务配置的权限（默认 full access＝danger-full-access）并创建 goal，由平台 goal 轮次驱动自动运行你的提示词，无需人工干预。
每日重复 —— 每任务可选：触发（或发生冲突）后自动顺延到第二天同一时刻再次执行。
轮数上限 —— 可选限制触发后 goal 的自主轮次数（--rounds <n> 或界面字段；默认跟随宿主，通常为 256）。
任意任务可编辑 —— 编辑已触发/失败的任务会变回「待触发」；添加与编辑都校验只能填写未来的时间。
Web 界面 —— 浏览器原生管理面板（见下），外加 /timed-goal 命令族。
不轮询 —— 界面在打开时与每次变更后获取一次；另有手动刷新按钮按需重读列表。
双语界面 —— 简体中文 / English，跟随 DSH 语言设置。

Web 界面介绍

入口控件（⏱ 定时）位于每个对话的输入框工具行——在所有会话状态下都可见，包括没有对话记录的全新空白对话（会话头部在有内容前会被整体隐藏，因此入口放在始终可见的输入区）。

点击后，配置面板以浏览器页内居中模态框呈现——与「选择工作区」弹窗同款的系统级对话框（官方 Modal 组件，portal 渲染到页面根节点，不随触发按钮定位；半透明幕布；按 Esc、点幕布或「关闭」收起），左右分栏：

左侧 —— 配置任务：日历日期时间选择器（月份切换、日期网格、时/分/秒下拉、"现在"快捷项）、UTC 开关、每日重复复选框、可选轮数输入、提示词文本框。
右侧 —— 已配置的任务：当前对话的任务与实时状态（待触发 / 已触发 / 失败、触发时间、每日徽标、轮数、权限说明），每行带编辑 / 删除，另有手动刷新与清空按钮。

设置页的「定时任务」卡片（settings.section）是只读总览：跨所有会话查看全部已安排任务（含所属会话、状态、时间），每行提供「跳转」按钮直接进入任务所在的对话，以及「删除」按钮删除任意任务（新增/编辑请在对话内通过「⏱ 定时」面板操作）。

环境要求

已安装 DSH，并使用 web profile（dsh web）。
Node.js 18+（与你的 DSH 运行时一致）。

安装

dsh plugin --profile web add dsh-timed-goal

然后重启 dsh web 进程（宿主端插件代码在启动时加载），并验证：

dsh --profile web --dump-config | grep timed-goal

重启后，任意对话输入框工具行会出现 ⏱ 定时 控件，设置页出现「定时任务」卡片。

本地源码目录安装（例如开发调试）：

dsh plugin --profile web add file:/绝对/路径/dsh-timed-goal

卸载

dsh plugin --profile web remove dsh-timed-goal
# 然后重启 dsh web

已配置任务保存在 $DSH_HOME/plugins/dsh-timed-goal/jobs.json（默认 ~/.dsh/plugins/dsh-timed-goal/jobs.json）。若打算重装，请先备份该文件。

使用方法

斜杠命令

在任意对话内发送（完整帮助见 /timed-goal help）：

/timed-goal add 2026-09-01 09:30:00 --rounds 32 把当前时间发送到我的邮箱
/timed-goal 2026-09-01 09:30 --daily 每天早上提醒我喝水
/timed-goal list
/timed-goal remove tg-xxxxxxxx
/timed-goal clear

add 可省略：/timed-goal <时间> <提示词...> 直接可用。
时间格式：YYYY-MM-DD HH:mm[:ss]（服务器本地时间）或 YYYY-MM-DD HH:mm[:ss]Z（UTC）。
--daily：任务每天在此时刻重复执行。
--rounds <n>：限制触发 goal 的自主轮次。
时间必须是未来的；过去的时间会被拒绝。

Web 界面

1. 打开一个对话 → 点击输入框工具行的 ⏱ 定时 → 居中模态框打开。 2. 左栏：在日历中选择日期时间，切换 UTC / 每日重复，可选设置最大轮数，填写提示词，点添加。 3. 右栏：查看任务状态。编辑可修改任务（表单自动回填；已触发/失败的任务保存后回到「待触发」，且只能保存未来的时间）；删除移除任意任务（已触发也可删）；刷新重读列表；清空清掉当前对话的任务。 4. 设置 → 定时任务：查看所有会话的任务总览，可用「跳转」进入任务所在对话、用「删除」移除任务。

工作原理

每秒一次的 tick 扫描持久化任务库（$DSH_HOME/plugins/dsh-timed-goal/jobs.json），任务在 web 重启后依然生效。
到点时插件解析该会话（冷会话会从持久化恢复），把会话权限固定为任务配置的等级（默认 full access＝danger-full-access，也可以选择 workspace write），并以你的提示词创建 goal——由 goal 轮次驱动自动执行。
每日任务在触发（或 GOAL_ALREADY_EXISTS 冲突）后自动顺延到次日；其他失败以 5 秒退避在 30 分钟宽限窗口内重试，之后标记为「失败」——可编辑后重试。
宿主 Web 服务器上的浏览器 API：/timed-goal/jobs —— GET（列表）、POST（创建）、PATCH /timed-goal/jobs/<id>（编辑）、DELETE /timed-goal/jobs/<id>（删除）、DELETE /timed-goal/jobs（清空全部，或带 ?sessionId=… 仅清空某会话）。

安全说明

插件默认以 full access（danger-full-access）执行定时任务——其意义就是在你自己的 DSH 实例中无人值守地自主执行；需要更克制的场景可为单个任务选择 workspace write（仅可写工作区，超出范围需审批）。旧版本安排的任务没有权限字段，升级后仍按 full access 原样触发。请只安排你信任的提示词。

开发

git clone https://github.com/gfds2005/dsh-timed-goal.git
cd dsh-timed-goal
npm test   # 单元 + 集成测试

License

[MIT](LICENSE)

祝使用愉快！⏱

来源信息

安装

检查来源文件