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