更新测试中，有bug和想法欢迎大家反馈呀

dsh 简易封装

一个很轻的 Electron 壳，把 dsh web 套进桌面窗口里，省得自己开浏览器。

在窗口右上角有一个鲸鱼图标按钮，点击可展开控制面板（右侧滑出，不占用原界面）。

安装

方式一：zip 便携版

从 GitHub Releases 下载 dsh 简易封装-*-win.zip，解压后双击 dsh 简易封装.exe 即用，不用安装。

方式二：安装程序

从 GitHub Releases 下载 dsh 简易封装 Setup X.X.X.exe，双击安装，会创建桌面快捷方式。

方式三：源码运行

setup.cmd    装依赖
start.cmd    启动窗口
update.cmd   手动更新 dsh 到最新版

控制面板（右上角鲸鱼按钮）

点右上角鲸鱼图标展开右侧面板：

• 用量：会话数、工作区数、会话文件数、占用空间
• Skill：列出 ~/.dsh/skills 下的技能，可勾选启用 / 禁用
• 插件：列出当前 profile 加载的插件，可勾选启用 / 禁用

切换 Skill / 插件后需重启 dsh 生效。

自动更新

启动后每 3 小时检查一次 @deepseek-ai/dsh 版本。有新版本时窗口右下角出现带红点的鲸鱼角标，点击确认后自动更新并重启。

隐私说明

• 不包含任何模型配置、API Key、会话数据
• 打包产物只有壳代码 + dsh 运行依赖，你的 ~/.dsh（配置/凭据/会话）始终留在本机
• 应用运行时读取你系统环境变量里的 OPENCODE_GO_API_KEY 等，不会写入包内

首次运行

dsh 首次启动需要在 ~/.dsh 创建符号链接，要求已开启 Windows 开发者模式。 未开启时应用会弹出引导，可一键开启（需管理员权限，弹 UAC 确认一次）。

从源码打包

build.cmd    打包（生成安装程序和 zip 便携版到 dist\）

环境变量

变量	说明	默认
DSH_PORT	dsh web 端口，0 表示随机	0
DSH_HOST	dsh web 监听地址	127.0.0.1
DSH_NODE	指定用于运行 dsh 的 node 路径	自动探测
DSH_HOME	dsh 数据目录（默认 ~/.dsh）	自动探测

目录结构

main.js                 主进程（拉起 dsh + 内嵌窗口 + 更新检查 + 面板数据）
preload.js              注入更新角标 + 右侧控制面板
loading.html            启动加载页
setup.cmd / start.cmd / update.cmd / build.cmd
scripts/gen-icon.mjs    鲸鱼图标生成
scripts/download-node.ps1  便携 Node 下载
build/                  图标资源（打包用）
dist/                   打包产物
portable-node/          便携 Node（运行时生成，不入库）

原理

main.js 用便携 Node（版本不足时自动探测系统 Node）以 --expose-internals 启动 node_modules/@deepseek-ai/dsh/lib/bin.js web，解析其监听地址后加载到 Electron 窗口。定期查询 npm registry 检查 dsh 更新，有新版本时通过 npm install @deepseek-ai/dsh@latest 更新并重启。

右侧控制面板通过 IPC 读取 ~/.dsh 下的 skill / 插件配置与会话统计，勾选后写回 ~/.dsh/profiles/web/cordis.patch.yml 或 skill 目录，不动 dsh 本体。

会话控制台侧栏

plugins/session-console/ 是 DSH 网页内的右侧「会话控制台」侧栏（dsh.client 双面插件）， 对当前对话使用的技能与工具提供快捷功能了解和启用管理：

• 技能：当前会话技能列表 + 功能说明 +「详情」全文；开关可拦截该技能的 skill 调用（按会话生效）
• 工具：当前会话工具目录 + 说明；开关可拦截该工具调用（核心工具保护，不可禁用）
• 插件：本次对话 define/run/stop/undefine 过的动态插件状态卡片 + 活动时间线

安装（永久，重启生效）

双击运行：

scripts\install-session-console.cmd

或手动两步：把 plugins/session-console 复制到 ~/.dsh/profiles/web/node_modules/dsh-session-console\，并在 ~/.dsh/profiles/web/cordis.patch.yml 的 - insert: 列表内加：

    - id: session-console
      name: dsh-session-console

然后完全重启 dsh，右侧栏自动出现。

动态版（即装即用、进程重启失效）源码见 plugins/session-console/dynamic/： 让助手用 cordis_define/cordis_run 安装即可，供快速试玩与调试。