firmwareloop 0.7.3__tar.gz → 0.8.0__tar.gz

{firmwareloop-0.7.3 → firmwareloop-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.7.3
+Version: 0.8.0
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -18,7 +18,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pyvisa>=1.14.0
-Requires-Dist: pyvisa-py>=0.7.3
+Requires-Dist: pyvisa-py>=0.7.4
 Requires-Dist: pyserial>=3.5
 Requires-Dist: pytest>=8.0.0
 Requires-Dist: pyocd>=0.36.0
@@ -177,6 +177,8 @@ fwloop setup
    | Claude Code CLI | `~/.claude.json` |
    | Qoder / Qoder CN | `~/.qoder/mcp.json`、`~/.qoder-cn/mcp.json` |
    | CodeBuddy IDE | `~/.codebuddy/mcp.json` |
+   | DeepSeek Harness (DSH) | `~/.dsh/profiles/<已派生 profile>/cordis.patch.yml` |
+   | ZCode IDE | `~/.zcode/cli/config.json` |
 
 2. **同步技能包**（`firmwareloop`、`fwloop-adapter`）到 Antigravity 与 Claude Code 的全局 Skill 目录。
 3. **生成机器级全局配置** `%APPDATA%\FirmwareLoop\lab.yaml`（NdtBox 配置模板，已存在则不覆盖）。
@@ -383,7 +385,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.7.3)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.8.0)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -393,7 +395,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.7.3）
+## 能力验证状态（v0.8.0）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -401,6 +403,7 @@ claude mcp remove --scope user agentic-hil
 | 能力 | 状态 |
 |---|---|
 | 双层 MCP 服务（13 个工作流与硬件工具） | Implemented + Protocol Validated（31/31 测试通过） |
+| fwloop setup 一键注册（7 Agent：Antigravity / Claude Code / Qoder(+CN) / CodeBuddy / DeepSeek Harness / ZCode） | Implemented + Multi-Agent Validated（DSH / ZCode 真机写入验证） |
 | 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（55 例单测: 含残留 serve 自动清理 / close 进程回收 / UTF-8 线路 / 失败落 JSONL）-> Real Hardware Validated 待 DUT |
 | 一键多 Agent 脚手架（fwloop init / fw_init_project） | Implemented + Multi-Agent Validated |
 | 自定义/私有调试工具接入 Skill（fwloop-adapter） | Implemented + Multi-Skill Validated |
@@ -437,10 +440,10 @@ claude mcp remove --scope user agentic-hil
 | 串口 `SERIAL_PORT_ERROR: ... PermissionError(13)` | 端口被 GUI 上位机独占（NDT Debug Tool / STDataCollection.exe、串口助手）→ 关闭占用方后 `fw_serial_open`；残留会话用 `fw_serial_close`（已自动等待/强杀进程，端口释放可验证） |
 | `fw_serial_status` 的 `error_class` 为 `UART_BUSY` | 会话未打开或已被占用 → 先 `fw_serial_open`；残留会话 `fw_serial_close` 清理 |
 | `fw_serial_*` 报 `PermissionError(13)` / `rx_bytes: 0` | 串口被独占：**退出 NDT Debug Tool GUI（STDataCollection.exe）**——它打开时会同时占住 Box 串口与 USB-IIC 通道；失败信封/`fw_serial_status` 的 `suspected_holders` 会直接列出嫌疑进程（注意别杀 MCP server 的 python） |
-| 烧录"擦除生效（probe 从非 00 变 00）但校验读回全 FF"、`pages_written` 已发出 | v0.7.1 及更早的逐笔 serve 路径问题 → v0.7.3 起默认走 `flash_engine: bridge`（桥内单体，与 GUI 同进程模型）；要复现/排查旧行为用 `flash_engine: "serve"` |
+| 烧录"擦除生效（probe 从非 00 变 00）但校验读回全 FF"、`pages_written` 已发出 | v0.7.1 及更早的逐笔 serve 路径问题 → v0.7.4 起默认走 `flash_engine: bridge`（桥内单体，与 GUI 同进程模型）；要复现/排查旧行为用 `flash_engine: "serve"` |
 | 长调用（capture/measure）客户端超时 | MCP stdio 循环是**单线程**的：长调用会让同会话其它调用排队（含 3s 的小调用）→ 缩短窗口，或用 `fw_ndtdbg_stream_start` job 模式 |
 | 烧录报 `INCOMPLETE_FLASH` | 桥内 flash 连续 30s 无进度（疑似卡在写入中途）→ **芯片处于半擦写态，勿直接使用，必须重新完整烧录**；信封带 `chip_state: partially_erased` 与 `post_kill_power_cycle`（已尝试复位） |
-| 烧录报 `COLD_BOOT_VERIFY_FAILED` | **Flash 字节已通过逐窗校验，但断电重上电后目标没有有效应答/与期望不符**（现场 `.18` 类问题：GUI 报成功、当场可读，冷启动 `Fw_ver = -1`）→ 按固件冷启动路径排查（看门狗/时钟/外设初始化）；或用 `cold_boot_expect` 指定期望值、`cold_boot_check: false` 关闭 |
+| 烧录报 `COLD_BOOT_VERIFY_FAILED` | **Flash 字节已通过逐窗校验，但断电重上电后目标没有有效应答/与期望不符**（现场失败形态：烧录工具报成功、当场可读，冷启动后却读不到版本）→ 按固件冷启动路径排查（看门狗/时钟/外设初始化）；或用 `cold_boot_expect` 指定期望值、`cold_boot_check: false` 关闭 |
 | `fw_serial_status` 的 `port_probe.openable = false` | 端口当前**无法独占打开**（硬结论）→ 看 `holder_candidates`（`source: cmdline` 比 `name` 准，候选≠持有者）确认占用方 |
 
 完整速查表与手工部署细节见 [`Fwloop_setup_pack/README.md`](Fwloop_setup_pack/README.md)。

