Repository navigation
dsh-loopx-plugin 0.1.1-beta.7
Pre-releasedsh-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_v2closeout: Enforcesloopx>=2.4.0across bootstrap, Driver, and GoalBar (#8899), integrates progressive capture admission (#8543), consumesquota receiptandquota_settlement_plan_v2closeouts (#8879,#9147), exposescontinuationAdmissionerrors and source fingerprints in GoalBar, and fences canceled maintenance or probe returns (#8510,#8520,#8856). - DSH
0.2.2-rc.1..rc.3qualification & hot-uninstall isolation: Qualifies DSH0.2.2-rc.1through0.2.2-rc.3(retaining0.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 dashboardworkspace 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-contextsubpath (#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 webValidation: 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 jsonValidation: 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 --jsonValidation: 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 (includingadmission-closeout.integration.spec.ts14 tests coveringquota_settlement_plan_v2closeouts).npm pack(34files,88.8 kBcompressed,345.7 kBunpacked): tarball SHA-25642f5bd621e65bd80f5a7782098d297274c90e32faedfbb115102df91e3e7b800.- DSH smokes (
pnpm 10.33.0, DSH0.2.2-rc.3):smoke:artifact,smoke:peer-range,smoke:mcp-transport,smoke:profile,smoke:runtime, andsmoke:registry -- --tarball ./dsh-loopx-plugin-0.1.1-beta.7.tgzall passed. - Real Windows desktop interactive installation and mounted browser Start/Pause remain separate platform/manual checks; offline
--offline --ignore-scriptsinstallation 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适配与热卸载隔离: 适配 DSH0.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 test15 个测试文件共 372 条测试通过;打包产物dsh-loopx-plugin-0.1.1-beta.7.tgz(34 个文件,SHA-25642f5bd621e65bd80f5a7782098d297274c90e32faedfbb115102df91e3e7b800)并通过 DSH0.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。