前言¶
在 DSH 插件方式裏，界面外觀調整也可以做成可安裝、可卸載的客戶端層。對 DSH Web 使用者來說，一個具體訴求是：想要一組更穩的 light/dark 視覺值，同時保留自己的 light、dark 或 system 偏好，並且卸載後能恢復到原有主題。
ui-song-theme 就是圍繞這個位置做的插件：它爲 DeepSeek Harness 提供 Song-inspired 的 light 與 dark 主題層。
這是什麼¶
ui-song-theme 由 yunfei07 維護，包名爲 ui-song-theme，許可證爲 MIT。
一句話定位：它是 DeepSeek Harness 的 Song-inspired light and dark theme plugin。它主要解決“疊加一層可回退的主題 token，而不是直接改基礎主題”的問題。
核心功能¶
- 提供可逆的
ThemeRuntime.overrideTokens()層，包含完整的 light 與 dark 值。 - 保留用戶的
light、dark或system偏好。 - 將可見的 legacy blue selections 和 browser focus outline 重繪到同一 botanical color family。
- 卸載插件時只移除插件自己的層，並恢復下面的主題。
安裝與啓用¶
安裝前，先確認運行環境滿足以下要求：
- Node.js
^22.19.0或>=24.0.0 - DeepSeek Harness UI theme
>=0.1.0-rc.6 <0.2.0 - Peer dependencies 包含
@deepseek-ai/cordis ^4.0.1和@deepseek-ai/dsh-client-ui-theme >=0.1.0-rc.6 <0.2.0
下面把插件安裝到 Web profile。執行這條命令後，ui-song-theme 會作爲主題層加入該 profile。
dsh plugin --profile web add github:yunfei07/ui-song-theme
安裝完成後，用下面命令啓動 Web profile，檢查 light、dark 和 system 偏好下的實際效果。
dsh --profile web
典型用法¶
如果是可復現安裝，可以先固定 commit。這樣後續同一 profile 安裝時不會跟隨倉庫默認分支漂移。
dsh plugin --profile web add github:yunfei07/ui-song-theme#<commit-sha>
使用階段如果不再需要這組主題，執行卸載命令。卸載後只移除 ui-song-theme 層，並恢復它下面的主題。
dsh plugin --profile web remove ui-song-theme
如果進入倉庫做本地檢查，可以用下面這組命令，依次覆蓋安裝、檢查、構建和打包檢查。
corepack pnpm@11.21.0 install
pnpm check
pnpm build
pnpm pack:check
適用場景與注意¶
這個插件適合希望調整 DSH Web 界面視覺 token 的使用者，尤其是想保留 light/dark/system 偏好，並且需要可卸載回退的場景。已覈實的能力集中在主題 token 層。
注意以下事項：
- 插件代碼會在當前 dsh 進程權限下運行。安裝前請檢查源碼、依賴和許可證。
- 系統字體可用性會影響 exact Song glyph metrics，不同系統上的具體字形度量可能不完全一致。
- 項目許可證聲明爲 MIT。
結尾¶
ui-song-theme 的價值在於把 Song-inspired 明暗主題做成可疊加、可卸載的 DSH 插件層：安裝時獲得一組完整的 light/dark 值，卸載時恢復原有主題。
社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係；這裏列出可覈實的倉庫地址：