{firmwareloop-0.7.3 → firmwareloop-0.8.0}/README.md

@@ -149,6 +149,8 @@ fwloop setup
    | Claude Code CLI | `~/.claude.json` |
    | Qoder / Qoder CN | `~/.qoder/mcp.json`、`~/.qoder-cn/mcp.json` |
    | CodeBuddy IDE | `~/.codebuddy/mcp.json` |
+   | DeepSeek Harness (DSH) | `~/.dsh/profiles/<已派生 profile>/cordis.patch.yml` |
+   | ZCode IDE | `~/.zcode/cli/config.json` |
 
 2. **同步技能包**（`firmwareloop`、`fwloop-adapter`）到 Antigravity 与 Claude Code 的全局 Skill 目录。
 3. **生成机器级全局配置** `%APPDATA%\FirmwareLoop\lab.yaml`（NdtBox 配置模板，已存在则不覆盖）。
@@ -355,7 +357,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.7.3)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.8.0)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -365,7 +367,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.7.3）
+## 能力验证状态（v0.8.0）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -373,6 +375,7 @@ claude mcp remove --scope user agentic-hil
 | 能力 | 状态 |
 |---|---|
 | 双层 MCP 服务（13 个工作流与硬件工具） | Implemented + Protocol Validated（31/31 测试通过） |
+| fwloop setup 一键注册（7 Agent：Antigravity / Claude Code / Qoder(+CN) / CodeBuddy / DeepSeek Harness / ZCode） | Implemented + Multi-Agent Validated（DSH / ZCode 真机写入验证） |
 | 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（55 例单测: 含残留 serve 自动清理 / close 进程回收 / UTF-8 线路 / 失败落 JSONL）-> Real Hardware Validated 待 DUT |
 | 一键多 Agent 脚手架（fwloop init / fw_init_project） | Implemented + Multi-Agent Validated |
 | 自定义/私有调试工具接入 Skill（fwloop-adapter） | Implemented + Multi-Skill Validated |
@@ -409,10 +412,10 @@ claude mcp remove --scope user agentic-hil
 | 串口 `SERIAL_PORT_ERROR: ... PermissionError(13)` | 端口被 GUI 上位机独占（NDT Debug Tool / STDataCollection.exe、串口助手）→ 关闭占用方后 `fw_serial_open`；残留会话用 `fw_serial_close`（已自动等待/强杀进程，端口释放可验证） |
 | `fw_serial_status` 的 `error_class` 为 `UART_BUSY` | 会话未打开或已被占用 → 先 `fw_serial_open`；残留会话 `fw_serial_close` 清理 |
 | `fw_serial_*` 报 `PermissionError(13)` / `rx_bytes: 0` | 串口被独占：**退出 NDT Debug Tool GUI（STDataCollection.exe）**——它打开时会同时占住 Box 串口与 USB-IIC 通道；失败信封/`fw_serial_status` 的 `suspected_holders` 会直接列出嫌疑进程（注意别杀 MCP server 的 python） |
-| 烧录"擦除生效（probe 从非 00 变 00）但校验读回全 FF"、`pages_written` 已发出 | v0.7.1 及更早的逐笔 serve 路径问题 → v0.7.3 起默认走 `flash_engine: bridge`（桥内单体，与 GUI 同进程模型）；要复现/排查旧行为用 `flash_engine: "serve"` |
+| 烧录"擦除生效（probe 从非 00 变 00）但校验读回全 FF"、`pages_written` 已发出 | v0.7.1 及更早的逐笔 serve 路径问题 → v0.7.4 起默认走 `flash_engine: bridge`（桥内单体，与 GUI 同进程模型）；要复现/排查旧行为用 `flash_engine: "serve"` |
 | 长调用（capture/measure）客户端超时 | MCP stdio 循环是**单线程**的：长调用会让同会话其它调用排队（含 3s 的小调用）→ 缩短窗口，或用 `fw_ndtdbg_stream_start` job 模式 |
 | 烧录报 `INCOMPLETE_FLASH` | 桥内 flash 连续 30s 无进度（疑似卡在写入中途）→ **芯片处于半擦写态，勿直接使用，必须重新完整烧录**；信封带 `chip_state: partially_erased` 与 `post_kill_power_cycle`（已尝试复位） |
