Skip to content

Releases: SparkElf/deepseek-harness-plus

DeepSeek Harness Plus 0.6.3

Choose a tag to compare

@SparkElf SparkElf released this 08 Sep 17:58
27e01bc

DeepSeek Harness Plus 0.6.3

面向普通Windows用户的安装修复版本。

下载

  • Windows x64:DeepSeek.Harness.Plus.Setup.0.2.0-rc.5.exe

GitHub自动提供Source code (tar.gz)Source code (zip)

主要变化

  • 安装向导检测、安装或复用系统Git、Node.js/npm和pnpm,并记录实际路径。
  • 版本冲突时可更新推荐版本,或保留现有版本并行安装。
  • 中文安装优先大陆下载源,失败后切换官方源。
  • Windows native fs-ext由CI预编译,不要求用户安装node-gyp、Python或Visual Studio Build Tools。
  • 安装包不内嵌完整开发工具,Windows exe约115MB。

版本对应

  • Desktop:0.2.0-rc.5
  • Plus profile:@sparkelf/dsh-plus@0.1.0-rc.22
  • Official source:d347e703908d0406b7a7ef80e3a0e594d86b2215

安装器尚未签名,Windows可能显示SmartScreen提示。

安装器SHA-256:bf5f3389793345608372b10c58ebe08d1938dc81a55cd87dfefc4979fa8708bf

DeepSeek Harness Plus 0.6.1

Choose a tag to compare

@SparkElf SparkElf released this 08 Sep 04:03
27e01bc

DeepSeek Harness Plus 0.6.1

面向普通用户的 Desktop 安装版本。

下载

  • Windows x64:DeepSeek.Harness.Plus.Setup.0.2.0-rc.3.exe

GitHub 自动提供 Source code (tar.gz)Source code (zip)

版本对应

  • Desktop:0.2.0-rc.3
  • Plus profile:@sparkelf/dsh-plus@0.1.0-rc.22
  • Official source:d347e703908d0406b7a7ef80e3a0e594d86b2215

安装说明

安装器内含独立 Node runtime、pnpm 和已审阅的 Plus 闭包。首次安装需要本机已安装 Git,并需要访问 GitHub 和 npm。安装器未签名,Windows 可能显示 SmartScreen 提示。

安装器 SHA-256:8c11c75580be7dfe6224369adb1c14c34404d54b89267df4f97544bc676b1973

完整变更与验证记录:#132

DeepSeek Harness Plus 0.6.0

Choose a tag to compare

@SparkElf SparkElf released this 05 Sep 10:36
675c95c

DeepSeek Harness Plus 0.6.0

版本定位

这是正式产品序列中继 DeepSeek Harness Plus 0.5.0 之后的 0.6.0 版本。变更范围严格按 plus-v0.5.0..675c95c1aa 整理,不再使用 Workspace UX 的独立版本号替代 Plus 产品版本。

重要分发变化

0.5.0 的单体 Electron 安装器工作流已在本周期移除。Supervisor 与可选托盘桌面端现在由独立包维护:

  • Supervisor:@sparkelf/dsh-plugin-supervisor@0.1.1
  • 可选 Electron 托盘:@sparkelf/dsh-plus-desktop@0.1.1
  • Plus profile:@sparkelf/dsh-plus@0.1.0-rc.14

因此本 Release 不伪造或附带已经退出维护链的 exe/AppImage/deb;附带的是当前部署使用的兼容客户端包、精确版本 manifest、校验值和桌面/移动视觉证据。

从 0.5.0 升级的完整变化

1. 移动端与 Composer

  • Composer toolbar 在窄屏和手机上保持单行,不再把模型与发送区换到第二行;320px真实Session通过≤340px专用2px gap消除最后2px横向overflow。
  • 模型触发器按容器宽度逐步降级:完整模型与推理等级、仅模型名、Think 图标与 chevron。
  • 模型名支持省略,完整模型和推理等级始终保留在 aria-label 与 hover title。
  • 640px 及以下模型菜单Portal到 document.body,绕开Composer祖先裁剪;菜单使用border-box、最大240px外框和可收缩行,完整显示“模型/推理等级”,不再越出视口。
  • 恢复此前已验收的移动Settings:首页为全屏单列导航,详情页独占内容区并提供返回操作,safe-area和字号/主题控件不再被桌面双栏挤压。
  • Session Header新增专用context slot:桌面保持标题、上下文、完整任务计数的原顺序,Session Log只在轨迹toolbar;移动端才把任务/调度放到tab行并压成图标,Session Log为28px图标。
  • 移动carrier重连时,恢复generation会丢弃opening snapshot之前的缓存entry,并以权威snapshot重建窗口;初次打开、重复/倒退cursor、断裂和重叠仍严格报错。
  • 修复command-only New Session后欢迎视图恢复、移动模型选择溢出和Hero workspace/preset窄屏布局。

2. Welcome、权限与中文体验

  • permission-only操作保持在欢迎页,不再错误进入对话视图。
  • 权限preset、Full access确认、Session log与工具栏顺序完成中文化和一致化。移动权限菜单在≤800px使用共享Menu的compact body Portal:418/320px均为164×84、26px/12px行并位于viewport内;桌面保持218×130、40px/14px和原地定位。
  • 新增通用 conversation.hero.brand.nameconversation.hero.brand.badge Slot;官方DeepSeek fallback保持不变。
  • DataOps workspace可通过Slot应用万相Logo、字标、title、favicon并隐藏Preview badge,不依赖DOM或哈希CSS。

3. Plus发布与依赖治理

  • Plus npm闭包推进到23成员rc14,并建立可重复打包、dist-tag推广、manifest对比和公开发布审计。
  • GenUI固定到可应用补丁的精确版本,避免新安装解析到不兼容版本。
  • Browser Auth策略拆成独立data patch:官方Web保持认证,Plus profile可显式关闭整页token/cookie门禁,同时保留Host/Origin约束。
  • Supervisor和Desktop移出Plus npm传递依赖,Supervisor由profile唯一拥有,可选Desktop独立发布。
  • 修复release manifest比较、产物diff、废弃rc审计、插件ownership和清洁分支集成。
  • 新增production profile closure gate:fingerprint运行时JS/CSS/JSON/YAML/WASM和package manifest;同版本不同内容、未声明包变化、能力marker缺失或bundle缺失都会阻止promotion。
  • Plus patch governance改为在manifest声明的baseRevision临时worktree验证,不再错误地对当前master执行apply check;新增强制promotion runbook。

4. Sidebar、Univer与文件工作流

  • Better Sidebar 0.18.1支持显式预览workspace外文本、媒体和sandboxed HTML;文件树和所有写入仍受workspace fence控制。
  • 恢复alpha.2下的Sidebar文件打开路径,移除旧 workspaces.openPath 依赖。
  • Univer支持授权模板文件创建、可信只读模板根、外部字体预加载和非致命Viewer fallback。
  • Univer Office 0.2.14保持已关闭预览状态:切换会话或发送新消息不会全量重放旧预览,仅新Univer操作打开自己的文件。
  • Univer Host兼容当前DSH Settings API,不再导入部署运行时缺失的 settingsNamespace helper。

5. Plus插件与工作台闭包

  • Mobile Bridge 0.2.10
  • Settings Backup 0.1.0-rc.14
  • Document Attachments 0.1.0-rc.14
  • Subagent Settings 0.1.0-rc.14;Plus patch通过禁用的根client carrier加载Web入口,两条startup节点继续唯一拥有Host settings schema,不重复注册工具
  • Better Sidebar 0.18.1
  • Univer Office 0.2.14
  • SSH Manager 0.6.0:title-free资源树、主机/集群右键菜单和键盘操作
  • SQL Workbench 0.4.0
  • API Client 0.4.2

DataOps Managed 0.3.0只进入DataOps workspace image,不进入标准Plus profile。最终镜像为 dataops-ai-workspace:workbench-ui-0.6.0-wanxiang-675c95csha256:64437f48113dc5c6f6961576a3202a8d6622776e7fa2edb8f3f3bac6b6d45a4f),并同步更新 dataops-ai-workspace:local。镜像以原健康万相镜像为基底,只覆盖与3080同checksum的9个immutable包;原source-ref保留,overlay明细记录在镜像内 .plus-0.6.0-overlay.json。现有DataOps容器未强制重建。

6. CI与发布可靠性

  • 增量CI、PR路径选择、public runner容量、Windows native/Wine和release-shaped Python runtime矩阵完成收敛。
  • 修复PowerShell headless PTY readiness、浏览器认证策略、Viewer字体fallback和插件补丁应用验证。
  • Core required checks覆盖Linux、Windows、macOS、Node 22/24/26、静态门禁、npm打包和release-shaped runtime。

