跳到主内容

dsh-task-board 使用指南

为 DSH Web GUI 增加多列任务看板，侧边栏入口一键切换；任务通过 Host 真实会话执行并回写状态，5 段 cron 定时由 Host 持有或浏览器兜底。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

deepseek-harness-desktop

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @linxin666/dsh-client-ui-task-board

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 可靠 Windows 启动：移除 PowerShell 5.1 -WindowStyle Hidden 与 Electron Node 模式的冲突，隐藏窗口仍由 spawn 的 windowsHide 处理；空旧补丁、状态订阅竞态和 IPC 错误不会再把启动页永久留在 8%。
  • 验证过的 Runtime 组合：内置 @deepseek-ai/dsh 0.1.0-rc.7、dshmarket 1.15.0、Web UI 聚合 0.2.3、兼容 rc.7 的 Codex Connect 与 dsh-live-stats 0.1.20，Stable 继续精确锁定而非追随 latest。
  • 托盘与后台自动化需显式选择：默认关闭仍会退出。选择“最小化到托盘并启用后台自动化”后，关闭主窗口才保留 Runtime 和到期任务；显式退出、更新、安全模式和崩溃路径一律完整停止。
  • Host 持久任务调度：Task Board 保存时区、cron 槽位、租约、misfire/running 策略和确定性运行键；启用后台自动化时通过真实 DSH Session 执行并回写 Task Run，Host 不可用时仍回退浏览器调度。
  • 可审计的扩展边界：扩展坞校验 dsh.compatibility 的版本、Desktop API、能力、Surface 与运行时证据，并在 profile 写入 desktop-plugins.lock.json。browser-safe SDK 不导入 Electron 或私有 DSH 模块；预览的外部打开仅传工作区根和相对路径，Host 验证后才交给系统。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件是干什么的？

在 DSH Web 界面侧边栏新增「任务看板」入口，点击后中间列切换为多列看板（待规划/待办/进行中/已完成/已失败），提供任务创建、执行、状态回写与定时调度。

任务执行会消耗 API 额度吗？

会。每次执行都通过客户端 runtime 创建一个真实的工作区会话并以 session.prompt 驱动 agent，消耗与普通会话相同的 API 配额。

任务数据存在哪里？

权威 v3 台账位于 Host 端 DSH_HOME/profiles//state/task-board/tasks-v3.json；Host 端点不可用时回退到 v2 Host 路径或浏览器 localStorage v1。

定时任务必须一直打开看板吗？

不必须。作为 Desktop 2.7 host-job 适配器且用户明确开启后台自动化时，Host 会以租约、时区 cron 和确定性 TaskRun 认领到期槽位；其余运行时（包括旧的 Web Host、状态格式异常或没有 adapter）由浏览器标签页的 ticker 兜底，需要标签页保持打开。

错过了 cron 触发点会补跑吗？

默认 skip。宿主侧 sleep/restart 错过的触发点全部跳过；显式 run-once 最多合并补跑一个槽位，queue-next 在任务运行中最多保留一个待执行槽位。

卸载后任务数据会丢失吗？

不会。卸载仅移除插件注册行并恢复 GUI 原状，ledger 文件保留在 Host 端 state/task-board 目录下。

安装后还需要做什么？

需要重启 dsh web 进程一次。profile 层（bundle 行、dsh.client 元数据）只在进程启动时读取，单纯的页面刷新不会让入口生效。

Worktree 审核是什么？

Desktop 2.6 任务可选择 shared-workspace 或 Git Worktree；Runtime Provider 提供 workspace/session 观察能力时 Host 创建受控 Worktree，详情展示有界 Evidence 并提供 Commit/Merge/Keep/Discard；缺少能力时明确回退到 shared-workspace。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: >=0.1.0-rc.7 <0.2.0（package.json#dsh.compatibility.runtime），Desktop 2.7.0-2.x（package.json#dsh.compatibility.desktop）
  • Node: 源码未声明 engines；monorepo 约定 ^22.19 || >=24（package.json#devDependencies @types/node ^22.20.0）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则