dsh-task-board · 个人任务管理
DSH Web GUI 的个人任务管理面板：双月日历、日常清单、每天工作视图与可拖拽的 24 小时时间轴，并支持用自然语言让 AI 提取任务。
功能
- 双月日历：连续两个月网格；每个长期任务按起止日期画成一条彩色时间条，当天的定时任务也会作为单日条画在对应日期上（长期任务优先排布，每周最多显示 5 行，点「还有 N 项」可展开显示全部；日常任务不显示在日历上）。跨周自动分段；双击长期任务线条进入拖动模式（拖线身移动日期、拖两端改长度）；已度过的日期段用浅灰雾面 + 细斜纹 + 白色毛玻璃描边标出；单击任一条线可查看该任务的子任务。
- 日常任务：每天重复的习惯清单，圆角方块勾选框（完成时绿色实心 + 白色对勾）；可增删改。
- 每天工作：按钮切换两种视图。
- 任务列表：周一至周日 7 个竖列，左右翻页切换周；已过去日期背景为
#E5ECFD；只列非日常任务（定时任务与跨天长期任务），每行带完成勾选框；按住任务行可拖到本周其他日期改期（当天定时任务和单日任务可拖，多日长期任务请在日历里拖动调整范围）。 - 具体当天：左侧「当天日常」与「当天任务」两个清单，右侧 24 小时纵向时间轴；方块可拖动移动、拖上下边缘改起止（15 分钟吸附），双击时间轴空白处快速新建；点方块可编辑。
- AI 提取：页面顶部输入一段中文安排（例如「下周一至周五完成季度报告；每天锻炼 30 分钟；今天 14:00-15:30 开例会」），点击提取后调用当前默认模型解析为可编辑的任务草案，确认后写入日历 / 日常清单 / 当天安排。模型不可用、超时或返回格式异常时自动降级为本地规则解析，并给出提示。
- 长期任务按天完成：长期任务出现在任务列表 / 具体当天时，勾选只表示「这一天做了这个任务的相关工作」，只影响当天（记录在
doneDates），不会把整个项目标记为完成；取消勾选也只影响当天。 - 子任务：长期任务和当天定时任务都可以带有序子任务；AI 提取时缩进行会自动归到上一行任务名下。选中日历上的任务可查看其子任务，周视图显示子任务数量；子任务只能在「具体当天」页增删改，顺序固定、不支持拖动重排。
- 持久化：改动自动保存到
/task-board/data.json；写入前做字段校验与原子重命名，读取失败时暂停自动保存以免覆盖原文件。
安装
插件需要 DSH >= 0.2.1-rc.2。任选一种：
# 从 npm 安装（发布后可用）
dsh plugin --profile web add dsh-task-board
# 或直接从 GitHub 安装
dsh plugin --profile web add github:GinoXiang/dsh-task-board
安装后重启 DSH 或刷新 Web GUI，侧边栏会出现「任务」图标，点开即进入任务面板。
数据与权限
- 只读写
/task-board/data.json一个 JSON 文件（默认~/.dsh/task-board/data.json）；卸载插件不会删除该文件。 - AI 提取只在点击「AI 提取」时调用一次当前配置的默认模型，不会后台自动请求；不发送文件内容，只发送输入框里的文本。
- Host 端提供三个本地 HTTP 接口（
/task-board/load、/task-board/save、/task-board/extract），仅接受回环地址与同源请求，只支持 POST，请求体上限 2 MB。 - 无第三方运行时依赖；客户端使用 DSH Web GUI 自带的 React 与主题 token。
开发
index.js Host 半：三个本地接口、JSON 存储、LLM 提取 + 本地降级解析
client.js Client 半：侧边栏图标与整页 UI（plain JS，无需构建）
cordis.patch.yml 插件插入补丁
locale/en.json 插件显示名与描述（英文）
locale/zh.json 插件显示名与描述（中文）
icon.svg 插件图标
修改 client.js 或 index.js 后，在插件管理中禁用再启用该 bundle 即可让客户端半重新加载。
License
MIT
---
dsh-task-board · English
A personal task board for the DSH Web GUI: a two-month calendar, a daily checklist, week and day work views with a draggable 24-hour timeline, and AI extraction of tasks from natural language.
Features
- Two-month calendar — every long-term task is drawn as a colored timeline bar across its date range, and a timed day task is drawn as a single-day bar on its date (long-term tasks pack first, five lanes per week row with an expand button to show every task; recurring daily tasks are not drawn on the calendar). Bars are split per week, double-clicking a long-term bar enters drag mode (move the body, drag either end to resize), and days before today are rendered as a hazy gray band with fine diagonal hatching and a white glass-like outline. Selecting any bar shows that task's subtasks.
- Daily tasks — recurring daily habits in a rounded-square checkbox list (green filled with a white check when done); add, rename and delete.
- Daily work, two views — a seven-column week list (Monday to Sunday, page between weeks, past days tinted
#E5ECFD, completion checkboxes for timed tasks and long-term projects; drag a task row onto another day of the week to reschedule it — timed day tasks and single-day tasks move, multi-day projects keep their range and are dragged on the calendar) and a specific-day view with the day's daily tasks, the day's tasks, and a 24-hour timeline whose blocks move by dragging and resize by dragging their edges (15-minute snapping, double-click empty space to add). - AI extraction — paste a Chinese schedule into the top bar, click extract, review the editable task drafts, then confirm to write them into the calendar, the daily checklist or a day plan. When the default model is unavailable, times out, or returns malformed output, a local rule-based parser takes over with a notice.
- Per-day completion for long-term tasks — when a long-term task appears in the week list or the day view, checking it only means “I worked on this task that day”: it records that single date in
doneDatesand never marks the whole project or its other dates complete, and unchecking only removes that date. - Subtasks — long-term tasks and timed day tasks can carry ordered subtasks; indented lines in an extracted outline become subtasks of the task above them. Selecting a task on the calendar shows its subtasks and the week view shows a subtask count; subtasks are added, renamed, checked and deleted only on the specific-day page, in their stored order (no drag reordering).
- Persistence — autosave to
/task-board/data.jsonwith validation and atomic writes; autosave pauses if the file cannot be read, so a corrupt file is never overwritten.
Install
dsh plugin --profile web add dsh-task-board
# or
dsh plugin --profile web add github:GinoXiang/dsh-task-board
Requires DSH >= 0.2.1-rc.2. Restart DSH or refresh the Web GUI after installing; a "任务" (Tasks) icon appears in the sidebar.
Data and permissions
- Reads and writes only
/task-board/data.json(default~/.dsh/task-board/data.json). - The default model is called once per explicit AI-extract click; nothing is fetched in the background and no file content is sent.
- Three local HTTP endpoints (
/task-board/load,/task-board/save,/task-board/extract) accept loopback, same-origin POST requests only, with a 2 MB body cap. - No third-party runtime dependencies; the client uses the React instance and theme tokens provided by the DSH Web GUI.
License
MIT
吉祥物 / Mascot
> 仅供图一乐，与插件功能无关。/ Just for fun; not related to the plugin itself.
