DeepSeek Harness 专注于会话和聊天交互，擅长思考，但在长期维护操作真相方面较弱。dsh-codex-kanban 插件为 Harness 提供了一个持久化的可视化看板。它不构建独立的聊天界面，而是通过原生工具让 Harness 聊天读取和更新卡片，同时集成 Codex 作为官方子代理。
插件概况¶
- 名称：dsh-codex-kanban
- 作者：sonozaki7
- 类别：工作流
- 许可证：MIT
该插件将卡片存储在本地 JSON 文件中，而非浏览器存储。它集成了 Codex 官方子代理，提供工具化操作接口，支持状态流转、证据追踪以及本地运行与安全绑定。
安装与前置条件¶
安装前请确保满足以下环境要求：
* Node.js 版本 >= 22.19
* 已认证的 Codex CLI
* DeepSeek Harness 环境
仅管理员需要执行一次安装命令。安装完成后，需重启 DSH web 配置文件。
dsh plugin --profile web add github:sonozaki7/dsh-codex-kanban
核心功能¶
状态流转管理¶
插件明确定义了任务状态流转路径：
* backlog：值得记住但未准备好开始。
* ready：上下文和验收标准足够。
* running：有人或代理正在积极工作。
* review：工作已完成但未验收（需证据证明）。
* done：标准已满足且有证据。
* blocked：存在具体阻碍，进入此状态并附带原因。
工具化操作¶
插件向 DeepSeek 代理注册了以下工具：
* kanban：支持 list, create, update, move, evidence, delete。
* kanban_codex：将现有任务委托给 Codex 子代理执行。
重要字段包括 project, status, owner, acceptance_criteria, blocked_by, evidence_text, evidence_url。
证据与安全性¶
- 证据追踪：验收标准、阻碍项、执行报告和验证证据都保存在卡片上。
- 本地运行：仪表板绑定到
127.0.0.1:4317，数据写入本地文件~/.dsh/codex-kanban/board.json。 - 权限控制：数据文件仅允许所有者写入，拒绝来自外部浏览器的未授权修改。
使用流程¶
安装完成后，日常使用主要为可视化操作：
- 打开工作台：在浏览器访问
http://127.0.0.1:4317。 - 创建卡片：选择“Create my first card”，描述预期结果和验收标准。
- 准备工作：将卡片移动到
Ready状态。 - 转发任务：点击卡片上的“Open in Harness”按钮。插件会复制卡片的结构化任务消息并打开官方 Harness UI。
- 执行任务：在 Harness 中粘贴并发送准备好的消息。DeepSeek 可以更新同一张卡片，并在适当时候使用 Codex 内部执行代码。
注意事项¶
- Codex 执行结果：Codex 工作完成后默认进入
review状态，而非done。必须有人工或代理检查并附加证据后，状态才能流转至done。 - 依赖项：插件依赖
@deepseek-ai/dsh-subagent-codex和@deepseek-ai/schemastery。 - 操作模式：在桌面端支持拖拽卡片，在移动端或键盘操作下使用卡片底部的状态菜单。
生态背景¶
DeepSeek Harness 理念为「一切皆插件」。本插件在本地运行，不依赖云任务服务暴露项目上下文，适合需要在多个仓库和 AI 聊天间切换、并希望 DeepSeek 协调而 Codex 处理边界代码工作的场景。
