firmwareloop 0.11.1__tar.gz → 0.11.2__tar.gz

{firmwareloop-0.11.1 → firmwareloop-0.11.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.11.1
+Version: 0.11.2
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -234,7 +234,17 @@ fwloop setup
    | DeepSeek Harness (DSH) | `~/.dsh/profiles/<已派生 profile>/cordis.patch.yml` |
    | ZCode IDE | `~/.zcode/cli/config.json` |
 
-2. **同步技能包**（`firmwareloop`、`fwloop-adapter`）到 Antigravity 与 Claude Code 的全局 Skill 目录。
+2. **同步技能包**（`firmwareloop`、`fwloop-adapter`）到各 Agent 的全局 Skill 目录（探测式：Agent 主目录存在才写入，`skills/` 子目录自动创建）：
+
+   | Agent | Skill 写入位置 |
+   |---|---|
+   | Google Antigravity / Gemini CLI | `~/.gemini/antigravity-cli/skills/` |
+   | Claude Code CLI | `~/.claude/skills/` |
+   | Qoder / Qoder CN | `~/.qoder/skills/`、`~/.qoder-cn/skills/` |
+   | CodeBuddy IDE | `~/.codebuddy/skills/` |
+   | DeepSeek Harness (DSH) | `~/.dsh/skills/` |
+   | ZCode IDE | `~/.zcode/skills/` |
+   | 通用（跨 Agent 工具链） | `~/.agents/skills/`（特殊：无"未安装"概念，机器上不存在时直接创建） |
 3. **生成机器级全局配置** `%APPDATA%\FirmwareLoop\lab.yaml`（NdtBox 配置模板，已存在则不覆盖）。
 
 > 手动注册（可选）：Claude Code 也可逐条注册，效果相同：
@@ -439,7 +449,7 @@ claude mcp remove --scope user agentic-hil
 ├── demo-firmware/    示例固件（CMake；宿主编译模拟 MCU，闭环验证载体）
 ├── demo-make/        示例固件（Make；构建测试载体）
 ├── docs/             DEPENDENCY_MATRIX / REUSE_PLAN / V0.0.2_GAP_VERIFICATION
-├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.11.1)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.11.2)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -449,7 +459,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.11.1）
+## 能力验证状态（v0.11.2）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.11.1 → firmwareloop-0.11.2}/README.md

@@ -204,7 +204,17 @@ fwloop setup
    | DeepSeek Harness (DSH) | `~/.dsh/profiles/<已派生 profile>/cordis.patch.yml` |
    | ZCode IDE | `~/.zcode/cli/config.json` |
 
-2. **同步技能包**（`firmwareloop`、`fwloop-adapter`）到 Antigravity 与 Claude Code 的全局 Skill 目录。
+2. **同步技能包**（`firmwareloop`、`fwloop-adapter`）到各 Agent 的全局 Skill 目录（探测式：Agent 主目录存在才写入，`skills/` 子目录自动创建）：
+
+   | Agent | Skill 写入位置 |
+   |---|---|
+   | Google Antigravity / Gemini CLI | `~/.gemini/antigravity-cli/skills/` |
+   | Claude Code CLI | `~/.claude/skills/` |
+   | Qoder / Qoder CN | `~/.qoder/skills/`、`~/.qoder-cn/skills/` |
+   | CodeBuddy IDE | `~/.codebuddy/skills/` |
+   | DeepSeek Harness (DSH) | `~/.dsh/skills/` |
+   | ZCode IDE | `~/.zcode/skills/` |
+   | 通用（跨 Agent 工具链） | `~/.agents/skills/`（特殊：无"未安装"概念，机器上不存在时直接创建） |
 3. **生成机器级全局配置** `%APPDATA%\FirmwareLoop\lab.yaml`（NdtBox 配置模板，已存在则不覆盖）。
 
 > 手动注册（可选）：Claude Code 也可逐条注册，效果相同：
@@ -409,7 +419,7 @@ claude mcp remove --scope user agentic-hil
 ├── demo-firmware/    示例固件（CMake；宿主编译模拟 MCU，闭环验证载体）
 ├── demo-make/        示例固件（Make；构建测试载体）
 ├── docs/             DEPENDENCY_MATRIX / REUSE_PLAN / V0.0.2_GAP_VERIFICATION
