常见问题与排查

适用范围：当前适配 Halo 2.26.0 及以上版本的言答Issue。旧版插件的界面与构建方式可能不同。

安装后没有后台菜单

确认插件已启用且启动正常，再检查账号是否具备 Issue 管理权限。当前版本要求 Halo 2.26.0+；安装旧版或新版时都应以对应插件包的兼容要求为准。

使用后台提供的主体访问链接。格式为 /subject/{subjectName}；subjectName 是系统标识，不是展示名称。将链接加入站点导航即可提供稳定入口。

先切换「全部」状态，检查是否仍保留搜索关键词，再检查主体是否选对。若管理员能看到而访客看不到，继续检查审核状态、可见性及角色权限。

填写标题、描述和模板必填字段。描述为空或正在提交时按钮会被禁用；登录状态或发布权限不足也会阻止创建。提交失败后保留输入内容，查看提示，再确认登录状态，不要连续重复提交。

检查主体参与者、Issue 经办人等人员设置，以及 Halo 通知渠道和接收设置。不能仅根据页面上的「订阅」文字判断已经订阅成功。

主题需要提供 Halo 2.26 的 templates/layout.html 与 html(head, content) 契约。未适配时使用内置兜底布局是正常行为，具体接入方式见主题布局契约。

普通安装用户：确认安装并启用了新插件包，刷新浏览器并检查插件静态资源是否加载成功。

源码开发者：执行 ./gradlew build 或 ./gradlew reloadPlugin，确认日志包含 :issue-static:pnpmBuild，不要只复制旧的 src/main/resources/static/webAssets。详情见自动构建。

重载主题，再清理该主题的模板缓存。主题检测结果与模板解析缓存都需要更新；只保存或删除文件不一定立即生效。

记录 Halo 版本、插件版本、主题名称与版本、访问页面、用户登录/权限情况、复现步骤和报错信息。涉及显示问题时，补充窗口宽度及明暗模式，便于复现。