add # 新增偷菜功能

docs/stealing.md

@@ -0,0 +1,41 @@
+# 偷菜与仓库输出规则
+
+## 偷菜
+
+仅支持发送 `偷菜 @用户`，不接受直接输入 QQ 号或在 @ 后附加文字。
+仅支持当前机器人、平台共享范围内的
+已开通农场，不允许偷自己。结果直接回复文字，避免额外绘图和图片发送。
+
+每次遍历目标全部地块；成熟、未枯萎且本季未被当前玩家偷过的地块，各随机
+偷取 1～3 个，直接进入偷取者的作物仓库。同名同编号的结果合并展示。
+未成熟、本季已偷过、防偷保护分别汇总跳过数量。
+
+本季总产量为土地加成后再按成熟时虫数减产的整数产量。剩余产量减去已偷
+数量；防偷下限为本季总产量的一半向上取整。临界时缩减本次偷取数量，
+保证不会穿过下限。例如本季产量 9 个，至少保留 5 个。
+
+保留每日最多 5 次成功偷菜规则，以北京时间零点刷新；一次访问无论偷取
+多少地块只算一次成功，完全未偷到不扣次数。操作记录持久化，重启不重置。
+同一消息重放返回原收据，不会重复扣产或入库。
+
+目标扣产、偷取者入库、去重记录、操作收据均在一个 SQLite 事务中提交。
+收获按剩余产量入库，并清除本季偷取记录；再生长进入下一季后可重新偷取。
+农场详述显示扣除偷取后的预计产出，不额外展示被偷数量。
+
+已有核心数据库版本 1～3 在启动时顺序迁移至版本 4。新增字段仅保存
+本季已被偷数量；独立记录表用于判定每个玩家是否偷过当前季。
+
+## 仓库图片质量
+
+`我的种子`、`我的作物` 支持以下输出，页码可省略，默认第 1 页：
+
+| 指令参数 | 尺寸 | JPEG 质量 | 用途 |
+| --- | --- | --- | --- |
+| `[页码]` | 768 × 1152 | 70 | 默认标准压缩图 |
+| `[页码] 高清` | 1024 × 1536 | 85 | 放大查看文字 |
+| `[页码] 文字` | 无图片 | 无 | 老机器、网络慢时使用 |
+
+每页最多 12 项；标准档按实际输出尺寸绘制。相同快照、分类、页码、质量
+可复用有界内存缓存，并共享进行中的绘图任务；绘图并发数为 1，队列有上限。
+默认 AUTO 输出 JPEG；部署者显式配置其他图片格式时仍尊重该设置。
+图片日志记录尺寸、质量、字节数；实际耗时随机器、字体、缓存而变化。