# dsh-goal-planner

<p align="center">
  <a href="https://github.com/caseyyy/dsh-goal-planner/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/caseyyy/dsh-goal-planner"></a>
  <a href="LICENSE"><img alt="License: GPL-2.0" src="https://img.shields.io/badge/license-GPL--2.0-red.svg"></a>
  <a href="https://awesome-dsh-plugin.com/zh/"><img alt="Awesome DSH Plugin" src="https://awesome-dsh-plugin.com/badge.svg"></a>
</p>

目标驱动的每日任务计划器（DeepSeek Harness 插件）：多目标任务数据 + Web 端「目标计划」预览面板，与微信提醒推送链路共享同一份数据文件。

Goal-driven daily task planner for DeepSeek Harness: multi-goal task data plus a daily preview panel in the Web GUI, sharing one data file with the WeChat reminder pipeline.

## 功能 / Features

- 🎯 **多目标 / Multi-goal**：`goals[]` 支持并行多个目标（每个目标独立截止日期），新目标不覆盖旧目标 / parallel goals with independent deadlines; adding a new goal never overwrites existing ones
- 📅 **每日预览 / Daily preview**：设置 → **目标计划** 面板，按日期翻页查看每一天的任务 / open Settings → **Goal Planner** and page through every day's tasks
- ✅ **一键完成 / One-click done**：面板里直接勾选任务完成/恢复，数据即时落盘 / toggle tasks done/todo in the panel; changes persist immediately
- 🔌 **与推送链路共享数据 / Shared data**：`tasksPath` 配置指向现有 `tasks.json`，即可与 `push-daily.mjs` + `dsh-automation` 的每晚微信推送共用同一份数据 / point `tasksPath` at an existing `tasks.json` to share it with the nightly WeChat push pipeline (`push-daily.mjs` + `dsh-automation`)
- 🔒 **Loopback 安全 / Loopback only**：HTTP API 仅允许 127.0.0.1 访问 / the HTTP API accepts loopback requests only

## 界面预览 / Screenshots

设置侧边栏入口 / Settings entry（设置 → 目标计划 / Settings → Goal Planner）：

![设置入口 / Settings entry](docs/00-settings.png)

今日任务面板（目标概览 + 日期导航 + 任务卡片）/ Today's panel (goal overview + date navigation + task cards)：

![今日面板 / Today's panel](docs/01-panel-today.png)

多任务日期（同一天多个任务依次排列，可一键勾选完成）/ A multi-task day (several tasks listed together, one-click done toggle)：

![多任务日期 / Multi-task day](docs/02-panel-multi-day.png)

## 数据模型 / Data model

```json
{
  "updatedAt": "2026-08-24",
  "goals": [
    { "id": "G1", "title": "给宝宝办齐证件", "deadline": "2026-09-12", "note": "背景备注（可选）" }
  ],
  "tasks": [
    {
      "id": "T01",
      "goalId": "G1",
      "title": "任务标题",
      "detail": "做什么、做到什么程度算完成",
      "time": "具体时间/时段",
      "location": "地点/线上入口",
      "materials": ["要准备的材料"],
      "steps": ["步骤 1"],
      "note": "注意事项",
      "dueDate": "2026-08-25",
      "status": "todo | doing | done"
    }
  ]
}
```

字段说明 / Field notes：`title`、`goalId`、`dueDate`、`status` 必填；`detail`/`time`/`location`/`materials`/`steps`/`note` 可选，有值才在面板与推送中显示 / required: `title`, `goalId`, `dueDate`, `status`; optional fields are shown only when present.

## 安装 / Install

```sh
dsh plugin --profile web add github:caseyyy/dsh-goal-planner
# 本地开发 / local development:
dsh plugin --profile web add link:D:/path/to/dsh-goal-planner -w
```

重启 `dsh web` 后，设置页左侧出现 **目标计划** 入口。

Restart `dsh web`; the **Goal Planner** entry then appears in Settings.

### 指向已有数据文件 / Point at an existing data file

在 profile 的 `cordis.patch.yml` 中覆盖配置 / override in your profile's `cordis.patch.yml`:

```yaml
- id: goal-planner
  config:
    tasksPath: 'D:\\HarnessWorkbench\\goals\\tasks.json'
```

留空则使用 `$DSH_HOME/dsh-goal-planner/tasks.json`。 / Leave empty to use `$DSH_HOME/dsh-goal-planner/tasks.json`.

## HTTP API（仅 loopback / loopback only）

| 方法 Method | 路径 Path | 说明 Description |
|---|---|---|
| GET | `/api/goal-planner/state` | 返回 `{ ok, path, document }` / returns the full document |
| POST | `/api/goal-planner/save` | 整体保存文档（结构校验）/ replaces the document (validated) |
| POST | `/api/goal-planner/toggle` | `{ taskId }` 翻转 todo ↔ done / flips a task's todo/done status |

## 与提醒链路配合 / Working with the reminder pipeline

典型组合（作者自用）/ The typical setup the author runs daily:

- **拆解排期 / Decompose & schedule**：对话中告诉 agent「我的目标是 XXX，截止 YYYY-MM-DD」→ agent 搜索步骤/材料并写入本插件的数据文件 / in a chat, tell the agent "my goal is X, due YYYY-MM-DD" — it researches steps and materials and writes them into this plugin's data file
- **每日微信推送 / Nightly WeChat push**：`dsh-automation` 规则每天 20:30 运行 `node push-daily.mjs`，把「明天」到期任务经 Server酱 推送到微信 / a `dsh-automation` rule runs `node push-daily.mjs` at 20:30 daily and pushes tomorrow's due tasks to WeChat via ServerChan
- **随时预览 / Preview anytime**：本插件面板按天翻看任务 / browse tasks day by day in this plugin's panel

## 开发 / Development

```sh
npm install        # 仅需 esbuild / only esbuild is needed
npm run build      # lib/index.js + lib/client.js
```

- Host 端 `src/index.js`：数据读写 + HTTP 路由（`ctx.inject(['webServer'])`）/ Host half `src/index.js`: data read/write + HTTP routes via `ctx.inject(['webServer'])`
- Client 端 `src/client/*`：React 面板，external 依赖宿主平台模块表；构建为 CJS 并经 `window.__ModuleLoader__.load` 自注册 / Client half `src/client/*`: React panel; externals resolve from the host platform module table; the bundle is built as CJS and self-registers through `window.__ModuleLoader__.load`

## License

[GPL-2.0](LICENSE)