firmwareloop 0.7.4__tar.gz → 0.8.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.7.4
+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
@@ -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.4)
+├── 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.4）
+## 能力验证状态（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 |

{firmwareloop-0.7.4 → 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.4)
+├── 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.4）
+## 能力验证状态（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 |

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.7.4
+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
@@ -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.4)
+├── 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.4）
+## 能力验证状态（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 |

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

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

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

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

{firmwareloop-0.7.4 → 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.4).
+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:
@@ -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.4"
+                    "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.4)")
+    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.4)")
+    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.4)")
+    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.4)
+    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.4")
+            print("FirmwareLoop v0.8.0")
             sys.exit(0)
         elif cmd in ["help", "-h", "--help"]:
             print_cli_help()

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

@@ -1,6 +1,6 @@
 <#
 .SYNOPSIS
-    Dual-Tier MCP setup and registration helper (v0.7.4).
+    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.4)" -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