| name | drpy-node-coder |
| description | drpy-node 爬虫源全生命周期一体化 skill——建源、诊断、修复、测试、播放调试、仓库发布。自带 CLI（scripts/cli.js），无需安装 MCP。用户提到"新建源/写源/做源/建源/生成源/爬虫源""修源/测试某个源/详情为空/搜索异常/源无效/低分评估/诊断/排障/规则不生效""播放不通/lazy 不对/iframe/m3u8/parse:0/1/假播放/加密链接/防盗链""上传仓库/替换上传/改标签/发布源/同步源/打标签/分享源"时使用。 |
drpy-node Coder
drpy-node 爬虫源的建、修、测、放、传全链路一体化 skill。自带 CLI 工具，无需安装 MCP 服务。
便携性说明（先读）
- ✅ 无需 MCP：所有能力内置在
scripts/cli.js，AI 直接 node scripts/cli.js <命令> 调用。
- ✅ 零 npm 依赖：无需
npm install。localDsCore 测试引擎 bundle（14M，全内联 cheerio/axios/drpyS/htmlParser）+ sqlite + 编码 wasm 自带于 scripts/vendor/。
- ⚠️ 前置：本机需有
drpy-node 项目（CLI 复用其 req/pdfa/drpyS/DS解密 源码模块——这些互相 import、非 bundle，搬不动；但 localDsCore 已内联进 vendor/，test/evaluate 不再依赖 drpy-node-bundle 目录）。
- 首次使用：
cd scripts && node cli.js setup <drpy-node-绝对路径> && node cli.js doctor。
- 调用范式：
node scripts/cli.js [--root <drpy-node路径>] <命令> [参数] [--flags]。所有命令输出 JSON：成功 {"ok":true,"data":...}、失败 {"ok":false,"error":...}。
- 输出读取：少数命令（test/evaluate）首次加载测试引擎时 stdout 可能有一次初始化日志，业务 JSON 始终是 stdout 最后一行，按最后一行
{ 解析。
总控工作流（5 步闭环）
用户输入
│
Step1 识别输入 ──仅 URL──→ 分析站点 → 建源路线
│（已有源名/文件）
Step2 评估现状：syntax+validate(L1) → test 单接口(L2) → evaluate 全流程(L3)
│
Step3 判断失败类型：A规则不通 / B评估串联 / C播放链
│ 🛑 检查点1：确认诊断结论
Step4 分流执行：本 skill 修 / 转播放调试 / 转仓库
│
Step5 收束：evaluate 复评 → 🛑 检查点2 → 上传建议 / 结束
核心原则：先评估 → 再分流 → 再修复 → 再验证 → 最后给上传建议。不要一上来就重写。
模式闸门：先判断是否允许写入
| 用户模式 | 允许 | 禁止 |
|---|
| 只读/dry-run/只规划 | 读取、诊断、给方案和验证计划 | fs write/edit、house upload/* |
| 需确认后改 | 读取、诊断、输出拟改字段+验证计划 | 未确认前改源或仓库元数据 |
| 明确执行 | 按 L1/L2/L3 证据最小修复 | 跳过大改确认点、直接仓库 mutation |
| 自主全流程（"修到100""自动完成""做源并上传"） | alive check→建源→低风险修复→播放→L3=100→上传 | 坏站硬写、未达目标冒充完成、目标不明上传 |
任务分派表（场景 → 路线 + 首读 reference + 关键命令）
| 场景 | 路线 | 首读 reference | 关键 CLI 命令 |
|---|
| 仅 URL，新建源 | 建源 A/B/C/D | references-create-checklist.md、references-template-system.md | fetch guess analyze template fs write syntax validate test evaluate |
| 已有源评估低分 | 诊断 A/B/C | references-workflow-triage.md、references-framework-internals.md | fs read resolved evaluate test |
| detail 通但 play 异常 | 播放专项 | references-play-lazy-summary.md | test <src> detail test <src> play iframe fetch + Playwright（见下） |
| 上传/替换/改标签 | 仓库守门 | references-upload-decision.md | house verify house upload house list house info house tags |
| 模板继承排查 | 路线 A | references-template-summary.md、references-inherited-template-minimal-override-site.md | guess resolved |
| 纯 API/SPA 站 | 路线 C | references-pure-api-async-site.md、references-api-functions.md | fetch analyze |
| 签名接口站 | 路线 B2 | references-non-template-signed-api-site.md | fetch + 浏览器抓包 |
| 二级字典/多集 | detail 规范 | references-detail-dict-and-multiep.md | debug test <src> detail |
| 搜索异常 | 搜索策略 | references-search-strategies.md、references-old-encoding-search-site.md | test <src> search |
| async 函数陷阱 | 通用 | references-async-function-patterns.md | — |
| 特殊内容(漫画/小说/音乐/网盘) | 路线 D | references-special-content.md | — |
| 多引擎源(php/hipy/cat) | 路线 E | references-multi-engine-sources.md | fetch + curl ?do=py/php/cat&extend=（必须带 extend；hipy 改源需 kill daemon） |
建源 30 秒路线（仅 URL 入口）
Step 0 alive check（自主模式不可跳过）：fetch <url> 确认可达；guess <url> 探模板；analyze <url> 看 HTML/SPA。遇 broken_site/hard_anti_bot/missing_credentials 停手。
站型分派（先 guess）：
- 命中模板 → A 模板继承（最小覆盖 host/url/searchUrl/class_parse，勿急重写）
- 未命中+DOM 完整 → B1 字符串规则（+二级字典）
- 未命中+签名接口 → B2 async 一级/搜索
- body 空+JSON API → C 全 async
- 漫画/小说/音乐/网盘 → D 特殊内容
- 403/登录/验证码 → 停手
7 条必背规则（含 async 的源必过）：①this.input 是 URL 不是响应，须 await request(this.input) ②纯数字 vod_id 必设 detailUrl ③POST 用 body 非 data ④searchUrl 必带 ** ⑤推荐要全量聚合去重 ⑥async 用 this.input/this.MY_CATE/this.MY_PAGE，勿手拼 URL ⑦不写重复同名属性。
写入验证链：template → fs write spider/js/源名.js → syntax → validate → test home/category/detail/search/play → evaluate。
诊断 L1/L2/L3 证据链
| 等级 | 命令 | 能下结论 | 不能下结论 |
|---|
| L1 | syntax + validate | 非语法残档、rule 结构合法，可拆测 | 可用、已修好、可上传 |
| L2 | test <src> <iface> 单接口 | 某接口真实通/断（须带真实上游返回值） | 全链稳定、可发布 |
| L3 | evaluate <src> 全流程 | 首页→一级→二级→播放→搜索串联评分 | 站点长期稳定 |
结论必须带等级，例"L2 显示 detail 通、play 断"，不要说成"整个源不通"。单接口测试必须用上游真实返回值（category→vod_id→detail→play_url），不要手推 ID。
evaluate 丢分映射：首页20+一级20丢 → class_parse 未命中；仅首页20丢 → double 不匹配；搜索10丢 → 已按源名后缀选默认词(漫画->海贼王/小说->修仙/短剧->离婚/音频->故事)，仍丢则换词查 searchUrl；二级25丢 → detailUrl/二级字典；播放25丢 → 先看 test detail 的 play_url_diagnosis：detail 有数据但 vod_play_url 空属二级选择器/detailUrl 问题(非 play 层)，按 hint 修二级；仅当 detail 完整且 play 真失败才转 Playwright 嗅探。常见误判：detail 返回列表项(只有 vod_id/vod_name/vod_pic)而非完整详情 = 缺 detailUrl。
播放调试（Playwright 复用指引）
CLI 提供 test <src> play、iframe <url>、fetch <url>。浏览器嗅探能力不在 CLI 内——需要嗅探 JS 运行时生成的 m3u8/签名时，使用你已连接的 Playwright MCP：
browser_navigate(play_url) 打开播放页browser_network_requests(filter='m3u8|mp4|api|play|url') 看运行时请求- 需点播放按钮则
browser_snapshot 找按钮→点击→再看网络
- 提取真实媒体 URL 或签名 API，回写 lazy
lazy 三类型：common_lazy（播放页有 player_* JSON，先查 encrypt）/ def_lazy（{parse:1,url:input} 嗅探）/ cj_lazy（parse_url）。假通过识别：play success≠真实可播，返回 url 仍是 play.html/API/普通页时继续验扩展名/content-type/网络请求。
仓库发布守门
上传前必跑：house verify + syntax + validate + 源 metadata 自洽。给出 A/B/C 档 + L1/L2/L3 证据：
- A 建议上传：至少 L2，最终版/自主要求 L3=100
- B 技术可传不建议：L1/L2，用户坚持才传
- C 暂不传：触红线（语法错/结构无效/metadata 不一致/详情空/播放假通过/特殊内容无对应协议）
上传：house upload <path> --tags <逗号分隔> --is-public true --auto-replace true（默认同名自动替换）。上传后 house info <cid> 核验 file_id/cid/tags/is_public 一致。
标签规则：不脑补、不因文件名带 [优] 就加 优，严格按用户明确要求；用户没说则从简。
强约束 / 停手边界
- 坏站/反爬/缺凭据 → 停手回报，不绕过（
broken_site/hard_anti_bot/missing_credentials）。
- 高风险重写（模板改全 async、删大段规则、引签名/登录态）→ 必须先给方案等确认。
- 仓库 mutation（upload/replace/tags/toggle）→ 必须
house verify + 目标确认 + info 核验。
- DS 加密源：用
fs read（自动解密），勿用 IDE Edit 直接改加密文件。
- hipy 源改动：改
spider/py/*.py 或 base/spider.py 后必须 kill t4_daemon 重载（daemon 缓存 module），否则改动不生效；ds/cat 改了直接生效无此问题。见 references-multi-engine-sources.md。
- 大改确认点：删手写规则、改 detail 线路逻辑、跨多 flag 的 lazy 重写 → 停手确认。
- 路径安全：所有文件操作限定在 drpy-node 项目内（isSafePath 强制）。
自主全流程 handoff packet
当用户要求"自动完成/修到100/做源并上传"时，贯穿建→修→测→传全程：
autonomous: true
target_score: 100
upload_preauthorized: true/false
tags/is_public: 用户明确值或空
source_name/path: ...
blocker_type: none/broken_site/hard_anti_bot/missing_credentials/high_risk_change/ambiguous_upload/score_below_target/detail_unstable
autonomous_next: continue_evaluate/return_workflow/stop_for_user
自主循环：alive check → 建源 → L1/L2/L3 → 按丢分最小修复 → play（detail 稳定时）→ L3=100 → house upload → info 核验。低风险不停手只记录；遇 high_risk/目标歧义/凭据缺失必须停手确认。
CLI 速查（高频；完整清单见 references-cli-commands.md）
node cli.js [--root <path>] doctor
node cli.js src list
node cli.js fetch <url> [--method POST --header k=v --data]
node cli.js analyze <url> | guess <url>
node cli.js debug --rule 'a&&href' --mode pdfh --url <url>
node cli.js fs read <path> | fs write <path> --content ...
node cli.js fs edit <path> replace_text --search .. --replacement ..
node cli.js syntax <path> | validate <path> | resolved <path>
node cli.js test <src> <home|category|detail|search|play> [--class-id/--ids/--keyword/--play-url/--flag]
node cli.js evaluate <src> [--keyword 斗罗大陆]
node cli.js house verify | house upload <path> --tags .. | house info <cid>
参数约定：位置参数在前，flags 在后（--flag value / --flag=value / --header k=v 可重复）。大文本用 --content-file 或 stdin。
Reference 使用规则
references/ 落地深度内容（建源清单/模板系统/async 陷阱/play lazy/上传决策/框架机制等）。主文件不重复 reference 内容，按「任务分派表」首读对应 reference。reference 不可达时不中断，按本文件内置规则最小排查并标注。
