前言¶
DeepSeek Harness（下文簡稱 DSH）把模型、工具、技能、會話、沙箱、存儲、循環、調度和 UI 都做成可替換的插件。官方說法是「一切皆插件」：Cordis 內核只負責加載、卸載和依賴，具體能力由插件提供。網頁界面因此也可以整層換掉，而不必去改 Harness 源碼。
默認 Web GUI 能完成編碼 Agent 的日常操作，界面卻和官方預覽頁差不多。社區裏陸續出現了主題類插件：有人做角色立繪，有人做桌寵，也有人把整套工作臺配色換成自己的品牌色。dsh-xiaoyao-skins 屬於這一類，但形態更完整——它不是單套皮膚，而是夕小瑤角色向的皮膚合集、一行換膚安裝器，以及給社區作者用的腳手架和體檢命令。
本文按社區插件目錄頁、GitHub 倉庫 README、package.json / catalog/skins.json、皮膚規範 docs/SKIN_SPEC.md、架構說明 docs/ARCHITECTURE.md，以及在線皮膚展廳覈對後整理：這個倉庫是什麼、目錄頁那條安裝命令怎麼用、日常換膚走哪條命令、許可證爲什麼不是「整個倉庫統一 MIT」。社區插件目錄（deepseek-harness-plugin.com）是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，不要把它當成官方應用商店。倉庫自己也聲明：這是獨立社區項目，與 DeepSeek 及 zhu1090093659/dsh-web-ui 原作者不存在隸屬、贊助、認證或背書關係。
這是什麼¶
dsh-xiaoyao-skins 是一套面向真實 DSH Web profile 的社區皮膚合集表現層插件，由 147228 維護，倉庫地址是 147228/dsh-xiaoyao-skins。根目錄 package.json 的包名爲 @xiaoyao-ai/dsh-xiaoyao-skins，作者字段是 Xiaoyao AI / 夕小瑤科技說，當前合集版本是 0.1.3。目錄頁把它歸在「主題與外觀」，主要語言是 CSS。倉庫創建於 2026 年 8 月 13 日，最近一次推送爲 2026 年 8 月 14 日，社區目錄收錄日期爲 2026 年 8 月 15 日。截至 2026 年 8 月 17 日，GitHub API 顯示 24 星；目錄頁當時展示的是 20 星，以後者作收錄快照即可，星標以倉庫頁面爲準。
它解決的問題很具體：讓 Web 界面在不改 Harness 源碼、不清空 profile、不遷移會話數據的前提下，換成帶夕小瑤角色和場景配色的外觀。README 寫明每套皮膚都是一個可安裝、可卸載、可測試的 DSH 插件，不替換會話、模型、工具、沙箱或插件系統。catalog/skins.json 聲明兼容 DeepSeek Harness 0.1.0-rc.6、Node.js >=20。
和只分發一套成品皮膚的倉庫不同，這裏同時提供三件事：
packages/skins/*裏的六套獨立皮膚 bundlexiaoyao-skin安裝器，內部調用官方dsh plugin add/remove做切換xiaoyao-skin create/doctor這條社區創作工具鏈
根目錄 package.json 沒有 dsh.bundle 字段，真正帶 DSH 接線的是各皮膚子包。例如黑鯨實驗室的包名是 @xiaoyao-ai/dsh-client-ui-skin-black-whale，dsh.client.platform 爲 web，對 @deepseek-ai/cordis 的開發依賴是 ^4.0.1。
核心功能¶
下面這些能力來自倉庫 README、catalog/skins.json、皮膚規範和架構文檔，不是演示稿裏的想象功能。
六套接入真實 Web profile 的皮膚¶
README 強調預覽圖來自真實 DSH Web profile，不是靜態概念圖。catalog/skins.json 當前登記了六套：
| 皮膚 | slug | 包名 | 配色要點 | 作用域 |
|---|---|---|---|---|
| 夕小瑤 · 黑鯨實驗室 | black-whale |
@xiaoyao-ai/dsh-client-ui-skin-black-whale |
官網黑鯨 × 石墨黑 × 小瑤粉 | data-dsh-black-whale |
| 夕小瑤 · 探索之境 | ocean |
@xiaoyao-ai/dsh-client-ui-skin-xiaoyao |
深海藍 × 貓娘粉 × 鯨魚光效 | data-dsh-xiaoyao |
| 藍粉雙子 · 晴空研究所 | sky-lab |
@xiaoyao-ai/dsh-client-ui-skin-sky-lab |
雲端白晝 × 雙主角協作 | data-dsh-sky-lab |
| 夕小瑤 · 烽火夜長城 | great-wall-beacon |
@xiaoyao-ai/dsh-client-ui-skin-great-wall-beacon |
炭黑長城 × 中國紅 × 古金 | data-dsh-great-wall-beacon |
| 夕小瑤 · 山河朝霞 | great-wall-sunrise |
@xiaoyao-ai/dsh-client-ui-skin-great-wall-sunrise |
米白宣紙 × 硃紅 × 朝霞金 | data-dsh-great-wall-sunrise |
| 夕小瑤 · 雪嶺長城 | great-wall-snow |
@xiaoyao-ai/dsh-client-ui-skin-great-wall-snow |
雪白 × 墨灰 × 正紅披風 | data-dsh-great-wall-snow |
完整安裝命令也可以在 在線皮膚展廳 一鍵複製。展廳文案同樣寫明：只改變表現層，會話、模型、工具、沙箱、權限與項目數據仍由原生 Harness 提供。
一行換膚，切換時只動本倉庫登記過的包¶
日常換膚不靠手改 cordis.patch.yml。安裝器默認操作 web profile，流程在 docs/ARCHITECTURE.md 裏寫得很清楚：
- 先通過官方
dsh plugin add安裝目標皮膚的 Release tgz - 再移除本倉庫目錄裏登記過的其他皮膚包
- 不改 DSH 源碼，不清空 profile，不讀取或遷移會話數據
安裝順序是「先加目標、後移舊皮膚」。目標下載或安裝失敗時，當前皮膚仍在，不會把 profile 留在半配置狀態。README 還提供 xiaoyao-skin use official 恢復官方界面。
只做表現層¶
架構文檔把皮膚能做和不能做的事寫死了。皮膚可以改色彩、排版、背景、邊框與動效，可以使用倉庫內有許可的圖片和字體，也可以讀取視口、系統配色和 prefers-reduced-motion。皮膚不可以：
- 替換或代理會話、模型、工具、沙箱、存儲、網絡請求
- 採集遙測、上傳 profile 內容或注入外部腳本
- 直接改寫 DSH 安裝目錄、用戶配置或其他插件
- 用全局選擇器污染未啓用皮膚時的頁面
docs/SKIN_SPEC.md 進一步要求：全部 CSS 必須以 body[你的-bodyAttr] 爲作用域；圖片必須可在離線環境工作，禁止運行時遠程拉取；皮膚包不得包含網絡請求、遙測、外部腳本、本機絕對路徑、賬號信息或未脫敏工作區截圖。黑鯨實驗室 README 也寫了同一句話：不讀取會話，不調用模型，不發起網絡請求。素材在構建階段內嵌進 client bundle。
Client 入口用 ctx.effect() 安裝皮膚，並返回清理函數。卸載或熱重載時必須移除 bodyAttr、事件監聽與運行期 style 節點。倉庫用測試真實執行 dispose()，避免換完皮膚回不去。
給創作者的腳手架和體檢¶
合集不只給終端用戶。xiaoyao-skin create 會生成一套帶官方 DSH bundle 接線、Web client 入口、可逆卸載、CSS 隔離、測試和授權文件的模板。做好後可以用 xiaoyao-skin doctor 跑合集醫生。皮膚提案走 GitHub Issue 模板 skin_proposal.yml。pnpm check 會校驗目錄元數據、官方 DSH 接線、表現層權限邊界、生命週期清理、六套皮膚單測、安裝器單測、構建結果與展廳；合併請求還會在 Linux、macOS、Windows 三套環境中重跑。
安裝與啓用¶
安裝前請先有一份能跑起來的 DSH Web 界面，並已完成初始化。官方快速體驗是：
npx @deepseek-ai/dsh web
源碼安裝則克隆 deepseek-ai/deepseek-harness。DSH 仍處於開發者預覽，核心插件和 API 會繼續變。倉庫要求 Node.js 20+，推薦 24 LTS。不需要預先安裝 pnpm：安裝器會優先複用可用版本；沒有時通過 Corepack 或 npx 爲本次操作臨時提供兼容版本，不修改全局 pnpm 配置。
目錄頁給出的命令¶
社區目錄頁的安裝命令以頁面原文爲準，在 DeepSeek Harness 終端裏運行：
dsh plugin add github:147228/dsh-xiaoyao-skins
如需可復現安裝，目錄頁要求固定 commit 哈希：
dsh plugin add github:147228/dsh-xiaoyao-skins#<commit>
把 <commit> 換成倉庫裏實際的提交哈希，不要照抄佔位符。
目錄頁同時提示：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前應檢查源代碼倉庫和許可證。
這條命令把整個 GitHub 倉庫當作插件源。日常「換到某一套皮膚」時，倉庫 README 走的是下一節的安裝器：它按 catalog/skins.json 解析已登記包與 Release 資產，再對目標皮膚 tgz 調用 dsh plugin add。
倉庫 README 的一行換膚¶
需要 Node.js 20+，並已安裝、初始化 DeepSeek Harness。命令默認操作 web profile。
換成黑鯨實驗室：
npx --yes --package=https://github.com/147228/dsh-xiaoyao-skins/releases/latest/download/xiaoyao-skin-kit.tgz xiaoyao-skin use black-whale
換成探索之境：
npx --yes --package=https://github.com/147228/dsh-xiaoyao-skins/releases/latest/download/xiaoyao-skin-kit.tgz xiaoyao-skin use ocean
其餘四套把最後的 slug 換成 sky-lab、great-wall-beacon、great-wall-sunrise 或 great-wall-snow 即可，與 catalog/skins.json 裏的 install 字段一致。
恢復官方界面：
npx --yes --package=https://github.com/147228/dsh-xiaoyao-skins/releases/latest/download/xiaoyao-skin-kit.tgz xiaoyao-skin use official
可用 --profile 指定其他 profile，用 --dry-run 只查看將執行的 DSH 命令，不檢查、不下載、不寫入 profile。
安裝兼容性與排錯¶
README 把安裝器在不同 Node 版本上的行爲寫成了表：
| 環境 | 安裝器行爲 |
|---|---|
| Node.js 24 / 22.13+ | 複用可用 pnpm，或臨時使用 pnpm 11.19 |
| Node.js 20 / 22.0–22.12 | 複用可用 pnpm，或臨時使用 pnpm 10.34，避開 pnpm 11 的 Node 版本限制 |
| 未安裝全局 pnpm | 自動走 Corepack；Corepack 也不可用時自動走隨 Node 提供的 npx |
--dry-run |
只打印 DSH 命令，不檢查、不下載、不寫入 profile |
如果看到 dsh: pnpm not found on PATH，README 的說明是：使用的是舊版工具包，重新執行上面同一條 releases/latest 命令即可獲取修復版。若自動兜底因網絡或代理失敗，安裝器會給出與當前 Node.js 匹配的手動 npm install -g pnpm@... 命令。安裝目標失敗時不會移除當前皮膚。
典型用法¶
看預覽再決定¶
安裝前可以先打開展廳 https://147228.github.io/dsh-xiaoyao-skins/ ，或直接看倉庫裏各皮膚目錄的 preview/dark.jpg。六套畫風跨度比較大：黑鯨偏專業研究臺，探索之境和晴空研究所偏角色向，長城三套偏新中式場景。不喜歡某一套，換 slug 即可，不必先卸整個工具鏈。
指定 profile 或只預覽命令¶
默認寫 web profile。若你的 DSH 界面不在默認 profile 裏，加上 --profile。只想確認安裝器會調用哪些 dsh plugin 命令時，加 --dry-run。這兩項都來自根目錄 README，沒有額外的配置文件要改。
做一套自己的皮膚¶
npx --yes --package=https://github.com/147228/dsh-xiaoyao-skins/releases/latest/download/xiaoyao-skin-kit.tgz xiaoyao-skin create moon-rabbit
cd dsh-skin-moon-rabbit
pnpm install
pnpm check
模板已經帶好官方 DSH bundle 接線、Web client 入口、可逆卸載、CSS 隔離、測試和授權文件。docs/SKIN_SPEC.md 要求每個皮膚聲明唯一的 id、包名、bodyAttr、接線 id，並且 wiring.bundleWired 必須爲 true，代表能通過一條 DSH 插件命令自動接入 Web profile。package.json 必須同時公開 Host 和 Client 構建產物，cordis.patch.yml 的插件名必須等於包名。
做好後運行合集醫生：
npx --yes --package=https://github.com/147228/dsh-xiaoyao-skins/releases/latest/download/xiaoyao-skin-kit.tgz xiaoyao-skin doctor ./dsh-skin-moon-rabbit
然後從 皮膚提案 Issue 模板 開始，或直接閱讀倉庫的 CONTRIBUTING.md。只想換外觀、不打算投稿的話，不必走這條路徑。
本地開發合集本身¶
完整開發、構建與發佈使用 Node.js 24：
corepack enable
pnpm install --frozen-lockfile
pnpm check
pnpm pack:release
這是維護這個合集倉庫時用的命令，終端用戶換膚不需要跑。
適用場景與注意事項¶
適合這些情況：
- 已經在用 DSH Web 界面，希望工作臺有固定的夕小瑤 / 新中式辨識度
- 只改外觀，不希望皮膚插件插入服務、改模型請求或訪問會話
- 想在幾套社區皮膚之間切換，並保留一鍵回到官方界面的路徑
- 打算按規範做一套自己的表現層皮膚，並提交到這個合集
不適合這些情況：
- 只在終端 / TUI 裏用 DSH，不用 Web GUI。各皮膚
package.json把平臺標成web - 指望它增強 Agent 能力。它不提供工具、技能或模型適配
- 要把小瑤角色或美術直接用於商業項目。美術是 CC BY-NC 4.0，付費分發、商品、廣告植入及商業圖像模型訓練需另行取得書面授權
許可證必須按層來看。GitHub 和目錄頁把 SPDX 標成 NOASSERTION，是因爲本倉庫不是「所有內容統一 MIT」。README 的對照表是：
| 內容 | 適用許可 | 必須注意 |
|---|---|---|
| 本項目原創源代碼 | MIT，Copyright © 2026 Xiaoyao AI / 夕小瑤科技說及貢獻者 | 副本或重要部分須保留 MIT 版權與許可聲明 |
shared/tsdown.client.ts、shared/web-platform.ts 等衍生構建支持 |
衍生自 zhu1090093659/dsh-web-ui，原作者代碼爲 BSD-3-Clause |
源碼和二進制分發均須保留原作者版權、許可條件和免責聲明；不得暗示原作者背書 |
| 夕小瑤角色、美術、皮膚背景和預覽圖 | CC BY-NC 4.0 | 署名後的個人使用、研究、展示和其他非商業使用可以；不得直接用於商業用途 |
| DeepSeek Harness 代碼與構建約定 | 按 deepseek-ai/deepseek-harness 的 MIT 許可使用 |
DeepSeek 名稱、鯨魚標識及其他商標權利不因本倉庫而獲得授權 |
轉載截圖、發佈整合包或遷入代碼時，不能只保留本倉庫的 MIT 文件；還必須一併保留對應的素材許可與第三方聲明。完整文本見 LICENSE、ASSET_LICENSE.md 和 THIRD_PARTY_NOTICES.md。
另外幾條實踐上的限制：
- 插件以當前 dsh 進程權限運行。即使這是展示層皮膚，安裝前仍應瀏覽倉庫源碼和許可證
- 皮膚規範禁止運行時網絡請求和遙測，但自動校驗只能兜底，貢獻者仍需對素材和代碼負責
- 兼容性聲明針對 DSH
0.1.0-rc.6。DSH 仍在開發者預覽，界面 DOM 結構一變，皮膚選擇器可能對不齊 - 安裝器通過 GitHub Releases 拉取
xiaoyao-skin-kit.tgz和各皮膚 tgz，網絡或代理失敗時要按安裝器給出的提示處理，不要手工改 DSH 源碼來「補裝」
小結¶
dsh-xiaoyao-skins 把 DSH「UI 也是插件」這件事做成一套可切換的社區皮膚工坊：六套皮膚各自是獨立的 Web 表現層 bundle，安裝器負責調用官方 dsh plugin add 做可逆切換，腳手架則把 CSS 隔離、卸載清理和許可文件提前寫進模板。它不介入會話、模型、工具和沙箱。目錄頁的安裝命令是：
dsh plugin add github:147228/dsh-xiaoyao-skins
日常換到某一套皮膚，按 README 使用 xiaoyao-skin use <slug>。使用前看清分層許可：代碼走 MIT，衍生構建支持走 BSD-3-Clause，小瑤美術走 CC BY-NC 4.0，非商業場景再分發截圖或整合包。
目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-xiaoyao-skins/
GitHub：https://github.com/147228/dsh-xiaoyao-skins
在線展廳：https://147228.github.io/dsh-xiaoyao-skins/
