DeepSeekHarnessGreen

DeepSeek Harness 桌面绿色整合版启动器

English | 中文

把 DeepSeek Harness（dsh）封装成双击即用的本地启动器：不用敲命令、不用单独装 Python / Node、不用手动开浏览器，整包拷走就能用。如同三军帐中一纸调令，点一下即可出征。

下载：GitHub Release ｜ Gitee Release（国内更快）｜ GitHub 仓库 ｜ Gitee 仓库

亮点速览

• ⚡ 双击即用：用 DSH_Launcher.exe（无需装 Python）或 start.bat，首次点一下「安装环境」即可自动就绪。
• 🖥️ 桌面版界面体验：默认以独立桌面窗口打开（内嵌 WebView2，完全脱离浏览器，像原生桌面 App 一样独立成窗）；也可一键切回原始 WebUI（用系统浏览器打开）。「桌面窗口 / 网页窗口」随时切换，默认方式可在设置里改。
• 🌱 绿色便携：Node、dsh、npm/pnpm 缓存、会话数据、临时文件全部在本目录 `runtime/`——不写用户主目录、不装系统、不写注册表；内置便携 Node/Python，下载国内镜像优先、连不上自动回退官方。整个文件夹拷到任意电脑即可继续用。
• 📦 内置 12 款实用插件：会话回退 / 导入、用量统计、文件浏览、清理归档、侧边栏、背景影画、Ollama 本地大模型接入、祖宗记忆库（跨会话自动记忆，v3 默认关闭）、用户规则注入（类似 TRAE 规则功能，v4 支持 WebUI 内编辑）、技能中心（左侧入口 + 官方/个人技能分组管理 + 聊天栏技能选择器）等，文有文臣、武有武将，各司其职（详见内置插件）。
• 🔁 两通道独立自更新：官方核心（dsh）与绿色版外围互不干扰，各查各的、各备各的；dsh 核心升级默认自动备份（可在常规设置关闭），失败给出手动地址，不丢你的设置与会话。
• 🏠 局域网远程访问：一键把服务绑定到 0.0.0.0 并自动放行 Windows 防火墙，手机 / 其它电脑可直接打开 WebUI。
• 🌐 中英双语界面：启动器右上角一键切换中文 / English，所有按钮、下拉框、弹窗、状态实时刷新，无需重启。语言偏好自动保存到 config.json。

快速上手（第一次使用）

1. 解压后双击 `DSH_Launcher.exe`（或 start.bat）；
2. 点 【安装环境】：自动下载便携 Node → 本地安装 dsh → 补齐内置 Python（需联网，几分钟，npm 进度逐行显示）；
3. 点 【启动服务】 → 自动打开独立桌面窗口（也可在启动器里切到网页窗口，用浏览器打开原始 WebUI）；
4. 网页里：设置 → 模型 → 填入 DeepSeek API Key，并选择工作区（让 AI 干活的文件夹）；
5. 之后每次：双击启动器 → 点【启动服务】即用。

之后即可直接在网页里与 DeepSeek 对话、让 AI 读写工作区文件、调用工具执行任务。

主要界面按钮

按钮 · 作用 安装环境 · 下载便携 Node + 安装 dsh + 补齐内置 Python 启动 / 停止服务 · 拉起 / 停止 dsh 服务（启动后按默认方式自动打开界面） 桌面窗口 / 网页窗口 · 手动打开界面：桌面窗口 = 内嵌 WebView2 独立窗口；网页窗口 = 系统浏览器打开原始 WebUI（默认方式可在设置里改） 检查更新 · 检测官方 dsh 最新版本（动态列出 npm 稳定版/预发布 + GitHub 全部 tag），更新前默认自动备份旧版（可在常规设置关闭） 检查绿色版更新 · 检测本绿色版外围（启动器/插件/文档）更新，由独立更新程序 DSH_Update.exe 完成覆盖安装并重启 插件管理 · 查看 / 搜索 / 安装 / 移除插件（npm + GitHub 官方话题页，也可装本地插件文件夹） 数据维护 · 服务停止后：恢复（取消归档）或永久删除归档会话 设置 · 镜像源、端口、局域网绑定等

无界面模式（可选）：python launcher.py --start / --stop / --purge-archived / --purge-session / --restore-session / --install-plugin 。

绿色整合与数据

• 全部本地化：便携 Node、dsh 包、npm 缓存、pnpm 存储、会话数据、临时文件，全在 runtime/ 下，不会产生 ~/.npm、~/.pnpm-store 等用户目录残留。
• 不污染系统：不装全局包、不改 PATH、不写注册表。
• 整目录迁移：停止服务 → 复制整个文件夹到新电脑 → 双击即用，会话记录跟着走（工作区路径不一致时在网页里重新选一下工作区即可）。
• 彻底卸载：直接删除整个文件夹，无残留。

轻量分发 zip：发布包不含 runtime/（不带已下载的环境），体积小；新机联网后由启动器自动下载 Node / Python / dsh，解压 → 点【安装环境】 → 点【启动服务】三步即可。

内置插件

全部为纯插件（不修改官方文件），与绿色版统一采用 Apache License 2.0 开源；安装方式：「插件管理 → 选择本地插件文件夹安装…」选 plugins，装完重启服务生效。

