Skip to main content

dsh-ui-web/packages/dsh-task-board

34Stars2Forks0Issues0Watchers

Add multi-column task kanban to DSH Web GUI with local task persistence, real agent session execution, and configurable 5-segment cron scheduling.

Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki

ⓘ This plugin is a sub-package of the CAPTAIN1275/dsh-ui-web monorepo — stars and activity count the whole repository.

Language
TypeScript
License
Apache-2.0
Branch
main
dsh-plugindsh-plugin-marketdsh-plugins

Install

cmdweb profile
$ dsh plugin --profile web add @captain1275/dsh-client-ui-task-board

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin CAPTAIN1275/dsh-ui-web/packages/dsh-task-board for me: review the repository at https://github.com/CAPTAIN1275/dsh-ui-web first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Sentence Pitch

dsh-task-board is a multi-column task board plugin for the DSH Web GUI: it displays tasks across five columns (Unplanned/Todo/In Progress/Completed/Failed), clicking "Execute" will genuinely drive an agent session to run the task, and supports setting timed runs using 5-field cron expressions.

Core Capabilities

  • Sidebar entry injection: Inserts a "Task Board" entry row below the "New Session" button, displaying icon + text in wide mode and icon-only in collapsed rail mode, adapting to DSH skin tokens (src/client/sidebar-entry.ts, src/client/index.ts:155).
  • Multi-column board view: Five columns - Unplanned/Todo/In Progress/Completed/Failed; cards display title, description, status, update time, and execution count; top supports search filter, "+ New Task", "Return to Conversation" (src/client/board/TaskBoard.tsx, src/client/index.ts:156-159).
  • Task detail and execution: Click a card to open details (including Prompt and execution records), can execute/re-run, delete (with confirmation), view session (jump to execution transcript), manually move back to Unplanned/Todo (src/client/board/TaskDetail.tsx).
  • Real execution chain: Reuse or create a new DSH workspace session, rename it to the task title, use the task Prompt to genuinely drive the agent via session.prompt; after subscribing to session snapshot turns ending, place the card in "Completed/Failed" based on lastAgentError and write execution records (src/core/execution.ts:104-258).
  • Scheduled tasks: Detail panel provides enable switch + 5-field cron expression (min hour day month weekday, supports * / */n / a-b / comma lists) + common presets (daily 09:00, hourly, every 10 minutes, every Monday 09:00); upon enabling, calculate and persist "next run time", at the scheduled time automatically go through the same real execution chain as manual execution (src/client/board/TaskDetail.tsx:61-66, src/core/scheduler.ts:48-104).
  • Local persistence and state sync: Tasks stored in browser localStorage (key dsh.taskBoard.v1), persist across refresh/DSH restart; legacy "In Progress" tasks automatically reconciled based on session status, session turn ending settles to Completed/Failed (src/core/store.ts:31, src/core/execution.ts:156-199).

Technical Implementation

  • Language: TypeScript (ESM; React 18 for UI)
  • Key Dependencies: @deepseek-ai/dsh-client-runtime + @deepseek-ai/dsh-client-connection + @deepseek-ai/dsh-client-ui-settings (browser half injects runtime services, session binding, settings panel); @deepseek-ai/cordis + @deepseek-ai/dsh-settings + schemastery (host half plugin declaration + config schema validation); react ^18.2.0 + react-dom (board view rendering)
  • Architecture Pattern: Cordis dual-half plugin — host half src/index.ts does one thing: announces this plugin's existence, capabilities, and limitations to all agents via systemPrompt.section(name: 'plugin:task-board', order: 200) (controlled by announceToAgent and enabled switch, disabling注销 that section); browser half src/client/index.ts mounts sidebar entry + middle column board view after settings scope is ready (DOM injected into [data-pane="conversation"] tail React-unmanaged child nodes, toggle visibility via <html data-dsh-task-board-active>, conversation subtree stays mounted with state). cordis.patch.yml inserts plugin line into web profile roster, package.json#dsh.client declares platform: "web" and mounts browser half to client runtime
  • Entry Files: src/index.ts (host half, injects SystemPrompt section + registers settings namespace), src/client/index.ts (browser half, mounts sidebar + board + controller + scheduler + settings card), src/core/execution.ts (real session execution), src/core/scheduler.ts (browser-side scheduled heartbeat), src/core/store.ts (localStorage persistence), src/core/controller.ts (task ledger and view state)

