作者：7DGroup

DeepSeek Harness（dsh）的 Windows 专属系统托盘插件。在 dsh web 运行期间，系统托盘会自动出现 DeepSeek 鲸鱼图标；服务停止后，托盘图标 3 秒内自动消失——托盘与服务同生命周期。同时自动维护一个静默桌面启动器 DSH.lnk，双击即可无窗口启动服务并打开浏览器。

---

📌 项目信息

字段	值
作者	7DGroup
版本	0.1.0
运行平台	Windows 10/11（win32；其他平台自动跳过）
运行时	Node ^22.19.0 || >=24.0.0 · pnpm 10+ · dsh CLI
插件名称	tray-7d-win
Peer dependency	@deepseek-ai/cordis ^4.0.1
仓库	github.com/7dgroup-ai/dsh-7d-tray-win
许可证	MIT

🖼️ 插件效果

运行 dsh web 后，系统托盘区将出现 DeepSeek 鲸鱼图标，同时桌面会自动生成 DSH.lnk 快捷方式：

• 双击图标：打开 http://127.0.0.1:3080
• 右键菜单：打开 DSH Web / 打开日志文件夹 / 退出（停止服务）

服务退出（含崩溃）后，托盘图标与托盘代理进程自动消失。

✨ 核心功能

• 托盘图标：官方 DeepSeek 鲸鱼标志；双击打开 Web UI，右键菜单支持打开日志、退出服务。
• 生命周期同步：无论通过桌面快捷方式、命令行还是脚本启动 dsh web，托盘都会自动出现；服务退出后托盘 3 秒内自动消失。
• 静默桌面启动器：自动维护桌面 DSH.lnk，双击后无任何窗口，服务在后台启动并自动打开浏览器。
• 自带干净启动链：内置 PowerShell 启动脚本与 npmmirror 镜像源配置，避免宿主环境变量污染，国内网络也可正常启动。
• 零核心改动 / 官方升级无影响：纯 Cordis 组合层插件，仅通过 cordis.patch.yml 在 profile 组合层中插入一行；不覆盖、不修改 DSH 官方包内的任何文件。执行 dsh plugin remove 即可恢复原始状态；只要 Cordis 生命周期保持兼容，升级 DSH 官方版本不会与本插件产生冲突。

✅ 功能清单

• ✅ Windows 系统托盘自动显隐
• ✅ 双击托盘打开 Web UI
• ✅ 右键菜单：打开 DSH Web / 打开日志文件夹 / 退出
• ✅ 服务停止后托盘自动清理
• ✅ 静默桌面启动器 DSH.lnk 自动维护
• ✅ 首次启动时自动编译 .NET 启动器（需 .NET Framework 4）
• ✅ 每次启动自动刷新插件携带的最新资源
• ✅ 非 win32 平台自动跳过，不报错

📂 项目结构

dsh-7d-tray-win/
├── assets/                         # 随包发布的资源文件
│   ├── DSH.ico                     # 托盘图标
│   ├── tray-agent.ps1              # 托盘代理脚本
│   ├── starter.ps1                 # dsh web 启动链脚本
│   ├── starter-launcher.cs         # 静默桌面启动器源码
│   └── make-shortcut.ps1           # 桌面快捷方式维护脚本
├── lib/                            # 运行时入口
│   └── index.js                    # Cordis 插件：托盘控制逻辑
├── cordis.patch.yml                # 组合层补丁
├── package.json
├── LICENSE
├── README.md
└── README.zh.md

🚀 快速开始

环境要求

• Windows 10/11（win32）
• Node.js ^22.19.0 || >=24.0.0
• pnpm 10+
• .NET Framework 4（系统自带，用于一次性编译静默启动器）
• PowerShell（系统自带）

安装到 web profile（推荐）

大多数会话默认启动 web profile（dsh web 是 dsh --profile web 的简写），因此推荐直接安装到 web profile：

dsh plugin --profile web add @7dgroup/dsh-7d-tray-win

或从本地路径安装（开发/测试时）：

dsh plugin --profile web add C:\path\to\dsh-7d-tray-win

安装后启动 dsh web，托盘图标与桌面快捷方式即自动生效。

安装到其他 profile

如果你使用自定义 profile，请将上述命令中的 web 替换为对应的 profile 名称。插件只在它被安装到的 profile 中生效。

💡 使用说明

