说说 · 使用说明

朋友圈式的短内容插件：会员可以像发朋友圈一样发布文字与图片，支持公开 / 仅自己可见、图片九宫格、评论与回复，并提供 flomo 风格的记录 API。

• 插件标识：shuoshuo
• 前台地址：/shuoshuo
• 后台地址：/admin/shuoshuo
• 数据表：zsensshuoshuopost、zsensshuoshuocomment

一、安装与启用

1. 后台进入「插件」列表，找到「说说」，点击安装。
2. 安装时会自动创建数据表、注册后台菜单与权限规则，并生成一个 32 位 API 令牌。
3. 安装完成后到「插件 → 说说 → 配置」确认开关状态，前台访问 /shuoshuo 即可使用。

卸载会删除 zsensshuoshuopost、zsensshuoshuocomment 两张表及插件菜单，数据不可恢复，操作前请先备份。

二、前台使用

发布说说

• 登录会员在页面顶部看到发布框：输入文字（最多 maxchars 字，默认 5000）、添加图片（最多 maximages 张，默认 9）、切换「公开 / 仅自己」后点击发布。
• 图片会即时上传并显示预览，可逐张移除。
• 正文与图片至少填写一项；发布有 5 秒防连发限制。

浏览与筛选

• 「全部」只展示公开的说说；「我的」展示自己发布的全部内容（含仅自己可见）。
• 超过 6 行自动折叠，可点「展开全文」。
• 点击图片可打开大图预览，支持左右切换、Esc 关闭。

评论与回复

• 每条说说底部有「评论」按钮，括号内为评论数量，点击展开评论区。
• 登录后可发表评论（最多 500 字，5 秒防连发）；点某条评论的「回复」可针对其回复，界面显示「回复 @某人」。
• 回复的回复会自动归到该条根评论下，保持「评论 + 回复」两层结构。
• 游客可以浏览评论，但会看到「登录后参与评论」的提示。

删除权限

删除一条说说会同时清除它的全部评论；删除根评论会连带删除其下所有回复。

三、后台管理

后台「插件 → 说说」提供列表与编辑功能：

• 列表：按关键词（正文 / 作者）、可见性、状态、来源（会员 / 后台 / API）筛选，分页展示缩略图、图片数、来源与时间。
• 新增 / 编辑：可设置正文、图片（逐行填写地址，或通过多文件上传自动追加）、作者昵称与头像、可见性、显示状态。
• 操作：显示 / 隐藏单条说说、批量删除（同时清理评论）。

四、插件配置项

「顶部导航入口」默认关闭，插件启用后不会自动往导航栏加按钮；需要入口时在配置里打开即可（要求主题支持 baractionsbefore_post 钩子）。

五、记录 API（flomo 风格）

接口地址：POST /shuoshuo/api

鉴权方式（三选一）

1. 请求体字段 token 或 api_token
2. 请求头 X-Shuoshuo-Token: <令牌>
3. 请求头 Authorization: Bearer <令牌>

令牌在「插件 → 说说 → 配置 → API 令牌」中查看；更换后所有已接入的工具都要同步更新。

请求参数

\* 正文与图片至少提供一项。

响应示例

{"code":1,"msg":"已发布","data":{"id":128,"url":""}}

失败时 code 为 0，msg 说明原因（令牌无效、今日写入已达上限、正文超长等）。

调用示例

# 表单方式
curl -X POST 'http://example.com/shuoshuo/api' \
  -d 'token=你的令牌' \
  -d 'content=今天也要加油'

# JSON 方式（含图片）
curl -X POST 'http://example.com/shuoshuo/api' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer 你的令牌' \
  -d '{"content":"随手拍一张","image_urls":["https://example.com/a.jpg"],"visibility":1}'

接入第三方工具

在 iOS「快捷指令」/ Android「HTTP Request」/ 自动化工具中，新建一个 POST 请求：

• URL：https://你的域名/shuoshuo/api
• 请求头：Authorization: Bearer 你的令牌
• 请求体（JSON）：{"content":"<要记录的文字>"}

即可实现「随手一记，自动同步到站点」。

六、数据结构

zsensshuoshuopost（说说）

zsensshuoshuocomment（评论）

七、常见问题

Q：前台打不开 /shuoshuo？

确认插件已安装且在配置中「启用说说」为开启状态。

Q：导航栏没有「说说」入口？

默认不显示，属于预期行为。到「插件 → 说说 → 配置」打开「顶部导航入口」。

Q：API 返回「令牌无效」？

检查请求体 / 请求头中的令牌是否与配置页一致，注意不要带多余空格；更换令牌后旧工具需同步更新。

Q：API 返回「今日写入已达上限」？

已在「API 每日上限」达到当日条数（默认 100），可调大数值或填 0 取消限制。

Q：会员发不出说说？

检查「会员可发布」是否为开启状态、正文是否超出字数上限、是否在 5 秒防连发间隔内。

Q：评论显示「评论功能已关闭」？

配置中「开启评论」被关闭，重新开启即可。

Q：静态样式不生效？

插件安装时会把样式复制到 public/static/shuoshuo/。若手动修改过 plugins/shuoshuo/static/shuoshuo.css，需同步复制到该目录并刷新浏览器缓存。