官方开发者文档：🔒 外部链接需 后查看
特点：不会写 PHP 代码也能开发；插件全部为单文件 plugin.php，不允许 zip 打包上传；源码包无插件示例。

重要说明：

  1. 豆包网页版不能访问你的服务器，不能读取服务器 / 本地目录文件；全部开发规则以在线文档 https://bbs1.org/dev_docs 为准。
  2. ✅ bbs1 后台上传插件只接受单文件；plugin.php、plugin.php.txt 均可识别；分享插件市场建议用标准 plugin.php。

前置准备

  1. 浏览器打开官方开发者文档：🔒 外部链接需 后查看，开发遇到钩子、API 疑问随时查阅。
  2. 已经部署好 bbs1 站点，优先在测试网站做插件开发，不要直接上正式生产站。
  3. 打开豆包网页版：https://www.doubao.com/
  4. 准备文本编辑器（记事本 / VS Code），用来保存豆包输出的 plugin.php。

第 1 步：新开对话，发送基础约束提示词（最重要）

新开豆包对话，直接复制发送下面一大段，告诉豆包以在线 dev_docs 作为唯一权威规范：

你是bbs1插件开发专家，唯一权威规范文档：https://bbs1.org/dev_docs。
禁止参考、读取 index.php，不要臆造钩子、API、函数。
bbs1插件全部是单文件 plugin.php，禁止zip打包。
plugin.php 文件头部必须写 if (!defined('APP_ROOT')) exit;
遵循全部约束：命名前缀、N+1数据库性能约束、三数据库兼容SQLite/MySQL/PostgreSQL、manifest完整字段，修改代码必须递增version版本号。
静态CSS、JS全部写在plugin.php内部assets函数，不能依赖外部文件；按需加载使用assets_mode。
收到我的插件需求，只输出完整、可以直接后台上传部署的plugin.php PHP源码，不要多余讲解、前言、说明文字。

发送完成，即可开始提插件需求。

提示：每次新开对话都建议粘贴这段打底提示词，防止 AI 遗忘约束。

第 2 步：固定模板描述插件需求（零基础，大白话）

复制模板，只修改【】中的内容，其余文字不动直接发给豆包：

开发 bbs1 插件：
插件名称：【】
目标页面：【全站 / 帖子详情页 / 首页 / 用户中心等】
面向用户：【所有人 / 仅登录用户 / 仅管理员】
功能描述：【大白话写完整交互、展示效果】
是否需要后台配置面板：【有 / 无】，配置项：【无就删除本行】
是否需要数据库存储数据：【需要 / 不需要】
样式要求：【简洁、跟随主题、移动端适配等】

严格遵循 https://bbs1.org/dev_docs 全部规范；输出完整单文件plugin.php，只输出PHP代码。

可直接测试示例需求（回到顶部悬浮按钮）

开发 bbs1 插件：
插件名称：回到顶部按钮
目标页面：全站所有页面
面向用户：所有人
功能描述：页面右下角悬浮回到顶部按钮，点击平滑滚动回到页面顶部
是否需要后台配置面板：无
是否需要数据库存储数据：不需要
样式要求：简洁小巧，适配移动端，自动适配明暗主题

严格遵循 https://bbs1.org/dev_docs 全部规范；输出完整单文件plugin.php，只输出PHP代码。

第 3 步：保存插件源码文件

  1. 复制豆包返回全部 PHP 代码；
  2. 记事本 / VS Code 粘贴；
  3. 另存：
  • 推荐：文件名 plugin.php，编码 UTF‑8
  • 备选：Windows 记事本生成的 plugin.php.txt，bbs1 后台也可以识别上传。

Windows 注意：关闭「隐藏已知文件扩展名」避免后缀错乱。

第 4 步：bbs1 后台上传、同步、启用插件（仅单文件）

  1. 登录 bbs1 后台 → 插件 → 上传插件；
  2. 选中本地 plugin.php（或 plugin.php.txt）单文件上传，禁止 zip；
  3. 上传完成后执行【同步插件】；
  4. 在插件列表找到插件，点击启用，前台验证功能。

规则：CSS、JS 资源全部内嵌在 plugin.php，通过 manifest 的 assets 注册，不需要外置文件。

第 5 步：报错调试，迭代修改插件

场景 A：插件白屏、报错、功能不生效

复制完整报错文本，加上现象，发送模板：

bbs1插件启用后出现问题：
现象：【按钮不显示 / 帖子页白屏 / 游客正常登录报错】
报错原文：【粘贴完整报错】
对照 https://bbs1.org/dev_docs 规范修复，输出完整新版plugin.php，只输出PHP代码。

场景 B：修改已有的插件

点豆包输入框附件📎上传你的 plugin.php / plugin.php.txt，附带文字：

修改这份bbs1插件：【写清楚修改需求】
版本号version必须递增，严格遵循 https://bbs1.org/dev_docs，输出完整更新后的plugin.php，只输出PHP代码。

第 6 步：分享插件到插件市场（可选）

插件反复测试稳定无报错：
后台 → 本地插件列表 → 点击【分享】，提交单文件 plugin.php 至插件市场审核。

避坑清单

  1. 插件是纯单文件，禁止 zip 打包上传；静态样式脚本全部写进 plugin.php 的 assets。
  2. 修改任意代码（含注释换行），manifest 内 version 版本号必须递增，后台才识别更新。
  3. 严格遵守 N+1 性能约束：帖子、回帖逐条渲染钩子内禁止循环数据库查询，优先批量预取 + 内存映射。
  4. 自定义函数、CSS 类、JS 变量、localStorage 键名，全部带上插件 ID 前缀，避免和其他插件冲突。
  5. 数据库代码兼容 SQLite / MySQL / PostgreSQL，优先用系统封装app_db_*系列函数，不要手写数据库特定 SQL。
  6. 正式网站测试插件务必备份网站与数据库；错误插件会造成页面异常。
  7. 遇到钩子参数、$ctx字段拿不到，打开 🔒 外部链接需 后查看 的 Hooks 与展示位置章节核对，把钩子名称写进你的需求描述。

长期备用完整打底提示词（新开对话一键复制）

你是bbs1插件开发专家，唯一权威规范文档：https://bbs1.org/dev_docs。
禁止参考、读取 index.php，不要臆造钩子、API、函数。
bbs1插件全部是单文件 plugin.php，禁止zip打包。
plugin.php 文件头部必须写 if (!defined('APP_ROOT')) exit;
遵循全部约束：命名前缀、N+1数据库性能约束、三数据库兼容SQLite/MySQL/PostgreSQL、manifest完整字段，修改代码必须递增version版本号。
静态CSS、JS全部写在plugin.php内部assets函数，不能依赖外部文件；按需加载使用assets_mode。
收到我的插件需求，只输出完整、可以直接后台上传部署的plugin.php PHP源码，不要多余讲解、前言、说明文字。

最后由 bbs1 编辑于 2026-10-31 11:44
主楼