jlink（jlink 搜索） Skills下载安装命令和教程

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：jlink（jlink 搜索）
来源仓库：https://github.com/zhinkgit/embeddedskills
仓库路径：skills/jlink
安装命令：
npx skills add https://github.com/zhinkgit/embeddedskills --skill jlink
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill；本站只展示命令，不托管安装包，也不自动执行。

skills.shnpx skills

npx skills add https://github.com/zhinkgit/embeddedskills --skill jlink

简介

jlink 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。

它支持查询仓库状态、分析代码变更、辅助 Issue 和 PR 管理，适用于代码审查与协作流程。
通过 npx skills add 命令从指定 GitHub 仓库安装，具体用法可参考原始 README 文件。
安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写操作。
jlink 属于前端设计类 Skill，可作为该场景下的辅助能力补充。

SKILL.md

J-Link 下载与在线调试

本 skill 提供 J-Link 探针的设备探测、固件烧录、内存读写、寄存器查看、目标复位、RTT 日志读取，以及轻量在线调试和 GDB 源码级调试能力。

配置

环境级配置（skill/config.json）

skill 目录下的 config.json 包含环境级配置（工具路径、端口号等），首次使用前确认 exe 路径正确：

{
  "exe": "C:\\Program Files\\SEGGER\\JLink\\JLink.exe",
  "gdbserver_exe": "C:\\Program Files\\SEGGER\\JLink\\JLinkGDBServerCL.exe",
  "rtt_exe": "C:\\Program Files\\SEGGER\\JLink\\JLinkRTTClient.exe",
  "gdb_exe": "C:\\Program Files\\Arm\\GNU Toolchain mingw-w64-x86_64-arm-none-eabi\\bin\\arm-none-eabi-gdb.exe",
  "serial_no": "",
  "rtt_telnet_port": 0,
  "swo_command": [],
  "operation_mode": 1
}

exe：JLink.exe 完整路径（必填）
gdbserver_exe：JLinkGDBServerCL.exe 路径，RTT 和 GDB 调试需要
rtt_exe：JLinkRTTClient.exe 路径
gdb_exe：arm-none-eabi-gdb 路径，GDB 源码级调试需要
serial_no：默认探针序列号，多探针场景下使用
rtt_telnet_port：RTT 端口，0 表示使用工具默认值
swo_command：可选，完整 SWO viewer 命令数组，供 jlink_swo.py 包装
operation_mode：1 直接执行 / 2 输出风险摘要但不阻塞 / 3 执行前确认

工程级配置（.embeddedskills/config.json）

设备参数（device/interface/speed）统一在工作区的 .embeddedskills/config.json 中管理：

{
  "jlink": {
    "device": "STM32F407VG",
    "interface": "SWD",
    "speed": "4000"
  }
}

device：芯片型号（如 STM32F407VG、GD32F470ZG）
interface：调试接口，SWD 或 JTAG，默认 SWD
speed：调试速率 kHz，默认 4000

参数解析优先级：CLI 参数 > 工程配置 > state.json > 默认值

成功执行后，确认过的 device/interface/speed 会自动写回工程配置。

子命令

基础操作

子命令	用途	风险
`info`	探测探针与目标连通性	低
`flash`	烧录固件（.hex /.bin /.elf）	高
`read-mem`	读取内存区域	低
`write-mem`	写入内存	高
`regs`	查看 CPU 寄存器	低
`reset`	复位目标芯片	高
`rtt`	读取 RTT 日志输出	低
`swo`	包装外部 SWO viewer 为统一事件流	低

在线调试（JLink Commander）

子命令	用途	风险
`halt`	暂停 CPU，返回寄存器状态	低
`go`	恢复 CPU 运行	低
`step`	单步执行（支持指定步数），返回执行的指令和寄存器	低
`run-to`	设置断点并运行，等待命中后返回状态	低

GDB 源码级调试

子命令	用途	依赖
`gdb backtrace/locals`	查看调用栈和局部变量	arm-none-eabi-gdb
`gdb break/continue/next/step/finish/until`	one-shot 控制执行流	arm-none-eabi-gdb
`gdb frame/print/watch/disassemble/threads/crash-report`	one-shot 源码级诊断	arm-none-eabi-gdb

执行流程

