Skip to content

dsh-loopx-plugin 0.1.1-beta.7

Pre-release
Pre-release

Choose a tag to compare

@loopx-agent loopx-agent released this 21 Nov 21:57
· 2 commits to main since this release
a6ffb3b

dsh-loopx-plugin 0.1.1-beta.7

An independently versioned DeepSeek Harness plugin release aligned with LoopX 2.4.0. This is a prerelease of the plugin; LoopX Core and Desktop App remain independently versioned.

Versioned plugin documentation · LoopX v2.4.0 release

Release Decision

Who should upgrade: DSH plugin users adopting LoopX Core 2.4.0+ or DSH 0.2.2-rc.1..rc.3 (including 0.2.2-rc.3), Windows DSH operators needing native path and continuation support, and users wanting the Personal Workspace sidebar panel or safe hot uninstall.

What this release solves: 0.1.1-beta.7 pairs with LoopX 2.4.0's quota receipt reader and quota_settlement_plan_v2 closeout contract, isolates hot uninstall from the shared DSH Web server (#6102), adds the LoopX Personal Workspace sidebar panel (#8352), fixes Windows native continuation and GoalBar path matching (#8504), surfaces GoalBar admission failures and source fingerprints (#8879), and fences stale maintenance/cancellation results (#8510, #8520, #8856).

