dsh-automation

DeepSeek Harness 的 RPA 式定时网页自动化插件：录制操作 → 生成需求文档 → LLM 生成 Python+Playwright 代码 → 配置触发器定时执行 → 记录运行结果并邮件通知。

使用流程

1. 打开 Harness Web UI（默认 http://127.0.0.1:3080）→ 设置 → 自动化任务。
2. 点「新建自动化任务」：
   • 方式 A：录制操作 — 输入起始网址点「开始录制」，会弹出一个可见的 Chrome 窗口，你在里面正常操作（点击/输入/翻页），每一步自动截图。按 F9 或点浮动「停止录制」按钮结束，然后点「生成需求文档」。
   • 方式 B：手动写需求 — 跳过录制直接编写需求文档。
3. 微调需求文档（可编辑）。
4. 点「生成自动化代码」→ LLM 生成 Python + Playwright 脚本（可编辑）。
5. 运行配置：下载/获取内容的保存目录、运行记录存储目录、通知邮箱。
6. 触发器：cron（如 0 9 * * * 每天 9 点）/ 间隔 / 一次性 / 仅手动。
7. 保存。任务到点自动执行；每次运行生成一份 .md 运行记录，可选 SMTP 邮件通知。

服务端 API（/dsh-automation/*）

接口	说明
GET /status	插件状态
GET/POST /config	读写配置（LLM provider/model、Python 路径、SMTP、目录）
GET /models	列出可用 LLM provider 与模型
GET/POST /tasks	任务列表 / 新建任务
GET/PUT/DELETE /tasks/:id	任务详情 / 更新 / 删除
POST /tasks/:id/run	立即运行一次
POST /tasks/:id/enable	启用 / 停用触发器
GET /tasks/:id/runs	运行历史
POST /record/start POST /record/stop GET /record/status	录制器控制
POST /generate/requirement	录制数据 → 需求文档
POST /generate/code	需求文档 → Python 代码
POST /notify/test	发送测试邮件

配置

• LLM：复用 harness 的 ctx.llm（provider 如 deepseek-official / ali），不单独消耗 API key；留空自动选择。
• Python：生成脚本用 python 配置的执行（默认 D:\Anaconda3\python.exe），需 pip install playwright 并 playwright install chromium。
• 邮件：SMTP 配置（host/port/账号/授权码）+ 收件邮箱。agent-mail MCP 适配器可后续接入（代码中 notifier.notify 是唯一出口）。

数据存储

$DSH_HOME/profiles/web/data/dsh-automation/：

• tasks/*.json 任务定义（需求、代码、触发器、配置）
• runs/<taskId>/*.json 结构化运行记录
• recordings/*/ 录制数据（steps + 截图）
• settings.json 插件配置

开发说明

• 服务端：lib/index.js（cordis 插件，inject: ['webServer', 'llm']），HTTP 路由用 ctx.webServer.register({ kind: 'prefix', path: '/dsh-automation', handler })。
• 客户端：client/client.js 通过 window.__ModuleLoader__.load 注入，ctx.slots.inject('settings.section', ...) 挂载设置页。
• 录制器：runner/recorder.py（headed Chromium + 注入录制脚本，F9 停止）。