完整first-parent合并清单

  • #41 修复Supervisor官方客户端构建
  • #42 人工审阅视觉完善
  • #43 增量影响分析CI
  • #45 PR workflow路径规则
  • #48 移动模型选择溢出
  • #91#93#116#117 活跃分支和最终工作树集成/清理
  • #96 欢迎页权限控制与中文体验
  • #97 官方Plus插件候选
  • #98#102#106 Plus npm rc9/rc10/rc11发布线
  • #99#100#101#103#104#105 npm发布审计、diff、manifest、dist-tag和废弃rc治理
  • #107 Browser Auth policy patch
  • #111 Plus完整验收
  • #113 Univer模板文件与字体支持
  • #118#119#120 Supervisor/Desktop外部化和唯一profile ownership
  • #121 GenUI精确版本固定
  • #122 Sidebar文件打开与Viewer fallback
  • #123 可扩展欢迎页品牌Slot
  • #124 响应式Composer模型控制
  • #125 移动session重连与模型菜单边界
  • #126 恢复#53–#73已验收移动Web UI栈,并恢复Subagent Settings入口
  • #127 分离桌面/移动Header,恢复patched Composer/Session Log,并加入production closure门禁
  • #128 修复真实Session在320px下最后2px Composer overflow
  • #129 修复移动权限菜单桌面尺寸复用、越界和Composer祖先裁剪
  • #130 改为按Composer实际宽度响应,覆盖宽桌面中的窄Conversation列和手机端权限/模型菜单
  • #131 修复profile重建:patched workspace覆盖clean CLI包,Settings/Model纳入rc16 patch,完整声明SQL/SSH/API等bundle,并加入版本升级closure policy
  • dsh-plugins-plus #53/#54 新增Supervisor accepted-profile guard,systemd启动前验证860包runtime与patch payload,未accept的自动release会回退
  • 直接提交:command-only New Session欢迎视图恢复

验证

  • Core静态门禁:43/43
  • 移动重连与菜单定向测试:43/43
  • Composer定向测试:82/82
  • 双布局、Session Log与production closure定向测试:88/88
  • Production closure:11个关键package、10个声明变化、0个未声明变化;.patch/.diff进入fingerprint,支持精确baseline/candidate版本升级
  • 权限browser suite:4/4,模型browser suite:3/3;1000px桌面中的300px Composer和418/320手机均Portal且完整,宽桌面菜单保持原尺寸,browser errors 0
  • Settings与模型真实浏览器E2E:15/15;模型几何用例可独立运行
  • Web响应式Composer E2E:3/3
  • 完整Core生产构建:通过
  • Core全required CI:通过
  • 3080真实验收:桌面Session Log仅在轨迹toolbar、完整任务计数不受移动CSS影响;418/390/360/320px页面与Composer overflow均为0、row高42px、tabs水平、移动日志28px;浏览器错误0
  • 最终Supervisor切换恢复:1个Session成功,0失败
  • DataOps image browser smoke:title=万相数据平台 Harness、Preview隐藏、Subagents/DataOps Settings入口存在、418×820详情overflow 0、browser errors 0

运行版本

当前标准Plus profile:/root/.dsh/releases/plus/cc210df8be57ccc173661ab6b68aaa41c894e85b/profile

核心合并提交:675c95c1aa3fbd8365841c55193f090758913d13

Wanxiang Brand Slots 0.1.0

Choose a tag to compare

@SparkElf SparkElf released this 03 Sep 20:56
b1a02b9

Adds generic New Session brand-name and brand-badge slots with unchanged official fallbacks. Used by DataOps-managed workspace images to render the Wanxiang name and suppress the Preview badge without DOM or hashed-CSS coupling. Conversation tests, client catalog, static gates, Windows lanes, package matrix, and Web build passed.

DeepSeek Harness Plus 0.5.0

Choose a tag to compare

@SparkElf SparkElf released this 21 Aug 14:39
ab2927d

DeepSeek Harness Plus 0.5.0

中文

0.5.0 完成移动桥接与设置备份的发布闭环:桌面端可显式连接/断开手机桥接,并独立控制自动连接与断线重连;Settings 页可将设置和用户数据导出为一个 zip,并从 zip 恢复。本版同时修复 Gateway 兼容设置、PowerShell 7.6 headless PTY 启动,以及公共四核 CI 下暴露的真实调度问题。

谁适合安装或升级

  • 希望从手机配对并继续操作桌面 Harness 会话的用户。
  • 需要在升级、迁移或故障恢复前备份 Settings 与用户数据的用户。
  • 使用 OpenAI Responses 兼容网关或持久 PowerShell 工具的用户。
  • 0.4.0 及更早版本用户:覆盖安装会保留现有 settings、凭据与 storages。

完整功能变化

1. Mobile Bridge 正式集成

web profile 集成外部维护的 @sparkelf/dsh-mobile-bridge@0.2.7;relay server 对应 @sparkelf/dsh-mobile-bridge-server@0.2.5。Settings 中可编辑的桌面 server 默认值是 https://www.tokensfree.eu.cc。桌面字段只填写 server root;手机配对 URL 由二维码生成并追加 /bridge/,桌面 WebSocket 使用 /ws/bridge

连接控制现在是显式状态:用户可主动 Connect/Disconnect,autoConnectautoReconnect 分别控制启动连接和断线恢复,互不替代。保存设置在持久化成功后立即完成,不依赖 relay、二维码或配对页是否已就绪。二维码保持 240px;登录、配对、刷新后状态恢复及双设备隔离均走真实 UI、Host 与外部 relay。

2. Settings Backup

