白山的技术手记Tech Wiki

Tech Wiki

技术文档总览

由 Markdown 技术文档生成的 wiki 页面。公开版已对敏感服务器信息做占位符脱敏。

返回技术导航 返回首页文章
Source: README.md

本文档集合整理个人站点、Gitea 自建仓库、TS3AudioBot Docker 迁移，以及《回声》项目的技术实现与排障记录。

1. 常用入口

  • 技术博客首页：index.html
  • 技术文章目录：posts/index.html
  • 技术导航页：docs/index.html
  • Gitea 自建仓库：http://<服务器公网 IP>:<Gitea Web 端口>/

公开版说明：本文档已对真实公网 IP、域名、端口、仓库名、个人路径、凭证文件名和数据库文件名做占位符脱敏。需要执行命令时，请替换为当前服务器的真实值。

2. 文档范围

当前文档分为四组：

  • 网站实现层：静态站点结构、样式系统、交互脚本、Mermaid/Prism 集成、页面组织与维护流程。
  • 《回声》项目层：三层 AI-游戏融合架构、Facts 与 Function Calling、Unity 系统接入、论文验证、提示词约束与失败边界。
  • 自建服务运维层：Docker 服务目录、数据卷、备份、恢复、域名、反向代理与 HTTPS。
  • TS3AudioBot 层：Docker 迁移、插件加载、!bili 命令、Bilibili 音频解析链路与排障。

3. 建议阅读顺序

3.1 网站与《回声》

  1. 01-site-implementation.md
  2. 02-content-information-architecture.md
  3. 03-echo-three-layer-architecture.md
  4. 04-echo-facts-and-command-execution.md
  5. 05-echo-unity-systems-integration.md
  6. 06-echo-thesis-validation.md
  7. 07-site-maintenance-guide.md
  8. 08-echo-prompt-role-constraints.md
  9. 09-echo-failure-cases-boundaries.md

3.2 自建服务与运维

  1. ops/01-docker-data-backup-and-restore.md
  2. ops/02-gitea-domain-https-switch.md
  3. Gitea-Docker-Yum-部署与排障技术文档.md

3.3 TS3AudioBot

  1. ts3audiobot/TS3AudioBot Docker 迁移技术文档.md
  2. ts3audiobot/02-plugin-loading-and-bili-command.md
  3. ts3audiobot/03-bilibili-audio-troubleshooting.md

4. 网站源文件映射

核心站点文件：

  • index.html
  • styles.css
  • site.js
  • docs/index.html
  • projects/echo.html
  • posts/index.html

技术内容来源：

  • posts/three-layer-architecture.html
  • posts/facts-function-calling.html
  • posts/play-systems.html
  • posts/experiment-and-thesis.html
  • site-tech-docs/**

静态资源与第三方依赖：

  • assets/img/**
  • assets/vendor/prism/**
  • Mermaid CDN：https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js

5. 当前结论摘要

这个网站是一个以手写 HTML、CSS 和原生 JavaScript 为核心的静态技术站点。它暂时不依赖构建流程，也没有模板引擎，因此维护重点不是“换框架”，而是保持目录、导航、样式和文章入口的一致性。

《回声》内容已经形成“首页入口 -> 项目专题页 -> 技术文章目录 -> 分主题文章”的阅读路径。后续新增专题时，应继续围绕项目技术主线展开，避免把站点变成杂项博客。

Gitea 与 TS3AudioBot 文档则更适合沉淀为“自建服务运维专题”。这类文章的价值不在于介绍概念，而在于保留真实路径、真实命令、真实错误和最小恢复步骤。

6. 维护建议

  • 新增文章时先判断它属于“网站/回声”“自建服务”“TS3AudioBot”哪一组。
  • 面向公网的链接优先放到 docs/index.html，不要散落在多个页面。
  • 涉及 IP、端口、cookies、数据库、权限文件的内容应标注安全注意事项。
  • 若文章数量继续增长，优先抽离 HTML 模板和 Markdown 生成流程，再考虑重构技术栈。