-| 烧录报 `COLD_BOOT_VERIFY_FAILED` | **Flash 字节已通过逐窗校验，但断电重上电后目标没有有效应答/与期望不符**（现场 `.18` 类问题：GUI 报成功、当场可读，冷启动 `Fw_ver = -1`）→ 按固件冷启动路径排查（看门狗/时钟/外设初始化）；或用 `cold_boot_expect` 指定期望值、`cold_boot_check: false` 关闭 |
+| 烧录报 `COLD_BOOT_VERIFY_FAILED` | **Flash 字节已通过逐窗校验，但断电重上电后目标没有有效应答/与期望不符**（现场失败形态：烧录工具报成功、当场可读，冷启动后却读不到版本）→ 按固件冷启动路径排查（看门狗/时钟/外设初始化）；或用 `cold_boot_expect` 指定期望值、`cold_boot_check: false` 关闭 |
 | `fw_serial_status` 的 `port_probe.openable = false` | 端口当前**无法独占打开**（硬结论）→ 看 `holder_candidates`（`source: cmdline` 比 `name` 准，候选≠持有者）确认占用方 |
 
 完整速查表与手工部署细节见 [`Fwloop_setup_pack/README.md`](Fwloop_setup_pack/README.md)。

{firmwareloop-0.7.3 → firmwareloop-0.8.0}/firmwareloop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.7.3
+Version: 0.8.0
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -18,7 +18,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pyvisa>=1.14.0
-Requires-Dist: pyvisa-py>=0.7.3
+Requires-Dist: pyvisa-py>=0.7.4
 Requires-Dist: pyserial>=3.5
 Requires-Dist: pytest>=8.0.0
 Requires-Dist: pyocd>=0.36.0
@@ -177,6 +177,8 @@ fwloop setup
    | Claude Code CLI | `~/.claude.json` |
    | Qoder / Qoder CN | `~/.qoder/mcp.json`、`~/.qoder-cn/mcp.json` |
    | CodeBuddy IDE | `~/.codebuddy/mcp.json` |
+   | DeepSeek Harness (DSH) | `~/.dsh/profiles/<已派生 profile>/cordis.patch.yml` |
+   | ZCode IDE | `~/.zcode/cli/config.json` |
 
 2. **同步技能包**（`firmwareloop`、`fwloop-adapter`）到 Antigravity 与 Claude Code 的全局 Skill 目录。
 3. **生成机器级全局配置** `%APPDATA%\FirmwareLoop\lab.yaml`（NdtBox 配置模板，已存在则不覆盖）。
@@ -383,7 +385,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.7.3)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.8.0)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -393,7 +395,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.7.3）
+## 能力验证状态（v0.8.0）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`
@@ -401,6 +403,7 @@ claude mcp remove --scope user agentic-hil
 | 能力 | 状态 |
 |---|---|
 | 双层 MCP 服务（13 个工作流与硬件工具） | Implemented + Protocol Validated（31/31 测试通过） |
+| fwloop setup 一键注册（7 Agent：Antigravity / Claude Code / Qoder(+CN) / CodeBuddy / DeepSeek Harness / ZCode） | Implemented + Multi-Agent Validated（DSH / ZCode 真机写入验证） |
 | 串口助手工具族（fw_serial_* 七工具, 长驻会话/发送序列/帧解析/窗口采集） | Implemented + Simulator Validated（55 例单测: 含残留 serve 自动清理 / close 进程回收 / UTF-8 线路 / 失败落 JSONL）-> Real Hardware Validated 待 DUT |
 | 一键多 Agent 脚手架（fwloop init / fw_init_project） | Implemented + Multi-Agent Validated |
 | 自定义/私有调试工具接入 Skill（fwloop-adapter） | Implemented + Multi-Skill Validated |
@@ -437,10 +440,10 @@ claude mcp remove --scope user agentic-hil
 | 串口 `SERIAL_PORT_ERROR: ... PermissionError(13)` | 端口被 GUI 上位机独占（NDT Debug Tool / STDataCollection.exe、串口助手）→ 关闭占用方后 `fw_serial_open`；残留会话用 `fw_serial_close`（已自动等待/强杀进程，端口释放可验证） |
 | `fw_serial_status` 的 `error_class` 为 `UART_BUSY` | 会话未打开或已被占用 → 先 `fw_serial_open`；残留会话 `fw_serial_close` 清理 |
 | `fw_serial_*` 报 `PermissionError(13)` / `rx_bytes: 0` | 串口被独占：**退出 NDT Debug Tool GUI（STDataCollection.exe）**——它打开时会同时占住 Box 串口与 USB-IIC 通道；失败信封/`fw_serial_status` 的 `suspected_holders` 会直接列出嫌疑进程（注意别杀 MCP server 的 python） |
-| 烧录"擦除生效（probe 从非 00 变 00）但校验读回全 FF"、`pages_written` 已发出 | v0.7.1 及更早的逐笔 serve 路径问题 → v0.7.3 起默认走 `flash_engine: bridge`（桥内单体，与 GUI 同进程模型）；要复现/排查旧行为用 `flash_engine: "serve"` |
+| 烧录"擦除生效（probe 从非 00 变 00）但校验读回全 FF"、`pages_written` 已发出 | v0.7.1 及更早的逐笔 serve 路径问题 → v0.7.4 起默认走 `flash_engine: bridge`（桥内单体，与 GUI 同进程模型）；要复现/排查旧行为用 `flash_engine: "serve"` |
 | 长调用（capture/measure）客户端超时 | MCP stdio 循环是**单线程**的：长调用会让同会话其它调用排队（含 3s 的小调用）→ 缩短窗口，或用 `fw_ndtdbg_stream_start` job 模式 |
 | 烧录报 `INCOMPLETE_FLASH` | 桥内 flash 连续 30s 无进度（疑似卡在写入中途）→ **芯片处于半擦写态，勿直接使用，必须重新完整烧录**；信封带 `chip_state: partially_erased` 与 `post_kill_power_cycle`（已尝试复位） |