-├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.11.1)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.11.2)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -419,7 +429,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.11.1）
+## 能力验证状态（v0.11.2）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.11.1 → firmwareloop-0.11.2}/firmwareloop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.11.1
+Version: 0.11.2
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -234,7 +234,17 @@ fwloop setup
    | DeepSeek Harness (DSH) | `~/.dsh/profiles/<已派生 profile>/cordis.patch.yml` |
    | ZCode IDE | `~/.zcode/cli/config.json` |
 
-2. **同步技能包**（`firmwareloop`、`fwloop-adapter`）到 Antigravity 与 Claude Code 的全局 Skill 目录。
+2. **同步技能包**（`firmwareloop`、`fwloop-adapter`）到各 Agent 的全局 Skill 目录（探测式：Agent 主目录存在才写入，`skills/` 子目录自动创建）：
+
+   | Agent | Skill 写入位置 |
+   |---|---|
+   | Google Antigravity / Gemini CLI | `~/.gemini/antigravity-cli/skills/` |
+   | Claude Code CLI | `~/.claude/skills/` |
+   | Qoder / Qoder CN | `~/.qoder/skills/`、`~/.qoder-cn/skills/` |
+   | CodeBuddy IDE | `~/.codebuddy/skills/` |
+   | DeepSeek Harness (DSH) | `~/.dsh/skills/` |
+   | ZCode IDE | `~/.zcode/skills/` |
+   | 通用（跨 Agent 工具链） | `~/.agents/skills/`（特殊：无"未安装"概念，机器上不存在时直接创建） |
 3. **生成机器级全局配置** `%APPDATA%\FirmwareLoop\lab.yaml`（NdtBox 配置模板，已存在则不覆盖）。
 
 > 手动注册（可选）：Claude Code 也可逐条注册，效果相同：
@@ -439,7 +449,7 @@ claude mcp remove --scope user agentic-hil
 ├── demo-firmware/    示例固件（CMake；宿主编译模拟 MCU，闭环验证载体）
 ├── demo-make/        示例固件（Make；构建测试载体）
 ├── docs/             DEPENDENCY_MATRIX / REUSE_PLAN / V0.0.2_GAP_VERIFICATION
-├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.11.1)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.11.2)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -449,7 +459,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.11.1）
+## 能力验证状态（v0.11.2）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.11.1 → firmwareloop-0.11.2}/firmwareloop.egg-info/SOURCES.txt

@@ -30,6 +30,7 @@ tools/test.ps1
 tools/common/build-backends.psm1
 tools/common/fw.psm1
 tools/common/uart_probe.py
+tools/installer/README.md
 tools/lib/__init__.py
 tools/lib/doctor_summary.py
 tools/lib/instruments.py

{firmwareloop-0.11.1 → firmwareloop-0.11.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "firmwareloop"
-version = "0.11.1"
+version = "0.11.2"
 description = "AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)"
 readme = "README.md"
 authors = [

{firmwareloop-0.11.1 → firmwareloop-0.11.2}/tools/__init__.py

@@ -2,4 +2,4 @@
 FirmwareLoop - AI Agent Firmware Development and Lab Automation Platform.
 """
 
-__version__ = "0.11.1"
+__version__ = "0.11.2"

{firmwareloop-0.11.1 → firmwareloop-0.11.2}/tools/can.ps1

@@ -61,8 +61,8 @@ if ($Backend -eq 'agentic-hil' -and -not $tool) {
 }
 
 # Resolve lab config for adapter/channel/bitrate defaults (never hardcoded)
-$labCfg = Join-Path $repoRoot 'lab\lab.yaml'
-if (-not (Test-Path -LiteralPath $labCfg)) { $labCfg = Join-Path $repoRoot 'lab\lab.example.yaml' }
+$labCfg = Join-Path (Join-Path $repoRoot 'lab') 'lab.yaml'
+if (-not (Test-Path -LiteralPath $labCfg)) { $labCfg = Join-Path (Join-Path $repoRoot 'lab') 'lab.example.yaml' }
 $canCfg = @{}
 if (Test-Path -LiteralPath $labCfg) {
     try {

{firmwareloop-0.11.1 → firmwareloop-0.11.2}/tools/flash.ps1

@@ -87,7 +87,7 @@ switch ($Backend) {
             Exit-WithError -Class 'TOOLCHAIN_NOT_FOUND' -Message 'pyocd 未找到。请在 Python 环境中安装 pyocd (`uv pip install pyocd`)。' -Detail 'pyOCD 用于通过 ST-LINK / CMSIS-DAP 烧录 STM32 芯片。'
         }
         $targetChip = 'stm32f103rc'
-        $labYaml = Join-Path $repoRoot 'lab\lab.yaml'
+        $labYaml = Join-Path (Join-Path $repoRoot 'lab') 'lab.yaml'
         if (Test-Path -LiteralPath $labYaml) {
             $labContent = Get-Content -LiteralPath $labYaml -Raw
             if ($labContent -match 'target_chip:\s*["'']?([^"''\r\n]+)') {

{firmwareloop-0.11.1 → firmwareloop-0.11.2}/tools/fw_mcp_server.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 """
-fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.11.1).
+fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.11.2).
 
 Exposes high-level firmware engineering and hardware management tools to AI Coding
 Agents (Antigravity CLI, Claude Code CLI, Qoder IDE, CodeBuddy IDE, DeepSeek Harness,
@@ -2610,7 +2610,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
                 },
                 "serverInfo": {
                     "name": "firmwareloop",
-                    "version": "0.11.1"
+                    "version": "0.11.2"
                 }
             }
         }
