Make site URLs environment-driven

docs/content-sync-guide.md

@@ -43,6 +43,20 @@ npm run rebuild
 cp .env.example .env
 ```
 
+### 2.0 公开 URL 配置
+
+| 变量 | 必填 | 作用 |
+|------|------|------|
+| `PUBLIC_SITE_URL` | 可选 | 站点正式地址，对应 Astro `site` |
+| `PUBLIC_GITEA_URL` | 可选 | 页面里展示的 Gitea 根地址 |
+| `PUBLIC_GITHUB_URL` | 可选 | 页面里展示的 GitHub 地址 |
+| `PUBLIC_BLOG_URL` | 可选 | 页面里展示的 Blog 地址 |
+| `PUBLIC_GITEA_USERNAME` | 可选 | 页面展示用 Gitea 用户名 |
+
+这些变量会进入最终静态页面，因此只应放公开信息。
+
+如果正式域名还没发下来，可以先留空；页面会继续构建，只是不会输出对应外链。
+
 ### 2.1 Gitea
 
 | 变量 | 必填 | 作用 |
@@ -99,6 +113,22 @@ cp .env.example .env
 
 ## 3. 映射文件如何填写
 
+### 3.0 推荐的维护边界
+
+当前建议把以下文件视为 **AstrBot 可维护输入文件**：
+
+- `src/content/projects/index.json`
+- `src/content/seafile/index.json`
+- `src/content/shares/index.json`
+
+推荐工作流：
+
+1. 你在 AstrBot 里编辑项目 / 分享 / 下载配置
+2. AstrBot 更新这些 JSON
+3. AstrBot 执行 `npm run rebuild`
+
+仓库本身只负责消费这些文件，不需要额外引入数据库或在线后台。
+
 ### 3.1 项目种子数据：`src/content/projects/index.json`
 
 每个项目至少包含：

docs/docker-deploy.md

@@ -17,6 +17,11 @@
 
 确保仓库根目录有可用的 `.env`，或在执行 `docker compose` 前导出这些变量：
 
+- `PUBLIC_SITE_URL`
+- `PUBLIC_GITEA_URL`
+- `PUBLIC_GITHUB_URL`
+- `PUBLIC_BLOG_URL`
+- `PUBLIC_GITEA_USERNAME`
 - `GITEA_BASE_URL`
 - `GITEA_TOKEN`
 - `GITEA_USERNAME`