goatliamia/dsh-runtime-react--plugins-runtime-progress7

dsh-runtime-progress-legacy

LEGACY reference plugin (superseded 2026-09-02): seam-based shell-lock reaction. The package name dsh-runtime-progress now belongs to core/runtime-progress (the Progress fact layer); this reference stays only as a seam-usage example.

包名
dsh-runtime-progress-legacy
版本
0.1.0
许可证
MIT
最近更新
2026年9月2日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:goatliamia/dsh-runtime-react#c61c18f82509629417c7441f2ccbcb83f6d49155&path:plugins/runtime-progress

dsh-runtime-progress

Reference runtime-* plugin on top of dsh-runtime-seam (host-only): demonstrates how a domain capability composes with the seam — a shell-lock guard, plus an onActivity reaction for no-progress circuit events.

参考插件:展示 domain 能力如何挂在 dsh-runtime-seam 上——shell-lock 守卫示例 + 对 circuit 介入记录的响应。它不是功能承诺,是写法样板

它演示了什么

  1. 注入 seamcordis.patch.ymlinject: [runtimeSeam]),用 seam.setFact 声明一个确定性事实。
  2. Guard 示例shell-lock 事实存在时,拒绝对锁定 shell 的操作(seam.registerGuard,教学式 reason)。
  3. onActivity 反应:监听 circuit-open 介入记录,做自己的记录/降级处理(不拦截、不改变 seam 行为)。
  4. 宿主空转runtimeSeam 缺失时静默退出,不拖垮 boot。

安装

cd plugins/runtime-progress
pnpm pack
dsh plugin add dsh-runtime-progress-.tgz

依赖 dsh-runtime-seam(workspace file: 依赖,发布前替换为版本号)。

新写一个 runtime-* plugin 的最小步骤

1. 回答贡献清单 docs/contribution.md 的 9 个问题(确定性部分是否真的存在?)
2. cordis.patch.yml 声明 inject: [runtimeSeam](可选注入)
3. setFact 声明事实 → registerGuard 守卫动作边界 / onActivity 响应介入
4. 宿主失败必须可隔离:缺 seam、缺事实、异常都不影响其他 plugin

文档

  • 机制与证据:仓库根 README.md(English)/ README.zh-CN.md(简体中文)
  • 贡献边界:docs/contribution.md
  • 实验记录:docs/status/runtime-*.md