chore(native): archive farm-core-foundation

docs/comet/archive/2026-10-26-farm-core-foundation/brief.md

@@ -0,0 +1,122 @@
+# Outcome
+
+在D:/Work/farm当前main工作区归档现有框架无关基础核心、共享绘图和
+真寻预览交付。按用户2026-10-26确认，将旧规格同步为已经实现并记录
+的规则，补齐离线验收；不借归档修改业务代码或实施作物Service迁移。
+
+# Scope
+
+- farm_core不依赖三种框架或Pillow；离线迁出旧基线202条作物，以稳定
+  本地ID为身份，运行时允许同名并拒绝名称歧义，不在运行时引用legacy。
+- SQLite保存权威账户、库存、地块、交易流水和幂等结果；显式身份由
+  deployment/realm/platform/user构成，不推断跨群或跨平台绑定。
+- 注册赠送500农场币、0点券、0经验及6块普通空地；可靠识别为初始
+  3块的旧用户仅补3块普通空地，保留已付费开垦成果，重试不重复补偿。
+- 购买、播种、收获、铲除、加锁/解锁、出售和查询保持整数校验、
+  事务原子性、失败传播及可注入时钟。已播种作物保存不可变结算定义。
+- 经验等级门槛200*k*(k+1)//2；播种每地+2、铲除每地+2经验，收获
+  逐地计算本次增量。首熟为time*3600，再生长沿用去重phase[1:]之和。
+- farm_render提供Pillow同步工具、有界缓存、目标尺寸绘制、后台受控
+  执行、三格式编码及安全日志；普通宽1024，农场高清宽1536。
+- 统一图片编码质量为整数1～95、默认75；仅我的农场接受高清，质量
+  为max(配置值,85)，其他查询拒绝高清，保留分页与文字。
+- 作物采用visible_contact_center统一定位及当前稳定地块编号映射，
+  不使用旧offset或逐阶段手调锚点；缺图明确占位并记录静态警告。
+- 开发素材独立导出，插件包含轻量元数据、清单和小型升级土地图；
+  大型assets.zip及字体ZIP不进发布包，按Github/Gitea/farm_service
+  选择源校验下载缓存。服务地址独立保留，显式中文字体优先；默认使用
+  原版小赖字体和完整OFL许可，资源不可用则接入层保留文字功能。
+- 真寻原指令、私有_vendor命名空间、稳定幂等与启动关闭生命周期；
+  白名单构建、独立验证及安全安装仅在临时目录测试。
+- 工作流执行检查并上传附件；push main或显式publish输入可触发固定
+  真寻发布仓库main分支的普通同步，PR不发布，脚本默认dry-run且不force。
+- 后续已存在的NoneBot/AstrBot、土地扩展/升级、偷菜、虫害及旧库迁移
+  保留现状，不加入本change的新需求；完整离线测试仍检查其回归。
+
+## Directory structure
+
+### Created
+
+本轮不新建业务模块；Comet生成正式验收报告与归档卷宗。
+
+### Modified
+
+- 当前brief与specs/farm-core、farm-render、zhenxun-preview/spec.md。
+- release/targets.json中的真寻目标分支记录与实际main规则对齐。
+- 如需记录本轮测量，使用现有runtime下的独立样例目录。
+
+### Deleted
+
+仅由Comet归档事务迁移当前change文件，不删除业务代码或玩家数据。
+
+### Not created
+
+不创建作物远程目录、Service接口、新业务模块、真实玩家库或新框架接入。
+
+# Non-goals
+
+- 不实施作物Service迁移或启动在线更新；另一个仓库中的迁移设计不
+  纳入本次归档，不因此视为已获实施确认或已实现。
+- 不改业务行为、重新平衡数值、修改legacy、重置或迁移真实玩家资产。
+- 不clone/fetch/pull/push，不创建PR、Release或执行实际跨仓库发布。
+- 不安装、启动或重启真实机器人，不部署Service，不访问真实玩家库。
+- 不把本地检查、模拟宿主或静态工作流证据称为真实平台及远端CI通过。
+
+# Acceptance examples
+
+- A1: 旧基线827文件校验继续通过；核心不导入框架、无导入副作用，
+  从源码及安装包可独立运行，不在运行时引用legacy。
+- A2: 可复现导出202条基线作物；ID及必要数值对应源静态数据库；
+  加载校验格式/schema，坏数据明确拒绝。运行时ID唯一，同名拒绝歧义。
+- A3: 新注册得到500农场币、0点券、0经验、6空地；重复注册不增发，
+  不同作用域隔离；旧初始3块账号仅补3块，并发/重试/重启不重复补偿。
+- A4: 购买、播种扣款/入库/耗种正确；0、负数、bool、超大数量、余额、
+  库存或等级不足及未知作物明确失败，没有部分写入。
+- A5: 未成熟不能收获，成熟只增加本次产量/经验；收获前100、本次20
+  后为120，播种经验另算。逐地加成顺序无关，多季/枯萎/铲除及成熟
+  边界遵守保存定义及可注入时钟。
+- A6: 余额100、出售收益20后为120；锁定限制指定和全部出售；
+  返回真实余额及安全文本，不出现模板参数缺失。
+- A7: 故障注入使资产/地块/流水/结果整体回滚；重试返回原结果，
+  参数冲突拒绝；并发不透支/重复领奖，故障不伪装成功，重启后可读。
+- A8: 离线测试、运行入口与说明可执行；文档区分源码、模拟、离线
+  产物与真实宿主/远程验证，准确记录当前实现与待办。
+- A9: 图片工具支持透明合成、缩放、裁剪、测量/省略及三格式编码；
+  渲染不联网或导入框架，核心无Pillow依赖；安装后提供匹配外部资源可绘图。
+- A10: 一次快照与统一时间绘制空地、生长、成熟、再生长、枯萎及
+  锁定状态，采用当前地块映射及统一定位，普通/高清输出可解码。
+- A11: 小图从目标尺寸绘制，素材与成图缓存有界且不污染共享图片；
+  阶段/成熟边界、余额、头像及身份变化不会复用过期图。
+- A12: 后台合成编码限制并发、相同请求合并；取消不提前释放名额，
+  关闭等待任务排空；日志仅记录耗时、尺寸、缓存等安全信息。
+- A13: 离线样例和真实测量覆盖尺寸/编码、冷暖缓存及调用方式；
+  图片可解码，明确本机测量不等同真实平台上传性能。
+- A14: 真寻原指令、路由、身份/幂等、异常反馈与启动关闭通过模拟验证；
+  字体显式路径优先、默认校验下载，资源失败文字可用，不操作真实宿主。
+- A15: 白名单真寻插件包包含私有共享模块、轻量数据、许可和来源哈希，
+  不含其他适配、legacy、测试、玩家数据或大型资源ZIP；准确标识脏源码，
+  相同输入可复现，构建不改源码。
+- A16: 离线验证内容、导入与路由；安装拒绝穿越、坏哈希和已有目标，
+  失败无半成品，不操作旧插件/玩家数据或启动真实机器人。
+- A17: 工作流检查、构建、上传；push main或显式publish输入可触发固定
+  真寻仓库main普通同步，PR不发布；脚本默认dry-run、不force，冲突失败，
+  凭据不落盘。本次只检查与模拟，不执行真实发布。
+- A18: 本机离线打包与安全边界检查通过；静态核对Windows/Linux与
+  Pillow10.4/12.3矩阵，明确本机环境及未运行矩阵；提供安装、依赖、
+  字体、数据库、回退/卸载与Secrets说明，不宣称真实平台已验证。
+- A19: 图片质量默认75，整数1和95有效，0、96、bool及非整数拒绝；
+  配置覆盖图片编码并区分缓存。仅我的农场允许高清，质量不低于85与
+  配置值，其他查询拒绝高清，分页/文字可用，帮助和配置说明一致。
+
+# Constraints and invariants
+
+沿用当前main目录，不创建或合并分支，不改业务代码。保留许可与来源，
+不记录令牌、凭据或真实玩家信息。正式状态和报告由Comet维护，不伪造
+验收证据。本轮检查绑定当前候选与文档，旧报告不能代替本轮验收。
+
+# Decisions
+
+- 用户已确认按当前已实现并记录的规则同步旧规格、补齐验收后归档，
+  并再次要求“我已确认，请归档”；授权本地文档、验收与归档收尾。
+- 原记录中的3块地、仅手动farm-preview分支发布、包内大素材及旧
+  offset定位已被后续实现替代。本规格记录当前行为，不恢复旧规则。

docs/comet/archive/2026-10-26-farm-core-foundation/comet-state.yaml

