DeepSeek Harness-Setup-0.1.0

DeepSeek Harness 桌面端 · v0.1.0 版本说明

发布日期：2026-08-18
安装包：dist\DeepSeek Harness-Setup-0.1.0.exe

---

一、本版本是什么

本版本是一个基于 Electron 的 DeepSeek Harness 桌面启动器：

• 双击即开，自动检测 Node.js / npm / dsh / 前端资源
• 缺组件时一键从 npmmirror 下载安装（免管理员权限）
• 启动后同一窗口直接进入官方 DeepSeek Harness Web UI
• 菜单栏提供「检查DSH更新」，支持一键更新并自动重启
• 菜单栏「帮助」旁提供「CC-TUI」终端修复
• 设置页集成：互联、插件市场、插件安装、技能、技能市场、定时任务、会话修复

---

二、本版本包含的功能

1. 基础启动器

• 单实例锁：重复双击只聚焦已开窗口
• 自动检测环境（Node ≥ 22.5.0、npm、dsh、Web 前端资源）
• 缺组件引导页：下载便携 Node、npm 安装 dsh、进度与日志实时显示
• dsh web --port 0 随机端口启动，退出自动清理进程树
• 检查 DSH 更新：npmmirror 获取最新版本 → 弹窗确认 → 更新 → 自动重启 dsh web
• 更新过程显示独立「DSH 更新进度」窗口，实时输出 npm 日志

2. CC-TUI 终端修复

• 检测 cc-tui / tui profile 是否真正安装了可用的 dsh-cc-tui
• 未安装或历史 dsh-tui 损坏时自动安装（优先 npmmirror，失败回退 GitHub tarball）
• 已安装时打开系统终端里的 dsh --profile cc-tui 交互界面
• 启动报错页也提供「CC-TUI 终端修复」入口

3. 互联（设置 → 互联）

• QQ Bot 渠道：
  • 一键安装官方 @tencent-connect/dsh-qqbot
  • 一键启动并扫码绑定
  • 显示已连接机器人：昵称 / Bot ID / AppID
  • 支持切换账号、卸载
  • 已绑定账号自动连接
• WxClaw 微信渠道（内置自研插件 dsh-wxclaw）：
  • 使用微信 ilink Bot API，扫码绑定微信账号
  • 微信发消息 → dsh 接收并回复
  • 支持 24 小时回复窗口（context_token）
  • 支持切换账号、卸载、自动连接

4. 插件市场（设置 → 插件市场）

• 从 dshplugin.store 拉取插件列表
• 搜索、分类筛选、已安装筛选
• 插件卡片显示名称/作者/介绍/star/分类
• GitHub 按钮打开源码仓库
• 一键安装 / 卸载，日志弹窗显示，完成后自动重启 dsh web 生效
• client-only 插件自动写入 profile 入口行，确保被 dsh 识别

5. 插件安装（设置 → 插件 → 插件安装 Tab）

• 本地导入：选择插件文件夹自动安装到 dsh 插件位置
• 链接安装：输入 GitHub 等链接 → 查看插件信息 → 下载安装（不依赖 git）
• 本界面安装列表：查看 / 删除已安装插件
• 安装记录持久化在 ~/.dsh/plugin-install-history.json

6. 技能管理（设置 → 技能）

• 已安装：列出当前可发现的 skill，支持删除用户 ~/.dsh/skills 下的技能
• 安装：
  • 本地导入：选择 SKILL.md 文件夹或单个 .md 文件
  • 从链接安装：GitHub 仓库自动扫描并安装技能
• 技能市场：
  • 支持自定义市场源（如 https://github.com/anbeime/skill/tree/main/skills）
  • 自动拉取技能列表、描述、适用场景、附加信息
  • 支持查看详情和下载安装
  • 市场源保存在 ~/.dsh/skill-market-source.json

7. 定时任务（设置 → 定时任务）

