<div align="center">

🔌 dsh-jlink

DeepSeek Harness 原生 J-Link 调试插件

让 AI 助手直接调试真实硬件 —— 23 个一等工具 · 浏览器可视化面板 · 设备补丁注册器

   

@can/dsh-jlink · 在 DSH 会话里连接、暂停、读写内存寄存器、设断点、烧录固件 —— 全部通过自然语言完成。

</div>

---

🎯 为什么是「原生」

MCP 桥接方案只能递给模型一个工具名；本插件以 Cordis 插件身份深度集成 DeepSeek Harness：

工具语义、芯片匹配算法与 jlink_mcp（Python MCP 版）完全对齐，测试向量共用——迁移零心智成本。

✨ 特性总览

🚀 快速开始

> 前置条件：DeepSeek Harness rc.6 · J-Link 驱动已安装 · Python 3.10+ 且可安装 pylink-square 2.0.0（真机模式）

1️⃣ 挂进 profile（link 安装，树外 bundle 模式）

// profiles/<name>/package.json
{
  "dependencies": {
    "@can/dsh-jlink": "link:C:/path/to/dsh-jlink-plugin"
  },
  "dsh": { "profile": { "bundles": [ /* ... */, "@can/dsh-jlink" ] } }
}

2️⃣ 构建插件

pnpm install
CI=true pnpm build   # 产物：lib/index.mjs(host) + lib/client.js(browser) + lib/remote.mjs

3️⃣ 启动并验证

dsh web
# ✔ --dump-config 可见 jlink 行
# ✔ 浏览器会话头出现 J-Link 状态灯

> [!IMPORTANT] > 插件行由包内 cordis.patch.yml（dsh.bundle.patch 层）自动注入。 > 不要再在 profile 的 cordis.patch.yml 里手动添加 jlink 行——会双挂载。

无硬件？把配置里 driver 改成 mock，即可开发/演示全部工具与 UI。

🏗 架构

浏览器（Client plane）           Host（Node plane）                  硬件侧
┌──────────────────────┐   ┌───────────────────────────┐   ┌──────────────────┐
│ 会话头状态灯 / 弹窗    │RPC│  JLinkService (Typert)     │ndjson│ python/driver.py │
│ toolview 视图族 ×5    │◄─►│    └ JLinkCore 连接状态机   │◄───►│  └ pylink 2.0.0  │
│ hexdump·寄存器·RTT…  │   │    └ DriverInterface       │stdio│    └ J-Link DLL  │
└──────────────────────┘   │         ├ MockDriver        │    └───────┬──────────┘
                           │         └ PythonDriver      │            ▼
ctx.tools.register ◄───────│  PatchRegistry → Flagchip   │       J-Link → 目标板
23 个工具（模型调用面）      │              → Builtin      │

数据通道：工具调用（模型→Host）· Remote RPC（UI→Host，{ok,value} 信封）· RTT 长轮询 · toolview 键控槽。

🛠 工具目录（23）

> [!NOTE] > 内存/寄存器读写前必须已 halt（工具内前置检查，未 halt 返回 JLINK_NOT_HALTED）。 > match_chip_name 支持 精确 → 前缀 → 包含 → 模糊 四级匹配，输 FC7300F4MDD 即得完整型号。

⚙ 配置

zod schema 只增不改；经 cordis.patch.yml 行内 config: 覆盖。

✅ 真机验证记录

<details open> <summary><b>🅰 Flagchip FC7300 · JTAG · Cortex-M4 r0p1</b>（J-Link WiFi S/N 941000021）</summary>

</details>

<details> <summary><b>🅱 ST STM32F103ZE · SWD · Cortex-M3</b>（J-Link WiFi S/N 941000024）</summary>

</details>

⚠ 已知限制

1. Flash 能力按设备而异 — DLL 内置设备（STM32 等）三件套直接可用；erase_flash 为全片擦除（pylink 仅绑定 JLINK_EraseChip）。FC7300 不在 DLL 设备表，需接入 jlink_mcp 的 flash loader 管线（规划中） 2. 电压读数依赖 DLL 版本 — 部分 DLL 不支持 VTarget exec 命令，此时显示 “—” 3. RTT 需固件配合 — 目标固件执行 SEGGER_RTT_Init() 后才有数据 4. 规划中 — SVD 寄存器符号化 · GDB server · 多厂商补丁示例 · ui-primitives token 化

🧪 本地开发

pnpm install                # devDeps 以 file: 引用本机 @deepseek-ai/* rc.6
CI=true pnpm build          # 主构建(ESM) + client(CJS) + wrap-client 包装
pnpm typecheck              # tsc --noEmit 严格模式
pnpm test                   # vitest：匹配向量 / 信封 / 状态机 / remote 描述符一致性

> [!TIP] > pnpm 无 TTY 时构建可能触发 install 确认，统一加 CI=true。 > 同一时刻一个探头只能被一个进程占用——测试前先退出 J-Link Commander / J-Flash。

📁 文档导航

🙏 致谢

• jlink_mcp — 工具语义 · 匹配算法 · 补丁数据来源
• DSH-better-sidebar — 树外 bundle 插件先例
• DeepSeek Harness — @deepseek-ai/dsh@0.1.0-rc.6 事实基准

---

<div align="center">

MIT License © can · 在真实硬件上逐行打磨 🔧

</div>