@local/dsh-fang
dsh-Fang (瓮城) — 用于 DeepSeek Harness 的母体/分叉插件开发环境：一个只读母体、每个任务一个可弃用的子插件 dsh-Web、1 个编排器 + 12 个子插件。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:TwinsEarth/dsh-fang#3e0fe5a017cd7d2bb1f1106e03cf8b92155f2769Fang 以 @local/dsh-fang 发布，当前版本为 2.6.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
加载、运行、更新、回滚、卸载、回收，全生命周期管理。
1.用dsh-Web，当瓮城完成风险阻隔&审批（Beta） 2.DeepSeekHarness，当主城保存原样不变（稳定版）
母体大脑 + 分身器官 + 容器兜底：一个只读母体，每个任务派生一个用完即弃的子 dsh-Web； 开发都在分身里，母体只在「提升」时被显式更新。崩溃不扩散、污染不残留、插件不串味。
v2.3.1 把「瓮城」做进 Web UI（左侧导航 + 3:7 分屏控制面板 + 双击派生 + 母体/分身会话继续开发）； v2.0.0 按三层拓扑重新部署， 新增 Adapter 跨进程桥、任务语义、端口池、干净模板、Router 双阶段、评分环境阈值、 审计汇总、容器执行与申报写代理、商用钩子。
FANG_CONTAINER_LIVE=1 手动容器探针，已单独跑 9/9）；node tools/e2e.mjs → 41/41 checks passed（临时 $DSH_HOME + 真实 dsh 母体 + 真分身：
派生 → Adapter 握手 → 角色矩阵 → 任务/分身会话标题 → 归档 → 审计链 → 回收）；@local/dsh-fang bundle 层（通过 link: 指到本仓库，包版本 2.3.1）；sidebar.panellist 有 id=fang（order 90, active）、
main 的 key fang 已注册、dock 的 fang-badge active；宿主行 include:fang-session-catalog 已加载。dsh-fang-2.3.1.tgz + manifest.json，CI/compat 全绿；@twinsearth/dsh-fang@2.3.1 构建与本地 healthz 已就绪，等待 npm 组织 @twinsearth 创建后发布；sidebar.panellist）；单击 → 中列控制面板；双击图标 → 快速派生并打开分身标签页。main key=fang）：任务列表 + 母体已有会话列表，选中 → 确认条 → 继续开发（会话走 ≤32KiB lineage 种子）。规格与平台约束见 docs/UI-瓮城入口.md；交付记录见 docs/v2.3.1-交付报告.md。
git clone https://github.com/TwinsEarth/dsh-fang.git && cd dsh-fang
# 1. 离线自检（不修改任何东西）
node tools/fangctl.mjs doctor
node tools/fangctl.mjs status
# 2. 全量单测（node v24 不接受目录参数）
node --test --test-concurrency=1 "test/*.test.mjs"
# 3. 实机端到端验收（临时 $DSH_HOME + 真实 dsh 母体 + 真分身，不碰你的 profile）
node tools/e2e.mjs
# 4. 安装到当前 profile（DSH 内 plugin_manager install_bundle，target = 本目录）
安装后刷新页面：输入框下方出现「瓮城 N/M」徽标，点「门户」进入 /fang/panel：
$DSH_HOME、干净模板、Adapter 握手后 ready；| 行 id | 模块 | 母体 | 分身 | 职责 | 服务 key |
|---|---|---|---|---|---|
fang-orchestrator | orchestrator.mjs | ✅ | ❌ | 任务语义：create/status/promote/archive、门户 | fang |
fang-forker | forker.mjs | ✅ | ❌ | 端口池、spawn/kill、junction、URL 解析 | fangForker |
fang-restart-guard | restart-guard.mjs | ✅ | ❌ | 母体重启唯一闸门（只决策/审批/审计） | fangRestart |
fang-scorer | scorer.mjs | ✅（复核） | ✅（主） | 静态 A–E + 动作灯色，阈值按环境分叉 | fangScorer |
fang-router | router.mjs | ✅（初判） | ✅（复核） | decide / confirm（只升不降）/ 容器分支 | fangRouter |
fang-healer | healer.mjs | ❌ | ✅ | 自检/证据/G1–G12/补丁建议（不放行） | fangHealer |
fang-approver | approver.mjs | ✅（汇总） | ✅（本地） | 待批队列/A-B/监控/回滚 | fangApprover |
fang-hot-reloader | hot-reloader.mjs | ❌ | ✅ | 真 ESM 换版 + 健康窗 | fangHotReloader |
fang-buffer-keeper | buffer-keeper.mjs | ❌ | ✅ | 三态监视 + 容器申报写代理 | fangBuffer |
fang-auditor | auditor.mjs | ✅ | ✅ | 双侧哈希链审计 + aggregate | fangAudit |
fang-adapter | adapter.mjs | ❌ | ✅ | 跨进程桥：HTTP 控制/状态/审批/审计 | fangAdapter |
契约：CONTRACTS-V2.md · 协议：PROTOCOL-V2.md · 架构：ARCHITECTURE-V2.md · 变更：CHANGELOG.md。
src/kernel/role.mjs 单点决定；DSH_FANG_ROLE=fork 由 forker 注入，分身无法自升为母体。$DSH_HOME/fang/<profileTag>/；分身各用自己的 $DSH_HOME，天然隔离。node_modules 指向母版 junction；删除必须走 kernel removeTree()（junction 只解链）。sha256(canonical(record)+prevHash)，可发现改字段/删行/换序/伪造追加。strictRedLine=true 时 risk==='red' 必须显式 decide()；无人应答 fail-closed。parseWebUrl 只认带 ?token= 的启动行——裸地址 401。AppContainer 真实执行需 FANG_CONTAINER_LIVE=1 手动探针（CI 只覆盖降级路径）；
Job Object 层未接入；分身会话迁移/跨宿主接管未做；Relay 付费五项只有钩子与配置开关。
v1 运行中的宿主缓存旧模块，v2 生效需母体重启（红线：由用户确认执行）。
完整清单见 ARCHITECTURE-V2.md §8。
| 层 | 路径 | 协议 | 你能做什么 |
|---|---|---|---|
| 核心层 | src/ · probes/ · client.js · cordis.patch*.yml · test/ · tools/e2e.mjs | AGPL-3.0-or-later | 自由使用/修改；对外提供网络服务时须按 AGPL 提供源码 |
| 生态层 | sdk/ · tools/fangctl.mjs | MIT | 零摩擦复制、修改、二次分发、闭源集成 |
| 商业层 | relay-server/ · enterprise/ | 商业许可（闭源） | 需购买许可；不随开源分发包 |
fangwenxin@geefish.com。SPDX-License-Identifier；test/licensing.test.mjs 防止分层漂移。