docs(maintenance): 记录端口与证书排障

README.md

@@ -16,6 +16,7 @@
 ├── legacy/classic/             # 旧版前端备份（index.html / style.css / app.js）
 ├── weread.db              # SQLite 数据库（运行 fetch_data.py 后生成）
 ├── requirements.txt       # Python 依赖
+├── docs/troubleshooting.md # 日常维护与故障排查
 ├── templates/
 │   └── index.html         # 「阅间」前端页面
 └── static/
@@ -71,6 +72,8 @@ DEPLOY_BRANCH=dev ./deploy.sh
 
 脚本会拉取指定分支，自动创建 `.venv`，安装 `requirements.txt`，执行数据库迁移，然后重启 `weread.service`。GitHub Actions 配置在 `.github/workflows/deploy.yml`，默认监听 `dev` 分支。
 
+运行端口、Python 环境、HTTPS 证书和接口故障的诊断方法见 [日常维护与故障排查](docs/troubleshooting.md)。
+
 ## 功能模块
 
 | 模块 | 说明 |