读取 skill/config.json，确认 exe 路径有效
读取 .embeddedskills/config.json 获取工程级配置（device/interface/speed）
读取 .embeddedskills/state.json 获取历史状态
参数解析优先级：CLI 参数 > 工程配置 > state.json > 默认值
若当前动作需要 device 且仍为空，直接要求用户补充，绝不猜测
多探针场景未指定 serial_no 时，列出探针让用户选择，不自动选择
按 operation_mode 决定是否需要确认后执行
使用模板生成临时 .jlink 命令文件，调用 JLink.exe 时带 -NoGui 1 -ExitOnError 1 -AutoConnect 1
解析输出和返回码，返回结构化结果
成功执行后，将确认过的 device/interface/speed 写回 .embeddedskills/config.json

脚本调用

skill 目录下有四个 Python 脚本，使用标准库实现，无额外依赖。

jlink_exec.py — 基础操作 + 轻量调试

# 探测连通性
python <skill-dir>/scripts/jlink_exec.py info --device GD32F470ZG --json

# 烧录固件
python <skill-dir>/scripts/jlink_exec.py flash --file build/app.hex --device GD32F470ZG --json

# 烧录 .bin（必须提供地址）
python <skill-dir>/scripts/jlink_exec.py flash --file build/app.bin --device GD32F470ZG --address 0x08000000 --json

# 读取内存
python <skill-dir>/scripts/jlink_exec.py read-mem --address 0x08000000 --length 256 --device GD32F470ZG --json

# 写入内存
python <skill-dir>/scripts/jlink_exec.py write-mem --address 0x20000000 --value 0x12345678 --device GD32F470ZG --json

# 查看寄存器
python <skill-dir>/scripts/jlink_exec.py regs --device GD32F470ZG --json

# 复位目标
python <skill-dir>/scripts/jlink_exec.py reset --device GD32F470ZG --json

# 暂停 CPU
python <skill-dir>/scripts/jlink_exec.py halt --device GD32F470ZG --json

# 恢复运行
python <skill-dir>/scripts/jlink_exec.py go --device GD32F470ZG --json

# 单步执行（3 步）
python <skill-dir>/scripts/jlink_exec.py step --device GD32F470ZG --count 3 --json

# 运行到断点地址
python <skill-dir>/scripts/jlink_exec.py run-to --device GD32F470ZG --address 0x08001234 --timeout-ms 3000 --json

通用可选参数：--interface SWD|JTAG、--speed 4000、--serial-no <序列号>、--exe <JLink.exe路径>

jlink_rtt.py — RTT 日志读取

python <skill-dir>/scripts/jlink_rtt.py --device GD32F470ZG --json

可选参数：--serial-no、--channel、--encoding、--rtt-port、--gdbserver-exe <路径>、--rtt-exe <路径>

RTT 工作原理：脚本先通过 JLinkGDBServerCL.exe 建立调试连接，再启动 JLinkRTTClient.exe 读取 RTT 数据。--json 模式输出 JSON Lines。

jlink_swo.py — SWO 事件流包装

# 使用 config.json 里的 swo_command
python <skill-dir>/scripts/jlink_swo.py --json

# 或显式传入 viewer 命令
python <skill-dir>/scripts/jlink_swo.py \
  --viewer-cmd JLinkSWOViewerCL.exe -device GD32F470ZG -itf SWD -speed 4000 \
  --json

jlink_swo.py 不直接实现 SWO 协议，而是把外部 viewer 的 stdout/stderr 统一包装成 JSON Lines，便于上层 workflow 或 AI 继续消费。

jlink_gdb.py — GDB 源码级调试（需要 arm-none-eabi-gdb）

# 执行自定义 GDB 命令序列
python <skill-dir>/scripts/jlink_gdb.py run \
  --gdbserver-exe <路径> --gdb-exe <arm-none-eabi-gdb路径> \
  --device GD32F470ZG --elf build/app.elf \
  --commands "break main" "continue" "backtrace" "info locals" --json

# 快捷：获取调用栈
python <skill-dir>/scripts/jlink_gdb.py backtrace \
  --gdbserver-exe <路径> --gdb-exe <路径> \
  --device GD32F470ZG --elf build/app.elf --json

# 快捷：查看局部变量
python <skill-dir>/scripts/jlink_gdb.py locals \
  --gdbserver-exe <路径> --gdb-exe <路径> \
  --device GD32F470ZG --elf build/app.elf --json

GDB 调试需要 ELF 文件才能进行源码级调试（断点到函数名、查看变量）。没有 ELF 时仍可使用地址级调试。

输出格式

所有脚本以 JSON 格式返回，基础字段为 status（ok/error）、action、summary、details，并可能附带 context、artifacts、metrics、state、next_actions、timing。流式观测命令使用 JSON Lines，并统一输出 source、channel_type、stream_type。

