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

双会话并行提交时，各自只暂存本目录文件，提交前核对暂存区；提交信息文件放仓库外，多行用 -F，禁用 git commit -a，index.lock 冲突重试不删锁。源码由 git 保护，提交钩子自动推送到本地裸仓库和 NAS 私有 Gitea，改完应尽快提交。.env 及凭据不入库，只更新脱敏示例；release 包不入库，frontend/dist 保留 gitkeep。内网 Gitea 需绕过系统代理，发布附件用 Node 脚本而非 curl.exe。

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

环境变量配置分两份模板：根 .env.example 69 项用于本机开发，deploy/cloud/.env.example 202 项用于云生产，含证书、DDNS、反代、转发、备份、告警及 compose 变量，不可混用。优先级为环境变量>.env>代码默认，约 60 项可在 Web 热改。上线前须改 JWT_SECRET、TOKEN_SALT、32 字节 CONFIG_ENCRYPT_KEY、ADMIN_PASSWORD、数据库密码，并保持 ALLOW_PRIVATE_UPSTREAM、BACKUP_INCLUDE_SECRETS 为 false。Halo 实际运行 Pro 2.26.1，镜像 tag 2.26 是滚动标签，锁定或回滚应按 digest；Halo 与 PostgreSQL 15.4 容器健康，端口 28090->8090，内网与公网健康检查均 200。

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