Files
main_plugin_farm/docs/astrbot-store-preparation.md
T
2026-10-23 19:19:01 +08:00

72 lines
4.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# AstrBot 商店展示适配 — 2026-10-23
## 已完成的本地修改
- 图标发布源:主仓库根目录`logo.png`,1254×1254 RGBA透明PNG。
使用内置图片生成工具制作,并清理边缘和留白;未覆盖其他图标。
后续添加浅粉文字「真寻农场」。主仓库、NoneBot和真寻README使用高清
`logo.png`,显示宽度400像素。AstrBot构建将高清图复制为`logo-readme.png`
供README引用,将根目录`logo-astrbot.png`(256×256)复制为商店识别的
`logo.png`。两个用途独立;AstrBot原目录中的图片不再作为打包源。
- 元数据:保持插件名、作者与仓库身份;添加短介绍、标签、主页及
`support_platforms: [aiocqhttp]`。版本继续读取 `version.txt`,本次为2.0.2。
- 文档:`readme/astrbot.md`改为用户使用说明,截图和图标采用发布仓库main分支
的公开绝对链接;发布前尚未在远端存在的新图片暂时无法通过该链接显示。
- 构建时从`src/farm_core/commands.py`读取AstrBot命令,替换README中的
`<!-- FARM_COMMANDS -->`标记,不再手写一份独立指令表。
- 更新日志:`integrations/astrbot/CHANGELOG.md`,2.0.2标记待发布,
未编造1.x历史,不表示已更新线上商店。
- 发布包收录README、CHANGELOG、logo和预览图,加入完整性清单。
- `verify_astrbot.py --marketplace`额外检查16 MiB大小限制;
普通本地安装包校验保留原有完整性边界。
## 本地交付及检查
- ZIP:`dist/astrbot-store-assets-20261023/astrbot_plugin_farm-2.0.2.zip`。
- 精确大小:25,248,453字节(24.08 MiB)。
- 安装目录预览:同目录`repository/`,版本2.0.2。
- 两项AstrBot包测试通过:重复构建一致、校验与篡改拒绝、模拟宿主命令、
图片及关闭流程,并验证展示资源、透明图标和自动指令表。
- 图标为正方形,Alpha范围0~255。未把生成的角色图声明为官方授权素材。
- 本轮未安装、重启、提交Git、推送、创建Release或更新Cloud。
## 待确认与已知限制
2026-10-23后续进展:已将三端发行包的assets.zip移至farm_service仓库
`assets/`,本地新包`dist/astrbot-external-assets-20261023/`大小4,599,804字节
(4.39 MiB),通过`--marketplace`大小及完整性检查;以下24.08 MiB为旧产物记录。
配置及服务说明以`farm_service/docs/assets.md`为准;尚未推送或验证远端素材URL。
1. **商店容量限制尚未满足**:官方普通投稿限制16MB,现有素材包
`src/farm_render/data/assets.zip`本身已21,264,561字节;完整ZIP24.08 MiB。
`--marketplace`已实际执行并拒绝。不能把本地构建成功当作市场发布就绪。
后续需决定素材压缩/拆分策略,或与AstrBot维护者确认容量例外;本轮未删减
或重新压缩用户现有农场素材以避免画质和布局变化。
2. **最低AstrBot版本**:未凭推测加入`astrbot_version`。需要选择最低支持版本
并在真实宿主验证后声明;模拟宿主通过不等于真实宿主通过。
3. **支持平台**:仅声明当前重点适配的aiocqhttp;其他平台是否加入须验证,
不因共享核心不依赖框架就宣称全部平台可用。
4. **Cloud同步**:发布页需登录。尚未核实Cloud独立更新日志是否自动同步
CHANGELOG或GitHub Release;宿主读取根CHANGELOG已有官方源码依据。
后续发布时应检查Cloud的文档、更新日志、信息、版本四个栏目。
5. **图标选择**:当前采用真寻抱趴胡萝卜的构图。正方形符合图标比例要求,
保留生成原分辨率;256×256为官方推荐而非本轮输出尺寸。
如用户希望改坐姿、简化轮廓或调整服装,可基于原图继续修改。
6. **角色呈现**:图标为生成式非官方二次创作,识别度及是否最终采用由用户审阅;
不声称已获得角色官方授权。代码许可证不能作为角色图像授权的证明。
7. **模型请求**:当前工具不能切换或核实主对话模型,未声称已切到GPT-6.1 Sol高。
## 图标生成说明
内置图片生成工具;首稿提示:Mahiro Oyama / 緒山まひろ,银白偏粉长发、
呆毛和红棕眼,穿不透明宽松淡黄色连帽衫,完整着装、无文字,Q版角色轻松
抱趴在一根巨大橙色胡萝卜上,绿色叶片、奶油色贴纸轮廓,透明正方形背景,
优先小图辨识。第二轮保留角色与姿势,要求清理游离像素、平滑轮廓和增加留白。
## 参考
- https://docs.astrbot.app/dev/star/plugin-new.html
- https://docs.astrbot.app/dev/star/plugin-publish.html
- https://cloud.astrbot.app/plugin/Shu-Ying/astrbot_plugin_farm
- https://onimai.jp/character/mahiro.html