fixed # 修复工作流

readme/astrbot.md

@@ -40,11 +40,23 @@
 | `data_dir` | 空 | 留空使用 `data/plugin_data/astrbot_plugin_farm`；更改不会自动搬迁存档 |
 | `image_format` | `AUTO` | `AUTO` 为 JPEG；也可选 `JPEG` 或 `PNG` |
 | `image_quality` | `75` | 整数1～95，下一次图片请求生效；PNG不受影响 |
+| `resource_source`（资源获取地址） | `Github` | `Github`、`Gitea`、`farm_service`，重载生效 |
+| `farm_service_url`（farm_service 地址） | 空 | 独立HTTPS基础地址，供资源及后续活动服务共用；选farm_service下载时必填 |
 
 除图片质量外，配置变更后请重载插件。高清农场的图片质量不低于85。
 依赖 Pillow 和 aiohttp，由插件依赖声明安装；插件不捆绑中文字体。
 当前重点适配 QQ/OneBot（`aiocqhttp`），其他平台尚未完成真实环境验证。
 
+插件不携带大型`assets.zip`。启动时校验数据目录下缓存素材的SHA256，
+缺失或不匹配时从所选源下载并校验后原子替换；GitHub/Gitea均从
+`farm_service`仓库根目录`assets/`获取。默认Github，不自动跨源切换；
+下载失败保留文字功能，调整来源后重载重试。两项配置始终同时存在，
+活动功能尚未实现。已有正确缓存时不联网。
+
+离线部署可将服务仓库的`assets/assets.zip`放到农场数据目录
+`assets/<SHA256>/assets.zip`；SHA见插件的`_vendor/farm_render/data/asset-manifest.json`。
+请先提交/发布服务仓库的素材，再发布依赖它的插件；不要把素材ZIP放回插件仓库。
+
 ## 玩法与旧账号兼容
 
 - 新账号初始6块土地。`/开垦 条件` 查询下一块地的等级和费用，

readme/nonebot.md

@@ -23,6 +23,8 @@ FARM_FONT=C:/Windows/Fonts/msyh.ttc
 FARM_IMAGE_FORMAT=AUTO
 FARM_IMAGE_QUALITY=75
 FARM_DEPLOYMENT=nonebot
+FARM_RESOURCE_SOURCE=Github
+FARM_SERVICE_URL=
 ```
 
 `FARM_DATA_DIR` 可显式指定数据目录，默认沿用旧版插件 localstore 下的
@@ -30,6 +32,13 @@ FARM_DEPLOYMENT=nonebot
 机器人和平台迁入 `farm.sqlite3`；遇到账号或平台冲突会拒绝覆盖。
 日志写入该目录的 `farm-preview.log`。字体不可用时提供文字响应。
 
+`FARM_RESOURCE_SOURCE`（资源获取地址）支持`Github`、`Gitea`、`farm_service`，
+默认`Github`。`FARM_SERVICE_URL`（farm_service 地址）始终独立存在，
+供资源及后续活动功能共用；选择farm_service下载时须填写HTTPS基础地址。
+两项修改后重载。插件不包含素材ZIP：每次启动校验本地SHA256，缺失或不匹配
+才从`farm_service`仓库根目录`assets/assets.zip`下载，校验成功后原子替换。
+失败时保留文字功能，不自动跨源切换，重载后重试。活动功能尚未实施。
+
 `FARM_IMAGE_QUALITY` 为整数1～95，默认75，统一控制全部农场图片
 的编码质量；越高通常越清晰、文件越大，PNG无损格式不受此值影响。
 启动时校验配置。只有“我的农场 高清”允许高清，使用1536宽，质量

readme/zhenxun.md

@@ -3,6 +3,13 @@
 # 真寻农场(zhenxun_plugin_farm)
 
 <img src="./logo.png" width="400" alt="真寻农场 Logo">
+
+> 资源配置：「资源获取地址」默认Github，可选Github、Gitea、farm_service；
+> 「farm_service 地址」始终独立存在，供资源及后续活动服务共用。
+> 选择farm_service下载时填写HTTPS基础地址，两项修改后重载。
+> 插件不携带assets.zip，启动校验缓存SHA256，缺失或不匹配时从所选源获取；
+> Github/Gitea均使用farm_service仓库根目录assets/。失败保留文字功能，重载重试。
+> 活动服务尚未实现，请先发布服务仓库素材再发布插件。
 <p align="center">
     <a href="./LICENSE">
         <img src="https://img.shields.io/badge/license-GPL3.0-FE7D37" alt="license">