不看网站源码,也能做出插件
插件 API 1.2.0:36 个扩展点、32 个平台函数、 21 条自检规则全部写进了「插件契约」,可以直接查询、生成与自检。 你只需要会一点 PHP。
三步走:从零到一个能提交的插件
平台把「有哪些钩子、怎么写才对」做成了可查询的契约与工具,你不需要读万能墙源码。
生成起始包
一份能直接跑的骨架:清单、入口、生命周期、后台页、前台页、静态资源、README,全部带中文注释。
php backend/plugin_new_cli.php my_plugin --name="我的插件" --caps=db,admin_ui
查扩展点
全部钩子(含参数、返回值、可复制示例)、能力清单、plugin.json 字段规范、SDK 函数与自检规则。
GET https://wall.lhuiye.cn/api?action=plugin_contract§ion=hooks第 1 步 · 生成起始包
生成的是一个**可以直接跑**的插件目录:plugin.json(清单)、plugin.php(入口)、
lifecycle.php(安装/卸载)、views/(后台页与前台页)、assets/(静态资源)、
README.md,每一处都有中文注释和 TODO 标记。
方式 A:浏览器里生成(不需要服务器权限)
填插件标识、名字、需要的能力,点一下就下载 zip;解压后放到站点的
backend/plugins/ 目录,或在万能墙后台「插件管理 → 上传安装」。
方式 B:命令行生成
php backend/plugin_new_cli.php my_plugin \
--name="我的插件" --author="你的名字" \
--caps=db,admin_ui,front_ui --api --shortcode
db 自建数据表 · files 文件与静态资源 ·
http 外部请求 · mail 发邮件 · admin_ui 后台页面 · front_ui 前台页面与注入。
详见扩展点全表。
第 2 步 · 查扩展点(契约)
钩子名、参数顺序、返回值、起始版本、示例代码,全部来自**平台自己生成的契约**, 所以不会出现「文档写了、平台没有」的情况。两种查法内容完全一样:
section=hooks|sdk|manifest|lint_rules|digest。
请求接口 ↗
SDK 函数速查
设置读写、自建表、外部请求、日志、定时任务…每个函数都有签名与示例。
查看函数 →
清单字段与自检规则
plugin.json 每个字段的规范,以及自检会报的规则编号。
查看规范 →
最长用的几个钩子
plugin_render_footer页面注入区(</body> 之前):注入 JS、悬浮组件(灵动岛、客服按钮) filter
$html, $payload
post_created帖子发布成功(已过审核、已入库)。 action
$postId, $userId, $content
post_card_html信息流里「单张帖子卡片」的 HTML(渲染完成后)。可以加徽章、加按钮、改样式。 filter
$html, $post, $comments
feed_posts信息流接口返回的帖子数组(分页之后、编码之前)。可以加字段、按自定义规则重排。 filter
$posts, $ctx
post_publish_guard发帖前的最后一道守卫:可以否决本次发布(例如自己实现更严格的规则、限制特定用户群)。 filter
$allow, $payload
api_response所有 API 响应在 JSON 编码前触发。用来给响应统一加字段(如客户端要求的标记)、改写 filter
$data, $action
第 3 步 · 上传前自检
自检用的就是**提交审核的同一套规则**:过了自检,提交就不会再因为包本身的问题被拒。
方式 B:在站点上自检(更全)
php backend/plugin_lint_cli.php backend/plugins/my_plugin # 目录
php backend/plugin_lint_cli.php ~/my_plugin.zip # 压缩包
插件开发资料包(离线可查,也可以交给你自己的工具)
下载 插件开发资料包:里面是开放平台的**全部教程、注意事项、开发手册、机器可读契约、起始包与官方示例插件**。 你可以自己离线查阅照着手写;也可以把整个文件夹交给**你自己习惯的 AI 助手**当上下文,让它按规范产出可安装的插件。
说明:万能墙开放平台**不提供任何 AI 服务**,也不绑定任何 AI 厂商;资料包只负责把规范整理好,用不用工具、用哪个,由你决定。
参考这个资料包,帮我做一个万能墙插件:
标识 study_checkin,名字「自习打卡」,
功能:每天可打卡一次、显示本月打卡日历;
需要:自建表、后台统计页、前台页面、一个查询接口。
ASSISTANT-BRIEF.md 是可选的一份"规则书"(可用钩子名单、必须遵守的约束、文件清单与交付要求),
要交给自己的 AI 助手时附上它即可;不用 AI 的话,看 plugin-dev-manual.md 与
example/demo_toolkit/ 也完全够。
新手最容易踩的坑
function ($html, $payload = [])echo 会污染 JSON 或页面结构
只 echo 不 return 会清空页面
平台会提升为全局,但别依赖它
安装时插件入口还没加载
不要直接写核心表
其它目录不会被放行