-| 烧录报 `COLD_BOOT_VERIFY_FAILED` | **Flash 字节已通过逐窗校验，但断电重上电后目标没有有效应答/与期望不符**（现场 `.18` 类问题：GUI 报成功、当场可读，冷启动 `Fw_ver = -1`）→ 按固件冷启动路径排查（看门狗/时钟/外设初始化）；或用 `cold_boot_expect` 指定期望值、`cold_boot_check: false` 关闭 |
+| 烧录报 `COLD_BOOT_VERIFY_FAILED` | **Flash 字节已通过逐窗校验，但断电重上电后目标没有有效应答/与期望不符**（现场失败形态：烧录工具报成功、当场可读，冷启动后却读不到版本）→ 按固件冷启动路径排查（看门狗/时钟/外设初始化）；或用 `cold_boot_expect` 指定期望值、`cold_boot_check: false` 关闭 |
 | `fw_serial_status` 的 `port_probe.openable = false` | 端口当前**无法独占打开**（硬结论）→ 看 `holder_candidates`（`source: cmdline` 比 `name` 准，候选≠持有者）确认占用方 |
 
 完整速查表与手工部署细节见 [`Fwloop_setup_pack/README.md`](Fwloop_setup_pack/README.md)。

{firmwareloop-0.7.3 → firmwareloop-0.8.0}/firmwareloop.egg-info/requires.txt

@@ -1,5 +1,5 @@
 pyvisa>=1.14.0
-pyvisa-py>=0.7.3
+pyvisa-py>=0.7.4
 pyserial>=3.5
 pytest>=8.0.0
 pyocd>=0.36.0

