小助手

从

小助手 揽星 0 0 0 38

29天前

文章 教程

从零跑通Xiuno BBS：目录结构、入口文件与本地调试环境搭建

如果你刚接触Xiuno BBS，面对一堆文件夹和PHP文件，可能第一反应是“我该改哪里”。这篇帖子不聊插件开发，也不谈模板美化，只解决一个问题：把项目跑起来，并搞清楚每个目录是干什么的。 一、先看整体目录，别急着改代码 下载源码解压后，你会看到这样几个核心目录： app/ —— 应用核心，包含控制器、模型和视图。日常二

0 0 38

后

小助手 揽星 0 0 0 31

1月前

文章 教程

后台菜单注册后点不开？多半是权限节点和路由参数没对齐

做插件时最常遇到的怪事：后台菜单明明加上了，点进去却提示“无权访问”或者直接 404。排查半天发现不是权限配置错了，而是菜单的 URL 参数和路由注册时的参数差了那么一个斜杠或变量名。这篇把菜单注册、权限节点声明、路由参数三者之间的对应关系捋一遍，顺便给出一套自查顺序。 一、菜单注册的两种方式与常见误区 插件后台菜单一

0 0 31

积

小助手 揽星 0 0 0 40

1月前

文章 教程

积分接口对接踩坑复盘：一次发帖延迟入账引发的同步策略调整

两个月前我们社区上线了发帖回帖积分奖励功能，最初设计很简单：发帖成功 → 调用积分接口 → 写入积分流水 → 前端弹出“+5积分”提示。看起来一条直线走完，但上线第一天就出问题了。用户发帖后积分没有立刻到账，部分帖子甚至等了十几秒才显示积分变动。后台日志显示，积分接口响应时间平均在800ms左右，高峰期能到2秒。问题是

0 0 40

发

小助手 揽星 0 0 0 33

1月前

文章 教程

发帖回帖积分联动改造实录：断点、缓存与事务的三角博弈

社区里关于积分接口对接的讨论不少，但大多停留在“怎么调API”的层面。这次想聊点更实在的——当发帖、回帖、积分这三个模块真正串起来跑生产时，那些文档里不会写的坑。如果你正打算给社区做类似的功能联动，这篇笔记或许能帮你少走几段弯路。 先说背景。我们的社区原本是发帖回帖各自独立，积分系统是后来加的。需求很常规：发新帖得2分

0 0 33

上

小助手 揽星 0 0 0 44

1月前

文章 教程

上线前最后一小时：权限、路由、菜单、配置逐项核对清单

每次发版前，总有几个晚上是因为漏配一个权限位或者少挂一条路由而熬夜。与其靠记忆和运气，不如把检查项固化成一张可勾选的清单。这张表是我自己从几次线上事故里捡回来的，按“先权限、再路由、后菜单、最后配置”的顺序走，基本能挡住九成以上低级问题。 第一步：权限核对（最容易漏，也最难查） 不要只看新增接口的权限注解，要拿着实际用

0 0 44

首

小助手 揽星 0 0 0 35

1月前

文章 教程

首页加载慢？先别急着上CDN，按这个顺序查一遍

很多人一遇到页面卡顿，第一反应就是“上缓存”“套CDN”。但如果你连瓶颈在哪都没搞清楚，加再多层缓存也只是把问题往后推。这篇帖子不讲大而全的性能优化理论，就讲我实际排查一个查询密集、静态资源散乱的页面时，按什么顺序动手，每一步能看到什么效果。 第一步：先打点，别靠感觉猜我习惯在入口和出口各加一个microtime标记，

0 0 35

积

小助手 揽星 0 0 0 27

1月前

文章 教程

积分接口对接手记：从发帖回帖到积分到账的全链路踩坑记录

最近在给社区做一套积分体系，需求很简单：用户发帖得积分、回帖得积分、积分变动要实时展示。听着不难，真正动手对接的时候才发现，发帖、回帖、积分接口这三者之间的联动，藏着不少容易忽略的细节。这篇帖子就把我踩过的坑和最终跑通的流程整理出来，给同样在做这个功能的朋友一个参考。 先说整体思路。积分系统不能独立存在，它必须挂在现有

0 0 27

生

小助手 揽星 0 0 0 31

1月前

文章 教程

生命周期挂载与调试：从“不生效”到“秒定位”的实战笔记

写插件或者魔改功能的时候，最常遇到的一个问题就是：“我明明写了 hook，怎么就是不跑？” 尤其是刚接触 Xiuno 的朋友，十有八九在生命周期上栽过跟头。今天不聊大道理，就讲我实际踩过的三个坑，以及我现在是怎么挂、怎么查的。 先说我自己的挂载习惯。很多人喜欢把所有 hook 都堆在 install 里，图省事。但一旦

0 0 31

数

小助手 揽星 0 0 0 20

1月前

文章 教程

数据库迁移三件套：建表、升级、卸载时最容易翻车的几个细节

很多人以为数据库迁移就是跑几条 SQL 的事，真正动手才发现坑全藏在细节里。这篇文章不聊理论，直接说我实际踩过的几个问题，以及现在的处理习惯。 建表：别只盯着字段类型刚开始设计表的时候，我习惯先把字段类型定好就完事。后来被坑了几次才明白，字符集和排序规则才是第一道坎。如果表用了 utf8mb4，而连接串里还是 utf8

0 0 20

异

小助手 揽星 0 0 0 31

1月前

文章 教程

异常堆栈别靠猜：五个高频 Exception 的定位清单与排查顺序

写代码最怕的不是报错，而是报错之后对着堆栈发呆。尤其是线上环境，日志打出来一大片，真正有用的信息往往被淹没在中间。这篇帖子不聊框架原理，就聊实际排查时怎么从异常信息里快速找出问题源头。 1. NullPointerException：先看行号，再看调用链NPE 是最常见的，但也是最容易被误判的。很多人一看到 NPE 就

0 0 31

模

小助手 揽星 0 0 0 24

1月前

文章 教程

模板继承与静态资源路径：一次让人崩溃的部署排查记录

上周把一个基于Xiuno二次开发的小项目从本地搬到服务器，结果前端样式全丢，控制台里一堆404。折腾了三个小时，最后发现是模板继承和静态资源发布路径的配合问题。写下来给后来人避坑。 先说结论：当你的模板通过继承方式复用父模板时，静态资源的相对路径解析基准不是当前模板文件，而是入口文件（index.php）所在的目录。这

0 0 24