@@ -2745,7 +2745,7 @@ def _settle_stashed_entrypoints(stashed) -> None:
 def handle_cli_update() -> int:
     """Handle `firmwareloop update` command."""
     print("============================================================")
-    print("  FirmwareLoop Auto-Updater (v0.11.1)")
+    print("  FirmwareLoop Auto-Updater (v0.11.2)")
     print("============================================================")
 
     is_git_repo = os.path.exists(os.path.join(REPO_ROOT, ".git"))
@@ -3224,6 +3224,67 @@ def configure_codebuddy_user_mcp(user_home: str) -> Dict[str, Any]:
         return {"ok": False, "path": mcp_file, "reason": str(exc)}
 
 
+# setup [7] Skill 同步目标: 与 MCP 注册列表对齐 (MCP 支持哪个 Agent, Skill 就配哪个),
+# 另含 .agents 跨 Agent 通用约定。顺序对齐 setup 的 MCP 段编号。
+# 形状均为 <agent主目录>/<skills相对路径>/<skill>/<name>/SKILL.md; 探测判据 = agent
+# 主目录存在 (与各 MCP 段的 not_installed 语义一致; skills/ 子目录不存在时自动创建)。
+# 例外: .agents 是跨 Agent 通用约定, 无"未安装"概念 -> install_dir=None 免探测,
+# 机器上不存在时直接创建 ~/.agents 写入。
+SKILL_SYNC_TARGETS = [
+    # (显示名, agent 主目录[安装探测判据; None=通用免探测], 全局 skills 目录相对 user_home)
+    ("Antigravity", ".gemini", os.path.join(".gemini", "antigravity-cli", "skills")),
+    ("Claude Code", ".claude", os.path.join(".claude", "skills")),
+    ("Qoder", ".qoder", os.path.join(".qoder", "skills")),
+    ("Qoder CN", ".qoder-cn", os.path.join(".qoder-cn", "skills")),
+    ("CodeBuddy", ".codebuddy", os.path.join(".codebuddy", "skills")),
+    ("DSH", ".dsh", os.path.join(".dsh", "skills")),
+    ("ZCode", ".zcode", os.path.join(".zcode", "skills")),
+    (".agents (cross-agent)", None, os.path.join(".agents", "skills")),
+]
+
+GLOBAL_SKILL_NAMES = ("firmwareloop", "fwloop-adapter")
+
+
+def sync_global_skills(user_home: str) -> List[Dict[str, Any]]:
+    """把 GLOBAL_SKILL_NAMES 中的 skill 同步到各 Agent 全局 skills 目录 (表驱动)。
+
+    - 目标来自 SKILL_SYNC_TARGETS (与 setup 的 MCP 注册面对齐);
+    - 探测语义与 MCP 段一致: agent 主目录不存在 -> not_installed 跳过, 不创建;
+      install_dir=None 的通用目标 (.agents) 免探测, 不存在时直接创建;
+    - 已存在的 SKILL.md 无条件覆盖 (与既有 Antigravity/Claude 行为一致, 顺带
+      消除 skills-marketplace/手工安装造成的版本漂移);
+    - 源解析走 _skill_template_path(): 仓库 skills/ 优先, 安装态回退包内 templates。
+    返回 per-agent 结果: {"agent", "ok", "path", "synced"/"reason"/"warnings"}。
+    """
+    results: List[Dict[str, Any]] = []
+    for label, install_dir, skills_rel in SKILL_SYNC_TARGETS:
+        skills_dir = os.path.join(user_home, skills_rel)
+        if install_dir is not None and not os.path.isdir(os.path.join(user_home, install_dir)):
+            results.append({"agent": label, "ok": False, "path": skills_dir,
+                            "reason": "not_installed"})
+            continue
+        synced: List[str] = []
+        warnings: List[str] = []
+        for sk in GLOBAL_SKILL_NAMES:
+            sk_src = _skill_template_path(sk)
+            if not sk_src:
+                warnings.append(f"{sk}: 源缺失 (仓库 skills/ 与包内 templates/ 均未找到)")
+                continue
+            try:
+                target = os.path.join(skills_dir, sk)
+                os.makedirs(target, exist_ok=True)
+                shutil.copyfile(sk_src, os.path.join(target, "SKILL.md"))
+                synced.append(sk)
+            except OSError as exc:
+                warnings.append(f"{sk}: {exc}")
+        entry: Dict[str, Any] = {"agent": label, "ok": bool(synced),
+                                 "path": skills_dir, "synced": synced}
+        if warnings:
+            entry["warnings"] = warnings
+        results.append(entry)
+    return results
+
+
 DSH_MCP_CLIENT_PLUGIN = "@deepseek-ai/dsh-mcp-client"
 
 # DSH (DeepSeek Harness) profile patch entries. Tools surface as