新增第一方 Plus 包 @sparkelf/dsh-client-ui-settings-backup@0.1.0-rc.8。Settings 页可把设置与用户数据导出为一个 zip,并通过导入同类 zip 完成恢复;包通过独立 plus-npm-v0.1.0-rc.8 发布线发布,不改写任何 @deepseek-ai/*@0.1.0-rc.8 包。

3. Provider 与模型设置

Gateway 编辑器重新提供 effective openai-responses 的兼容控制;Subagent 设置覆盖创建、暂存、保存、重置与放弃,并在模型列表刷新后保持一致。Models 候选验收覆盖 11/11 个可见模型入口。

4. PowerShell 与发布可靠性

headless PTY 现在识别 PowerShell 7.6 PSReadLine 的标准光标位置查询并回应固定 headless 位置,startup 只在解析到自有 OSC marker 及精确 dsh> prompt 后发布,不再接受 setup 源码回显。真实 pwsh 测试使用产品发布的 readiness 预算;持久 cwd、环境变量、UTF-8 与模型可见输出均保持不变。

公共 Linux runner 使用四核容量预算执行 coverage、browser snapshots、lint、publint 与消费者门禁,不启用 self-hosted failover,也不通过 retry 伪造成功。

用户流程或迁移说明

  1. 下载对应平台的 0.5.0 安装包并覆盖安装;现有用户数据保留。
  2. 打开 Settings,需要备份时先导出 zip;恢复时选择该 zip 导入。
  3. 在 Mobile Bridge 中保持默认 server root 或填写自己的 server root,按需要设置 Auto connect / Auto reconnect,再显式 Connect。
  4. 用手机扫描生成的二维码,在手机配对页完成登录;不要在桌面 server 字段手工追加 /bridge
  5. Windows 用户安装后从托盘停止/启动一次 Harness,使新 bundle 与 Host 生效。

从 0.4.0 升级后的主要变化

0.4.0 0.5.0
Mobile Bridge 未随 Plus 发布 外部插件正式集成,支持显式连接与独立自动连接/重连
无第一方 Settings 全量备份入口 Settings 中可导出/导入一个 zip
Gateway 兼容控制缺失 effective openai-responses 兼容控制恢复
PowerShell startup 可误认源码回显 解析 marker + 精确 prompt,并支持 PSReadLine 光标查询

下载与平台支持

平台 文件 大小 校验值或签名状态
Windows x64 DeepSeek.Harness.Plus.Setup.0.5.0.exe 96,197,416 bytes SHA-256 0e3f187a712c3cd354858792b533529704eb9964b127cc908bb8b3429a61470f,未签名
Linux x64 deepseek-harness-plus-0.5.0.AppImage 118,387,286 bytes SHA-256 94eeed334f30af88976f3558263de25ca6d55492a81f9a1122c7123fa547ac4e,未签名
Debian/Ubuntu x64 deepseek-harness-plus-0.5.0.deb 92,763,756 bytes SHA-256 28c75ddfbdae51aaee5fcaf651846020dbfaa43c8a43a4f0e8b3384e5f3a77cc,未签名

macOS 安装包仍延后到签名/notarization 就绪。Windows 首次运行可能触发 SmartScreen。

兼容性与使用限制

  • 本版继续使用已验证的 @deepseek-ai/*@0.1.0-rc.8 基线。发布前已审计 upstream 0.1.1-rc.1528c682e06);为避免在候选验收后引入未验证的上游批次,本版不重基。
  • Mobile Bridge relay 是外部服务;外部 TLS/network 失败会保持可见诊断,保存 Settings 不受其阻塞。
  • Settings Backup zip 当前不加密;请按敏感用户数据保管。
  • 安装包未签名;校验 SHA-256 后再安装。

本版本不包含

  • macOS 安装包、Windows/macOS 代码签名与 notarization。
  • Settings Backup 加密或云端备份。
  • 对外部 Mobile Bridge relay 服务的所有权迁移;其包和服务继续由外部项目维护。
  • upstream 0.1.1-rc.1 重基。

验证证据

  • 候选 http://127.0.0.1:3081 的 Models 11/11 与 Mobile Bridge 双设备、登录、配对、刷新恢复流程通过真实 UI 验收;未使用 route/mock/retry。
  • PR #39 的 blocking CI 聚合全绿:exhaustive coverage、static、browser snapshots/artifacts、Wine Windows、Node 22/24/26、Python SDK/runtime、Desktop Linux/Windows 与 NSIS 均通过。
  • real-provider e2e 因仓库没有 DEEPSEEK_API_KEY_EXTERNAL 保持可见失败并按发布批准豁免,没有伪造绿色结果;独立 Windows native larger-runner 信号在发布时仍按非阻塞合同排队。
  • Plus npm workflow 32491703629 从 tag plus-npm-v0.1.0-rc.8 发布 Settings Backup;公共 registry 返回版本、tarball 与 SHA-512 integrity。
  • 三个桌面资产由正式 tag workflow 32493308126 在合并 commit ab2927d727 上构建并上传;以上 SHA-256 由公开 release 回下载文件计算。

关联改动


English

0.5.0 completes the Mobile Bridge and Settings Backup release paths. The desktop can explicitly connect or disconnect the phone bridge while controlling initial auto-connect and disconnect recovery independently. Settings can export user settings and data as one zip and restore from that zip. This release also repairs Gateway compatibility controls, PowerShell 7.6 headless PTY startup, and real scheduling failures exposed by the public four-core CI lane.

Who should install or upgrade

  • Users who want to pair a phone and continue operating desktop Harness sessions.
  • Users who need a Settings and user-data backup before upgrades, migration, or recovery.
  • Users of OpenAI Responses-compatible gateways or the persistent PowerShell tool.
  • Anyone on 0.4.0 or earlier; overwrite installation preserves existing settings, credentials, and storages.

Complete feature and behavior changes

1. Mobile Bridge integration

The web profile integrates externally maintained @sparkelf/dsh-mobile-bridge@0.2.7; the relay server package is @sparkelf/dsh-mobile-bridge-server@0.2.5. The editable desktop server default is https://www.tokensfree.eu.cc. Enter only the server root on desktop. The generated phone pairing URL appends /bridge/, while the desktop WebSocket uses /ws/bridge.

Connection state is explicit: users can Connect or Disconnect, while autoConnect and autoReconnect independently control startup connection and disconnect recovery. Saving completes as soon as persistence succeeds and does not depend on relay, QR, or pairing-page readiness. The QR remains 240px. Login, pairing, post-refresh recovery, and two-device isolation were exercised through the real UI, Host, and external relay.

2. Settings Backup

The new first-party Plus package @sparkelf/dsh-client-ui-settings-backup@0.1.0-rc.8 adds one-zip export and import for Settings and user data. It ships through the independent plus-npm-v0.1.0-rc.8 release line and does not overwrite any @deepseek-ai/*@0.1.0-rc.8 package.

3. Provider and model settings

The Gateway editor restores the compatibility control for effective openai-responses. Subagent settings cover create, stage, save, reset, and discard, and remain consistent after model-list refresh. Candidate acceptance covered all 11/11 visible model entries.

4. PowerShell and release reliability

The headless PTY now detects the standard cursor-position query emitted by PowerShell 7.6 PSReadLine and returns a fixed headless position. Startup publishes only after parsing the owned OSC marker and exact dsh> prompt, never from echoed setup source. Real pwsh tests use the published readiness budgets; persistent cwd, environment, UTF-8, and model-visible output remain unchanged.

Public Linux CI sizes coverage, browser snapshots, lint, publint, and consumer gates for four hosted cores. Self-hosted failover and automatic test retries remain disabled.

User workflow or migration

  1. Download the 0.5.0 package for your platform and overwrite-install; existing user data is retained.
  2. In Settings, export a zip before migration or recovery; select that zip to restore.
  3. In Mobile Bridge, keep the default server root or enter your own root, choose Auto connect / Auto reconnect, then explicitly Connect.
  4. Scan the generated QR and complete login on the phone pairing page. Do not append /bridge to the desktop server field.
  5. On Windows, stop and start Harness once from the tray so the new bundle and Host take effect.

Main changes from 0.4.0

0.4.0 0.5.0
Mobile Bridge not shipped with Plus External plugin integrated with explicit connection and independent auto-connect/reconnect
No first-party full Settings backup entry Export/import Settings and user data as one zip
Gateway compatibility control missing Effective openai-responses compatibility control restored
PowerShell startup could accept echoed setup source Parsed marker + exact prompt, with PSReadLine cursor-query support

Downloads and platform support

Platform File Size Checksum or signing status
Windows x64 DeepSeek.Harness.Plus.Setup.0.5.0.exe 96,197,416 bytes SHA-256 0e3f187a712c3cd354858792b533529704eb9964b127cc908bb8b3429a61470f, unsigned
Linux x64 deepseek-harness-plus-0.5.0.AppImage 118,387,286 bytes SHA-256 94eeed334f30af88976f3558263de25ca6d55492a81f9a1122c7123fa547ac4e, unsigned
Debian/Ubuntu x64 deepseek-harness-plus-0.5.0.deb 92,763,756 bytes SHA-256 28c75ddfbdae51aaee5fcaf651846020dbfaa43c8a43a4f0e8b3384e5f3a77cc, unsigned

macOS packages remain deferred pending signing and notarization. Windows may show SmartScreen on first launch.

Compatibility and limitations

  • This release stays on the verified @deepseek-ai/*@0.1.0-rc.8 baseline. Upstream 0.1.1-rc.1 at 528c682e06 was audited before release; it is not rebased here to avoid adding an unverified upstream batch after candidate acceptance.
  • The Mobile Bridge relay is external. TLS or network failures remain visible diagnostics and never block saving Settings.
  • Settings Backup zip files are not encrypted; handle them as sensitive user data.
  • Installers are unsigned; verify SHA-256 before installation.

Not included in this release

  • macOS packages or Windows/macOS signing and notarization.
  • Settings Backup encryption or cloud backup.
  • Ownership transfer of the external Mobile Bridge relay; its package and service remain externally maintained.
  • Rebase onto upstream 0.1.1-rc.1.

Verification evidence

  • Candidate http://127.0.0.1:3081 passed Models 11/11 and real-UI Mobile Bridge two-device, login, pairing, and refresh-recovery flows without route mocks or retries.
  • PR #39's blocking CI aggregate passed exhaustive cover...
Read more

DeepSeek Harness Plus 0.4.0

Choose a tag to compare

@SparkElf SparkElf released this 18 Aug 20:26
56b19b0

DeepSeek Harness Plus 0.4.0

中文

0.4.0 把社区里最成熟的侧边栏体验变成出厂默认:新装和存量安装打开就是带文件树、编辑器、终端、Git 面板的 VSCode 式右侧栏,无需手动装插件。同时落地首页双语 README、代理工作风格规则、外部插件策展收录,以及泛用智能取数协议的设计注。

谁适合安装或升级

  • 想要会话级文件浏览/编辑、终端、Git 面板而不想手动装插件的用户。
  • 0.3.0 及更早用户:升级即获得默认侧边栏与本批文档/流程改进。
  • 关注智能取数泛用协议的维护者(设计注已入库,待开发)。

完整功能变化

1. better-sidebar 默认集成

web profile 模板现在默认挂载 dsh-better-sidebar 0.13.1(VSCode 式右侧栏:资源管理器/编辑器/终端/Git/子代理页面,按会话隔离,开放第三方 tab 注册)。存量安装的"安装自有元组"(仅 base+web-app)会在下次启动时自动规范化到新模板;任何自行增删过 bundle 列表的配置被视为用户自有,保持不变。终端依赖 node-pty,加载失败时侧边栏其余功能照常、终端显示修复横幅。

使用方式:

  1. 安装或升级到 0.4.0,启动 Harness。
  2. 会话页右侧即见侧边栏;终端 tab 首次使用按提示确认 node-pty 可用即可。
  3. 不想要它:dsh plugin --profile web remove dsh-better-sidebar,列表归用户自有后不再自动恢复。

2. 首页双语 README

README 首页同时展示中文与英文(中文在上),不再需要点链接跳转;README.zh.md 保持结构镜像以通过配对门禁。

3. 代理工作风格规则入库

AGENTS.md 新增工作风格指针,正文在 .agents/working-style.md:不迎合、实事求是指出思维漏洞(用户对则不提)、未获明确开发许可先汇报不动手、外部插件先审后装。

4. 外部插件策展与智能取数协议设计

策展清单收录 better-sidebar(plusBundle 真);新增 proposed Agent Note《泛用智能取数工具与中台协议》:dq/v1 JSON 协议(capabilities/resources search/query sql/query api/kb/glossary)、dsh-plugins-plus 泛用插件、dataops 适配层三层设计,只设计不开发。

用户流程或迁移说明

  1. 覆盖安装 0.4.0,用户数据保留。
  2. 启动后侧边栏默认可见;存量自定义 bundle 配置不受影响。
  3. Windows 用户:托盘停止/启动一次 Harness 使新 bundle 生效。

从上一版本升级后的主要变化

上一版本 当前版本
侧边栏需手动 dsh plugin add 出厂默认挂载,存量自动规范化
README 中文需点链接跳转 首页双语并列,中文在上
代理行为规则口头约定 入库为 working-style 规则
智能取数强绑定 dataops 泛用协议设计入库(待开发)

下载与平台支持

平台 文件 大小 校验值或签名状态
Windows x64 DeepSeek Harness Plus Setup 0.4.0.exe — 见本 Release 附件 96,197,090 bytes SHA-256 905f43ff44f578e38574c9282e53a5bf7281404610c369d296a8d7fb08a8a9e7,未签名

Linux 可源码运行;macOS 延后到签名/notarization 就绪。安装包未签名,首跑可能触发 SmartScreen。

兼容性与使用限制

  • 0.3.0 数据(settings/凭据/storages)覆盖升级保留。
  • 自行改过 web profile bundles 列表的用户不受自动规范化影响。
  • node-pty 缺失时终端不可用,其余侧边栏功能不受影响。

本版本不包含

  • 移动网页版桥接(插件与服务器已在 dsh-plugins-plus 开发完成,部署待服务器凭据)。
  • 智能取数协议实现(仅设计注)。
  • macOS 安装包、安装包签名/公证、备份加密。

验证证据

  • Windows CI Playwright Electron 套件全绿(安装器交互、完整安装、备份闭环)。
  • 0.4.0 构建经 NSIS 工作流打包,附件 SHA-256 与 CI 产物一致。
  • 用户此前对 better-sidebar 集成的真实环境验收("集成得很好")。

关联改动

  • PR #32(0.4.0 批次):https://github.com/SparkElf/deepseek-harness-plus/pull/32
  • Tagged source:https://github.com/SparkElf/deepseek-harness-plus/tree/plus-v0.4.0

English

0.4.0 makes the community's most mature sidebar the factory default: fresh and stock installs open with a VSCode-like right rail — explorer, editor, terminal, Git panel — with no manual plugin step. It also ships the front-page bilingual README, agent working-style rules, curation of better-sidebar, and the design note for a generic intelligent data-query protocol.

Who should install or upgrade

  • Users who want session-scoped file browsing/editing, a terminal, and a Git panel without manual plugin installs.
  • Anyone on 0.3.0 or earlier: upgrade for the default sidebar plus this batch of docs/process improvements.
  • Maintainers watching the generic data-query protocol (design note landed; implementation pending).

Complete feature and behavior changes

1. better-sidebar by default

The web profile template now mounts dsh-better-sidebar 0.13.1 (VSCode-like right rail: explorer/editor/terminal/Git/subagent pages, isolated per session, open to third-party tabs). Stock installation-owned tuples (base+web-app only) normalize to the new template at next boot; any list the user added to or reordered is user-owned and left untouched. The terminal needs node-pty; when it fails to load, the rest of the sidebar works and the terminal shows a repair banner.

How to use it:

  1. Install or upgrade to 0.4.0 and start Harness.
  2. The sidebar is visible on the conversation page; confirm node-pty on first terminal use if prompted.
  3. To opt out: dsh plugin --profile web remove dsh-better-sidebar; once user-owned, the list is not auto-restored.

2. Front-page bilingual README

The README now shows Chinese and English together on the front page (Chinese first); no link hop needed. README.zh.md stays a structural mirror for the pairing gate.

3. Agent working-style rules

AGENTS.md links the new working-style rules (full text in .agents/working-style.md): no sycophancy, fact-based pushback on reasoning gaps (silent when the owner is right), report before implementing without explicit approval, and review-before-install for external plugins.

4. Curation and data-query protocol design

The curated manifest records better-sidebar (plusBundle true); a proposed Agent Note designs the generic intelligent data-query tool and the dq/v1 middle-platform protocol (capabilities, resource search, SQL query, API query, KB, glossary) with a dsh-plugins-plus generic plugin and a dataops adapter — design only, no code.

User workflow or migration

  1. Overwrite-install 0.4.0; user data is preserved.
  2. The sidebar appears by default; custom bundle lists are untouched.
  3. Windows: stop/start Harness once from the tray so the new bundle takes effect.

Main changes from the previous version

Previous version Current version
Sidebar required manual dsh plugin add Mounted by default; stock installs normalize
Chinese README behind a link hop Front-page bilingual, Chinese first
Agent behavior rules informal Codified working-style rules
Data query hard-wired to dataops Generic protocol design landed (implementation pending)

Downloads and platform support

Platform File Size Checksum or signing status
Windows x64 DeepSeek Harness Plus Setup 0.4.0.exe — attached to this release 96,197,090 bytes SHA-256 905f43ff44f578e38574c9282e53a5bf7281404610c369d296a8d7fb08a8a9e7, unsigned

Linux runs from source; macOS deferred pending signing/notarization. The installer is unsigned; first run may trigger SmartScreen.

Compatibility and limitations

  • 0.3.0 data (settings/credentials/storages) survives overwrite upgrade.
  • Users who customized the web profile bundles list are not auto-normalized.
  • Without node-pty the terminal tab is unavailable; the rest of the sidebar works.

Not included in this release

  • Mobile web bridge (plugin and server developed in dsh-plugins-plus; deployment awaits server credentials).
  • Data-query protocol implementation (design note only).
  • macOS packages, installer signing/notarization, backup encryption.

Verification evidence

  • Windows CI Playwright Electron suite fully green (installer interactions, complete install, backup loop).
  • The 0.4.0 build comes from the NSIS workflow; the asset SHA-256 matches the CI artifact.
  • The owner's real-environment acceptance of the better-sidebar integration ("集成得很好").

Related changes

  • PR #32 (0.4.0 batch): https://github.com/SparkElf/deepseek-harness-plus/pull/32
  • Tagged source: https://github.com/SparkElf/deepseek-harness-plus/tree/plus-v0.4.0

DeepSeek Harness Plus 0.3.0

Choose a tag to compare

@SparkElf SparkElf released this 18 Aug 16:40
a66fc2a

DeepSeek Harness Plus 0.3.0

中文

DeepSeek Harness Plus 0.3.0 是 0.2.0 之后桌面安装、运行与数据管理体验的完整收束版本。它把"安装—配置—启动—备份—开机自启—退出"这条日常链路里所有已发现的断点补齐:安装向导不再需要从头填写、端口冲突可以当场解决、构建与启动不再弹出空控制台、安装完成后托盘与 Harness 服务常驻、用户设置和数据可以一个压缩包带走并在 WSL 与 Windows 之间迁移。同时版本号与安装器克隆的提交开始一一对应。

谁适合安装或升级

  • 正在使用 0.1.x / 0.2.x 的 Windows 桌面用户,尤其是曾被安装向导、端口占用、控制台窗口困扰的用户。
  • 需要迁移或定期备份 Harness 设置、模型配置、密钥与会话数据的用户。
  • 希望开机自动启动 Harness、或希望安装完成后托盘与服务自动常驻的用户。
  • 在 WSL 中运行 Harness、但希望托盘始终在 Windows 的用户。

完整功能变化

1. 安装向导全流程预填与重配置

此前每次打开安装向导都要从头填写安装目录、端口、代理与 API 密钥。现在:新安装时安装目录默认填到<托盘安装目录>\dsh;重新配置时安装目录、四个端口、代理全部从已保存的 runtime 回填,覆盖选项默认勾选;当目标目录已有凭据文档时 API 密钥变为可选(安装器从不覆盖已有凭据)。托盘新增"重新配置安装…"入口,无需重装即可重进向导。安装完成页提供"运行初始化设置"复选项,勾选后应用启动即弹出安装向导,即使已有 runtime 配置。

使用方式:

  1. 运行安装程序,完成页勾选"运行初始化设置"。
  2. 向导各页确认预填值(目录、端口、provider/model、密钥可选)。
  3. 安装完成后浏览器自动打开 Harness,托盘常驻系统托盘。

2. 目录选择器支持选盘符

安装目录的"选择文件夹"浏览器此前只能从用户目录逐级进入,无法换盘。现在 Windows 上浏览器以虚拟盘符层打开,顶层即 C:、D:、E:… 列表,可直接选盘再进入目录,也可一路返回盘符层。

3. 端口占用弹窗与旧服务自动替换

此前端口被占用只有一句报错,且旧 Supervisor 会按旧端口继续服务,导致"填了 3085 却侦测 3080"。现在:安装/启动时端口被占用会弹窗显示占用进程名与 PID(进程名不可用时给出裸 PID),可选择"结束进程并继续";配置端口与存活 Supervisor 不一致时,daemon 先请旧实例 shutdown,旧版本不识别该命令时按命令行强杀,再由新配置拉起新 Supervisor。

4. 备份与恢复(设置页 + 托盘)

设置页新增"备份"分区,托盘提供"备份与恢复…"入口:导出把用户设置(含 provider/模型配置)、凭据(密钥明文本身)、storages 打包为一个 zip;导入先校验清单标记与路径安全(拒绝绝对路径、反斜杠、..),通过后才停止 Harness、同名覆盖恢复、原本在运行则自动重启。运行时生成的 profilessupervisor 日志不包含在内。压缩包经仅回环的 HTTP 路由流式传输(下载/上传),不再 base64 进 JSON,大 home 不再爆内存。WSL 目标经 \\wsl.localhost UNC 访问,压缩包可在 WSL 与 Windows 安装之间迁移。

使用方式:

  1. 设置页 → 备份 → 导出备份压缩包(浏览器下载 zip)。
  2. 新环境:设置页 → 备份 → 选择压缩包并导入 → 确认覆盖。
  3. 状态行显示导出/导入结果;无效压缩包以本地化文案拒绝且不影响运行中的 Harness。

5. 无控制台启动与构建

托盘"启动 Harness"此前会留下常驻 CMD 窗口;构建阶段也会弹出空终端。现在 Supervisor 直接以 node --import tsx/esm 启动 Web(绕过 pnpm 的 cmd.exe 链),构建五阶段(tsc host/client、tsdown host/client、vite build)直接经 node 执行,全程 windowsHide,任何构建/启动路径都不再弹控制台。

6. 托盘常驻、退出与进度通知

安装向导关闭后托盘与 Harness 服务此前会一起消失(Electron 默认最后窗口关闭即退出,而 Supervisor 以 utilityProcess 随应用生命周期)。现在托盘应用驻留到用户主动"退出";退出项显示"正在退出…"提示、8 秒宽限内尽力停止 runtime、失败或超时也照常退出且不弹错误框;托盘操作经气泡通知宣告开始/完成/失败,daemon 阶段文案进入托盘 tooltip,长操作不再无声。

7. 开机自启动

托盘新增"开机自动启动"复选项:Windows(含 runtime 目标为 WSL 的情况,托盘应用本体始终在 Windows)写入登录项注册表项;Linux 桌面写入/删除 XDG autostart .desktop 条目;每次重建托盘时读回勾选状态。

8. 版本号与克隆提交对应

此前安装器烘焙构建时最新提交,0.2.0 名下累积了所有后续 PR。现在构建提交若打着 plus-v* release tag,安装器克隆该 tag,版本号与克隆提交一一对应;本版本版本号升至 0.3.0。

9. 分支整合

#14 将六个历史分支合入 master,用户可见部分已在上文各小节完整说明;其余为 CI 打包工作流与文档整理。

10. 持久 bash 每条命令约 3.5 秒停顿的修复

此前持久 bash 工具用自有标记覆盖了 PS1,终端后端的提示符就绪路径永远匹配不上,每条命令都要等满 idleSilenceMs 静默窗(约 3.5 秒)才返回。现在 shell 初始化时重新声明后端的受控提示符,命令即时响应;默认静默配置保持不变,并以桩契约测试和真实 Loader 组合测试钉住该对齐。使用 shell/持久终端的用户升级后每条命令直接省去约 3.5 秒等待。

11. 设置页子代理(Subagent)设置

设置页插件分区新增子代理卡片:可为子代理配置 persona、工具过滤与委派深度等默认值;子代理默认编排改由插件配置承载。此前这些只能改文件,现在在设置页可见、可改、即时生效。

12. OpenAI Responses 网关兼容、模型能力开关与自定义 provider

模型设置与网关链路支持 OpenAI Responses 兼容 provider:请求按 Responses 协议构造,返回的多种 reasoning 状态被统一清理为 Harness 可展示的状态,兼容网关不再因未知状态报错或显示异常。模型页新增逐模型"支持图片输入"能力开关与"中转站兼容模式"(不向网关发送 reasoning 输入状态,避免中转站报错);"高级"区更名为"模型能力"。自定义 provider 编辑器补全名称/baseURL 校验与模型列表编辑,Responses 兼容中转站可在页面完成配置。

13. 安装器与托盘视觉重设计

按统一前端设计规范重做了安装器与托盘相关界面:安装器窗口表面统一、按原生卡片比例预览、provider 设置流程精简、选择控件打磨、设置页下拉样式对齐。视觉变化不改变任何配置语义。

14. Windows 打包 CI 与仓库/流程/代理工具(内部)

每个 master/PR 构建都经 Windows NSIS 工作流产出安装包工件,Release 附件即来自该流水线。#7#11 为流程与文档批次:release notes 双语完整性标准、PR 合并收尾流程、README 去重、以用户反馈定义边缘案例,以及 architecture-planning、code-review、implementation 等技能调整;仓库代理技能新增 harness-frontend-design、pr-authoring、pr-merge-closeout、release-notes-authoring(含模板)、fast-artifact-downloads。这些面向维护流程与代理,不改变产品行为。

用户流程或迁移说明

  1. 卸载或覆盖安装均可:直接运行 0.3.0 安装包,勾选覆盖安装并保留用户数据。
  2. 完成页勾选"运行初始化设置",确认预填配置后完成向导。
  3. 确认托盘图标常驻、浏览器打开的端口可访问;托盘"备份与恢复…"可导出第一个备份包。
  4. 从 WSL 迁移:在 WSL 环境的设置页导出备份包,Windows 新安装导入即可。

从上一版本升级后的主要变化

上一版本 当前版本
安装向导每次从头填写 目录/端口/代理/覆盖预填,密钥可选
选文件夹无法换盘 顶层盘符列表可选任意盘
端口占用仅报错 弹窗显示占用进程,可结束并继续
安装完成后托盘与服务消失 托盘常驻,服务随托盘存活
启动/构建弹空控制台 全程无控制台窗口
设置/密钥无法整体迁移 备份/恢复一个压缩包,WSL↔Windows 可迁移
0.2.0 累积所有后续提交 版本与克隆提交一一对应

下载与平台支持

平台 文件 大小 校验值或签名状态
Windows x64 DeepSeek Harness Plus Setup 0.3.0.exe — 见本 Release 附件 96,197,116 bytes SHA-256 28708eb2d80ffe471e261c658600fa81744b80f672dd8bee1d85e0b6377a04ec,未签名

Linux(AppImage/deb)与 macOS(dmg)目标可由源码构建;本 Release 仅附 Windows 安装包。安装包未签名/未公证,首次运行可能触发 SmartScreen 提示。

兼容性与使用限制

  • 0.1.x/0.2.x 的 runtime 数据(settings、凭据、storages)可直接覆盖升级保留。
  • 备份导入按同名覆盖,未包含的文件保留;导入前自动校验,无效包不影响运行中的 Harness。
  • 备份不含运行时生成的 profilessupervisor 日志。
  • 开机自启动在 Linux 依赖 XDG autostart;无显示环境不适用。
  • 旧版本 Supervisor 的替换依赖命令行特征匹配强杀,极端权限受限时由后续启动报错暴露。

本版本不包含

  • macOS 公开安装包与安装包签名/公证。
  • 自动更新通道(仍通过托盘"版本管理…"手动升级)。
  • 备份包的加密或云端存储。
  • 图片生成与完整模型能力矩阵(本版本仅交付设计文档与"支持图片输入"等开关)。

验证证据

  • Windows CI(windows-latest)Playwright Electron 套件三个用例全绿:安装器交互、完整原生安装并启动 Supervisor、备份导出/导入 UI 闭环(含标记校验、篡改恢复、密钥明文断言)。
  • 用户于 2026-08-18 在真实 Windows 环境验收通过:安装向导预填、托盘常驻、3085 可访问、备份/恢复、开机自启动、端口弹窗、无控制台。
  • 每次合入均经 Windows NSIS 工作流打包;Release 附件 SHA-256 与 CI 产物一致。

关联改动

  • PR #13#30(安装器修复、备份、托盘体验、版本对应):https://github.com/SparkElf/deepseek-harness-plus/pulls?q=is%3Apr+is%3Amerged+13..30
  • Tagged source:https://github.com/SparkElf/deepseek-harness-plus/tree/plus-v0.3.0

English

DeepSeek Harness Plus 0.3.0 closes out the desktop install/run/data-management loop that 0.2.0 opened. Every discovered break in the daily chain — install, configure, start, back up, launch at login, quit — is fixed: the wizard no longer starts from blank fields, port conflicts are resolvable on the spot, builds and launches no longer pop empty consoles, the tray and Harness service stay resident after the wizard closes, and user settings plus data travel as one zip that migrates between WSL and Windows. Version numbers now correspond to the commits installers clone.

Who should install or upgrade

  • Windows desktop users on 0.1.x / 0.2.x, especially anyone blocked by wizard friction, port conflicts, or console windows.
  • Users who need to migrate or periodically back up Harness settings, model configuration, keys, and session data.
  • Users who want Harness to launch at startup, or the tray and service to stay resident after installation.
  • Users running Harness inside WSL while keeping the tray on Windows.

Complete feature and behavior changes

1. Wizard prefill and reconfiguration

Previously every wizard run started from blank directory, ports, proxy, and API key. Now: fresh installs default the installation folder to <tray install dir>\dsh; reconfiguration prefills the directory, all four ports, and the proxy from the saved runtime with overwrite checked; the API key becomes optional when the target already stores a credentials document (the installer never overwrites credentials). The tray offers "Reconfigure installation…" to reopen the wizard without reinstalling, and the finish page's "Run initial setup" checkbox reopens the wizard at next launch even when a runtime exists.

How to use it:

  1. Run the installer and tick "Run initial setup" on the finish page.
  2. Confirm the prefilled values (folder, ports, provider/model, optional key).
  3. After completion the browser opens Harness and the tray stays resident.

2. Drive picker in the directory browser

The install folder browser previously could not switch drives. On Windows it now opens on a virtual drives level listing C:, D:, E:… so any drive is selectable, and you can navigate back up to the drives level at any time.

3. Port-occupancy dialog and stale-supervisor replacement

Previously an occupied port produced only an error, and an old Supervisor kept serving its old ports ("typed 3085 but it probed 3080"). Now an occupied port raises a dialog naming the holding process and PID (bare PID when unnamed) with an end-and-continue option; when a live Supervisor's configured ports differ, the daemon asks it to shut down and force-kills builds too old to know the shutdown command, then starts a fresh Supervisor from the new manifest.

4. Backup and restore (settings page + tray)

The settings dialog gains a Backup section and the tray a "Backup and restore…" entry: export packs settings (including provider/model configuration), credentials (the key values themselves), and storages into one zip; import validates the manifest marker and path safety (absolute paths, backslashes, .. rejected) before stopping Harness, overwrites same-named files, and restarts when it was running. Runtime-generated profiles and supervisor logs are excluded. Archives stream over loopback-only HTTP routes instead of base64-in-JSON, so large homes no longer exhaust memory. WSL homes are reached via \\wsl.localhost UNC, so archives migrate between WSL and Windows installs.

How to use it:

  1. Settings → Backup → Export backup archive (browser downloads the zip).
  2. In the new environment: Settings → Backup → choose the archive and import, confirm overwrite.
  3. The status line reports the result; invalid archives are rejected with localized copy without disturbing a running Harness.

5. Console-free launch and build

Tray "Start Harness" previously left a persistent CMD window and builds popped empty terminals. The Supervisor now launches Web directly via node --import tsx/esm (bypassing pnpm's cmd.exe chain) and the five build stages (tsc host/client, tsdown host/client, vite build) run directly through node, all with windowsHide; no console window appears on any build or launch path.

6. Tray residency, quit, and progress notifications

Closing the wizard previously took the tray, Supervisor, and Web down together (Electron quits on last-window close by default and the Supervisor is a utilityProcess tied to the app). The tray app now stays resident until Quit; Quit shows a quitting hint, stops the runtime within an eight-second budget, and quits regardless without error dialogs; tray actions announce start/completion/failure via balloon notifications and...

Read more

DeepSeek Harness Plus 0.2.0

Choose a tag to compare

@github-actions github-actions released this 15 Aug 22:32
4b6044f

DeepSeek Harness Plus 0.2.0

中文

DeepSeek Harness Plus 0.2.0 是一次面向本地桌面使用体验的完整升级。它打通了三个日常高频流程:直接打开 Harness 实际使用的配置文件、让 Web Search 跟随当前模型配置、通过可视化 Supervisor 管理和排查本地 Web runtime。亮点不在于增加更多开关,而在于让配置、运行、重启和故障定位形成可操作的完整闭环。

谁适合升级

建议以下用户从 0.1.0 升级:

  • 在 Windows、WSL2 或 Linux 上使用 DeepSeek Harness Plus 桌面版。
  • 需要直接查看或编辑当前 Harness 实际使用的配置文件。
  • 使用 OpenAI Responses 兼容 provider,并希望 Web Search 跟随当前选中的 provider/model。
  • 经常重建或重启本地 Harness,希望明确看到当前分支、revision、进程和构建日志。
  • 希望 Web runtime 重启后页面自动恢复,而不是手动刷新并逐个寻找被中断的会话。

完整功能变化

1. 从设置页打开真实配置文件

设置页现在提供稳定的“打开配置文件”操作,目标是当前 Host 实际使用的 $DSH_HOME/settings.yaml,而不是浏览器猜测出的路径或项目目录中的示例文件。

完整操作链路如下:

  1. settings-file 确认并准备当前 settings document。
  2. 浏览器调用无路径参数的 settings.openDocument
  3. Host 再次解析自己持有的配置文件路径。
  4. Host 把文件交给当前操作系统的原生打开机制。

这意味着文件路径始终由 Host 管理,不会暴露给浏览器,也不会因为前端工作目录不同而打开错误文件。

各平台行为:

  • Windows:通过 PowerShell Invoke-Item 使用系统文件关联打开 YAML。
  • WSL2:先用 wslpath -w 把 Linux 路径转换成 Windows/UNC 路径,再解析 Windows PowerShell 可执行文件并调用 Invoke-Item
  • Linux:通过 xdg-open 交给系统默认应用。
  • macOS 源码运行环境:通过系统原生文本文件打开方式处理;本版本不提供公开 macOS 安装包。

WSL2 检测不再只依赖 WSL_INTEROPWSL_DISTRO_NAME。即使 Supervisor 没有继承这些环境变量,也能根据 Microsoft WSL kernel release 识别 WSL2。这正是本版本在实际 WSL2 环境中修复的主要问题。

2. Settings 操作与 Host 实际能力保持一致

配置文件操作现在区分两个事实:

  • 当前 settings provider 是否拥有可准备的本地文档。
  • 当前 Host 是否能够把该文档交给原生应用。

用户体验上的变化:

  • 文件型 settings provider 的操作入口保持稳定,不会因为 metadata 尚在加载而错误消失。
  • 点击操作时由 Host 准备和打开文件,页面不自行拼接路径。
  • 原生打开不可用时,界面明确表现为不可用状态,而不是提供一个点击后必然失败的假入口。
  • 配置文件缺失时,可由 settings provider 以正确权限创建后再打开。

3. Web Search 跟随当前 provider 和 model

Web Search 不再默认假设用户一定使用 DeepSeek 官方 credential。当前搜索链路会读取 agent 实际选中的 provider/model,并选择与它匹配的搜索实现。

本版本支持的主要体验:

  • 当前模型来自 OpenAI Responses 兼容 provider 时,使用该 provider 的 base URL、credential reference 和 model 进行搜索。
  • 本机一类 link_api / gpt-5.6-sol 配置可以直接沿当前模型链路执行 Web Search。
  • 显式配置的 DeepSeek 搜索模式继续保留,不会被移除。
  • 当前协议不支持搜索时会明确失败,不会静默改走另一套 credential 或产生难以解释的认证错误。

对用户而言,模型选择和 Web Search 使用的是同一份运行时事实,不再需要维护两套容易漂移的 provider 配置。

4. 独立的本地 Runtime Supervisor

0.2.0 引入 Supervisor 作为 Harness Web runtime 的单一生命周期管理入口。桌面托盘和进度页不再各自直接管理进程,而是把命令交给 Supervisor control socket。

Supervisor 支持:

  • 启动 Harness Web。
  • 停止 Harness Web。
  • 重启当前 runtime。
  • 重新构建并重启 runtime。
  • 在重建命令中选择目标分支。
  • 串行执行维护操作,避免重复点击同时触发多个 restart/build。
  • 将完整构建输出写入持久 runtime log。
  • 将当前运行身份写入 Supervisor manifest。

进度页会显示:

  • 安装路径。
  • DSH_HOME
  • 当前 Git branch 和 revision。
  • 工作树是否存在未提交改动。
  • Web 端口和 progress 端口。
  • Web PID 与 watcher PID。
  • 当前 operation、phase 和最终结果。

默认本地布局为:

  • Production Web:http://127.0.0.1:3080
  • Production progress:http://127.0.0.1:3082
  • Candidate Web:http://127.0.0.1:3081
  • Candidate progress:http://127.0.0.1:3083

5. Supervisor 进度页重新设计

进度页从简单状态展示升级为面向重复运维操作的工作界面。

主要变化:

  • 统一 DeepSeek Harness Plus 品牌,移除重复或不一致的标题和阶段信息。
  • Runtime identity 独立展示,用户可以先确认“正在操作哪一个 runtime”。
  • 活动时间线和原始运行日志使用固定高度、独立滚动区域,长时间构建不会把整个页面无限撑长。
  • 日志按内容区分 phase、success、warning、error、command 和 artifact,错误与产物更容易定位。
  • 操作按钮使用明确图标和状态,不需要依赖冗长说明文字理解动作。
  • 当前 operation 运行时会禁用冲突操作,避免重复提交。
  • 保留完整 raw output,简化状态不会替代真正的编译器和 runtime 日志。
  • 窄屏和桌面布局都保持信息可读,不让日志、按钮或身份字段互相遮挡。

6. Plugin HMR 与 Web runtime 重启采用不同恢复方式

0.2.0 区分两类更新:

  • 纯 client plugin rebuild:继续使用 HMR,只替换对应 Cordis plugin fiber,不刷新整页,当前页面和会话位置保持不变。
  • 完整 Web runtime 重启:SSE 断开并重新连接后,现有页面自动 reload,使 shell、Host、core 和 bundle 使用新构建结果。

当 Web runtime 重启前存在正在运行的会话时,浏览器会记录这些 session id。页面重新连接后,会为对应会话排队发送以下恢复提示:

请继续完成任务,如果都已完成则回复没有未完成的任务即可

用户不需要在重启后逐个寻找会话并手动输入继续命令。已经完成的任务可以直接回复没有未完成任务,仍在进行的任务可以继续执行。

7. Candidate-first 本地开发与验收流程

本版本把候选环境优先的工作方式写入仓库规则和专用 skill,减少未验收改动直接影响 3080 的情况。

规则如下:

  • 只有确认运行着 production watcher 的纯 client-plugin source edit 可以使用 3080 HMR。
  • Web shell、client runtime、HMR infrastructure、Host、Supervisor、desktop、settings/schema、dependency、lockfile 和 bundle composition 改动都必须使用 candidate。
  • Candidate 使用独立 Git worktree、独立 DSH_HOME、3081 Web 和 3083 progress。
  • Candidate 完成真实 UI 验收后,才能由用户明确授权 promotion 到 production 3080/3082。
  • Production worktree 不作为普通非 HMR 开发工作区。

这项变化主要服务维护者,但最终收益是用户看到的 production 页面始终对应已经验收的候选结果。

8. 原 PR 与本地汇总分支的同步规则

本版本补充了 Plus 的 PR 协作规则:本地汇总分支已经包含用户确认的完整改动,而原远端 PR 落后时,应把完成内容同步回原 PR,而不是关闭原 PR、另建竞争 PR 或擅自改变 PR 拆分方式。

该规则保留原 PR 的编号、评审历史和功能边界,使远端审阅内容与用户已经验收的本地结果一致。

从 0.1.0 升级后最直观的变化

0.1.0 0.2.0
配置文件通常需要手动寻找 从 Settings 直接打开 Host 实际使用的配置文件
WSL 可能被误判为普通无桌面 Linux 可从 Microsoft kernel 识别 WSL2 并调用 Windows 默认应用
Web Search 与当前模型配置可能分离 Search 跟随当前 provider/model
重建状态主要依赖托盘提示和原始日志 通过 3082 页面查看完整 runtime identity、阶段和日志
Web 重启后需要手动刷新和恢复会话 页面自动 reload,并向被中断的运行会话发送继续提示
非 HMR 改动可能直接在 production 工作树处理 非 HMR 改动先进入隔离的 3081/3083 candidate

下载与安装包

平台 文件 大小
Linux AppImage deepseek-harness-plus-0.2.0.AppImage 115,578,976 bytes
Debian / Ubuntu deepseek-harness-plus-0.2.0.deb 90,450,904 bytes
Windows DeepSeek.Harness.Plus.Setup.0.2.0.exe 93,694,226 bytes

macOS 安装包仍未公开发布,需等待签名和 notarization 配置完成。源码中的 macOS 路径打开逻辑不等于提供了可分发的 macOS 安装包。

兼容性与升级说明

  • 本版本没有修改 agent-loop
  • 本版本没有修改 session durable format。
  • 现有 settings 仍由 DSH_HOME 下的 settings provider 管理。
  • 当前桌面发行范围为 Linux 和 Windows。
  • 当前 Harness runtime 仍建议运行在私有本地环境;本版本没有提供多用户或公网部署 preset。

本版本不包含

以下内容仍未进入 0.2.0:

  • Draft PR #3 中的模型能力配置界面。
  • 可见的 context window 和 maximum output token 设置。
  • 图片理解与真实图片生成能力的独立声明。
  • 图片生成 runtime 输出链路。
  • 代码开发、智能问数、多用户、AIGC 和社区运营 presets。
  • macOS 签名、notarization 和公开安装包。

验证证据

  • Settings、native opener 和 config API 聚焦测试:67/67 通过。
  • HMR/runtime 聚焦测试:11/11 通过。
  • Feature、skill 和 release 文档门禁:doc-sync 28/28 通过。
  • Linux AppImage/deb 在本地和 GitHub Actions 中完成真实打包。
  • Windows NSIS installer 在 GitHub Actions 中完成真实打包。
  • Candidate 3081 和 production 3080 均通过真实 Settings UI 调用 settings.openDocument,返回 opened: true,页面无错误提示。
  • Tag workflow 成功生成并上传三个 0.2.0 资产。
  • 三个公开下载地址均已实际请求验证,返回 HTTP 200。

关联改动

完整变更范围固定在 tag plus-v0.2.0


English

DeepSeek Harness Plus 0.2.0 is a comprehensive upgrade focused on the local desktop experience. It connects three high-frequency daily workflows: directly opening the configuration file actually used by Harness, making Web Search follow the current model configuration, and managing and troubleshooting the local Web runtime through a visual Supervisor. The focus is not on adding more switches, but on creating an actionable closed loop for configuration, operation, restart, and fault diagnosis.

Who Should Upgrade

The following users are recommended to upgrade from 0.1.0:

  • Users of the DeepSeek Harness Plus desktop app on Windows, WSL2, or Linux.
  • Users who need to directly view or edit the configuration file currently used by Harness.
  • Users of an OpenAI Responses-compatible provider who want Web Search to follow the currently selected provider/model.
  • Users who frequently rebuild or restart local Harness and want clear visibility into the current branch, revision, processes, and build logs.
  • Users who want the page to recover automatically after a Web runtime restart, rather than manually refreshing and locating interrupted sessions one by one.

Complete Feature Changes

1. Open the Actual Configuration File from Settings

The Settings page now provides a reliable “Open Configuration File” action. Its target is the $DSH_HOME/settings.yaml actually used by the current Host, rather than a path guessed by the browser or an example file in the project directory.

The complete workflow is as follows:

  1. settings-file confirms and prepares the current settings document.
  2. The browser calls settings.openDocument with no path arguments.
  3. The Host resolves the configuration file path it holds again.
  4. The Host passes the file to the current operating system's native open mechanism.

This means that the file path is always managed by the Host, is not exposed to the browser, and cannot open the wrong file because the frontend has a different working directory.

Platform behavior:

  • Windows: Opens the YAML using the system file association through PowerShell Invoke-Item.
  • WSL2: First converts the Linux path to a Windows/UNC path with wslpath -w, then resolves the Windows PowerShell executable and calls Invoke-Item.
  • Linux: Passes the file to the system default application through xdg-open.
  • macOS source-run environments: Uses the system's native text-file opening mechanism; this release does not provide a public macOS installer package.

WSL2 detection no longer relies solely on WSL_INTEROP or WSL_DISTRO_NAME. Even when the Supervisor does not inherit these environment variables, it can identify WSL2 from the Microsoft WSL kernel release. This is the primary issue fixed in real WSL2 environments in this release.

2. Settings Actions Match Actual Host Capabilities

Configuration file actions now distinguish between two facts:

  • Whether the current settings provider has a local document that can be prepared.
  • Whether the current Host can pass that document to a native application.

Changes to the user experience:

  • The action entry point for file-based settings providers remains stable and does not incorrectly disappear while metadata is still loading.
  • When the action is clicked, the Host prepares and opens the file; the page does not cons...
Read more

DeepSeek Harness Plus 0.1.0

Choose a tag to compare

@github-actions github-actions released this 14 Aug 13:55
89ad208

DeepSeek Harness Plus 0.1.0

中文

DeepSeek Harness Plus 0.1.0 是 Plus 的首个公开版本。它交付了两条核心用户价值:修复子 agent 没有继承当前模型选择的问题,并提供一个面向本地用户的一次性安装引导和系统托盘管理器。首发版本同时建立了 Plus 的变更记录与评审机制,让用户能够区分已经交付、正在实验和仍在规划的能力。

谁适合使用

0.1.0 适合以下用户:

  • 在 Harness Web 中切换模型,并使用子 agent 分解任务。
  • 希望在 Linux 或 Windows 上通过图形化引导建立本地 Harness runtime。
  • 希望安装完成后从系统托盘启动、停止、打开、升级或修复本地服务。
  • 需要一个明确记录社区修复、兼容性和验证证据的 Harness 分支。

完整功能变化

1. 子 agent 继承当前 UI 模型选择

0.1.0 修复了一个影响实际任务执行的问题:用户在 Harness Web 中选择了模型后,新建的子 agent 可能仍然使用全局默认模型或其他旧配置。

修复后的体验:

  • 父 session 当前生效的 provider 和 model 会成为新子 agent 的默认选择。
  • 用户在 Web UI 中最新选择的模型优先于全局默认模型。
  • 子 agent 仍然可以在确有需要时使用自己的显式模型覆盖。
  • provider、model 和相关模型限制会沿子 agent 创建链路传递,不只复制一个显示名称。

这使父 agent 与子 agent 在默认情况下使用用户当前明确选择的模型,避免同一项任务在主会话和子任务之间出现难以察觉的模型差异。

涉及的主要模块:

  • @deepseek-ai/dsh-host-apiproxy:提供父 session 当前模型选择。
  • @deepseek-ai/dsh-subagent:创建 child agent 时继承父 session 的选择。
  • @deepseek-ai/dsh-agent:携带创建 child agent 所需的模型选择信息。

该修复没有修改 agent loop,也没有改变 session durable format。

2. 一次性桌面安装引导

首次运行桌面应用且本地 runtime 尚未建立时,0.1.0 会打开安装引导。用户不需要手动完成 clone、配置文件创建、构建和浏览器启动等分散步骤。

安装引导收集:

  • 一个空的安装目录。
  • 本地 Harness Web 端口。
  • 初始 DeepSeek API key。
  • 默认模型。
  • 可选的 reasoning effort。

随后桌面应用会:

  1. 检查本机是否具备 Git 和 pnpm。
  2. 克隆独立的 DeepSeek Harness Plus checkout。
  3. 为该安装创建隔离的 DSH_HOME
  4. 写入首次启动所需的 credential、默认模型和 reasoning 设置。
  5. 安装锁文件指定的依赖并构建源码。
  6. 启动本地 Harness Web。
  7. 在默认浏览器中打开 Harness Web。
  8. 关闭一次性安装引导,后续日常工作回到 Web 页面。

桌面引导只负责建立第一个可运行环境,不会变成第二个长期设置中心。安装完成后,模型、credential、workspace、preset 和 agent 操作继续由 Harness Web 管理。

3. 安装失败后的 Repair 路径

首次安装不是一个“全部成功才留下任何状态”的黑盒操作。0.1.0 在 checkout 克隆成功后就保存 runtime 记录,因此后续依赖安装或构建失败时,用户仍然可以从托盘进入 Repair,而不是面对一个既无法继续、也无法恢复的半成品目录。

Repair installation 会:

  • 使用锁文件恢复依赖。
  • 重新构建当前 checkout。
  • 保留用户已经选择的安装路径和本地 runtime 记录。

缺少 Git、pnpm 或构建命令失败时,安装引导会显示失败信息,不会声称安装已经完成。

4. 系统托盘管理本地 Harness runtime

安装完成后,桌面应用驻留在系统托盘,为本地 runtime 提供日常生命周期操作。

托盘操作包括:

  • Open DeepSeek Harness:在默认浏览器打开已配置的本地 Web 地址。
  • Start service:启动本地 Harness Web,并等待服务开始监听。
  • Stop service:停止本地 Web 进程,同时保留 settings、workspace 和 session 数据。
  • Upgrade Plus:快进更新 checkout、恢复锁定依赖、重新构建;如果升级前 runtime 正在运行,升级完成后重新启动。
  • Repair installation:恢复依赖并重新构建当前安装。
  • Open local data folder:打开当前 Plus 安装的本地数据目录。

托盘会区分用户主动停止和进程意外退出,避免把一次正常 Stop 显示为 runtime 崩溃。

5. 独立的本地安装与数据目录

桌面版不会复用任意现有源码目录或全局配置作为隐式安装目标。0.1.0 为桌面安装建立独立 checkout 和隔离 DSH_HOME

  • 安装源码与用户的其他 Harness checkout 分开。
  • 首次 credential 和 model 设置写入该 runtime 自己的数据目录。
  • 停止、升级或修复桌面 runtime 不会要求用户手动切换终端工作目录。
  • 安装后的日常配置仍在 Harness Web 中完成。

6. Linux 与 Windows 首发安装包

0.1.0 建立了 DeepSeek Harness Plus 的第一套公开桌面发行链路:

  • Linux x64 AppImage。
  • Debian / Ubuntu x64 deb package。
  • Windows NSIS installer。

Linux 和 Windows 产物分别在对应 GitHub runner 上构建并上传。Release 发布前对 draft 中的文件名、大小和可下载性进行了检查。

macOS 没有随 0.1.0 发布。虽然源码中存在 DMG target,但普通用户可用的公开 macOS 安装包需要 Developer ID 签名和 notarization;首发版本选择明确延期,而不是发布一个系统默认会阻止打开的 unsigned DMG。

7. Plus 变更记录与兼容性说明

0.1.0 建立了 Plus 相对上游差异的可审阅记录。用户和维护者可以查看一项改动为什么存在、影响哪些文件、与上游哪个 revision 对比,以及如何验证。

记录分为:

  • diffs/core/registry.yaml:上游 Harness 核心和核心 plugin 的行为差异。
  • diffs/community/registry.yaml:桌面、治理、社区扩展和部署相关差异。
  • presets/compositions/registry.yaml:未来 plugin 和 preset 的组合声明与冲突检查。

0.1.0 的核心 active 记录是 child agent 继承父 session 当前 UI 模型选择。桌面安装器在首发开发阶段作为 community 记录维护,公开产物在 Release 审核后发布。

8. Plus PR 治理与初学者可读说明

首发版本增加了面向人类和 AI contributor 的统一 PR 证据结构。每个 Plus PR 需要说明:

  • 用户问题和产品结果。
  • 架构与 owner。
  • 实现范围。
  • 代码审查结论。
  • 测试治理。
  • 验证证据。
  • 影响的 core/community diff records。

GitHub governance workflow 会检查必需段落、diff registry 和 composition claims。AI 生成的证据用于帮助审阅,不会替代人类 maintainer 的最终决定。

同时新增 beginner-friendly PR authoring skill,要求 PR 先解释用户能做什么、证据是什么、哪些内容没有交付,再介绍内部实现,避免把 PR 写成只有作者看得懂的开发日志。

首次安装后的用户流程

  1. 下载并启动对应平台安装包。
  2. 在首次引导中选择空安装目录和本地端口。
  3. 输入初始 DeepSeek API key、默认模型和可选 reasoning effort。
  4. 等待 clone、依赖安装和构建完成。
  5. 浏览器自动打开 Harness Web。
  6. 后续在 Harness Web 中管理模型、credential、workspace 和 agent。
  7. 使用系统托盘启动、停止、打开、升级或修复本地 runtime。

下载与校验

平台 文件 大小 SHA-256
Linux AppImage deepseek-harness-plus-0.1.0.AppImage 115,419,137 bytes 066a0a8c39cf3cd2097eda7ebd831de045c3b5f5730ae9e18f039ecfa0addfe5
Debian / Ubuntu deepseek-harness-plus-0.1.0.deb 90,358,092 bytes 278ee819db6e109454a3b9107af9a4d5d8e4d0191847077c604ed93383488a03
Windows DeepSeek.Harness.Plus.Setup.0.1.0.exe 93,610,129 bytes 8c072b2485d410eabb657b47233b91918914ce571d112ddd869e7af1e6c70929

平台要求与使用限制

  • 桌面安装流程需要本机具备 Git 和 pnpm,因为 0.1.0 使用源码 checkout 建立本地 runtime。
  • 公开安装包只覆盖 Linux x64 和 Windows;没有 macOS 安装包。
  • 桌面 helper 负责本地服务生命周期,不负责替代 Harness Web 的日常设置页面。
  • 当前 runtime 适合本地私有使用,不包含多用户或公网部署能力。
  • 0.1.0 没有提供可安装 preset catalog。
  • 安装包在匹配平台的 GitHub runner 上完成构建;当时尚未建立桌面能力的完整端到端 UI 自动化套件。

本版本不包含

以下路线图能力在 0.1.0 中仍未交付:

  • 代码开发 preset。
  • 智能问数 preset。
  • 多用户 runtime preset。
  • AIGC preset。
  • 社区运营 preset。
  • macOS 签名、notarization 和公开安装包。
  • 0.2.0 后续加入的 Settings 系统默认应用 opener。
  • 0.2.0 后续加入的当前模型 Web Search。
  • 0.2.0 后续加入的独立 Supervisor 进度页和重启恢复流程。

验证证据

  • Child agent 模型继承拥有 Host API 和 in-process subagent 聚焦回归覆盖。
  • Session-level UI model selection reproduction 验证了父 session 当前选择可以到达 child agent。
  • 一次性安装引导完成了 folder、model、confirmation 和 progress 页面检查。
  • Daemon lifecycle 验证覆盖 starting、running 和用户主动 stopped 状态。
  • Linux 本地打包生成 AppImage 和 deb,并检查 deb metadata。
  • GitHub Actions 在 Linux 和 Windows runner 上完成对应平台打包并上传 artifacts。
  • Plus governance verifier 和文档 doc-sync 28 项门禁通过。
  • Release 发布前记录并核对了三个资产的 SHA-256。

关联改动

完整首发代码固定在 tag plus-v0.1.0


English

DeepSeek Harness Plus 0.1.0 is the first public release of Plus. It delivers two core user benefits: it fixes the issue where subagents did not inherit the current model selection, and it provides a one-time installation wizard and system tray manager for local users. This initial release also establishes Plus's changelog and review process, allowing users to distinguish between capabilities that have been delivered, are being experimented with, and are still planned.

Who Should Use It

0.1.0 is for users who:

  • Switch models in Harness Web and use subagents to break down tasks.
  • Want to set up a local Harness runtime through a graphical wizard on Linux or Windows.
  • Want to start, stop, open, upgrade, or repair local services from the system tray after installation.
  • Need a Harness fork that clearly records community fixes, compatibility, and validation evidence.

Complete Feature Changes

1. Subagents Inherit the Current UI Model Selection

0.1.0 fixes an issue affecting real task execution: after a user selected a model in Harness Web, newly created subagents could still use the global default model or another old configuration.

The experience after the fix:

  • The provider and model currently in effect for the parent session become the default selection for new subagents.
  • The model most recently selected by the user in the Web UI takes precedence over the global default model.
  • Subagents can still use their own explicit model override when genuinely needed.
  • The provider, model, and related model restrictions are passed through the subagent creation path, rather than copying only a display name.

This causes parent agents and subagents to use the model the user has currently selected explicitly by default, avoiding subtle model differences between the main session and subtasks of the same task.

Main modules involved:

  • @deepseek-ai/dsh-host-apiproxy: provides the parent session's current model selection.
  • @deepseek-ai/dsh-subagent: inherits the parent session's selection when creating a child agent.
  • @deepseek-ai/dsh-agent: carries the model-selection information needed to create a child agent.

This fix does not modify the agent loop or change the session durable format.

2. One-Time Desktop Installation Wizard

When the desktop app is run for the first time and a local runtime has not yet been created, 0.1.0 opens the installation wizard. Users do not need to manually complete scattered steps such as cloning, creating configuration files, building, and launching a browser.

The installation wizard collects:

  • An empty installation directory.
  • A local Harness Web port.
  • An initial DeepSeek API key.
  • A default model.
  • Optional reasoning effort.

The desktop app then:

  1. Checks whether Git and pnpm are available on the machine.
  2. Clones a dedicated DeepSeek Harness Plus checkout.
  3. Creates an isolated DSH_HOME for that installation.
  4. Writes the credentials, default model, and reasoning settings required for first launch.
  5. Installs the dependencies specified by the lockfile and builds the source.
  6. Starts local Harness Web.
  7. Opens Harness Web in the default browser.
  8. Closes the one-time installation wizard; subsequent daily work returns to the Web page.

The desktop wizard is responsible only for establishing the first runnable environment; it does not become a second long-term settings center. After installation, Harness Web continues to manage models, credentials, workspaces, presets, and agent operations.

3. Repair Path After Installation Failure

The first installation is not a black-box operation that leaves any state only if everything succeeds. 0.1.0 saves the runtime record as soon as checkout cloning succeeds, so if subsequent...

Read more