前言¶
DSH 的 Web 界面已經提供原生對話，但文件、終端、瀏覽器、文檔、知識庫等能力如果分散在不同入口，同屏協作會比較受限。dsh-macos-desktop 是一個面向 DSH Web profile 的客戶端插件，由 Taylor-Cat 維護。它通過 DSH 官方 shell.overlay 槽位，在官方 DSH 對話之上疊加一個 macOS 風格桌面，右側仍保留原生對話，卸載後恢復官方界面。
這是什麼¶
dsh-macos-desktop 的定位是：把 DSH 的 Web 界面改造成 macOS 風格桌面，同時保留官方原生對話，並提供文件、終端、瀏覽器、文檔、知識庫、AI 看圖與生圖等桌面能力。
它聲明爲純前端、純 JS 實現，無原生模塊、無構建步驟，兼容 Windows、macOS、Linux。許可證爲 MIT。
核心功能¶
桌面與官方對話¶
- 在官方 DSH 對話之上疊加界面，右側保留原生對話並主題化。
- 提供 macOS 風格桌面：多窗口、Dock、菜單欄、Spotlight 搜索、迷你日曆、天氣、深色模式。
- 通過 DSH 官方
shell.overlay槽位掛載；卸載後恢復官方界面。
文件、終端與瀏覽器¶
- 文件管理：隔離
desktop/目錄、回收站、便籤、拖拽上傳。 - 終端：Windows PowerShell/cmd 與 POSIX PTY。
- 多標籤瀏覽器。
文檔、知識庫與工具¶
- 文檔辦公：
docx、pdf、pptx與富文本。 - 知識庫。
- 計算器、番茄鍾。
AI 能力¶
- AI 看圖：依賴
modlens。 - 截圖自動看圖發給 AI。
@知識庫引用。- AI 生圖：使用 DashScope 通義萬相。
安裝與啓用¶
前置環境¶
- Node.js
≥22.19.0 - npm
≥9 peerDependencies要求@deepseek-ai/cordis ^4.0.1dsh plugin會轉發給 pnpm
安裝¶
本地鏈接安裝適合鏈接調試：
dsh plugin --profile web add link:../dsh-macos-desktop
已覈實資料中給出的 GitHub 安裝形式如下：
dsh plugin --profile web add github:你的用戶名/dsh-macos-desktop
這裏的“你的用戶名”是佔位符。已覈實資料未出現可直接使用的 Taylor-Cat/dsh-macos-desktop 安裝命令，README 中該命令也用於“發佈到 GitHub 後”。
安裝後可查看插件列表：
dsh plugin --profile web list
更新和卸載：
dsh plugin --profile web update dsh-macos-desktop
dsh plugin --profile web remove dsh-macos-desktop
啓動與驗證¶
啓動 Web 界面：
dsh web
打開 http://127.0.0.1:3080，按 Ctrl/Cmd+Shift+R 硬刷新。
換端口啓動：
dsh web --port 8080
確認插件進入配置樹：
dsh --profile web --dump-config
倉庫內還帶有兩個自檢命令：
node verify-structure.cjs .
node smoke-host.cjs
典型用法¶
啓用 AI 生圖¶
AI 生圖使用 DashScope 通義萬相，依賴可選的 DASHSCOPE_API_KEY。可以配置環境變量，或使用密鑰文件，例如：
$DSH_HOME\secrets\dashscope.key
密鑰用於 AI 生圖，AI 會話讀不到該密鑰。
啓用 AI 看圖¶
AI 看圖依賴 modlens CLI：
npm i -g @liustack/modlens
檢查 modlens 引擎配置：
npx @liustack/modlens doctor
未安裝 modlens 時，相關功能會給出提示。
使用原生對話¶
右側保留官方 DSH 對話能力。DSH 0.1.x 沒有 DSH_MODEL 環境變量；默認模型在設置裏，會話模型在界面中選擇。
適用場景與注意¶
- 適合希望在不替換官方 DSH 對話的前提下，把文件、終端、瀏覽器、文檔、知識庫等能力放到同一 Web 桌面的使用者。
- 插件複用 DSH 模型與憑據體系，本插件自身沒有密鑰。
- 文件、終端、文檔只在授權 workspace 內操作。
DASHSCOPE_API_KEY爲可選項，用於 AI 生圖。file:安裝是複製不是鏈接，改代碼不生效；link:安裝是軟鏈接。- 插件 ID 需與包名、客戶端 bundle id 一致。
- 插件隨當前 DSH 進程運行，並複用 DSH 的模型、憑據與 workspace 授權範圍；安裝前應檢查源碼與許可證。
參考¶
GitHub：
https://github.com/Taylor-Cat/dsh-macos-desktop
目錄頁：已覈實資料未包含可確認的 URL。