@@ -3498,7 +3559,7 @@ def set_ndtdbg_dlldir(dll_path: str) -> str:
 def handle_cli_setup() -> int:
     """Handle `firmwareloop setup` command: simultaneously configure Antigravity CLI, Claude Code CLI, Qoder IDE, CodeBuddy IDE, DeepSeek Harness (DSH), and ZCode IDE."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.11.1)")
+    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.11.2)")
     print("============================================================")
     print("")
 
@@ -3612,30 +3673,19 @@ def handle_cli_setup() -> int:
     else:
         print(f"    - User MCP: [Warning] Could not write {zc_result['path']}: {zc_result.get('reason')}")
 
-    # 7. Global Skills Sync for Antigravity and Claude Code
-    # 源解析 (v0.9.2): 源码仓库 skills/<name>/SKILL.md 优先, 安装态回退包内
-    # tools/templates/skill-<name>.md (skills/ 不随 wheel 分发, 此前安装态静默 0 同步)。
+    # 7. Global Skills Sync — 目标表驱动 (SKILL_SYNC_TARGETS), 与 MCP 注册面全量对齐
+    # (外加 .agents 跨 Agent 通用约定); 探测式 (agent 主目录存在才写, not_installed
+    # 跳过)。源解析 (v0.9.2): 仓库 skills/<name>/SKILL.md 优先, 安装态回退包内
+    # tools/templates/skill-<name>.md (skills/ 不随 wheel 分发)。
     print(f"\n[7] Global Skills:")
-    ag_skills_dir = os.path.join(user_home, ".gemini", "antigravity-cli", "skills")
-    claude_skills_dir = os.path.join(user_home, ".claude", "skills")
-    skills_synced = 0
-    for sk in ["firmwareloop", "fwloop-adapter"]:
-        sk_src = _skill_template_path(sk)
-        if not sk_src:
-            print(f"    - {sk}: [Warning] skill 源缺失 (仓库 skills/ 与包内 templates/ 均未找到)")
-            continue
-        try:
-            ag_target = os.path.join(ag_skills_dir, sk)
-            os.makedirs(ag_target, exist_ok=True)
-            shutil.copyfile(sk_src, os.path.join(ag_target, "SKILL.md"))
-
-            cl_target = os.path.join(claude_skills_dir, sk)
-            os.makedirs(cl_target, exist_ok=True)
-            shutil.copyfile(sk_src, os.path.join(cl_target, "SKILL.md"))
-            skills_synced += 1
-        except Exception as exc:  # noqa: BLE001
-            print(f"    - {sk}: [Warning] {exc}")
-    print(f"    - Synchronized: [OK] {skills_synced} skills (firmwareloop, fwloop-adapter) to Antigravity & Claude Code")
+    for item in sync_global_skills(user_home):
+        if item["ok"]:
+            print(f"    - {item['agent']}: [OK] {', '.join(item['synced'])} -> {item['path']}")
+        elif item.get("reason") == "not_installed":
+            print(f"    - {item['agent']}: agent 主目录不存在, 跳过 (not_installed)")
+        else:
+            for warn in item.get("warnings") or [item.get("reason") or "unknown"]:
+                print(f"    - {item['agent']}: [Warning] {warn}")
 
     # 8. Machine-level global lab.yaml (ndtdbg config for the globally installed tool)
     global_cfg = ensure_global_lab_yaml()
@@ -3654,7 +3704,7 @@ def handle_cli_setup() -> int:
 def handle_cli_init(chip: Optional[str] = None, upgrade: bool = False) -> int:
     """Handle `firmwareloop init [target_chip]` command."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Project Initializer (v0.11.1)")
