其他技能

DeepSeekHarnessGreen

LiuJunheng/DeepSeekHarnessGreen

DeepSeek Harness绿色整合版，一键安装启动，不污染C盘，一个文件夹里管理，自动更新。DeepSeek Harness Green All-in-One Launcher - double-click to run, all-localized

查看仓库项目主页

Stars: 16
Forks: 3
Issues: 0
更新: 9 天前

PROJECT TOPICS

项目标签

ai ai-agents ai-tools dsh dsh-desktop dsh-plugin dsh-skill

INSTALL REFERENCE

安装参考

未验证

dsh plugin --profile web add github:LiuJunheng/DeepSeekHarnessGreen

在 DSH 中安装

该命令指向仓库当前默认分支；尚无绑定当前 commit 的完整验证结果。

PROJECT README

README

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，下载国内镜像优先、连不上自动回退官方。整个文件夹拷到任意电脑即可继续用。
📦 内置 10 款实用插件：会话回退 / 导入、用量统计、文件浏览、清理归档、侧边栏、背景影画、Ollama 本地大模型接入、祖宗记忆库（跨会话自动记忆，v3 默认关闭）、用户规则注入（类似 TRAE 规则功能，v4 支持 WebUI 内编辑）等，文有文臣、武有武将，各司其职（详见内置插件）。
🔁 两通道独立自更新：官方核心（dsh）与绿色版外围互不干扰，各查各的、各备各的；更新前自动备份、失败给出手动地址，不丢你的设置与会话。
🏠 局域网远程访问：一键把服务绑定到 0.0.0.0 并自动放行 Windows 防火墙，手机 / 其它电脑可直接打开 WebUI。
🌐 中英双语界面：启动器右上角一键切换中文 / English，所有按钮、下拉框、弹窗、状态实时刷新，无需重启。语言偏好自动保存到 config.json。

快速上手（第一次使用）

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

之后即可直接在网页里与 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 <ID> / --restore-session <ID> / --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 备份）+ 默认关闭。

各插件详细用法见 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://<本机IP>: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，新会话可直接使用。

CLASSIFICATION EVIDENCE

分类依据

项目类型技能

功能分类其他

规则置信度中

系统优先读取 GitHub Topics，再与站内分类词典和词根规则比对。当前命中： dsh-skill。