俗世客的思行小筑

已废弃方案留档

Administrator — Sun, 13 Sep 2026 14:38:40 GMT

来源：halo-kb/知识库架构设计.md → C.4 批量导入本地 Markdown 的可行路径（原文 1430 字符） C.4 批量导入本地 Markdown 的可行路径已核实的结论：导入是可行的，但有明确边界。排序路径端点/命

数据库类

Administrator — Sun, 13 Sep 2026 14:38:38 GMT

来源：intranet-tunnel/docs/docker-build.md → 六、数据库外部访问（Navicat / DBeaver / pgAdmin）（原文 1233 字符）六、数据库外部访问（Navicat / DBeaver

网络与域名类

Administrator — Sun, 13 Sep 2026 14:38:37 GMT

来源：intranet-tunnel/docs/AGENTS-ARCHIVE.md → ⚠️ 排障时容易自设陷阱的两个点（原文 670 字符） ⚠️ 排障时容易自设陷阱的两个点 1. curl --resolve <域名:443:127.0

容器与部署类

Administrator — Sun, 13 Sep 2026 14:38:34 GMT

来源：intranet-tunnel/docs/AGENTS-ARCHIVE.md → 服务端服务全面检查（2026-09-12 实操）（原文 3081 字符）服务端服务全面检查（2026-09-12 实操）不用登面板点页面，直接走 A

提交与备份纪律

Administrator — Sun, 13 Sep 2026 14:38:32 GMT

来源：intranet-tunnel/docs/mobile-parallel-work.md → 五、提交纪律（两个会话都适用）（原文 460 字符）五、提交纪律（两个会话都适用） - 提交前用 git status --short 确

API 契约与字段核对

Administrator — Sun, 13 Sep 2026 14:38:29 GMT

来源：intranet-tunnel/docs/mobile-api-contract.md（整篇）（原文 17270 字符）移动端 App —— 服务端接口契约（v1.0.6 起）本文件是服务端与移动端之间的冻结契约。两端按本文件并行

前端与客户端约定

Administrator — Sun, 13 Sep 2026 14:38:26 GMT

来源：intranet-tunnel/docs/ui-refactor.md（整篇）（原文 17732 字符） Web 管理端 UI 现代化改造说明本文件记录本次「UI 现代化 + 图形验证码 + 短信验证码登录」改造的范围、约定与回滚方

Go 服务端约定

Administrator — Sun, 13 Sep 2026 14:38:25 GMT

来源：intranet-tunnel/docs/AGENTS-ARCHIVE.md → 两步验证（2FA）从「形同虚设」到真正生效（v1.0.6，2026-09-13）（原文 3695 字符）两步验证（2FA）从「形同虚设」到真正生效（v

数据备份与恢复演练

Administrator — Sun, 13 Sep 2026 14:38:23 GMT

Halo 备份须三层齐备：数据库 pg_dump、halo2 文件、compose/env 配置，缺一难恢复；插件、主题、keys 不在库中，keys 丢失 PAT 失效。默认不停机，库与文件非同一时间点，窗口不足 6 秒，目前无附件。演练约 5.5 秒完成，sha256 校验通过；恢复验证用临时库，生产库未写入，以表数 34、extensions 行 391 相等为判据，不能只看 pg_restore 无报错。恢复生产要先备份现状、停 Halo、恢复库和文件、起服务并健康检查。最大缺口是备份与生产同卷、无异地副本。运维每日查健康与备份新鲜度，每周恢复验证和校验，每月异地副本、完整演练、digest 与权限复核，匿名用户接口必须 302。

内容体系与分类标签规范

Administrator — Sun, 13 Sep 2026 14:38:20 GMT

来源：halo-kb/知识库架构设计.md → A 分类（Categories）体系（原文 6838 字符） A 分类（Categories）体系 A.1 设计原则原则说明 ------ 一层一个"工作线" 一级分类不是技术名词，而是你

主题与插件清单