• 支持新建 / 编辑 / 删除 / 启用 / 禁用 / 立即运行
• 任务配置：名称、执行频率（间隔 / 每天 / 每周 / 单次）、提示词、模型、权限、指定技能、前置脚本
• 使用 dsh headless 模式执行：dsh --profile headless --patch <临时配置> "提示词"
• 运行记录和完整日志保存在 ~/.dsh/scheduled-task-runs.jsonl，支持查看和删除
• 应用启动时自动写入说明 skill，让 dsh 知道桌面端具备定时任务功能

8. 会话修复（设置 → 会话修复）

• 自动扫描 ~/.dsh/sessions 下所有 session.jsonl.zstd
• 检测历史记录中的 seq 重复 / 乱序
• 一键修复：自动备份、删除重复/乱序记录、重新压缩并校验
• 修复脚本内置于应用，运行时释放到 userData 目录，依赖本机 Python + zstandard

9. 图标与打包

• 统一使用 assets/icon.ico（Windows 多尺寸）与 assets/icon.png
• 应用 exe、安装包 exe、桌面/开始菜单快捷方式均已内嵌指定图标
• NSIS 安装包：可选安装目录、创建桌面/开始菜单快捷方式、注册表卸载信息
• 免安装版：dist\win-unpacked\DeepSeek Harness.exe

---

三、安装与使用

1. 运行 DeepSeek Harness-Setup-0.1.0.exe 完成安装
2. 双击桌面「DeepSeek Harness」启动
3. 首次启动若缺组件，点「下载并安装」
4. 进入 Harness 界面后：
   • 设置 → 互联：管理 QQ Bot / WxClaw 渠道
   • 设置 → 插件市场：浏览 / 安装 / 卸载市场插件
   • 设置 → 插件 → 插件安装：本地导入 / 链接安装插件
   • 设置 → 技能：管理 / 导入技能，使用技能市场
   • 设置 → 定时任务：创建和管理定时任务
   • 设置 → 会话修复：修复损坏的历史记录

---

四、数据目录

数据	位置
dsh profile / 会话	C:\Users\<用户名>\.dsh
应用自管运行时	<Electron userData>\runtime\
插件 tarball	~\.dsh\plugin-tarballs\
插件安装历史	~\.dsh\plugin-install-history.json
技能	~\.dsh\skills\、~\.agents\skills\
技能市场源	~\.dsh\skill-market-source.json
定时任务配置	~\.dsh\scheduled-tasks.json
定时任务运行记录	~\.dsh\scheduled-task-runs.jsonl
会话修复脚本	<Electron userData>\session-repair\session-repair.py

---

五、已知问题与说明

1. SmartScreen 提示：安装包未做代码签名，首次运行需点「更多信息 → 仍要运行」。
2. 插件市场首页较大：dshplugin.store 首页约 6MB，网络慢时加载需要等待；失败会自动用 sitemap 兜底。
3. Windows 图标缓存：若快捷方式图标未刷新，注销重登或重启电脑即可（exe 与安装包已内嵌正确图标）。
4. WxClaw 接口：使用微信 ilink Bot 官方接口（https://ilinkai.weixin.qq.com），请合规使用。
5. 会话修复依赖 Python：需要本机安装 Python 且包含 zstandard 模块，否则「会话修复」页面无法使用。
6. 定时任务仅应用运行时触发：DeepSeek Harness 桌面端关闭时，定时任务不会执行。
7. connect.html / connect.js：为历史遗留的独立互联中心窗口，当前菜单已不提供入口，主要使用 Web UI 内的「互联」页。

---

六、开发与构建

cd D:\Python\开发\harness
npm install        # 国内可先设置 ELECTRON_MIRROR 与 registry 镜像
npm start          # 开发运行

npm run dist       # 打包 NSIS 安装包到 dist\

当前环境因沙箱限制，也可使用内置 NSIS 直接构建：

"C:\Users\24179\AppData\Local\electron-builder\Cache\nsis-3.0.4.1\nsis-3.0.4.1-1mx3n\Bin\makensis.exe" installer.nsi

---

七、版本记录

版本	日期	说明
v0.1.0	2026-08-16	首个可用版本：基础启动器、互联、插件市场、插件安装、检查DSH更新、统一图标
v0.1.0（增强版）	2026-08-18	修复 CC-TUI、更新进度窗口、技能管理、技能市场、定时任务、会话修复