前言¶
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。
