dsh-ui-taskcards
sidebar tab screenshot
DSH（DeepSeek Harness）Web UI 的纯客户端插件：官方右侧栏原生标签页「待办任务」（sidebarRightTabs 注册类型 + sidebar.right.pane.tab 槽位，与「工作区文件/浏览器/终端」同一套 dock 体验：可拖拽分栏、全屏、宽度拖拽、会话级布局记忆）+ 输入框固定按钮（conversation.composer.dock）。
兼容性：DSH Web 0.1.x ~ 0.2.x（依赖官方 sidebarRightTabs 服务与 sidebar.right.pane.tab 槽位；在 0.2.1-rc.2 上验证）。纯客户端 bundle，无 npm 依赖。
功能
- 采集：当前会话 todos 投影 diff（LCS + 相似度 ≥0.8 模糊对齐）自动转卡（source=agent-todo）；输入框 📌 按钮固定草稿转卡（composer-pinned，不发送不清草稿）；面板快捷输入建卡（panel-input，
! 前缀立即执行，多行粘贴逐行建卡）
- 卡片：编辑（标题/派发指令）、修改（工作区/会话/定时/顺序执行成员，仅 pending 可改目标）、执行（
sessions.prompt mode=queue）；回合观察器回写（手动执行的卡：会话 running→running，回合结束且收件队列空→done 并自动归档；从未观察到 running 时需满 15s 快速回合窗口；目标会话消失 45s 后置 failed）；工作区/会话徽标（会话徽标点击 uiWorkspace.openSession 跳转）；拖拽 + ↑↓ 排序；终态自动归档（历史区可恢复/删除）
- 定时：本地 30s 心跳调度器；设置定时时前置校验目标；到期派发后清除；补触发复用 requestId 幂等；到期目标失效即转 failed（防心跳反复拾起）；单轮心跳最多 3 张
- 顺序执行：每会话一台状态机（idle/dispatching/waiting-running/waiting-interaction/advancing/stopped）；复合轮次结束判定（running=false 且收件队列空，队列不可探测时降级为 3s 连续空闲）；pendingInteraction 暂停 + 10s 恢复计时；批次内同工作区复用新建会话（
seqIsolatedSessions 可切逐卡新建）；连续 3 张 blocked 即停止；顺序执行开关（⛓）默认关闭且不持久化（每次打开页面需手动开启）；由会话 todos 自动捕获的卡片默认不加入顺序执行队列，可在「修改」中显式加入；跨窗口存储同步时会立即停止本窗口在途的顺序执行批次
- 目标解析：会话存活→直接派发+归属自愈；无会话有工作区→
sessions.create({workspaceId}) 新建并回写；否则拦截引导设置工作区
- 幂等：write-ahead lastDispatch + requestId 单飞检查；跨窗口 storage 事件同步
- 入口（方案 B）：右侧栏「+ 新标签页 → 待办任务」添加（引导入口），打开后与文件/浏览器面板同款 dock 行为；面板内创建任务默认绑定该标签页所属会话；旧的 shell.overlay 抽屉已移除
文件
| 文件 | 说明 |
|---|
package.json | dsh.client.inject：locale / ui-conversation / ui-primitives / ui-workspace |
cordis.patch.yml | bundle patch（host 半边 no-op） |
lib/index.js | host stub |
lib/client.js | 浏览器 bundle（ModuleLoader CJS 工厂，单文件 region 分区） |
安装
# 1) 安装包（本地目录或 Git 仓库；GitHub 简写亦可）
dsh plugin --profile web add file:<本插件目录>
# 或：dsh plugin --profile web add git+https://github.com/ydlly224/dsh-ui-taskcards.git
- 在
~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 数组里追加 "dsh-ui-taskcards"（pnpm 已把依赖写入 dependencies，注册 bundle 需手动加一行）；
- 重启一次 dsh web，浏览器刷新后在右侧栏「+ 新标签页 → 待办任务」打开；此后仅改
lib/client.js 会自动 HMR 热重载。
纯客户端插件：无 npm 依赖、不发起网络请求、不写除 localStorage["dsh.taskcards.v1"] 之外的本机持久化。
自检
node --check lib/index.js # 通过
node --check lib/client.js # 通过
已知边界
- 定时触发需页面开启；关闭期间错过的到期卡下次打开补触发一次
- 轮次归因是会话级近似；用户排队消息会推迟顺序执行推进（不卡死不跳队）
- v1 单窗口约束（多窗口写冲突靠 storage 事件尽力同步）
English
A pure client-side plugin for DeepSeek Harness Web UI: registers a native right-sidebar tab (sidebarRightTabs) — a Todo Tasks tab that captures session todos as durable cards with run / schedule / sequential execution and history.
- Repo: https://github.com/ydlly224/dsh-ui-taskcards
- Install:
dsh plugin --profile web add git+https://github.com/ydlly224/dsh-ui-taskcards.git, then register the bundle name in ~/.dsh/profiles/web/package.json → dsh.profile.bundles, restart dsh web and refresh.
- Extends: DSH Web 0.1.x ~ 0.2.x (verified on 0.2.1-rc.2); pure client bundle, zero dependencies.
