docs(spider): 补充 Python 站源加载与缓存排查说明

Browse source

排查「改了 py 却不生效」缺少可查的文档依据，补上加载链路与实际生效条件。

- 说明 getDependence 缺失按无依赖处理，不继承 base.spider.Spider 的
  单文件 py 源可以不实现
- 新增「Python 加载与缓存」小节：file:// 改写、api md5 缓存名、
  Spider 实例缓存、load_module 的 sys.modules 旧模块，共四层
- 记录实测结论：只替换磁盘 py 不生效，需触发配置重载或重启 App
- Source 依据补充 Loader.java / app.py / UrlUtil.java / Site.java

Verification: 文档核对：新增 Python 加载与缓存四层链路说明，并逐项对照源码（Site.objectFrom→UrlUtil.convert 的 file:// 改写、Loader.scriptName 的 api md5 缓存名、PyLoader.computeIfAbsent 实例缓存、app.spider 的 load_module/sys.modules）与真机实测（5557，同版本包同站点：只替换磁盘 py 不生效；触发真实配置重载 config/use→VodConfig.clear→BaseLoader.clear→PyLoader.clear 后生效 MK_B→MK_C；重启 App 生效）；新增的 python-spider init failed 可诊断性说明与 317fa9021d 的实现一致；文档末尾 Source 依据新增的 4 个路径均已逐一确认存在于仓库；行尾保持 CRLF（195 CRLF / 0 bare LF）；markdownlint 通过

Task-Guard: PY-SPIDER-CACHE-DOC-20261016

...

This commit is contained in:

Silent1566 2026-10-16 10:50:51 +08:00

parent 317fa9021d

commit 96771c8a98

1 changed files with 25 additions and 0 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download patch file Download diff file Expand all files Collapse all files

25

docs/integration/spider.md

View file