为 DSH Web GUI 增加多列任务看板：本地持久化任务，真正驱动 agent 会话执行，可配 5 段 cron 定时执行。
ⓘ 此插件是大仓库 CAPTAIN1275/dsh-ui-web 的子包，星数与活跃度统计的是整个仓库。
- 语言
- TypeScript
- License
- Apache-2.0
- 分支
- main
安装
$ dsh plugin --profile web add github:CAPTAIN1275/dsh-ui-web/packages/dsh-task-board在终端中运行以上命令，通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh？看这篇新手教程
对话式安装
帮我安装 DeepSeek Harness 插件 CAPTAIN1275/dsh-ui-web/packages/dsh-task-board：先查看仓库 https://github.com/CAPTAIN1275/dsh-ui-web.git 确认安全性，然后执行安装命令并验证插件加载成功。
把这段指令粘贴给 DSH Web GUI 里的助手，由它代你完成安装与验证。
一句话定位
dsh-task-board 是 DSH Web GUI 里的多列任务看板插件：把任务以「待规划/待办/进行中/已完成/已失败」五列摆开，点「执行」会真实驱动一个 agent 会话跑任务，并支持用 5 段 cron 表达式给任务设定时运行。
核心能力
- 侧边栏入口注入：在「新会话」按钮下方插入「任务看板」入口行，宽栏显示图标+文字、折叠 rail 显示纯图标，跟随 DSH 皮肤 token 自适应（src/client/sidebar-entry.ts、src/client/index.ts:155）。
- 多列看板视图：待规划/待办/进行中/已完成/已失败五列；卡片显示标题、描述、状态、更新时间、执行次数；顶部支持搜索过滤、「+ 新建任务」、「返回对话」（src/client/board/TaskBoard.tsx、src/client/index.ts:156-159）。
- 任务详情与执行：点卡片打开详情（含 Prompt 与执行记录），详情内可执行/重新执行、删除（带确认）、查看会话（跳到执行 transcript）、手动移回待规划/待办（src/client/board/TaskDetail.tsx）。
- 真实执行链路：复用或新建一个 DSH 工作区会话，把它改名为任务标题，用任务 Prompt 调用会话真实驱动 agent；订阅会话快照轮次结束后按
lastAgentError把卡片落「已完成/已失败」并写入执行记录（src/core/execution.ts:104-258）。 - 定时任务：详情面板提供启用开关 + 5 段 cron 表达式（分 时 日 月 周，支持
*/*/n/a-b/ 逗号列表）+ 常用预设（每天 09:00、每小时、每 10 分钟、每周一 09:00）；启用即计算并持久化「下次运行时间」，到点自动走与手动执行相同的真实执行链路（src/client/board/TaskDetail.tsx:61-66、src/core/scheduler.ts:48-104）。 - 本地持久化与状态回写：任务存浏览器 localStorage（键
dsh.taskBoard.v1），跨刷新/重启 DSH 不丢；遗留的「进行中」任务按会话现状自动对账（reconcile），会话 turn 结束即结算为已完成/已失败（src/core/store.ts:31、src/core/execution.ts:156-199）。
技术实现
- 语言: TypeScript（ESM；React 18 写 UI）
- 关键依赖:
@deepseek-ai/dsh-client-runtime+@deepseek-ai/dsh-client-connection+@deepseek-ai/dsh-client-ui-settings（browser 半区注入 runtime 服务、会话 binding、设置面板）；@deepseek-ai/cordis+@deepseek-ai/dsh-settings+schemastery（host 半区插件声明 + 配置 schema 校验）；react ^18.2.0+react-dom（看板视图渲染） - 架构模式: Cordis 双半区插件 — host 半边
src/index.ts只做一件事：通过systemPrompt.section(name: 'plugin:task-board', order: 200)向所有 agent 公告本插件存在、能力、限制（受announceToAgent与enabled开关控制，关闭即注销该段）；browser 半边src/client/index.ts在 settings scope 就绪后挂载侧边栏入口 + 中间列看板视图（DOM 注入到[data-pane="conversation"]尾部 React 不管的子节点，靠<html data-dsh-taskboard-active>切显隐，对话子树保持挂载有状态）。cordis.patch.yml把插件行插入 web profile 名册，package.json#dsh.client声明platform: "web"并把浏览器半边挂到客户端 runtime 上 - 入口文件:
src/index.ts（host 半边，注入 SystemPrompt section + 注册 settings namespace）、src/client/index.ts（browser 半边，挂侧边栏 + 看板 + 控制器 + 调度器 + 设置卡片）、src/core/execution.ts（真实会话执行）、src/core/scheduler.ts（浏览器端定时心跳）、src/core/store.ts（localStorage 持久化）、src/core/controller.ts（任务台账与视图状态）
适用场景
在 DSH Web GUI 上想把"想跑的任务"从对话里捞出来排队执行的用户：写好任务卡片（标题/描述/Prompt），需要时手动点「执行」让 agent 真跑，也可以给某些任务配 cron 让它自动跑起来并把结果留在卡片详情里。适合有重复性工作流（每天 09:00 整理、每 10 分钟巡检）但又不想离开 DSH Web GUI 的场景。
前置依赖与兼容性
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| DSH 运行时 | >=0.1.0-rc.6 | peerDependencies 锁定 @deepseek-ai/dsh-client-connection / dsh-client-runtime / dsh-client-ui-settings / dsh-settings 为 ^0.1.0-rc.6；dsh.client.inject 同时声明 dsh-client-runtime / dsh-client-connection / dsh-client-ui-settings（package.json:37-43） |
| 客户端运行 profile | web | cordis.patch.yml 把插件行插入 web profile 名册，package.json#dsh.client.platform 也为 web；headless profile 下浏览器半区不加载（cordis.patch.yml:11-13、package.json:24-36） |
| React | ^18.2.0 | browser 半区依赖，看板视图用 React 18 渲染（package.json:42） |
| Node.js | 未声明 | 仓库根 package.json 与本包 package.json 均无 engines 字段；README 仅在构建章节写"前置 Node ≥ 20"，运行时无 Node 版本绑定 |
| 平台 | 跨平台（macOS / Windows / Linux） | 仅依赖浏览器 API（DOM、localStorage、setInterval、visibilitychange）；没有原生绑定 |
| 原生模块 | 无 | 不依赖 node-pty / node:sqlite / koffi 等原生模块；仅 schemastery 一个非 SDK 运行时依赖（package.json:44-46） |
安装方式
dsh plugin --profile web add github:CAPTAIN1275/dsh-ui-web/packages/dsh-task-board
安装后重启 dsh web，侧边栏「新会话」下方出现「任务看板」入口即生效（页面刷新不够，需重启进程）。
配置项
| 配置 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| enabled | boolean | 总开关；设为 false 时整个插件在浏览器半区不挂载（侧边栏入口与看板都不出现），同时关闭 host 半边的 SystemPrompt 公告段 | true |
| announceToAgent | boolean | 是否在每个 agent 的系统提示词里公告本插件；设为 false 时关闭那条 systemPrompt section，但插件功能本身不受影响 | true |
配置在 Web GUI 的「插件设置」面板里改（web-ui.plugin.item 槽位，order=110，命名空间 task-board），写入即生效，不需要重启 DSH。
常见问题
Q: 装上后在 DSH Web GUI 里能看到什么？
A: 侧边栏「新会话」按钮下方多出一行「任务看板」入口（侧栏折叠为 rail 时变成纯图标）。点击入口，中间列整列切换为五列看板（待规划/待办/进行中/已完成/已失败）。卡片可拖到不同列，点开有详情（标题/描述/Prompt/执行记录），详情里可执行/重新执行、删除、查看会话并设置 5 段 cron 定时。
Q: 「执行」是真的驱动 agent 还是只是改卡片状态？
A: 真实驱动。点执行时插件通过客户端 runtime 复用或新建一个 DSH 工作区会话，把会话改名为任务标题，再用 session.prompt 把任务 Prompt 发出去，然后订阅该会话快照，等到这一轮真实结束后按 lastAgentError 字段把卡片落「已完成」或「已失败」并写入执行记录。该会话会出现在会话列表，可点进对话查看真实 transcript。
Q: 任务数据存在哪里？卸载后会不会丢？
A: 存在浏览器 localStorage 的 dsh.taskBoard.v1 键里（与 DSH 客户端自身的快照存储同源，跨刷新与重启 DSH 都持久）。卸载插件不会清数据；如需彻底清除，在浏览器控制台执行 localStorage.removeItem('dsh.taskBoard.v1')。
Q: 定时任务的执行时机是什么？
A: 在浏览器端调度：插件每分钟 tick 一次（页面从后台切回可见时立即补一次 tick），到点的任务走与手动「执行」完全相同的真实执行链路；同一 tick 不会重复触发，到点前先把「下次运行时间」顺延到下一个 cron 匹配点再执行。需要 DSH Web GUI 的浏览器标签页保持打开；标签页关闭期间错过的调度按「错过即跳过」处理，下次打开时只补跑已经顺延过去的到期任务。任务还在「进行中」时即使到点也会跳过本次，等下一个 cron 匹配点。
Q: 5 段 cron 表达式支持哪些写法？有没有预设？
A: 支持 * / */n / a-b / 逗号列表的 5 段表达式（分 时 日 月 周）；未通过校验的 cron 会被识别为非法并丢弃（不会持久化为一个永远不触发的 schedule）。预设四档：每天 09:00（0 9 * * *）、每小时（0 * * * *）、每 10 分钟（*/10 * * * *）、每周一 09:00（0 9 * * 1）。
Q: 任务进行中刷新页面/重启 DSH，会发生什么？
A: 不会丢。任务执行会话由真实 DSH 会话驱动，关闭/刷新后插件加载时会对遗留的「进行中」任务按会话现状对账：会话列表里已找不到→标记「已取消」、会话还在跑→继续等待、会话 turn 已结束→按 lastAgentError 或历史尾部的 turn/end 错误节点判定成功/失败；整个对账过程是幂等的。
Q: 需要重启 DSH 进程才能让插件生效吗？
A: 是。profile 层（bundle 行、dsh.client 元数据）在 dsh web 启动时读取，安装/卸载后重启 dsh web GUI 才生效；只刷新页面不会激活新挂载的插件。设置面板里的 enabled / announceToAgent 改动不需要重启，立即生效。
Q: Agent 会自动知道这个看板的存在吗？
A: 默认会。host 半边通过 systemPrompt.section（name plugin:task-board、order 200）向所有 agent 公告本插件的入口、能力与限制；用户提到「任务看板/看板/定时任务」时模型即知道对应本插件。在 Web 设置里把 announceToAgent 改成 false 即可关闭该公告段，插件功能不受影响。
上手难度
入门 — 装好插件、重启 dsh web，侧边栏多出入口、点开就是五列看板，所有交互都有即时可视反馈；高级定时功能也只需在详情里勾启用 + 选预设 + 保存，无需写 cron 字符串也能用。
已知问题与限制
- 定时调度在浏览器端执行，需要 DSH Web GUI 的浏览器标签页保持打开；标签页关闭期间错过的调度按「错过即跳过」处理，下次打开时只补跑已经顺延过去的到期任务，不会"补"历史漏跑的多次（src/core/scheduler.ts:48-104、README.md:82-84）。
- 任务处于「进行中」时，即使到 cron 匹配点也会跳过本次，等下一个匹配点；同一个任务不会并行执行（src/core/scheduler.ts:79-101）。
- 5 段 cron 表达式必须合法（
isValidCron校验）；非法表达式在持久化阶段会被丢弃（不会留下一个永远不触发的 schedule），UI 上表现为定时开关开启后没有"下次运行"时间（src/core/store.ts:77-91）。 - 插件挂载/卸载需要在 DSH profile 层生效，所以必须重启
dsh webGUI；页面刷新不够（README.md:101-103、cordis.patch.yml:1-12）。 - 执行任务会真实消耗 API 额度（host 半边公告的 TASK_BOARD_GUIDANCE 段已明文写出这一点，src/index.ts:25）；详情里不会展示 token/费用数字，请按需关注 DSH 自身的用量统计。
- 任务数据存浏览器 localStorage（键
dsh.taskBoard.v1），仅在http://127.0.0.1:<dsh web 端口>这个 origin 下跨刷新/重启持久；隐私模式或浏览器禁用 localStorage 时持久化会失效（写失败仅 console.error，不会破坏 in-memory 状态，src/core/store.ts:137-156）。 - DOM 挂载（侧边栏入口 + 看板视图）失败时仅
console.error，不会抛出，避免把 DSH Web shell 拖崩（src/client/index.ts:160-163）。
基于 zhu1090093659/dsh-web-ui（Apache-2.0）开发的 DeepSeek Harness（DSH）Web UI 插件套件。全套 22 个包已发布到 npm（
@captain1275/*）。
DSH Web UI 全家桶为 DeepSeek Harness 的 Web 界面提供一系列插件与皮肤：极光毛玻璃皮肤、任务看板、 SSH 运维、右侧文件/变更面板、Git 图谱、移动端远程控制、DeepSeek 娘看板娘（养成系）、实时令牌统计， 以及皮肤中心。所有插件既可独立安装，也可通过聚合包一次装齐。
极光 Aurora 皮肤效果（沉浸光感 / 深色 / 浅色）
特性
极光（Aurora）皮肤（支持动态背景）
- 毛玻璃输入框：高斯模糊（backdrop-filter 30px）+ 半透明玻璃底 + 细边框 + 内高光
- 自定义背景：URL / 本地图片 / 动图（GIF/WebP）/ 视频（mp4/webm） / 透明度 / 模糊调节，
深浅两套极光渐变；视频背景支持静音开关、本地文件持久化（存
~/.dsh/skin-aurora-media/，刷新不丢） - 仿Claude Code推理等级滑块：点击模型菜单的「推理等级」弹出 Effort 滑块面板——无极拖动、松手吸附、 WebGL 火焰跟随、OFF/MAX 刻度、Low/Medium/High/Ultracode 状态
- 用户消息气泡毛玻璃：与输入框统一的玻璃质感
DeepSeek 看板娘（养成系）
- 图片资源（社区同人资源，codex-pet-DeepSeek-girl）
- 养成系统：亲密度 4 级成长（幼鲸 / 伙伴 / 挚友 / 深海羁绊）、升级庆祝气泡、进度条、 Token 零食经济、使用时长成长（每 30 分钟 +1）
- 待机随机气泡：空闲时随机说话（live2d 风格文案）
- 摸头 / 喂食 / 改名 / 拖动，召唤按钮（live2d 同款贴边滑出）
Skill 人格设定
- 设置「人格设定」：开关启用/禁用常驻人格，编辑技能名、描述与人格正文
- 一键生效：保存后写入用户级技能
~/.dsh/skills/catgirl-rp/SKILL.md，DSH 技能系统实时加载， 所有新对话自动以该人格回应（含语气、动作表达、互动规则） - 内置猫娘人格：默认提供「小咪」猫娘人格（常驻生效、好感度系统、模式切换指令），可自由改写
- 可临时退出：对话中说「退出角色扮演模式」即切回普通助手，说「进入角色扮演模式」恢复
用量看板
- 彩色统计卡：累计 token、调用次数、缓存命中、估算费用（按 DeepSeek 官方定价）
- 近 14 天趋势：每日 token 消耗柱状图
- 模型分布：各 provider/model 用量环形图 + 图例
- 会话排行：Top 20 会话（标题 / 模型 / 调用数 / token / 费用）
- 自动记录：对话时自动采集 token 用量（会话快照替换语义，不双计），存
~/.dsh/usage.json - 侧边栏入口：彩色柱状按钮打开全屏看板
功能插件
| 插件 | 功能 |
|---|---|
| dsh-task-board | 侧边栏任务看板：多列 kanban、真实执行（驱动 agent 会话）、定时执行（cron） |
| dsh-ssh | SSH 运维：主机管理、远程执行、SFTP 传输、隧道、集群并发、Web 终端 |
| dsh-aionui-panel | 右侧「预览 / 文件 / 变更」面板：文件树、多格式预览、git 操作、文件拖拽 |
| dsh-git-graph | 会话头部 git 分支选择器 + 提交图 |
| dsh-live-stats | 实时 token 估算与生成速度 |
| dsh-full-stats | 完整统计行：覆盖官方统计（不省略）+ 运行状态指示 + 自定义状态文本（含替换官方 Deep diving...） |
| dsh-usage-dashboard | 用量看板：彩色统计卡 / 近 14 天趋势 / 模型分布 / 会话排行 / 费用估算 |
| dsh-web-ui-settings | 设置页「Web UI 插件」配置组 + 「人格设定」+「关于」版权页 |
| dsh-web-ui-all | 聚合包：一键安装全部插件 |
皮肤中心
10 套皮肤（ths / xp / blue-fantasy / dragon-heir / minecraft / miku / trading / whale-song / aurora / skin-center），支持皮肤启用互斥管理与一键切换。
其余皮肤（ths / xp / blue-fantasy / dragon-heir / minecraft / miku / trading / whale-song） 为上游 dsh-web-ui 自带皮肤。
安装
方式一：npm（推荐，已发布）
# 在 DSH profile 目录（~/.dsh/profiles/web）安装聚合包
npm install @captain1275/dsh-web-ui-all@0.2.8
然后在 profile 的 package.json 里把 @captain1275/dsh-web-ui-all 加入
dsh.profile.bundles：
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@captain1275/dsh-client-ui-skin-aurora",
"@captain1275/dsh-full-stats",
"@captain1275/dsh-web-ui-all"
]
}
}
}
重启 DSH 即生效。
方式二：从源码（开发）
git clone <your-repo-url> dsh-web-ui
cd dsh-web-ui
pnpm install
pnpm -r build
# 把本地包链接进 profile（junction）
node scripts/link-profile.mjs
开发
- 构建：
pnpm -r build（或pnpm --filter <package> build） - 新增皮肤：参考
packages/skins/aurora（skin.json+src/client+cordis.patch.yml）， 然后用node scripts/skin-center-bundles重新生成注册表 - 聚合包 patch：编辑
packages/dsh-web-ui-all/aggregate.yml后node scripts/aggregate.mjs - 皮肤资产同步：
node packages/dsh-skins/build.mjs
目录结构
packages/
├─ dsh-task-board / dsh-ssh / dsh-aionui-panel / dsh-git-graph
├─ dsh-pet / dsh-live-stats / dsh-full-stats
├─ dsh-web-ui-settings / dsh-web-ui-all / dsh-skins
└─ skins/ # 皮肤源码（aurora、miku、ths 等）
scripts/ # 构建 / 注册表 / 链接工具
shared/ # 共享构建预设（tsdown.client.ts）
版权与许可
- 主体代码：zhu1090093659/dsh-web-ui，Apache-2.0
- 增强优化：@captain1275
- DeepSeek 娘精灵图：xpy12367/codex-pet-DeepSeek-girl， 社区同人资源，版权归原作者
- 人形图标：Font Awesome 6.7.2，CC BY 4.0
- 样式参考：live2d-widget（GPL-3.0，仅参考视觉风格，未搬用代码）
- 商标：DeepSeek 及其相关标识均为 DeepSeek 官方资产；本插件为社区开发者独立维护的非官方同人项目， 不代表 DeepSeek 官方立场。
收录徽章
[](https://deepseek-plugin.org/plugins/CAPTAIN1275/dsh-ui-web/packages/dsh-task-board)把这段 markdown 粘贴到你的 GitHub README，链接回本插件详情页。徽章只声明已被本站收录，不代表安全认证。