前言¶
DSH 的扩展方式可以概括为「一切皆插件」：社区目录是独立站点，与 DeepSeek / 幻方没有官方从属关系，不应理解为官方应用商店。dsh-ux 是其中一个 DSH Web 界面体验套件，GitHub 仓库为 jiangnanquan/dsh-ux，许可证为 MIT。
它包含两部分：dsh-enhance Web 插件，以及 dsh-desktop 无边框 Electron 桌面壳。对已经通过 dsh web profile 使用 DSH 的人来说，下面介绍它在主题、布局、折叠胶囊、账户用量和桌面形态上做了什么，以及如何安装、升级、卸载。
组件构成¶
dsh-enhance¶
dsh-enhance 是 DSH Web 插件。package.json 中声明的包名为 dsh-enhance，版本为 1.0.0。它声明了 dsh.bundle.patch 与 dsh.client，安装后会被加入 profile 的 bundles。
dsh-desktop¶
dsh-desktop 是 macOS 无边框沉浸式窗口，把 DSH Web 放进桌面应用形态。它可以双击启动，自动拉起后端和窗口。
核心能力¶
主题与布局¶
主题方面，dsh-enhance 使用 Solarized 浅色配色；深色模式保留官方默认。
字体方面，优先使用 Maple Mono 字体栈，检测到已安装才启用；未安装时自动回退到 PingFang SC、SF Mono、Menlo 或等宽字体。
布局方面，它加宽消息列、使用紧凑间距、收窄输入队列，并禁用橡皮筋滚动。
折叠胶囊¶
思考块会聚合为 Think ×N 胶囊；工具调用会聚合为 A → B → C 链路胶囊。
长链路会按可用宽度换行。每一行独立成一个胶囊，点击任意一行即可展开。
账户用量¶
界面底部会显示官方账户余额、本轮 token 成本，以及近 30 天用量图表。
这些信息需要当前 DSH 已配置 DEEPSEEK_API_KEY 凭据。未配置时，这些信息显示为查询失败或不可用，不影响主题、布局和折叠胶囊等其余功能。
计价表按官方峰谷价硬编码。如果官方调价，需要更新 lib/index.js 中的 pricingFor。
安装与启用¶
先确认你已经按 DSH 的 profile 机制运行 dsh web。
然后执行安装命令：
dsh plugin --profile web add github:jiangnanquan/dsh-ux#main
这个包声明了 dsh.bundle.patch 与 dsh.client，dsh plugin add 会把它加入 profile 的 bundles。执行后重启 dsh 即可生效，无需手改配置。
重复执行安装命令是安全的，幂等。后续升级和卸载使用包名 dsh-enhance：
dsh plugin --profile web update dsh-enhance
dsh plugin --profile web remove dsh-enhance
注意安装地址使用仓库名 dsh-ux，而升级和卸载命令使用包名 dsh-enhance，两者来自同一仓库。
交给 AI 执行¶
如果你不想手动执行命令，可以把 README 中给出的提示词粘贴给任意 AI agent，让它按 INSTALL.md 完成安装、自检和回滚。
示例提示词如下：
请按照 https://github.com/jiangnanquan/dsh-ux/blob/main/INSTALL.md 里的步骤，在我的机器上安装并验证 dsh-enhance 插件（profile 用 web），然后运行文档里的健康检查并告诉我结果。如果任何一步失败，按文档的回滚步骤恢复原状并说明原因。
桌面壳用法¶
dsh-desktop 面向 macOS。使用桌面壳时，双击 启动 DSH.command，它会自动拉起后端和窗口。
它支持以下环境变量：
DSH_URLDSH_SNAPSHOT
这两个环境变量用于指向不同的 DSH Web 地址或快照。
依赖与运行前提¶
dsh-enhance 的 peer dependencies 包括：
react ^18.0.0 || ^19.0.0
@deepseek-ai/dsh-client-runtime ^0.1.0-rc.6
@deepseek-ai/dsh-client-ui-theme ^0.1.0-rc.6
使用账户用量功能时，还需要当前 DSH 已配置 DEEPSEEK_API_KEY。未配置时，余额、本轮成本和近 30 天用量图表会显示查询失败或不可用。
适用场景与注意¶
适合：
1、已经通过 dsh web profile 使用 DSH，想调整主题和布局。
2、经常面对较长的思考块或工具调用链，需要折叠成胶囊。
3、希望在界面底部看到官方账户余额、本轮 token 成本和近 30 天用量。
4、在 macOS 上想把 DSH Web 做成无边框桌面窗口。
注意：
- 插件会以当前 DSH 进程权限运行。安装前建议先检查源码、补丁、依赖和许可证。
- 许可证为 MIT。
- 余额、本轮成本和用量图表依赖
DEEPSEEK_API_KEY，未配置时不可用。 - 计价表按官方峰谷价硬编码，官方调价后需更新
pricingFor。 - 字体效果取决于本机是否安装 Maple Mono；未安装时使用回退字体。
- 插件目录是独立站点，与 DeepSeek / 幻方没有官方从属关系。
结尾¶
dsh-ux 把主题、布局、折叠胶囊和账户用量集中成 DSH Web 插件，并额外提供一个 macOS 无边框桌面壳。适合已经使用 dsh web，并希望调整界面密度、折叠长思考链和工具链、查看账户用量信息的用户。
GitHub 仓库：
https://github.com/jiangnanquan/dsh-ux
如果你正在某个 DSH 插件目录中查找它，请将其视为独立插件入口；本文未给出具体目录页地址，避免引用未核实的 URL。