+    print("  FirmwareLoop Multi-Agent Project Initializer (v0.11.2)")
     print("============================================================")
     cwd = os.getcwd()
     print(f"[*] Initializing multi-agent guidelines & bench config in:\n    {cwd}\n")
@@ -3687,7 +3737,7 @@ def handle_cli_init(chip: Optional[str] = None, upgrade: bool = False) -> int:
 
 
 def print_cli_help() -> None:
-    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.11.1)
+    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.11.2)
 
 Usage:
   fwloop [command]   (or: firmwareloop [command])
@@ -3737,7 +3787,7 @@ def main() -> None:
         elif cmd in ["describe", "contract", "tools"]:
             sys.exit(handle_cli_describe(args[1] if len(args) > 1 else None))
         elif cmd in ["version", "-v", "--version"]:
-            print("FirmwareLoop v0.11.1")
+            print("FirmwareLoop v0.11.2")
             sys.exit(0)
         elif cmd in ["help", "-h", "--help"]:
             print_cli_help()

firmwareloop-0.11.2/tools/installer/README.md

@@ -0,0 +1,44 @@
+# 离线交付包安装器（NSIS 源码）
+
+这份目录收纳 `Fwloop_setup_pack` 一键安装器的 **NSIS 源码**（此前只存在于构建机的临时目录，
+丢失后无法重编 —— 2026-09-14 收纳入库）。
+
+| 文件 | 产物 | 用途 |
+| :--- | :--- | :--- |
+| `deploy_setup.nsi` | `Fwloop_setup_pack\fwloop-deploy-setup.exe` | 一键部署：fwloop 离线安装 + Agent 注册 + NdtBox 配置 + Saleae 固件 + sigrok-cli |
+| `install_firmware.nsi` | `Fwloop_setup_pack\assets\saleae-logic16-firmware-setup.exe` | Saleae Logic16 固件落位 `%LOCALAPPDATA%\sigrok-firmware`（支持 `/S`） |
+
+## 什么时候需要重编译
+
+**只需要同步 firmwareloop 版本时 —— 不需要**。安装器**不内嵌** wheels/python：它在目标机上从
+`$EXEDIR\assets\wheels` 离线安装（`uv tool install --find-links "$EXEDIR\assets\wheels" --offline ...`）。
+同步固件包版本的步骤：
+
+1. `uv build` 生成新 wheel；
+2. 用新 wheel 替换 `Fwloop_setup_pack\assets\wheels\firmwareloop-<旧>.whl`（依赖 wheel 不变则不动）；
+3. 更新 `Fwloop_setup_pack\README.md` 里的版本引用；
+4. 离线冒烟：`uv pip install --offline --find-links Fwloop_setup_pack\assets\wheels "firmwareloop==<新版本>"`
+   （装进临时 venv，验证 `fwloop --version`）。
+
+**改了安装器逻辑 / 升级内嵌 uv.exe 时 —— 需要**（见下）。
+
+## 如何编译
+
+1. 工具链：NSIS 3.08（https://nsis.sourceforge.io/download/ ，本机历史构建放在 `.tmp\nsis-build\nsis-3.08\`，
+   该目录易失，丢了重新下载解压即可）。
+2. 在**含 nsis-3.08 的目录**下执行（nsi 里的 `OutFile` 与资源相对路径按当时布局写死）：
+
+   ```powershell
+   cd <含 nsis-3.08 的目录>            # 例: .tmp\nsis-build
+   .\nsis-3.08\makensis.exe deploy_setup.nsi
+   ```
+
+3. `deploy_setup.nsi` 的 `OutFile` 是**绝对路径**（指向 `Fwloop_setup_pack\fwloop-deploy-setup.exe`），
+   换机器/换布局时先改这一行；资源引用形如 `..\..\Fwloop_setup_pack\assets\uv\uv.exe`（内嵌的只有 uv.exe）。
+
+## 交付包同步清单（每次发版）
+
+1. `uv build` + 替换 `assets\wheels\firmwareloop-*.whl`；
+2. 更新 `Fwloop_setup_pack\README.md` 的版本引用（`版本要求` / `wheels` 描述 / `fwloop version` 注释）；
+3. 离线冒烟（上面的第 4 步）；
+4. **不必**重编译 `fwloop-deploy-setup.exe`（除非改了安装器逻辑）。