Administrator — Sun, 13 Sep 2026 14:38:18 GMT

来源：halo-kb/插件选型调研.md（整篇）（原文 29071 字符） Halo 插件选型调研 — AI 个人技术知识库调研对象：Halo 2.x 插件生态目标实例：http://<内网IP:28090（站点「俗世客的思行小筑」）

部署与升级

Administrator — Sun, 13 Sep 2026 14:38:15 GMT

来源：halo-kb/实例现状基线.md → A Halo 版本与运行形态（原文 4821 字符） A Halo 版本与运行形态 A.1 确切版本：Halo Pro 2.26.1 三处独立来源互证，结论确定：证据 1 —— 容器启动日志第

Docker 服务栈清单

Administrator — Sun, 13 Sep 2026 14:38:11 GMT

来源：intranet-tunnel/docs/docker-build.md（整篇）（原文 6354 字符） Docker 镜像构建与部署说明一、构建命令构建上下文必须是仓库根目录（服务端依赖 ../shared 模块）：或用 co

飞牛 OS 使用要点

Administrator — Sun, 13 Sep 2026 14:38:08 GMT

飞牛 OS/Debian 12 的 Halo NAS 脚本提供全量备份、非破坏恢复验证、破坏性恢复、健康检查与定时轮转。备份含数据库、全局角色、halo2、compose/env 和校验清单，只增不改，默认保留 7 份；恢复前先验证，灾难恢复先备份现状，再停 Halo、恢复库和文件。数据库命令须显式走容器内 PostgreSQL，--clean --if-exists 具破坏性。隧道配置上，TUNNELS 仅支持简写且本地地址固定 127.0.0.1，容器须用 TUNNELS_FILE；域名跨客户端占用会被跳过；泛域新隧道云端零改动，改 tunnels.json 重启 tunnel-client，改 client.env 需强制重建容器。

发布与回滚流程

Administrator — Sun, 13 Sep 2026 14:38:05 GMT

来源：intranet-tunnel/release/README.md → 九、版本变更（原文 14908 字符）九、版本变更 ⚠️ 本目录只保留当前版本的归档（服务端 1.1.1 / 客户端 1.2.1），历史版本的 tar/zip

DNS 与 ACME 证书签发续期

Administrator — Sun, 13 Sep 2026 14:38:02 GMT

来源：intranet-tunnel/deploy/cloud/BAOTA-DEPLOY.md → 四、证书：面板自带的 DNS-01 有缺陷，改用 acme.sh（原文 1085 字符）四、证书：面板自带的 DNS-01 有缺陷，改用

宝塔与 nginx 反代

Administrator — Sun, 13 Sep 2026 14:38:00 GMT

来源：intranet-tunnel/deploy/cloud/BAOTA-DEPLOY.md（整篇）（原文 8031 字符）宝塔共存部署记录（2026-09-12 实测）本文记录把 intranet-tunnel 部署到已运行宝塔面板

阿里云 ECS 与 Workbench CLI

Administrator — Sun, 13 Sep 2026 14:37:56 GMT

来源：intranet-tunnel/docs/AGENTS-ARCHIVE.md → intranet-tunnel 云服务器部署（2026-09-12）· 完整版（原文 2191 字符） intranet-tunnel 云服务器部署（2

隧道域名访问异常

Administrator — Sun, 13 Sep 2026 14:37:52 GMT

来源：intranet-tunnel/docs/AGENTS-ARCHIVE.md → .tunnel.sushike.cloud 基础设施（2026-09-12）· 完整版（原文 843 字符） .tunnel.sushike.cloud

域名与证书接入

Administrator — Sun, 13 Sep 2026 14:37:51 GMT

来源：intranet-tunnel/deploy/edge/README.md（整篇）（原文 6509 字符）边缘配置自动同步让「在面板配好一条隧道」到「域名可以访问」之间不再有人工步骤。 --- 它解决什么隧道域名最终是由服务端内