{firmwareloop-0.7.3 → firmwareloop-0.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "firmwareloop"
-version = "0.7.3"
+version = "0.8.0"
 description = "AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)"
 readme = "README.md"
 authors = [
@@ -14,7 +14,7 @@ license = { text = "MIT" }
 requires-python = ">=3.10"
 dependencies = [
     "pyvisa>=1.14.0",
-    "pyvisa-py>=0.7.3",
+    "pyvisa-py>=0.7.4",
     "pyserial>=3.5",
     "pytest>=8.0.0",
     "pyocd>=0.36.0",

{firmwareloop-0.7.3 → firmwareloop-0.8.0}/tools/__init__.py

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

{firmwareloop-0.7.3 → firmwareloop-0.8.0}/tools/fw_mcp_server.py

@@ -1,9 +1,10 @@
 #!/usr/bin/env python3
 """
-fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.7.3).
+fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.8.0).
 
 Exposes high-level firmware engineering and hardware management tools to AI Coding
-Agents (Antigravity CLI, Claude Code CLI, Qoder IDE, CodeBuddy IDE, Cursor) via the Model Context
+Agents (Antigravity CLI, Claude Code CLI, Qoder IDE, CodeBuddy IDE, DeepSeek Harness,
+ZCode IDE, Cursor) via the Model Context
 Protocol (JSON-RPC 2.0 stdio).
 
 Tools provided:
@@ -332,7 +333,7 @@ def handle_fw_ndtdbg_write_reg(args: Dict[str, Any]) -> Dict[str, Any]:
 def handle_fw_ndtdbg_flash(args: Dict[str, Any]) -> Dict[str, Any]:
     """Erase + flash a .bin/.nfw image onto the NdtBox target chip (ChipSea Fxx) over IIC.
 
-    P1-3 (0.7.3): 去掉按签名重试 —— "TARGET_MISMATCH @0x0000" 正是"根本没进 boot"的
+    P1-3 (0.7.4): 去掉按签名重试 —— "TARGET_MISMATCH @0x0000" 正是"根本没进 boot"的
     特征签名 (旧 boot 判据假阳的同一条错误路径), 盲目重试只会重复同一失败路径。
     整片重写 (<= rewrite_times) 现由 flash_exec 内部完成, 结果带 rewrite_count;
     BOOT_NOT_ENTERED 直接返回指引 (需断电重启, 重试无意义)。
@@ -1156,6 +1157,57 @@ custom_tools:
 向用户展示配置位置，并说明后续在对话中可以直接使用自然语言调度：
 - “*使用我们公司的烧录工具把固件刷入芯片*”
 - “*启动自研抓包工具采集 5 秒串口日志*”
+
+---
+
+## 可选手法：目标侧"只读诊断插桩"（通用模式）
+
+**适用**：目标固件"挂死 / 反复重启"，没有可用串口输出（或写通道不可用），但工具族能读寄存器。
+思路：让固件把**运行痕迹暴露成只读寄存器**，Agent 一次读回即可定位阶段与崩溃现场，
+不必"改一处 → 烧一次 → 猜一次"。
+
+> **⚠️ 归属规则（先看这条）**：本 skill 会**随包分发**（`fwloop init` / `fwloop setup` 会把它
+> 复制到用户工程与各 Agent 的 skills 目录），因此**这里只放与具体项目、具体芯片无关的通用内容**。
+> 每个项目的**地址约定、寄存器含义、现场案例属于项目资产**，请记录到：
+> - 该项目仓库内的 `docs/<project>-probe-convention.md`，或该项目自建的 project skill；
+>
+> 本 skill 负责教你**怎么设计**这套插桩、以及**记录到哪里**，不承载任何单一项目的约定。
+
+### 通用模式（由粗到细四件套）
+
+1. **阶段编号**：最后到达的启动边界；
+2. **阶段追踪环**：最近 N 步的环形缓冲（看清"路径"，而不只是终点）；
+3. **计数器组**：主循环迭代数、可疑等待循环的自旋计数、崩溃现场（fault 状态字 / PC / LR / xPSR）；
+4. **运行时可调"停靠级别"**：写后断电即可逐级二分崩溃点。
+
+### 通用约束（与芯片无关，都是踩出来的）
+
+1. 插桩数组放 **NOINIT** 段：复位/软复位不清零，才看得到"重启前最后执行到哪"；
+2. 尽量**只读注册**，不要占用可写寄存器语义；
+3. 注册表必须按**地址升序**：乱序会导致从机自检失败 / 初始化提前 `return`
+   ⇒ 通信通道根本没起来，现象与"目标掉电"完全一样（极易误判）；
+4. **避开厂商协议占用的地址**：例——烧录工具会往某个固定地址写擦除/完成魔数，
+   插桩变量放在那里会污染工具的判据；
+5. 采集遵守工具族的协议约束（升序读、单次长度上限、关键字节双读校验——见各工具描述）；
+6. 插桩代码用 `#if` 开关包裹：关闭时零成本、零 RAM。
+
+### 固件侧两条"已知良方"（与芯片无关）
+
+1. **"通道先行"**：把"能被工具读到的通道"（I2C 从机 / 串口）初始化提到所有可疑初始化**之前**
+   ⇒ 之后无论哪里崩，设备仍然可读（把它写在最后，往往会被插桩本身锁死）；
+2. **fault handler 禁止裸自旋**（`B .`）：其优先级高于一切可配置中断，死等会饿死通信中断，
+   目标"从总线上消失"（工具侧表现为 `BUS_TIMEOUT`）⇒ 应"记录现场 + 复位"。
+   （进阶手法"改写异常返回地址 → 恢复函数 → 重建通道 → 停靠"与芯片强相关，换目标需复测。）
+
+### 最小闭环（通用）
+
+```text
+fw_ndtdbg_power_cycle(off_ms=500)     # 复位（不需 write_allowed）
+fw_ndtdbg_status                      # 分级结论 + 判据表
+fw_ndtdbg_read_reg(reg=..., len=...)  # 读"项目约定文档"里定义的诊断寄存器
+fw_ndtdbg_flash(...)                  # 改完固件自助烧录（含烧后冷启动冒烟）
+fw_serial_capture(power_cycle_off_ms=500)   # 抓开机日志（窗口内自动复位）
+```
 """
     if not os.path.exists(adapter_skill_path) or overwrite:
         with open(adapter_skill_path, "w", encoding="utf-8") as fh:
@@ -2335,7 +2387,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
                 },
                 "serverInfo": {
                     "name": "firmwareloop",
-                    "version": "0.7.3"
+                    "version": "0.8.0"
                 }
             }
         }
@@ -2470,7 +2522,7 @@ def _settle_stashed_entrypoints(stashed) -> None:
 def handle_cli_update() -> int:
     """Handle `firmwareloop update` command."""
     print("============================================================")
-    print("  FirmwareLoop Auto-Updater (v0.7.3)")
+    print("  FirmwareLoop Auto-Updater (v0.8.0)")
     print("============================================================")
 
     is_git_repo = os.path.exists(os.path.join(REPO_ROOT, ".git"))
@@ -2813,6 +2865,192 @@ def configure_codebuddy_user_mcp(user_home: str) -> Dict[str, Any]:
         return {"ok": False, "path": mcp_file, "reason": str(exc)}
 
 
+DSH_MCP_CLIENT_PLUGIN = "@deepseek-ai/dsh-mcp-client"
+
+# DSH (DeepSeek Harness) profile patch entries. Tools surface as
+# mcp__<serverName>__<tool> (same shape as Claude Code / Codex), e.g.
+# mcp__fwloop__fw_build. Bare command names resolve via PATH: the DSH
+# stdio transport only scrubs credential-shaped / DSH_* env vars, so the
+# parent PATH survives (same convention as the Qoder / Claude entries).
+DSH_MCP_SERVER_ENTRIES = (
+    ("mcp-fwloop", "fwloop", {"command": "fwloop", "args": []}),
+    ("mcp-agentic-hil", "agentic-hil", {"command": "agentic-hil", "args": ["mcp-stdio"]}),
+)
+
+DSH_PATCH_HEADER = (
+    "# FirmwareLoop dual-tier MCP (added by fwloop setup).\n"
+    "# Bridged by @deepseek-ai/dsh-mcp-client; tools surface as mcp__<serverName>__<tool>.\n"
+)
+
+
+def resolve_dsh_home(user_home: str) -> str:
+    """Resolve the DeepSeek Harness home: non-blank $DSH_HOME wins, else ~/.dsh.
+
+    Mirrors @deepseek-ai/dsh-home-paths precedence (an in-harness configured
+    home override is invisible to external tools and therefore not honored).
+    """
+    env_home = (os.environ.get("DSH_HOME") or "").strip()
+    return env_home if env_home else os.path.join(user_home, ".dsh")
+
+
+def discover_dsh_profiles(dsh_home: str) -> List[str]:
+    """List derived DSH profile names under <home>/profiles.
+
+    A directory counts as a profile only when it has a profile-root cordis.yml,
+    which excludes the shared <home>/profiles/node_modules dependency tree.
+    Built-in profiles (web/tui/headless) appear here once the user has booted
+    or derived them; never-derived ones do not exist on disk and are skipped.
+    """
+    profiles_dir = os.path.join(dsh_home, "profiles")
+    found: List[str] = []
+    if os.path.isdir(profiles_dir):
+        for name in sorted(os.listdir(profiles_dir)):
+            cand = os.path.join(profiles_dir, name)
+            if os.path.isdir(cand) and os.path.isfile(os.path.join(cand, "cordis.yml")):
+                found.append(name)
+    return found
+
+
+def _dsh_entry_yaml(entry_id: str, server_name: str, spec: Dict[str, Any]) -> str:
+    args_repr = ", ".join(f"'{a}'" for a in spec.get("args", []))
+    return (
+        f"    - id: {entry_id}\n"
+        f"      name: '{DSH_MCP_CLIENT_PLUGIN}'\n"
+        f"      config:\n"
+        f"        serverName: {server_name}\n"
+        f"        transport: stdio\n"
+        f"        command: {spec['command']}\n"
+        f"        args: [{args_repr}]\n"
+    )
+
+
+def upsert_dsh_patch_file(patch_path: str) -> str:
+    """Idempotently add the FirmwareLoop MCP entries to a profile's cordis.patch.yml.
+
+    Returns "written" or "already_configured". Text-level upsert on purpose:
+    a yaml.safe_dump round-trip would strip the user's guide comments, so an
+    existing file is only ever appended to. Membership is decided by a plain
+    substring check on our fixed ids (fail-safe side: a false positive merely
+    skips the write), and entries that already exist are never rewritten so
+    user overrides (e.g. a custom command) survive setup re-runs.
+    """
+    present = ""
+    if os.path.exists(patch_path):
+        with open(patch_path, "r", encoding="utf-8-sig") as f:
+            present = f.read()
+    missing = [eid for eid, _, _ in DSH_MCP_SERVER_ENTRIES if f"id: {eid}" not in present]
+    if present and not missing:
+        return "already_configured"
+    # Single "- insert:" block holding the missing entries, matching the shape
+    # of the official dsh-mcp-client sample (one block, several entries).
+    new_text = "- insert:\n" + "".join(
+        _dsh_entry_yaml(eid, name, spec)
+        for eid, name, spec in DSH_MCP_SERVER_ENTRIES
+        if eid in missing
+    )
+    parent = os.path.dirname(patch_path)
+    if parent:
+        os.makedirs(parent, exist_ok=True)
+    if not present:
+        with open(patch_path, "w", encoding="utf-8", newline="\n") as f:
+            f.write(DSH_PATCH_HEADER)
+            f.write(new_text)
+        return "written"
+    stripped = present.strip()
+    with open(patch_path, "w", encoding="utf-8", newline="\n") as f:
+        if not stripped or stripped == "[]":
+            # Empty document (blank or literal []): keep leading comment lines,
+            # then start the entries array.
+            comments = "\n".join(
+                line for line in present.splitlines() if line.strip().startswith("#")
+            )
+            if comments:
+                f.write(comments + "\n")
+            f.write(new_text)
+        else:
+            f.write(present)
+            if not present.endswith("\n"):
+                f.write("\n")
+            f.write("\n" + new_text)
+    return "written"
+
+
+def configure_dsh_profiles(user_home: str) -> List[Dict[str, Any]]:
+    """Add FirmwareLoop MCP entries to every derived DSH profile's cordis.patch.yml."""
+    dsh_home = resolve_dsh_home(user_home)
+    results: List[Dict[str, Any]] = []
+    for profile in discover_dsh_profiles(dsh_home):
+        patch_path = os.path.join(dsh_home, "profiles", profile, "cordis.patch.yml")
+        try:
+            status = upsert_dsh_patch_file(patch_path)
+            results.append({"profile": profile, "ok": True, "path": patch_path, "status": status})
+        except Exception as exc:
+            results.append({"profile": profile, "ok": False, "path": patch_path, "reason": str(exc)})
+    return results
+
+
+ZCODE_MCP_SERVERS = {
+    "fwloop": {"command": "fwloop", "type": "stdio"},
+    "agentic-hil": {"command": "agentic-hil", "args": ["mcp-stdio"], "type": "stdio"},
+}
+
+
+def upsert_zcode_mcp_json(mcp_path: str, servers: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+    """Merge MCP servers into ZCode's ~/.zcode/cli/config.json without dropping
+    existing entries.
+
+    ZCode (GLM desktop IDE) nests its MCP registry under "mcp"."servers" —
+    the per-entry shape (type/command/args) matches Qoder's mcpServers, so the
+    same per-entry merge (keep user extras like env) applies.
+    """
+    payload = dict(servers or ZCODE_MCP_SERVERS)
+    data: Dict[str, Any] = {}
+    if os.path.exists(mcp_path):
+        try:
+            with open(mcp_path, "r", encoding="utf-8-sig") as f:
+                loaded = json.load(f)
+            if isinstance(loaded, dict):
+                data = loaded
+        except Exception:
+            data = {}
+    mcp_root = data.get("mcp")
+    if not isinstance(mcp_root, dict):
+        mcp_root = {}
+    mcp_servers = mcp_root.get("servers")
+    if not isinstance(mcp_servers, dict):
+        mcp_servers = {}
+    for name, entry in payload.items():
+        old = mcp_servers.get(name)
+        if isinstance(old, dict) and isinstance(entry, dict):
+            merged = dict(old)
+            merged.update(entry)
+            mcp_servers[name] = merged
+        else:
+            mcp_servers[name] = entry
+    mcp_root["servers"] = mcp_servers
+    data["mcp"] = mcp_root
+    parent = os.path.dirname(mcp_path)
+    if parent:
+        os.makedirs(parent, exist_ok=True)
+    with open(mcp_path, "w", encoding="utf-8") as f:
+        json.dump(data, f, indent=2)
+        f.write("\n")
+    return data
+
+
+def configure_zcode_user_mcp(user_home: str) -> Dict[str, Any]:
+    """Write FirmwareLoop MCP entries into ZCode's ~/.zcode/cli/config.json."""
+    zcode_dir = os.path.join(user_home, ".zcode")
+    mcp_file = os.path.join(zcode_dir, "cli", "config.json")
+    if not os.path.isdir(zcode_dir):
+        return {"ok": False, "path": mcp_file, "reason": "not_installed"}
+    try:
+        upsert_zcode_mcp_json(mcp_file)
+        return {"ok": True, "path": mcp_file}
+    except Exception as exc:
+        return {"ok": False, "path": mcp_file, "reason": str(exc)}
+
+
 def resolve_ndtdebugtool_lib(tool_root: str) -> str:
     """Resolve the NdtDebugTool lib directory (must contain USBIOX.DLL)."""
     if not tool_root or not os.path.isdir(tool_root):
@@ -2899,9 +3137,9 @@ 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, and CodeBuddy IDE."""
+    """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.7.3)")
+    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.8.0)")
     print("============================================================")
     print("")
 
@@ -2985,7 +3223,37 @@ def handle_cli_setup() -> int:
     else:
         print(f"    - User MCP: [Warning] Could not write {cb_result['path']}: {cb_result.get('reason')}")
 
-    # 5. Global Skills Sync for Antigravity and Claude Code
+    # 5. DeepSeek Harness (DSH) — per-profile cordis.patch.yml upsert
+    # Only profiles already derived under <home>/profiles (a booted or
+    # --from-default-profile'd profile has a profile-root cordis.yml) are
+    # configured; never-derived built-ins do not exist on disk and are skipped.
+    print("\n[5] DeepSeek Harness (DSH):")
+    dsh_results = configure_dsh_profiles(user_home)
+    dsh_ok = [item for item in dsh_results if item.get("ok")]
+    if dsh_ok:
+        for item in dsh_ok:
+            state = "already configured" if item["status"] == "already_configured" else "written"
+            print(f"    - profile {item['profile']}: [OK] {state}: {item['path']}")
+        configured_agents.append("DeepSeek Harness (DSH)")
+    else:
+        print("    - ~/.dsh/profiles has no derived profile (DSH not installed, or no profile booted yet)")
+        print("    - Boot/derive a profile in DSH first, then re-run: fwloop setup")
+    for item in dsh_results:
+        if not item.get("ok"):
+            print(f"    - profile {item['profile']}: [Warning] Could not write {item['path']}: {item.get('reason')}")
+
+    # 6. ZCode IDE user-level MCP (~/.zcode/cli/config.json, {"mcp": {"servers": ...}})
+    print("\n[6] ZCode IDE:")
+    zc_result = configure_zcode_user_mcp(user_home)
+    if zc_result.get("ok"):
+        print(f"    - User MCP: [OK] Written to {zc_result['path']}")
+        configured_agents.append("ZCode")
+    elif zc_result.get("reason") == "not_installed":
+        print("    - User MCP: ~/.zcode not found (Workspace .mcp.json still supported)")
+    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
     ag_skills_dir = os.path.join(user_home, ".gemini", "antigravity-cli", "skills")
     claude_skills_dir = os.path.join(user_home, ".claude", "skills")
     source_skills_dir = os.path.join(REPO_ROOT, "skills")
@@ -3006,14 +3274,14 @@ def handle_cli_setup() -> int:
                 except Exception:
                     pass
 
-    print(f"\n[5] Global Skills:")
+    print(f"\n[7] Global Skills:")
     print(f"    - Synchronized: [OK] {skills_synced} skills (firmwareloop, fwloop-adapter) to Antigravity & Claude Code")
 
-    # 5. Machine-level global lab.yaml (ndtdbg config for the globally installed tool)
+    # 8. Machine-level global lab.yaml (ndtdbg config for the globally installed tool)
     global_cfg = ensure_global_lab_yaml()
     if global_cfg:
         exists = "  [已存在, 未覆盖]" if os.path.isfile(global_cfg) else "  [已创建]"
-        print("\n[6] NdtBox 全局配置:")
+        print("\n[8] NdtBox 全局配置:")
         print(f"    - {global_cfg}{exists}")
         print("    - 若未配置, 请运行: fwloop ndtdebugtool \"<NdtDebugTool 根目录>\"")
 
@@ -3026,7 +3294,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.7.3)")
+    print("  FirmwareLoop Multi-Agent Project Initializer (v0.8.0)")
     print("============================================================")
     cwd = os.getcwd()
     print(f"[*] Initializing multi-agent guidelines & bench config in:\n    {cwd}\n")
@@ -3059,7 +3327,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.7.3)
+    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.8.0)
 
 Usage:
   fwloop [command]   (or: firmwareloop [command])
