team-kanban · 团队项目看板（DSH Java Native 插件场景案例 P8）

基于 deepseek-harness-java（DSH）Java Native 插件机制 的团队项目看板场景案例：三列看板 + 迭代进度/故事点统计 + 成员负载 + 延期风险预警，并通过 kanban-copilot 插件接入 AI 助手，支持自然语言看板总览、拖卡、建卡、进度汇总、风险巡检与周报生成。

一、项目组成

模块	说明
kanban-app	Spring Boot 3.2 应用（端口 18087），提供看板 REST API 与前端页面
kanban-plugin	DSH Java Native 插件（kanban-copilot），打包 5 个 AI 工具

业务背景：虚拟团队「支付中台」迭代 Sprint 24-9（2026-09-14 ~ 09-27），5 名成员（陈晓/林悦/王砚/赵铭/苏芮），12+ 张卡片覆盖聚合支付、退款链路、收银台、对账结算等任务，含逾期/临期等真实风险场景。

二、插件工具（5 个）

工具	说明
board_overview	看板总览：迭代信息、三列卡片分布、进行中/待办明细
card_move	拖拽卡片：按卡片 ID 移动到 todo/doing/done
card_create	新建卡片：标题、负责人、优先级、截止日、故事点、标签
sprint_progress	进度汇总：三列计数、故事点完成率、成员负载
risk_check	风险巡检：按 OVERDUE/HIGH/MEDIUM 分级，含建议动作

三、REST API

方法	路径	说明
GET	/api/board	看板全量（迭代 + 成员 + 卡片）
POST	/api/card/move	移动卡片 {cardId, status}
POST	/api/card	新建卡片
GET	/api/progress	进度/故事点/成员负载
GET	/api/risks	延期风险清单
POST	/api/assistant/stream	AI 助手 SSE（透传 DSH）

四、快速开始

# 1. 构建
mvn clean package -DskipTests

# 2. 启动应用（默认 18087）
java -Dserver.port=18087 -jar kanban-app/target/kanban-app-1.0.0-SNAPSHOT.jar

# 3. 安装插件到本地 DSH（假设 DSH 运行在 127.0.0.1:8090）
bash install_plugin.sh kanban-plugin/target/kanban-plugin-1.0.0-SNAPSHOT.jar \
  kanban-copilot 1.0.0-SNAPSHOT kanban-plugin-1.0.0-SNAPSHOT.jar "团队项目助手"

# 4. 打开页面
open http://127.0.0.1:18087/

浏览器访问 http://127.0.0.1:18087/ 即可看到看板并在右侧与 AI 助手对话。

五、端到端验证

通过 DSH Agent 流式接口验证 5 个工具（agentId = kanban-copilot）：

bash agent_stream.sh 127.0.0.1:8090 kanban-copilot "看一下当前看板的整体情况，有哪些卡片在进行中？"
bash agent_stream.sh 127.0.0.1:8090 kanban-copilot "汇总迭代进度和故事点完成率，看看有哪些延期风险"
bash agent_stream.sh 127.0.0.1:8090 kanban-copilot "把 c05 移动到已完成，再建一张卡：压测报告输出，赵铭，P1，2026-09-30"
bash agent_stream.sh 127.0.0.1:8090 kanban-copilot "生成一份本周周报"

验证截图（全部真实运行截取）：

截图	内容
	AI 汇总迭代进度与风险
	AI 生成周报（进展/风险/计划）
	点击卡片拖拽到下一列，进度实时刷新

六、技术要点

• 插件规范：入口类继承 AbstractHarnessPlugin，SPI 注册 META-INF/services/cn.xiaofuge.deepseek.harness.domain.spi.JavaHarnessPlugin，描述文件必须位于 META-INF/plugin.yaml（不是 resources 根目录，否则激活报 META-INF/plugin.yaml not found）。
• 依赖作用域：cn.xiaofuge:deepseek-harness-java-types:0.1.5 用 provided，宿主运行时提供，避免 fat jar 类冲突。
• -parameters 编译参数：父 pom 配置 <maven.compiler.parameters>true</maven.compiler.parameters>，否则 @RequestParam 参数名解析失败导致 500。
• SSE 透传：前端 → 应用 /api/assistant/stream → DSH /api/agent/stream（用 agentId），前端同时兼容 event:chunk + data:{"content"} 与 data:{"type":"text","delta"} 两种事件格式。

七、目录结构

team-kanban/
├── pom.xml                    # 父 pom（maven.compiler.parameters=true）
├── kanban-app/                # Spring Boot 应用 (18087)
│   └── src/main/java/cn/xiaofuge/kanban/app/
│       ├── KanbanApplication.java
│       ├── KanbanStore.java       # 内存数据层：迭代/成员/卡片/进度/风险
│       ├── KanbanController.java  # 看板 REST API
│       └── AssistantController.java # SSE 透传 DSH
├── kanban-plugin/             # DSH 插件 (kanban-copilot)
│   └── src/main/
│       ├── java/cn/xiaofuge/kanban/plugin/KanbanPlugin.java  # 5 工具
│       └── resources/
│           ├── META-INF/plugin.yaml
│           └── META-INF/services/...
└── docs/
    ├── 使用说明.md
    └── screenshots/           # 验证截图 ×4