成功示例：

{
  "status": "ok",
  "action": "halt",
  "summary": "已暂停，PC=0x08049ABC",
  "details": {
    "device": "GD32F470ZG",
    "registers": { "PC": "0x08049ABC", "R0": "0x00000004", "..." : "..." }
  }
}

step 示例（包含执行的指令）：

{
  "status": "ok",
  "action": "step",
  "summary": "单步3次，PC=0x08049AB4",
  "details": {
    "steps": [
      { "address": "0x08049AB8", "opcode": "80 1B", "instruction": "SUBS R0, R0, R6" },
      { "address": "0x08049ABA", "opcode": "A8 42", "instruction": "CMP R0, R5" },
      { "address": "0x08049ABC", "opcode": "FA D3", "instruction": "BCC #-0x0C" }
    ],
    "registers": { "PC": "0x08049AB4", "..." : "..." }
  }
}

run-to 示例（断点命中）：

{
  "status": "ok",
  "action": "run-to",
  "summary": "断点命中 @ 0x08049AB4，PC=0x08049AB4",
  "details": {
    "bp_address": "0x08049AB4",
    "bp_hit": true,
    "registers": { "PC": "0x08049AB4", "..." : "..." }
  }
}

核心规则

不自动猜测 device 芯片型号，缺失时必须询问用户
多探针场景不自动选择探针，必须让用户指定序列号
参数解析优先级为：CLI 显式参数 > .embeddedskills/config.json（工程级）> skill/config.json（环境级）> .embeddedskills/state.json > 默认值/报错
.bin 文件必须显式提供烧录地址，缺失时报错
连接失败时给出排查建议（检查连线、供电、接口类型、速度），不自动尝试更激进参数
烧录、写内存、复位在参数完整且用户意图明确时直接执行
run-to 的断点在单次 JLink 会话内完成设置和清除，不存在跨会话 handle 问题
结果回显中始终包含目标芯片、接口类型和执行动作
产物路径（elf/file）不进入工程配置，仍只依赖 state.json
last_flash/last_debug 等运行状态继续写入 state.json

调试典型工作流

快速排查（JLink Commander）

halt → regs → read-mem → step → go

适合查看当前执行位置、寄存器状态、内存值，无需 ELF 和 GDB。

断点调试（JLink Commander）

run-to(address) → regs → read-mem → go

在指定地址设置断点并等待命中，查看此时的状态。

源码级调试（GDB）

gdb run --elf app.elf --commands "break main" "continue" "backtrace" "info locals"

需要 ELF 文件和 arm-none-eabi-gdb，支持函数名断点和变量查看。

参考

遇到芯片型号问题时可查阅 references/common_devices.md。

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明，方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用；具体调用方式请以来源页面和 README 为准。

平台分布

Codex

35.51%

按下载量换算116

Claude

27.59%

按下载量换算90

Cursor

18.84%

按下载量换算62

Gemini CLI

9.79%

按下载量换算32

安全审计

Gen Agent Trust Hub

可疑

Socket

通过

Snyk

通过

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容，本身偏只读；真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在 warning/failed 结果，不能写成本站确认安全。当前只有一个来源，正式发布前建议补源仓库或其他目录站核验。

来源信息

GitHub 仓库

github.com

/zhinkgit/embeddedskills

SKILL.md 来源

github.com

/zhinkgit/embeddedskills/tree/main/skills/jlink

skills-sh

skills.sh

/zhinkgit/embeddedskills/jlink

继续浏览同类 Skills

更多前端设计 Skills（10,216）返回 Skills 目录

上一个 Skill

jira-ticket-prioritizer（Jira ticket prioritizer 前端）

用于处理 Jira 项目、任务、缺陷、Sprint、负责人和状态流转。它适合让 Agent 辅助查询工单、汇总迭代进展、创建任务或整理需求和缺陷信息。使用时要确认项目权限、字段配置和工作流规则，不同团队的 Issue 类型、状态和必填字段可能不同；涉及批量改状态、改负责人或创建工单时，应先预览变更内容再执行。

下一个 Skill

jmmarotta-frontend-design（jmmarotta frontend 设计）

用于辅助前端页面、组件、样式和交互逻辑的开发与维护。它适合让 Agent 生成或审查 React、Next.js、Vue、Tailwind、CSS 等相关代码，整理组件结构，或定位布局和性能问题。使用时需要结合项目现有设计系统、路由和构建方式，避免只生成孤立片段；涉及页面改动时，应配合本地预览和构建检查确认视觉效果。