iKanban

English | 简体中文

iKanban 是一个面向键盘操作、基于 DeepSeek Harness 的多智能体编码工作空间。它专为跨项目地驱动、审查和协调并行智能体工作而构建，将会话管理、差异审查和项目感知导航集于一处。

本 monorepo 包含 iKanban DSH bundle，以及由 iKanban 和 IPaper 共同使用、公开发布的产品中立浏览器软件包。

介绍视频

以下视频介绍了 iKanban 的工作流及其演进，包括当前基于 DSH 的 v0.5.0。v0.3 及更早的视频早于当前软件包，因此其中的安装步骤和部分界面可能有所不同。

Bilibili 视频： 为什么做它 · v0.1 · v0.2 · v0.2.11 如何使用 · v0.3 · v0.3.14 · v0.4.2 · v0.5.0

软件包

• @isomoes/dsh-ikanban - 公开发布的 iKanban DSH bundle、编码预设、产品组合配置和品牌
• @isomoes/dsh-web-ui - 与 IPaper 共用、公开发布的产品中立浏览器插件界面和 Vite shell

使用方法

1. 安装 DSH

首先通过 npm 全局安装 DeepSeek Harness CLI：

npm install -g @deepseek-ai/dsh --registry=https://registry.npmjs.org

中国大陆用户可以将命令中的 npm 官方 registry 替换为国内镜像，例如 https://registry.npmmirror.com。镜像同步可能存在延迟；如果需要最新发布的版本，请使用官方地址 https://registry.npmjs.org。

2. 安装 iKanban

将已发布的 iKanban bundle 和共享 Web UI 安装到 ikanban profile 中。如果该 profile 尚不存在，dsh plugin 命令会自动创建：

dsh plugin --profile ikanban add @isomoes/dsh-ikanban @isomoes/dsh-web-ui --registry=https://registry.npmjs.org

@isomoes/dsh-web-ui 必须是 profile 的直接依赖，因为 Cordis 从 profile 根目录解析浏览器 loader entry；它不会加入 dsh.profile.bundles，组合补丁仍然只由 @isomoes/dsh-ikanban 提供。这里的 --registry 同样可以替换为国内镜像；需要最新 iKanban 版本时请使用 npm 官方 registry。

3. 更新 iKanban

停止正在运行的 iKanban，然后通过 DSH 将该 profile 中的 iKanban bundle 和共享 Web UI 一起更新到最新版本：

dsh plugin --profile ikanban update @isomoes/dsh-ikanban @isomoes/dsh-web-ui --latest --config.minimumReleaseAge=0 --registry=https://registry.npmjs.org

--config.minimumReleaseAge=0 会在此次显式更新中绕过 pnpm 默认的 24 小时新版本等待期，否则刚发布的版本可能被报告为“Already up to date”。更新完成后，重新启动 iKanban 即可。国内镜像也可能存在同步延迟；若未获取到最新版本，请改用上述 npm 官方 registry。

4. 运行 iKanban

通过该 profile 启动 iKanban：

dsh --profile ikanban

可以通过启动参数指定端口，例如：

dsh --profile ikanban --port 9091

发布历史请参阅 CHANGELOG.md。当前架构与产品演进记录保留在以下文档中：

版本文档： v0.4.2 当前架构与基础功能 · v0.1.6 到 v0.2.7 · v0.2.7 到 v0.3.1 · v0.3.1 到 v0.3.14

开发

pnpm install
pnpm typecheck
pnpm build

构建项目，将 iKanban bundle 与共享 Web UI checkout 都以链接方式安装到隔离的 ikanban-dev DSH profile，然后运行：

pnpm dev

pnpm dev 会自动创建或刷新 profile，并显式链接 @isomoes/dsh-web-ui，使隔离 profile 可以解析组合配置中的 @isomoes/dsh-web-ui/client/* loader entry。Web UI 是普通运行时依赖，不会成为额外的 bundle layer；只有 iKanban 提供产品组合补丁。使用 pnpm dev:config 可以在不启动应用的情况下检查最终组合配置。该命令通过 tsdown 监视所有 fork 后的客户端 bundle，并通过 Vite 监视浏览器 shell。客户端变更会热重载对应的虚拟 DSH 软件包；shell 变更会复制到链接的软件包中，需要刷新浏览器。

有关重新构建行为和 profile 清理方式，请参阅软件包的开发指南。