@@ -3105,7 +3373,7 @@ def main() -> None:
                 sys.exit(2)
             sys.exit(handle_cli_ndtdebugtool(args[1]))
         elif cmd in ["version", "-v", "--version"]:
-            print("FirmwareLoop v0.7.3")
+            print("FirmwareLoop v0.8.0")
             sys.exit(0)
         elif cmd in ["help", "-h", "--help"]:
             print_cli_help()

{firmwareloop-0.7.3 → firmwareloop-0.8.0}/tools/lib/ndtdbg.py

@@ -828,7 +828,7 @@ class NdtBoxIo:
         """桥内单体 flash 引擎 (0.7.2 起为默认): 单进程内 USBIOX(0) 与 USB2IO(1) 句柄同持,
 
         帧经 stdin 一次性传入、全程连续无逐笔管道往返 —— 即原厂 GUI 的进程模型, 也是
-        现场 (2026-09-11 F72) 6/6 verify pass 的那条路径。校验失败 (桥报
+        现场 (2026-09-11) 6/6 verify pass 的那条路径。校验失败 (桥报
         TARGET_MISMATCH "烧录校验失败") 时按 rewrite_times 整片重跑, 其余错误直接上抛。
         """
         import time
@@ -879,7 +879,7 @@ class NdtBoxIo:
     def flash_exec(self, plan: dict, timeout_ms: int | None = None) -> dict:
         """烧录引擎分派: "bridge" (默认, 桥内单体 flash) / "serve" (逐笔 Python 驱动)。
 
-        现场实证 (2026-09-11, F72, 同一批固件 + 同一台设备):
+        现场实证 (2026-09-11, 同一批固件 + 同一台设备):
           桥内单体 flash (帧经 stdin 一次传入)      -> 6/6 {"ok":true,"verify":"pass"}
           逐笔 serve 路径 (每页一笔 raw 事务)        -> 100% "擦除生效但页写不落地"
             (probe FFFFFFFF -> 00000000 说明 7 字节擦除帧到达; 99 页 write_ms 7594ms
@@ -1428,8 +1428,8 @@ class ChipSeaFxx:
                         expect: str | None = None) -> dict:
         """烧后冷启动冒烟 (评审 §4): 断电重上电 -> 读已知寄存器 -> 判定固件是否真的跑起来。
 
