findscripter 何时使用
适用场景：
- 分析核心转储（core dump / crash dump），定位崩溃位置与根因。
- 用 GDB attach 调试正在运行的进程（如卡死的服务）。
- 排查崩溃、死锁、内存损坏等问题。
- 调试多线程程序，关联源码上下文做智能分析。
不该用（负边界）：
- 任务与 C/C++ 调试无关。
- 用户只需通用协助，并不涉及调试。
- 环境不满足：需 GDB 9.0+ 且启用 Python 支持、Python 3.6.8+、Linux 系统；缺这些条件不要使用本技能。
前置准备：
# 安装 gdb-cli
pip install gdb-cli
# 或从 GitHub 安装
pip install git+https://github.com/Cerdore/gdb-cli.git
# 验证 GDB 已启用 Python 支持
gdb -nx -q -batch -ex "python print('OK')"
步骤
- 初始化会话：加载 core 或 attach 进程，记下返回的
session_id。 - 收集初始信息：线程列表、带局部变量的回溯、寄存器。
- 关联源码（关键）：对每个栈帧读取崩溃点 ±20 行源码，结合局部变量值分析逻辑。
- 深入排查：求值变量/字段、查类型、查内存、反汇编、遍历全部线程（死锁）。
- 会话管理：查看状态、用完即
stop清理。
指令
初始化会话：
# 加载核心转储
gdb-cli load --binary <binary_path> --core <core_path> [--gdb-path <gdb_path>]
# 附加运行进程
gdb-cli attach --pid <pid> [--binary <binary_path>]
返回形如 "session_id": "a1b2c3"，后续命令复用：
SESSION="<session_id>"
# 线程列表
gdb-cli threads -s $SESSION
# 回溯（含局部变量）
gdb-cli bt -s $SESSION --full
# 寄存器
gdb-cli registers -s $SESSION
# 指定帧的局部变量
gdb-cli locals-cmd -s $SESSION --frame <N>
深入排查：
# 求值变量 / 指针字段
gdb-cli eval-cmd -s $SESSION "variable_name"
gdb-cli eval-cmd -s $SESSION "ptr->field"
# 查看类型定义
gdb-cli ptype -s $SESSION "struct_name"
# 内存检查
gdb-cli memory -s $SESSION "0x7fffffffe000" --size 64
# 反汇编
gdb-cli disasm -s $SESSION --count 20
# 遍历全部线程回溯（死锁分析）
gdb-cli thread-apply -s $SESSION bt --all
# 共享库
gdb-cli sharedlibs -s $SESSION
会话管理：
gdb-cli sessions # 列出活动会话
gdb-cli status -s $SESSION # 查看会话状态
gdb-cli stop -s $SESSION # 停止并清理
常见模式速查：
- 空指针解引用：崩溃在内存访问指令、指针为
0x0。查registers（看 RIP）+eval-cmd "ptr"。 - 死锁：多线程卡在锁函数、回溯出现
pthread_mutex_lock。用thread-apply ... bt --all找循环等待。 - 内存损坏：崩溃在 malloc/free、变量为乱码值。查
memory "&variable" --size 128+registers。
示例
源码与运行时关联（核心方法）：
Frame #0: process_data() at src/worker.c:87
源码：
85: Node* node = get_node(id);
86: if (node == NULL) return;
87: node->data = value; <- 崩溃在此
变量：
node = 0x0 (NULL)
结论：第 86 行的 NULL 检查未拦住该问题。
核心转储分析：
gdb-cli load --binary ./myapp --core /tmp/core.1234
gdb-cli bt -s a1b2c3 --full # 崩溃位置
gdb-cli locals-cmd -s a1b2c3 --frame 0
运行进程调试：
gdb-cli attach --pid 12345
gdb-cli threads -s b2c3d4
gdb-cli thread-apply -s b2c3d4 bt --all
注意事项
最佳实践：
- 先读源码再据变量值下结论，避免误判。
- 线程数多或回溯过深时用
--range分页。 - 用
ptype先理解复杂数据结构再看值。 - 多线程问题务必检查所有线程；类型需与源码定义交叉核对。
安全与权限：
- 本技能需访问进程与核心转储；attach 进程可能需要相应权限（sudo、ptrace_scope）。
- 核心转储可能包含敏感数据，谨慎处理。
- 只调试你有授权分析的进程。
- 输出不能替代针对具体环境的验证、测试或专家复核；缺少必要输入、权限、安全边界或成功标准时应暂停并澄清。
互见
- 系统化调试方法论（systematic-debugging）：通用调试流程。
- 测试驱动开发（test-driven-development）：先写测试再实现。
- 仓库 https://github.com/Cerdore/gdb-cli ｜ PyPI https://pypi.org/project/gdb-cli/
采编自 sickn33/antigravity-awesome-skills（MIT）。