dsh-codex-task-board
DeepSeek Harness 的跨项目任务看板：每个 DSH 会话都会在待处理 / 处理中 / 待审阅之间显示为任务卡片，并支持优先级颜色、稳定排序和单页自适应布局。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:cpsGGG/dsh-codex-task-board#ca65d176699b67ff48571eccbcb9473c28dc0da5
Codex Task Board 以 dsh-codex-task-board 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A cross-project task board for DeepSeek Harness — every DSH session becomes a task card, grouped into three columns: 待处理 / 处理中 / 待审阅 (To do / In progress / Needs review).
English | 中文
The screenshot above is rendered from the real bundle against fictional demo data (
npm run preview). Nothing in this repo contains a maintainer's workspace names, paths or session titles.
The board is a first-class DSH destination, not an overlay: it registers into the shell's own global-panel seats (sidebar.panellist + main), the same mechanism DSH's built-in Schedules page uses. Selecting it swaps the centre column; returning to the Conversation does not change the current session.
running, completed (finished but not yet opened), and unanswered interactions.turn/start → turn/end events.dsh plugin --profile <your-profile> add dsh-codex-task-board
Then restart DSH and open 任务面板 at the bottom of the sidebar.
git clone https://github.com/cpsGGG/dsh-codex-task-board.git
dsh plugin --profile <your-profile> add ./dsh-codex-task-board
lib/client.js is committed, so no build step is required. If you change src/, run npm run build.
Windows note: pnpm installs
file:dependencies as a copy, not a symlink. If you are developing against a local checkout, point the profile'snode_modules/dsh-codex-task-boardat your working tree with a directory junction instead, or re-run the install after every build.
| DSH | 0.2.0-rc.2 (developed and verified against it) |
| Profile | any web-platform profile |
| Node | ≥ 20 (build and tests only — the shipped bundle needs none) |
DSH is in developer preview and its internal slot surface can change between releases. The plugin reads useSessions from the global standard props and registers into sidebar.panellist + main; if a future release renames either, the board fails loudly with a visible stack rather than silently disappearing.
DSH has no DOM to patch — it has slots. So this is a native plugin rather than an injection:
| Concern | Approach |
|---|---|
| Sidebar entry | sidebar.panellist list slot (id: task-board) |
| Panel body | main keyed slot, dispatched by that same id |
| Navigation | ctx.layout.selectPanel(id) / selectPanel(null) |
| Session data | the useSessions global standard prop |
| Turn duration | ctx.sessions.binding(id).eventSource folded over turn/start / turn/end |
| Pause / resume | ISession.cancel() / ISession.prompt() |
| Persistence | localStorage, key codex-task-board:session-state:v3 |
src/core.mjs is deliberately framework-free — no DOM, no React, no Cordis — so every rule (status precedence, ordering, layout arithmetic, colour balancing) is unit-testable in plain Node.
| Path | |
|---|---|
src/core.mjs | Pure logic: palette, status, ordering, adaptive layout, store normalisation |
src/client.mjs | Panel UI + slot registration |
src/panel.css | Stylesheet |
lib/client.js | Built bundle (committed) |
tests/core.test.mjs | 34 logic tests |
tests/panel.test.mjs | 16 render tests that execute the real built bundle |
tools/build.mjs | Build |
tools/make-preview.mjs | Generates preview/board.html from demo data |
tools/*asar*.mjs, tools/*slots*.mjs | Introspection helpers for a DSH app.asar |
npm run build # src/*.mjs + panel.css -> lib/client.js
npm test # 50 tests
npm run preview # regenerate preview/board.html
The client half is not an ES module. DSH's client module system loads a classic script that calls window.__ModuleLoader__.load({ id, factory }) and resolves externals through an injected require. tools/build.mjs inlines the two local modules, rewrites the react import into that require, and wraps the result — no bundler, because the graph is two files.
The render tests are worth knowing about: they load lib/client.js, drive the same apply() the shell drives, and expand the returned element tree with a stub React. That catches the class of failure a live check hides behind DSH's slot error boundary, which renders an opaque empty div.
A screenshot of a real board leaks whatever the maintainer had open. tools/make-preview.mjs renders the same component against a fixed cast of fictional sessions, so the artifact is reproducible and safe to publish.
This is a port of a private Codex panel (codex-task-board-mod@0.5.8) that injected DOM into the Codex desktop app. Two behaviours had to change because DSH's session model differs:
"Resume" sends a real message. The original sent thread/resume plus an empty turn/start — "continue without appending a user message". DSH has no such verb: prompt rejects content with no non-whitespace text (the gateway's hasPromptContent guard), and there is no session-level resume. This port therefore sends a minimal real instruction (继续). The card leaves the paused state and starts running exactly as before; the difference is that the message is visible in the transcript.
Blank sessions stay off the board. DSH reuses one empty "New session" draft per workspace, so it is excluded — the same reason the original skipped thread.ephemeral threads.
Everything else — the three columns and their copy, card anatomy, the 16-colour palette and its least-used balancing, the status precedence, the stable ordering, the adaptive layout arithmetic, the interactions and the store schema — is reproduced from the original.
Issues and PRs welcome. Please run npm test before opening a PR; if you touch the panel UI, also run npm run preview and check both themes.
MIT.
This project is not affiliated with DeepSeek AI or OpenAI. "DeepSeek Harness" and "Codex" are the property of their respective owners.
一个 跨项目任务面板：把每条 DSH 会话变成一张任务卡片，按 待处理 / 处理中 / 待审阅 三栏集中查看与打开。
面板是 DSH 的原生目的地，不是浮层——它注册进外壳自己的全局面板槽位（sidebar.panellist + main），和 DSH 内置的「自动化任务」页用的是同一套机制。点它切换中央面板，返回会话不改变当前会话。
turn/start → turn/end 事件折算。dsh plugin --profile <你的 profile> add dsh-codex-task-board
然后重启 DSH，点侧边栏底部的 任务面板。
lib/client.js 已随仓库提交，无需构建。改动 src/ 后运行 npm run build。
Windows 提示：pnpm 对
file:依赖是复制而非软链。若你在本地 checkout 上开发，建议把 profile 的node_modules/dsh-codex-task-board用目录联接指向工作目录，否则每次构建后都要重装。
「启动」发送真实消息。原版发 thread/resume + 空的 turn/start（"不追加用户消息地继续"）。DSH 没有这个动词：prompt 拒绝没有非空白文本的内容，也没有会话级 resume。因此这里发送一条最小真实指令（继续）——卡片同样离开暂停态并开始运行，区别只是该消息在对话记录里可见。
空会话不入面板。DSH 每个工作区复用一个空的「新会话」草稿，故排除；原版对应的是跳过 thread.ephemeral。
其余部分（三栏与文案、卡片结构、16 色色板与"最少使用"平衡、状态判定优先级、稳定排序、自适应布局算法、交互、存储结构）均照原版复刻。
npm run build # src/*.mjs + panel.css -> lib/client.js
npm test # 50 个测试
npm run preview # 重新生成 preview/board.html
客户端半边不是 ES module：DSH 的客户端模块系统加载的是调用 window.__ModuleLoader__.load({ id, factory }) 的经典脚本，外部依赖通过注入的 require 解析。tools/build.mjs 内联两个本地模块、把 react 改写成该 require，再包上外壳——没有引入打包器，因为依赖图只有两个文件。
渲染测试值得一提：它加载 lib/client.js，走与外壳相同的 apply()，用桩 React 展开元素树。这能抓住一类被 DSH 槽位错误边界（只渲染一个空的 data-slot-error）掩盖的崩溃。
MIT。本项目与 DeepSeek AI、OpenAI 均无隶属关系。