前言¶
在 DeepSeek Harness（DSH）里做智能体开发时，常见做法是切到终端或 IDE 里调用 CLI、再看纯文本输出。你若希望在本机桌面上保持一个轻量入口，把对话、模型选择和回复展示集中在一块区域，就需要在客户端侧扩展 DSH，而不是只靠终端会话。
下面介绍社区插件 dsh-floating-ball（维护者 1997liuyh-boop）。它归类为 客户端 插件；SkillHub 目录页显示的简介为：DSH 桌面悬浮助手，支持 Markdown 回复、会话、模型 和 权限控制。DeepSeek Harness 生态强调「一切皆插件」，SkillHub（目录页）是独立社区站点，与 DeepSeek / 幻方无官方应用商店式的从属关系；安装与源码审查仍由使用者自行承担。
这是什么¶
dsh-floating-ball 面向在本机运行 DSH 的开发者：用桌面悬浮形态提供助手界面，并与 DSH 的会话、模型及权限能力对接。公开元数据中仓库星标为 0；GitHub 地址为 1997liuyh-boop/dsh-floating-ball。预抓取的 README 未能获取，写作时无法引用仓库内的安装说明或配置字段原文。
核心功能¶
以下能力来自目录简介，未经 README 逐步核对，故只作能力范围说明，不展开未公开的接口名或配置项。
- Markdown 回复：助手输出以 Markdown 形式呈现，便于阅读代码块、列表等结构化内容。
- 会话：在悬浮界面中延续或管理对话上下文（具体交互以仓库实现为准）。
- 模型：与 DSH 侧的模型选择或使用方式衔接（细节见后续公开的文档）。
- 权限控制：涉及本机能力时，应通过 DSH 插件体系做权限约束（实现方式以源码为准）。
安装与启用¶
预抓取资料中 未包含 官方安装命令原文；按任务要求，本文 不 凭插件名拼接 dsh plugin add github:owner/repo 一类命令。
安装前建议按下面顺序自行核对：
- 打开 SkillHub 目录页，确认插件条目与维护者信息是否与预期一致：
https://www.skillhub.cn/plugins/1997liuyh-boop/dsh-floating-ball - 打开 GitHub 仓库，阅读 README 中的安装、启用与依赖说明：
https://github.com/1997liuyh-boop/dsh-floating-ball
核对时若仓库不可用或 README 缺失，应等待维护者更新或从目录页提供的其它链接获取说明，勿使用未经验证的命令。 - 在 DSH 中按文档完成插件加载后，再启动与悬浮助手相关的客户端入口（具体子命令或菜单以 README 为准）。
典型用法¶
README 预抓取失败，且当前无法从仓库拉取可复现示例，本文 不 编写虚构的命令或配置片段。
经上面的步骤拿到 README 后，通常应关注：如何唤起悬浮窗、如何绑定当前 DSH 会话、如何选择模型，以及 Markdown 渲染与权限提示是否符合你的安全策略。将文档中的示例原样迁入本地环境验证即可。
适用场景与注意¶
适合谁
- 经常在桌面环境下使用 DSH，希望减少在终端与浏览器之间来回切换的开发者。
- 需要把助手回复以 Markdown 阅读，并希望在同一入口管理会话与模型选择的用户。
务必注意
- DSH 插件在 当前 dsh 进程的权限 下运行；客户端类插件还可能访问图形界面、剪贴板或本地文件等能力。安装前应通读源码、查看许可证，并确认与你的工作区安全规范一致。
- 社区目录用于发现插件，不承担与你本机环境一致的担保；星标、版本号、许可证等仅以各页面与仓库 明确展示 的内容为准。
- 公开资料未给出详细配置项时，不要假设默认值或环境变量名称；一律以维护者后续发布的 README 为准。
结尾¶
dsh-floating-ball 的定位是 DSH 上的桌面悬浮助手，在简介所述范围内覆盖 Markdown 回复、会话、模型与权限控制。若你需要在不离开桌面的前提下使用 DSH，可从社区目录进入条目，并在 GitHub 仓库获得最新安装与用法说明。