Use Cases

Users who want to queue and execute "tasks to run" extracted from conversations in the DSH Web GUI: create task cards (title/description/Prompt), manually click "Execute" when needed to let the agent actually run, or configure cron for certain tasks to run automatically and leave results in card details. Suitable for repetitive workflows (daily 09:00 consolidation, every 10 minutes inspection) without leaving the DSH Web GUI.

Prerequisites & Compatibility

DependencyMin VersionDescription
DSH Runtime>=0.1.0-rc.6peerDependencies locks @deepseek-ai/dsh-client-connection / dsh-client-runtime / dsh-client-ui-settings / dsh-settings to ^0.1.0-rc.6; dsh.client.inject also declares dsh-client-runtime / dsh-client-connection / dsh-client-ui-settings (package.json:37-43)
Client Run Profilewebcordis.patch.yml inserts plugin line into web profile roster, package.json#dsh.client.platform is also web; browser half doesn't load under headless profile (cordis.patch.yml:11-13, package.json:24-36)
React^18.2.0Browser half dependency, board view renders with React 18 (package.json:42)
Node.jsNot declaredNeither root package.json nor this package's package.json has engines field; README only states "Prerequisite Node ≥ 20" in build section, no Node version binding at runtime
PlatformCross-platform (macOS / Windows / Linux)Only depends on browser APIs (DOM, localStorage, setInterval, visibilitychange); no native bindings
Native ModulesNoneDoes not depend on node-pty / node:sqlite / koffi etc.; only schemastery is a non-SDK runtime dependency (package.json:44-46)

Installation

dsh plugin --profile web add github:CAPTAIN1275/dsh-ui-web/packages/dsh-task-board

After installation, restart dsh web, the "Task Board" entry appears below "New Session" in the sidebar (page refresh is not enough, process restart required).

Configuration Options

ConfigTypeDescriptionDefault
enabledbooleanMaster switch; when set to false, the entire plugin doesn't mount in browser half (no sidebar entry or board), also disables host half's SystemPrompt announcement sectiontrue
announceToAgentbooleanWhether to announce this plugin in each agent's system prompt; setting to false disables that systemPrompt section, but plugin functionality itself is unaffectedtrue

Configuration is modified in Web GUI's "Plugin Settings" panel (web-ui.plugin.item slot, order=110, namespace task-board), changes take effect immediately, no DSH restart needed.

FAQ

Q: What can I see in DSH Web GUI after installing?

A: An additional "Task Board" entry appears below the "New Session" button in the sidebar (becomes icon-only when sidebar is collapsed to rail). Clicking the entry switches the entire middle column to a five-column board (Unplanned/Todo/In Progress/Completed/Failed). Cards can be dragged to different columns, clicking opens details (title/description/Prompt/execution records), details allow execute/re-run, delete, view session, and set 5-field cron schedule.

Q: Does "Execute" really drive an agent or just change card status?

A: It really drives. When clicking execute, the plugin reuses or creates a new DSH workspace session via client runtime, renames the session to the task title, then sends the task Prompt via session.prompt, subscribes to that session's snapshots, and after the turn ends, places the card in "Completed" or "Failed" based on the lastAgentError field and writes execution records. The session appears in the session list, you can click to view the actual transcript.

Q: Where is task data stored? Will it be lost after uninstall?

A: Stored in browser localStorage under key dsh.taskBoard.v1 (same origin as DSH client snapshot storage, persists across refresh and DSH restarts). Uninstalling the plugin doesn't clear data; to completely clear, execute localStorage.removeItem('dsh.taskBoard.v1') in browser console.

