dsh-hk-craft
DeepSeek Harness(dsh)的原生插件。以一个可安装组合包(bundle)接入你已有的 dsh profile,在 dsh 现有 Web UI / 会话中直接使用。
不提供启动器、桌面外壳、独立 DSH_HOME、独立端口或第二套界面。
状态
已交付能力:多会话分屏 + 侧栏精简,并补齐侧栏工作区管理(五态灯、删除确认、拖动排序)、HK Craft 设置页、窗格头部工具栏与桌面通知。关键决策见 ADR-0005 ~ 0020,上游契约清单见 docs/upstream-contracts.md。
- 多会话分屏:插件加载后默认进入分屏。每个窗格承载一个会话;
+、Ctrl+Shift+E和/resume的 Ctrl+Enter 在焦点窗格右侧插入新窗格,并按当前窗格数均分这一排的宽度,不重排顺序。没有焦点窗格时Ctrl+Shift+E不产生分栏。每个工作区默认最多 4 格,可在 HK Craft 设置页改成任意格数,填0表示不限制;已经开始创建的分栏不会因为中途把上限调低而被取消。窗格数不等于会话数。每个窗格头部显示自己的标题、当前模式、子代理查看、视图切换与关闭,标签条只保留标签和紧贴的+。 - TUI 命令切换对话:
/resume、/new、/clear、/fork、/trace与Ctrl+N;命令只在客户端执行,不发给模型、不写入会话日志。/resume可搜索当前工作区的历史会话,Enter替换焦点窗格,Ctrl+Enter在右侧新格打开。完整用法见 插件 README。 - 侧栏精简与工作区管理:工作区行有五态灯(灰/蓝空闲/绿未读/黄/红)、行内删除(二次确认、不中断运行中的会话)与指针拖动排序(顺序由 Host 持久化)。
- 桌面通知:等待授权 / 等待回答 / 计划待审阅 / 本轮完成 / 本轮失败五类分开;点击通知切到对应会话。设置页可逐类开关、关声音、查看系统权限并发送测试通知。子代理不单独通知,失败优先于完成;可勾选“dsh 在前台且该对话可见时不再通知”,避免对正在看的对话重复打扰。
- 界面:工作区、标签条、窗格头部、空状态、对话框与设置页统一使用 dsh 的
--dsw-*语义 token;深浅主题、键盘 focus-visible、悬停态与 reduced-motion 都走同一套视觉层。
插件仍以 bundle 形式装入现有 dsh profile,不改变 dsh 的端口、home 与登录态;安装后需重启 dsh 生效。
依赖
| 依赖 | 版本 | 说明 |
|---|---|---|
| Node.js | ^22.19.0 || >=24.0.0 |
根 package.json engines.node |
| pnpm | 12.5.1 |
由 packageManager 钉死;拒绝 npm/yarn |
@deepseek-ai/dsh(Desktop 运行时) |
0.2.2-rc.1 |
desktop profile 实际加载的运行时;本插件作为其 profile bundle 安装 |
全局 dsh CLI |
0.2.0-rc.2(本机) |
只用于非 desktop 试验 profile;与上一行不是同一列车 |
| dsh profile | desktop |
默认安装目标;沿用其 home、端口与 Web UI |
版本真源见 deps/VERSIONS.md。
安装与卸载
desktop profile 由 Electron 应用独占管理,不能用 CLI dsh plugin --profile desktop ... 安装;CLI 会返回 profile "desktop" is managed exclusively by the Electron application。安装走 dsh 自带的插件面板:
- 在仓库根执行
pnpm install && pnpm build && pnpm check && pnpm test。 - 打开 dsh → 侧边栏 Plugins → Add plugin。
- 选择 Install a third-party plugin,填入本目录的绝对路径:
C:\Agent\Agent14-dsh-hk-craft\packages\dsh-hk-craft - 安装完成后重启 dsh,使新 bundle 行装载。
- 卸载:Plugins → Installed plugins → dsh-hk-craft → 卸载,再重启。
也可以在非 desktop 的试验 profile 上用 CLI 做安装冒烟(会新建该 profile,不影响 desktop):
dsh plugin --profile craft-smoke add ./packages/dsh-hk-craft
注意 dsh 指向的是全局 npm CLI,不一定和 Desktop 内置运行时同一列车(本机 CLI 为 0.2.0-rc.2,Desktop 为 0.2.2-rc.1)。CLI 版本不满足 engines.dsh 时先按同一列车升级,这条冒烟才成立;desktop 的安装与冒烟不受影响。
开发命令:
pnpm test # 包内单元测试
pnpm build # 构建客户端 bundle lib/client.js
pnpm check # 校验 manifest / patch / 入口与已构建 bundle 一致
目录说明
| 路径 | 用途 |
|---|---|
packages/dsh-hk-craft/ |
唯一可安装 bundle:manifest、cordis.patch.yml、host 入口、客户端 UI 与构建脚本 |
GLOSSARY.md |
领域语言(术语表,长期) |
docs/ |
架构与关键原理(长期) |
docs/adr/ |
架构决策记录:一决策一文件(长期) |
docs/agents/ |
工程类 skill 的消费规则:issue 跟踪器、triage 标签、域文档 |
docs/research/ |
技术调研与可行性 |
.scratch/ |
无 remote 时的临时容器 / 本地草稿(不入库) |
scripts/ |
结构校验与冒烟 |
tests/ |
跨包冒烟与 fixtures |
deps/ |
钉死的第三方版本 |
没有 apps/:本项目不设独立应用入口,这是刻意的架构约束(ADR-0001)。
延伸阅读
docs/README.md— 架构说明docs/upstream-contracts.md— 依赖的 dsh 上游契约docs/adr/— 架构决策记录docs/agents/domain.md— 领域文档与 issue tracker 规则AGENTS.md— 协作者与编码 Agent 的约定GLOSSARY.md— 领域语言
许可
本项目采用 MIT License 开源,Copyright (c) 2026 HHpetra。
No comments yet. Be the first to write one.