Skip to content

DeepSeek Harness-Setup-0.1.0

Latest
Latest

Choose a tag to compare

View all tags
@241793 241793 released this 16 Aug 11:14
· 11 commits to main since this release
0.1.0
47da584
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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、更新进度窗口、技能管理、技能市场、定时任务、会话修复
Assets 3
Loading