drpy-node-coder

drpy-node Coder

drpy-node 爬虫源的建、修、测、放、传全链路一体化 skill。自带 CLI 工具，无需安装 MCP 服务。

便携性说明（先读）

• ✅ 无需 MCP：所有能力内置在 scripts/cli.js，AI 直接 node scripts/cli.js <命令> 调用。
• ⚠️ cli.js 在 skill 自身目录（~/.zcode/skills/drpy-node-coder/scripts/cli.js），不在 drpy-node 仓库里——drpy-node/scripts 下没有 cli.js。工作目录随意（CLI 通过 setup 记录的根定位找到 drpy-node），别 cd 错地方。
• ✅ 零 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路径>] [--target <网关名>] <命令> [参数] [--flags]。所有命令输出 JSON：成功 {"ok":true,"data":...}、失败 {"ok":false,"error":...}。
• 输出读取：少数命令（test/evaluate）首次加载测试引擎时 stdout 可能有一次初始化日志，业务 JSON 始终是 stdout 最后一行，按最后一行 { 解析。Windows Git Bash 下输出里可能混入 ANSI 清屏序列（ESC[H2J），直接解析会失败，先 | tr -d '\033' | grep -v '^\[H\[2J' 清洗。
• data_preview 是截断文本（约 3KB，尾部 ... (数据已截断，共 N 字符)），截断点可能切开 JSON 字符串——对 preview 做 JSON.parse 必炸。结构化取值只用 item_count / first_item（同样截断至 500 字符）字段，或对整行输出 grep 关键词；要完整数据请换姿势（见下文「测试实战陷阱」）。

网关与远程执行（local / 远程 drpy-node 多网关）

CLI 天然支持多网关：local（默认，本地 drpy-node）+ 任意多个远程部署的 drpy-node。

node cli.js gateway add prod http://1.2.3.4:5757 --user admin --password .. --api-pwd ..
node cli.js gateway persist prod    # 凭据固化到系统级环境变量，新会话零配置（首次配置必跑）
node cli.js gateway test prod       # 探活+版本+端点可用性（首次连接远程必跑）
node cli.js gateway use prod        # 切换默认网关（nvm use 式，持久化）
node cli.js src list --target prod  # 单次显式覆盖，不改默认
node cli.js gateway use local       # 切回本地

首连引导剧本（用户不会敲命令时必走）

用户往往只说"帮我配置/连上远端 drpy-node http://x.x.x.x:5757"，不会提 gateway 命令。AI 按此剧本主动执行，缺什么追问什么，不要把命令甩给用户：

1. 地址缺失先问地址：要到 IP/域名+端口（drpy-node 默认 5757；docker 部署确认端口已映射、防火墙放行）。
2. 先试探后追问：gateway add <建议名> <url>（先不带凭据）→ gateway test <名>，按探测结果精准提问，不要一次问全：
   • 401 鉴权失败 → 追问远端 .env 的 API_AUTH_NAME/API_AUTH_CODE，顺带确认是否有 API_PWD
   • runtime 404 → 告知远端 drpy-node 版本过旧需升级
   • 全 ok → 无需凭据，跳到第 4 步
3. 带凭据重配+固化：gateway add <名> <url> --overwrite --user .. --password .. --api-pwd .. → gateway persist <名>（一次性固化：凭据写入 Windows 用户级环境变量 + Git Bash profile，配置文件改存变量名、清掉明文；幂等可重跑）→ gateway test 全绿。此后任何新终端/新会话零配置可用，无需再 export。明文→固化的两步由 AI 连续完成，用户只需提供一次凭据。
4. 切换+验证：gateway use <名> → 真实跑一条（如 src list）→ 向用户报告连接摘要（远端版本、源数量、网关名、当前指向）。