@@ -0,0 +1,617 @@
+schema: comet.native.v4
+name: farm-core-foundation
+language: en
+phase: archive
+status: done
+state_version: 50
+brief: brief.md
+document_constraints_version: 3
+shape_confirmation_hash: 0c329cbbb25fef680c0862751441fb78bb7bd4d7a8a2f698edf5a20d17ab828e
+spec_changes:
+  - capability: farm-core
+    operation: create
+    source: specs/farm-core/spec.md
+  - capability: farm-render
+    operation: create
+    source: specs/farm-render/spec.md
+  - capability: zhenxun-preview
+    operation: create
+    source: specs/zhenxun-preview/spec.md
+workspace:
+  isolation: current
+  change_branch: main
+  target_branch: main
+  finish: null
+loop:
+  stage: done
+  goal_cycle: 7
+  iteration: 2
+  attempt: 1
+  retry_epoch: 0
+  failed_iteration_count: 1
+  no_progress_count: 0
+  execution_failure_count: 0
+  previous_unresolved_ids: []
+  next_action: null
+acceptance:
+  - id: A1
+    source: brief.md
+    text: "A1: 旧基线827文件校验继续通过；核心不导入框架、无导入副作用， 从源码及安装包可独立运行，不在运行时引用legacy。"
+    result: passed
+    reason:
+      text: 当前Runtime
+        foundation-offline核实827旧基线与源码/安装包隔离测试通过；test_packaging.py校验无宿主导入、无导入副作用及临时wheel独立运行。
+      truncated: false
+  - id: A2
+    source: brief.md
+    text: "A2: 可复现导出202条基线作物；ID及必要数值对应源静态数据库； 加载校验格式/schema，坏数据明确拒绝。运行时ID唯一，同名拒绝歧义。"
+    result: passed
+    reason:
+      text: export_catalogue.py只读静态库并排序确定性导出；Runtime导出比对、202条目录及坏schema/重复ID/同名歧义测试通过，catalogue.py显式拒绝无效输入。
+      truncated: false
+  - id: A3
+    source: brief.md
+    text: "A3: 新注册得到500农场币、0点券、0经验、6空地；重复注册不增发， 不同作用域隔离；旧初始3块账号仅补3块，并发/重试/重启不重复补偿。"
+    result: passed
+    reason:
+      text: repository.py:33注册500币和6空地；application.py:61从注册来源识别旧初始3块并以固定幂等事务补3块；正式注册/隔离/并发/故障/重启补地测试通过。
+      truncated: false
+  - id: A4
+    source: brief.md
+    text: "A4: 购买、播种扣款/入库/耗种正确；0、负数、bool、超大数量、余额、 库存或等级不足及未知作物明确失败，没有部分写入。"
+    result: passed
+    reason:
+      text: application.py:177购买与208播种校验目录、数量、余额、库存并在事务内修改；正式非法数量、未知作物、等级/余额不足、耗种与回滚测试通过。
+      truncated: false
+  - id: A5
+    source: brief.md
+    text: "A5: 未成熟不能收获，成熟只增加本次产量/经验；收获前100、本次20 后为120，播种经验另算。逐地加成顺序无关，多季/枯萎/铲除及成熟
+      边界遵守保存定义及可注入时钟。"
+    result: passed
+    reason:
+      text: application.py:251按保存的plot.plant逐地结算本次经验和产量、成熟边界与再生长；test_transactions中冻结定义、逐地加成、历史经验增量、多季和铲除测试通过。
+      truncated: false
+  - id: A6
+    source: brief.md
+    text: "A6: 余额100、出售收益20后为120；锁定限制指定和全部出售； 返回真实余额及安全文本，不出现模板参数缺失。"
+    result: passed
+    reason:
+      text: application.py:437统一保护锁定库存且只加本次收益；正式100余额出售20得120、两种出售入口锁定及安全文本测试通过。
+      truncated: false
+  - id: A7
+    source: brief.md
+    text: "A7: 故障注入使资产/地块/流水/结果整体回滚；重试返回原结果， 参数冲突拒绝；并发不透支/重复领奖，故障不伪装成功，重启后可读。"
+    result: passed
+    reason:
+      text: storage.py:353 BEGIN
+        IMMEDIATE将状态、流水与幂等结果一起提交，异常整体回滚；正式故障注入、参数冲突、取消重放、并发扣款/收获与重启测试通过。
+      truncated: false
+  - id: A8
+    source: brief.md
+    text: "A8: 离线测试、运行入口与说明可执行；文档区分源码、模拟、离线 产物与真实宿主/远程验证，准确记录当前实现与待办。"
+    result: passed
+    reason:
+      text: 新增docs/zhenxun-preview-current.md与实际构建、verify_foundation及安装入口一致；docs索引明确11为历史，09/10和发布README已说明6地、当前字体、内置作物与待办，并区分本机/模拟/真实验证。
+      truncated: false
+  - id: A9
+    source: brief.md
+    text: "A9: 图片工具支持透明合成、缩放、裁剪、测量/省略及三格式编码； 渲染不联网或导入框架，核心无Pillow依赖；安装后提供匹配外部资源可绘图。"
+    result: passed
+    reason:
+      text: canvas.py支持透明、缩裁、测量省略及三编码；assets/renderer不导入框架或联网，准备资源在接入层；正式Canvas及临时wheel绘图测试通过。
+      truncated: false
+  - id: A10
+    source: brief.md
+    text: "A10: 一次快照与统一时间绘制空地、生长、成熟、再生长、枯萎及 锁定状态，采用当前地块映射及统一定位，普通/高清输出可解码。"
+    result: passed
+    reason:
+      text: layout.py纯消费快照和now构造空/生长/成熟/再生长/枯萎状态，renderer使用当前映射；正式阶段、目标尺寸、作物统一落点回归通过，render-decode验证6幅普通/高清图片。
+      truncated: false
+  - id: A11
+    source: brief.md
+    text: "A11: 小图从目标尺寸绘制，素材与成图缓存有界且不污染共享图片； 阶段/成熟边界、余额、头像及身份变化不会复用过期图。"
+    result: passed
+    reason:
+      text: assets.py有界ByteLRU并返回图片副本；renderer请求键含场景、身份摘要、配置、格式和头像摘要；正式预算/共享图片安全/阶段成熟边界及余额头像身份失效测试通过。
+      truncated: false
+  - id: A12
+    source: brief.md
+    text: "A12: 后台合成编码限制并发、相同请求合并；取消不提前释放名额， 关闭等待任务排空；日志仅记录耗时、尺寸、缓存等安全信息。"
+    result: passed
+    reason:
+      text: service.py一次snapshot、to_thread、Semaphore及shield共享任务，关闭排空；正式事件循环不阻塞、并发上限、取消保留容量和失败重试测试通过；源码日志未输出身份或快照。
+      truncated: false
+  - id: A13
+    source: brief.md
+    text: "A13: 离线样例和真实测量覆盖尺寸/编码、冷暖缓存及调用方式； 图片可解码，明确本机测量不等同真实平台上传性能。"
+    result: passed
+    reason:
+      text: render_demo.py提供合成样例和冷暖缓存测量；本轮benchmark明确Windows/Python3.12.14/Pillow12.3及非上传范围，绑定Runtime验证1024/1536三格式六文件可解码且暖缓存全命中。
+      truncated: false
+  - id: A14
+    source: brief.md
+    text: "A14: 真寻原指令、路由、身份/幂等、异常反馈与启动关闭通过模拟验证； 字体显式路径优先、默认校验下载，资源失败文字可用，不操作真实宿主。"
+    result: passed
+    reason:
+      text: commands.py注册原指令与启动关闭、身份和稳定消息标识；runtime.py默认校验资源/字体、显式字体优先、失败文字保留；本候选模拟路由/生命周期/异常/幂等正式测试通过。
+      truncated: false
+  - id: A15
+    source: brief.md
+    text: "A15: 白名单真寻插件包包含私有共享模块、轻量数据、许可和来源哈希，
+      不含其他适配、legacy、测试、玩家数据或大型资源ZIP；准确标识脏源码， 相同输入可复现，构建不改源码。"
+    result: passed
+    reason:
+      text: build_zhenxun.py白名单生成私有_vendor、轻量数据许可与来源哈希，排除assets.zip并固定ZIP时间排序、记录dirty；正式可复现完整包及私有导入测试通过。
+      truncated: false
+  - id: A16
+    source: brief.md
+    text: "A16: 离线验证内容、导入与路由；安装拒绝穿越、坏哈希和已有目标， 失败无半成品，不操作旧插件/玩家数据或启动真实机器人。"
+    result: passed
+    reason:
+      text: verify_zhenxun.py拒绝穿越、重复、链接和哈希差异；install_zhenxun.py先校验、临时写入且拒绝已有目标；正式坏包/安装/目标保留及离线导入路由测试通过。
+      truncated: false
+  - id: A17
+    source: brief.md
+    text: "A17: 工作流检查、构建、上传；push main或显式publish输入可触发固定
+      真寻仓库main普通同步，PR不发布；脚本默认dry-run、不force，冲突失败， 凭据不落盘。本次只检查与模拟，不执行真实发布。"
+    result: passed
+    reason:
+      text: 工作流默认只读且PR无发布路径，main
+        push或明确publish输入经test/build触发固定目标；publish_zhenxun.py默认dry-run、不force、并发冲突失败，正式模拟和workflow-guards通过。
+      truncated: false
+  - id: A18
+    source: brief.md
+    text: "A18: 本机离线打包与安全边界检查通过；静态核对Windows/Linux与
+      Pillow10.4/12.3矩阵，明确本机环境及未运行矩阵；提供安装、依赖、
+      字体、数据库、回退/卸载与Secrets说明，不宣称真实平台已验证。"
+    result: passed
+    reason:
+      text: 当前说明覆盖生成包/requirements、停止旧插件、字体、数据目录、日志、备份回退卸载和Secret；与源码及Windows/Linux/Pillow10.4/12.3矩阵一致，明确1项跳过和未运行矩阵、真实宿主/远端边界；离线包安全测试通过。
+      truncated: false
+  - id: A19
+    source: brief.md
+    text: "A19: 图片质量默认75，整数1和95有效，0、96、bool及非整数拒绝； 配置覆盖图片编码并区分缓存。仅我的农场允许高清，质量不低于85与
+      配置值，其他查询拒绝高清，分页/文字可用，帮助和配置说明一致。"
+    result: passed
+    reason:
+      text: RenderOptions严格整数1至95、默认75；Runtime请求读取质量，仅farm高清1536且max(质量,85)，其他查询拒绝高清；正式边界、逐编码器传递、质量缓存与帮助测试通过。
+      truncated: false
+builder_handoff:
+  candidate_id: 2e7d9479-6e65-480f-b4df-85f937519b86
+  identity_provider: skill-coordinated
+  builder_execution_ref: skill-coordinated:builder:0eff5a20-cba2-445f-95de-405dd2ee7c01
+  iteration: 2
+  summary:
+    text: 修复独立验收A8/A18：新增docs/zhenxun-preview-current.md，补齐构建、部署依赖、安装配置、数据日志、备份回退卸载、Secrets及真实验证边界；docs索引明确旧docs/11为历史，更新09/10现行规则与发布README，取消签到/在线作物更新误报。无业务代码变更；重新核对全部19项，保留原17项证据。
+    truncated: false
+  addressed_acceptance_ids:
+    - A1
+    - A2
+    - A3
+    - A4
+    - A5
+    - A6
+    - A7
+    - A8
+    - A9
+    - A10
+    - A11
+    - A12
+    - A13
+    - A14
+    - A15
+    - A16
+    - A17
+    - A18
+    - A19
+  acceptance_review:
+    - id: A1
+      status: implemented-with-evidence
+      evidence:
+        - scripts/check_baseline.py
+        - tests/test_packaging.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A2
+      status: implemented-with-evidence
+      evidence:
+        - scripts/export_catalogue.py
+        - tests/test_domain.py
+        - tests/test_crop_identity.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A3
+      status: implemented-with-evidence
+      evidence:
+        - src/farm_core/repository.py:33
+        - tests/test_transactions.py
+        - tests/test_land.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A4
+      status: implemented-with-evidence
+      evidence:
+        - src/farm_core/application.py:177
+        - tests/test_transactions.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A5
+      status: implemented-with-evidence
+      evidence:
+        - src/farm_core/application.py:251
+        - tests/test_transactions.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A6
+      status: implemented-with-evidence
+      evidence:
+        - src/farm_core/application.py:437
+        - tests/test_transactions.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A7
+      status: implemented-with-evidence
+      evidence:
+        - src/farm_core/storage.py:353
+        - tests/test_transactions.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A8
+      status: implemented-with-evidence
+      evidence:
+        - docs/zhenxun-preview-current.md
+        - docs/README.md
+        - docs/09-foundation.md
+        - docs/10-rendering.md
+        - readme/zhenxun.md
+        - scripts/verify_foundation.py
+      note: 已对照源码修正历史描述，提供完整当前使用说明并清晰区分历史记录和本轮验证；原业务行为未变，供新的独立Verifier复核。
+    - id: A9
+      status: implemented-with-evidence
+      evidence:
+        - src/farm_render/canvas.py
+        - src/farm_render/assets.py
+        - tests/test_packaging.py
+        - tests/test_render.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A10
+      status: implemented-with-evidence
+      evidence:
+        - src/farm_render/renderer.py
+        - tests/test_crop_positions.py
+        - tests/test_render.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A11
+      status: implemented-with-evidence
+      evidence:
+        - src/farm_render/assets.py
+        - tests/test_render.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A12
+      status: implemented-with-evidence
+      evidence:
+        - src/farm_render/service.py
+        - tests/test_render.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A13
+      status: implemented-with-evidence
+      evidence:
+        - runtime/archive-foundation-20261026/benchmark.json
+        - scripts/render_demo.py
+        - docs/10-rendering.md
+      note: 本轮Windows/Python3.12.14/Pillow12.3实测六种输出，1024/1536三格式冷暖缓存均生成；正式Verifier复核解码与报告。
+    - id: A14
+      status: implemented-with-evidence
+      evidence:
+        - integrations/shared/runtime.py
+        - tests/test_zhenxun_runtime.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A15
+      status: implemented-with-evidence
+      evidence:
+        - scripts/build_zhenxun.py
+        - tests/test_zhenxun_package.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A16
+      status: implemented-with-evidence
+      evidence:
+        - scripts/verify_zhenxun.py
+        - scripts/install_zhenxun.py
+        - tests/test_zhenxun_package.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A17
+      status: implemented-with-evidence
+      evidence:
+        - .github/workflows/zhenxun-preview.yml
+        - scripts/publish_zhenxun.py
+        - tests/test_zhenxun_package.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+    - id: A18
+      status: implemented-with-evidence
+      evidence:
+        - docs/zhenxun-preview-current.md
+        - docs/README.md
+        - docs/09-foundation.md
+        - docs/10-rendering.md
+        - readme/zhenxun.md
+        - .github/workflows/zhenxun-preview.yml
+        - tests/test_zhenxun_package.py
+      note: 已对照源码修正历史描述，提供完整当前使用说明并清晰区分历史记录和本轮验证；原业务行为未变，供新的独立Verifier复核。
+    - id: A19
+      status: implemented-with-evidence
+      evidence:
+        - src/farm_render/models.py
+        - integrations/shared/runtime.py
+        - tests/test_zhenxun_runtime.py
+      note: 已逐项核对当前源码与对应测试覆盖；此声明不是测试通过，正式结果由Runtime与独立Verifier给出。
+  checks:
+    - name:
+        text: documentation-diff
+        truncated: false
+      result: passed
+      note:
+        text: git diff --check退出0；更新内容仅文档/正式规格/发布目标记录。
+        truncated: false
+  checks_truncated: false
+  known_limits:
+    - text: 仅本地Windows/Python3.12.14/Pillow12.3；其他CI矩阵未执行。
+      truncated: false
+    - text: 未访问真实玩家库、未启动宿主、未推送或部署。
+      truncated: false
+    - text: 历史455个作物阶段缺图引用保留占位行为。
+      truncated: false
+    - text: 作物Service迁移尚未实施，另仓库设计不纳入归档。
+      truncated: false
+  known_limits_truncated: false
+  review: null
+  submitted_at: 2026-10-26T04:35:00.062Z
+blockers: []
+verification:
+  candidate_id: 2e7d9479-6e65-480f-b4df-85f937519b86
+  identity_provider: skill-coordinated
+  verifier_execution_ref: skill-coordinated:verifier:dbb1408c-96f4-4483-8af0-3b2fbe54af09
+  iteration: 2
+  attempt: 1
+  assurance: skill-coordinated
+  verdict: pass
+  checks:
+    - id: foundation-offline
+      name:
+        text: 完整离线核心/绘图/三端打包回归
+        truncated: false
+      argv_display:
+        - text: -NoProfile
+          truncated: false
+        - text: -Command
+          truncated: false
+        - text: $env:FARM_TEST_FONT='D:\Work\farm_service\fonts\Xiaolai-Regular.ttf';
+            $env:PYTHONIOENCODING='utf-8'; &
+            'D:\Work\farm\.release-cache\ci-aiohttp-20261023\Scripts\python.exe'
+            scripts/verify_foundation.py; exit $LASTEXITCODE
+          truncated: false
+      argv_truncated: false
+      cwd_ref: .
+      status: passed
+      exit_code: 0
+      duration_ms: 107377
+    - id: workflow-guards
+      name:
+        text: 工作流权限与发布边界静态检查
+        truncated: false
+      argv_display:
+        - text: scripts/check_workflows.py
+          truncated: false
+      argv_truncated: false
+      cwd_ref: .
+      status: passed
+      exit_code: 0
+      duration_ms: 110
+    - id: render-decode
+      name:
+        text: 本轮六种绘图样例与暖缓存验证
+        truncated: false
+      argv_display:
+        - text: -c
+          truncated: false
+        - text: import json; from pathlib import Path; from PIL import Image;
+            p=Path('runtime/archive-foundation-20261026');
+            d=json.loads((p/'benchmark.json').read_text(encoding='utf-8'));
+            assert len(d['measurements'])==6; assert all(r['warm_cache_hit'] for
+            r in d['measurements']); files=list(p.glob('farm-*')); assert
+            len(files)==6; [Image.open(f).verify() for f in files]; print('6
+            rendered files verified; all warm cache hits')
+          truncated: false
+      argv_truncated: false
+      cwd_ref: .
+      status: passed
+      exit_code: 0
+      duration_ms: 122
+  summary:
+    text: 新的独立只读Verifier完整核对brief四核心结构、三Spec与A1-A19，直接源码补齐过期图覆盖，并核查本candidate绑定Runtime三检查均exit0；复用219项离线记录（218通过、1项明确跳过）、工作流守卫和六图解码/暖缓存证据。A8/A18现行文档已与实现对齐，其余17项逐项核查通过；最后参考Builder交接，未重跑完整套件、修改业务/测试/文档/报告或操作玩家数据，未代用户接受或归档。
+    truncated: false
+  risks:
+    - text: 正式完整测试共219项，218通过；1项NoneBot宿主配置测试因本地缺Pydantic跳过，不计作通过。该项不属于本change真寻宿主配置验收。
+      truncated: false
+    - text: 仅本机Windows/Python3.12.14/Pillow12.3；工作流矩阵仅静态核对，Linux及Pillow10.4未在本轮运行。
+      truncated: false
+    - text: 未启动真实机器人、访问真实玩家库、验证公开下载、执行远端CI、发布或部署；历史455个缺图引用仍使用明确占位。
+      truncated: false
+    - text: 图索引为2026-10-15，相关路径过期或无覆盖；本轮以直接源码和正式日志补齐，未据旧图推断缺失。
+      truncated: false
+    - text: 作物Service迁移不属于本次归档范围且尚未实施。
+      truncated: false
+  risks_truncated: false
+  completed_at: 2026-10-26T04:40:15.168Z
+history:
+  - goal_cycle: 1
+    iteration: 1
+    attempt: 1
+    outcome: pass
+    unresolved_ids: []
+    summary:
+      text: 独立只读验收完成：完整brief/Spec、实现、测试、配置和文档均已核对，最后参考Builder交接；绑定候选的Runtime
+        foundation-offline以退出码0完成，827基线文件、可复现目录导出与32项测试通过。A1-A8全部通过；未追加或自行重跑完整检查，未修改项目源文件。
+      truncated: false
+    completed_at: 2026-10-15T07:00:29.324Z
+  - goal_cycle: 1
+    iteration: 1
+    attempt: 1
+    outcome: recovery
+    unresolved_ids: []
+    summary:
+      text: 用户明确要求在已确认的图片工具及绘图优化方案上执行开发；将共享农场渲染作为当前基础开发的范围补充，保留原业务验收项并追加图片验收。
+      truncated: false
+    completed_at: 2026-10-15T07:55:29.688Z
+  - goal_cycle: 2
+    iteration: 0
+    attempt: 0
+    outcome: recovery
+    unresolved_ids: []
+    summary:
+      text: Native confirmed acceptance criteria changed
+      truncated: false
+    completed_at: 2026-10-15T08:23:15.134Z
+  - goal_cycle: 3
+    iteration: 1
+    attempt: 1
+    outcome: pass
+    unresolved_ids: []
+    summary:
+      text: 独立只读核对全部13项、完整规格、核心与渲染源码、测试/打包/导出脚本、正式Runtime日志和图片样例；复用匹配候选的45项正式检查，全部验收通过。图索引新增渲染未覆盖且旧文件metadata_changed，已直接源文件补齐，无需重复完整套件。
+      truncated: false
+    completed_at: 2026-10-15T08:40:00.608Z
+  - goal_cycle: 3
+    iteration: 1
+    attempt: 1
+    outcome: recovery
+    unresolved_ids: []
+    summary:
+      text: 用户选择补齐真寻测试版：命令接入、打包工作流和安装脚本；将现有核心与渲染扩展为可安装真寻预览包，保留独立测试库和旧基线，不执行远端操作。
+      truncated: false
+    completed_at: 2026-10-15T09:24:24.236Z
+  - goal_cycle: 4
+    iteration: 0
+    attempt: 0
+    outcome: recovery
+    unresolved_ids: []
+    summary:
+      text: Native confirmed acceptance criteria changed
+      truncated: false
+    completed_at: 2026-10-15T09:28:23.268Z
+  - goal_cycle: 5
+    iteration: 1
+    attempt: 1
+    outcome: pass
+    unresolved_ids: []
+    summary:
+      text: 独立只读核对完整brief、三份规格及18项验收，审阅核心/渲染、真寻接入、白名单构建/校验/安装/固定发布边界、工作流和测试文档。复用本候选正式Runtime的55项全回归、Pillow10.4下23项兼容检查及工作流守卫，全部通过；未重复完整套件。图索引旧/新增缺覆盖，已直接源码补齐。未修改实现或正式规格，未访问远端、安装/启动机器人或代用户接受。
+      truncated: false
+    completed_at: 2026-10-15T09:51:26.860Z
+  - goal_cycle: 5
+    iteration: 1
+    attempt: 1
+    outcome: recovery
+    unresolved_ids: []
+    summary:
+      text: 独立验收指出余额不足错误码映射缺少insufficient_funds；保持已确认范围，补中文提示及回归测试后重新交付。
+      truncated: false
+    completed_at: 2026-10-15T09:52:02.989Z
+  - goal_cycle: 5
+    iteration: 2
+    attempt: 1
+    outcome: pass
+    unresolved_ids: []
+    summary:
+      text: 独立只读核对完整brief、三份规格和18项，审阅核心/渲染/真寻接入、白名单构建/校验/安装/固定发布边界、测试工作流与文档。当前candidate绑定Runtime的56项完整回归、Pillow10.4下24项及工作流守卫均退出码0；日志前缀658580e0与当前cedb操作绑定已核实。额外只读确认最终ZIP30文件且runtime匹配修复源码，余额不足中文提示与无扣款回归通过。图索引过期/缺覆盖已直接源码补齐，未重复完整套件、修改实现或正式文件、远端操作、安装启动宿主或代用户接受。
+      truncated: false
+    completed_at: 2026-10-15T09:58:23.989Z
+  - goal_cycle: 5
+    iteration: 2
+    attempt: 1
+    outcome: recovery
+    unresolved_ids: []
+    summary:
+      text: 用户实际测试要求默认字体：在真寻适配层默认复用宿主字体目录，保留显式字体覆盖和缺失时清楚提示；修复预览版默认不可绘图的接入遗漏。
+      truncated: false
+    completed_at: 2026-10-16T02:06:48.036Z
+  - goal_cycle: 5
+    iteration: 3
+    attempt: 1
+    outcome: pass
+    unresolved_ids: []
+    summary:
+      text: 独立只读验收全部A1-A18：完整brief/三spec与当前字体实现、测试、文档已核对；复用此前未改变核心/渲染/发布的正式独立验收，并核实本候选绑定Runtime三检查exit0，实际58项完整与Pillow10.4下26项通过。真寻FONT_PATH为resources/font，接入层默认选宿主字体，坏默认跳过、显式覆盖优先，共享层未引入真寻路径；安装目录runtime/commands与主源SHA256一致。图索引不覆盖新文件或metadata_changed，已读源码补齐；未重跑完整测试、未修改项目文件、未启动宿主或访问远端。
+      truncated: false
+    completed_at: 2026-10-16T02:13:06.574Z
+  - goal_cycle: 5
+    iteration: 3
+    attempt: 1
+    outcome: recovery
+    unresolved_ids: []
+    summary:
+      text: 用户要求修复迁移遗漏：恢复旧版用户面板素材、布局与经验进度语义并保留性能优化。
+      truncated: false
+    completed_at: 2026-10-16T02:17:50.690Z
+  - goal_cycle: 5
+    iteration: 4
+    attempt: 0
+    outcome: recovery
+    unresolved_ids: []
+    summary:
+      text: "Builder handoff Runtime checks failed: all-offline"
+      truncated: false
+    completed_at: 2026-10-16T02:26:17.238Z
+  - goal_cycle: 5
+    iteration: 5
+    attempt: 1
+    outcome: pass
+    unresolved_ids: []
+    summary:
+      text: 独立只读核对全部A1-A18、完整brief/三份Spec、相关实现与测试及本候选Runtime绑定。复用60项完整检查、Pillow10.4下28项及工作流守卫，均退出码0；未重跑完整套件。原面板底图/头像框/头像尺寸和信息已恢复，用户授权的槽位坐标校正经源码与1536样图核验；preview.3最终ZIP30文件与当前安装目录逐文件相同，renderer匹配源码。未修改实现/正式规格、操作远端、真实玩家库或启动宿主。
+      truncated: false
+    completed_at: 2026-10-16T02:31:02.032Z
+  - goal_cycle: 5
+    iteration: 5
+    attempt: 1
+    outcome: recovery
+    unresolved_ids: []
+    summary:
+      text: 用户明确要求执行统一图片质量配置，默认75、范围1至95，仅我的农场允许高清覆盖；其他图片禁止高清，保留仓库文字和分页。修订用户可见要求。
+      truncated: false
+    completed_at: 2026-10-22T09:37:42.325Z
+  - goal_cycle: 6
+    iteration: 1
+    attempt: 0
+    outcome: recovery
+    unresolved_ids: []
+    summary:
+      text: "Native formal documents are invalid (brief-structure-missing: brief.md)"
+      truncated: false
+    completed_at: 2026-10-26T04:22:42.893Z
+  - goal_cycle: 7
+    iteration: 1
+    attempt: 1
+    outcome: fail
+    unresolved_ids:
+      - A8
+      - A18
+    summary:
+      text: 新的独立只读Verifier核对完整brief、三Spec及全部19项；brief四核心结构有效。复用当前candidate绑定Runtime三项退出0检查，未重跑完整套件。17通过，A8和A18因现行文档陈旧/缺失失败，修复说明后再验收；无需据此修改业务。独立核验完成后最后参考Builder交接，其文档证据不足。未修改业务、测试、规格、报告或玩家数据，未接受结果或归档。
+      truncated: false
+    completed_at: 2026-10-26T04:31:34.844Z
+  - goal_cycle: 7
+    iteration: 2
+    attempt: 1
+    outcome: pass
+    unresolved_ids: []
+    summary:
+      text: 新的独立只读Verifier完整核对brief四核心结构、三Spec与A1-A19，直接源码补齐过期图覆盖，并核查本candidate绑定Runtime三检查均exit0；复用219项离线记录（218通过、1项明确跳过）、工作流守卫和六图解码/暖缓存证据。A8/A18现行文档已与实现对齐，其余17项逐项核查通过；最后参考Builder交接，未重跑完整套件、修改业务/测试/文档/报告或操作玩家数据，未代用户接受或归档。
+      truncated: false
+    completed_at: 2026-10-26T04:40:15.168Z
+history_overflow:
+  dropped_entries: 0
+  first_dropped_at: null
+  last_dropped_at: null
+  outcome_counts:
+    pass: 0
+    fail: 0
+    blocked: 0
+    execution-error: 0
+    recovery: 0
+verification_result: pass
+verification_report: verification.md
+archived: true
+created_at: 2026-10-15T06:34:33.214Z

docs/comet/archive/2026-10-26-farm-core-foundation/specs/farm-core/spec.md

@@ -18,7 +18,8 @@ Acceptance: A1
 
 ## Catalogue
 
-源静态目录 202 条作物名称唯一；映射 id/name/level/buy/isVip/vipBuy/
+迁移基线含202条作物且当时名称唯一；运行时以稳定本地ID为身份，
+允许同名，名称查询拒绝歧义，支持#编号。映射id/name/level/buy/isVip/vipBuy/
 experience/harvest/price/time/crop/phase 等必要数据，规范整数数值，
 异常的字段或版本错误明确拒绝。购买使用对应币种，按等级校验。
 不下载远程目录，不将素材路径或绘图偏移当作业务依赖。
@@ -31,8 +32,10 @@ Acceptance: A2
 ## Registration and account model
 
 调用方提供 deployment/realm/platform/user 字符串身份，核心不推断账号
-等价性或跨群共享。首次注册赠送500 point、0 vipPoint、0 exp、3空地。
+等价性或跨群共享。首次注册赠送500 point、0 vipPoint、0 exp、6空地。
 唯一身份只能领取一次初始资产。查询总是基于已提交数据库状态。
+可靠识别为初始3块的旧用户一次性追加3块普通空地，保留已开垦成果；
+并发、重试和重启不得重复补偿，来源不明和数量异常明确拒绝。
 经验等级门槛为 200*k*(k+1)//2，使用整数边界计算。
 货币、数量和时间范围必须适合 SQLite 整数及应用限制。
 bool 不作为合法整数参数，不允许负数归零后当作交易成功。
@@ -57,7 +60,9 @@ Acceptance: A4
 
 首熟为播种时间加 time*3600；使用可注入时钟，当前时间等于成熟时可收。
 每块地独立计算 floor(base*(100+bonus)/100) 后相加，不对累计值加成。
-经验只增加本次增量。产物入库、经验变动、收获次数和下一季状态
+经验只增加本次增量。播种每地另加2经验、铲除每地另加2经验；
+“历史100”指收获操作前已提交的经验。
+产物入库、经验变动、收获次数和下一季状态
 在同一事务提交。最后一季后枯萎；铲除只清理枯萎地块。
 再次重试不重复收获。展示结果不再次修改数据。
 

docs/comet/archive/2026-10-26-farm-core-foundation/specs/farm-render/spec.md

@@ -5,15 +5,19 @@
 farm_render 使用 Pillow 实现同步画布操作；farm_core 不依赖 Pillow。
 工具支持透明合成、复制、缩放、裁剪、文本测量与超长省略，以及
 WebP/JPEG/PNG 编码。JPEG 合并透明背景，输出携带 MIME、尺寸与字节。
-WebP 默认采用有损质量75、method=2；高清质量85。格式与尺寸独立，
+WebP 默认采用有损质量75、method=2；高清质量为max(配置质量,85)。格式与尺寸独立，
 auto 根据调用方声明的平台能力选择 WebP 或 JPEG，本机无 WebP 编码
 支持时 auto 回退 JPEG，显式 WebP 则清楚报错。PNG 保留无损选项。
-素材独立打入安装包，不在运行时引用 legacy 或宿主；字体显式配置，
-不复制 Windows 商业字体。无字体时明确报错，不输出缺字占位图。
+开发素材独立生成，不在运行时引用 legacy 或宿主。插件携带轻量元数据
+及绑定摘要的素材清单，大型 assets.zip 从所选源校验下载并缓存，
+不打入插件发布包；小型升级土地素材仍随包提供。中文字体支持显式
+配置，或独立校验下载原版小赖字体及完整 OFL 许可，不复制 Windows
+商业字体。无可用素材或字体时接入层降级文字，不输出缺字占位图。
 
 Scenario: Framework-independent packaged renderer
 Acceptance: A9
-从 wheel 安装到临时目录，无 legacy 和框架仍能加载素材并生成图片。
+从 wheel 安装到临时目录，无 legacy 和框架，显式提供已校验的外部
+素材及字体后仍可生成图片；下载与校验止于接入/资源准备层。
 
 ## Snapshot and layout
 
@@ -22,7 +26,10 @@ Acceptance: A9
 首季阶段锚点由保存的 mature_at-growth_seconds 推导，再季使用
 mature_at-regrowth_seconds，按本季时长映射展示阶段，成熟优先、
 枯萎优先于成熟。阶段仅影响外观，不修改交易规则和数据库。
-读取实际 offsetX/Y/W/H 字段；缺失作物资源使用显式占位并记录警告。
+作物定位采用 schema=4 的 visible_contact_center 统一公式，按本地
+土地中心落点，保留完整纹理和直立等比缩放，不使用旧 offset 字段
+或逐阶段手调锚点。地块位置按当前稳定编号映射。缺失作物资源使用
+显式占位并记录警告。
 用户信息显示真实快照余额、点券和经验，头像仅接收字节，无头像时
 绘制默认图；拒绝超大或无效头像并降级。主题由调用方明确提供。
 

docs/comet/archive/2026-10-26-farm-core-foundation/specs/zhenxun-preview/spec.md

@@ -16,7 +16,8 @@ Acceptance: A19
 不共享成图。农场高清为1536宽，质量至少85且不低于配置；其他命令高清
 返回明确参数错误，仓库分页和文字仍可用，帮助不再宣称其他命令支持高清。
 
-仅提供真寻接入；业务和图片仍来自主仓库共享源码。接入层加载插件
+本 capability 验收真寻接入；NoneBot/AstrBot 已有独立接入与打包，
+不将其当前存在误报为未实现。业务和图片仍来自主仓库共享源码。接入层加载插件
 私有_vendor命名空间，渲染层对farm_core的引用在构建时改为私有相对
 导入，不修改开发源码、不污染全局sys.path或sys.modules别名。
 命令不增加测试前缀，沿用开通农场、我的农场、农场帮助、我的种子、
@@ -27,8 +28,10 @@ Acceptance: A19
 绑定；测试数据位置与旧版不同。事件标识包含机器人、平台、用户及
 原消息标识；无法获得稳定消息标识时写操作明确拒绝，不能随机重试。
 在启动时初始化存储、渲染器，在关闭时等待任务排空后关闭存储；字体
-必须配置为部署方拥有使用权的中文字体。无字体时文本功能仍可用，
-我的农场返回明确配置提示。头像失败降级，不让头像下载无限等待。
+支持显式配置合法中文字体，或校验下载原版小赖字体及完整许可。
+资源源可选 Github、Gitea、farm_service，默认 Github；服务地址独立
+保留。缺少资源或字体时保留文字功能，日志明确原因。头像失败降级，
+不让头像下载无限等待。本次不包含作物目录远程更新。
 
 Scenario: 真寻命令与生命周期
 Acceptance: A14
@@ -38,7 +41,8 @@ Acceptance: A14
 ## 产物
 
 scripts/build_zhenxun.py按白名单复制真寻接入、farm_core、farm_render、
-对应数据/图片、LICENSE及NOTICE。ZIP含单一插件根目录，仓库导出目录
+对应轻量数据、升级土地素材、LICENSE及NOTICE；大型图片及字体 ZIP
+不进入插件包。ZIP含单一插件根目录，仓库导出目录
 可作为真寻发布仓库根。生成来源manifest与独立SHA256附件，清单不
 自包含哈希；本地工作区脏时标识dirty，不能冒充源HEAD的纯净构建。
 输入版本严格校验，ZIP排序/时间固定，目标存在则拒绝或显式选择新路径。
@@ -64,10 +68,11 @@ Acceptance: A16
 
 主仓库CI在PR/push及手动触发时执行检查，构建ZIP/清单/校验附件并上传
 Actions artifact。工作流权限默认只读；不可信PR不触发跨仓库写入。
-跨仓库同步是独立的手动选择，使用专用Secret/受保护environment，并
-固定目标Shu-Ying/zhenxun_plugin_farm的farm-preview分支。
-脚本默认dry-run；只有显式发布才联网。只创建或普通更新预览分支，
-不force、不碰main/旧标签；并发分支改变时失败。发布仓库只含生成的
+跨仓库同步依当前工作流，在 main 的 push 或显式 publish 手动输入时
+执行，PR 不触发；使用专用 Secret/受保护 environment，固定目标为
+Shu-Ying/zhenxun_plugin_farm 的 main 分支。脚本默认 dry-run，只有显式
+发布才联网；只进行普通更新，不 force、不修改旧标签；并发分支改变
+时失败。此次本地归档不执行发布。发布仓库只含生成的
 可安装内容、来源和验证工具，以及验证工作流，不在那里维护业务源码。
 下载ZIP测试不要求先同步仓库，不要求用户先给令牌。
 

docs/comet/archive/2026-10-26-farm-core-foundation/verification.md

@@ -0,0 +1,98 @@
+---
+generated_from_state_version: 50
+---
+
+# Verification
+
+## Current result
+
+- Result: **Archived**
+- Verification status: **Checks completed; result confirmed**
+- Goal cycle: 7
+- Iteration: 2
+- Verifier attempt: 1
+- Completed: 2026-10-26T04:40:15.168Z
+- Summary: 新的独立只读Verifier完整核对brief四核心结构、三Spec与A1-A19，直接源码补齐过期图覆盖，并核查本candidate绑定Runtime三检查均exit0；复用219项离线记录（218通过、1项明确跳过）、工作流守卫和六图解码/暖缓存证据。A8/A18现行文档已与实现对齐，其余17项逐项核查通过；最后参考Builder交接，未重跑完整套件、修改业务/测试/文档/报告或操作玩家数据，未代用户接受或归档。
+
+## Acceptance
+
+| ID | Result | Source | Criterion | Reason |
+| --- | --- | --- | --- | --- |
+| A1 | passed | brief.md | A1: 旧基线827文件校验继续通过；核心不导入框架、无导入副作用， 从源码及安装包可独立运行，不在运行时引用legacy。 | 当前Runtime foundation-offline核实827旧基线与源码/安装包隔离测试通过；test_packaging.py校验无宿主导入、无导入副作用及临时wheel独立运行。 |
+| A2 | passed | brief.md | A2: 可复现导出202条基线作物；ID及必要数值对应源静态数据库； 加载校验格式/schema，坏数据明确拒绝。运行时ID唯一，同名拒绝歧义。 | export_catalogue.py只读静态库并排序确定性导出；Runtime导出比对、202条目录及坏schema/重复ID/同名歧义测试通过，catalogue.py显式拒绝无效输入。 |
+| A3 | passed | brief.md | A3: 新注册得到500农场币、0点券、0经验、6空地；重复注册不增发， 不同作用域隔离；旧初始3块账号仅补3块，并发/重试/重启不重复补偿。 | repository.py:33注册500币和6空地；application.py:61从注册来源识别旧初始3块并以固定幂等事务补3块；正式注册/隔离/并发/故障/重启补地测试通过。 |
+| A4 | passed | brief.md | A4: 购买、播种扣款/入库/耗种正确；0、负数、bool、超大数量、余额、 库存或等级不足及未知作物明确失败，没有部分写入。 | application.py:177购买与208播种校验目录、数量、余额、库存并在事务内修改；正式非法数量、未知作物、等级/余额不足、耗种与回滚测试通过。 |
+| A5 | passed | brief.md | A5: 未成熟不能收获，成熟只增加本次产量/经验；收获前100、本次20 后为120，播种经验另算。逐地加成顺序无关，多季/枯萎/铲除及成熟 边界遵守保存定义及可注入时钟。 | application.py:251按保存的plot.plant逐地结算本次经验和产量、成熟边界与再生长；test_transactions中冻结定义、逐地加成、历史经验增量、多季和铲除测试通过。 |
+| A6 | passed | brief.md | A6: 余额100、出售收益20后为120；锁定限制指定和全部出售； 返回真实余额及安全文本，不出现模板参数缺失。 | application.py:437统一保护锁定库存且只加本次收益；正式100余额出售20得120、两种出售入口锁定及安全文本测试通过。 |
+| A7 | passed | brief.md | A7: 故障注入使资产/地块/流水/结果整体回滚；重试返回原结果， 参数冲突拒绝；并发不透支/重复领奖，故障不伪装成功，重启后可读。 | storage.py:353 BEGIN IMMEDIATE将状态、流水与幂等结果一起提交，异常整体回滚；正式故障注入、参数冲突、取消重放、并发扣款/收获与重启测试通过。 |
+| A8 | passed | brief.md | A8: 离线测试、运行入口与说明可执行；文档区分源码、模拟、离线 产物与真实宿主/远程验证，准确记录当前实现与待办。 | 新增docs/zhenxun-preview-current.md与实际构建、verify_foundation及安装入口一致；docs索引明确11为历史，09/10和发布README已说明6地、当前字体、内置作物与待办，并区分本机/模拟/真实验证。 |
+| A9 | passed | brief.md | A9: 图片工具支持透明合成、缩放、裁剪、测量/省略及三格式编码； 渲染不联网或导入框架，核心无Pillow依赖；安装后提供匹配外部资源可绘图。 | canvas.py支持透明、缩裁、测量省略及三编码；assets/renderer不导入框架或联网，准备资源在接入层；正式Canvas及临时wheel绘图测试通过。 |
+| A10 | passed | brief.md | A10: 一次快照与统一时间绘制空地、生长、成熟、再生长、枯萎及 锁定状态，采用当前地块映射及统一定位，普通/高清输出可解码。 | layout.py纯消费快照和now构造空/生长/成熟/再生长/枯萎状态，renderer使用当前映射；正式阶段、目标尺寸、作物统一落点回归通过，render-decode验证6幅普通/高清图片。 |
+| A11 | passed | brief.md | A11: 小图从目标尺寸绘制，素材与成图缓存有界且不污染共享图片； 阶段/成熟边界、余额、头像及身份变化不会复用过期图。 | assets.py有界ByteLRU并返回图片副本；renderer请求键含场景、身份摘要、配置、格式和头像摘要；正式预算/共享图片安全/阶段成熟边界及余额头像身份失效测试通过。 |
+| A12 | passed | brief.md | A12: 后台合成编码限制并发、相同请求合并；取消不提前释放名额， 关闭等待任务排空；日志仅记录耗时、尺寸、缓存等安全信息。 | service.py一次snapshot、to_thread、Semaphore及shield共享任务，关闭排空；正式事件循环不阻塞、并发上限、取消保留容量和失败重试测试通过；源码日志未输出身份或快照。 |
+| A13 | passed | brief.md | A13: 离线样例和真实测量覆盖尺寸/编码、冷暖缓存及调用方式； 图片可解码，明确本机测量不等同真实平台上传性能。 | render_demo.py提供合成样例和冷暖缓存测量；本轮benchmark明确Windows/Python3.12.14/Pillow12.3及非上传范围，绑定Runtime验证1024/1536三格式六文件可解码且暖缓存全命中。 |
+| A14 | passed | brief.md | A14: 真寻原指令、路由、身份/幂等、异常反馈与启动关闭通过模拟验证； 字体显式路径优先、默认校验下载，资源失败文字可用，不操作真实宿主。 | commands.py注册原指令与启动关闭、身份和稳定消息标识；runtime.py默认校验资源/字体、显式字体优先、失败文字保留；本候选模拟路由/生命周期/异常/幂等正式测试通过。 |
+| A15 | passed | brief.md | A15: 白名单真寻插件包包含私有共享模块、轻量数据、许可和来源哈希， 不含其他适配、legacy、测试、玩家数据或大型资源ZIP；准确标识脏源码， 相同输入可复现，构建不改源码。 | build_zhenxun.py白名单生成私有_vendor、轻量数据许可与来源哈希，排除assets.zip并固定ZIP时间排序、记录dirty；正式可复现完整包及私有导入测试通过。 |
+| A16 | passed | brief.md | A16: 离线验证内容、导入与路由；安装拒绝穿越、坏哈希和已有目标， 失败无半成品，不操作旧插件/玩家数据或启动真实机器人。 | verify_zhenxun.py拒绝穿越、重复、链接和哈希差异；install_zhenxun.py先校验、临时写入且拒绝已有目标；正式坏包/安装/目标保留及离线导入路由测试通过。 |
+| A17 | passed | brief.md | A17: 工作流检查、构建、上传；push main或显式publish输入可触发固定 真寻仓库main普通同步，PR不发布；脚本默认dry-run、不force，冲突失败， 凭据不落盘。本次只检查与模拟，不执行真实发布。 | 工作流默认只读且PR无发布路径，main push或明确publish输入经test/build触发固定目标；publish_zhenxun.py默认dry-run、不force、并发冲突失败，正式模拟和workflow-guards通过。 |
+| A18 | passed | brief.md | A18: 本机离线打包与安全边界检查通过；静态核对Windows/Linux与 Pillow10.4/12.3矩阵，明确本机环境及未运行矩阵；提供安装、依赖、 字体、数据库、回退/卸载与Secrets说明，不宣称真实平台已验证。 | 当前说明覆盖生成包/requirements、停止旧插件、字体、数据目录、日志、备份回退卸载和Secret；与源码及Windows/Linux/Pillow10.4/12.3矩阵一致，明确1项跳过和未运行矩阵、真实宿主/远端边界；离线包安全测试通过。 |
+| A19 | passed | brief.md | A19: 图片质量默认75，整数1和95有效，0、96、bool及非整数拒绝； 配置覆盖图片编码并区分缓存。仅我的农场允许高清，质量不低于85与 配置值，其他查询拒绝高清，分页/文字可用，帮助和配置说明一致。 | RenderOptions严格整数1至95、默认75；Runtime请求读取质量，仅farm高清1536且max(质量,85)，其他查询拒绝高清；正式边界、逐编码器传递、质量缓存与帮助测试通过。 |
+
+## Checks
+
+| Check | Command | Working directory | Status | Exit | Duration |
+| --- | --- | --- | --- | ---: | ---: |
+| 完整离线核心/绘图/三端打包回归 | -NoProfile -Command $env:FARM_TEST_FONT='D:\Work\farm_service\fonts\Xiaolai-Regular.ttf'; $env:PYTHONIOENCODING='utf-8'; & 'D:\Work\farm\.release-cache\ci-aiohttp-20261023\Scripts\python.exe' scripts/verify_foundation.py; exit $LASTEXITCODE | . | passed | 0 | 107377 ms |
+| 工作流权限与发布边界静态检查 | scripts/check_workflows.py | . | passed | 0 | 110 ms |
+| 本轮六种绘图样例与暖缓存验证 | -c import json; from pathlib import Path; from PIL import Image; p=Path('runtime/archive-foundation-20261026'); d=json.loads((p/'benchmark.json').read_text(encoding='utf-8')); assert len(d['measurements'])==6; assert all(r['warm_cache_hit'] for r in d['measurements']); files=list(p.glob('farm-*')); assert len(files)==6; [Image.open(f).verify() for f in files]; print('6 rendered files verified; all warm cache hits') | . | passed | 0 | 122 ms |
+
+### Builder-reported evidence
+
+These are Builder reports, not Runtime check receipts or independent verification results.
+
+- documentation-diff: passed — git diff --check退出0；更新内容仅文档/正式规格/发布目标记录。
+- Known limitation: 仅本地Windows/Python3.12.14/Pillow12.3；其他CI矩阵未执行。
+- Known limitation: 未访问真实玩家库、未启动宿主、未推送或部署。
+- Known limitation: 历史455个作物阶段缺图引用保留占位行为。
+- Known limitation: 作物Service迁移尚未实施，另仓库设计不纳入归档。
+
+## Blockers
+
+_None._
+
+## Risks and skipped work
+
+- 正式完整测试共219项，218通过；1项NoneBot宿主配置测试因本地缺Pydantic跳过，不计作通过。该项不属于本change真寻宿主配置验收。
+- 仅本机Windows/Python3.12.14/Pillow12.3；工作流矩阵仅静态核对，Linux及Pillow10.4未在本轮运行。
+- 未启动真实机器人、访问真实玩家库、验证公开下载、执行远端CI、发布或部署；历史455个缺图引用仍使用明确占位。
+- 图索引为2026-10-15，相关路径过期或无覆盖；本轮以直接源码和正式日志补齐，未据旧图推断缺失。
+- 作物Service迁移不属于本次归档范围且尚未实施。
+
+## Previous iterations
+
+| Goal cycle | Iteration | Attempt | Outcome | Unresolved | Summary | Completed |
+| ---: | ---: | ---: | --- | --- | --- | --- |
+| 1 | 1 | 1 | pass | — | 独立只读验收完成：完整brief/Spec、实现、测试、配置和文档均已核对，最后参考Builder交接；绑定候选的Runtime foundation-offline以退出码0完成，827基线文件、可复现目录导出与32项测试通过。A1-A8全部通过；未追加或自行重跑完整检查，未修改项目源文件。 | 2026-10-15T07:00:29.324Z |
+| 1 | 1 | 1 | recovery | — | 用户明确要求在已确认的图片工具及绘图优化方案上执行开发；将共享农场渲染作为当前基础开发的范围补充，保留原业务验收项并追加图片验收。 | 2026-10-15T07:55:29.688Z |
+| 2 | 0 | 0 | recovery | — | Native confirmed acceptance criteria changed | 2026-10-15T08:23:15.134Z |
+| 3 | 1 | 1 | pass | — | 独立只读核对全部13项、完整规格、核心与渲染源码、测试/打包/导出脚本、正式Runtime日志和图片样例；复用匹配候选的45项正式检查，全部验收通过。图索引新增渲染未覆盖且旧文件metadata_changed，已直接源文件补齐，无需重复完整套件。 | 2026-10-15T08:40:00.608Z |
+| 3 | 1 | 1 | recovery | — | 用户选择补齐真寻测试版：命令接入、打包工作流和安装脚本；将现有核心与渲染扩展为可安装真寻预览包，保留独立测试库和旧基线，不执行远端操作。 | 2026-10-15T09:24:24.236Z |
+| 4 | 0 | 0 | recovery | — | Native confirmed acceptance criteria changed | 2026-10-15T09:28:23.268Z |
+| 5 | 1 | 1 | pass | — | 独立只读核对完整brief、三份规格及18项验收，审阅核心/渲染、真寻接入、白名单构建/校验/安装/固定发布边界、工作流和测试文档。复用本候选正式Runtime的55项全回归、Pillow10.4下23项兼容检查及工作流守卫，全部通过；未重复完整套件。图索引旧/新增缺覆盖，已直接源码补齐。未修改实现或正式规格，未访问远端、安装/启动机器人或代用户接受。 | 2026-10-15T09:51:26.860Z |
+| 5 | 1 | 1 | recovery | — | 独立验收指出余额不足错误码映射缺少insufficient_funds；保持已确认范围，补中文提示及回归测试后重新交付。 | 2026-10-15T09:52:02.989Z |
+| 5 | 2 | 1 | pass | — | 独立只读核对完整brief、三份规格和18项，审阅核心/渲染/真寻接入、白名单构建/校验/安装/固定发布边界、测试工作流与文档。当前candidate绑定Runtime的56项完整回归、Pillow10.4下24项及工作流守卫均退出码0；日志前缀658580e0与当前cedb操作绑定已核实。额外只读确认最终ZIP30文件且runtime匹配修复源码，余额不足中文提示与无扣款回归通过。图索引过期/缺覆盖已直接源码补齐，未重复完整套件、修改实现或正式文件、远端操作、安装启动宿主或代用户接受。 | 2026-10-15T09:58:23.989Z |
+| 5 | 2 | 1 | recovery | — | 用户实际测试要求默认字体：在真寻适配层默认复用宿主字体目录，保留显式字体覆盖和缺失时清楚提示；修复预览版默认不可绘图的接入遗漏。 | 2026-10-16T02:06:48.036Z |
+| 5 | 3 | 1 | pass | — | 独立只读验收全部A1-A18：完整brief/三spec与当前字体实现、测试、文档已核对；复用此前未改变核心/渲染/发布的正式独立验收，并核实本候选绑定Runtime三检查exit0，实际58项完整与Pillow10.4下26项通过。真寻FONT_PATH为resources/font，接入层默认选宿主字体，坏默认跳过、显式覆盖优先，共享层未引入真寻路径；安装目录runtime/commands与主源SHA256一致。图索引不覆盖新文件或metadata_changed，已读源码补齐；未重跑完整测试、未修改项目文件、未启动宿主或访问远端。 | 2026-10-16T02:13:06.574Z |
+| 5 | 3 | 1 | recovery | — | 用户要求修复迁移遗漏：恢复旧版用户面板素材、布局与经验进度语义并保留性能优化。 | 2026-10-16T02:17:50.690Z |
+| 5 | 4 | 0 | recovery | — | Builder handoff Runtime checks failed: all-offline | 2026-10-16T02:26:17.238Z |
+| 5 | 5 | 1 | pass | — | 独立只读核对全部A1-A18、完整brief/三份Spec、相关实现与测试及本候选Runtime绑定。复用60项完整检查、Pillow10.4下28项及工作流守卫，均退出码0；未重跑完整套件。原面板底图/头像框/头像尺寸和信息已恢复，用户授权的槽位坐标校正经源码与1536样图核验；preview.3最终ZIP30文件与当前安装目录逐文件相同，renderer匹配源码。未修改实现/正式规格、操作远端、真实玩家库或启动宿主。 | 2026-10-16T02:31:02.032Z |
+| 5 | 5 | 1 | recovery | — | 用户明确要求执行统一图片质量配置，默认75、范围1至95，仅我的农场允许高清覆盖；其他图片禁止高清，保留仓库文字和分页。修订用户可见要求。 | 2026-10-22T09:37:42.325Z |
+| 6 | 1 | 0 | recovery | — | Native formal documents are invalid (brief-structure-missing: brief.md) | 2026-10-26T04:22:42.893Z |
+| 7 | 1 | 1 | fail | A8, A18 | 新的独立只读Verifier核对完整brief、三Spec及全部19项；brief四核心结构有效。复用当前candidate绑定Runtime三项退出0检查，未重跑完整套件。17通过，A8和A18因现行文档陈旧/缺失失败，修复说明后再验收；无需据此修改业务。独立核验完成后最后参考Builder交接，其文档证据不足。未修改业务、测试、规格、报告或玩家数据，未接受结果或归档。 | 2026-10-26T04:31:34.844Z |
+| 7 | 2 | 1 | pass | — | 新的独立只读Verifier完整核对brief四核心结构、三Spec与A1-A19，直接源码补齐过期图覆盖，并核查本candidate绑定Runtime三检查均exit0；复用219项离线记录（218通过、1项明确跳过）、工作流守卫和六图解码/暖缓存证据。A8/A18现行文档已与实现对齐，其余17项逐项核查通过；最后参考Builder交接，未重跑完整套件、修改业务/测试/文档/报告或操作玩家数据，未代用户接受或归档。 | 2026-10-26T04:40:15.168Z |
+
+
+
+## Conclusion
+
+新的独立只读Verifier完整核对brief四核心结构、三Spec与A1-A19，直接源码补齐过期图覆盖，并核查本candidate绑定Runtime三检查均exit0；复用219项离线记录（218通过、1项明确跳过）、工作流守卫和六图解码/暖缓存证据。A8/A18现行文档已与实现对齐，其余17项逐项核查通过；最后参考Builder交接，未重跑完整套件、修改业务/测试/文档/报告或操作玩家数据，未代用户接受或归档。

docs/comet/changes/farm-core-foundation/brief.md

@@ -1,164 +0,0 @@
-# Outcome
-
-在 D:/Work/farm 当前目录完成旧版可用规则的第一批迁移，建立不依赖
-真寻、NoneBot 或 AstrBot 的可运行基础核心；使用 SQLite 验证完整交易
-闭环，为后续框架接入提供稳定调用入口。Comet 初始化已完成，
-AGENTS.md 缺失开始标记已修复。用户已明确选择当前目录继续。
-
-# Scope
-
-- 本次追加统一图片编码质量配置，整数1～95，默认75，覆盖农场、
-  地块编号、详情、商店及种子/作物仓库。仅“我的农场”接受高清，
-  使用1536宽及max(配置质量,85)；其他查询拒绝高清，保留分页与文字。
-  真寻网页配置提供“农场图片质量”，普通NoneBot提供FARM_IMAGE_QUALITY。
-  不发布、不安装、不重启机器人，不改变其他功能。
-- 迁移基线只读。迁出旧作物目录 202 条唯一名称配置，保留必要数值、
-  购买币种、等级、成熟时间、产量、经验和多季次数；新核心运行不依赖
-  legacy 目录，不复制旧框架依赖。共享渲染素材按下述新增范围迁出。
-- 建立明确的玩家作用域标识，由调用方提供部署、领域、消息平台与
-  用户 ID，不自行选择群共享或跨框架账号绑定政策。
-- SQLite 新 schema、显式事务、操作流水和幂等操作记录；只处理新建
-  测试数据库，不导入真实玩家库。余额与库存以数据库为权威。
-- 注册初始 500 农场币、0 点券、0 经验、3 块普通空地，沿用旧值。
-- 提供账户/库存/地块查询、购买种子、播种、收获、铲除枯萎作物、
-  锁定/解锁作物、指定出售/全部出售及基础文本结果。
-- 每级累计经验门槛沿用 200*k*(k+1)/2，以整数计算避免浮点边界。
-  普通币与点券库存独立；本轮不实现两者兑换或外部金币充值。
-- 多季作物首熟时间沿用 time*3600；再生长间隔沿用旧实现去重后
-  phase[1:] 之和。该规则明确保留兼容，数值平衡后续另议。
-- 纯规则支持每块地独立计算产量/经验加成再求和；首轮创建普通地，
-  不提供土地升级、星级自动升级或偷菜加成。
-- 核心应用 API 为异步可调用，SQLite 阻塞操作不在事件循环线程执行；
-  不引入可变玩家余额缓存或导入时后台线程。日志记录事务操作标识、
-  操作类别与提交结果，不记录密钥或真实用户消息。
-- 使用本地可重复测试覆盖规则、原子性、失败传播、重试幂等和并发；
-  更新 README、实现说明与现有路线状态，保留待确认决策。
-- 根据用户对已讨论方案的明确执行指令，追加 farm_render：Pillow 同步
-  图片工具、离线素材包、有界缓存、按目标尺寸绘制、后台受控执行、
-  普通/高清预览、WebP/JPEG/PNG 编码和分阶段日志。
-- 渲染接收一次核心快照和统一时间，不逐地块查库、不联网；头像字节
-  由接入方提供，失败使用默认头像。保留旧农场背景、地块和作物素材。
-- 按可见状态缓存成图并在生长阶段边界失效；并发相同请求合并。
-  提供离线生成、性能记录、安装包独立运行和中文字体配置说明。
-- 用户选择补齐真寻测试版：最小命令接入、离线白名单打包、GitHub
-  构建工作流、可选手动同步真寻发布仓库测试分支、安装/卸载说明。
-  独立测试库、沿用原指令；保留旧版和原业务/渲染验收A1-A13。
-
-## Directory structure
-
-### Created
-
-- src/farm_render/：画布、素材、展示模型、布局、渲染器及异步入口。
-- scripts/export_render_assets.py、scripts/render_demo.py。
-- tests/test_render*.py、docs/10-rendering.md。
-- integrations/zhenxun/ 的入口、命令和生命周期；scripts/ 下真寻构建、
-  产物验证、本地安装及手动发布脚本；.github/workflows/ 下构建工作流；
-  tests/test_zhenxun*.py、docs/11-zhenxun-preview.md。
-
-### Modified
-
-- pyproject.toml：render 可选依赖及渲染素材打包。
-- scripts/verify_foundation.py：增加渲染资源可复现检查。
-- README.md、docs/README.md、docs/task_plan.md、docs/progress.md。
-- 当前 brief 与新增 farm-render 目标规格；原业务规格保留。
-- release/targets.json 与真寻职责说明；新增真寻预览完整目标规格。
-
-### Deleted
-
-无。
-
-### Not created
-
-- 不创建AstrBot/通用NoneBot接入、真实玩家库或字体再分发包。
-- 不修改 legacy 基线，不创建多个框架的业务副本。
-
-# Non-goals
-
-本轮不实现AstrBot/通用NoneBot宿主插件、签到、偷菜、活动、
-外部金币兑换、点券兑换、土地升级、星级进阶、账号绑定或在线联机。
-不读取或迁移真实玩家数据，不重置旧资产，不改旧基线业务。
-不在本机 clone/fetch/pull/push 任何远程，不创建 PR 或远端Release。
-生成工作流与发布脚本，但不执行跨仓库发布或安装/重启真实机器人。
-不将设计占位目录报告为已支持三框架。
-
-# Acceptance examples
-
-- A19: 默认质量75，整数1和95有效，0、96、布尔值及非整数拒绝；
-  配置应用到所有图片编码，缓存区分质量。仅我的农场接受高清，
-  质量不低于85及配置值；其他查询拒绝高清，仓库分页、文字继续可用。
-  真寻注册网页配置并在请求时读取，NoneBot读取启动配置；帮助与说明一致。
-- A1: 旧基线 827 文件校验继续通过；新核心不导入三框架、无导入副作用，
-  可从安装包或源码独立运行，核心不通过路径引用 legacy。
-- A2: 可复现导出 202 条作物配置，名称和必要数值对应源静态数据库；
-  本地加载支持格式校验，坏数据明确失败，不访问网络。
-- A3: 注册立即可查询 500 农场币、0 点券、0 经验、3 块空地；
-  重复注册不重复赠送；不同显式作用域不串号。
-- A4: 购买到播种全过程扣款、入库、耗种和地块改变正确；0、负数、
-  布尔值、超大数量、余额/库存不足、等级不足和不存在对象明确失败，
-  不留下部分写入。
-- A5: 未成熟不能收获；成熟后只增加本次产量/经验；历史经验 100、
-  本次获得20时为120；多地加成逐块计算且交换顺序不改变总和；
-  多季次数及枯萎/铲除遵守保存的规则与可注入时钟。
-- A6: 出售收益只增加一次，例如余额100、收益20后为120；
-  锁定同时约束指定与全部出售；返回结构化真实余额及安全文本，
-  不发生旧版模板参数缺失。
-- A7: 模拟交易中途异常时余额、库存、地块及流水整体回滚；
-  同一操作标识重试返回原结果、参数冲突拒绝；并发写入不超卖、
-  不重复领取，不吞数据库故障伪装成功；重启后数据可读。
-- A8: 提供可执行的离线测试、运行入口和使用说明，保留真实宿主、
-  真实库迁移及远程发布未验证的说明；文档记录已实现范围和剩余项。
-- A9: 独立图片工具支持透明合成、缩放、裁剪、文本测量/省略和三格式编码；
-  渲染不导入框架、不联网，核心保持无 Pillow 依赖；安装包含所需素材。
-- A10: 从一次快照绘制空地、生长、成熟、再生长、枯萎及锁定地块，
-  使用统一时间、旧布局和正确偏移；输出普通/高清可解码图片。
-- A11: 小画布从开始按目标尺寸绘制；素材和结果缓存有内存上限，
-  共享素材不被污染；阶段/成熟边界、账户、头像及作用域变化不复用旧图。
-- A12: 合成和编码在后台执行且限制并发，相同请求合并；取消和异常
-  不提前释放运行名额、不泄漏后台任务；记录耗时、尺寸和缓存状态。
-- A13: 离线生成农场样例、对比尺寸/编码与冷暖缓存，保存测量报告和
-  接入文档；验证旧基线及原有核心测试，明确尚未接入真实消息平台。
-- A14: 真寻接入沿用原指令提供帮助、注册、我的农场、仓库、购买、
-  播种、收获、铲除、锁定/解锁、出售；稳定事件幂等标识、身份隔离，
-  独立测试数据库与启动/关闭生命周期；缺字体时给出配置提示。
-- A15: 白名单构建完整真寻插件ZIP，包含私有共享模块、静态素材、
-  依赖、许可证及来源/文件哈希；不含其他适配、legacy、测试或玩家数据，
-  源提交/脏工作区明确记录，相同输入可复现，构建不修改开发源码。
-- A16: 离线校验ZIP内容、导入和命令路由；安装脚本拒绝路径穿越、
-  哈希错误和已有目标，不覆盖旧插件或玩家数据；不自动启动真实机器人。
-- A17: 主仓库工作流完成检查/构建/上传测试附件；可选手动发布只面向
-  固定真寻仓库的专用测试分支，默认不发布、不改main、不force，凭据
-  由Secrets提供且不进入产物；发布仓库收到生成内容后可独立校验。
-- A18: 本机离线验证打包、边界与安装行为；CI覆盖Windows/Linux及
-  Pillow10.4和当前支持版本，记录真实宿主、GitHub运行未验证边界；
-  提供下载、字体/数据路径、测试命令、回退/卸载和Secrets配置说明。
-
-# Constraints and invariants
-
-源码使用 Python，4 空格、80 字符行长，明确说明数据模型字段。
-保留 GPLv3 许可与源归属。共享核心内部相对导入。
-运行数据和测试临时数据库不入 Git。新实现只使用必要依赖，
-优先标准库 SQLite、异步线程执行和 unittest，不为框架引入依赖。
-新数据库 schema 与旧库区分，未知或更高 schema 明确拒绝。
-同一基础交易的存储和应用紧密耦合，使用单个 change，不拆分子任务。
-
-# Decisions
-
-- 2026-10-22用户确认统一质量方案，并修正为“除了我的农场允许带高清，
-  其他都不允许。请执行吧”。本次不接受或归档旧验收结果。
-- 用户已授权初始化 Comet 并执行基础开发；工作区为当前目录 main。
-- 主仓库地址已明确：https://github.com/Shu-Ying/main_plugin_farm.git。
-- 现有文档是设计参考，旧代码是实现参考；本轮仅覆盖上述第一批核心，
-  不把整份长期计划视为一次必须全部实施的产品需求。
-- 未决的农场共享、联机、存量资产、兑换与素材发布不由本轮擅自决定。
-- 用户随后明确要求“根据上述方案和之前优化的绘制我的农场，请执行”，
-  授权图片层及绘图优化。沿用已选当前目录；该目录已有未提交核心，
-  Runtime 不允许第二个 current change，因此作为基础开发范围补充。
-- 用户讨论后明确“确认并进入开发”，包含 WebP 优先候选及 JPEG/PNG
-  兼容输出；尺寸、质量、编码力度独立配置，平台能力由适配器声明。
-- 素材保留原 GPL 归属，不捆绑未确认再分发许可的字体；部署显式配置
-  中文字体路径。真实宿主头像缓存和上传由后续适配器实现。
-- 用户已明确选择“补齐真寻测试版：命令接入＋打包工作流＋安装脚本”。
-  由于当前目录未归档核心与新接入需联合验证，作为同一基础测试交付
-  扩展；不代用户接受上轮结果。用户明确不加测试前缀，沿用原指令；
-  测试库与旧库隔离，发布脚本只操作专用farm-preview分支，实际发布
-  不执行。测试时由用户停用旧插件，安装器不删除或覆盖旧插件。

docs/comet/changes/farm-core-foundation/comet-state.yaml

@@ -1,296 +0,0 @@
-schema: comet.native.v4
-name: farm-core-foundation
-language: en
-phase: build
-status: active
-state_version: 39
-brief: brief.md
-document_constraints_version: 3
-shape_confirmation_hash: 066f3825ae83e04c24cb7018a75d217a2aaae9a8a4cba1c435eecc776de4a90d
-spec_changes:
-  - capability: farm-core
-    operation: create
-    source: specs/farm-core/spec.md
-  - capability: farm-render
-    operation: create
-    source: specs/farm-render/spec.md
-  - capability: zhenxun-preview
-    operation: create
-    source: specs/zhenxun-preview/spec.md
-workspace:
-  isolation: current
-  change_branch: main
-  target_branch: main
-  finish: null
-loop:
-  stage: building
-  goal_cycle: 6
-  iteration: 1
-  attempt: 0
-  retry_epoch: 0
-  failed_iteration_count: 0
-  no_progress_count: 0
-  execution_failure_count: 0
-  previous_unresolved_ids: []
-  next_action: submit-builder-candidate
-acceptance:
-  - id: A1
-    source: brief.md
-    text: "A19: 默认质量75，整数1和95有效，0、96、布尔值及非整数拒绝； 配置应用到所有图片编码，缓存区分质量。仅我的农场接受高清，
-      质量不低于85及配置值；其他查询拒绝高清，仓库分页、文字继续可用。 真寻注册网页配置并在请求时读取，NoneBot读取启动配置；帮助与说明一致。"
-    result: pending
-    reason: null
-  - id: A2
-    source: brief.md
-    text: "A1: 旧基线 827 文件校验继续通过；新核心不导入三框架、无导入副作用， 可从安装包或源码独立运行，核心不通过路径引用 legacy。"
-    result: pending
-    reason: null
-  - id: A3
-    source: brief.md
-    text: "A2: 可复现导出 202 条作物配置，名称和必要数值对应源静态数据库； 本地加载支持格式校验，坏数据明确失败，不访问网络。"
-    result: pending
-    reason: null
-  - id: A4
-    source: brief.md
-    text: "A3: 注册立即可查询 500 农场币、0 点券、0 经验、3 块空地； 重复注册不重复赠送；不同显式作用域不串号。"
-    result: pending
-    reason: null
-  - id: A5
-    source: brief.md
-    text: "A4: 购买到播种全过程扣款、入库、耗种和地块改变正确；0、负数、 布尔值、超大数量、余额/库存不足、等级不足和不存在对象明确失败，
-      不留下部分写入。"
-    result: pending
-    reason: null
-  - id: A6
-    source: brief.md
-    text: "A5: 未成熟不能收获；成熟后只增加本次产量/经验；历史经验 100、 本次获得20时为120；多地加成逐块计算且交换顺序不改变总和；
-      多季次数及枯萎/铲除遵守保存的规则与可注入时钟。"
-    result: pending
-    reason: null
-  - id: A7
-    source: brief.md
-    text: "A6: 出售收益只增加一次，例如余额100、收益20后为120； 锁定同时约束指定与全部出售；返回结构化真实余额及安全文本，
-      不发生旧版模板参数缺失。"
-    result: pending
-    reason: null
-  - id: A8
-    source: brief.md
-    text: "A7: 模拟交易中途异常时余额、库存、地块及流水整体回滚； 同一操作标识重试返回原结果、参数冲突拒绝；并发写入不超卖、
-      不重复领取，不吞数据库故障伪装成功；重启后数据可读。"
-    result: pending
-    reason: null
-  - id: A9
-    source: brief.md
-    text: "A8: 提供可执行的离线测试、运行入口和使用说明，保留真实宿主、 真实库迁移及远程发布未验证的说明；文档记录已实现范围和剩余项。"
-    result: pending
-    reason: null
-  - id: A10
-    source: brief.md
-    text: "A9: 独立图片工具支持透明合成、缩放、裁剪、文本测量/省略和三格式编码； 渲染不导入框架、不联网，核心保持无 Pillow
-      依赖；安装包含所需素材。"
-    result: pending
-    reason: null
-  - id: A11
-    source: brief.md
-    text: "A10: 从一次快照绘制空地、生长、成熟、再生长、枯萎及锁定地块， 使用统一时间、旧布局和正确偏移；输出普通/高清可解码图片。"
-    result: pending
-    reason: null
-  - id: A12
-    source: brief.md
-    text: "A11: 小画布从开始按目标尺寸绘制；素材和结果缓存有内存上限， 共享素材不被污染；阶段/成熟边界、账户、头像及作用域变化不复用旧图。"
-    result: pending
-    reason: null
-  - id: A13
-    source: brief.md
-    text: "A12: 合成和编码在后台执行且限制并发，相同请求合并；取消和异常 不提前释放运行名额、不泄漏后台任务；记录耗时、尺寸和缓存状态。"
-    result: pending
-    reason: null
-  - id: A14
-    source: brief.md
-    text: "A13: 离线生成农场样例、对比尺寸/编码与冷暖缓存，保存测量报告和 接入文档；验证旧基线及原有核心测试，明确尚未接入真实消息平台。"
-    result: pending
-    reason: null
-  - id: A15
-    source: brief.md
-    text: "A14: 真寻接入沿用原指令提供帮助、注册、我的农场、仓库、购买、 播种、收获、铲除、锁定/解锁、出售；稳定事件幂等标识、身份隔离，
-      独立测试数据库与启动/关闭生命周期；缺字体时给出配置提示。"
-    result: pending
-    reason: null
-  - id: A16
-    source: brief.md
-    text: "A15: 白名单构建完整真寻插件ZIP，包含私有共享模块、静态素材、 依赖、许可证及来源/文件哈希；不含其他适配、legacy、测试或玩家数据，
-      源提交/脏工作区明确记录，相同输入可复现，构建不修改开发源码。"
-    result: pending
-    reason: null
-  - id: A17
-    source: brief.md
-    text: "A16: 离线校验ZIP内容、导入和命令路由；安装脚本拒绝路径穿越、 哈希错误和已有目标，不覆盖旧插件或玩家数据；不自动启动真实机器人。"
-    result: pending
-    reason: null
-  - id: A18
-    source: brief.md
-    text: "A17: 主仓库工作流完成检查/构建/上传测试附件；可选手动发布只面向 固定真寻仓库的专用测试分支，默认不发布、不改main、不force，凭据
-      由Secrets提供且不进入产物；发布仓库收到生成内容后可独立校验。"
-    result: pending
-    reason: null
-  - id: A19
-    source: brief.md
-    text: "A18: 本机离线验证打包、边界与安装行为；CI覆盖Windows/Linux及
-      Pillow10.4和当前支持版本，记录真实宿主、GitHub运行未验证边界；
-      提供下载、字体/数据路径、测试命令、回退/卸载和Secrets配置说明。"
-    result: pending
-    reason: null
-builder_handoff: null
-blockers: []
-verification: null
-history:
-  - goal_cycle: 1
-    iteration: 1
-    attempt: 1
-    outcome: pass
-    unresolved_ids: []
-    summary:
-      text: 独立只读验收完成：完整brief/Spec、实现、测试、配置和文档均已核对，最后参考Builder交接；绑定候选的Runtime
-        foundation-offline以退出码0完成，827基线文件、可复现目录导出与32项测试通过。A1-A8全部通过；未追加或自行重跑完整检查，未修改项目源文件。
-      truncated: false
-    completed_at: 2026-10-15T07:00:29.324Z
-  - goal_cycle: 1
-    iteration: 1
-    attempt: 1
-    outcome: recovery
-    unresolved_ids: []
-    summary:
-      text: 用户明确要求在已确认的图片工具及绘图优化方案上执行开发；将共享农场渲染作为当前基础开发的范围补充，保留原业务验收项并追加图片验收。
-      truncated: false
-    completed_at: 2026-10-15T07:55:29.688Z
-  - goal_cycle: 2
-    iteration: 0
-    attempt: 0
-    outcome: recovery
-    unresolved_ids: []
-    summary:
-      text: Native confirmed acceptance criteria changed
-      truncated: false
-    completed_at: 2026-10-15T08:23:15.134Z
-  - goal_cycle: 3
-    iteration: 1
-    attempt: 1
-    outcome: pass
-    unresolved_ids: []
-    summary:
-      text: 独立只读核对全部13项、完整规格、核心与渲染源码、测试/打包/导出脚本、正式Runtime日志和图片样例；复用匹配候选的45项正式检查，全部验收通过。图索引新增渲染未覆盖且旧文件metadata_changed，已直接源文件补齐，无需重复完整套件。
-      truncated: false
-    completed_at: 2026-10-15T08:40:00.608Z
-  - goal_cycle: 3
-    iteration: 1
-    attempt: 1
-    outcome: recovery
-    unresolved_ids: []
-    summary:
-      text: 用户选择补齐真寻测试版：命令接入、打包工作流和安装脚本；将现有核心与渲染扩展为可安装真寻预览包，保留独立测试库和旧基线，不执行远端操作。
-      truncated: false
-    completed_at: 2026-10-15T09:24:24.236Z
-  - goal_cycle: 4
-    iteration: 0
-    attempt: 0
-    outcome: recovery
-    unresolved_ids: []
-    summary:
-      text: Native confirmed acceptance criteria changed
-      truncated: false
-    completed_at: 2026-10-15T09:28:23.268Z
-  - goal_cycle: 5
-    iteration: 1
-    attempt: 1
-    outcome: pass
-    unresolved_ids: []
-    summary:
-      text: 独立只读核对完整brief、三份规格及18项验收，审阅核心/渲染、真寻接入、白名单构建/校验/安装/固定发布边界、工作流和测试文档。复用本候选正式Runtime的55项全回归、Pillow10.4下23项兼容检查及工作流守卫，全部通过；未重复完整套件。图索引旧/新增缺覆盖，已直接源码补齐。未修改实现或正式规格，未访问远端、安装/启动机器人或代用户接受。
-      truncated: false
-    completed_at: 2026-10-15T09:51:26.860Z
-  - goal_cycle: 5
-    iteration: 1
-    attempt: 1
-    outcome: recovery
-    unresolved_ids: []
-    summary:
-      text: 独立验收指出余额不足错误码映射缺少insufficient_funds；保持已确认范围，补中文提示及回归测试后重新交付。
-      truncated: false
-    completed_at: 2026-10-15T09:52:02.989Z
-  - goal_cycle: 5
-    iteration: 2
-    attempt: 1
-    outcome: pass
-    unresolved_ids: []
-    summary:
-      text: 独立只读核对完整brief、三份规格和18项，审阅核心/渲染/真寻接入、白名单构建/校验/安装/固定发布边界、测试工作流与文档。当前candidate绑定Runtime的56项完整回归、Pillow10.4下24项及工作流守卫均退出码0；日志前缀658580e0与当前cedb操作绑定已核实。额外只读确认最终ZIP30文件且runtime匹配修复源码，余额不足中文提示与无扣款回归通过。图索引过期/缺覆盖已直接源码补齐，未重复完整套件、修改实现或正式文件、远端操作、安装启动宿主或代用户接受。
-      truncated: false
-    completed_at: 2026-10-15T09:58:23.989Z
-  - goal_cycle: 5
-    iteration: 2
-    attempt: 1
-    outcome: recovery
-    unresolved_ids: []
-    summary:
-      text: 用户实际测试要求默认字体：在真寻适配层默认复用宿主字体目录，保留显式字体覆盖和缺失时清楚提示；修复预览版默认不可绘图的接入遗漏。
-      truncated: false
-    completed_at: 2026-10-16T02:06:48.036Z
-  - goal_cycle: 5
-    iteration: 3
-    attempt: 1
-    outcome: pass
-    unresolved_ids: []
-    summary:
-      text: 独立只读验收全部A1-A18：完整brief/三spec与当前字体实现、测试、文档已核对；复用此前未改变核心/渲染/发布的正式独立验收，并核实本候选绑定Runtime三检查exit0，实际58项完整与Pillow10.4下26项通过。真寻FONT_PATH为resources/font，接入层默认选宿主字体，坏默认跳过、显式覆盖优先，共享层未引入真寻路径；安装目录runtime/commands与主源SHA256一致。图索引不覆盖新文件或metadata_changed，已读源码补齐；未重跑完整测试、未修改项目文件、未启动宿主或访问远端。
-      truncated: false
-    completed_at: 2026-10-16T02:13:06.574Z
-  - goal_cycle: 5
-    iteration: 3
-    attempt: 1
-    outcome: recovery
-    unresolved_ids: []
-    summary:
-      text: 用户要求修复迁移遗漏：恢复旧版用户面板素材、布局与经验进度语义并保留性能优化。
-      truncated: false
-    completed_at: 2026-10-16T02:17:50.690Z
-  - goal_cycle: 5
-    iteration: 4
-    attempt: 0
-    outcome: recovery
-    unresolved_ids: []
-    summary:
-      text: "Builder handoff Runtime checks failed: all-offline"
-      truncated: false
-    completed_at: 2026-10-16T02:26:17.238Z
-  - goal_cycle: 5
-    iteration: 5
-    attempt: 1
-    outcome: pass
-    unresolved_ids: []
-    summary:
-      text: 独立只读核对全部A1-A18、完整brief/三份Spec、相关实现与测试及本候选Runtime绑定。复用60项完整检查、Pillow10.4下28项及工作流守卫，均退出码0；未重跑完整套件。原面板底图/头像框/头像尺寸和信息已恢复，用户授权的槽位坐标校正经源码与1536样图核验；preview.3最终ZIP30文件与当前安装目录逐文件相同，renderer匹配源码。未修改实现/正式规格、操作远端、真实玩家库或启动宿主。
-      truncated: false
-    completed_at: 2026-10-16T02:31:02.032Z
-  - goal_cycle: 5
-    iteration: 5
-    attempt: 1
-    outcome: recovery
-    unresolved_ids: []
-    summary:
-      text: 用户明确要求执行统一图片质量配置，默认75、范围1至95，仅我的农场允许高清覆盖；其他图片禁止高清，保留仓库文字和分页。修订用户可见要求。
-      truncated: false
-    completed_at: 2026-10-22T09:37:42.325Z
-history_overflow:
-  dropped_entries: 0
-  first_dropped_at: null
-  last_dropped_at: null
-  outcome_counts:
-    pass: 0
-    fail: 0
-    blocked: 0
-    execution-error: 0
-    recovery: 0
-verification_result: pending
-verification_report: null
-archived: false
-created_at: 2026-10-15T06:34:33.214Z

docs/comet/specs/farm-core/spec.md

@@ -0,0 +1,107 @@
+# Farm Core Foundation
+
+本规格定义第一批框架无关基础核心的完整行为，覆盖注册、配置、
+资产库存、种植交易、文本展示和本地持久化。
+真实机器人入口、联机和旧玩家数据迁移不在本 capability 范围内。
+
+## Runtime and migration boundary
+
+共享代码位于 src/farm_core，包内部相对导入；加载模块不执行网络、
+创建数据库或启动线程。可注入显式配置、时钟与存储生命周期。
+静态作物目录从保留的旧作物库离线导出，发布或安装后不依赖 legacy。
+完整静态目录与玩家数据库分开保存，旧基线保持只读。
+SQLite 工作在线程中执行且每个用例拥有完整事务，异步调用可等待结果。
+
+Scenario: Independent core and preserved baseline
+Acceptance: A1
+基线离线校验通过，包独立导入、安装、调用不需要三种宿主或 legacy。
+
+## Catalogue
+
+迁移基线含202条作物且当时名称唯一；运行时以稳定本地ID为身份，
+允许同名，名称查询拒绝歧义，支持#编号。映射id/name/level/buy/isVip/vipBuy/
+experience/harvest/price/time/crop/phase 等必要数据，规范整数数值，
+异常的字段或版本错误明确拒绝。购买使用对应币种，按等级校验。
+不下载远程目录，不将素材路径或绘图偏移当作业务依赖。
+多季再生长间隔保持旧去重 phase[1:] 求和规则，不在首轮重新平衡。
+
+Scenario: Reproducible catalogue migration
+Acceptance: A2
+离线导出再生成内容一致；202 条与源值匹配；损坏输入被拒绝。
+
+## Registration and account model
+
+调用方提供 deployment/realm/platform/user 字符串身份，核心不推断账号
+等价性或跨群共享。首次注册赠送500 point、0 vipPoint、0 exp、6空地。
+唯一身份只能领取一次初始资产。查询总是基于已提交数据库状态。
+可靠识别为初始3块的旧用户一次性追加3块普通空地，保留已开垦成果；
+并发、重试和重启不得重复补偿，来源不明和数量异常明确拒绝。
+经验等级门槛为 200*k*(k+1)//2，使用整数边界计算。
+货币、数量和时间范围必须适合 SQLite 整数及应用限制。
+bool 不作为合法整数参数，不允许负数归零后当作交易成功。
+
+Scenario: Immediate registration and scope isolation
+Acceptance: A3
+首次注册立即查询得到默认值；重复注册无增发；不同作用域相互独立。
+
+## Purchase and sowing
+
+购买种子时在同一用例事务内检查注册、作物、数量、等级和余额，
+扣款并增加库存，失败整体回滚。播种检查空地和库存，在同一事务内
+消耗实际种子、创建作物实例，保存结算所需目录数据避免后续版本改变
+已播种作物。显式数量超过可用资源返回明确结果，全部操作使用明确
+参数而不是允许任意负数。返回真实操作数、余额及剩余库存。
+
+Scenario: Purchase and sow atomically with validated inputs
+Acceptance: A4
+非法数量、余额不足、等级不足和库存不足不产生任何部分状态。
+
+## Harvest and crop lifecycle
+
+首熟为播种时间加 time*3600；使用可注入时钟，当前时间等于成熟时可收。
+每块地独立计算 floor(base*(100+bonus)/100) 后相加，不对累计值加成。
+经验只增加本次增量。播种每地另加2经验、铲除每地另加2经验；
+“历史100”指收获操作前已提交的经验。
+产物入库、经验变动、收获次数和下一季状态
+在同一事务提交。最后一季后枯萎；铲除只清理枯萎地块。
+再次重试不重复收获。展示结果不再次修改数据。
+
+Scenario: Correct experience and multi-crop settlement
+Acceptance: A5
+历史100加本次20等于120；地块排序不影响总收益；成熟边界及多季状态正确。
+
+## Inventory locking and selling
+
+指定出售和全部出售均保护锁定物品。出售收入在事务内增加一次，
+库存减少为实际成交数量。没有可出售物品时有明确结果。
+查询及返回结构化账户/库存/地块数据，基础文本仅渲染结果，避免模板
+占位不匹配；文本不依赖任何消息框架。
+
+Scenario: Consistent locking and exact sale proceeds
+Acceptance: A6
+100余额出售收入20变为120；锁定物品无法通过任一出售入口消耗。
+
+## Persistence, idempotency and failures
+
+每个写用例有稳定 operation_id、动作和规范化参数指纹。
+同作用域同标识相同请求返回已提交结果，不再次扣款或发奖；
+不同参数冲突拒绝。状态改变、资产流水和结果持久化在同一事务。
+数据库异常应回滚并传播为明确错误，不能转成不存在/无农场。
+支持并发调用，通过事务、条件更新及唯一约束避免超卖和重复结算。
+关闭后重开可读取已提交数据；未知/高版本 schema 拒绝。
+调用取消不能无记录重复交易，已提交结果可通过相同操作标识恢复。
+
+Scenario: Rollback, replay and concurrent safety
+Acceptance: A7
+故障注入无部分数据；重试幂等；冲突被拒绝；并发不透支；重启后状态一致。
+
+## Verification and user documentation
+
+离线测试采用构造数据，覆盖上述全部验收示例以及源目录一致性。
+提供本地运行/演示入口，不宣称可放入三种框架插件目录加载。
+记录本轮新实现与旧缺陷对应关系，不把历史设计文档误标为全面完成。
+不安装或操作真实机器人，不访问远程仓库，不导入真实玩家数据库。
+
+Scenario: Repeatable local verification and accurate status
+Acceptance: A8
+安装及离线测试命令可复现，使用说明清楚标明未实现的接入与发布部分。

docs/comet/specs/farm-render/spec.md

@@ -0,0 +1,77 @@
+# Farm Render
+
+## Independent image layer
+
+farm_render 使用 Pillow 实现同步画布操作；farm_core 不依赖 Pillow。
+工具支持透明合成、复制、缩放、裁剪、文本测量与超长省略，以及
+WebP/JPEG/PNG 编码。JPEG 合并透明背景，输出携带 MIME、尺寸与字节。
+WebP 默认采用有损质量75、method=2；高清质量为max(配置质量,85)。格式与尺寸独立，
+auto 根据调用方声明的平台能力选择 WebP 或 JPEG，本机无 WebP 编码
+支持时 auto 回退 JPEG，显式 WebP 则清楚报错。PNG 保留无损选项。
+开发素材独立生成，不在运行时引用 legacy 或宿主。插件携带轻量元数据
+及绑定摘要的素材清单，大型 assets.zip 从所选源校验下载并缓存，
+不打入插件发布包；小型升级土地素材仍随包提供。中文字体支持显式
+配置，或独立校验下载原版小赖字体及完整 OFL 许可，不复制 Windows
+商业字体。无可用素材或字体时接入层降级文字，不输出缺字占位图。
+
+Scenario: Framework-independent packaged renderer
+Acceptance: A9
+从 wheel 安装到临时目录，无 legacy 和框架，显式提供已校验的外部
+素材及字体后仍可生成图片；下载与校验止于接入/资源准备层。
+
+## Snapshot and layout
+
+入口从业务服务取得一次一致快照；绘图纯消费快照与统一 now，不查库。
+复用旧30块地布局、季节静态背景、草地/普通地和作物阶段素材。
+首季阶段锚点由保存的 mature_at-growth_seconds 推导，再季使用
+mature_at-regrowth_seconds，按本季时长映射展示阶段，成熟优先、
+枯萎优先于成熟。阶段仅影响外观，不修改交易规则和数据库。
+作物定位采用 schema=4 的 visible_contact_center 统一公式，按本地
+土地中心落点，保留完整纹理和直立等比缩放，不使用旧 offset 字段
+或逐阶段手调锚点。地块位置按当前稳定编号映射。缺失作物资源使用
+显式占位并记录警告。
+用户信息显示真实快照余额、点券和经验，头像仅接收字节，无头像时
+绘制默认图；拒绝超大或无效头像并降级。主题由调用方明确提供。
+
+Scenario: Farm states and target profiles
+Acceptance: A10
+空地、生长、成熟、再生长、枯萎和未解锁地可生成图片，普通与高清
+使用同一布局；统一时间下同一阶段稳定，边界切换正确。
+
+## Resource and result cache
+
+普通图默认宽1024，高清宽1536；画布与坐标从开始按比例处理。
+解码后素材、底图和成图使用有界 LRU，超限条目不入缓存。
+素材缓存键含路径及目标尺寸，缓存图片只读或复制后修改。
+成图键含完整身份、可见地块阶段/账户/头像摘要、主题、质量与格式；
+同阶段可复用，下一阶段或成熟时间到达必须改变键，静态素材版本
+由渲染器实例绑定；资源更新后重新创建实例。默认缓存不落盘。
+
+Scenario: Bounded and correct caching
+Acceptance: A11
+缓存总字节不超上限；跨账号不串图，阶段、余额、头像变化不命中旧图；
+普通图绘制画布即为1024宽，无3072宽中间合成画布。
+
+## Controlled asynchronous entry
+
+提供异步入口，将整张图的合成与编码交给后台线程；默认最多一个
+任务运行，等待队列有上限。相同身份/状态请求共享任务。调用取消
+不取消正在运行的共享绘制，也不提前释放容量。关闭等待任务排空。
+日志只记录查询/排队/合成/编码耗时、字节、尺寸和缓存结果，不记录
+真实用户标识、姓名、头像、凭据或完整快照。
+
+Scenario: Concurrency, cancellation and diagnostics
+Acceptance: A12
+慢绘图时事件循环仍可工作；同时运行数有界，重复请求共享任务，
+失败可重试；取消后后台完成并正确释放容量，关闭无残留任务。
+
+## Verification and usage
+
+提供明确中文字体路径的离线示例，使用构造数据和临时数据库，
+报告冷暖耗时、尺寸、三种编码字节及缓存占用。测量仅代表本机样例，
+不宣称低配服务器耗时或真实平台上传性能。保留核心离线验证与
+旧基线校验，不接入/重启真实机器人，不访问远端。
+
+Scenario: Repeatable offline rendering
+Acceptance: A13
+离线样例可解码，性能报告真实可复现，文档提供接入调用和未验证边界。

docs/comet/specs/zhenxun-preview/spec.md

@@ -0,0 +1,96 @@
+# 真寻可安装预览包
+
+## 接入边界
+
+全部图片采用统一整数编码质量（1～95，默认75）。真寻网页配置名称为
+“农场图片质量”，普通NoneBot接入使用FARM_IMAGE_QUALITY。真寻请求时
+读取配置；无效值明确拒绝并保留已有有效配置，不静默夹取范围。
+只有“我的农场 高清”可覆盖默认尺寸至1536宽，质量max(配置值,85)。
+地块编号、详情、种子商店、我的种子和我的作物拒绝高清参数，保留既有
+分页和仓库文字查询。编码质量随各类渲染输入传递并进入图片缓存键。
+PNG继续无损输出，质量参数不改变PNG清晰度。默认其他图片尺寸不变。
+
+Scenario: 全局图片质量及仅农场高清
+Acceptance: A19
+配置1和95可用；0、96、布尔及小数拒绝。所有图片按配置编码且不同质量
+不共享成图。农场高清为1536宽，质量至少85且不低于配置；其他命令高清
+返回明确参数错误，仓库分页和文字仍可用，帮助不再宣称其他命令支持高清。
+
+本 capability 验收真寻接入；NoneBot/AstrBot 已有独立接入与打包，
+不将其当前存在误报为未实现。业务和图片仍来自主仓库共享源码。接入层加载插件
+私有_vendor命名空间，渲染层对farm_core的引用在构建时改为私有相对
+导入，不修改开发源码、不污染全局sys.path或sys.modules别名。
+命令不增加测试前缀，沿用开通农场、我的农场、农场帮助、我的种子、
+我的作物、购买种子、播种、收获、铲除、作物加锁、作物解锁、出售作物
+等原指令，覆盖帮助、注册、我的农场、仓库、购买、
+播种、收获、铲除、锁定/解锁和出售；复用已有规则，不移植旧损坏模块。
+部署标识由配置给出，同一平台玩家在本预览部署内共享农场，不跨平台
+绑定；测试数据位置与旧版不同。事件标识包含机器人、平台、用户及
+原消息标识；无法获得稳定消息标识时写操作明确拒绝，不能随机重试。
+在启动时初始化存储、渲染器，在关闭时等待任务排空后关闭存储；字体
+支持显式配置合法中文字体，或校验下载原版小赖字体及完整许可。
+资源源可选 Github、Gitea、farm_service，默认 Github；服务地址独立
+保留。缺少资源或字体时保留文字功能，日志明确原因。头像失败降级，
+不让头像下载无限等待。本次不包含作物目录远程更新。
+
+Scenario: 真寻命令与生命周期
+Acceptance: A14
+模拟宿主验证命令路由、身份/幂等标识、异常反馈与启动关闭，使用独立库；
+不把模拟宿主测试报告为真实平台发图成功。
+
+## 产物
+
+scripts/build_zhenxun.py按白名单复制真寻接入、farm_core、farm_render、
+对应轻量数据、升级土地素材、LICENSE及NOTICE；大型图片及字体 ZIP
+不进入插件包。ZIP含单一插件根目录，仓库导出目录
+可作为真寻发布仓库根。生成来源manifest与独立SHA256附件，清单不
+自包含哈希；本地工作区脏时标识dirty，不能冒充源HEAD的纯净构建。
+输入版本严格校验，ZIP排序/时间固定，目标存在则拒绝或显式选择新路径。
+不打包其他适配器、运行库、凭据、缓存、legacy或全局字体。
+
+Scenario: 可复现白名单打包
+Acceptance: A15
+重复构建内容相同，独立目录导入私有模块成功，无旧目录和其他框架依赖。
+
+## 安装验证
+
+独立verify脚本校验manifest中每个文件与ZIP精确一致，拒绝多余/重复项、
+绝对路径、反斜线穿越、符号链接、不可信插件根名、哈希错误。
+安装器只安装到用户显式提供的插件父目录，既有目标拒绝覆盖，不删旧
+插件、不接触旧数据、不安装依赖、不启动/重启机器人；先校验再写入，
+失败清理自己新建的临时目录。提供明确安装步骤和停止机器人提示。
+
+Scenario: 安全校验与安装
+Acceptance: A16
+临时目录测试有效包可安装，坏包/穿越/已有目标均拒绝且不留下半成品。
+
+## 工作流和发布
+
+主仓库CI在PR/push及手动触发时执行检查，构建ZIP/清单/校验附件并上传
+Actions artifact。工作流权限默认只读；不可信PR不触发跨仓库写入。
+跨仓库同步依当前工作流，在 main 的 push 或显式 publish 手动输入时
+执行，PR 不触发；使用专用 Secret/受保护 environment，固定目标为
+Shu-Ying/zhenxun_plugin_farm 的 main 分支。脚本默认 dry-run，只有显式
+发布才联网；只进行普通更新，不 force、不修改旧标签；并发分支改变
+时失败。此次本地归档不执行发布。发布仓库只含生成的
+可安装内容、来源和验证工具，以及验证工作流，不在那里维护业务源码。
+下载ZIP测试不要求先同步仓库，不要求用户先给令牌。
+
+Scenario: 测试附件与可控同步
+Acceptance: A17
+静态检查工作流触发/权限和输入边界；模拟服务验证固定目标、冲突保护、
+令牌不落盘与默认dry-run。此任务不执行真实GitHub发布。
+
+## 兼容与文档
+
+真寻本地配置要求Pillow>=10,<11，本预览使用与其相交的>=10.4版本；
+CI测试最低10.4和本项目支持当前版本，Windows/Linux。不得静默强制
+升级宿主到12。文档列出本机实际检查、模拟与真实宿主的差别，并提供
+主仓库生成、发布仓库布局、下载/依赖安装、字体、数据库、测试命令、
+与旧版避免冲突、备份/卸载和可选同步的凭据最小权限步骤。沿用原
+指令时必须由用户停用旧插件，不静默更名指令，不自动禁用旧插件。
+
+Scenario: 可复现的真寻测试交付
+Acceptance: A18
+产物可离线验证，文档能按步骤启动人工测试；明确真实机器人与GitHub
+工作流仍未实际执行，不宣称已经上线或已兼容全部平台。