[开发] FlintHub 插件开发规划 · 总索引20261031

文档集版本：2.0 · 更新日期：2026-10-30 · 状态：有效 代码基线：FLINTHUB_VERSION = V1.3.1（version.php:8） 编写依据：docs/插件开发规范.md v1.7（2026-10-21） 本次修订：对 28 份原始方案做存量能力比对，给出定级结论，并按开发文档标准重整结构。

1. 这套文档怎么用

本目录不是「待办功能清单」，而是经过存量盘点后的决策文档集。站点已有 88 个插件，核心能力在 V1.3.1 也已补齐多轮，因此原始 28 份方案里有相当一部分与现状重叠。开工前必须先看定级结论，再决定是否动手。

2. 定级总表（28 项）

四类结论，含义见 02-开发文档规范 §3。

2.1 可直接开发（13 项）——站点无等价能力，方案可原样落地

2.2 需要插件增强（8 项）——不新建插件，改扩建现有归口

2.3 需要重新制作（2 项）——现有实现语义错误，扩建不如重写

2.4 不做 / 暂缓（5 项）

3. 建议推进顺序

定级之后只剩 23 项有效方案，按「补缺口 → 低成本高感知 → 重活」三档推进。

第 0 批  修语义（先做，避免带病扩张）
  16 短信服务重制（第三方登录的短信通道当前不可用）
  28 备份补插件库（70 个插件库 + uploads 不在核心备份范围，是真实风险）
  27 VIP 时长制（points_mall 永久换组会污染用户组）

第 1 批  安全与内容底座
  01 两步验证 → 12 问卷 → 02 工单

第 2 批  低成本高感知（增强类优先，改动面小）
  22 私信会话层 → 23 关注动态流 → 24 编辑历史版本链
  20 相关推荐面板 → 07 图鉴册 → 26 通用打赏

第 3 批  运营与外部分发
  10 抢楼 → 14 RSS → 15 Webhook → 18 相册

第 4 批  重活（最后）
  08 拍卖 → 09 聊天室 → 19 百科 → 17 WebPush → 06 群押池 → 11 生日 → 21 时光胶囊

4. 跨方案共性结论（规避重复踩坑）

盘点过程中确认的、多份方案共享的运行时事实，动手前不必再核一遍：

⚠️ 两套关注并存且列名不同：user_profile.user_follows 用 followed_id，suiyu.sy_follows 用 followee_id，是两张互不相通的表。做 23 时必须先决定以哪套为准，否则会出现「主页显示已关注、suiyu 动态流里没有」的割裂。

5. 文档集结构

插件开发规划/
├── README.md                     ← 本文件：索引 + 定级总表 + 推进顺序
├── 00-通用合规基线.md            ← 28 项共用的硬规则与验证基线（[B*] 编号）
├── 01-规划定级台账.md            ← 逐项定级结论、依据、证据位置、处置动作
├── 02-开发文档规范.md            ← 一份方案的标准结构、状态口径、评审要点
├── plans/                        ← 28 份方案正文，统一前置元信息块
│   ├── 01-twofactor-两步验证.md
│   └── ...（按编号 01~28）
└── _archive/
    └── original/                 ← 盘点前的原始 28 份 + 旧 README，只读留档