前言¶
下面介绍 dsh-polling。它是 DeepSeek Harness 的插件,用于把自然语言描述的重复任务变成 cron 驱动的轮询任务/定时任务,并以真实会话执行。维护者是 cnyac,许可证为 MIT。
它的目标比较具体:当你需要定期检查文件夹、网页,或者定时抓数据、写日报/周报、整理归档、跑脚本时,不再每次手动发起对话,而是让 Harness 按时间触发,在独立会话里完成。
核心能力¶
用自然语言创建任务¶
可以直接描述任务,例如:
帮我建个轮询任务:每个工作日早上 9 点检查
D:\稿件\待处理,有新稿件就按常规流程润色归档。
插件支持自然语言创建轮询任务,并提供模型工具:
polling_create
polling_list
polling_edit
polling_delete
polling_trigger
以真实会话执行¶
任务会在自己的会话里执行,不中断当前对话。过程和结果保留在对应会话中,可以打开查看。
新建任务时可选标准、PTC、极简、创造或自定义模式。任务执行时不能切换模式,需要等任务完成后再保存。
Web UI 管理¶
插件提供 Web UI,可查看任务列表、搜索、立即执行、编辑、启停和删除任务。
调度行为¶
- 错过时间后,下次启动补跑最近一次。
- 上一个任务仍在运行时,新触发会跳过。
安装与启用¶
先确认本机已安装 dsh CLI,并且运行过 dsh web。Node 引擎要求为:
node ^22.19.0 || >=24.0.0
然后执行:
dsh plugin --profile web add github:cnyac/dsh-polling
如果通过 GitHub 方式首次安装,会提示允许构建,按提示确认一次即可。
安装后重启 dsh web,侧边栏会出现「轮询」工作区。
典型用法¶
创建任务¶
在 Harness 中直接输入:
帮我建个轮询任务:每个工作日早上 9 点检查
D:\稿件\待处理,有新稿件就按常规流程润色归档。
创建成功后,到点会自动触发。
管理任务¶
有两个入口:
- 侧边栏「轮询」工作区 → 点进任务会话 → 会话顶部「轮询任务」:快捷查看状态、立即执行和编辑。
- 设置 → 插件 →「轮询任务」标签:任务列表和独立编辑页,支持搜索、新建、编辑、立即执行、启停和删除。
可选配置¶
插件支持自定义数据目录 dir 与 keepPinned 配置。在 profile 的 cordis.patch.yml 中配置示例:
- id: polling
name: dsh-polling
config:
dir: 'D:\MyPolling'
keepPinned: true
适用场景与注意¶
适合把重复性、可描述的检查与执行流程交给 Harness 自动跑,例如盯文件夹、盯网页、抓数据、写日报/周报、整理归档、发消息、跑脚本。
使用前注意:
- 每次触发等于一次模型调用,频率越高费用越多,按实际需要设置。
- 任务由模型自主执行,插件运行在当前
dsh进程环境中,权限与手动对话一致;安装前建议检查源码与许可证。 - 任务数据保存在本机
$DSH_HOME下,插件不向外部服务上报。
结尾¶
dsh-polling 的价值在于把定时触发、自然语言任务描述、真实会话执行和 Web UI 管理放在同一个插件里。
目录页:DSH 社区目录(搜索 dsh-polling)。
GitHub:https://github.com/cnyac/dsh-polling