前言¶
在 DeepSeek Harness（DSH）里写代码、跑智能体时，任务往往落在 Backlog.md 的 Markdown 与 CLI 上；若只在终端或浏览器里切窗口，Composer 和右侧会话很难和任务视图保持在同一套界面里。社区插件 dsh-plugin-backlog-md（维护者 jeremytenjo，分类：工作流）把 Backlog.md 接到 Harness 原生侧栏：Source Control 旁多一个 Backlog 入口，任务表在右侧原生面板里渲染，并由插件按需拉起官方本地服务。Backlog.md 仍是唯一数据源，插件不另建任务库、也不自行写任务 Markdown。
这是什么¶
一句话：Native Backlog.md task management for DeepSeek Harness——在 Harness 内完成 Backlog.md 任务的查看与编辑，同时兼容 CLI、MCP 或其它编辑器对同一项目的改动。
核心功能¶
下面按 README 已说明的能力归纳，均可与 GitHub 仓库说明 对照。
界面与集成
- 在 Composer 的 Source Control 旁注册
ListTodo启动器（与 Source Control 同尺寸、悬停与面板折叠行为一致），高亮表示 Backlog 面板处于活动态。 - 任务视图注册为 Harness 右侧边栏标签页，沿用原生缩放、折叠、全屏、焦点与会话级持久化；聊天与 Agent 会话保持挂载（
keepMounted: true）。
服务与数据
- 零手工起服：检测工作区 Backlog.md 项目、定位 CLI、分配 loopback 端口，在需要时启动
backlog browser、等待健康检查后连接；用户不必手动执行backlog browser。 - 每个规范工作区至多一个由插件托管的服务器，多 Harness 会话可共享；插件未启动的服务不会被终止。
- 读写仅走 Backlog.md 官方 HTTP API；Host 订阅 WebSocket 通知并转发变更范围，面板通过 TanStack Query 失效缓存，不重复挂文件系统 watcher。
任务操作与展示
- 宽表与紧凑列表共用一套 TanStack Table；用 CSS 容器查询按面板内容宽度切换（640px breakpoint），筛选、排序、选中、展开与详情导航在切换后保留。
- 支持创建、编辑、状态/优先级、负责人、标签、里程碑、依赖、验收标准、Definition of Done、子任务、归档与永久删除等完整工作流。
- 冲突感知编辑：后台刷新不丢未保存内容；保存前检测外部变更，提供 Reload latest / Merge my edits，不做静默覆盖。
- Send to Chat：把可编辑提示放进当前 Composer，不会自动发送消息。
- CLI、MCP、Codex 或其它编辑器改动的任务，经同一 WebSocket 通道反映到面板，Agent 侧无需再装插件集成。
环境与依赖¶
| 组件 | 要求 |
|---|---|
| DeepSeek Harness | 已在 0.2.1-rc.3 测试；插件使用 Cordis 的 lifecycle、slots、locale、sidebarRightTabs、sidebarRight、webServer、subprocess、sessions、workingDirectory 等公开服务 |
| Backlog.md | 测试版本 1.55.3，1.54.0 亦在 UI 中验证；支持范围 >=1.30.0 <2.0.0 |
| Node | Host 端 22 及以上；插件发行包无运行时 npm 依赖 |
| OS | Backlog.md 原生 CLI 可运行的 macOS、Linux、Windows |
Backlog.md 须安装在工作区（node_modules/.bin/backlog）或位于 PATH，工作区本地安装优先。项目须已 backlog init；未初始化时面板会给出具体命令提示。
安装与启用¶
插件以当前 dsh 进程权限运行；安装前请自行审阅源码与 MIT 许可证。
桌面应用（推荐）¶
- 打开 Settings → Plugins。
- 选择 Add plugin，填写本地目录路径或 GitHub 仓库地址。
- 启用插件后 reload 页面或重启 Host。
Electron 桌面配置由应用管理，Settings 流程为官方推荐路径。
CLI¶
为服务当前 Harness 实例的 profile 添加插件（例如 web）。发行包已包含构建好的 client.js，无需本地 build：
dsh plugin --profile <profile> add github:jeremytenjo/dsh-plugin-backlog-md
README 亦说明可先取得仓库目录再 add 本地路径；与上述 GitHub 方式二选一即可。
首次运行前：Backlog.md¶
- 在工作区或全局安装 CLI：
npm install --save-dev backlog.md
# 或: pnpm add -D backlog.md
# 或: npm install -g backlog.md
- 若尚未初始化项目：
backlog init
# 或非交互默认:
backlog init --defaults
- 在该工作区打开 Harness 会话，点击 Source Control 旁的 Backlog。面板会自行起服，无需再跑
backlog browser。
典型用法¶
启动器与面板¶
Backlog 按钮挂在 conversation.input.right 槽位 order 11，紧挨 Source Control（order 10）。点击打开右侧 backlog-md 标签；Backlog 已激活时再次点击遵循 Harness 原生面板开关。
筛选与排序¶
状态条显示各状态数量并可作状态筛选；搜索进一步收窄。Filters 内可组合 Exclude status、Priority、Milestone、Label、Assignee。标题区显示筛选后数量，Clear filters 重置。筛选、排序、列可见性与分页大小按工作区写入 localStorage（不存任务数据）。
默认注意力顺序：In Progress → To Do → Done，同状态内按 Backlog.md ordinal 与自然 ID 排序；点击列头可覆盖当前工作区默认排序。
宽表与紧凑列表¶
宽表列包括 ID、Title（含子任务进度）、Status、Priority、Ordinal、Labels、Assignee、Milestone、Created 与行操作；支持粘性表头、排序、行选（可将选中任务送到 Composer）、子任务展开与列可见性配置。面板内容宽度低于 640px 时切换为紧凑列表，无需横向滚动。
任务详情与保存¶
点行进入同面板内详情：可编辑标题与正文相关字段，只读展示评论；页脚显示未保存状态并提供 Save/Cancel。外部变更与本地编辑冲突时，按 README 说明选择重载或合并，避免覆盖他人或 CLI 的更新。
适用场景与注意¶
适合已在仓库中使用 Backlog.md、又希望在 DSH 里与 Composer、Agent 同屏管任务的工作流。若工作区没有 Backlog 项目或未安装 CLI，面板会引导初始化，而不是静默失败。
DSH 生态强调「一切皆插件」；SkillHub 目录页 为社区收录，与 DeepSeek / 幻方无官方从属关系。插件当前 package 版本为 0.1.0，GitHub 星标以仓库页为准。
结尾¶
dsh-plugin-backlog-md 把 Backlog.md 的任务表、详情编辑与官方 API/WebSocket 同步收进 Harness 原生右栏，并自动管理 backlog browser，让任务源与智能体会话留在同一界面。进一步了解可访问 目录页 与 GitHub 仓库。
