MiniDocs 批量导入本地 Markdown 可行但边界明确：minidocs-cli 已验证；API multipart 字段与 CRUD 只写 raw 是否致空白未确认；自制 ZIP 不可行，仅支持插件导出 ZIP。导入前知识库须存在，文档默认草稿需发布，CLI 需 PAT。上架应保持 docsme 禁用避免 /docs/* 冲突，本实例主题模板安全；目录折叠未实现，2.26.1 兼容性未专项确认。前台与分享未验证；本次仅建结构，未填正文，未启用批量导入。

文档集记录 Halo 站点建设与内网隧道方案。已完成 Halo 2.26.1 基线、CLI 接通、插件安装、分类标签体系、38 节点 MiniDocs 知识库、页面菜单、Gitea 同步、备份恢复与安全审计。关键结论：访客 AI 问答、编辑器辅助创作、语义增强搜索均不可实现，根因是缺少访客端点、编辑器扩展、embedding 适配器及具体 RAG 检索实现；ai-assistant 因许可证未启用。文档约定用【实测】【推断】【未确认】标注可信度，凭据只用占位符，并给出 5 步最小复现路径；另附内网隧道架构、端口、网关与安全防护等目录。

隧道流量统计恒为0已在v1.0.4修复。根因是1.0.1把公网入口交给内置反代时只搬流量、未搬记账，统计仍只挂在数据面路径。修法是在反代隧道连接上记账，不包ResponseWriter，以覆盖HTTP、SSE、WebSocket，并须共用同一stats.Collector，否则会静默丢弃。验证需访问隧道3次确认增量非0，且未访问隧道仍为0。1.0.1还修复反代规则不自动同步和48080监听冲突，生产compose漂移须回写仓库。