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，下载国内镜像优先、连不上自动回退官方。整个文件夹拷到任意电脑即可继续用。 📦 内置 13 款实用插件：会话回退 / 导入、用量统计、文件浏览、清理归档、侧边栏、背景影画、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 读写工作区文件、调用工具执行任务。 主要界面按钮 无界面模式（可选）：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\ ，装完重启服务生效。 各插件详细用法见 plugins/ /README.md。 数据维护（恢复 / 永久删除归档会话）

dsh 官方没有"永久删除会话"和"取消归档"功能——网页里的"归档"只是把会话隐藏（日志全保留）。本启动器在停止服务后直接操作本地数据，做到： 恢复（取消归档）：会话重新出现在列表，日志与内容不受影响（召回放逐的武将，既往不咎）； 永久删除：彻底删除日志 + 工作区注册表条目 + 新旧两种投影缓存，不可恢复（削籍夺职，永不叙用）； 缓存残留（幻影会话）：升级过 dsh 后，个别早已删除的会话仍会在投影缓存里留下标题缓存（storages/session_projcache/sessions/session-*.json），它们没有日志、不属于任何工作区、在 WebUI 里也看不到。会话管理会把它们标成「缓存残留」，底部显示"共 N 个会话, 其中 M 个缓存残留"，勾选「删除选中」即可一并清除（2026-10-27 修复：此前只清旧版缓存，新版缓存漏删导致这类行删不掉；无标题的残留也已纳入列表）。

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

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

更新后内置插件会自动同步一次：外围更新完成、启动器重启后，会自动补装本版新增的内置插件、并把已装插件更新到随包源码（结果写在启动器日志里，不必自己记着去点「插件管理」）。判断依据是 runtime/last_run_version.txt 里记录的版本号 —— 所以手动下载 zip 解压覆盖这种更新方式同样会触发；同步失败会保留标记，下次启动自动重试。 局域网远程访问

主窗口「网络设置」→ 服务绑定选 局域网 (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。 常见问题 开源协议

本绿色版整体（启动器 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，新会话可直接使用。