前言¶
在 DSH「一切皆插件」的模式下，桌面窗口、运行时管理、平台兼容、计费查看和文件编辑都可以作为插件接入。dsh-desktop-tools 是一个 dsh 环境管理插件：安装后，dsh web 可自动获取桌面宿主并打开桌面窗口，同时提供环境面板弹窗、DeepSeek 官方计费面板和内置代码编辑器。
这是什么¶
dsh-desktop-tools 是 TypeScript 编写的 dsh 环境管理插件，许可证为 MIT，仓库地址是 https://github.com/YUEEEEY/dsh-desktop-tools。它覆盖几类能力：
- 桌面窗口：Rust/Tauri 宿主按系统自动获取；
- 运行时管理：提供一键更新入口；
- 平台兼容：自动适配，非 Windows 自动跳过；
- DeepSeek 官方计费面板；
- 内置代码编辑器：浏览与编辑工作区文件。
插件声明 peerDependencies 为 @deepseek-ai/schemastery ^3.18.1。
核心功能¶
桌面窗口¶
安装插件后，可配备桌面窗口。宿主是 Tauri 2 二进制，约 5MB，支持 Windows / macOS / Linux。
启动 dsh web 时，插件会自动获取桌面宿主并打开桌面窗口。如果不想自动开窗，可以使用：
dsh web --no-desktop
环境面板弹窗¶
使用 Ctrl+Shift+P，或从托盘/菜单打开独立面板窗口。面板内容包含宿主状态、运行时、平台兼容和计费摘要。
运行时一键更新¶
插件提供运行时一键更新能力。更新和平台适配都依赖 dsh 安装位置；无法定位 dsh 安装时，会返回“未定位到 dsh 安装”，但计费、编辑器与页面功能不受影响。
平台兼容自动适配¶
平台兼容适配会按系统自动处理：非 Windows 自动跳过；配置 autoApplyPatches 仅在 win32 下生效。
DeepSeek 官方计费面板¶
插件提供 DeepSeek 官方计费面板，用于查看 DeepSeek 官方计费信息。
代码编辑器¶
使用 Ctrl+Shift+E，或从托盘/菜单在主窗口内打开代码编辑器，可以浏览与编辑工作区文件。
代码视图顶部可用「对话 / 代码」切换，或用 Ctrl+B 回到对话视图。
编辑器支持多标签：按扩展名识别语言，Ctrl+S 保存，未保存文件有标记，状态栏显示路径、语言和行列。也可以在运行时切换工作区根目录，打开其它项目，无需重启。
默认根目录为 dsh 工作区，可用配置 editorRoot 覆盖。文件 API 包括：
/api/fs/tree
/api/fs/read
/api/fs/write
/api/fs/watch
/api/fs/changes
/api/fs/root
这些接口严格限定在工作区根目录内，仅本地访问；变更类接口同源校验。
安装与启用¶
安装命令：
dsh plugin --profile web add dsh-desktop-tools
安装后启动：
dsh web
插件会自动获取桌面宿主并打开桌面窗口。若需关闭自动开窗：
dsh web --no-desktop
插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
典型用法¶
下面介绍几个可直接复现的用法。
1、打开环境面板：使用 Ctrl+Shift+P 或托盘/菜单，查看宿主状态、运行时、平台兼容和计费摘要。
2、打开代码编辑器：使用 Ctrl+Shift+E 或托盘/菜单，在工作区内浏览和编辑文件。
3、切回对话视图：在代码视图顶部点击「对话 / 代码」切换，或按 Ctrl+B。
4、保存文件：编辑完成后按 Ctrl+S；未保存文件会有标记，状态栏显示路径、语言、行列。
5、切换项目：运行时切换工作区根目录，打开其它项目，无需重启。
6、网络异常处理：网络不可用时插件照常工作，只是暂不打开桌面窗口；之后可在面板点击“重新获取宿主”。
适用场景与注意¶
适合需要把 dsh web 接入桌面窗口、统一查看环境状态并编辑工作区文件的开发者。
使用注意：
- 平台兼容自动适配中，
autoApplyPatches仅win32生效，非 Windows 自动跳过； - 代码编辑器默认根目录为 dsh 工作区；如需改变范围，使用
editorRoot； - 文件 API 仅访问工作区根目录内，变更类接口同源校验；
- 无法定位 dsh 安装时，更新与适配会提示“未定位到 dsh 安装”，但计费、编辑器与页面功能不受影响；
- 插件以当前 dsh 进程权限运行，安装前应检查源码与 MIT 许可证。
结尾¶
dsh-desktop-tools 把桌面窗口、环境面板、运行时管理、平台兼容适配、计费面板和代码编辑器放进同一个 dsh 插件里，适合在 dsh web 日常使用中使用。
GitHub 仓库：https://github.com/YUEEEEY/dsh-desktop-tools。
DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系；可在目录中搜索 dsh-desktop-tools。
