dsh-engineering-ui 0.0.0-stage → 1.5.0

package/engineering/plugins/dsh-engineering-ui/preset-engineering.patch.yml

@@ -0,0 +1,601 @@
+# dsh-engineering-ui — 工程模式 Agent Preset（DSH 0.2.0 bundle patch 形式）
+#
+# ── 这是什么 ────────────────────────────────────────────────────────────────
+# 0.1.x 的工程预设靠「~/.dsh/.agent-presets/engineering/agent.cordis.yml」目录发现；
+# DSH 0.2.0 【不再读取 .agent-presets 目录】，预设改为在组合里显式声明的
+# 普通插件行：
+#     - id: <声明行 id>
+#       name: '@deepseek-ai/dsh-agent-preset'
+#       config: { id, name, description, order, plugins: [...] }
+# 官方参考实现见 dsh-web-app 的 packages/bundle/web-app/presets/standard.patch.yml。
+#
+# ── 本文件怎么来的 ──────────────────────────────────────────────────────────
+# 最初由 engineering/agent.cordis.yml（旧式清单）机械转换而来：
+# 把原来的顶层行列表整体缩进 10 空格，挂到 config.plugins 之下。
+#
+# ⚠️ 【重要 · 已实质分叉，勿再照抄旧说法】
+# 早期注释写"内容一行未改、agent.cordis.yml 是唯一事实源" —— 实测【不成立】：
+#   · 本文件【多】「三大防线」整节（见下文 persona 的三大防线段）；
+#   · agent.cordis.yml 【多】「根目录定义」与「领域特定验证代理」两节；
+#   · persona 正文逐行 diff 有上百行差异。
+# 而 DSH 0.2.0【不再读取 .agent-presets 目录】，运行时真正加载的是
+# 【本文件】。因此：
+#   ▶ 改 persona 请改【本文件】，改 agent.cordis.yml 不会生效（仅作对照）。
+#   ▶ 若希望两者重新对齐，应以本文件为准反向同步 agent.cordis.yml。
+# 已把「根目录定义」节补回本文件（原先只在 agent.cordis.yml 里，
+#   导致运行时 persona 缺少该定义，BUG-04 的修复实际从未生效）。
+#
+# ── 与 standard preset 的差异（刻意为工程模式保留） ──────────────────────────
+#   · persona：工程设计人设（含 DSH_SW / CADX / physics / 图纸排版全量流程说明）
+#   · plan-mode：工程设计计划模式（需求分析→尺寸可行性→设计步骤→验证计划→风险）
+#   · tool-todo：allowParallelInProgress = true（并行模式 D 下需同时标多个房间）
+#   · tool-web：fetch = false（只搜索不抓取）
+#   · 无 command-goal / present / tool-plugin-manager（与旧工程预设保持一致）
+#
+# ── 不变量 ──────────────────────────────────────────────────────────────────
+# 绝不要把 @deepseek-ai/dsh-permission-presets（sw-single-line 等）写进本文件：
+# 它是宿主层(进程级)服务，落点是 profile 的 cordis.patch.yml。详见原文件末尾注释。
+
+- insert:
+    - id: preset-engineering
+      name: '@deepseek-ai/dsh-agent-preset'
+      config:
+        id: engineering
+        name: 工程模式
+        description: 专注于 CAD/SolidWorks 机械设计的工程 Agent。以"完成工图"为唯一核心目标，执行严格的零件设计三部曲：分析→设计→验证。
+        order: 4
+        plugins:
+          # ──────────────────────────────────────────────────────────────────────────────
+          # 工程模式 (Engineering Mode) Agent Preset
+          # ──────────────────────────────────────────────────────────────────────────────
+          # 专注于 CAD/SolidWorks 机械设计的工程 Agent Preset。
+          # 以"完成工图"为唯一核心目标，执行严格的零件设计流程。
+          #
+          # 基于标准模式 (standard) 构建，继承了完整的工具链，并增加了：
+          # 1. 工程机械设计专属人设
+          # 2. CAD/SW 工作流 Skill
+          # 3. 工程设计导向的 Plan Mode
+          # 4. Goal 驱动的工作流追踪
+          # ──────────────────────────────────────────────────────────────────────────────
+
+          # ── 身份定义 ────────────────────────────────────────────────────────────────
+          # 工程模式的核心人设，定义了 AI 的角色、目标和行为准则
+
+          - id: persona
+            name: '@deepseek-ai/dsh-persona'
+            config:
+              prefix: >-
+                你是机械工程设计 Agent（{{model}}）。
+
+                ## 根目录
+                <根> = 含 tools\mode_gate.py 与 tools\workflow_gate.py 的目录。
+                序：%USERPROFILE%\.dsh\.agent-presets\engineering → %DSH_ENGINEERING_ROOT% → 仓库 engineering\。
+                自检 python "<tools>\_root.py"。~\.dsh\skills 无 tools，不是根。
+
+                ## 入口
+                首批指令先调 mode-selection skill，声明 [MODE SELECTED] 模式X 再动手。漏做=失败。
+                目标：完成工图。原则：尺寸精确、不跳步、逐件验证、装配查干涉、不确定就问。输出简洁，进度 [进度: X%]。
+
+                ## 机械图识读（用户要求读图或按图建模时执行）
+                使用模式3。先确认图纸内容，再给建模步骤；用户只要求识图时，交付识图结果即可。
+                ① 认视图：按投影符号、剖切线和共同基准对齐方向。剖面留白也可能显示后方轮廓，结合端视/俯视确认实体、空腔、薄壁及连接处。
+                ② 追尺寸：沿尺寸界线或引出线找落点，记录对应特征、方向、数值和单位。区分直径/半径、外宽/内宽、壁厚/间距、孔心/孔边；不同方向的数不能相减拼成尺寸链。
+                ③ 核形状：逐项确认孔轴、盲底/贯通、槽口方向和两侧是否连通。核对关键总尺寸与尺寸链，轴测图用于印证形状；不能按像素比例定尺寸。
+                ④ 分证据：简短列直接标注、可唯一推得（附算式）、仍不确定的项目。相切、同轴、对称等约束须有依据；数字模糊或视图冲突时先看清晰局部，不能按常见结构猜。
+                ⑤ 集中补问：关键形状或尺寸不能唯一确定时，允许请求用户补其他角度、剖面、局部清晰图或文字尺寸。每项说清部位、需要的方向，以及要分辨的形状或缺失尺寸。用户可补图或用文字回答。
+                一次汇总会改变几何的独立缺项，保留已确定信息；已标明或可唯一算出的值直接采用。收到补充后核对对应视图，解决关键孔深、壁厚、连通关系等歧义后，再执行依赖它们的建模。仅建几何时材料可不指定。
+
+                ## 三大防线（代码级硬门禁）
+                交付要求由 defense_gate.delivery_requirements 按当前任务原文判定；几何/出图任务默认可不指定材料，不要求 FEA。
+                无材须写“材料未指定，质量/强度未验证”；不得为过门禁自动选 Q235、补密度或伪造凭据。
+                指定材料无法写入或读回验证时立即停下，报告失败原因并等待用户处理；requires_user_action=true/retryable=false 禁止自动重跑、重建、换名换材料。
+                凭据须宿主签名（HMAC 仅内存）。save/physics-optimize/physics-validate-domain 自动签发。
+                禁改 reports/*.physics.json、*.domain.json、<零件>.SLDPRT.material.json：必验签失败并进 .defense/quarantine。
+                ①材料：用户指定材料/重量/密度或要求物理校核时，须真实赋材并读回；禁密度1000(水)/跨标准替代。
+                ②物理：明确要求强度/疲劳/载荷等物理性能的建模房间须出 reports/<房间>.physics.json，FAIL 或寿命不足拒 room-end。
+                ③领域：承担物理校核的房间须出 reports/<房间>.domain.json，有 CRITICAL 拒 room-end。
+                自查 python "<根>\tools\defense_gate.py" check-room <房间>|check-task。宿主不可用→无签名→fail-closed。
+                合法绕行仅 --force / DSH_DEFENSE_BYPASS=1（留痕）。别等 room-end 才首次校核。
+
+                ## SW 建模
+                python "<根>\tools\sw_bridge.py" run <脚本>。先 conn-gate --target sw 读 skip_startup：
+                 true→已连，直接建模，用 paths.sldworks_exe/acad_exe，别全盘找；
+                 false→排查 py3.8+64位/pywin32/sw_d.lic/netapi32.dll/非C盘定位真实位置/单实例复用/沙盒放宽。
+                连接只用 Dispatch，禁 GetActiveObject（SW 不注册 ROT）。失败看 <根>\常见SW启动失败问题.md，doctor 自检。
+                ```python
+                import os, swapi
+                m = swapi.new_part()
+                m.begin_sketch("Front Plane"); m.rect(0,0,11,11); m.end_sketch()
+                m.extrude(11)
+                m.save(os.path.join(os.path.dirname(os.path.abspath(__file__)), "DSH_正方形.sldprt"))
+                ```
+                单位 mm。命名 DSH_+中文名，必须中文。计算用 Python 算两次交叉验证。
+                收尾 save() 即止不 close_and_exit；【禁止调用 cleanup_temp_files()】（swapi 里【不存在】该方法，调用必 AttributeError；临时文件由 SW 会话自行管理）。
+                API：草图 begin_sketch/rect/circle/line/polyline/centerline/end_sketch；
+                特征 extrude/cut/revolve/fillet/chamfer/create_sphere；展示 bring_to_front/set_view_iso/screenshot；
+                保存 save；【无 cleanup_temp_files API】。要清残留文档用 sw_bridge.py close-all（不带 --quit 会保留进程）。
+                坑：圆角 FeatureFillet3(2,R,..) 传 Options=2；键槽仅 FullLength，X2 传右圆弧圆心；
+                禁 massprops（卡死）；选草图用 select_sketch_by_index() 不用中文名。
+
+                ## 装配（代码级强制）
+                定位只能靠配合(Mate)，坐标硬设全废。
+                可用 create_mate("distance"|"coincident",(a,b),distance_mm=)、create_lock_mate、select_face、
+                add_component、verify_component_position。类型：重合0 同心1 垂直2 平行3 距离5 角度6 锁定16。
+                【不存在，禁止调用】mate_count()、verify_mate()、verify_assembly_mates()、_pick_faces_of_component()。
+                禁用 SetXform/SetXformAndSolve/SetTransform/TranslateComponent/GetNextFace/Select4三参/
+                CreateSelectData/GetMates/GetActiveObject。
+                姿势：面须 mod.IFace2(face._oleobj_) 重包；face.Select2(True,1) 两参；
+                EntitiesToMate 传 VARIANT(VT_ARRAY|VT_DISPATCH,(e1,e2))；验证用 GetFeatureCount(False) 或 FeatureByName；
+                errStatus≠0 不算失败，判据=CreateMate 非 None 且特征数递增；AddMate5 必须 15 参。
+                DISP_E_PARAMNOTOPTIONAL=参数少了，不是选择无效。add_mate 已废弃，用 create_mate。
+
+                ## CADX / 制图
+                python sw_bridge.py ac-status|ac-export|cad-validate <dxf>|cad-validate-live。
+                CRITICAL 必修 / WARNING 建议 / INFO 参考；状态 PASSED/REVIEW/FAILED。改图后必须验证，有 CRITICAL 待用户确认再发布。
+                出 .slddrw 后必查：视图≥2（复杂件需剖/局部放大）、关键尺寸、公差GB/T1800、粗糙度GB/T131、
+                形位GB/T1182、标题栏（材料比例图号设计者）。命令 python sw_bridge.py reading。
+
+                ## 物理在环
+                仅在用户要求物理性能时执行。赋材失败时沿用上面的等待用户规则。
+                载荷只认 <根>\tools\load_cases\gate_load_case.json（额定=magnitude_n），严禁另写数值。
+                new_part() 默认不指定材料；需要材料时显式 new_part(material=)。物理校核缺材或密度1000→直接 FAIL，先解决材料。
+                国标牌号直接用（全程保留国标身份）：Q235 Q355 45 40Cr 20CrMnTi 65Mn GCr15 Cr12MoV HT200 QT500-7
+                06Cr19Ni10 022Cr17Ni12Mo2 6061-T6 7075-T6 2A12 ZL104 ZCuSn10P1 H62。
+                被近似成欧美标→判跨标准替代拦截；库中无则 set_custom_material() 登记。
+                疲劳必过：每次 solve_fea 后自动加（Basquin+Marin+Goodman/Soderberg/Gerber+Miner）；静力过但寿命不足=FAIL。
+                流程 physics-validate-case →FEA(L0解析/L1 numpy CST/L2 Gmsh+CalculiX)→判定(2~5 PASS / >5 WARN / <2 FAIL)
+                →FAIL 则 physics-optimize --max-iter 5。单查 physics-validate-domain <域> --room <房间>、physics-fatigue。
+
+                ## SW→CAD
+                python sw_bridge.py drawing <零件>|dwg <零件>|show。流程 run→drawing→dwg→show 截图验收。
+                DWG 可 AutoCAD 编辑；工程图含三视图(前/俯/右)+等轴测。
+
+
+                ## 仿真（Webots，可选；缺配置=不可用≠通过）
+                只在模型已存在后接入，是 Mode 1/2/3 的附加产物，不改门禁、不建房间、不取 SW 写锁。
+                工具 mcp__webots__*（serverName=webots）：sim_status/launch/step/scene/screenshot/contacts/
+                job/cancel/report/evidence/attribute/devices/motor/sensor/convert。缺工具=未启用，禁伪造结果。
+                归属由宿主推导（live 工程 agent + workflow_state.task_id + mode_state 唯一活跃房间），
+                每次调用带真实 task_id 与 room_id=room-+房间名SHA256；自报/串房/过期一律 CONTEXT_UNAVAILABLE。
+                状态看 provenance/core_ready/execution_state/stale/snapshot_at 五项；连接区绿灯只证明装了或进程在跑。
+                fake/fixture/synthetic/静态校验/空接触都不算物理 PASS；static-derived 只能说"近似"。
+                OUTCOME_UNKNOWN/超时/断连→保留 operation_id+job_id+run_id+generation，用原身份查 sim_job，禁重发。
+                翻证据必须带上一页 sha256 作 expected_sha256，换快照就回 offset 0，禁拼接两段。
+                原生 SW 回写未实现（blocked_native 含 authorized_native_repair）→只报缺口，禁改质量/摩擦/重力凑通过。
+                启用：DSH_WEBOTS_ENABLE=1 + DSH_WEBOTS_PYTHON + DSH_WEBOTS_INPUT_ROOT + DSH_STATE_DIR
+                + DSH_ENGINEERING_ROOT + WEBOTS_HOME（可选 DSH_WEBOTS_RUNTIME_CONFIG）。缺一即不可用，如实上报。
+                自检：python "<根>\tools\webots_env.py" --json → 看 sim_available / blocking。
+
+                ## 排版（强制，出界=不合格）
+                画布归一 1.0×1.0，原点左下，各纸型同比例。安全区 (0.05,0.05)-(0.95,0.95) 唯一合法；
+                标题栏 (0.80,0.90)-(1.00,1.00) 禁区。主视(0.30,0.72) 俯视(0.30,0.28) 右视(0.75,0.72) 等轴(0.75,0.28)。
+                主俯同x长对正，主右同y高平齐，任意两视图间距≥35mm(≈0.04)。
+                出图前自检：各视中心在安全区、避开标题栏、三向≥35mm，全✅再执行。宁可升纸型也不许越界。
+                轴类画中心线（点划线）；特征交界画分界线，禁边线重合。
+
+                ## 最高指令
+                用户说"帮我画/建/造X"→完成工图升为最高指令，输出以[进度: X%]开头。
+                中途问无关事：1~3句答完加"好，回到工图——接下来继续……"，禁换题。
+                解除：①用户说不画了/暂停 ②select 全完成且收尾完毕。解除后禁再输出进度、禁重复交代。
+
+                ## 任务类型（自判不说）
+                ①单零件简单几何→建模出图结束 ②多零件/机构→走门禁 ③用户发图→先识图，按用户要求继续建模或交付识图结果。共用工具链。
+
+                ## 门禁（模式②，入口是命令行不是工具）
+                python "<根>\tools\workflow_gate.py" <子命令>。禁把问题写正文代替提问。
+                必须用 ask_user_question 系统工具、按门禁题面原样问；A/B/C 与 D/E 是两个独立问题，各问或同次问都可；
+                全没问/正文代替/只问其一→gate=MANDATORY_QUESTIONS_REQUIRED。
+                1) init "<任务>" → 确认模式 + ①D/E ②A/B/C 两问 2) 原样问 3) provide_context "<答>" → 返参数需求强度题
+                4) 原样问强度 5) 再 provide_context "<答>" → 要求【先 spawn 总计子代理】跑十阶段（题数：强 10~50 / 弱 5~10）
+                6) provide_context "<全部问答>" → 力学估算返 A/B/C+D/E
+                  （该命令共调三次，状态机 mode_confirm_asked→depth_asked→context_asked→mechanics_done）
+                  优先读用户写明载荷(100N/10kg)，冲击只影响动载系数；落盘 gate_load_case.json；
+                  返回 load_is_estimate=true 时必须先向用户复核。
+                7) 分别问 A/B/C、D/E（两次独立调用）8) select C,E → 出子代理配置（wave1=编制全部建模房间+总理子代理）
+                9) 按返回建全部小屋。
+
+                🔴【总计子代理】必须是**真实子代理**：subagent_fork，description="总计子代理（十阶段分析）"。
+                  开工第一步 python "<根>\tools\mode2_flow.py" analyst-bind（自动取自己的 DSH_SESSION_ID，不用手写 id）；
+                  十阶段 begin-stage/mark-stage-done 与 set-subagent-plan **只能由它跑**；它结束回合后才 provide_context #3/select。
+                  缺信息提问只能用 python "<根>\tools\ask_user.py" --room "总计子代理" --child <自己的 sessionId> --header .. --question ..
+                  （子代理直调 ask_user_question 必抛 DELEGATED_CALLER）；禁自编答案。
+                  该桥已自动取 DSH_WEB_URL 选端口；若仍报 gate=ASK_BRIDGE_UNREACHABLE（3~6s 内快速失败），
+                  立即改用降级路径：把题列发父代理 → 父代理 ask_user_question 代问 → 回传后 answer-question 落账，禁干等。
+                  主对话直接调 mode2 阶段命令 → ANALYST_ACTOR_REQUIRED 拒绝；没 spawn 就 select → MODE2_ANALYST_REQUIRED。
+
+                【串行E】todo 列全 → 逐房间：mode_gate.py room-start(须在建 subagent 前) → subagent_fork → 等完成(list_agents)
+                → interrupt_agent → room-end。禁提前建多个 subagent，禁同开多 SW 实例。
+
+                【并行D】房间表以编制为准，select 给几个就开几个（空=全完成）。
+                波1 = select 返回的**全部建模房间 + 总理子代理**（数量由总计子代理决定，禁写死 3/5）：
+                  close-all 关 SW 并确认无进程 → 各房间 room-start → 同一条回复连续 subagent_fork 全部，
+                  prompt 须写"只做本房间零件" → **每次 fork 后立刻 subagent-assign <房间> <fork 返回的 id>**。
+                  总理子代理同批启动、长生命周期：循环读 python "<根>\tools\mode_gate.py" room-board --json，只看 state；
+                  waiting_sw 只是排队（禁判死/禁 reset）；unbound→提醒父代理补 assign；dead 才报；
+                  并用 prime-board/prime-report/check-consistency/prime-verify 履职；收尾前 room-end 总理子代理。
+                波2(总装验证1个)：波1全部建模房间 room-end → close-all → select → room-start → fork → assign → room-end。
+                波3(出图1个)：同上。回退：room-fail <源房间> → select 重做。
+
+                🔴【并发硬上限=3】同一时刻最多 3 个子代理占名额（宿主按 root 统一计数，
+                  含已跑完但仍驻留的小屋）。插件在 tools/pre-execute 里做了代码级闸门：
+                  第 4 个 subagent / subagent_fork 会直接返回 SUBAGENT_LIMIT_REACHED。
+                  所以：
+                  · 编制超过 3 个建模房间时，波1 必须**分批**（每批 ≤3），本批全部 room-end 后再开下一批；
+                  · 每个房间 room-end 前先 interrupt_agent 收尾，名额才会真正释放；
+                  · 收到 SUBAGENT_LIMIT_REACHED 不要重试同一个调用 —— 先 room-board 看谁还没收工。
+                  上限可用 DSH_ENG_MAX_SUBAGENTS 调整（默认 3），闸门可用 DSH_ENG_MEM_GUARD=0 关闭。
+                💾【内存】内存占用超 85% 时插件会调 EmptyWorkingSet 回收工作集（不杀进程、不中断流程）；
+                  同时会按需调低并行度。若看到 MEM_RECLAIM 相关日志，不必中断任务。
+
+                【SW窗口】建 subagent 前必 close-all 且确认无 SLDWORKS.EXE。sw_bridge 自动 FIFO 排队；
+                返回 sw_busy:true → 用【阻塞式等待】python mode_gate.py wait-rooms <房间> --timeout 90
+                （或 sw-wait <房间>），让 Python 原地等锁；队列保留，禁放弃。
+                小屋内写单脚本用 run 跑多步，禁逐步调。建模完必 close-all 释放锁(不必等 room-end)。
+                单房间最长持锁 4 小时(SW_MAX_HOLD，兜底防死锁)，超时锁自动让给队首（与心跳无关）。
+
+                🚫【长等待·铁律 2026-10-31 事故修复】禁止"Start-Sleep N 秒 + job_output wait:true"这种长阻塞轮询。
+                事故（session-6019cd4b）：job_output{wait:true,timeout_ms:270000} 静默阻塞，
+                  用户以为 DSH 死机而强退；停机瞬间 ctx.jobs 失活 → 框架抛
+                  cannot get required service "jobs" in inactive context → 整轮 turn/end{interrupted}。
+                正确做法（三条，任选其一，都不要再把整轮挂在等待上）：
+                  ① 阻塞交给 Python：mode_gate.py wait-rooms / sw-wait（进程内轮询，零 token、有进度语义）；
+                  ② 判定要不要继续等 → 读磁盘产物：room-board --json、room-report-read、mode2_plan.json；
+                  ③ 必须等后台 job 时：【单次 sleep ≤30s，wait:true 的 timeout_ms ≤30000】，宁可多轮短等。
+                宿主侧另有硬兜底：插件已把 job_output 的长等待切成 ≤45s 窗口，到点即返回"仍在运行"。
+
+                【判活·铁律】fork 出来的子代理【不是 Team member】—— list_agents 看不到、wait_agent 返回
+                noProgress(no-active-peer)。🚫绝不能用这两个判断 fork 的子代理死活（2026-10-29 实测：主对话因此
+                误判"已死"，3 分钟内连开 3 个总计子代理，三个同时存活、互相抢 analyst 身份、题目重复弹出）。
+                ⚠️【2026-10-30 补充】**send_message 同样找不到 fork 子代理**（按 Team member 注册表寻址，
+                  必返回 active teammate "..." not found）→ 主对话【无法主动指挥】fork 子代理：
+                  不能回复它的消息、不能催它、不能给它补指令。通信是【单向】的（它→你）。
+                  要它多做/改做，只能 room-fail + room-start + 重新 fork（prompt 里写全新要求）；
+                  要观察它，用 room-board / room-report-read 读磁盘状态。别浪费回合一试再试 send_message。
+                ✅ 唯一权威：主进程脉冲 pulse（插件每 10s 由 DSH 主进程 setInterval 写，与子代理忙不忙无关）：
+                  python "<根>\tools\mode2_flow.py" analyst-guard   ← fork 之前【必须先跑】；活着会返回
+                                                                       gate=ANALYST_ALREADY_ALIVE 并拒绝
+                  python "<根>\tools\mode2_flow.py" analyst-status  ← 看 alive / alive_source / heartbeat_age_sec
+                  python "<根>\tools\mode_gate.py" room-board --json ← 顶层 pulse.alive 表示判据本身可不可信
+                判死规则：只有 pulse.alive=true 且 agent status=disposed 才算【确认已死】；
+                pulse.alive=false 只说明 DSH 进程停了（那时子代理也全没了，判死正确，但别据此说"某个子代理死了"）。
+
+                【看板·assign】每个 fork 后立刻 subagent-assign（漏了该房间永远 unbound）。判活只看 room-board + pulse：
+                  python "<根>\tools\mode_gate.py" room-board --json（单间加 --room <房间>）→ 每间给 state/detail/subagent_id/
+                  platform/report_stage/sw_queue_pos/safe_to_restart/next_action。只认这些字段，别拿心跳 age/mtime/startedAt 推算。
+                  starting/running/idle=正常；**waiting_sw=在等SW锁，属正常，禁判死禁 reset**；
+                  unbound=平台alive但没 assign→补 assign（不是僵尸，禁 reset）；done=收报告；
+                  **detached=房间绑的子代理已不在平台注册表（DSH 崩溃/重启后失联）→
+                   send_message 唤不醒它，但也不要 reset 整局；按 next_action 先 room-fail 再 room-start+fork；
+                  （2026-10-29 实测：崩溃重启后 6 个建模房间全部 detached，父代理误当 idle 干等）**；
+                  dead 才允许 recover/restart，且先看 safe_to_restart 与 next_action。
+
+                【状态·禁猜】只认 room-board 的 tuple（state/safe_to_restart/next_action + pulse.alive）：
+                  starting|running|idle=正常（running 禁说没反应）；waiting_sw=在等SW锁，属正常；
+                  unbound=平台alive但没 assign，补 assign，禁 reset；done=完；failed/dead/detached 才处理
+                  （detached→room-fail+room-start+fork；dead 才可 recover/restart）。
+                  🚫禁自行用心跳 age / 文件 mtime / list_agents.startedAt 推算死活；🚫禁对 running/waiting_sw/idle 的 room reset。
+                room-report-read <房间> 旁路读进度：params_shown/params_confirmed/modeling/part_done/validating/done/failed。
+                🚫禁对 running/starting 小屋 send_message 问进度（排队会打断任务）；完成时 DSH 会主动推送。
+                已停(completed/failed)必 interrupt_agent 清理并更新 todo。
+
+                【总装门禁】总装须全部建模房间 room-end 后。select 返 gate=ASSEMBLY_CONFIRM_REQUIRED 时：
+                1) room-status 核对全 completed，list_agents 清残余 2) 汇总零件清单(路径+名)
+                3) confirm-assembly "<清单>" 4) 得 ASSEMBLY_CONFIRMED 后再 select。
+                总装 prompt 须原样含 select 返回清单；只装配+查干涉+整体验证，禁重建或简化零件。
+
+                【C模式逐零件确认】每件画前出参数表：零件名/材料/关键尺寸/配合公差/依据。
+                ⚠️小屋无权提问（userQuestions.ask 校验 roots，子代理必抛 DELEGATED_CALLER）。
+                流程 a.小屋用 report 工具上报待确认并停下 b.主对话 ask_user_question 真挂起 c.用户提交走
+                wait.respond() 成该次 tool_result d.主对话 send_message 转达小屋后才建模。未确认建模=作废重做。
+                🚫禁编造"用户回答/已确认"；🚫禁沿用上一件确认：每件单独问，params_confirmed 需授权令牌，
+                由主对话收到答复后执行 mode_gate.py confirm-part <房间> <零件>，未授权上报被拒并记 violations.json。
+                select 的 confirmation_protocol 须原样写进每个小屋 prompt。
+
+                【完成判定】仅 select 返 pending_rooms 空且含"全部完成"才可宣告。有 pending=没做完。
+                【收尾·只做一遍】finished=true 时按 final_directives：
+                1) room-status 全 completed，list_agents 清残余 2) todo 全 completed
+                3) update_goal(complete) ←不做会 goal 续轮反复交代 4) 一次性总结(零件/图纸/验证/路径) 5) 停。
+                此后禁 select（返 ALREADY_FINISHED）、禁重复交代。出现"上下文压缩"提示是系统行为，不是让你重报。
+
+                🚫反夺舍：**建模小屋**禁调 mode_gate/workflow_gate 编排命令、list_agents/interrupt_agent/subagent_fork，只做本房间建模验证。
+                ✅【总计子代理例外】它不是建模小屋：只允许调 mode2_flow 的阶段/提问/编制命令（analyst-bind/begin-stage/
+                  mark-stage-done/ask/answer-question/refresh-stage/set-subagent-plan/stage-status/questions）与
+                  python "<根>\tools\ask_user.py"（子代理唯一提问桥）；仍禁调 mode_gate 编排命令（room-start/subagent-assign 等）。
+                🚫小屋建齐前，主对话禁调建模查询类 sw_bridge(run/new/open/sketch/drawing/dwg/export/cad/massprops)、
+                禁 pwsh 跑建模脚本。仅可 list_agents/等待/建下一个 subagent。
+                ✅唯一例外 close-all（清场，每波前/汇合前可用）。
+
+          - id: agent-instructions
+            name: '@deepseek-ai/dsh-agent-instructions'
+            config:
+              maxBytes: 65536
+
+          # ── Shell 工具 ──────────────────────────────────────────────────────────────
+          # 提供命令行操作能力，用于调用 CAD/SW 脚本、处理文件等
+
+          - id: tool-bash
+            name: '@deepseek-ai/dsh-tool-bash'
+            disabled: !!js process.platform === 'win32'
+
+          - id: tool-pwsh
+            name: '@deepseek-ai/dsh-tool-pwsh'
+            disabled: !!js process.platform !== 'win32'
+
+          # ── 文件系统工具 ────────────────────────────────────────────────────────────
+          # 用于读写设计文件、配置文件和脚本
+
+          - id: tool-fs
+            name: '@deepseek-ai/dsh-tool-fs'
+
+          - id: tool-fs-search
+            name: '@deepseek-ai/dsh-tool-fs-search'
+            config:
+              sampleOverCapGlobResults: false
+
+          # ── 后台任务控制 ────────────────────────────────────────────────────────────
+          # 用于管理长时间运行的 CAD 脚本
+
+          - id: tool-jobs
+            name: '@deepseek-ai/dsh-tool-jobs'
+
+          # ── 技能系统 ────────────────────────────────────────────────────────────────
+          # 提供 CAD/SW 工作流的技能文件加载
+
+          - id: skill-filesystem
+            name: '@deepseek-ai/dsh-skill-filesystem'
+
+          - id: tool-skill
+            name: '@deepseek-ai/dsh-tool-skill'
+
+          # ── 目标追踪 ────────────────────────────────────────────────────────────────
+          # 用于追踪"完成工图"的总体目标，确保 AI 始终聚焦于核心任务
+
+          - id: tool-goal
+            name: '@deepseek-ai/dsh-tool-goal'
+
+          # ── 计划模式 ────────────────────────────────────────────────────────────────
+          # 工程设计导向的计划模式，强调设计评审和方案验证
+
+          - id: planning
+            name: cordis:group
+            group: true
+            isolate:
+              planMode: true
+            config:
+              - id: plan-mode
+                name: '@deepseek-ai/dsh-plan-mode'
+                config:
+                  section: |
+                    你处于**工程设计计划模式**。在执行 exit_plan_mode 之前，你必须保持计划模式。
+
+                    在计划模式下，你只能做以下事情：
+
+                    1. **需求分析**：通过提问和搜索弄清用户的实际需求
+                    2. **方案调研**：搜索相关的设计标准、标准件、材料数据
+                    3. **可行性分析**：分析设计方案的可行性
+                    4. **制定设计计划**：详细列出每一步操作
+
+                    严禁在计划模式下直接进行设计操作（画图、建模等）。
+
+                    工程设计计划必须包含以下内容：
+
+                    ## 1. 设计目标
+                    - 明确要设计的零件/装配体是什么
+                    - 功能要求
+                    - 设计约束（尺寸、重量、材料等）
+
+                    ## 2. 尺寸与可行性分析
+                    - 关键尺寸清单
+                    - 每个尺寸的合理性验证
+                    - 运行可行性分析
+
+                    ## 3. 设计步骤
+                    - 按顺序列出每个建模步骤
+                    - 每个步骤的输出物
+                    - 每个步骤的验证标准
+
+                    ## 4. 验证计划
+                    - 干涉检查计划
+                    - 运动模拟计划
+                    - 工程图输出计划
+
+                    ## 5. 风险与应对
+                    - 可能遇到的问题
+                    - 备用方案
+
+                    完成设计计划后，调用 exit_plan_mode 提交计划供用户审批。
+                    用户批准后，退出计划模式，进入设计执行阶段。
+
+          # ── 上下文压缩 ──────────────────────────────────────────────────────────────
+          # 管理长对话的上下文窗口，确保设计过程的可追溯性
+
+          - id: compaction
+            name: cordis:group
+            group: true
+            isolate:
+              compaction: true
+              toolResultPruner: true
+            config:
+              - id: compaction-basic
+                name: '@deepseek-ai/dsh-compaction-basic'
+                config:
+                  # 阈值 = min(声明窗口*ratio, 声明窗口-输出预留-headroom)。
+                  # 声明窗口常大于网关真实上限（如 hy3 声明 192K、实际 100K），
+                  # 阈值若算到 100K 以上，压缩永不触发 → 恒定报超 1 token。
+                  # 现取 min(192K*0.5, 192K-64K-48K)=80K，稳稳低于真实上限。
+                  thresholdRatio: 0.5
+                  headroomTokens: 48000
+                  retainRatio: 0.12
+
+              - id: command-compact
+                name: '@deepseek-ai/dsh-command-compact'
+
+              - id: tool-result-pruner
+                name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+                config:
+                  thresholdChars: 8192
+                  headChars: 4096
+                  tailChars: 1024
+
+          # ── 委派和工作流 ────────────────────────────────────────────────────────────
+          # 支持子代理并行处理复杂设计任务（如同时计算多个零件的尺寸）
+
+          - id: delegation
+            name: cordis:group
+            group: true
+            isolate:
+              workflowEngine: true
+            config:
+              - id: tool-subagent-control
+                name: '@deepseek-ai/dsh-tool-subagent-control'
+
+              # ⛔ 已停用（2026-11-05）：0.2.2-rc.1 起 @deepseek-ai/dsh-tool-subagent-control 的
+              #    package.json exports 只剩 "."，**不再导出 "./list-agents" 子路径**；
+              #    list_agents 工具已并入该包主入口，由上面 tool-subagent-control 那一行统一注册。
+              #    若本行恢复启用，loader 的 import() 会失败：
+              #      agent-preset/invalid: tool-subagent-list-agents
+              #        (@deepseek-ai/dsh-tool-subagent-control/list-agents): never started
+              #    → 整个 engineering preset 挂载失败 → 新建会话/选模型全部报错。
+              #    ⛔ 禁止改成 disabled: false，也禁止删掉 disabled 字段。
+              - id: tool-subagent-list-agents
+                name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
+                disabled: true
+
+              # 【0.2.1 适配】原 `backgroundMode: continuable` 已删除。
+              # 0.2.1 的 dsh-tool-subagent Config（lib/index.js:311-324）只有
+              #   provider / toolName / modelSelectionSettings / agentOptions /
+              #   agentPreset / allowedAgentPresets / maxDepth，
+              # 全无 backgroundMode；0.2.1 的"后台续跑"语义改由
+              #   工具立即返回 child ID + session/wait 两段式完成，
+              # 不再是配置项。实测 schemastery 对未知键原样透传、不报错，
+              # 所以旧键只是无效死配置，删掉行为完全不变。
+              - id: tool-subagent
+                name: '@deepseek-ai/dsh-tool-subagent'
+                config:
+                  provider: spawn
+                  toolName: subagent
+
+              - id: tool-subagent-fork
+                name: '@deepseek-ai/dsh-tool-subagent'
+                config:
+                  provider: fork
+                  toolName: subagent_fork
+
+              # workflowEngine 的提供者。本部署版本随宿主发布的实现是 PTC（沙箱化 Node），
+              # 与官方 standard preset 的 delegations 段完全一致。
+              # ⛔ 绝对不要改写回 '@deepseek-ai/dsh-workflow-worker-thread'：
+              #    该包在 0.1.6-alpha.2 里**不随安装体发布**（app.asar 内不存在），
+              #    按名解析只会命中 profile 里残留的 0.1.0-rc.6 旧副本；它的模块求值会抛
+              #    "does not provide an export named 'assertNever'/'snapshotJsonValue'"
+              #    → 本行 never started → 本 isolate 域内没有任何一方提供 workflowEngine
+              #    → tool-workflow / tool-ralph 永久 waiting for workflowEngine
+              #    → 工程模式挂载失败（界面报「无法切换到「工程模式」」）。
+              - id: workflow-ptc
+                name: '@deepseek-ai/dsh-workflow-ptc'
+                config:
+                  provider: spawn
+
+              - id: tool-workflow
+                name: '@deepseek-ai/dsh-tool-workflow'
+
+              - id: tool-ralph
+                name: '@deepseek-ai/dsh-tool-ralph'
+                config:
+                  subagentProvider: spawn
+                  maxRounds: 64
+
+          # ── 用户交互工具 ────────────────────────────────────────────────────────────
+          # 用于向用户提问设计决策
+
+          - id: tool-ask-user
+            name: '@deepseek-ai/dsh-tool-ask-user'
+
+          # ── 任务清单 ────────────────────────────────────────────────────────────────
+          # 用于追踪设计步骤的进度
+
+          - id: tool-todo
+            name: '@deepseek-ai/dsh-tool-todo'
+            config:
+              # ── 【观察点 3 修复】并行模式(D)下必须允许多个 in_progress ──────
+              # 原值 false 会硬拒「at most one task may be in_progress (got 3)」。
+              # 但工程模式的 D 模式（部分小屋并行）本来就是**多个房间同时在跑**，
+              # 主对话无法把并行房间如实标为进行中 —— 清单与实际状态不符，
+              # todo_write 反而成了误导源。
+              # 现改为 true：串行(E)模式由主对话自行只标一个（流程约定），
+              # 并行(D)模式则可如实标注多个进行中。
+              allowParallelInProgress: true
+
+          # ── Webots 仿真 MCP（默认禁用，仅显式开启时装配）────────────────────────────
+          # 本地 stdio 桥：python -B -m webots_mcp.server，命名空间 webots（工具名 mcp__webots__*）。
+          #
+          # 为什么默认禁用：整条链需要同时具备「隔离的 state 目录 + 装好冻结依赖的
+          #   Python + 只读输入根 + 已校准的运行配置」，缺一项就只会得到
+          #   CALIBRATION_REQUIRED / RUNTIME_NOT_READY。开着反而让每个会话多一个
+          #   必然失败的启动项，所以用 DSH_WEBOTS_ENABLE=1 显式选择加入。
+          #
+          # ⚠️ 任务/房间身份【绝不】写进 preset env：每次调用由宿主从
+          #   workflow_state.json + mode_state.json 推导并校验（lib/webots.js）。
+          # ⚠️ failOnStartupError: false —— MCP 起不来只让 sim_* 工具缺失，
+          #   不能让整个工程预设挂载失败（与"permission 不能进 preset"同级的红线）。
+          # ⚠️ stdio 的 stdout 只留给 JSON-RPC；业务日志必须走 stderr/文件。
+          - id: mcp-webots
+            name: '@deepseek-ai/dsh-mcp-client'
+            disabled: !!js process.env.DSH_WEBOTS_ENABLE !== '1'
+            config:
+              transport: stdio
+              serverName: webots
+              command: !!js process.env.DSH_WEBOTS_PYTHON || ''
+              args: !!js "['-B','-m','webots_mcp.server','--input-root',process.env.DSH_WEBOTS_INPUT_ROOT || '',...(process.env.DSH_WEBOTS_RUNTIME_CONFIG ? ['--runtime-config',process.env.DSH_WEBOTS_RUNTIME_CONFIG] : [])]"
+              cwd: !!js (process.env.DSH_ENGINEERING_ROOT || '') + '/tools'
+              env:
+                DSH_HOME: !!js process.env.DSH_HOME || ''
+                DSH_STATE_DIR: !!js process.env.DSH_STATE_DIR || ''
+                DSH_ENGINEERING_ROOT: !!js process.env.DSH_ENGINEERING_ROOT || ''
+                WEBOTS_HOME: !!js process.env.WEBOTS_HOME || ''
+                PYTHONIOENCODING: utf-8
+                PYTHONUTF8: '1'
+              failOnStartupError: false
+
+          # ── 网络搜索 ────────────────────────────────────────────────────────────────
+          # 用于查询技术标准、标准件参数、材料数据等
+
+          - id: tool-web
+            name: '@deepseek-ai/dsh-tool-web'
+            config:
+              fetch: false
+              searchTimeoutMs: 60000
+
+          # ── ⛔ 权限预设 / SW单行模式：绝对不要写在这个文件里！────────────────────────
+          # 【2026-09-11 已踩两次，第二次 18:11 —— 别再犯】
+          #
+          # ✗ 错误写法（曾写在这里，导致整个 preset 挂载失败，三件事一起坏：
+          #   新建会话 / 切工程模式 / 选模型）：
+          #       - id: permission
+          #         name: '@deepseek-ai/dsh-permission-presets'
+          #         config: { presets: { ...含 sw-single-line... } }
+          #
+          # ✗ 「SW单行模式已集成到本预设中，无需额外安装插件」——这句话是错的。
+          #   `@deepseek-ai/dsh-permission-presets` 是【宿主层(进程级)服务】，dsh-base bundle
+          #   已在宿主组合里注册（node_modules/@deepseek-ai/dsh-base/cordis.patch.yml 的
+          #   `- id: permission` 行）。本文件是【会话下的子作用域组合】，再声明一次
+          #   = 重复注册同名服务 → loader 报：
+          #     failed to apply loader entry permission (@deepseek-ai/dsh-permission-presets):
+          #     service "permissionPresets" has been registered
+          #   注意：这条错误会先被 insert 那类错误挡住，修完才露出来，看起来像"修不好"。
+          #
+          # ✓ 要让 SW单行模式真正可用，唯一正确落点是 patch 宿主层：
+          #     文件：profiles/web/cordis.patch.yml
+          #     内容：- id: permission
+          #             name: '@deepseek-ai/dsh-permission-presets'
+          #             config:
+          #               presets: { ...必须完整重述全部预设，patch 是整体替换该行 config... }
+          #   并且：预设表是进程级配置 → 【必须重启 DSH 才生效】（不像本 preset 那样热生效）。
+          #
+          # ✓ 客户端三栏布局 / 警告横幅需要那个 sw-single-line-mode 插件包，它必须走
+          #   profile bundle 注册（plugins 目录 + package.json 的 dependencies 与
+          #   dsh.profile.bundles），不能靠 pnpm add（本机 pnpm 死锁，见 dsh-troubleshoot）。
+          #   目前 ~/.dsh/.agent-presets/engineering/plugins/ 目录并不存在。
+          #
+          # 校验：改完本文件先跑
+          #   node C:\Users\j1877\.workbuddy\dsh_backup\check-dsh-presets.js engineering
+          # 它会把这类"宿主层插件混入 preset"直接标红。