Breaking changes: Yes. dsh-loopx-plugin 0.1.1-beta.7 requires LoopX 2.4.0 or newer; LoopX 2.3.0 lacks the original-Turn quota receipt reader (#8899). Compatible local/managed installs auto-upgrade when network access is available, while an explicitly outdated LOOPX_BIN must be upgraded by its owner.

How to verify: Restart DSH after installation, verify 0.1.1-beta.7 and all four loaded plugin rows with dsh --profile web --dump-config, inspect loopx --version in the plugin-managed runtime, and verify the exact Session binding inside a Session where /loopx was invoked.

loopx --version
dsh --profile web --dump-config
loopx --registry .loopx/registry.json --format json resolve-agent-thread \
  --host-surface deepseek-harness-native --thread-id "$DSH_SESSION_ID"

Contributors: Maintainer @huangruiteng and external community contributors @BigDataDZ, @cocolord, @Duang777, @ikunikun1145, @JasonBuildAI, @mikamikasuki, @xiaoan17, and @xiaobaifly7; concrete contributions are linked below.

Product changes

  • LoopX 2.4.0+ floor & quota_settlement_plan_v2 closeout: Enforces loopx>=2.4.0 across bootstrap, Driver, and GoalBar (#8899), integrates progressive capture admission (#8543), consumes quota receipt and quota_settlement_plan_v2 closeouts (#8879, #9147), exposes continuationAdmission errors and source fingerprints in GoalBar, and fences canceled maintenance or probe returns (#8510, #8520, #8856).
  • DSH 0.2.2-rc.1..rc.3 qualification & hot-uninstall isolation: Qualifies DSH 0.2.2-rc.1 through 0.2.2-rc.3 (retaining 0.1.5..0.2.1-rc.2), keeps the shared DSH Web server alive during hot disable/uninstall (#6102), preserves frozen toolchain overrides across pnpm 9/10/12 (#6861), and aligns Node admission (>=22.22.3, excluding 23) (#6851).
  • Personal Workspace sidebar panel & Windows paths: Adds the global LoopX sidebar panel embedding a loopback loopx dashboard workspace when already running (#8352), fixes Windows native continuation and GoalBar path matching (#8504), preserves selected host and Windows PATH-registered Python discovery (#6712, #6862), and reads scheduler cadence hints (#8609).
  • Optional native operation context & shadow observer hardening: Adds the opt-in dsh-loopx-plugin/native-operation-context subpath (#6466), redacts local file paths and mirrors canonical credential shapes in the default-off shadow observer (#6467, #7733, #8053, #8181), and adds synthetic Cordis overhead benchmarks (#5767, #6840).

Community Contributors

Contributions are derived from the dsh-loopx-plugin-v0.1.1-beta.6..dsh-loopx-plugin-v0.1.1-beta.7 package Git range and merged PR metadata:

  • @BigDataDZ — Aligned stable Node admission (#6851), preserved frozen overrides across pnpm versions (#6861), and preserved selected host and single-line Windows readback through installer qualification (#6862). #6851, #6861, #6862
  • @cocolord — Removed redundant defensive prose from prompts and comments (#9072). #9072
  • @Duang777 — Retired legacy Markdown mutation callers in favor of canonical authority (#6396). #6396
  • @ikunikun1145 — Redacted local file references in observer summaries (#6467). #6467
  • @JasonBuildAI — Found Windows PATH-registered Python (#6712), measured observer overhead with synthetic DSH sessions (#6840), and mirrored every canonical credential shape in the observer (#7733, #8181). #6712, #6840, #7733, #8181
  • @mikamikasuki — Verified observer behavior with Cordis sessions (#5767) and refreshed catalog install recovery guidance (#6000). #5767, #6000
  • @xiaoan17 — Added the LoopX Personal Workspace sidebar panel to the DSH web client (#8352). #8352
  • @xiaobaifly7 — Added native Windows continuation and GoalBar path support (#8504), retried continuation admission after attach-time maintenance (#8510), admitted host context alongside reserved continuations (#8517), honored probe cancellation (#8520), retained safe admission stages/causes (#8521), and read scheduler cadence from scheduler hint details (#8609). #8504, #8510, #8517, #8520, #8521, #8609

Optional Capability Activation & Use

DSH LoopX plugin

Activation: Install the pinned GitHub tarball or published dsh-loopx-plugin package into the web or desktop DSH profile, then start DSH (dsh --profile web --port 0 or loopx dsh-launch web). Invoke /loopx <task> in a Session to bind a Goal.

dsh plugin --profile web add \
  "https://github.com/loopx-project/loopx/releases/download/dsh-loopx-plugin-v0.1.1-beta.7/dsh-loopx-plugin-0.1.1-beta.7.tgz"
dsh --profile web --port 0
loopx dsh-launch web

Validation: Confirm 0.1.1-beta.7 and the four rows (loopx-goalbar, loopx-init-command, loopx-driver, loopx-shadow-observer) in dsh --profile web --dump-config, inspect resolve-agent-thread after invoking /loopx, and verify GoalBar plus the LoopX sidebar panel when loopx dashboard is running on loopback.

Disable / rollback: Run dsh plugin --profile web remove dsh-loopx-plugin (0.1.1-beta.7 keeps the shared Web server online during hot uninstall), or install an archived 0.1.1-beta.6 tarball only against a DSH/LoopX version supported by beta.6.

Authority boundary: Installation alone creates no Goal binding, activates no Driver, and grants no extra model tools. Core remains sole authority over Goals, Todos, quotas, and source fingerprint CAS; the LoopX sidebar panel never starts Core or mutates state itself.

Docs: DSH plugin README

DSH shadow observer

Activation: Default off. Export LOOPX_DSH_SHADOW_OBSERVER_GOAL_ID, LOOPX_DSH_SHADOW_OBSERVER_SESSION_ID, and LOOPX_DSH_SHADOW_OBSERVER_RUN_IDENTITY_JSON before launching DSH.

export LOOPX_DSH_SHADOW_OBSERVER_GOAL_ID="my-goal"
export LOOPX_DSH_SHADOW_OBSERVER_SESSION_ID="$DSH_SESSION_ID"
export LOOPX_DSH_SHADOW_OBSERVER_RUN_IDENTITY_JSON='{"worker_id":"worker-1","model_id":"model-1","task_id":"task-1","environment_id":"env-1","tools_id":"tools-1","budget_id":"budget-1","adapter_revision":"0.1.1-beta.7","observer_revision":"0.1.1-beta.7"}'
loopx reliability-diagnostics receipt --goal-id my-goal --format json
loopx reliability-diagnostics status --goal-id my-goal --format json

Validation: Inspect reliability-diagnostics receipt and status for source coverage, count conservation, and public_safety_violation counts. Existing legacy ledgers block flushes until upgraded offline.

Disable / rollback: Unset the three LOOPX_DSH_SHADOW_OBSERVER_* environment variables and restart DSH; existing diagnostic NDJSON records stay preserved.

Authority boundary: Module/hook-isolated read-only observer recording typed event names, turn/step indices, and ids only; never records prompts, arguments, tool outputs, or local paths, and never calls agent.send, schedules turns, or invokes the LoopX CLI.

Docs: Shadow observer setup

DSH native operation context

Activation: Default off (dsh-loopx-plugin/native-operation-context is omitted from default cordis.patch.yml). To opt in, add loopx-native-operation-context explicitly in a custom SDK Loader patch.

node -e 'import("dsh-loopx-plugin/native-operation-context").then(m => console.log(Object.keys(m)))'

Validation: Confirm the loopx_operation_context read-only model tool is registered in the custom SDK Loader profile and verified against the active Session binding.

Disable / rollback: Remove the loopx-native-operation-context insert block from the custom Loader patch and restart DSH.

Authority boundary: Exposes read-only context inspection scoped to the owned Session binding; grants no write, scheduling, or Goal-mutation authority.

Docs: Optional native operation context

npm trusted publishing

Activation: Maintainer-triggered GitHub Actions workflow (dsh-plugin-publish.yml) dispatched against an existing non-draft dsh-loopx-plugin-v0.1.1-beta.7 tag using npm Trusted Publishing (--provenance).

gh workflow run dsh-plugin-publish.yml --repo loopx-project/loopx \
  --ref dsh-loopx-plugin-v0.1.1-beta.7 \
  -f release_tag=dsh-loopx-plugin-v0.1.1-beta.7
npm view dsh-loopx-plugin version dist-tags dist.tarball --json

Validation: Verify workflow completion, dist-tags.latest == "0.1.1-beta.7", verify-distribution.mjs --tarball ./dsh-loopx-plugin-0.1.1-beta.7.tgz, and dsh plugin add dsh-loopx-plugin in an isolated DSH_HOME.

Disable / rollback: Do not dispatch dsh-plugin-publish.yml, or revoke the npm Trusted Publisher association as the package owner; the GitHub Release asset remains independently installable.

Authority boundary: Publishes the immutable GitHub Release tarball without rebuilding; requires npm Trusted Publisher ownership on npmjs and never grants repository or upstream marketplace merge rights.

Docs: Maintainer release and marketplace handoff

Validation and recovery

Built and verified from exact tag commit a6ffb3be6e7bdb48e02311ec58d618200fe0501c:

  • npm run build && npm run typecheck && npm test: 15 test files, 372 tests passed (including admission-closeout.integration.spec.ts 14 tests covering quota_settlement_plan_v2 closeouts).
  • npm pack (34 files, 88.8 kB compressed, 345.7 kB unpacked): tarball SHA-256 42f5bd621e65bd80f5a7782098d297274c90e32faedfbb115102df91e3e7b800.
  • DSH smokes (pnpm 10.33.0, DSH 0.2.2-rc.3): smoke:artifact, smoke:peer-range, smoke:mcp-transport, smoke:profile, smoke:runtime, and smoke:registry -- --tarball ./dsh-loopx-plugin-0.1.1-beta.7.tgz all passed.
  • Real Windows desktop interactive installation and mounted browser Start/Pause remain separate platform/manual checks; offline --offline --ignore-scripts installation covers only the plugin tarball when compatible Node, pnpm, Python, and LoopX CLI dependencies are already cached.

中文摘要

升级决策

谁需要升级: 升级至 LoopX Core 2.4.0+ 或 DSH 0.2.2-rc.1..rc.3(含 0.2.2-rc.3)的插件用户、需要 Windows 原生路径与续跑支持的运维者,以及需要 DSH 侧栏 LoopX 工作台面板或无中断热卸载的用户。

解决了什么: 0.1.1-beta.7 对齐 LoopX 2.4.0 的 quota receipt 与 quota_settlement_plan_v2 结案契约,隔离热卸载以保持共享 Web 服务在线(#6102),在 DSH 侧栏新增 LoopX 个人工作台面板(#8352),修复 Windows 原生续跑与 GoalBar 路径比对(#8504),在 GoalBar 暴露准入失败与源码指纹(#8879),并拦截已取消后的维护或探针返回(#8510、#8520、#8856)。

是否有破坏性变更: 有。dsh-loopx-plugin 0.1.1-beta.7 要求 LoopX 2.4.0 及以上版本,2.3.0 不支持原 Turn quota receipt 读取(#8899)。兼容安装可在有网时自动升级;显式指定的旧版 LOOPX_BIN 需由所有者自行升级。

如何验证: 安装后重启 DSH,执行 dsh --profile web --dump-config 确认 0.1.1-beta.7 与四个组件加载,在插件托管环境中核对 loopx --version,并在触发 /loopx 的精确会话内读回唯一绑定。

loopx --version
dsh --profile web --dump-config
loopx --registry .loopx/registry.json --format json resolve-agent-thread \
  --host-surface deepseek-harness-native --thread-id "$DSH_SESSION_ID"

贡献者: 维护者 @huangruiteng 与社区贡献者 @BigDataDZ、@cocolord、@Duang777、@ikunikun1145、@JasonBuildAI、@mikamikasuki、@xiaoan17、@xiaobaifly7(详情见上方列表)。

插件变化

  • Core 2.4.0+ 门禁与 quota_settlement_plan_v2 结案: 在初始化、Driver 与 GoalBar 统一要求 loopx>=2.4.0(#8899),接入渐进捕获准入与 quota_settlement_plan_v2 结案(#8543、#8879、#9147),展示准入失败与源码指纹,并隔离已取消的维护计划与探针(#8510、#8520、#8856)。
  • DSH 0.2.2-rc.1..rc.3 适配与热卸载隔离: 适配 DSH 0.2.2-rc.1..rc.3 并保留 0.1.5..0.2.1-rc.2 兼容范围,修复热禁用/卸载断开共享 Web 服务的问题(#6102),跨 pnpm 9/10/12 保留锁文件覆写(#6861),并对齐 Node 准入下限(#6851)。
  • 个人工作台侧栏面板与 Windows 支持: 在 DSH Web 侧栏增加 LoopX 面板内嵌已在回环端口运行的 loopx dashboard(#8352),修复 Windows 原生续跑、GoalBar 路径、PATH 注册 Python 发现与安装读回(#6712、#6862、#8504),并读取调度周期提示(#8609)。
  • 原生上下文工具与影子观察器加固: 新增默认关闭的 dsh-loopx-plugin/native-operation-context 子路径(#6466),在影子观察器中脱敏本地路径与全量凭据形态(#6467、#7733、#8053、#8181),并补充 Cordis 合成开销测试(#5767、#6840)。

社区贡献者

基于 dsh-loopx-plugin-v0.1.1-beta.6..dsh-loopx-plugin-v0.1.1-beta.7 包目录提交范围与已合并 PR 元数据:

  • @BigDataDZ:对齐 Node 准入下限(#6851)、跨 pnpm 版本保留覆写(#6861)及保留所选宿主与 Windows 单行版本读回(#6862)。 #6851, #6861, #6862
  • @cocolord:精简提示词与注释中的冗余防御性文案(#9072)。 #9072
  • @Duang777:退役旧版 Markdown 变更调用以收敛单一事实源(#6396)。 #6396
  • @ikunikun1145:在观察器摘要中脱敏本地文件引用(#6467)。 #6467
  • @JasonBuildAI:支持发现 Windows PATH 注册的 Python(#6712)、使用合成 DSH 会话测量观察器开销(#6840)并对齐全量凭据形态脱敏(#7733、#8181)。 #6712, #6840, #7733, #8181
  • @mikamikasuki:补充 Cordis 会话观察器验证(#5767)并更新目录安装恢复指引(#6000)。 #5767, #6000
  • @xiaoan17:在 DSH Web 侧栏接入 LoopX 个人工作台面板(#8352)。 #8352
  • @xiaobaifly7:补齐 Windows 原生续跑与 GoalBar 路径(#8504)、附着维护后重探准入(#8510)、保留预留续跑下的宿主上下文(#8517)、遵循探针取消(#8520)、保留安全准入阶段/原因(#8521)及读取调度周期提示(#8609)。 #8504, #8510, #8517, #8520, #8521, #8609

可选能力启用与使用

DSH LoopX plugin

启用: 将固定 GitHub tarball 或已发布的 dsh-loopx-plugin 包安装到 DSH web 或 desktop profile,再启动 DSH(dsh --profile web --port 0 或 loopx dsh-launch web),并在会话中执行 /loopx <task> 建立绑定。

dsh plugin --profile web add \
  "https://github.com/loopx-project/loopx/releases/download/dsh-loopx-plugin-v0.1.1-beta.7/dsh-loopx-plugin-0.1.1-beta.7.tgz"
dsh --profile web --port 0
loopx dsh-launch web

验证: 执行 dsh --profile web --dump-config 核对 0.1.1-beta.7 与四个组件行,在调用 /loopx 后执行 resolve-agent-thread 读回唯一绑定,并在本地运行 loopx dashboard 时确认 GoalBar 与侧栏 LoopX 面板。

停用 / 回退: 执行 dsh plugin --profile web remove dsh-loopx-plugin(0.1.1-beta.7 热卸载保持共享 Web 服务在线),或仅在兼容旧版的 DSH/LoopX 环境中重装 0.1.1-beta.6 归档包。

权限边界: 安装本身不创建 Goal 绑定、不激活 Driver、也不授予额外模型工具;Core 保留 Goal/Todo/配额与源码指纹 CAS 权威,侧栏 LoopX 面板不自行启动 Core 或写入状态。

文档: DSH 插件说明

DSH shadow observer

启用: 默认关闭;启动 DSH 前设置 LOOPX_DSH_SHADOW_OBSERVER_GOAL_ID、LOOPX_DSH_SHADOW_OBSERVER_SESSION_ID 与 LOOPX_DSH_SHADOW_OBSERVER_RUN_IDENTITY_JSON。

export LOOPX_DSH_SHADOW_OBSERVER_GOAL_ID="my-goal"
export LOOPX_DSH_SHADOW_OBSERVER_SESSION_ID="$DSH_SESSION_ID"
export LOOPX_DSH_SHADOW_OBSERVER_RUN_IDENTITY_JSON='{"worker_id":"worker-1","model_id":"model-1","task_id":"task-1","environment_id":"env-1","tools_id":"tools-1","budget_id":"budget-1","adapter_revision":"0.1.1-beta.7","observer_revision":"0.1.1-beta.7"}'
loopx reliability-diagnostics receipt --goal-id my-goal --format json
loopx reliability-diagnostics status --goal-id my-goal --format json

验证: 读取对应 Goal 的 receipt 与 status,核对来源覆盖、计数守恒与 public_safety_violation 计数;存在旧版账本时需先完成离线升级。

停用 / 回退: 取消设置上述三个环境变量并重启 DSH,既有诊断 NDJSON 数据保留不变。

权限边界: 仅在模块/Hook 层隔离的只读观察器,只记录事件类型、Turn/Step 编号与 ID,不记录提示词、参数、工具输出或本地路径,不调用 agent.send、调度或 LoopX CLI。

文档: 影子观察器配置

DSH native operation context

启用: 默认关闭(不在默认 cordis.patch.yml 中启用);如需试用,需在自定义 SDK Loader 补丁显式插入 loopx-native-operation-context。

node -e 'import("dsh-loopx-plugin/native-operation-context").then(m => console.log(Object.keys(m)))'

验证: 在自定义 Loader profile 中确认只读模型工具 loopx_operation_context 注册成功,并与当前会话绑定一致。

停用 / 回退: 从自定义 Loader 补丁移除 loopx-native-operation-context 条目并重启 DSH。

权限边界: 仅在已绑定会话作用域内提供只读上下文检查,不授予写入、调度或 Goal 修改权限。

文档: 原生操作上下文说明

npm trusted publishing

启用: 由维护者在已发布的非草稿 dsh-loopx-plugin-v0.1.1-beta.7 tag 上手动触发 dsh-plugin-publish.yml,通过 npm Trusted Publishing(--provenance)发布同一构建包。

gh workflow run dsh-plugin-publish.yml --repo loopx-project/loopx \
  --ref dsh-loopx-plugin-v0.1.1-beta.7 \
  -f release_tag=dsh-loopx-plugin-v0.1.1-beta.7
npm view dsh-loopx-plugin version dist-tags dist.tarball --json

验证: 核对工作流成功、npm dist-tags.latest == "0.1.1-beta.7"、verify-distribution.mjs --tarball ./dsh-loopx-plugin-0.1.1-beta.7.tgz 通过以及隔离 DSH_HOME 下的 dsh plugin add dsh-loopx-plugin。

停用 / 回退: 不触发 dsh-plugin-publish.yml 或由 npm 包所有者取消 Trusted Publisher 绑定;GitHub Release 资产仍可独立安装。

权限边界: 直接消费不可变 GitHub Release 产物而不重新构建;依赖 npmjs 包所有者的 Trusted Publisher 配置,不授予仓库或上游插件市场合并权限。

文档: 维护者发布与市场交接

发布验证

  • 基于精确提交 a6ffb3be6e7bdb48e02311ec58d618200fe0501c 完成构建与检查:npm run build && npm run typecheck && npm test 15 个测试文件共 372 条测试通过;打包产物 dsh-loopx-plugin-0.1.1-beta.7.tgz(34 个文件,SHA-256 42f5bd621e65bd80f5a7782098d297274c90e32faedfbb115102df91e3e7b800)并通过 DSH 0.2.2-rc.3 的全部 6 项包级 smoke(artifact / peer-range / mcp-transport / profile / runtime / registry)。
  • 真实 Windows 桌面交互安装与浏览器内嵌 Start/Pause 仍需在目标平台分别验证;离线 --offline --ignore-scripts 安装仅覆盖插件包本身,需预先具备兼容的 Node、pnpm、Python 与 LoopX CLI。