LeisureTimeQueue

LeisureTimeQueue

leisure-time-queue 是一个基于 DeepSeek Harness 的本地闲时任务队列插件。

你可以预先写好任务，并指定每周允许开始执行的时间段，例如“工作日 22:00 到次日 07:00”。只要 DeepSeek Harness 保持运行、目标会话可用且 Agent 处于空闲状态，插件就会按队列顺序自动开始任务。

任务仍在你自己的 DeepSeek Harness 中运行，并使用你已经配置的模型、凭据、权限和本地工作区。尽情享受梁文谷吧。

主要功能

• 在插件界面中配置每周执行时间段，可设置多个不同时段。
• 默认使用操作系统时区，可执行设置时区。
• 创建任务时可以选择已有会话，也可以创建新会话。
• 可以直接从当前会话标题栏把输入框内容加入闲时任务队列。
• 侧边栏提供全局任务入口，可创建任务并管理所有会话中的队列。
• 新建会话时可以选择模型、权限预设和工作区。
• 按 FIFO（先进先出）顺序执行队列。
• 支持暂停、恢复、取消、重试、编辑、删除和立即执行。
• 支持全局执行策略，以及针对单个会话设置不同的时间段。
• 支持 Harness 重启后的队列持久化和已派发任务恢复。

兼容版本

本文档对应以下版本：

组件 · 版本要求 · 说明 DeepSeek Harness CLI · @deepseek-ai/dsh@0.1.5-rc.1 · 至少需要此版本 DeepSeek Harness 相关包 · 0.1.5-rc.1 · 至少需要此版本 |

安装前准备

你需要准备：

1. 满足版本要求的 Node.js。
2. 插件安装包 leisure-time-queue-.tgz。
3. DeepSeek Harness 中至少一个已经配置并可正常调用的模型。

先检查 Node.js 版本：

node --version

如果你拿到的是插件源码，而不是 .tgz 安装包，还需要 pnpm。可以使用 Corepack 启用推荐版本：

corepack enable
corepack prepare pnpm@11.7.0 --activate
pnpm --version

如果当前 Node.js 没有附带 Corepack，也可以执行：

npm install --global pnpm@11.7.0

只有源码时，请先进入插件目录生成安装包：

pnpm install
pnpm pack

成功后，目录中会出现 leisure-time-queue-.tgz。如果你已经有这个文件，可以跳过打包步骤。

Windows 安装

以下命令在 PowerShell 中执行。

1. 安装插件

进入存放 .tgz 文件的目录，并取得它的绝对路径：

Set-Location "C:\path\to\plugin-package"
$pluginPackage = (Resolve-Path ".\leisure-time-queue-<version>.tgz").Path

将插件加入 DeepSeek Harness 的 Web profile：

npx @deepseek-ai/dsh plugin --profile web add $pluginPackage

2. 启动 DeepSeek Harness

先进入你平时希望作为默认工作区的目录，再启动 Web 界面：

Set-Location "C:\path\to\your-workspace"
npx @deepseek-ai/dsh web

启动命令所在目录会成为 DSH 的默认工作区。浏览器打开后即可配置插件。

Windows 的 Web profile 默认位于：

%USERPROFILE%\.dsh\profiles\web

在本机浏览器中使用时，选择工作区通常会打开 Windows 原生文件夹选择窗口。

macOS 安装

以下命令在 Terminal 中执行。

1. 安装插件

cd "/path/to/plugin-package"
plugin_package="$(pwd)/leisure-time-queue-<version>.tgz"
npx @deepseek-ai/dsh plugin --profile web add "$plugin_package"

2. 启动 DeepSeek Harness

cd "/path/to/your-workspace"
npx @deepseek-ai/dsh web

macOS 的 Web profile 默认位于 ~/.dsh/profiles/web。在本机浏览器中使用时，选择工作区通常会打开 macOS 原生文件夹选择窗口。

Linux 安装

以下命令在终端中执行。

1. 安装插件

cd "/path/to/plugin-package"
plugin_package="$(pwd)/leisure-time-queue-<version>.tgz"
npx @deepseek-ai/dsh plugin --profile web add "$plugin_package"

2. 启动 DeepSeek Harness

cd "/path/to/your-workspace"
npx @deepseek-ai/dsh web

Linux 的 Web profile 默认位于 ~/.dsh/profiles/web。

如果桌面环境安装了 Zenity 或 KDialog，工作区选择可以使用系统文件夹选择窗口。在 SSH、远程环境或没有图形选择器时，DSH 会使用内置目录浏览界面。

第一次使用

1. 先确认模型可以正常调用

在创建闲时任务前，建议先打开一个普通 DSH 会话，选择准备使用的模型并发送一条测试消息。

这一步可以提前确认：

• 模型提供方已经配置 API Key 或其他凭据。
• 当前模型在 DSH 中确实可用。
• 模型权限和工作区配置符合预期。

如果普通会话也无法调用模型，应先在 DSH 的“设置 → 模型”中完成模型和凭据配置。

2. 从当前会话快速创建任务

打开任意会话后，点击会话标题栏中的“闲时执行”。插件会自动：

• 使用当前会话作为任务目标；
• 读取当前输入框中的文字作为任务说明；
• 复用当前会话的模型、凭据、权限和工作区；
• 在标题留空时，根据任务说明第一行自动生成标题。

确认任务说明后点击“加入队列”即可。任务加入成功后，输入框中的原内容不会被清空。

3. 从侧边栏管理任务

点击侧边栏底部、设置按钮上方的“闲时任务”：

• “任务队列”页可以查看所有会话中的等待、执行中、失败和已完成任务；
• 可以暂停、恢复、立即执行、取消、重试、编辑或删除任务；
• 点击任务上的会话名称可以返回对应会话；
• “新建任务”页可以选择现有会话，也可以创建新会话。

侧边栏收起时，该入口显示为时钟图标；存在活动任务时会显示数量角标。

4. 打开插件配置

进入：

设置 → 插件 → 插件配置 → 闲时任务队列

展开“闲时任务队列”卡片：

如果没有看到插件，请先完全停止并重新启动 DSH。插件 Bundle 在运行过程中不会自动重新加载。

插件设置页主要用于配置执行时段、时区、并发限制和单个会话的覆盖策略。日常创建和管理任务通常不需要再进入设置页。

5. 配置全局执行策略

在“全局配置”中设置：

• 启用自动执行：关闭后，队列任务不会按时间段自动开始。
• 每日创建上限：限制一天内可以创建的任务数量。
• 最大并发任务数：同一时间最多运行多少个任务。普通电脑建议先设为 1。
• 最大自动续跑轮数：任务需要继续运行时，最多允许 Agent 自动续跑多少轮。
• 时区：首次安装默认使用操作系统时区，可从常用时区下拉框中调整。
• 每周时间段：指定哪些星期、从几点到几点允许任务开始。

安装后的时间段默认为空。即使“启用自动执行”已经打开，没有配置时间段时也不会自动执行任务。

跨午夜时间段按照开始日计算。例如：

周一 22:00 → 07:00

表示周一 22:00 开始，一直持续到周二 07:00。

设置完成后点击保存。

6. 创建任务

在“创建任务”区域选择任务目标。