docs: README/部署指南/故障排查记录补全（ai-service、API、权限、踩坑合集）

2026-08-13 17:48:00 +08:00
parent 0c67c2d428
commit 233c0dd0a7
5 changed files with 146 additions and 0 deletions
@@ -613,6 +613,24 @@ MVP 沿用 IoTDB（现状）；TDengine 作为生产规模化候选（先基准

 ---

+## 2026-08-13 文档同步（第二轮）：README / 部署指南 / 故障排查
+
+### 做了什么
+
+- README：API 概览表补 12 组新接口；权限矩阵补 20 个新权限码；新增 12.6 ai-service 本地开发、12.7 开发服务器部署摘要。
+- 部署指南（物理机）：架构图补 ai-service:8000；新增「13. 部署 ai-service」章节。
+- 故障排查处理记录：追加 8 类近期踩坑（NetBird 登录过期/隧道闪断、pip 国内源、rolldown WASM 内存、ETXTBSY、Gin 路由冲突/重复注册/文件覆盖/参数名、PowerShell 中文 JSON、tar 时间戳、SSH 命令后台化）。
+
+### 说明
+
+- 文档按「现状可用」原则更新，详细命令与回滚以 `开发交接记录.md` / 服务器 README 为准。
+
+### 相关提交
+
+`README.md`、`部署指南(物理机).md`、`故障排查处理记录.md`、`变更记录.md`、`开发交接记录.md`。
+
+---
+
 ## 环境与踩坑备忘（新同事必读）

 - **VPN**：开发服务器经 NetBird 访问；服务 Running 后需 `netbird up`，登录走 SSO（管理端 `115.191.19.95:6680`）。