DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

HHpetra /

HHpetra/dsh-hk-craft

Topic repository only

DSH split screen plugin, hide workspace conversations, switch conversations using the tui command. dsh分屏插件,隐藏工作区对话,改用tui命令切换对话。

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: master@8fe51d68

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 自带的插件面板:

  1. 在仓库根执行 pnpm install && pnpm build && pnpm check && pnpm test。
  2. 打开 dsh → 侧边栏 Plugins → Add plugin。
  3. 选择 Install a third-party plugin,填入本目录的绝对路径: C:\Agent\Agent14-dsh-hk-craft\packages\dsh-hk-craft
  4. 安装完成后重启 dsh,使新 bundle 行装载。
  5. 卸载: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。

—/ 5

No ratings yet

Manifest verification required

Commit 8fe51d6886df

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout