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

Halo 站点知识库设计分类与标签：分类按工作线划分，一级8个、二级20个，最长3级，每篇1个主分类；标签小写单数短横线，首批45个，单篇2~5个，全站上限50。实测20个二级分类为空且与一级平铺，前台曾列29个分类入口、28个空页，现全部隐藏，入口降至9个，首篇文章后恢复。分类与标签同slug可共存，显示名不得重复；3组完全同名分类已改显示名，未删分类标签，slug和旧链接不变。另建38节点知识库树，7顶级、3层，先占位发布。

Halo 2.x 插件选型调研确认，目标实例 Halo 2.26.1 满足 AI Foundation、智阅全能AI助手、MiniDocs、项目集的版本门槛。四者真实插件名为 ai-foundation、summaraidGPT、halo-plugin-minidocs、portfolio；智阅依赖 AI Foundation，MiniDocs、项目集独立。实例已启用 AI Foundation 1.1.0，但仅配 DeepSeek 语言模型，无 Embedding，导致 RAG、向量检索和前台访客问答当前不可用。AI Foundation 只是模型接入与调用底座，不含知识库、分块、向量库和前台页面，搜索仍为 Lucene 关键词。选型应先配语言与 Embedding 模型，再装智阅；版本以 Releases 或市场为准，不能信 plugin.yaml 的 version。

Halo Pro 2.26.1 实例的镜像 tag 2.26 为滚动标签，升级/回滚应锁 digest，镜像回滚不等于数据库回滚。Docker 日志已轮转，halo.log 无轮转，需用 logrotate 的 daily 加 maxsize 20M，避免 size 覆盖 daily；备份改用用户级 crontab，健康检查已启用并修正重启误报。项目集真实路由为 /portfolio，已新增“文档”“项目”菜单及 skills、timeline 页面，清理 7 个主题演示字段；但项目、技能、履历数据仍为空，external-url 实际生效公网域名故未改。前台匿名路径均 200，API 仍需登录。可据此避免版本漂移、日志漏轮转与告警误报。

Halo文章正文为HTML，MiniDocs为Markdown，因而Halo用HTML模板，MiniDocs与仓库.md用Markdown模板；Halo原生文章无front-matter，宜用正文元信息块记录版本、验证时间与环境。模板覆盖排错、README和教程长文，长文以H2为主章节并自动生成目录。代码高亮需正确标注语言，提示用引用块，图片和封面经编辑器或文章设置上传。附录A称本次纯文档整合零改动，产出README总纲，冲突以专项报告为准；验收含密钥零命中、分类标签73条断言、38个文档、44项回读和34表恢复，第3步为唯一写操作。

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

如果你看到了这一篇文章，那么证明你已经安装成功了，感谢使用 Halo 进行创作，希望能够使用愉快。