main_plugin_farm/docs/stealing.md

# 偷菜与仓库输出规则

## 偷菜

仅支持发送 `偷菜 @用户`，不接受直接输入 QQ 号或在 @ 后附加文字。
仅支持当前机器人、平台共享范围内的
已开通农场，不允许偷自己。结果直接回复文字，避免额外绘图和图片发送。

每次遍历目标全部地块；成熟、未枯萎且本季未被当前玩家偷过的地块，各随机
偷取 1～3 个，直接进入偷取者的作物仓库。同名同编号的结果合并展示。
未成熟、本季已偷过、防偷保护分别汇总跳过数量。

本季总产量为土地加成后再按成熟时虫数减产的整数产量。剩余产量减去已偷
数量；防偷下限为本季总产量的一半向上取整。临界时缩减本次偷取数量，
保证不会穿过下限。例如本季产量 9 个，至少保留 5 个。

保留每日最多 5 次成功偷菜规则，以北京时间零点刷新；一次访问无论偷取
多少地块只算一次成功，完全未偷到不扣次数。操作记录持久化，重启不重置。
同一消息重放返回原收据，不会重复扣产或入库。

目标扣产、偷取者入库、去重记录、操作收据均在一个 SQLite 事务中提交。
收获按剩余产量入库，并清除本季偷取记录；再生长进入下一季后可重新偷取。
农场详述显示扣除偷取后的预计产出，不额外展示被偷数量。

已有核心数据库版本 1～3 在启动时顺序迁移至版本 4。新增字段仅保存
本季已被偷数量；独立记录表用于判定每个玩家是否偷过当前季。

## 仓库图片质量

`我的种子`、`我的作物` 支持以下输出，页码可省略，默认第 1 页：

| 指令参数 | 尺寸 | JPEG 质量 | 用途 |
| --- | --- | --- | --- |
| `[页码]` | 768 × 1152 | 70 | 默认标准压缩图 |
| `[页码] 高清` | 1024 × 1536 | 85 | 放大查看文字 |
| `[页码] 文字` | 无图片 | 无 | 老机器、网络慢时使用 |

每页最多 12 项；标准档按实际输出尺寸绘制。相同快照、分类、页码、质量
可复用有界内存缓存，并共享进行中的绘图任务；绘图并发数为 1，队列有上限。
默认 AUTO 输出 JPEG；部署者显式配置其他图片格式时仍尊重该设置。
图片日志记录尺寸、质量、字节数；实际耗时随机器、字体、缓存而变化。