Files
main_plugin_farm/docs/07-decisions.md
T
2026-10-15 17:21:05 +08:00

42 lines
3.4 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.
# 待确认与补充问题
这些事项会改变用户资产、玩法和部署结果。文档中的建议不是已确认需求;
本轮初始化和保全不依赖它们,正式业务实现前需收敛关键项。
| 决策 | 建议起点 | 为什么要确认 |
|---|---|---|
| 农场归属 | 每个独立部署自有数据;群共享范围明确配置 | 决定注册唯一键、偷菜范围与迁移 |
| 多框架关系 | 先支持分别部署和迁移,不自动在线互通 | 联机会改变存储与服务架构 |
| 账号迁移 | 显式平台命名空间与人工确认映射 | QQ 官方标识与 OneBot ID 不宜自动合并 |
| 存量资产 | 默认保留并记录异常,另议补偿 | 旧逻辑有增发,无法从余额准确逆推 |
| 外部金币 | 真寻保留可选接入;其他框架默认关闭 | 外部钱包无法由本地事务保证原子性 |
| 点券和星级 | 先核对现有用途、成本与升级公式 | 涉及经济平衡与数据兼容 |
| 签到资源 | 首先保证内置/本地配置可用,联网更新可选 | 远程服务停机不应让基本玩法不可用 |
| 资源分发 | 精简基础资源;需要时使用固定版本扩展包 | 旧资源 ZIP 超 AstrBot 16 MB 市场限制 |
| 渲染 | 文本必备,图片可选且失败降级 | 宿主、字体、浏览器依赖和性能不同 |
| 兼容基线 | 保留旧指令清单;Python/宿主版本经矩阵实测确定 | 旧 README 的 3.10+ 不等于三框架共同最低版本 |
| 发布顺序 | 真寻先稳定,之后普通 NoneBot、AstrBot | 利用现有宿主验证闭环,控制变更范围 |
| 发布仓库 | 使用给出的三个现有仓库,接管前比较现有代码 | 三仓库不为空,不能直接覆盖 |
| 主仓库远程 | 已明确 Shu-Ying/main_plugin_farm | 本轮只建本地 Git,不误用发布仓库 |
| 发布授权 | 首次候选 PR 审查,稳定后再议自动发布 | 本轮未授权远程覆盖、推送或发布 |
| 跨平台 OS | 建议 Windows + Linux;macOS 有需求再验收 | 路径大小写、字体、浏览器和时区需分别测试 |
| 素材许可证 | 核对图片、字体、HTML 和借用工具来源 | 代码 GPLv3 不自动证明所有素材可分发 |
| 数据运维 | 定期备份、保留策略、恢复演练和脱敏诊断 | 游戏资产需要可恢复性和隐私保护 |
## 容易遗漏的技术约束
- 从旧仓库自动更新到新布局时,插件安装器是否删除旧文件;
旧入口残留可能重复加载,必须进行“旧版→新版”真实升级演练。
- 多目标发布可能部分成功,需要按目标重试和状态清单。
- 插件降级不等于 schema 降级;必须定义最低可读写 schema。
- 网络重试、平台重复投递、图片发送失败不能再次发奖或扣款。
- 资源目录只读部署场景必须支持,把可写缓存放宿主数据目录。
- 同一宿主同时安装相关插件时,模块名称和第三方依赖可能冲突;
插件私有打包只解决前者。
- Python、宿主框架、数据库 schema、作物规则和资源版本分别记录,
不混用一个远程浮点版本比较所有兼容关系。
- 发布仓库里的现有 star、issue、tag 和许可证要保留;不能 force push。
- 子仓库是概念上的发布仓库,不使用 git submodule,也不把本地克隆
提交进主仓库。
- CI 中的密钥不写源码;旧源码中暴露的服务令牌需服务端轮换。