ARTICLE · 1360746
iOS 内存与诊断取证工具包:DSH 插件(15 个 ios_* 工具 + 右侧栏面板)、MCP server、代码健康扫描
免责声明
由于传播、利用本公众号夜组安全所提供的信息而造成的任何直接或者间接的后果及损失,均由使用者本人负责,公众号夜组安全及作者不为此承担任何责任,一旦造成后果请自行承担!如有侵权烦请告知,我们会立即删除并致歉。谢谢!所有工具安全性自测!!!VX:NightCTI
朋友们现在只对常读和星标的公众号才展示大图推送,建议大家把夜组安全“设为星标”,否则可能就看不到了啦!

工具介绍dsh-ios-diag
一个 DeepSeek Harness(DSH)插件,同时是一个 stdio MCP server 和一组命令行工具。 做三件事:在模拟器上把能测的尽量测完、给真机做一次尽可能全的取证、把结论变成可交接的报告。
对被测项目只读:不写它的代码、不写它的基线文档、不要求它加埋点。

1. 这个项目到底想解决什么
真机测试是一次高成本事件:设备、接线、装包、复现、抓数、传回。人不在电脑边时,这一天就废了。
所以目标不是「再做一个 Instruments」,而是:
$TMPDIR 并即删;报告写在本仓库 |
一句话:把「感觉卡」变成「可比较的数字 + 可追溯的记录」。

2. 三种用法
| DSH 插件 | ios_* 工具 + 「内存」面板 | |
| MCP server | node bin/mcp.mjs | |
| 命令行 | npm run healthnpm run report、npm run handoff |
三者共用同一份内核(core/),工具行为不会分叉。
装进 DSH
# 在 DSH 里用 plugin_manager:install_bundle,target 指向本目录# 之后新会话即可看到 ios_* 工具接 MCP
{"mcpServers": {"ios-mem": {"command": "node","args": ["/Users/ruska/projects/dsh-plugins/dsh-ios-diag/bin/mcp.mjs"] } }}不要把 MCP 再挂回 DSH:DSH 已经有同名原生工具,挂上去只会多出两份工具和第二个采样进程。
3. 能力清单(15 个工具)
ios_mem_targets | ||
ios_mem_startios_mem_stop | ||
ios_mem_status | ||
ios_mem_detail | ||
ios_mem_mark | ||
ios_mem_record | ||
ios_mem_types | ||
ios_mem_launch | ||
ios_log_query | log show --style json),可 grep | |
ios_hang_sample | sample),回答「卡住时在干什么」 | |
ios_preflight | ||
ios_net_analyze | ||
ios_events_export | ||
ios_events_query | ||
npm run reportnpm run handoff |
平台说明:模拟器指 App 跑在 Mac 上的模拟器进程;真机指 USB 连接的物理设备;文件指只处理本地文件,不需要设备。
4. 给 AI / Agent 的使用指南
4.1 典型工作流
装真机前 ios_preflight → 有问题先修 ios_mem_start → 做操作 → ios_mem_mark("进入会话") → ios_mem_status → ios_log_query / ios_hang_sample 交叉看 → ios_events_export → npm run report → npm run handoff装真机后 ios_mem_record / ios_mem_types(真机录制)有 pcap ios_net_analyze → 对象进事件表4.2 调用约定
**先 ios_mem_targets**,拿udid + bundleId(或 pid)。不要猜 pid。pid 优先,bundleId 兜底:传 pid最快;只传bundleId会自动找。打点要贴着操作: ios_mem_start→ 操作 →ios_mem_mark("刚做了什么")。没有打点的曲线很难归因。别重复开采样:同一时间只保留一个采样环;再次 start会清空上一轮。真机工具会重新 launch App(xctrace 的 --launch),别在操作中途调用。报告不要手写数字: ios_events_export→npm run report,让规则算。
4.3 什么时候该用哪个
ios_hang_sampleios_mem_status(是否持续上涨) | |
ios_preflightios_mem_record(是否接近 jetsam) | |
ios_log_queryios_net_analyze(pcap) | |
ios_mem_detailios_mem_types(真机) | |
ios_mem_start |
5. 数据模型:事件与链接
导出的一轮叫一个 run,落在 docs/measurements/_runs/<时间>/(不入库)。
// events.jsonl:一行一个对象实例{"ts":"...","type":"mem_sample","id":"mem:1","sessionId":"run:...","rpcId":null,"pid":42, "attrs":{"totalMB":50.3,"top":"Malloc Nano"}}// links.jsonl:一行一条链接实例{"from":"mem:1","type":"contained_in","to":"run:...","method":"id","confidence":1}{"from":"mem:21","type":"contained_in","to":"mark:1","method":"time","confidence":0.5}硬规则:链接必须带 method(id = 有身份证的事实,time = 时间推断)和 confidence。 报告里两者分开展示;把推断当事实,比没有链接更糟。
6. 报告与交接
npm run report -- --run 20261114-1603 --project dsh-pocket-ios --title "内存采样"npm run handoff -- --report docs/measurements/dsh-pocket-ios/<...>.md报告固定六段:元信息 / 摘要 / 数据 / 异常与疑点 / 排查建议 / 复现。 交接消息带绝对路径,被测项目的 Agent 直接读文件,不用人肉转述。 目录约定: docs/measurements/<项目>/<YYYY-MM-DD-HHMM>-<主题>.md。
7. 代码健康扫描
npm run health -- --target /path/to/repo --project <slug> [--arch] [--coverage-json x.json] [--gate]五个维度:文件规模(>400 行)、SwiftLint 结构规则、覆盖率(xccov)、未使用代码(Periphery)、 目标仓库自己的架构检查。Periphery 需要一次构建(--periphery-project + --periphery-schemes), 本机已装但真跑未验证。--gate 任一不达标退出 1。对目标仓库只读。
工具获取
点击关注下方名片进入公众号
回复关键字【261116】获取下载链接
往期精彩
往期推荐
CVE-2026-98260-小米 17 Pro Max(popsicle)一键 root · KernelSU 越狱模式 | 仅限自己持有并授权的设备
AgenticPenTest | Agent 协作渗透测试工作台
CTF 线下赛用的离线 PHP 速查手册 | 11,930 条条目、196 条实战技巧、990 个payload、PHP 官方中文手册索引
DSH-purge 优化版:在上游 1.1.90 基础上恢复技能库 23 个技能、POC/EXP 知识库与本地靶场白名单、补齐 nuclei 模板类目
最新ARL-Next二开版本 | 现代化资产测绘与漏洞监控平台














































































