DeepSeek Harness - 自动化任务与调度中心插件 (@rooode/dsh-plugin-automation)

本插件为 DeepSeek Harness (DSH) 提供了类似 WorkBuddy (WB) 的完整自动化调度与任务管理中心。全面采用 Node.js 服务端常驻调度架构，支持在 Web 界面中通过可视化面板配置定时任务、选择模型与运行模式、审计全量运行历史，实现 24/7 后台无人值守稳定调度执行！

---

🌟 核心特性 (Features)

1. ⚡ 24/7 Node.js 服务端常驻后台调度：
   • 调度引擎常驻于 Node.js 服务端，完全不受浏览器标签页关闭、休眠、切屏后台降频（Timer Throttling）的影响，实现真正的无人值守周期执行。
2. 🛡️ 原生去 DOM 化的 Headless 会话执行引擎：
   • 任务触发时，由服务端通过 DSH 原生 RPC（session.create ➡️ session.rename ➡️ session.selectModel ➡️ session.prompt）直接调用，彻底告别 DOM 模拟与“找不到输入框超时”异常。
3. 📁 智能工作区适配：
   • 提取并精简展示末级目录名称（如 📁 wb），悬停显示完整路径；触发时智能关联当前环境的 Workspace，解决跨机器路径标识不一致问题。
4. 🧭 左侧导航栏原生居中挂载：
   • 紧随「+ 新会话」按钮下方居中对齐，内置 WorkBuddy 原生时钟图标与活跃任务数徽标（Badge）。
5. 📋 主工作区横向通栏卡片列表 (一行一条)：
   • 采用宽敞舒展的 5 轨横向排版，调度频率、模型标签与右侧固定操作按钮（⚡ 运行、⏸ 暂停 / ▶ 启用、✏️ 编辑、🗑️ 删除）各得其所，彻底杜绝按钮挤占。
6. 📑 顶栏标签页导航：
   • 📋 任务列表：卡片式浏览全部任务、下次执行倒计时、调度/暂停/正在执行状态。
   • 📜 运行记录：全量运行审计大表格，记录服务端毫秒级耗时与错误追溯，支持点击条目直接跳转至对应会话。
   • + 新建任务 / ✏️ 编辑任务：WorkBuddy 风格双栏编辑布局。
7. 🎛️ 提示词与模型/模式一体化输入框 (Prompt Composer)：
   • 内置底部工具栏模型选择器（对齐 DSH 真实的 DeepSeek-V4-Flash、DeepSeek-V4-Pro、DeepSeek-V4-Flash-Vision-Exp）。
   • 内置 Agent 模式预设选择器（对齐 DSH 真实的 标准模式、PTC 模式、极简模式、创造模式）。
8. ⏱️ 对齐 WorkBuddy 的「执行频率」系统：
   • 周期执行（每天 / 每周指定周几多选 / 每月指定日期 + 时间选择器）。
   • 间隔执行（每隔 N 小时 / N 分钟）。
   • 单次定时（指定年月日 + 时间）。
9. 📜 右侧专属「运行历史」面板：
   • 针对当前任务独立展示历史执行记录、触发方式、执行模型与状态，点击可直接跳转对应会话。

---

📦 快速安装 (Installation)

在终端中执行以下命令，将插件一键安装到 DSH 的 web profile 中：

方式 1：标准 npx 安装（推荐，无需全局安装）

# 1. 一键从 npm 下载并安装插件
npx @deepseek-ai/dsh plugin --profile web add @rooode/dsh-plugin-automation

# 2. 启动 DSH Web 界面
npx @deepseek-ai/dsh web

方式 2：全局 dsh CLI 安装

如果您已全局安装了 npm install -g @deepseek-ai/dsh：

# 1. 安装插件
dsh plugin --profile web add @rooode/dsh-plugin-automation

# 2. 启动
dsh web

方式 3：离线 Tarball 安装（适合内网/断网环境）

# 下载或拷贝 rooode-dsh-plugin-automation-*.tgz 后执行：
npx @deepseek-ai/dsh plugin --profile web add ./rooode-dsh-plugin-automation-0.2.0.tgz

---

⚙️ 配置项说明 (Configuration)

可在 cordis.patch.yml 中自定义配置以下参数：

- insert:
    - id: ui-automation
      name: '@rooode/dsh-plugin-automation'
      config:
        defaultPollingIntervalMs: 5000
        maxStoredRecords: 100
        # storageFilePath: '~/.dsh/storages/automations.json'

配置参数列表

配置项	类型	默认值	说明
defaultPollingIntervalMs	number	5000	自动化任务轮询检测与调度触发间隔（毫秒）
maxStoredRecords	number	100	历史运行记录最大保留条数
storageFilePath	string	~/.dsh/storages/automations.json	自定义自动化任务持久化存储的 JSON 文件路径

---

📁 项目结构 (Directory Structure)

dsh-plugin-automation/
├── package.json          # 插件元信息、dsh.bundle/client 声明与 npm scripts
├── cordis.patch.yml      # 官方标准 Bundle Manifest 配置文件
├── tsconfig.json         # TypeScript 严格编译与类型输出配置
├── README.md             # 插件技术说明与安装文档
├── src/
│   ├── types.ts          # 任务、频率、模型与模式的 TypeScript 接口定义
│   ├── service.ts        # Cordis 服务 AutomationService (服务端调度与 REST API 路由)
│   ├── tool.ts           # 大模型 Agent 自动化管理工具注册 (automation_manage)
│   ├── index.ts          # Node 端入口：服务初始化、WebServer 注入与 Schema 校验
│   └── client.js         # 前端 React 视图组件与状态机源码
├── lib/
│   ├── index.js          # Node 端 ESM 产物
│   ├── service.js        # 服务端常驻调度引擎产物
│   ├── index.d.ts        # TypeScript 导出类型声明
│   ├── types.d.ts        # 核心类型声明
│   └── client.js         # 前端独立分发 Bundle
└── scripts/
    ├── build.js          # 编译与 Profile 自动分发同步脚本
    └── test_service.js   # 服务端调度引擎本地测试脚本

---

🛠️ 本地开发与二次构建 (Development)

在本项目根目录下执行：

# 1. 编译并将最新产物同步至本地 DSH 运行环境
npm run build

# 2. 监听文件变动实时编译分发
npm run dev

# 3. 执行类型检查
npm run typecheck

# 4. 生成离线分发 tarball 压缩包
npm run package

---

📄 开源许可证 (License)

MIT License © 2026 rooode