feat: 增加调试模式，方便写猫源

Taois · Taois · commit 4dc8189bcac9 · 2025-08-14T16:30:21.000+08:00
diff --git a/.env.development b/.env.development
@@ -29,4 +29,5 @@ tx_news_guonei_api_key=
 
 # QQ邮箱配置
 QQ_EMAIL =
-QQ_SMTP_AUTH_CODE =
+QQ_SMTP_AUTH_CODE =
+CAT_DEBUG=0
diff --git a/README.md b/README.md
@@ -1,14 +1,15 @@
 # drpyS(drpy-node)
 
 nodejs作为服务端的drpy实现。全面升级异步写法  
-~~积极开发中，每日一更~~，当前进度 `71%`  
+~~积极开发中，每日一更~~，当前进度 `72%`  
 ~~找工作中，随缘更新~~  
 上班当牛马，下班要带娃，阶段性佛系趁娃睡觉熬夜更新
 
 * [接口文档](docs/apidoc.md) | [接口列表如定时任务](docs/apiList.md) | [小猫影视-待对接T4](https://github.com/waifu-project/movie/pull/135)
 * [本地配置接口-动态本地](/config?pwd=$pwd)
 * [本地配置接口-动态外网/局域网](/config/1?pwd=$pwd)
 * [其他配置接口-订阅过滤](/docs/sub.md)
+* [猫源调试教程](/docs/catDebug.md)
 * [代码加解密工具](/admin/encoder)
 * [V我50支付凭证生成器](/authcoder?len=10&number=1)
 * [接口压测教程](/docs/httpTest.md)
@@ -23,6 +24,10 @@ nodejs作为服务端的drpy实现。全面升级异步写法
 
 ## 更新记录
 
+### 20250814
+
+更新至V1.2.11
+
 ### 20250813
 
 更新至V1.2.10
diff --git a/docs/catDebug.md b/docs/catDebug.md
@@ -0,0 +1,30 @@
+# 猫源调试教程
+
+道长只有windows环境，这里以windows为例
+
+1. 环境变量 .env 里 确保 `CAT_DEBUG=1`
+2. 启动时通过 `dev-win-debug` 脚本启动 或者 `yarn dev-win-debug`
+3. 谷歌浏览器 输入 `chrome://inspect`，在里面找到本地项目对应的端口
+4. 在浏览器上找到类似 这种字符串:
+
+```
+Remote Target #LOCALHOST
+localhost:9229 (v22.14.0) trace
+index.js file:///E:/_gitwork_drpy-node_index.js
+```
+
+点击下方的 `inspect` 超链接会打开一个控制台窗口，显示 `devTools`
+
+1. 在 `devTools` 控制台可以看到输出，在源代码来源标签页可以看到运行的js文件。
+   找到对应的源如 `spider/catvod` 里面的猫测试，进去打断点
+2. 确保 在 `config/env.json` 里有 `"enable_cat": "2"`,猫源用T4方式运行
+3. 浏览器访问 `http://127.0.0.1:5757/api/猫测试?do=cat&pwd=dzyyds` 这样的链接就可以访问触发程序的断点
+
+## 其它说明
+
+1. 环境变量 .env 里  `CAT_DEBUG=0` 也可以调试，同时支持显示 `getProxyUrl` `ENV` 等特殊变量。
+   只是调试的时候js需要在(无网域)下面找到 `data:text/javascript;base64,` 开头的文件。
+
+2. DS源是特殊字符串读取虚拟机运行方式，无法调试，我已经试过了，各位就不用再试了，调试源只针对catvod目录下的esm源
+3. 已测试 `webstorm` 等工具自带的调试模式无法调试动态import的源，也就是对 `catvod` 源无法调试，但是可以调试ds框架主js相关逻辑。
+   所以写源调试还是要按我提供的教程来操作。
diff --git a/docs/updateRecord.md b/docs/updateRecord.md
@@ -1,5 +1,13 @@
 # drpyS更新记录
 
+### 20250814
+
+更新至V1.2.11
+
+1. 定时任务 增加 `QQ邮箱` 的消息推送方式
+2. `cat源` 增加调试模式，但是不支持 `getProxyUrl` 等方法，需要在环境变量.env文件里启用 `CAT_DEBUG=1`。
+   详情参考 [猫源调试教程](/docs/catDebug.md)
+
 ### 20250813
 
 更新至V1.2.10
diff --git a/libs/catvod.js b/libs/catvod.js
@@ -12,6 +12,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const _data_path = path.join(__dirname, '../data');
 const _config_path = path.join(__dirname, '../config');
 const _lib_path = path.join(__dirname, '../spider/catvod');
+const enable_cat_debug = Number(process.env.CAT_DEBUG) || 0;
 
 
 const json2Object = function (json) {
@@ -82,7 +83,12 @@ const init = async function (filePath, env = {}, refresh) {
         }
         log(`Loading module: ${filePath}`);
         let t1 = getNowTime();
-        const module = await loadEsmWithEnv(filePath, env);
+        let module;
+        if (enable_cat_debug) {
+            module = await loadEsmWithHash(filePath, fileHash);
+        } else {
+            module = await loadEsmWithEnv(filePath, env);
+        }
         // console.log('module:', module);
         let rule;
         if (module && module.__jsEvalReturn && typeof module.__jsEvalReturn === 'function') {
diff --git a/package.json b/package.json
@@ -7,6 +7,7 @@
     "build": "node index.js",
     "dev": "node index.js",
     "dev-win": "chcp 65001 && node --trace-deprecation index.js",
+    "dev-win-debug": "chcp 65001 && node --trace-deprecation --inspect index.js",
     "pm2": "pm2 start index.js --name drpys",
     "node22": "node --experimental-sqlite index.js",
     "node22-win": "chcp 65001 && node --trace-deprecation --experimental-sqlite index.js",
diff --git a/public/index.html b/public/index.html
@@ -8,12 +8,13 @@
                 </head>
                 <body>
                     <h1 id="drpysdrpy-node">drpyS(drpy-node)</h1>
-<p>nodejs作为服务端的drpy实现。全面升级异步写法<br><del>积极开发中，每日一更</del>，当前进度 <code>71%</code><br><del>找工作中，随缘更新</del><br>上班当牛马，下班要带娃，阶段性佛系趁娃睡觉熬夜更新</p>
+<p>nodejs作为服务端的drpy实现。全面升级异步写法<br><del>积极开发中，每日一更</del>，当前进度 <code>72%</code><br><del>找工作中，随缘更新</del><br>上班当牛马，下班要带娃，阶段性佛系趁娃睡觉熬夜更新</p>
 <ul>
 <li><a href="docs/apidoc.md">接口文档</a> | <a href="docs/apiList.md">接口列表如定时任务</a> | <a href="https://github.com/waifu-project/movie/pull/135">小猫影视-待对接T4</a></li>
 <li><a href="/config?pwd=dzyyds">本地配置接口-动态本地</a></li>
 <li><a href="/config/1?pwd=dzyyds">本地配置接口-动态外网/局域网</a></li>
 <li><a href="/docs/sub.md">其他配置接口-订阅过滤</a></li>
+<li><a href="/docs/catDebug.md">猫源调试教程</a></li>
 <li><a href="/admin/encoder">代码加解密工具</a></li>
 <li><a href="/authcoder?len=10&amp;number=1">V我50支付凭证生成器</a></li>
 <li><a href="/docs/httpTest.md">接口压测教程</a></li>
@@ -27,6 +28,8 @@ <h1 id="drpysdrpy-node">drpyS(drpy-node)</h1>
 <li><a href="/cat/index.html">在线猫ds源主页</a></li>
 </ul>
 <h2 id="更新记录">更新记录</h2>
+<h3 id="20250814">20250814</h3>
+<p>更新至V1.2.11</p>
 <h3 id="20250813">20250813</h3>
 <p>更新至V1.2.10</p>
 <h3 id="20250812">20250812</h3>