{firmwareloop-0.11.1 → firmwareloop-0.11.2}/tools/lib/serial_assistant.py

@@ -1123,6 +1123,17 @@ def pid_alive(pid: int | None) -> bool:
             out = subprocess.run(["tasklist", "/FI", f"PID eq {int(pid)}", "/NH"],
                                  capture_output=True, text=True, timeout=10)
             return str(int(pid)) in (out.stdout or "")
+        # POSIX: 已退出但未被父进程收割的僵尸进程, os.kill(pid, 0) 依然报存活
+        # -> wait_pid_exit 永远超时 (CI Linux 实测)。/proc 可读时以进程状态为准。
+        stat_path = f"/proc/{int(pid)}/stat"
+        if os.path.exists(stat_path):
+            try:
+                with open(stat_path, encoding="utf-8") as fh:
+                    state = fh.read().rsplit(")", 1)[-1].strip()[:1]
+                if state:
+                    return state != "Z"
+            except OSError:
+                pass    # /proc 读失败 (非 Linux) -> 回退 os.kill 探测
         os.kill(int(pid), 0)
         return True
     except Exception:  # noqa: BLE001

{firmwareloop-0.11.1 → firmwareloop-0.11.2}/tools/logic_capture.ps1

@@ -67,11 +67,11 @@ if ($Backend -eq 'sigrok') {
 # ---- output layout ------------------------------------------------------------
 $stamp = Get-Date -Format 'yyyyMMdd-HHmmss'
 $runId = Get-FwRunId
-if (-not $OutDir) { $OutDir = Join-Path $repoRoot "artifacts\captures\$runId" }
+if (-not $OutDir) { $OutDir = Join-Path (Join-Path (Join-Path $repoRoot 'artifacts') 'captures') $runId }
 New-Item -ItemType Directory -Force -Path $OutDir | Out-Null
 
 # decoder config snapshot (read from lab/protocol-decode.yaml if present)
-$decodeCfg = Join-Path $repoRoot 'lab\protocol-decode.yaml'
+$decodeCfg = Join-Path (Join-Path $repoRoot 'lab') 'protocol-decode.yaml'
 $configOut = Join-Path $OutDir 'decoder-config.yaml'
 if (Test-Path -LiteralPath $decodeCfg) {
     Copy-Item -LiteralPath $decodeCfg -Destination $configOut -Force
@@ -265,8 +265,8 @@ else {
     if ($deriveRes.exit_code -ne 0 -or -not (Test-Path -LiteralPath $rawSigrok)) {
         Exit-WithError -Class 'LOGIC_CAPTURE_ERROR' -Message 'sigrok-cli CSV export from capture.sr failed.' -Detail ($deriveRes.stdout + $deriveRes.stderr)
     }
-    $convScript = Join-Path $repoRoot 'tools\sigrok_csv_to_fwloop.py'
-    $py = Resolve-FwPython
+    $convScript = Join-Path (Join-Path $repoRoot 'tools') 'sigrok_csv_to_fwloop.py'
+    $py = Resolve-FwPython -RepoRoot $repoRoot
     $convRes = Invoke-FwProcess -FilePath $py -Arguments @($convScript, $rawSigrok, $rawFile, $SampleRateHz) `
         -WorkingDirectory $repoRoot -TimeoutMs 120000
     if ($convRes.exit_code -ne 0 -or -not (Test-Path -LiteralPath $rawFile)) {
@@ -281,12 +281,12 @@ else {
 # ---- 摘要: 实际时长/截断 + 每通道活动 + 接线判定 (v0.9.2) ------------------------
 $summary = $null
 $summaryPath = Join-Path $OutDir 'capture-summary.json'
-$sumScript = Join-Path $repoRoot 'tools\logic_capture_summary.py'
-$sumPy = Resolve-FwPython
+$sumScript = Join-Path (Join-Path $repoRoot 'tools') 'logic_capture_summary.py'
+$sumPy = Resolve-FwPython -RepoRoot $repoRoot
 if ((Test-Path -LiteralPath $sumScript) -and $sumPy) {
     $sumArgs = @($sumScript, $rawFile, '--protocol', $Protocol, '--out', $summaryPath)
     if ($Backend -eq 'sigrok') { $sumArgs += @('--requested-s', "$DurationSec") }
-    $cfgPath = Join-Path $repoRoot 'lab\protocol-decode.yaml'
+    $cfgPath = Join-Path (Join-Path $repoRoot 'lab') 'protocol-decode.yaml'
     if (Test-Path -LiteralPath $cfgPath) { $sumArgs += @('--config', $cfgPath) }
     $sumRes = Invoke-FwProcess -FilePath $sumPy -Arguments $sumArgs -WorkingDirectory $repoRoot -TimeoutMs 60000
     if ($sumRes.exit_code -eq 0) {

{firmwareloop-0.11.1 → firmwareloop-0.11.2}/tools/logic_decode.ps1

@@ -96,7 +96,9 @@ if (-not (Test-Path -LiteralPath $rawFile)) {
 
 # ---- protocol/config resolution ------------------------------------------------
 $cfg = @{}
-$cfgPath = Join-Path $repoRoot 'lab\protocol-decode.yaml'
+# 跨平台注意: 子路径分段 Join-Path (字面量 'lab\protocol-decode.yaml' 在 Linux pwsh
+# 会变成文件名含反斜杠的单段路径, Test-Path 恒 False -> 通道映射静默回落 builtin-default)
+$cfgPath = Join-Path (Join-Path $repoRoot 'lab') 'protocol-decode.yaml'
 # YAML is not natively parseable in PowerShell; the venv python + PyYAML does it.
 if ($meta -and $meta.protocol) { $reqProtocol = [string]$meta.protocol } else { $reqProtocol = $null }
 if ($Protocol) { $reqProtocol = $Protocol }
@@ -110,7 +112,8 @@ $signalMap = [ordered]@{}
 $channelMapSource = 'builtin-default'
 $cfgBaud = 0
 if (Test-Path -LiteralPath $cfgPath) {
-    $pyCfg = Resolve-FwPython
+    # -RepoRoot 必传: 裸调用只找 PATH python, CI 上是没装 pyyaml 的系统解释器 -> 解析失败
+    $pyCfg = Resolve-FwPython -RepoRoot $repoRoot
     if ($pyCfg) {
         $pyScript = "import json,sys;sys.stdout.reconfigure(encoding='utf-8',errors='replace');" +
                     "import yaml;d=(yaml.safe_load(open(sys.argv[1],encoding='utf-8')) or {});" +

{firmwareloop-0.11.1 → firmwareloop-0.11.2}/tools/setup-agent-mcp.ps1

@@ -1,6 +1,6 @@
 <#
 .SYNOPSIS
-    Dual-Tier MCP setup and registration helper (v0.11.1).
+    Dual-Tier MCP setup and registration helper (v0.11.2).
     Inspects installed AI coding agents (Qoder, Claude Code, Antigravity, Cursor)
     and configures global MCP / skills or prints exact registration commands.
 
@@ -242,7 +242,7 @@ if ($Json) {
     Write-FwJson ([pscustomobject]$report)
 } else {
     Write-Host "============================================================" -ForegroundColor Cyan
-    Write-Host "  FirmwareLoop Dual-Tier MCP & Agent Setup Helper (v0.11.1)" -ForegroundColor Green
+    Write-Host "  FirmwareLoop Dual-Tier MCP & Agent Setup Helper (v0.11.2)" -ForegroundColor Green
     Write-Host "============================================================" -ForegroundColor Cyan
     Write-Host ""
     Write-Host "[1] Google Antigravity / Gemini CLI:" -ForegroundColor Yellow