dsh-plugin-orchd

Read-only orchd panel for the DeepSeek Harness (DSH) right sidebar: open a project session and see that project's task board, dependency graph, ideas and review timeline next to the conversation. No project configuration — the plugin derives the project from the session.

把 orchd 的项目状态带进 DSH 右侧栏的只读面板：

点开一个项目会话，面板自动检测这个项目有没有用 orchd。 装了 → 同屏显示任务看板、依赖图、想法与审查时间线；没装 → 给一个接入入口。

面板没有任何写操作：claim / done / review / merge / amend 一律不出现在 UI 里。

---

面板内容

视图	内容
四态检测	未安装 / 未初始化 / 就绪 / 异常，每种状态各自点名原因，不是一句「出错了」
看板	状态分布、待办 / 在途 / 终态，状态条即筛选器；关键词、筛选、排序；800+ 任务虚拟滚动
任务详情	目标、验收标准、验证命令、写范围、上游依赖与下游引用（可点跳转）、审查事件时间线
依赖图	DAG：聚焦闭包 / 活跃子图 / 含终态全图；环、自依赖与悬空上游显式标注，不静默少画
想法（IDEAS）	只读想法看板：状态分组、归档任务对照、可复制的推进命令
接入入口	未安装的项目给两条路：复制命令自己跑，或让当前会话的 agent 去装（注入前先给你看文本）

安装

# 推荐：npm 包
dsh plugin --profile web add dsh-plugin-orchd

# DSH Desktop：用应用自带的终端（欢迎页里那个），**不要**加 --profile
dsh plugin add dsh-plugin-orchd

没有 npm 也能从源码装（被市场收录前的等价路径）：

dsh plugin --profile web add github:7bder/dsh-plugin-orchd

Desktop 的 desktop profile 由应用托管：普通 dsh plugin --profile desktop ... 会被 CLI 直接拒（ profile "desktop" is managed exclusively by the Electron application），应用自带终端里不带 --profile 的命令才改得到它。装好后重启 DSH——宿主侧模块不热替换：会话 header 角落出现开关，右侧栏出现「orchd 任务」页。

被插件市场收录后可以在设置里搜索一键安装。Release 页另有 tarball 资产，但那条路依赖 github.com/release-assets（在部分网络不稳），且 pnpm 11 对「URL tarball」的 lockfile 完整性要求更严 （可能报 ERR_PNPM_MISSING_TARBALL_INTEGRITY），所以只作归档与手动备用。

前置条件

• DSH 提供右侧栏面板席位（sidebarRightTabs + sidebar.right.pane.tab，session 作用域）。
• 项目侧装了 orchd（项目根或容器主工作树下有 .orchd/）。没装的话面板会给出接入入口，不会静默失败。
• Python 3 在 PATH 上（python / py -3 / python3 依次探测，也可在配置里写死 pythonPath）—— 面板跑的是项目自带的引擎入口 python <项目>/.orchd/__main__.py，插件不自带、不安装引擎。

只读保证

这是硬约束，不是口号：

• 命令白名单 fail-closed：不在白名单里的子进程调用根本不 spawn，被拒时记一行结构化日志。
• 子进程环境剥掉会话身份，读命令不会带出任何会被引擎当成「有人在动这个任务」的变量。
• 不直读账本、不碰锁、不写项目文件；面板不做文件导出（诊断信息只复制到剪贴板）。
• 开发期在真引擎、真账本、真 git 仓库上跑只读冒烟：比对工作区文件哈希、账本事件数、git status，要求零变更。

配置

配置写进 profile 的 cordis.patch.yml（- id: orchd-tasks 那一行的 config: 下），全部有默认值：

键	默认	说明
pythonPath	null	null = 自动探测
requestTimeoutMs	20000	单次引擎调用超时（超时与「引擎报错」在 UI 上是两种状态）
cacheTtlMs / pollTtlMs / detectTtlMs	5000 / 30000 / 10000	看板 / 轮询 / 四态检测的缓存 TTL
maxProjectContexts	8	每会话项目上下文的 LRU 上限
orchdCoreRepo	null	接入入口里展示的引擎仓库地址
allowRoots	[]	调试用白名单；空 = 不额外收敛

HTTP API

面板的数据全部来自插件自己注册的 8 条同源路由（会话绑定，前端只传 sessionId，不传路径）：

GET  /orchd/api/context         四态 + 项目身份 + 诊断
GET  /orchd/api/board           状态条 + 任务列表
GET  /orchd/api/task            单任务详情（+ 审查时间线，按需）
GET  /orchd/api/graph           依赖图（节点 / 边 / 环 / 悬空）
GET  /orchd/api/history         审查事件时间线
GET  /orchd/api/ideas           想法看板
POST /orchd/api/install-entry   返回将要注入的文本（本身不注入）
POST /orchd/api/install-inject  执行注入（需显式确认）

前缀外的路径一律 404（fail-closed）。

卸载

dsh plugin --profile web remove dsh-plugin-orchd

已知残留：remove 之后 profile 的 node_modules/ 里可能留一个空目录（包管理器行为），手工删掉即可， 不影响启动。

边界

面板只跟当前会话的项目，不做跨项目聚合、不做项目切换器（DSH 的 Workspace 分组已经是项目导航）； 不做实时推送（引擎没有常驻进程，用缓存 + 手动刷新）；不注册面向模型的工具。

许可

MIT。引擎本体见 7bder/orchd-core。