托盘图标交互

操作	行为
双击图标	打开 http://127.0.0.1:3080
右键 → 打开 DSH Web	打开 http://127.0.0.1:3080
右键 → 打开日志文件夹	打开 %LOCALAPPDATA%\dsh-7d-tray-win\
右键 → 退出	停止 dsh web 服务并关闭托盘

静默桌面启动器

插件首次启动时会编译 starter-launcher.cs 为 starter-launcher.exe，并生成/刷新桌面 DSH.lnk。此后：

• 双击桌面 DSH.lnk → 无任何窗口弹出
• dsh web 在后台启动
• 浏览器自动打开 http://127.0.0.1:3080
• 系统托盘出现 DeepSeek 鲸鱼图标

📁 运行时目录

所有运行资源与日志存放在 %LOCALAPPDATA%\dsh-7d-tray-win\：

文件	用途
DSH.ico	托盘图标
tray-agent.ps1	托盘代理脚本
starter.ps1	dsh web 启动链脚本
starter-launcher.cs	静默启动器源码
starter-launcher.exe	编译后的静默启动器
make-shortcut.ps1	快捷方式维护脚本
dsh-launch.log	服务启动链日志（npx/dsh 输出）
tray-agent.log	托盘代理生命周期日志
plugin-debug.log	插件 apply/spawn/卸载调试日志

每次服务启动时，插件都会将携带的最新资源刷新到该目录。

⚠️ 注意事项

1. Windows 专属：插件在检测到非 win32 平台时会自动跳过，不会安装托盘或报错。
2. 首次编译：首次运行需要 .NET Framework 4 编译静默启动器；若缺少 csc.exe，桌面快捷方式功能将不可用，但托盘功能不受影响。
3. 启动器无托盘：DSH.lnk 本身不显示托盘；托盘由本插件在 dsh web 运行时提供。
4. 资源刷新：每次 dsh web 启动都会覆盖 %LOCALAPPDATA%\dsh-7d-tray-win\ 下的资源文件为插件携带的最新版本，请勿在该目录中存放需要持久化的自定义文件。
5. 端口固定：双击托盘图标固定打开 http://127.0.0.1:3080，请确保 dsh web 服务监听在该地址。
6. 官方版本升级无影响：本插件是纯 Cordis 组合层插件，不覆盖、不修改 DSH 官方包内的任何文件；只要 Cordis 生命周期保持兼容，升级 DSH 官方版本不会破坏本插件。
7. 建议单实例运行：所有运行中的实例共享运行时目录 %LOCALAPPDATA%\dsh-7d-tray-win\ 与桌面快捷方式 DSH.lnk；若同时运行多个 dsh web 实例，后启动的实例会覆盖共享文件，请同一时间只运行 1 个实例。

❓ 常见问题

Q: 安装时提示找不到 pnpm？
A: dsh plugin 会调用 pnpm 安装依赖，请确保 pnpm 已安装并在 PATH 中：

npm install -g pnpm@10

Q: 托盘图标没有出现？
A: 请确认：

• 当前系统为 Windows 10/11；
• 插件安装到了你实际启动的 profile（默认是 web）；
• dsh web 已成功启动；
• 查看 %LOCALAPPDATA%\dsh-7d-tray-win\plugin-debug.log 与 tray-agent.log 排查错误。

Q: 桌面快捷方式没有生成？
A: 检查 %LOCALAPPDATA%\dsh-7d-tray-win\plugin-debug.log 中是否有 csc.exe not found 或 launcher compile failed 日志。首次运行需要系统自带 .NET Framework 4。

Q: 如何卸载？
A: 运行：

dsh plugin --profile web remove @7dgroup/dsh-7d-tray-win

然后可手动删除 %LOCALAPPDATA%\dsh-7d-tray-win\ 与桌面 DSH.lnk。

Q: 可以在非 win32 平台安装吗？
A: 可以安装，但插件会自动跳过，不会创建托盘或快捷方式。

Q: 升级 DSH 官方版本会影响本插件吗？
A: 不会。本插件是纯 Cordis 组合层插件，仅向 profile 的 cordis.patch.yml 添加一行；不覆盖、不修改 DSH 官方包内的任何文件。只要 Cordis 生命周期保持兼容，官方版本升级后本插件继续生效。

📄 许可证

MIT · Copyright © 2026 7DGroup