前言¶
DSH 生态里，插件是扩展能力的主要方式。对智能体开发者来说，一个常见的问题是：需求通常从一句自然语言开始，但落到代码里时，需要细化、拆分、执行、合并，并且要能看见每一步的状态。
dsh-task-kanban 是一个 DSH web 插件，它为 DSH web 主界面新增“任务看板”：把需求细化成多 phase 实现计划，在 git worktree 中串行实现，并在全部 phase 完成后自动合入主分支。
下面介绍它的定位、核心能力、安装方式和典型用法。
这是什么¶
dsh-task-kanban 的 npm 包名是 @fonlan/dsh-task-kanban，由 fonlan 维护，许可证为 MIT。
它的核心价值是把“需求 → 计划 → 执行 → 合并”这条链路放到 DSH web 主界面中管理，并通过泳道展示任务状态。
GitHub 仓库地址：
https://github.com/fonlan/dsh-task-kanban
核心功能¶
看板泳道¶
任务看板把卡片按五条泳道可视化：
需求 / 队列 / 运行中 / 已完成 / 已合并
卡片会显示以下信息：
- 标题
- 需求摘要
- 模型
- 细化 Skill
plan状态徽标- 所属阶段
- 时间
卡片还支持停止、重试、删除。
需求细化为 Phase 计划¶
新建任务后，插件会自动进入细化会话。
在这个会话中，需求会被拆解为串行执行的 phase 计划，也就是 plan。后续执行会围绕这些 phase 推进。
Skill 驱动的需求细化¶
插件支持通过 Skill 驱动需求细化。
在新建任务的需求输入框开头输入 /，会弹出可用 Skill 列表；也可以直接输入 /skill-name 指定细化时使用的 Skill。
示例：
/grill-me 帮我规划…
插件会把该 Skill 的完整指令注入细化会话，并进入交互式细化模式。
如果 Skill 未知或不可用，会给出明确报错，并且可以重试。
队列与串行执行¶
已规划的卡片可以拖入队列，并按 FIFO 顺序领取执行。
执行时的约束如下：
- 每个 phase 使用独立会话。
- 每个 phase 在同一
git worktree中严格串行推进。 - 同一工作区保持单并发。
- 跨工作区可以按设置并行。
自动合并主分支¶
当全部 phase 完成后，插件会执行以下动作：
- 将
plan分支合入main或master。 - 清理
worktree。 - 清理分支。
插件设置¶
设置入口位于：
侧边栏设置 → 插件配置 →「任务看板」
这里可以配置：
- 全局并行 worker 数。
- 细化需求会话的默认模型、推理强度与 Agent 预设。
- Phase 实现会话的默认模型、推理强度与 Agent 预设。
具体含义如下：
- 模型留空表示走默认链路。
- 推理强度仅列出所选模型支持的推理等级。
- Agent 预设在会话开始后固定。
安装与启用¶
通过 npm 发布包安装¶
先确认你要安装到的目录。运行安装命令的目录将作为默认 workspace 根目录。
在目标 workspace 根目录运行：
dsh plugin --profile web add @fonlan/dsh-task-kanban
已核实资料中，README 给出了固定版本安装示例：
dsh plugin --profile web add @fonlan/dsh-task-kanban@0.1.0
但同一批已核实资料中，README 的安装说明与 package.json 的版本说明存在冲突：README 称当前发布版本为 0.1.0，而 package.json 中 version 为 0.2.3。因此本文不将其中的某一个版本号作为当前发布版本结论。
本地源码安装¶
如果从本地仓库安装，需要先构建出 lib/ 产物。
在仓库目录下运行：
pnpm build
dsh plugin --profile web add .
安装后，插件会通过 cordis.patch.yml 挂载到 web profile。通常重启 web profile 后，可以看到“任务看板”入口。
典型用法¶
下面是一个可复现的使用路径。
1. 新建任务¶
在任务看板中新建任务，输入需求。
如果没有指定 Skill，系统会进入普通细化会话。
2. 指定细化 Skill¶
如果希望用特定 Skill 细化需求，在需求输入框开头输入 /，选择 Skill；也可以直接输入：
/skill-name 需求描述
例如：
/grill-me 帮我规划…
插件会注入该 Skill 的完整指令，并进入交互式细化模式。
3. 将已规划卡片放入队列¶
需求细化完成后，将已规划卡片拖入队列。
队列会按 FIFO 顺序领取执行。
4. 查看执行状态¶
执行过程中，可以在看板中观察卡片状态变化：
需求 / 队列 / 运行中 / 已完成 / 已合并
卡片上可以看到模型、细化 Skill、plan 状态徽标、所属阶段与时间，并支持停止、重试、删除。
5. 等待自动合并¶
全部 phase 完成后，插件会自动将 plan 分支合入 main 或 master，并清理 worktree 与分支。
6. 调整会话默认值¶
进入：
侧边栏设置 → 插件配置 →「任务看板」
可以配置全局并行 worker 数，以及两类会话的默认模型、推理强度与 Agent 预设：
- 细化需求会话。
- Phase 实现会话。
适用场景与注意¶
适合谁¶
这个插件比较适合以下场景：
- 使用 DSH web 主界面管理智能体任务。
- 希望把自然语言需求拆成多 phase 计划。
- 希望在
git worktree中串行执行，并在完成后自动合入主分支。 - 希望在看板里跟踪“需求 / 队列 / 运行中 / 已完成 / 已合并”状态。
使用注意¶
使用前需要关注以下几点：
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 插件会自动合入
main或master，执行前应确认分支策略。 - 同一工作区保持单并发；跨工作区并行受设置约束。
- 模型留空表示走默认链路。
- 推理强度仅列出所选模型支持的推理等级。
- Agent 预设在会话开始后固定。
- 未知或不可用的 Skill 会给出明确报错，并且可以重试。
- 修改服务端后需重启 web profile。
- 客户端改动走 web 端 HMR 链路，
pnpm run dev:web同启时生效。
结尾¶
dsh-task-kanban 的价值在于把需求细化、阶段执行、状态跟踪和自动合并放到同一个 DSH web 看板中，减少在多个会话之间手动切换和追踪的开销。
仓库地址：
https://github.com/fonlan/dsh-task-kanban
如需查看插件目录，以对应 DSH 插件目录站点为准；DSH 插件目录属于社区目录站点，不应理解为 DeepSeek 或幻方的官方应用商店。
