dsh-shape
Manifest validAdds the ability to quickly customize the dsh interface and functionality to dsh in the form of a plugin. You can use this plugin to instantly add a window, change the UI, or add new tools.
dsh-shape
dsh-shape 是 DeepSeek Harness 插件,用 shape 文件夹扩展 DSH 的界面、聊天卡片和页面级快捷操作。
能做什么
- Shape 浏览器:在对话顶栏打开应用网格,浏览所有 shape;按
Ctrl + .快速打开 - 独立视图:点击 shape 卡片,在第二个窗口展示该 shape 自己的界面
- 会话槽位:9 个槽位可选——输入框上方的卡片栈、下方的信息条、上方的浮窗(可固定、可自由浮动、靠近屏幕边缘自动吸附)、输入条左右与顶栏的状态 chip、New Session 选项、View 菜单行;客户端模块还能用
api.mount()在受支持槽位里渲染自己的 DOM - 单个开关:每个 shape 独立启停;关闭后它的视图、槽位条目和客户端逻辑一起失效
- 客户端逻辑:shape 可以注册页面级行为和快捷键,并按需读取已声明能力的接口
- 删除 shape:卡片右上角的删除按钮,确认后把该 shape 目录从磁盘移除
- 能力依赖:shape 声明需要的插件能力与版本,缺少依赖时不会启动,也不会显示槽位条目
- 能力目录:可以查看当前有哪些 shape 可用能力、版本、用途、用法和 API 方法名
- 内置能力:7 个内置能力覆盖工作区切换、界面控制、快捷键、槽位、事件与存储,见下文内置能力
- 即时生效:新增或修改 shape 文件夹后刷新即可,不需要重启 DSH
内置能力
shape 在 package.json 的 shape.requires 里声明需要的能力,再用 api.require('dsh-shape', '<能力>') 取用;缺少能力或版本不匹配时 shape 不会启动。
| 能力 | 版本 | 方法 | 用途 |
|---|---|---|---|
dsh-shape#core | 1.0.0 | 字段 apiVersion | 判断 shape ABI |
dsh-shape#workspace | 1.0.0 | list current next previous | 切换工作区,并展开、滚动到目标分组 |
dsh-shape#ui | 1.0.0 | openSession openWorkspace toggleSidebar selectPanel getTheme setTheme send cancelTurn notify openShapeBrowser | 控制 DSH 界面:导航、面板、主题、对话、通知、打开 Shapes |
dsh-shape#shortcuts | 1.0.0 | register list | 把 shape 动作注册成 DSH 命令,用户可在设置里重绑 |
dsh-shape#slots | 1.0.0 | list mount entries | 查询 9 个槽位、运行时挂载、统计占用 |
dsh-shape#events | 1.0.0 | emit on | shape 之间收发事件 |
dsh-shape#storage | 1.0.0 | get set remove keys | JSON 数据存到 shape 目录的 data/ 下 |
const ui = api.require('dsh-shape', 'ui')
const shortcuts = api.require('dsh-shape', 'shortcuts')
const store = api.require('dsh-shape', 'storage')
shortcuts.register({ id: 'summary', label: '显示 MCP 摘要', keys: 'Ctrl+Alt+M', run: () => ui.notify('3 个服务器') })
await store.set('collapsed', true) // → <shape>/data/collapsed.json
shape_capabilities 工具会列出当前所有能力、版本、用途、用法和 API 方法名。
演示

36 秒功能演示:1080p MP4 · 演示源码与复现步骤
Shape Studio 预设
安装后新增 Shape Studio 预设,用于开发 shape 和扩展插件:
- 提供查看、检查、创建和校验 shape 的工具,以及可查询 shape 能力目录的工具
- 附带 shape 开发 skill,并可按主题读取完整接口与规范
- 提供 Cordis 检查、插件安装与管理、插件市场
- 附带插件开发与预设编辑相关的 skill
这些工具和 skill 只在 Shape Studio 中可见,其他预设不会看到。
安装
npm 包名:@belowthetree/dsh-shape
dsh plugin --profile <profile> add @belowthetree/dsh-shape
把 <profile> 换成要安装的 profile(如 desktop、web),然后重启该 profile。
其他安装方式:
- GitHub 仓库:
dsh plugin --profile <profile> add github:belowthetree/dsh-shape - 本地开发:
dsh plugin --profile <profile> add link:/path/to/dsh-shape - 插件管理器:在 DSH 的插件管理器中按包名
@belowthetree/dsh-shape或仓库belowthetree/dsh-shape安装
要求 DSH >= 0.2.2-rc.1。安装后点击对话顶栏的 Shapes,或按 Ctrl + . 打开。
从旧的无作用域包名
dsh-shape升级:先dsh plugin --profile <profile> remove dsh-shape,再按上面的命令安装,最后把 profile 的dsh.profile.bundles里的dsh-shape改成@belowthetree/dsh-shape。
Comments
Loading…
Similar plugins
by wlj521
一切皆插件,可以定义自己喜欢的dsh,开关控制单项功能,字体大小,表格样式,对话框长度,timeline,git等
★ 17
↓ 1.4k/wk
MIT
TypeScript
Nov 5, 2026
dsh plugin --profile web add dsh-ui-tweaksby liceses
DSH 插件:把工作区里写好的 HTML 页展示在对话里,并让用户在页面上的表态快速回到 agent 手里。含四套预设样式。
★ 4
MIT
JavaScript
Nov 17, 2026
dsh plugin --profile web add dsh-showme-htmlby pgnqukezrdxmhjso
DSH Web UI 强化插件:功能模块可开关,含提供方标签、级联模型选择器、设置面板拖动 等
★ 0
MIT
TypeScript
Sep 28, 2026
dsh plugin --profile web add dsh-ui-fortifierby KouzakiUmi
DSH 插件:为实际启用的模型提供可读名称,统一美化 provider / 模型选择器与设置页;只改 UI 展示,不改变模型 ID、路由、凭据或请求。
★ 0
MIT
JavaScript
Oct 26, 2026
dsh plugin --profile web add dsh-model-namesby william-jin-cmu
dsh 插件:文件交付协议——send_artifact 工具经 tool/result meta 携带结构化描述子,任意客户端可渲染
★ 0
BSD-3-Clause
TypeScript
Aug 13, 2026
dsh plugin --profile web add @dsh-external/dsh-artifactby KaiYuan0422
一个简单的dsh插件:可以创建一个直接双击启动dsh web界面的脚本,可以自定义图标
★ 0
MIT
JavaScript
Aug 15, 2026
dsh plugin --profile web add dsh-launcher