Q: When do scheduled tasks execute?

A: Scheduled on the browser side: the plugin ticks once per minute (plus an immediate tick when page transitions from background to visible), tasks at their time go through the exact same real execution chain as manual "Execute"; the same tick won't trigger duplicates, before execution it shifts "next run time" to the next cron match point. Requires DSH Web GUI browser tab to stay open; missed schedules during tab closure are "skip if missed", when reopened it only catches up tasks that have already been shifted to overdue (not historical multiple missed runs). Tasks still "In Progress" skip the current scheduled run even if it matches, waiting for the next cron match point.

Q: What cron expression formats are supported? Are there presets?

A: Supports 5-field expressions with * / */n / a-b / comma lists (min hour day month weekday); invalid cron that fails validation is recognized as illegal and discarded (won't persist as a schedule that never triggers). Four presets: daily 09:00 (0 9 * * *), hourly (0 * * * *), every 10 minutes (*/10 * * * *), every Monday 09:00 (0 9 * * 1).

Q: What happens if I refresh page/DSH while a task is in progress?

A: Nothing is lost. Task execution is driven by a real DSH session, after close/refresh when the plugin loads, it reconciles legacy "In Progress" tasks based on session status: session no longer in list → marked "Cancelled", session still running → continues waiting, session turn ended → determines success/failure based on lastAgentError or historical tail's turn/end error node; the entire reconciliation process is idempotent.

Q: Does the plugin require DSH process restart to take effect?

A: Yes. Profile layer (bundle line, dsh.client metadata) is read when dsh web starts, installation/uninstall requires restarting dsh web GUI to take effect; page refresh alone won't activate newly mounted plugins. Changes to enabled / announceToAgent in settings panel don't require restart, take effect immediately.

Q: Will agents automatically know about this board?

A: Yes, by default. Host half announces this plugin's entry, capabilities, and limitations to all agents via systemPrompt.section (name plugin:task-board, order 200); when users mention "task board/board/scheduled task", the model knows it refers to this plugin. You can disable this announcement in Web settings by changing announceToAgent to false, plugin functionality is unaffected.

Learning Curve

Beginner — Install the plugin, restart dsh web, the sidebar shows an entry, click to open the five-column board, all interactions have immediate visual feedback; advanced scheduling features only require checking enable in details + selecting a preset + save, no need to write cron strings.

Known Issues & Limitations

  • Scheduled execution runs on the browser side, requires DSH Web GUI browser tab to stay open; missed schedules during tab closure are "skip if missed", when reopened it only catches up tasks that have already been shifted to overdue, won't "make up" historical multiple missed runs (src/core/scheduler.ts:48-104, README.md:82-84).
  • When a task is "In Progress", even at a cron match point it skips this run and waits for the next match point; the same task won't run in parallel (src/core/scheduler.ts:79-101).
  • 5-field cron expressions must be valid (isValidCron validation); illegal expressions are discarded at persistence stage (won't leave a schedule that never triggers), UI shows no "next run" time after enabling the schedule switch (src/core/store.ts:77-91).
  • Plugin mount/unmount takes effect at DSH profile layer, so must restart dsh web GUI; page refresh is not enough (README.md:101-103, cordis.patch.yml:1-12).
  • Executing tasks genuinely consumes API quota (the TASK_BOARD_GUIDANCE section announced by host half explicitly states this, src/index.ts:25); token/cost numbers are not displayed in details, please monitor DSH's own usage statistics as needed.
  • Task data stored in browser localStorage (key dsh.taskBoard.v1), persists across refresh/restart only under origin http://127.0.0.1:<dsh web port>; persistence fails in privacy mode or when browser disables localStorage (write failure only console.error, won't break in-memory state, src/core/store.ts:137-156).
  • When DOM mount (sidebar entry + board view) fails, only console.error, no exception thrown, to avoid dragging down DSH Web shell (src/client/index.ts:160-163).

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/CAPTAIN1275/dsh-ui-web/packages/dsh-task-board)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory