dsh-automation

Readme

# 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 停止）。