dsh-floating-ball
Manifest validA draggable quick-action floating ball above the DSH harness shell, with shortcuts for new session, sidebar toggle, theme switch, and back-to-chat.
悬浮球 · Floating ball
一个 DeepSeek Harness(DSH)插件:在界面最上层浮一颗可拖拽的快捷球,随手新建会话、切换侧栏、切主题、回到对话。
功能
- 挂在
shell.overlay(整帧浮层),悬在所有列之上,不受滚动容器裁剪,点击穿透不挡下方界面 - 按住可拖到任意位置,松手自动吸附最近的左右边缘;位置写入
localStorage(键dsh-floating-ball:position),下次进入仍在原处 - 单击(或键盘 Enter / Space)展开快捷菜单,再点一次、按 Esc、点空白处关闭
- 菜单四项:
- 新建会话 ——
uiWorkspace.startSession() - 切换侧栏 ——
layout.toggleSidebar() - 深色 / 浅色模式 ——
theme.setTheme()(按当前实际配色显示目标项) - 回到对话 ——
layout.selectPanel(null)
- 新建会话 ——
- 样式只用
--dsw-alias-*主题令牌,跟随明暗主题;prefers-reduced-motion下关闭动效 - 文案走 Client locale 服务(中 / 英),服务缺失时回退内置字典
- 自带原创 SVG 图标与
meta.title/meta.description
安装
插件以本地目录形式安装,需要一个 DSH profile:
- 在 DSH 会话里让 Agent 调用
plugin_manager,action: install_bundle,target填本目录的绝对路径; - 安装结果里
application为applied即已生效(Slot 会即时注册); - 之后更新本目录的代码,重新
install_bundle并重启 Harness 才会加载新的客户端 JS 代。
目录结构
package.json # dsh.bundle.patch + dsh.client(platform: web)
cordis.patch.yml # 插入 id: floating-ball 一行
index.js # Host 半:仅导出 apply(),让 Client 半被挂载
client.js # Client 半:注册 shell.overlay 占位 + 悬浮球组件
locale/zh.json # 显示元数据(中文)
locale/en.json # 显示元数据(英文)
icon.svg # 插件图标
自定义
- 菜单项:
client.js里的actions数组,每项一个run()调 Client 服务 - 球体尺寸 / 边距:
BALL、EDGE常量 - 吸附与卡片宽度:
MENU_W、MENU_GAP
兼容性
在 DSH Desktop 0.2.2-rc.1 验证:Client Slot 注册成功、显示元数据与图标随包落地。未声明版本范围。
License
未随包提供许可证文件,按需选择。
Comments
Loading…
Similar plugins
by tuogusa
A floating button beside the chat that opens a searchable list of all questions in the session for quick jumps, with smooth hover-open/close behavior.
★ 0
MIT
JavaScript
Aug 21, 2026
dsh plugin --profile web add dsh-session-nav✦
No screenshots
by loyalchiiina
Floating progress ball for the AI agent todo checklist: six skins, live done/total ring, multi-session monitoring with pins, inline rename, capsule mode, draggable; realtime sync via the sessions serv
★ 1
↓ 716/wk
MIT
JavaScript
Nov 8, 2026
dsh plugin --profile web add dsh-todo-float-ballby hu669293657
Adds deliverable-file buttons to the end of each agent turn (opens files with the OS default app) and a floating dot rail for jumping between conversation turns.
★ 0
MIT
JavaScript
Aug 29, 2026
dsh plugin --profile web add dsh-turn-toolsby jipika
Float the conversation to-do list as a collapsible card in the top-right corner of the session, switchable back to the stock panel from Settings.
★ 0
MIT
JavaScript
Oct 20, 2026
dsh plugin --profile web add dsh-todo-floatby xccpddym
Bubble navigation for DSH (DeepSeek Harness): a draggable accelerator ball listing all of your questions (numbered + timed), plus a full conversation outline panel with category filters. Click to jump
★ 0
MIT
JavaScript
Aug 17, 2026
dsh plugin --profile web add dsh-bubble-navby Andor-Z
Adds a sidebar tab that folds a session into user turns (input, tool steps, output) with one-click jump back into the conversation.
★ 3
↓ 192/wk
MIT
TypeScript
Oct 1, 2026
dsh plugin --profile web add dsh-turn-outline