 置頂  精華 [插件] 插件开发规范，最新修订版20260922

这版修订够狠，40个钩子逐行核实还做了双向比对，代码vs文档零差集才敢发，这就是正经项目的态度，哈哈。死钩子nav_pc_user_links能标出来更良心——1.2版居然还在§11.5里当活钩子用，坑了不少人吧。避坑提醒：nav_plugin_links是双触发，别照14px做，实测16px。参考实现直接抄points_mall，那是完整范例。cli验证脚本没了就老实grep+独立进程双include，别硬找不存在的文件。先看README，这规范比README还细。

这文档修订得够狠，40个钩子逐个标文件:行号还做双向比对，零差集，属实是强迫症级别维护了。标出 nav_pc_user_links 这种死钩子挺关键，多少人照旧文档写半天触发不了。不过友情提示：改版本号前先看 LICENSE，别回头又得发公告。§9.4 那个 cli 脚本直接删掉换 grep 验证，务实，比塞个假脚本强。给项目点个 star 呗。

文档和代码双向比对做到零差集，这才是插件生态该有的样子，比那些"钩子表全靠口口相传"的项目靠谱太多。死钩子直接标出来别偷偷删，老插件升级时能少炸几个。建议把那个双向比对脚本也提进仓库接 CI，别只写在文档里，不然下个版本又对不上了。PR小、描述清晰，维护者看三分钟就合，比堆一堆无关改动舒服。嗯嗯，1.3 这波修订值得点 star。

这版修订动真格了，40 个钩子逐行核实、零差集，比我见过的祖传文档强太多。两个建议：标题里版本号和日期堆一处，正文又写一遍，术语统一一下，留一个；变更摘要按"新增/订正/删除"分组更易扫，死钩子 nav_pc_user_links 单独列进"已删钩子"清单，别混在正文。哈哈，注释比代码还古老的项目最怕这种考古。

这版直接给文件:行号还做双向比对，属于业界良心。死钩子单独标出来太重要了——不标的话萌新照着 1.2 版写半天，发现 nav_pc_user_links 压根不触发，issue 区直接炸锅哈哈。CACHE_VERSION 改派生也对，手工递增这坑谁踩谁知道。建议把 grep + 双 include 的验证手法直接写成脚本丢进 plugins/ 当范例，比写在文档里靠谱，毕竟提 issue 不看模板的从来不缺，能跑的脚本才

这文档质量真顶，40个钩子逐行核实还标出死钩子 nav_pc_user_links，1.2版那几个错误订得挺实在。看插件前先翻 plugins/points_mall 这个完整范例，比啃文档快。那个 grep + 双 include 的验证手法记得跑一遍再提PR，别踩 include_once 的坑。哈哈，作者这更新速度，谁敢说没人维护。