-        只校验 Flash 字节的流程抓不到"镜像烧对了但跑不起来"——现场 `.18` 正是: GUI 报
-        `FW Upgrade Success` 且当场可读, 断电重上电后 `Fw_ver = -1`。这里 fail-closed:
+        只校验 Flash 字节的流程抓不到"镜像烧对了但跑不起来"——现场出现过: 烧录工具报成功
+        且当场可读, 断电重上电后版本寄存器却读不到。这里 fail-closed:
         expect 给定时逐字节比对; 未给定时判"有无效应答"(读不到或全 00/FF 都算失败)。
         """
         import time
@@ -1452,7 +1452,7 @@ class ChipSeaFxx:
         if raw is None:
             out["ok"] = False
             out["conclusion"] = ("冷启动后该寄存器无应答: 固件可能未起振/未使能 I2C 从机 "
-                                 "—— Flash 字节已验证, 但目标跑不起来 (现场 .18 类问题的特征)")
+                                 "—— Flash 字节已验证, 但目标跑不起来 (冷启动失败的特征)")
             return out
         if want is not None:
             if raw[:len(want)] != want:
@@ -1530,7 +1530,7 @@ class ChipSeaFxx:
                      "pages_written": len(pages), "window_verified": True,
                      "cold_boot": cold,
                      "hint": "①确认目标固件在本寄存器上确有可读内容 (否则用 cold_boot_expect 指定)"
-                             "; ②按现场 .18 类问题排查冷启动路径 (看门狗/时钟/外设初始化); "
+                             "; ②按冷启动路径排查 (看门狗/时钟/外设初始化); "
                              "③如确不需要该校验, 用 cold_boot_check=false / --no-cold-boot-check 关闭"})
         return {
             "file": file_path,

{firmwareloop-0.7.3 → firmwareloop-0.8.0}/tools/setup-agent-mcp.ps1

@@ -1,6 +1,6 @@
 <#
 .SYNOPSIS
-    Dual-Tier MCP setup and registration helper (v0.7.3).
+    Dual-Tier MCP setup and registration helper (v0.8.0).
     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.7.3)" -ForegroundColor Green
+    Write-Host "  FirmwareLoop Dual-Tier MCP & Agent Setup Helper (v0.8.0)" -ForegroundColor Green
     Write-Host "============================================================" -ForegroundColor Cyan
     Write-Host ""
     Write-Host "[1] Google Antigravity / Gemini CLI:" -ForegroundColor Yellow