插件 · 一句话功能 dsh-file-browser · WebUI 内文件浏览 / 预览 / 右键把官方 @引用、路径或内容塞进对话 dsh-archive-purge · WebUI 查看已归档会话（清理归档只读页） dsh-session-rewind · 会话被工具崩溃"毒化"时，一键回退到某可行回合派生干净续聊 dsh-session-import · 把导出的会话 ZIP / JSONL 导回本机（与官方导出互逆） dsh-usage-stats · 用量统计 + 每条消息的「本次 token / 预估费用」 dsh-sidebar-extend · 官方右侧栏 tab 类型插件（默认启用）：接管官方文件树（任意路径上溯 / 路径框跳转 / 右键 @引用·编辑·另存为·复制路径）+ 新增文本编辑 tab。不再自建侧栏外壳，折叠/分栏/浮窗/持久化全由官方容器负责 dsh-sidebar-lite · 旧版侧栏（仅对比用，默认停用）：自建完整右侧面板（文件浏览/预览编辑/内嵌浏览器/CMD 终端/后台任务），不接入官方右侧栏容器 dsh-media-background · 本地目录视频作为 WebUI 背景播放（画面 + 声音） dsh-ollama · 自动识别本机 Ollama 服务并接入，模型选择器直接选 Ollama 模型对话 dsh-memory · 祖宗记忆库：把对话关键信息沉淀到 SQLite，下次对话自动召回注入 system prompt。v3 加【测试】标签 + 默认关闭（省 token）+ WebUI 开关 + 记忆类型分类。规则提炼引擎零 LLM 成本，自动过滤寒暄套话思考过程。 dsh-rules · 用户规则注入：类似 TRAE 规则功能，编写个人偏好 / 代码风格 / 沟通要求的 markdown，每次对话自动注入 system prompt。v4 升级为双端插件，支持 WebUI 内直接编辑（预览 + textarea + 下载 .md 备份）+ 默认关闭。 dsh-skill-center · 技能中心：左侧栏「技能」入口 + 聊天输入框「技能」选择器（点选插入 /name，不用手打斜杠）；官方技能只读、个人技能独立管理（新建 / 导入 ZIP（可含多个技能）/ 粘贴路径 / 编辑 / 停用 / 删除进回收站），支持把 ZIP 拖到页面导入，个人技能存 runtime/dsh-home/skills，与官方技能分开。

各插件详细用法见 plugins//README.md。

数据维护（恢复 / 永久删除归档会话）

dsh 官方没有"永久删除会话"和"取消归档"功能——网页里的"归档"只是把会话隐藏（日志全保留）。本启动器在停止服务后直接操作本地数据，做到：

• 恢复（取消归档）：会话重新出现在列表，日志与内容不受影响（召回放逐的武将，既往不咎）；
• 永久删除：彻底删除日志 + 注册表条目，不可恢复（削籍夺职，永不叙用）。

入口：主窗口「数据维护 → 会话管理」，勾选会话后点「恢复选中 / 删除选中」。

双通道独立更新

两条完全独立、互不干扰的更新通道：

通道 · 更新对象 · 入口 · 更新源 官方核心 · dsh 本体（npm 包） · 「检查更新」 · 官方 npm / GitHub（动态检测所有标签） 绿色版外围 · 启动器 / exe / 插件 / 文档 · 「检查绿色版更新」 · GitHub Release（连不通自动转 Gitee 镜像）

核心更新只动 runtime/dsh/，外围更新只动程序根目录并跳过 `config.json` 与 `runtime/`（你的设置与会话数据不被动）；覆盖前旧文件自动备份到 runtime/update/backup/，新版有问题可手动复制回退。

局域网远程访问

主窗口「网络设置」→ 服务绑定选 局域网 (0.0.0.0) → 保存并【启动服务】，就绪日志会显示 局域网访问地址: http://:3080，其它电脑/手机打开即可使用。受信任主机不填 = 自动信任全部局域网 IP；填了只信任填写的地址。凭据（API Key）类特权操作仍仅本机可改，属官方安全保护。本机模式（默认 127.0.0.1）与以往完全一致。

常用设置（镜像源 / 端口 / 局域网）也可在 config.json 里改：mirror（auto/cn/official）、dsh_port、dsh_host、trusted_hosts。

常见问题

问题 · 处理 提示找不到 Python · 内置便携 Python 缺失且下载失败（多为网络问题），按 start.bat 提示手动装 Python 3 勾选 Add to PATH 兜底 下载 Node / 安装 dsh 慢 · 界面设置把镜像源切到「国内」或「官方」再试（默认已 mirror=cn） 端口被占用 · 设置里改端口（如 3090）后保存重启动 shell 工具报 Windows ACL temp root must be outside the workspace · 该会话工作区包含了 runtime/tmp；开新会话时在工作区选择器里选 workspace 目录（启动器会自动预置） 网页打不开 · 看 runtime/server.log；确认防火墙没拦 127.0.0.1 设置 API Key 报 EPERM: rename denied · 偶发，属安全软件实时扫描冲突，重试一次即可；频繁出现则把目录加入安全软件白名单 绿色版更新失败 · 更新程序会弹窗给出手动下载地址（GitHub / Gitee 发布页 + 直链），解压后覆盖到程序根目录（不要覆盖 config.json 与 runtime/）

开源协议

本绿色版整体（启动器 launcher.py、绿色版外壳、内置插件）统一采用 Apache License 2.0：Copyright (c) 2026 LiuJunheng，协议副本见 LICENSE，绿色版 zip 已随包附带。运行时依赖（@deepseek-ai/dsh、Node.js、便携 Python 等）为各第三方项目自己的许可证，仅在本地运行时目录内安装使用，不随源码分发。

DSH 经验 Skill

本项目部署 / 维护 / 插件开发经验已沉淀为 TRAE Skill `dsh-deploy-maintain`（源文件在 skills/dsh-deploy-maintain/，含 51 条避坑速查），已安装到 TRAE 全局 skills，新会话可直接使用。