feat: 首页对齐 main SPA 草绿壳与 Feed v2

顶栏搜索胶囊/发帖绿钮/Ctrl+K，侧栏板块色槽，列表 post-row--v2 与 SPA 同密度。 Co-authored-by: Cursor <cursoragent@cursor.com>
feat: 首页门面 Feed 密度与侧栏分组
2026-08-30 06:06:04 +08:00 · 2026-08-30 05:55:45 +08:00 · 2026-08-30 05:43:25 +08:00 · 2026-08-30 05:22:15 +08:00 · 2026-08-30 05:10:23 +08:00 · 2026-08-30 04:54:15 +08:00
330 changed files with 34602 additions and 15684 deletions
--- a/.cursor/rules/build-scripts.mdc
+++ b/.cursor/rules/build-scripts.mdc
@@ -0,0 +1,38 @@
+---
+description: 编译与构建脚本约定（Windows build.bat/ps1、Makefile、跨平台同步）
+alwaysApply: true
+---
+
+# 编译与构建脚本
+
+本分支（`rebuild/gitea-ssr`）：Go 单二进制 + `go:embed` 的 **templates** 与 **public/assets**（由 `web_src` 构建）；产物在 `dist/`。  
+对照 SPA 仅在 `main` 分支。
+
+## 运行编译（优先用封装命令，不要猜命令）
+
+| 平台 | 命令 |
+|------|------|
+| Windows | `build.bat` 或 `build.bat -Target <target>` |
+| Linux / macOS | `make` 或 `make <target>` |
+
+**不要**在 Windows 上直接运行 `make`（系统自带多为 Embarcadero MAKE，不兼容本项目 Makefile）。
+
+Windows 上**不要**让用户直接 `.\build.ps1`（默认 ExecutionPolicy 会拦截）；应通过 `build.bat`（内部 `-ExecutionPolicy Bypass`）调用。
+
+常用 target：`build`（默认）、`dev`、`run`、`web-src`、`clean`、`build-all`、`build-windows`、`build-linux`、`tidy`、`help`。
+
+## 修改构建脚本时的约定
+
+1. **双轨同步**：`build.ps1` 与 `Makefile` 目标与行为保持一致；改其一须同步另一份。
+2. **`build.bat` 仅用 ASCII 注释**：`.bat` 会被 cmd 按 GBK 解析，UTF-8 中文注释会导致整行乱码、`powershell` 无法执行。
+3. **`build.ps1` 可用 UTF-8**：由 PowerShell 执行，中文注释无妨。
+4. **构建顺序**：先 `web_src` 内 `npm run build`（产出 `public/assets`），再 `go build -trimpath -ldflags "-s -w -X main.version=..." -o dist/jiang13 ./cmd/jiang13`。
+5. **入口包**：`./cmd/jiang13`；Windows 产物带 `.exe`。
+6. **本分支无 `frontend/`**：勿再添加 SPA 构建步骤；需要对照 UI 时 `git checkout main`。
+
+## 新增 target 检查清单
+
+- [ ] `build.ps1` 的 `ValidateSet` 与 `switch` 分支
+- [ ] `Makefile` 对应 `.PHONY` 与 recipe
+- [ ] `build.bat -Target help` 说明（help 输出在 ps1 内）
+- [ ] README「快速开始」如需对外暴露再更新
--- a/.cursor/rules/rebuild-gitea-ssr.mdc
+++ b/.cursor/rules/rebuild-gitea-ssr.mdc
@@ -0,0 +1,37 @@
+---
+description: Gitea 式 SSR 重构总则（rebuild/gitea-ssr 分支）
+alwaysApply: true
+---
+
+# Gitea 式 SSR 重构
+
+## 分支
+
+- 功能开发在 **`rebuild/gitea-ssr`**；**不要**把破坏性 SSR 替换推到 `main`。
+- `main` 保留 React SPA，用作对照（checkout / worktree）。
+
+## 渲染
+
+- 公开页（首页、板块、帖详情、用户页等）必须用 **Go `html/template` 服务端渲染完整 HTML**。
+- 禁止为已迁移公开页恢复 React SPA 空壳；禁止「用户 SPA + 爬虫专用 HTML」双轨作为长期方案。
+- JSON `/api` 仅用于交互增强与管理后台，**不得**作为公开页首屏唯一数据来源。
+
+## 架构参照
+
+对齐 [Gitea](https://github.com/go-gitea/gitea) 职责划分：
+
+- `routers/web` — HTML 页面路由
+- `routers/api` — JSON API（原 `handler/`）
+- `routers/setup.go` — 路由总装
+- `templates/` — 模板
+- `web_src/` → `public/assets/` — 渐进增强 CSS/JS
+- `models/`、`services/` — 数据与业务
+- `modules/auth`、`modules/webrender`、`modules/seo` — 横切
+
+本分支**已删除** `frontend/` 与 `embed_static/`；勿再恢复 SPA 生产回落。
+
+细节见 [`docs/rebuild-spec/08-gitea-ssr-architecture.md`](docs/rebuild-spec/08-gitea-ssr-architecture.md)。
+
+## 产品规格
+
+实现功能前按 [`docs/rebuild-spec/README.md`](docs/rebuild-spec/README.md) 阅读顺序核对；业务规则以 `05-business-rules.md` 为准。
--- a/.cursor/rules/rebuild-spec-source.mdc
+++ b/.cursor/rules/rebuild-spec-source.mdc
@@ -0,0 +1,20 @@
+---
+description: 产品规格为唯一业务事实来源
+alwaysApply: true
+---
+
+# 规格文档对照
+
+重构实现时以 [`docs/rebuild-spec/`](docs/rebuild-spec/) 为准，不另发明业务语义。
+
+| 需求类型 | 查阅 |
+|----------|------|
+| 要不要做某功能 | `02-features.md` |
+| 表字段 / 枚举 / settings 键 | `03-data-model.md` |
+| HTTP 路径与 JSON 形状 | `04-api.md` |
+| 审核 / 积分 / 门控 / 悬赏等 | `05-business-rules.md` |
+| 路由与交互信息架构 | `06-pages-ux.md` |
+| 配置与部署 | `07-config-ops.md` |
+| SSR 目录与分支 | `08-gitea-ssr-architecture.md` |
+
+规格与代码冲突时：以**当前分支代码**行为为准，并应回写修正规格。
--- a/.cursor/rules/rebuild-templates.mdc
+++ b/.cursor/rules/rebuild-templates.mdc
@@ -0,0 +1,14 @@
+---
+description: Go HTML 模板约定（SSR）
+globs: templates/**/*
+alwaysApply: false
+---
+
+# 模板约定
+
+- 目录对齐 Gitea：`templates/base/`、`home/`、`post/`、`shared/`、`status/`、`auth/`，根级 `install.tmpl` / `post-install.tmpl`。
+- 页面入口用固定 `{{define "home"}}` / `{{define "post"}}` 等显式 `{{template "base/head"}}`…；**禁止** `{{template .Name}}`（标准库不支持动态名）。
+- **默认转义**；用户 HTML 须先消毒 + 门控后再 `{{safeHTML ...}}`。
+- 静态资源 `/ssr-assets/...`。
+- 浏览器写操作走 `routers/web` 表单 POST + CSRF（`webctx`），不依赖 JSON `/api`。
+- 中文文案可写在模板；站点名等从 PageChrome / settings 传入。
--- a/.dockerignore
+++ b/.dockerignore
@@ -0,0 +1,25 @@
+# Git 与编辑器
+.git
+.gitignore
+.idea
+.vscode
+.cursor
+.trae
+
+# 运行时数据与本地配置
+data/
+app.ini
+tmp-cookie.txt
+
+# 编译产物与依赖缓存
+dist/
+web_src/node_modules/
+public/assets/
+node_modules/
+.vite/
+
+# 文档与截图（不参与镜像构建）
+docs/
+
+# 计划文件
+*.plan.md
--- a/.gitattributes
+++ b/.gitattributes
@@ -0,0 +1,17 @@
+# 跨平台行尾：仓库内统一 LF，避免 Windows autocrlf 造成「假 modified」
+* text=auto eol=lf
+
+# Windows 批处理在 cmd 下需要 CRLF
+*.bat text eol=crlf
+*.cmd text eol=crlf
+
+# 二进制
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.webp binary
+*.woff binary
+*.woff2 binary
+*.exe binary
--- a/.gitea/ISSUE_TEMPLATE/bug_report.yaml
+++ b/.gitea/ISSUE_TEMPLATE/bug_report.yaml
@@ -0,0 +1,56 @@
+name: 缺陷报告
+about: 报告一个可复现的问题
+title: "[Bug] "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢反馈！请尽量提供复现步骤，方便我们定位问题。
+  - type: textarea
+    id: description
+    attributes:
+      label: 问题描述
+      description: 简要说明发生了什么
+      placeholder: 评论回复换行后，页面上显示为一行…
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: 复现步骤
+      placeholder: |
+        1. 打开帖子详情页
+        2. 在评论框输入多行文字
+        3. 点击发送
+        4. 观察到换行丢失
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: 期望行为
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: 实际行为
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: 版本 / 提交
+      placeholder: main @ abc1234 或 v1.0.0
+  - type: input
+    id: environment
+    attributes:
+      label: 环境
+      placeholder: Windows 11 / Chrome 125 / Go 1.26
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: 截图或日志
+      description: 可粘贴图片或相关日志
--- a/.gitea/ISSUE_TEMPLATE/feature_request.yaml
+++ b/.gitea/ISSUE_TEMPLATE/feature_request.yaml
@@ -0,0 +1,44 @@
+name: 功能建议
+about: 提出新功能或改进现有体验
+title: "[Feature] "
+labels:
+  - enhancement
+body:
+  - type: markdown
+    attributes:
+      value: |
+        欢迎提出想法！请先搜索已有 Issue，避免重复。
+  - type: textarea
+    id: problem
+    attributes:
+      label: 要解决什么问题？
+      description: 从用户场景出发描述痛点
+      placeholder: 管理员在帖子详情页缺少某某操作入口…
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: 期望的方案
+      description: 你心目中的实现方式（可简略）
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 备选方案
+      description: 如有其他思路可一并说明
+  - type: dropdown
+    id: area
+    attributes:
+      label: 涉及模块
+      options:
+        - 前台 UI/UX
+        - 管理后台
+        - 评论系统
+        - 帖子 / 板块
+        - 认证 / 权限
+        - 部署 / 构建
+        - 其他
+    validations:
+      required: true
--- a/.gitignore
+++ b/.gitignore
@@ -1,20 +1,30 @@
 # 运行时数据（数据库、JWT 密钥、日志、头像）
 /data/

-# 前端依赖与构建缓存
-/frontend/node_modules/
-/frontend/dist/
+# 本地配置（保留 app.ini.example）
+/app.ini

-# Go 编译产物
+# Node / 构建缓存
+/node_modules/
+/web_src/node_modules/
+*.tsbuildinfo
+
+# Go 编译产物（统一进 dist/；勿把二进制扔在仓库根目录）
 /dist/
 *.exe
+/jiang13
+/jiang13-*
+!/cmd/jiang13/

 # 临时文件
 tmp-cookie.txt
+*-err.txt
+*-out.txt

-# 编辑器 / OS
+# 编辑器 / AI 草稿 / OS
 .idea/
 .vscode/
+.trae/
 *.swp
 Thumbs.db
 .DS_Store
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -0,0 +1,44 @@
+# 参与贡献
+
+感谢你对姜十三论坛的关注！这是一个开源项目，欢迎提交 Issue 和 Pull Request。
+
+## 开发环境
+
+**要求：** Go 1.26+、Node.js 18+（仅构建 `web_src` 静态资源）
+
+本分支（`rebuild/gitea-ssr`）为 **Go 模板 SSR**；对照 React SPA 请 `git checkout main`。
+
+```bat
+REM Windows：请用 build.bat（内部 Bypass ExecutionPolicy）
+build.bat -Target dev
+REM 浏览器访问 http://localhost:3000
+```
+
+```bash
+# Linux / macOS
+make dev
+```
+
+## 提交规范
+
+- 一个 PR 只做一件事，保持 diff 小而清晰
+- 前端（`web_src` / 模板）改动请确认浅色 / 暗色主题下都正常
+- 涉及 UI 变更时，建议在 PR 中附上截图
+- 功能语义以 [`docs/rebuild-spec/`](docs/rebuild-spec/) 为准
+
+## 完整构建
+
+```bat
+build.bat            REM Windows：先 web_src，再 go build → dist/
+```
+
+```bash
+make build           # Linux / macOS
+```
+
+## 报告问题
+
+在本仓库 Issues 中描述（也可参考 [docs/issue-templates.md](docs/issue-templates.md)）：
+- 期望行为与实际行为
+- 复现步骤、浏览器 / OS
+- 相关模板或 `routers/web` 路径（若已知）
--- a/53
+++ b/53
@@ -0,0 +1,53 @@
+# 姜十三论坛 — 多阶段构建：web_src → Go 单二进制 → Alpine 运行镜像
+# 不使用 # syntax=docker/dockerfile:1，避免构建前额外拉取 docker.io/docker/dockerfile
+#
+# 国内网络：默认经 DaoCloud 拉取基础镜像，npm/go 走国内代理
+# 海外或已配置 Docker registry-mirrors 时可传空前缀：
+#   docker build --build-arg IMAGE_PREFIX= ...
+
+ARG IMAGE_PREFIX=docker.m.daocloud.io/library/
+ARG VERSION=dev
+
+# ── Stage 1: SSR 渐进资源（web_src → public/assets）────────────────────────
+FROM ${IMAGE_PREFIX}node:22-bookworm-slim AS websrc
+WORKDIR /src/web_src
+COPY web_src/package.json ./
+COPY web_src/ ./
+RUN node build.mjs
+
+# ── Stage 2: Go 编译（纯 Go SQLite，CGO_ENABLED=0）────────────────────────
+FROM ${IMAGE_PREFIX}golang:1.26-bookworm AS builder
+ARG VERSION
+ENV GOPROXY=https://goproxy.cn,direct
+WORKDIR /src
+COPY go.mod go.sum ./
+RUN go mod download
+COPY . .
+COPY --from=websrc /src/public/assets ./public/assets
+RUN CGO_ENABLED=0 go build -trimpath \
+    -ldflags "-s -w -X main.version=${VERSION}" \
+    -o /out/jiang13 ./cmd/jiang13
+
+# ── Stage 3: 运行镜像 ───────────────────────────────────────────────────────
+FROM ${IMAGE_PREFIX}alpine:3.21
+RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories \
+    && apk add --no-cache ca-certificates tzdata wget su-exec \
+    && adduser -D -u 1000 -h /app jiang13
+
+ENV TZ=Asia/Shanghai
+
+WORKDIR /app
+COPY --from=builder /out/jiang13 /app/jiang13
+COPY docker-entrypoint.sh /docker-entrypoint.sh
+RUN chown jiang13:jiang13 /app/jiang13 \
+    && chmod +x /app/jiang13 /docker-entrypoint.sh
+
+# 以 root 启动，entrypoint 修正 /data 卷权限后 su-exec 降权为 jiang13
+VOLUME ["/data"]
+EXPOSE 3000
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \
+    CMD wget -qO- http://127.0.0.1:3000/health || exit 1
+
+ENTRYPOINT ["/docker-entrypoint.sh"]
+CMD ["--work-path", "/app", "--data", "/data", "--port", "3000"]
--- a/12
+++ b/12
@@ -1,6 +1,4 @@
-MIT License
-
-Copyright (c) 2026 freefire
+Copyright (c) 2026 The Jiang13 Authors

 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -9,13 +7,13 @@ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:

-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.

 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
--- a/79
+++ b/79
@@ -1,76 +1,95 @@
 # 姜十三论坛 Jiang13 Forum - Makefile
-# Go 1.26 单二进制编译，与 Gitea 打包方式一致
+# Go 1.26 单二进制：templates SSR + web_src 渐进资源（本分支无 React SPA）

 APP_NAME    := jiang13
 MAIN_PKG    := ./cmd/jiang13
 BUILD_DIR   := dist
-VERSION     := 1.0.0
+DEV_DATA_DIR := dist/data
+VERSION     := $(shell git rev-parse --short HEAD 2>/dev/null | sed 's/^/1.0.0+/' || echo 1.0.0)
 LDFLAGS     := -s -w -X main.version=$(VERSION)
+REGISTRY_IMAGE := hangzhang714128/jiang13-forum

 GO          := go
 GOFLAGS     := -trimpath

-.PHONY: all build build-windows build-linux build-darwin clean run dev tidy help frontend frontend-build
+.PHONY: all build build-windows build-linux build-darwin build-all clean run dev tidy help web-src-build docker compose-up compose-down

 all: build

-frontend-build:
-	cd frontend && npm install && npm run build
+web-src-build:
+	cd web_src && npm run build

-## 编译当前平台二进制
-build: frontend-build
+## 编译当前平台二进制（纯 Go SQLite，无需 CGO）
+build: web-src-build
 	@mkdir -p $(BUILD_DIR)
-	$(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME) $(MAIN_PKG)
+	CGO_ENABLED=0 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME) $(MAIN_PKG)
 	@echo "✓ 编译完成: $(BUILD_DIR)/$(APP_NAME)"

 ## Windows amd64
-build-windows:
+build-windows: web-src-build
 	@mkdir -p $(BUILD_DIR)
-	GOOS=windows GOARCH=amd64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME).exe $(MAIN_PKG)
+	CGO_ENABLED=0 GOOS=windows GOARCH=amd64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME).exe $(MAIN_PKG)
 	@echo "✓ Windows: $(BUILD_DIR)/$(APP_NAME).exe"

 ## Linux amd64
-build-linux:
+build-linux: web-src-build
 	@mkdir -p $(BUILD_DIR)
-	GOOS=linux GOARCH=amd64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME)-linux-amd64 $(MAIN_PKG)
+	CGO_ENABLED=0 GOOS=linux GOARCH=amd64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME)-linux-amd64 $(MAIN_PKG)
 	@echo "✓ Linux: $(BUILD_DIR)/$(APP_NAME)-linux-amd64"

 ## macOS arm64 (Apple Silicon)
-build-darwin:
+build-darwin: web-src-build
 	@mkdir -p $(BUILD_DIR)
-	GOOS=darwin GOARCH=arm64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME)-darwin-arm64 $(MAIN_PKG)
+	CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME)-darwin-arm64 $(MAIN_PKG)
 	@echo "✓ macOS: $(BUILD_DIR)/$(APP_NAME)-darwin-arm64"

-## 跨平台全量编译
-build-all: build-windows build-linux build-darwin build
+## 跨平台全量编译（web_src 只跑一次）
+build-all: web-src-build
+	@mkdir -p $(BUILD_DIR)
+	CGO_ENABLED=0 GOOS=windows GOARCH=amd64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME).exe $(MAIN_PKG)
+	CGO_ENABLED=0 GOOS=linux GOARCH=amd64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME)-linux-amd64 $(MAIN_PKG)
+	CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME)-darwin-arm64 $(MAIN_PKG)
+	CGO_ENABLED=0 $(GO) build $(GOFLAGS) -ldflags "$(LDFLAGS)" -o $(BUILD_DIR)/$(APP_NAME) $(MAIN_PKG)
 	@echo "✓ 全平台编译完成"

 ## 整理依赖
 tidy:
 	$(GO) mod tidy

-## 本地运行（仅后端，使用已 embed 的前端）
-run:
-	$(GO) run $(MAIN_PKG) --port 3000 --data ./data
+## 本地运行 SSR（先构建 web_src）
+run: web-src-build
+	@mkdir -p $(DEV_DATA_DIR)
+	$(GO) run $(MAIN_PKG) --work-path . --data $(DEV_DATA_DIR)

-## 前端热更新开发（后端 :3000 + Vite :5173，Ctrl+C 同时退出）
-dev:
-	@echo "前端热更新: http://localhost:5173"
-	@echo "后端 API  : http://localhost:3000"
-	@trap 'kill 0' INT; \
-	$(GO) run $(MAIN_PKG) --port 3000 --data ./data & \
-	cd frontend && (test -d node_modules || npm install) && npm run dev
+## 同 run（SPA 对照请 git checkout main）
+dev: run

 ## 清理编译产物
 clean:
 	rm -rf $(BUILD_DIR)

+## 构建 Docker 镜像
+docker:
+	docker build --build-arg VERSION=$(VERSION) -t $(REGISTRY_IMAGE):$(VERSION) -t $(REGISTRY_IMAGE):latest .
+
+## Docker Compose 启动
+compose-up:
+	docker compose up -d --build
+
+## Docker Compose 停止
+compose-down:
+	docker compose down
+
 help:
-	@echo "姜十三论坛编译命令:"
-	@echo "  make build          - 编译当前平台"
+	@echo "姜十三论坛编译命令 (rebuild/gitea-ssr):"
+	@echo "  make web-src-build  - 构建 SSR 渐进资源 (web_src)"
+	@echo "  make build          - web_src + 编译当前平台"
 	@echo "  make build-windows  - 编译 Windows"
 	@echo "  make build-linux    - 编译 Linux"
 	@echo "  make build-darwin   - 编译 macOS"
 	@echo "  make build-all      - 编译全部平台"
-	@echo "  make run            - 仅启动后端（:3000）"
-	@echo "  make dev            - 前端热更新开发（:5173 + :3000）"
+	@echo "  make run / make dev - 启动 SSR（:3000）"
+	@echo "  make docker         - 构建 Docker 镜像"
+	@echo "  make compose-up     - Docker Compose 启动"
+	@echo "  make compose-down   - Docker Compose 停止"
+	@echo "  SPA 对照: git checkout main"
--- a/README.md
+++ b/README.md
@@ -1,187 +1,407 @@
+<div align="center">
+
 # 姜十三论坛 Jiang13 Forum

-轻量自用论坛系统，面向小圈子内部交流。与 Gitea 相同，编译为**单个独立 Go 二进制**，前端静态资源 embed 内嵌，内置 SQLite，开箱即用。
+**能聊 · 好看 · 好装**

-## 项目目录结构
+面向小圈子、团队与同好社群的轻量现代化论坛。  
+本分支（`rebuild/gitea-ssr`）：Go 模板真 SSR + `web_src` 渐进增强，单二进制 + SQLite。  
+对照 React SPA 请见 `main` 分支。

-```
-js13-forum/
-├── cmd/jiang13/main.go          # 程序入口
-├── config/config.go             # 命令行参数与配置
-├── model/
-│   ├── models.go                # GORM 模型定义
-│   └── db.go                    # 数据库初始化与自动迁移
-├── service/                     # 业务逻辑层
-│   ├── auth.go                  # 注册/登录/JWT
-│   ├── user.go                  # 用户资料/头像
-│   ├── board.go                 # 板块 CRUD
-│   ├── post.go                  # 帖子/点赞/收藏
-│   ├── comment.go               # 楼层评论
-│   ├── backup.go                # SQLite 备份
-│   ├── ratelimit.go             # 访问限流
-│   └── common.go                # 敏感词过滤等
-├── handler/
-│   ├── handlers.go              # 前台页面与 API
-│   └── admin.go                 # 后台管理
-├── middleware/auth.go           # JWT 鉴权与限流中间件
-├── router/router.go             # 路由注册
-├── embed_static/
-│   ├── embed.go                 # go:embed 声明
-│   ├── static/css/style.css     # 内嵌 CSS
-│   ├── static/js/app.js         # 内嵌 JS
-│   └── templates/               # 内嵌 HTML 模板
-├── go.mod
-├── Makefile
-└── README.md
-```
+<br>
+
+[![在线演示](https://img.shields.io/badge/Demo-bbs.iioio.com-18a058?style=flat-square)](https://bbs.iioio.com/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-18a058?style=flat-square)](LICENSE)
+[![Docker](https://img.shields.io/badge/Docker-hangzhang714128%2Fjiang13--forum-2496ED?style=flat-square&logo=docker&logoColor=white)](https://hub.docker.com/r/hangzhang714128/jiang13-forum)
+[![Go](https://img.shields.io/badge/Go-1.26-00ADD8?style=flat-square&logo=go&logoColor=white)](go.mod)
+[![SSR](https://img.shields.io/badge/SSR-Go_html%2Ftemplate-00ADD8?style=flat-square&logo=go&logoColor=white)](docs/rebuild-spec/08-gitea-ssr-architecture.md)
+[![SQLite](https://img.shields.io/badge/SQLite-内置-003B57?style=flat-square&logo=sqlite&logoColor=white)](#)
+
+[在线演示](https://bbs.iioio.com/) ·
+[快速开始](#-快速开始) ·
+[界面预览](#-界面预览) ·
+[功能亮点](#-功能亮点) ·
+[路线图](ROADMAP.md) ·
+[参与贡献](CONTRIBUTING.md)
+
+<br>
+
+<img src="docs/screenshots/home-light.png" alt="姜十三论坛首页 - 浅色主题三栏布局" width="92%">
+
+<sub>浅色主题 · 三栏布局 · Feed 排序 · 板块导航 · 标签云</sub>
+
+<br>
+
+> **演示站点：** [https://bbs.iioio.com/](https://bbs.iioio.com/)（现网多为 `main` SPA）  
+> 本分支按 [Gitea 式 SSR 规格](docs/rebuild-spec/08-gitea-ssr-architecture.md) 重构；欢迎提 Issue / PR 共建。
+
+</div>
+
+---
+
+## 它是什么
+
+姜十三论坛不做大而全的社区平台，只做好一件事：给「几人到几百人」的内部交流，一个干净、顺手、数据在自己手里的地方。
+
+| 场景 | 说明 |
+|------|------|
+| 团队 / 工作室 | 需求讨论、进度同步、知识沉淀 |
+| 兴趣小圈子 | 同好交流、作品分享、活动组织 |
+| 项目配套社区 | 可与 Gitea 等通过 OIDC（开放身份连接）做 SSO（单点登录） |
+| 个人站长 | 单机可跑，无需云数据库与一堆微服务 |
+
+---
+
+## 界面预览
+
+截图来自演示站 [bbs.iioio.com](https://bbs.iioio.com/)。
+
+<table>
+  <tr>
+    <td width="50%" align="center">
+      <img src="docs/screenshots/home-light.png" alt="浅色主题首页" width="100%">
+      <br><b>浅色主题</b><br>
+      <sub>左栏板块 · Feed 排序 · 右栏热门 / 标签 / 评论</sub>
+    </td>
+    <td width="50%" align="center">
+      <img src="docs/screenshots/home-dark.png" alt="暗色主题首页" width="100%">
+      <br><b>暗色主题</b><br>
+      <sub>一键切换 · 护眼阅读 · 全局色彩自适应</sub>
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" align="center">
+      <img src="docs/screenshots/post-detail.png" alt="帖子详情页" width="100%">
+      <br><b>帖子详情</b><br>
+      <sub>文章目录 · 标签 · 作者卡片 · 修订信息</sub>
+    </td>
+    <td width="50%" align="center">
+      <img src="docs/screenshots/post-rich.png" alt="富文本与代码高亮" width="100%">
+      <br><b>富文本渲染</b><br>
+      <sub>Markdown 排版 · 图片 · 代码块 · 目录导航</sub>
+    </td>
+  </tr>
+</table>
+
+<p align="center">
+  <img src="docs/screenshots/mobile-home.png" alt="移动端首页" width="280">
+  <br><b>移动端</b> — 板块快捷筛选 · Feed 排序 · 触控友好列表
+</p>
+
+---
+
+## 功能亮点
+
+### 界面与交互
+
+| 特性 | 说明 |
+|------|------|
+| **三栏布局** | 左栏板块导航 + 中间帖列表 + 右栏热门 / 标签 / 最新评论 |
+| **真 SSR** | 公开页服务端渲染完整 HTML（Go `html/template`） |
+| **帖子排序** | 最新发帖 / 最新回复 / 热门讨论 |
+| **主题切换** | 浅色 / 暗色 / 跟随系统（`localStorage`） |
+| **响应式** | ≤900px 隐藏右栏；搜索、发帖、登录触手可及 |
+
+### 社区功能
+
+- 安装向导创建管理员；用户注册 / 登录（bcrypt + 会话 Cookie）
+- 板块、发帖、Markdown 工具栏、正文图片上传、标签、置顶 / 精华
+- 帖子修订历史；可配置普通用户编辑时限
+- 楼层式评论：回复、嵌套树、内容门控（登录/回复/积分可见）
+- 点赞、收藏、热门帖、最新评论、站内私信、公开用户主页
+- SSR 管理后台：仪表盘、删帖 / 删评、禁言、举报、敏感词、限流、SQLite 一键备份
+- 可选：邮件验证码、OIDC Provider、S3 兼容对象存储（Gitea 仓库同步后置）
+
+### 部署体验
+
+- **单二进制** — `go:embed` 打包模板与 SSR 资源
+- **可切换数据库** — 默认 SQLite；可选 PostgreSQL / MySQL（Env 引导）
+- **跨平台** — Windows / Linux / macOS 一键编译
+- **系统服务** — 内置 Linux systemd / Windows Service 注册
+- **Docker 单容器** — 多阶段镜像，挂载 `data/` 即可持久化
+
+---

 ## 快速开始

 ### 1. 编译

-**Windows（推荐，无需 GNU Make）：**
+**Windows（推荐）：**

-```powershell
-# PowerShell
-.\build.ps1
-
-# 或双击 / cmd
+```bat
 build.bat
 ```

-**Linux / macOS（需 GNU Make）：**
+> 请通过 `build.bat` 调用（内部已处理 ExecutionPolicy）。不要直接 `.\build.ps1`，也不要在 Windows 上使用系统自带的 Embarcadero `make`。
+
+**Linux / macOS：**

 ```bash
 make build
 ```

-**手动分步（全平台通用）：**
+**手动分步（全平台）：**

 ```bash
-cd frontend && npm install && npm run build
-cd .. && go build -trimpath -ldflags "-s -w" -o dist/jiang13.exe ./cmd/jiang13
+cd web_src && npm run build
+cd .. && go build -trimpath -ldflags "-s -w" -o dist/jiang13 ./cmd/jiang13
 ```

-> Windows 自带的 `make` 通常是 Embarcadero MAKE，**不能**识别本项目 Makefile。请用 `.\build.ps1` 或安装 GNU Make（`choco install make`）后再用 `make build`。
-
 跨平台编译：

-```powershell
-.\build.ps1 -Target build-windows
-.\build.ps1 -Target build-linux
-.\build.ps1 -Target build-all
+```bat
+build.bat -Target build-windows
+build.bat -Target build-linux
+build.bat -Target build-all
 ```

-### 2. 启动
+### 2. Docker 部署（推荐）
+
+**一键启动（本地构建）：**
+
+```bash
+docker compose up -d --build
+```
+
+```bat
+.\build.bat -Target compose-up
+```
+
+```bash
+make compose-up
+```
+
+浏览器打开 `http://localhost:3000/install` 完成安装向导（站点名 + 管理员）。
+
+**拉取已构建镜像（Docker Hub）：**
+
+```bash
+docker pull hangzhang714128/jiang13-forum:latest
+docker run -d --name jiang13 \
+  -p 3000:3000 \
+  -v jiang13-data:/data \
+  --restart unless-stopped \
+  hangzhang714128/jiang13-forum:latest
+```
+
+**数据持久化：** 容器内 `/data` 对应 SQLite（默认）、上传、日志与 JWT/OIDC 密钥。可用 Docker volume 或绑定宿主机目录。镜像启动时会自动将 `/data` 卷属主修正为 uid `1000`（`jiang13` 用户）。
+
+**若使用旧版镜像仍报 permission denied**，可在宿主机执行：`chown -R 1000:1000 /你的数据目录`
+
+**可选环境变量（容器编排）：**
+
+| 变量 | 说明 |
+|------|------|
+| `JIANG13_HTTP_PORT` | HTTP 端口（默认 `3000`） |
+| `JIANG13_DATA` | 数据目录（默认 `/data`） |
+| `JIANG13_DB_TYPE` | `sqlite`（默认）\| `postgres` \| `mysql` |
+| `JIANG13_DB_DSN` | 完整 DSN（非 sqlite 时推荐） |
+| `JIANG13_WORK_PATH` | 工作目录 |
+
+JWT 自动写入 `/data/.jwt_secret`，无需 Env。
+
+**健康检查：** `GET /health` 返回 `{"status":"ok"}`，供 Docker / 负载均衡探活。
+
+**发布镜像到 Docker Hub（手动）：**
+
+```bash
+docker login
+.\build.bat -Target docker          # Windows
+# make docker                       # Linux/macOS
+docker push hangzhang714128/jiang13-forum:1.0.0
+docker push hangzhang714128/jiang13-forum:latest
+```
+
+或直接构建：
+
+```bash
+docker build --build-arg VERSION=1.0.0 -t hangzhang714128/jiang13-forum:1.0.0 -t hangzhang714128/jiang13-forum:latest .
+docker push hangzhang714128/jiang13-forum:1.0.0
+docker push hangzhang714128/jiang13-forum:latest
+```
+
+停止服务：`docker compose down` / `.\build.bat -Target compose-down` / `make compose-down`
+
+**构建失败（无法连接 auth.docker.io）？** Dockerfile 已默认经 DaoCloud 拉取基础镜像。若仍超时，可在 Docker Desktop → Settings → Docker Engine 添加：
+
+```json
+{
+  "registry-mirrors": ["https://docker.m.daocloud.io"]
+}
+```
+
+保存并重启 Docker 后重试 `.\build.bat -Target docker`。PowerShell 中请用 `.\build.bat`（带 `.\` 前缀）。
+
+**1Panel 部署提示：**
+
+1. 容器镜像填 `hangzhang714128/jiang13-forum:latest`
+2. 端口映射 `3000:3000`
+3. 挂载数据卷到容器内 `/data`（镜像会自动修正目录权限）
+4. 首次访问 `http://服务器IP:3000/install` 完成安装
+
+### 3. 直接启动（二进制）

 ```bash
 # Windows
-.\dist\jiang13.exe --port 3000 --data ./data
+.\dist\jiang13.exe --data .\dist\data

 # Linux / macOS
-./dist/jiang13 --port 3000 --data ./data
+./dist/jiang13 --data ./data
 ```

-### 3. 首次使用
+默认 SQLite，库文件在 `{DATA}/jiang13.db`。无 `app.ini`。

-1. 浏览器打开 http://localhost:3000/register 注册账号
-2. **第一个注册的用户自动成为管理员**，无需额外命令
-3. 登录后可访问 http://localhost:3000/admin/dashboard 进入后台
+### 4. 首次使用

-## 启动参数
+1. 浏览器打开 `http://localhost:3000/install`
+2. 填写站点名与管理员账号
+3. 完成后登录，访问管理后台配置品牌等（热更新，无需重启）
+
+### 配置分层（无 INI）
+
+| 层 | 内容 | 需重启 |
+|----|------|--------|
+| CLI / Env | 端口、数据目录、数据库类型与 DSN | 是 |
+| `data/.jwt_secret`、`.oidc_rsa.pem` | 密钥 | 换密钥需重启 |
+| DB `forum_settings` | 品牌、邮件、OIDC 开关、限流、存储… | 否 |
+
+**优先级：** 命令行显式参数 > 环境变量 > 内置默认。
+
+### 启动参数

 | 参数 | 默认值 | 说明 |
 |------|--------|------|
-| `--port` | 3000 | HTTP 监听端口 |
-| `--data` | ./data | 数据目录（SQLite、上传、日志） |
-| `--jwt-secret` | 自动生成 | JWT 签名密钥（留空则自动生成并持久化到 data/.jwt_secret） |
+| `--work-path` | 可执行文件目录 | 工作目录 |
+| `--port` | `3000` | HTTP 监听端口 |
+| `--http-addr` | （空） | 监听地址 |
+| `--data` | `data` | 数据目录 |
+| `--db-type` | `sqlite` | `sqlite` \| `postgres` \| `mysql` |
+| `--db-dsn` | （sqlite 默认 `{data}/jiang13.db`） | 完整 DSN |
+| `--service` | （空） | `install` / `uninstall` / `start` / `stop` / `restart` / `status` |

-## 数据目录说明
+**环境变量：** `JIANG13_HTTP_PORT`、`JIANG13_HTTP_ADDR`、`JIANG13_DATA`、`JIANG13_WORK_PATH`、`JIANG13_DB_TYPE`、`JIANG13_DB_DSN`、以及 `JIANG13_DB_HOST` / `USER` / `PASS` / `NAME` / `SSLMODE`。
+
+PostgreSQL / MySQL 示例见 [`docs/rebuild-spec/07-config-ops.md`](docs/rebuild-spec/07-config-ops.md)。
+
+### 5. 注册为系统服务（可选）
+
+```bash
+sudo mkdir -p /opt/jiang13
+sudo cp jiang13 /opt/jiang13/
+sudo /opt/jiang13/jiang13 --work-path /opt/jiang13 --data /opt/jiang13/data --service install
+sudo /opt/jiang13/jiang13 --service start
+sudo systemctl enable jiang13
+```
+
+**Windows（管理员 PowerShell）：**
+
+```powershell
+New-Item -ItemType Directory -Force -Path C:\jiang13 | Out-Null
+Copy-Item .\jiang13.exe C:\jiang13\
+C:\jiang13\jiang13.exe --work-path C:\jiang13 --data C:\jiang13\data --service install
+C:\jiang13\jiang13.exe --service start
+```
+
+> 改端口或 `DB_*` 后执行 `--service restart`（必要时重装服务以更新参数）。日志：`data/jiang13.log`。
+
+---
+
+## 技术栈
+
+| 层级 | 技术 |
+|------|------|
+| **后端 / SSR** | Go 1.26 · Gin · GORM · SQLite / PostgreSQL / MySQL · `html/template` |
+| **渐进资源** | `web_src/`（构建到 `public/assets/`，URL `/ssr-assets/`） |
+| **构建** | `web_src` → `go:embed` templates + assets，单二进制发布 |
+| **认证** | bcrypt · JWT Cookie · 可选 OIDC Provider |
+| **对照 SPA** | 仅 `main` 分支（React 18 · TipTap · Vite） |
+
+---
+
+## 本地开发（SSR）
+
+```bat
+build.bat -Target run
+```
+
+```bash
+make run
+```
+
+浏览器访问 `http://localhost:3000`。数据目录默认 `dist/data`。
+
+改模板 / Go 后重启进程；改 `web_src` 后需再跑 `build.bat -Target web-src`（或完整 `build`）。
+
+需要对照旧 SPA UI：`git checkout main` 或 `git worktree add ../jiang13-spa main`。
+
+---
+
+## 项目结构
+
+```
+jiang13-forum/                 # 分支 rebuild/gitea-ssr
+├── cmd/jiang13/               # 程序入口（含系统服务注册）
+├── config/                    # CLI / Env 引导配置（无 INI）
+├── Dockerfile                 # web_src → Go → Alpine
+├── docker-compose.yml
+├── models/                    # GORM 模型
+├── services/                  # 业务逻辑
+├── routers/
+│   ├── setup.go               # 路由总装
+│   ├── web/                   # HTML SSR
+│   └── api/                   # 机器入口（health / OIDC / SEO / thumb）
+├── modules/
+│   ├── auth/                  # JWT / 限流
+│   ├── webrender/             # 模板渲染
+│   └── seo/
+├── templates/                 # Go html/template（embed）
+├── web_src/                   # 渐进 CSS/JS 源码
+├── public/assets/             # web_src 构建产物（embed）
+├── docs/rebuild-spec/         # 产品规格与 SSR 架构
+├── docs/screenshots/
+└── ROADMAP.md
+```
+
+> SPA 源码树仅存在于 `main`（`frontend/`、`embed_static/`）。
+
+---
+
+## 数据目录

 ```
 data/
 ├── jiang13.db              # SQLite 主数据库
 ├── jiang13.log             # 运行日志
-├── filter_words.txt        # 敏感词配置（可编辑）
+├── filter_words.txt        # 敏感词配置
 ├── .jwt_secret             # JWT 密钥（自动生成）
-├── uploads/avatars/        # 用户头像（运行时写入，非 embed）
-└── jiang13_backup_*.db     # 后台导出的备份文件
+├── uploads/avatars/        # 用户头像
+├── uploads/posts/          # 帖子正文图片
+└── jiang13_backup_*.db     # 后台导出的备份
 ```

-## 修改前端并重新打包（Gitea 同款流程）
+---

-1. 编辑 `embed_static/templates/` 下的 HTML 模板
-2. 编辑 `embed_static/static/css/` 或 `static/js/` 下的静态资源
-3. 重新编译：`make build`
-4. 替换旧二进制，重启服务
+## 开发状态

-前端资源通过 `//go:embed` 编译进二进制，**运行时不需要单独的前端文件夹**。只有用户上传的头像保存在 `--data` 目录。
+项目**积极开发中**，欢迎参与共建。完整列表见 **[ROADMAP.md](ROADMAP.md)**。

-```go
-// embed_static/embed.go
-//go:embed static/*
-var staticFS embed.FS
-
-//go:embed templates/*
-var templatesFS embed.FS
-```
-
-## 功能概览
-
- 用户注册/登录（bcrypt + JWT Cookie）
- 普通用户 / 管理员两级权限
- 板块管理、发帖、富文本 HTML、标签、置顶
- 楼层式评论，支持回复指定楼层
- 点赞、收藏
- 管理员：删帖、删评论、禁言、SQLite 备份
- 内置敏感词过滤、发帖/评论限流
-
-## 技术栈
-
- **后端**：Go 1.26 + Gin + GORM + SQLite
- **前端**：React 18 + Arco Design + TanStack Virtual（虚拟滚动）
- **打包**：Vite 构建 → `go:embed` 内嵌 SPA，与 Gitea 同款单二进制
-
-## 前端开发（热更新 HMR）
-
-日常改前端**不需要**重新 `npm run build` 或 `go build`，用 Vite 开发服务器即可秒级热更新：
-
-```bash
-# 一键启动：Go 后端 + Vite 热更新（推荐）
-.\build.ps1 -Target dev          # Windows
-make dev                         # Linux / macOS（需 GNU Make）
-
-# 浏览器访问 http://localhost:5173
-# API 自动代理到 http://localhost:3000
-```
-
-也可开两个终端分别启动：
-
-```bash
-# 终端 1：仅后端
-.\build.ps1 -Target run          # 或 make run
-
-# 终端 2：仅前端热更新
-cd frontend && npm install && npm run dev
-```
-
-**何时才需要完整构建：**
-
- 改 Go 代码、模板、embed 静态资源 → `go build` / `make build`
- 发布单二进制前 → `npm run build` + `make build`（前端产物写入 `embed_static/static/spa/` 后 embed 进二进制）
-
-> 若直接访问 `:3000`，看到的是**上次 build 嵌入**的前端，不会有热更新。开发时请用 `:5173`。
-
-### 前端特性（高密度 V2EX/NGA 风格）
-
-| 特性 | 实现 |
+| 类型 | 示例 |
 |------|------|
-| 三栏布局 | 左栏板块菜单（可折叠）+ 中间虚拟滚动帖列表 + 右栏热门/通知/在线 |
-| 虚拟滚动 | `@tanstack/react-virtual` 帖列表 & 楼层回复 |
-| 已读/未读 | 未读高亮 + 角标 + 批量标记已读 |
-| 主题 | 浅色/暗黑一键切换，平板/手机自动收起侧栏 |
-| 交互 | 滚动加载更多、快捷回帖、楼层锚点、引用回复、@高亮 |
+| ✅ 已可用 | 三栏布局、主题、Feed 排序、楼层评论、嵌套树 |
+| ✅ 发帖体验 | Markdown 工具栏、图片上传、修订历史、内容门控 |
+| ✅ 管理后台 | SSR `/admin/*`（对照 SPA 见 `main`） |
+| 📋 计划中 | 见 [ROADMAP.md](ROADMAP.md) / [09-ssr-progress.md](docs/rebuild-spec/09-ssr-progress.md) |
+
+---
+
+## 参与贡献
+
+欢迎提交 Issue 和 Pull Request！详见 [CONTRIBUTING.md](CONTRIBUTING.md)。
+
+在线体验与反馈也可直接在演示站进行：[https://bbs.iioio.com/](https://bbs.iioio.com/)
+
+---

 ## 许可证

-MIT — 自用随意，欢迎修改。
+[MIT](LICENSE)（与 [Gitea](https://github.com/go-gitea/gitea) 相同的 Expat 文本格式）— 自由使用、修改与分发。
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -0,0 +1,52 @@
+# 路线图 ROADMAP
+
+> 姜十三论坛仍在积极开发中。  
+> 演示站：[https://bbs.iioio.com/](https://bbs.iioio.com/) · 欢迎通过本仓库 Issues 反馈问题或认领任务。  
+> **本仓库默认开发分支**：`rebuild/gitea-ssr`（Gitea 式 SSR）。`main` = React SPA 对照。
+
+**图例：** ✅ 已完成 · 🚧 进行中 · 📋 计划中 · 🐛 已知缺陷
+
+---
+
+## 开发状态概览
+
+| 模块 | 状态 | 说明 |
+|------|------|------|
+| 公开页 SSR | ✅ | Go `html/template`；首页 / 板块 / 帖详情 / 用户 / 消息等 |
+| 管理后台 SSR | ✅ | `/admin/*` 表单；对照 SPA 见 `main` |
+| 评论系统 | ✅ | 楼层 + 嵌套树（`ThreadParentID`） |
+| Markdown 编辑 | ✅ | 工具栏 + `/compose/preview`（非 TipTap） |
+| 主题 | ✅ | 浅色 / 暗色 / 跟随系统 |
+| OIDC Provider | ✅ | Discovery / Authorize / Token / UserInfo；Admin 配置面可继续打磨 |
+
+细节进度见 [`docs/rebuild-spec/09-ssr-progress.md`](docs/rebuild-spec/09-ssr-progress.md)。
+
+---
+
+## 🐛 已知缺陷（Bug）
+
+_当前无已记录缺陷。发现新问题请在本仓库提交 Issue。_
+
+---
+
+## 📋 计划中（Planned）
+
+| 优先级 | 功能 | 说明 |
+|--------|------|------|
+| 中 | OIDC / 存储 Admin 打磨 | SSO 与 S3 热切换运维面 |
+| 低 | 编辑器增强 | 表格、表情贴纸（TipTap 不作为本分支默认） |
+| 低 | Gitea `/projects` | 仓库列表页（后置） |
+
+---
+
+## ✅ 已完成（摘，本分支）
+
+- [x] Gitea 式目录与 Go 模板 SSR
+- [x] 五种帖类型 + 核心闭环（赞/藏/门控/审核…）
+- [x] Admin 仪表盘、板块、审核、用户、徽章、媒体、设置等
+- [x] Markdown 发帖/评论编辑器与预览
+- [x] 评论嵌套树、浅色/暗色主题
+- [x] OIDC Provider 机器入口
+- [x] 本分支删除未挂载论坛 JSON API（对照 `main`）
+
+更全清单：[`docs/rebuild-spec/02-features.md`](docs/rebuild-spec/02-features.md)。
--- a/build.bat
+++ b/build.bat
@@ -1,4 +1,4 @@
@echo off
-REM 姜十三论坛 Windows 快捷构建（双击或命令行均可）
+REM Jiang13 Forum Windows build wrapper (double-click or run from cmd)
 powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0build.ps1" %*
 exit /b %ERRORLEVEL%
--- a/build.ps1
+++ b/build.ps1
@@ -1,9 +1,10 @@
 # Jiang13 Forum - Windows build script (replaces GNU Make)
 # Usage: .\build.ps1
 #        .\build.ps1 -Target build-windows
+# Branch rebuild/gitea-ssr: Go templates SSR + web_src (no React SPA)

 param(
-    [ValidateSet('build', 'build-windows', 'build-linux', 'build-darwin', 'build-all', 'frontend', 'tidy', 'run', 'dev', 'clean', 'help')]
+    [ValidateSet('build', 'build-windows', 'build-linux', 'build-darwin', 'build-all', 'web-src', 'tidy', 'run', 'dev', 'clean', 'docker', 'compose-up', 'compose-down', 'help')]
    [string]$Target = 'build'
 )

@@ -11,7 +12,15 @@ $ErrorActionPreference = 'Stop'
 $AppName = 'jiang13'
 $MainPkg = './cmd/jiang13'
 $BuildDir = 'dist'
+$DevDataDir = 'dist/data'
 $Version = '1.0.0'
+try {
+    $gitSha = (git rev-parse --short HEAD 2>$null)
+    if ($LASTEXITCODE -eq 0 -and $gitSha) {
+        $Version = "1.0.0+$gitSha"
+    }
+} catch {}
+$RegistryImage = 'hangzhang714128/jiang13-forum'
 $Ldlags = "-s -w -X main.version=$Version"

 function Ensure-Dir($path) {
@@ -20,15 +29,12 @@ function Ensure-Dir($path) {
    }
 }

-function Build-Frontend {
-    Write-Host '[frontend] npm run build...' -ForegroundColor Cyan
-    Push-Location frontend
+function Build-WebSrc {
+    Write-Host '[web_src] npm run build...' -ForegroundColor Cyan
+    Push-Location web_src
    try {
-        if (-not (Test-Path node_modules)) {
-            npm install
-        }
        npm run build
-        if ($LASTEXITCODE -ne 0) { throw 'frontend build failed' }
+        if ($LASTEXITCODE -ne 0) { throw 'web_src build failed' }
    } finally {
        Pop-Location
    }
@@ -39,82 +45,102 @@ function Build-Go([string]$OutFile, [string]$GoOS = '', [string]$GoArch = '') {
    if ($GoOS) { $env:GOOS = $GoOS } else { Remove-Item Env:GOOS -ErrorAction SilentlyContinue }
    if ($GoArch) { $env:GOARCH = $GoArch } else { Remove-Item Env:GOARCH -ErrorAction SilentlyContinue }

+    # 纯 Go SQLite（glebarez），交叉编译无需 C 工具链
+    $prevCgo = $env:CGO_ENABLED
+    $env:CGO_ENABLED = '0'
+
    $isWindows = ($GoOS -eq 'windows') -or (($GoOS -eq '') -and ($env:OS -match 'Windows'))
    if ($isWindows -and ($OutFile -notmatch '\.exe$')) {
        $OutFile = "$OutFile.exe"
    }

    $outPath = Join-Path $BuildDir $OutFile
-    Write-Host "[go] build -> $outPath" -ForegroundColor Cyan
-    go build -trimpath -ldflags $Ldlags -o $outPath $MainPkg
-    if ($LASTEXITCODE -ne 0) { throw 'go build failed' }
-    Write-Host "[ok] $outPath" -ForegroundColor Green
+    Write-Host "[go] build -> $outPath (CGO_ENABLED=0)" -ForegroundColor Cyan
+    try {
+        go build -trimpath -ldflags $Ldlags -o $outPath $MainPkg
+        if ($LASTEXITCODE -ne 0) { throw 'go build failed' }
+        Write-Host "[ok] $outPath" -ForegroundColor Green
+    } finally {
+        if ($null -eq $prevCgo) {
+            Remove-Item Env:CGO_ENABLED -ErrorAction SilentlyContinue
+        } else {
+            $env:CGO_ENABLED = $prevCgo
+        }
+        Remove-Item Env:GOOS -ErrorAction SilentlyContinue
+        Remove-Item Env:GOARCH -ErrorAction SilentlyContinue
+    }
 }

 switch ($Target) {
    'help' {
-        Write-Host '.\build.ps1                  build current platform'
-        Write-Host '.\build.ps1 -Target frontend  frontend only'
+        Write-Host '.\build.ps1                  build current platform (web_src + go)'
+        Write-Host '.\build.ps1 -Target web-src   SSR progressive assets only'
        Write-Host '.\build.ps1 -Target build-windows'
        Write-Host '.\build.ps1 -Target build-linux'
        Write-Host '.\build.ps1 -Target build-all'
-        Write-Host '.\build.ps1 -Target run       backend only (port 3000)'
-        Write-Host '.\build.ps1 -Target dev       backend + Vite HMR (recommended for frontend dev)'
+        Write-Host '.\build.ps1 -Target run       SSR on :3000'
+        Write-Host '.\build.ps1 -Target dev       same as run (SSR; SPA is on main)'
        Write-Host '.\build.ps1 -Target tidy'
        Write-Host '.\build.ps1 -Target clean'
+        Write-Host '.\build.ps1 -Target docker'
+        Write-Host '.\build.ps1 -Target compose-up'
+        Write-Host '.\build.ps1 -Target compose-down'
        Write-Host ''
        Write-Host 'Note: Windows "make" is often Embarcadero MAKE, not GNU Make.'
+        Write-Host 'SPA reference: git checkout main  (or origin/main).'
    }
-    'frontend' { Build-Frontend }
+    'web-src' { Build-WebSrc }
    'tidy' { go mod tidy }
    'clean' {
        if (Test-Path $BuildDir) { Remove-Item -Recurse -Force $BuildDir }
        Write-Host '[ok] cleaned dist' -ForegroundColor Green
    }
    'run' {
-        go run $MainPkg --port 3000 --data ./data
+        Ensure-Dir $DevDataDir
+        Build-WebSrc
+        go run $MainPkg --work-path . --data $DevDataDir
    }
    'dev' {
-        $root = (Get-Location).Path
-        Write-Host ''
-        Write-Host '[dev] 前端热更新: http://localhost:5173' -ForegroundColor Green
-        Write-Host '[dev] 后端 API  : http://localhost:3000' -ForegroundColor Green
-        Write-Host '[dev] 后台管理  : http://localhost:3000/admin/dashboard' -ForegroundColor Green
-        Write-Host '[dev] 正在新窗口启动 Go 后端...' -ForegroundColor Cyan
-        Start-Process powershell -ArgumentList @(
-            '-NoExit', '-Command',
-            "Set-Location '$root'; Write-Host '[backend] Go API on :3000' -ForegroundColor Cyan; go run $MainPkg --port 3000 --data ./data"
-        ) | Out-Null
-        Start-Sleep -Seconds 2
-        Push-Location frontend
-        try {
-            if (-not (Test-Path node_modules)) { npm install }
-            npm run dev
-        } finally {
-            Pop-Location
-        }
+        Ensure-Dir $DevDataDir
+        Build-WebSrc
+        Write-Host '[dev] SSR: http://localhost:3000  (SPA 对照请 checkout main)' -ForegroundColor Green
+        go run $MainPkg --work-path . --data $DevDataDir
    }
    'build' {
-        Build-Frontend
+        Build-WebSrc
        Build-Go -OutFile $AppName
    }
    'build-windows' {
-        Build-Frontend
+        Build-WebSrc
        Build-Go -OutFile $AppName -GoOS 'windows' -GoArch 'amd64'
    }
    'build-linux' {
-        Build-Frontend
+        Build-WebSrc
        Build-Go -OutFile "$AppName-linux-amd64" -GoOS 'linux' -GoArch 'amd64'
    }
    'build-darwin' {
-        Build-Frontend
+        Build-WebSrc
        Build-Go -OutFile "$AppName-darwin-arm64" -GoOS 'darwin' -GoArch 'arm64'
    }
    'build-all' {
-        Build-Frontend
+        Build-WebSrc
        Build-Go -OutFile $AppName -GoOS 'windows' -GoArch 'amd64'
        Build-Go -OutFile "$AppName-linux-amd64" -GoOS 'linux' -GoArch 'amd64'
        Build-Go -OutFile "$AppName-darwin-arm64" -GoOS 'darwin' -GoArch 'arm64'
        Write-Host '[ok] all platforms done' -ForegroundColor Green
    }
+    'docker' {
+        Write-Host "[docker] build $RegistryImage`:$Version and latest" -ForegroundColor Cyan
+        docker build --build-arg "VERSION=$Version" -t "${RegistryImage}:$Version" -t "${RegistryImage}:latest" .
+        if ($LASTEXITCODE -ne 0) { throw 'docker build failed' }
+        Write-Host '[ok] docker image built' -ForegroundColor Green
+    }
+    'compose-up' {
+        docker compose up -d --build
+        if ($LASTEXITCODE -ne 0) { throw 'compose up failed' }
+    }
+    'compose-down' {
+        docker compose down
+        if ($LASTEXITCODE -ne 0) { throw 'compose down failed' }
+    }
 }
--- a/cmd/jiang13/main.go
+++ b/cmd/jiang13/main.go
@@ -1,76 +1,46 @@
-package main
+package main

 import (
-	"context"
 	"fmt"
-	"io"
 	"log"
-	"net/http"
 	"os"
-	"os/signal"
-	"syscall"
-	"time"

-	"github.com/jiang13/forum/config"
-	"github.com/jiang13/forum/model"
-	"github.com/jiang13/forum/router"
+	kardsvc "github.com/kardianos/service"
+
+	"git.iioio.com/freefire/jiang13-forum/config"
 )

+// version 由构建脚本通过 -ldflags "-X main.version=..." 注入
+var version = "dev"
+
 func main() {
 	cfg, err := config.Parse()
 	if err != nil {
 		log.Fatalf("配置解析失败: %v", err)
 	}

-	// 日志同时输出到控制台和文件
-	logFile, err := os.OpenFile(cfg.LogFile, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
+	svcCfg, err := buildServiceConfig(cfg)
 	if err != nil {
-		log.Fatalf("打开日志文件失败: %v", err)
-	}
-	defer logFile.Close()
-	log.SetOutput(io.MultiWriter(os.Stdout, logFile))
-	log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
-
-	log.Println("========================================")
-	log.Println("  姜十三论坛 Jiang13 Forum 启动中...")
-	log.Println("========================================")
-
-	// 初始化数据库
-	if err := model.InitDB(cfg.DBPath()); err != nil {
-		log.Fatalf("数据库初始化失败: %v", err)
+		log.Fatalf("构建服务配置失败: %v", err)
 	}

-	// 设置路由
-	engine, err := router.Setup(cfg)
+	prg := &program{cfg: cfg}
+	svc, err := kardsvc.New(prg, svcCfg)
 	if err != nil {
-		log.Fatalf("路由初始化失败: %v", err)
+		log.Fatalf("创建系统服务失败: %v", err)
 	}

-	addr := fmt.Sprintf(":%d", cfg.Port)
-	srv := &http.Server{
-		Addr:    addr,
-		Handler: engine,
-	}
-
-	// 优雅关机
-	go func() {
-		sigCh := make(chan os.Signal, 1)
-		signal.Notify(sigCh, syscall.SIGINT, syscall.SIGTERM)
-		<-sigCh
-		log.Println("收到关机信号，正在优雅关闭...")
-		ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
-		defer cancel()
-		if err := srv.Shutdown(ctx); err != nil {
-			log.Printf("HTTP 服务关闭异常: %v", err)
+	if cfg.ServiceAction != "" {
+		if err := runServiceControl(svc, cfg.ServiceAction); err != nil {
+			fmt.Fprintf(os.Stderr, "服务操作失败 (%s): %v\n", cfg.ServiceAction, err)
+			os.Exit(1)
 		}
-	}()
-
-	log.Printf("姜十三论坛已启动: http://localhost%s", addr)
-	log.Printf("后台管理地址: http://localhost%s/admin/dashboard", addr)
-	log.Printf("数据目录: %s", cfg.DataDir)
-
-	if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
-		log.Fatalf("HTTP 服务异常: %v", err)
+		return
+	}
+
+	// 交互终端或由服务管理器拉起时均走 Run：
+	// Windows Service / systemd 负责生命周期；前台运行时仍响应 Ctrl+C / SIGTERM
+	if err := svc.Run(); err != nil {
+		log.Fatalf("运行失败: %v", err)
 	}
-	log.Println("姜十三论坛已安全退出")
 }
--- a/cmd/jiang13/program.go
+++ b/cmd/jiang13/program.go
@@ -0,0 +1,175 @@
+package main
+
+import (
+	"context"
+	"fmt"
+	"io"
+	"log"
+	"net/http"
+	"os"
+	"time"
+
+	kardsvc "github.com/kardianos/service"
+
+	"git.iioio.com/freefire/jiang13-forum/config"
+	"git.iioio.com/freefire/jiang13-forum/models"
+	"git.iioio.com/freefire/jiang13-forum/routers"
+)
+
+const (
+	svcName        = "jiang13"
+	svcDisplayName = "姜十三论坛"
+	svcDescription = "姜十三论坛 Jiang13 Forum — 轻量单二进制论坛服务"
+)
+
+// program 实现 kardianos/service.Interface，兼容 Windows Service 与 Linux systemd
+type program struct {
+	cfg    *config.Config
+	server *http.Server
+}
+
+func (p *program) Start(s kardsvc.Service) error {
+	if err := p.setup(); err != nil {
+		return err
+	}
+	go func() {
+		if err := p.server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
+			log.Printf("HTTP 服务异常: %v", err)
+		}
+	}()
+	return nil
+}
+
+func (p *program) Stop(s kardsvc.Service) error {
+	log.Println("收到关机信号，正在优雅关闭...")
+	if p.server == nil {
+		return nil
+	}
+	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
+	defer cancel()
+	if err := p.server.Shutdown(ctx); err != nil {
+		log.Printf("HTTP 服务关闭异常: %v", err)
+		return err
+	}
+	log.Println("姜十三论坛已安全退出")
+	return nil
+}
+
+func (p *program) setup() error {
+	cfg := p.cfg
+	cfg.Version = version
+
+	logFile, err := os.OpenFile(cfg.LogFile, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
+	if err != nil {
+		return fmt.Errorf("打开日志文件失败: %w", err)
+	}
+	// 服务模式下 stdout 可能不可用，仅写文件；前台运行则双写
+	if kardsvc.Interactive() {
+		log.SetOutput(io.MultiWriter(os.Stdout, logFile))
+	} else {
+		log.SetOutput(logFile)
+	}
+	log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
+
+	log.Println("========================================")
+	log.Println("  姜十三论坛 Jiang13 Forum 启动中...")
+	log.Printf("  版本: %s", version)
+	log.Println("========================================")
+
+	if err := models.InitDB(models.DatabaseConfig{
+		Type:             cfg.DB.Type,
+		DSN:              cfg.DB.DSN,
+		SQLitePath:       cfg.DB.SQLitePath,
+		MaxOpenConns:     cfg.DB.MaxOpenConns,
+		MaxIdleConns:     cfg.DB.MaxIdleConns,
+		ConnMaxLifetimeSec: cfg.DB.ConnMaxLifetimeSec,
+	}); err != nil {
+		return fmt.Errorf("数据库初始化失败: %w", err)
+	}
+
+	engine, err := routers.Setup(cfg)
+	if err != nil {
+		return fmt.Errorf("路由初始化失败: %w", err)
+	}
+
+	addr := cfg.ListenAddr()
+	p.server = &http.Server{
+		Addr:    addr,
+		Handler: engine,
+	}
+
+	log.Printf("姜十三论坛已启动: http://localhost:%d", cfg.Port)
+	log.Printf("后台管理地址: http://localhost:%d/admin/dashboard", cfg.Port)
+	log.Printf("工作目录: %s", cfg.WorkPath)
+	log.Printf("数据目录: %s", cfg.DataDir)
+	log.Printf("数据库: %s", cfg.DB.Type)
+	return nil
+}
+
+func buildServiceConfig(cfg *config.Config) (*kardsvc.Config, error) {
+	// 服务绑定工作目录与数据目录；改端口 / DB_* 需重启进程（可用 Env 或重装服务参数）
+	args := []string{
+		"--work-path", cfg.WorkPath,
+		"--data", cfg.DataDir,
+		"--port", fmt.Sprintf("%d", cfg.Port),
+		"--db-type", cfg.DB.Type,
+	}
+	if cfg.DB.Type == config.DBTypeSQLite {
+		args = append(args, "--db-dsn", cfg.DB.SQLitePath)
+	} else if cfg.DB.DSN != "" {
+		args = append(args, "--db-dsn", cfg.DB.DSN)
+	}
+	return &kardsvc.Config{
+		Name:             svcName,
+		DisplayName:      svcDisplayName,
+		Description:      svcDescription,
+		WorkingDirectory: cfg.WorkPath,
+		Arguments:        args,
+		Option: kardsvc.KeyValue{
+			// systemd：异常退出后自动拉起
+			"Restart": "always",
+			// Windows：崩溃后重启
+			"OnFailure": "restart",
+		},
+	}, nil
+}
+
+func runServiceControl(s kardsvc.Service, action string) error {
+	if action == "status" {
+		st, err := s.Status()
+		if err != nil {
+			return err
+		}
+		switch st {
+		case kardsvc.StatusRunning:
+			fmt.Println("服务状态: 运行中 (running)")
+		case kardsvc.StatusStopped:
+			fmt.Println("服务状态: 已停止 (stopped)")
+		default:
+			fmt.Println("服务状态: 未知 (unknown)")
+		}
+		return nil
+	}
+
+	if err := kardsvc.Control(s, action); err != nil {
+		return err
+	}
+
+	switch action {
+	case "install":
+		fmt.Println("服务已安装。可用以下命令启动：")
+		fmt.Printf("  %s --service start\n", os.Args[0])
+		fmt.Println("或使用系统工具：")
+		fmt.Println("  Linux:   sudo systemctl start jiang13 && sudo systemctl enable jiang13")
+		fmt.Println("  Windows: Start-Service jiang13")
+	case "uninstall":
+		fmt.Println("服务已卸载")
+	case "start":
+		fmt.Println("服务已启动")
+	case "stop":
+		fmt.Println("服务已停止")
+	case "restart":
+		fmt.Println("服务已重启")
+	}
+	return nil
+}
--- a/config/config.go
+++ b/config/config.go
@@ -1,81 +1,341 @@
 package config

 import (
+	"crypto/rand"
+	"encoding/base64"
 	"flag"
 	"fmt"
+	"net/url"
 	"os"
 	"path/filepath"
+	"strconv"
+	"strings"
 )

-// Config 应用全局配置，通过命令行参数注入
-type Config struct {
-	// 监听端口
-	Port int
-	// 数据目录：SQLite 数据库、上传头像、日志文件均存放于此
-	DataDir string
-	// JWT 签名密钥
-	JWTSecret string
-	// 日志文件路径（相对 DataDir）
-	LogFile string
+const (
+	defaultPort    = 3000
+	defaultDataRel = "data"
+
+	DBTypeSQLite   = "sqlite"
+	DBTypePostgres = "postgres"
+	DBTypeMySQL    = "mysql"
+
+	// StorageTypeLocal / StorageTypeS3 上传存储后端（管理后台运行时配置）
+	StorageTypeLocal = "local"
+	StorageTypeS3    = "s3"
+)
+
+// DatabaseConfig 数据库引导配置（需重启）
+type DatabaseConfig struct {
+	Type     string // sqlite | postgres | mysql
+	DSN      string // 非空则优先
+	Host     string
+	User     string
+	Password string
+	Name     string
+	SSLMode  string // postgres
+	// SQLite 文件路径（Type=sqlite 时由 DataDir 推导或 DSN）
+	SQLitePath string
+
+	MaxOpenConns    int
+	MaxIdleConns    int
+	ConnMaxLifetimeSec int
 }

-// Parse 解析命令行参数并初始化目录
+// Config 进程引导配置：仅 CLI / 环境变量（无 INI）
+type Config struct {
+	WorkPath      string
+	HTTPAddr      string // 空表示 0.0.0.0
+	Port          int
+	DataDir       string
+	JWTSecret     string
+	LogFile       string
+	ServiceAction string
+	DevMode       bool
+	Version       string // 构建版本（ldflags）；用于 /ssr-assets ?v= 缓存穿透
+	DB            DatabaseConfig
+}
+
+// Parse 解析命令行与环境变量并准备数据目录
+// 优先级：命令行显式参数 > 环境变量 > 内置默认
 func Parse() (*Config, error) {
-	port := flag.Int("port", 3000, "HTTP 监听端口")
-	dataDir := flag.String("data", "./data", "数据存储目录（数据库、上传、日志）")
-	jwtSecret := flag.String("jwt-secret", "", "JWT 签名密钥（留空则自动生成并持久化）")
+	workFlag := flag.String("work-path", "", "工作目录（默认：可执行文件所在目录）")
+	portFlag := flag.Int("port", 0, "HTTP 监听端口（0 表示用环境变量或默认 3000）")
+	addrFlag := flag.String("http-addr", "", "HTTP 监听地址（默认空=全接口）")
+	dataFlag := flag.String("data", "", "数据存储目录")
+	dbTypeFlag := flag.String("db-type", "", "数据库类型：sqlite|postgres|mysql")
+	dbDSNFlag := flag.String("db-dsn", "", "数据库 DSN（优先于拆分参数）")
+	dbHostFlag := flag.String("db-host", "", "数据库主机")
+	dbUserFlag := flag.String("db-user", "", "数据库用户")
+	dbPassFlag := flag.String("db-pass", "", "数据库密码")
+	dbNameFlag := flag.String("db-name", "", "数据库名")
+	dbSSLFlag := flag.String("db-sslmode", "", "PostgreSQL sslmode")
+	serviceFlag := flag.String("service", "", "系统服务控制：install|uninstall|start|stop|restart|status")
+	devFlag := flag.Bool("dev", false, "开发模式")
+	_ = flag.String("config", "", "已废弃：不再使用 ini 配置文件")
+	_ = flag.String("jwt-secret", "", "已废弃：JWT 仅使用 data/.jwt_secret")
 	flag.Parse()

-	// 确保数据目录存在
-	if err := os.MkdirAll(*dataDir, 0755); err != nil {
-		return nil, fmt.Errorf("创建数据目录失败: %w", err)
+	action := strings.ToLower(strings.TrimSpace(*serviceFlag))
+	if action != "" && !validServiceAction(action) {
+		return nil, fmt.Errorf("无效的 -service 动作 %q，可选：install|uninstall|start|stop|restart|status", *serviceFlag)
 	}
-	uploadDir := filepath.Join(*dataDir, "uploads", "avatars")
-	if err := os.MkdirAll(uploadDir, 0755); err != nil {
-		return nil, fmt.Errorf("创建上传目录失败: %w", err)
+
+	workPathInput := firstNonEmpty(*workFlag, envOrDefault(envWorkPath))
+	workPath, err := resolveWorkPath(workPathInput)
+	if err != nil {
+		return nil, err
+	}
+
+	port := defaultPort
+	if p := envIntOrZero(envHTTPPort); p > 0 {
+		port = p
+	}
+	if *portFlag > 0 {
+		port = *portFlag
+	}
+
+	httpAddr := firstNonEmpty(*addrFlag, envOrDefault(envHTTPAddr))
+
+	dataInput := firstNonEmpty(*dataFlag, envOrDefault(envData), defaultDataRel)
+	absData, err := absPath(workPath, dataInput)
+	if err != nil {
+		return nil, fmt.Errorf("解析数据目录失败: %w", err)
+	}
+
+	dbCfg, err := buildDatabaseConfig(absData, dbFlags{
+		Type: *dbTypeFlag, DSN: *dbDSNFlag, Host: *dbHostFlag,
+		User: *dbUserFlag, Pass: *dbPassFlag, Name: *dbNameFlag, SSL: *dbSSLFlag,
+	})
+	if err != nil {
+		return nil, err
 	}

 	cfg := &Config{
-		Port:      *port,
-		DataDir:   *dataDir,
-		JWTSecret: *jwtSecret,
-		LogFile:   filepath.Join(*dataDir, "jiang13.log"),
+		WorkPath:      workPath,
+		HTTPAddr:      httpAddr,
+		Port:          port,
+		DataDir:       absData,
+		LogFile:       filepath.Join(absData, "jiang13.log"),
+		ServiceAction: action,
+		DevMode:       *devFlag,
+		DB:            dbCfg,
 	}

-	// 处理 JWT 密钥持久化
-	secretFile := filepath.Join(*dataDir, ".jwt_secret")
-	if cfg.JWTSecret == "" {
-		if data, err := os.ReadFile(secretFile); err == nil && len(data) > 0 {
-			cfg.JWTSecret = string(data)
-		} else {
-			cfg.JWTSecret = generateRandomSecret(32)
-			_ = os.WriteFile(secretFile, []byte(cfg.JWTSecret), 0600)
+	needDirs := action == "" || action == "install"
+	if needDirs {
+		if err := ensureDataDirs(absData); err != nil {
+			return nil, err
+		}
+		if err := cfg.resolveJWT(); err != nil {
+			return nil, err
 		}
 	}

 	return cfg, nil
 }

-// DBPath 返回 SQLite 数据库文件路径
-func (c *Config) DBPath() string {
-	return filepath.Join(c.DataDir, "jiang13.db")
+type dbFlags struct {
+	Type, DSN, Host, User, Pass, Name, SSL string
 }

-// UploadDir 返回头像上传目录
-func (c *Config) UploadDir() string {
+func buildDatabaseConfig(dataDir string, f dbFlags) (DatabaseConfig, error) {
+	typ := strings.ToLower(firstNonEmpty(f.Type, envOrDefault(envDBType), DBTypeSQLite))
+	switch typ {
+	case "sqlite", "sqlite3":
+		typ = DBTypeSQLite
+	case "postgres", "postgresql", "pg":
+		typ = DBTypePostgres
+	case "mysql", "mariadb":
+		typ = DBTypeMySQL
+	default:
+		return DatabaseConfig{}, fmt.Errorf("不支持的数据库类型 %q，可选：sqlite|postgres|mysql", typ)
+	}
+
+	out := DatabaseConfig{
+		Type:                typ,
+		DSN:                 firstNonEmpty(f.DSN, envOrDefault(envDBDSN)),
+		Host:                firstNonEmpty(f.Host, envOrDefault(envDBHost)),
+		User:                firstNonEmpty(f.User, envOrDefault(envDBUser)),
+		Password:            firstNonEmpty(f.Pass, envOrDefault(envDBPass)),
+		Name:                firstNonEmpty(f.Name, envOrDefault(envDBName)),
+		SSLMode:             firstNonEmpty(f.SSL, envOrDefault(envDBSSLMode), "disable"),
+		MaxOpenConns:        envIntDefault(envDBMaxOpen, 0),
+		MaxIdleConns:        envIntDefault(envDBMaxIdle, 0),
+		ConnMaxLifetimeSec:    envIntDefault(envDBConnLife, 0),
+	}
+
+	if typ == DBTypeSQLite {
+		if out.DSN != "" {
+			out.SQLitePath = out.DSN
+		} else {
+			out.SQLitePath = filepath.Join(dataDir, "jiang13.db")
+			out.DSN = out.SQLitePath
+		}
+		if out.MaxOpenConns == 0 {
+			out.MaxOpenConns = 1
+		}
+		if out.MaxIdleConns == 0 {
+			out.MaxIdleConns = 1
+		}
+		return out, nil
+	}
+
+	if out.DSN == "" {
+		dsn, err := buildDSN(out)
+		if err != nil {
+			return DatabaseConfig{}, err
+		}
+		out.DSN = dsn
+	}
+	if out.MaxOpenConns == 0 {
+		out.MaxOpenConns = 25
+	}
+	if out.MaxIdleConns == 0 {
+		out.MaxIdleConns = 5
+	}
+	if out.ConnMaxLifetimeSec == 0 {
+		out.ConnMaxLifetimeSec = 300
+	}
+	return out, nil
+}
+
+func buildDSN(c DatabaseConfig) (string, error) {
+	if c.Host == "" || c.User == "" || c.Name == "" {
+		return "", fmt.Errorf("%s 需要 JIANG13_DB_DSN，或 JIANG13_DB_HOST/USER/NAME（及可选 PASS）", c.Type)
+	}
+	switch c.Type {
+	case DBTypePostgres:
+		u := url.URL{
+			Scheme: "postgres",
+			User:   url.UserPassword(c.User, c.Password),
+			Host:   c.Host,
+			Path:   "/" + c.Name,
+		}
+		q := url.Values{}
+		q.Set("sslmode", c.SSLMode)
+		u.RawQuery = q.Encode()
+		return u.String(), nil
+	case DBTypeMySQL:
+		// 特殊字符密码请直接用 JIANG13_DB_DSN；此处为拆分参数简易拼接
+		return fmt.Sprintf("%s:%s@tcp(%s)/%s?parseTime=true&loc=Local&charset=utf8mb4",
+			c.User, c.Password, c.Host, c.Name), nil
+	default:
+		return "", fmt.Errorf("无法为 %s 拼接 DSN", c.Type)
+	}
+}
+
+func resolveWorkPath(flagVal string) (string, error) {
+	if strings.TrimSpace(flagVal) != "" {
+		abs, err := filepath.Abs(flagVal)
+		if err != nil {
+			return "", fmt.Errorf("解析工作目录失败: %w", err)
+		}
+		return filepath.Clean(abs), nil
+	}
+	return defaultWorkPath()
+}
+
+func ensureDataDirs(dataDir string) error {
+	if err := os.MkdirAll(dataDir, 0755); err != nil {
+		return fmt.Errorf("创建数据目录失败: %w", err)
+	}
+	for _, sub := range []string{
+		filepath.Join(dataDir, "uploads", "avatars"),
+		filepath.Join(dataDir, "uploads", "posts"),
+		filepath.Join(dataDir, "uploads", "site"),
+	} {
+		if err := os.MkdirAll(sub, 0755); err != nil {
+			return fmt.Errorf("创建上传目录失败: %w", err)
+		}
+	}
+	return nil
+}
+
+func (c *Config) resolveJWT() error {
+	secretFile := filepath.Join(c.DataDir, ".jwt_secret")
+	if data, err := os.ReadFile(secretFile); err == nil && len(bytesTrimSpace(data)) > 0 {
+		c.JWTSecret = string(bytesTrimSpace(data))
+		return nil
+	}
+	sec, err := generateRandomSecret(32)
+	if err != nil {
+		return err
+	}
+	c.JWTSecret = sec
+	if err := os.WriteFile(secretFile, []byte(c.JWTSecret), 0600); err != nil {
+		return fmt.Errorf("写入 JWT 密钥失败: %w", err)
+	}
+	return nil
+}
+
+func bytesTrimSpace(b []byte) []byte {
+	return []byte(strings.TrimSpace(string(b)))
+}
+
+func validServiceAction(action string) bool {
+	switch action {
+	case "install", "uninstall", "start", "stop", "restart", "status":
+		return true
+	default:
+		return false
+	}
+}
+
+// ListenAddr 返回 host:port
+func (c *Config) ListenAddr() string {
+	if c.HTTPAddr == "" {
+		return fmt.Sprintf(":%d", c.Port)
+	}
+	return fmt.Sprintf("%s:%d", c.HTTPAddr, c.Port)
+}
+
+// SQLitePath 兼容旧调用：仅 sqlite 有意义
+func (c *Config) DBPath() string {
+	if c.DB.Type == DBTypeSQLite {
+		return c.DB.SQLitePath
+	}
+	return c.DB.DSN
+}
+
+func (c *Config) AvatarUploadDir() string {
 	return filepath.Join(c.DataDir, "uploads", "avatars")
 }
-
-// FilterWordsPath 返回敏感词配置文件路径
+func (c *Config) PostImageUploadDir() string {
+	return filepath.Join(c.DataDir, "uploads", "posts")
+}
+func (c *Config) SiteUploadDir() string {
+	return filepath.Join(c.DataDir, "uploads", "site")
+}
 func (c *Config) FilterWordsPath() string {
 	return filepath.Join(c.DataDir, "filter_words.txt")
 }

-func generateRandomSecret(n int) string {
-	const chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
+func generateRandomSecret(n int) (string, error) {
 	b := make([]byte, n)
-	for i := range b {
-		b[i] = chars[i%len(chars)]
+	if _, err := rand.Read(b); err != nil {
+		return "", fmt.Errorf("生成密钥失败: %w", err)
 	}
-	return string(b)
+	return base64.RawURLEncoding.EncodeToString(b), nil
+}
+
+func firstNonEmpty(vals ...string) string {
+	for _, v := range vals {
+		if strings.TrimSpace(v) != "" {
+			return strings.TrimSpace(v)
+		}
+	}
+	return ""
+}
+
+func envIntDefault(key string, def int) int {
+	v := envOrDefault(key)
+	if v == "" {
+		return def
+	}
+	n, err := strconv.Atoi(v)
+	if err != nil || n < 0 {
+		return def
+	}
+	return n
 }
--- a/config/env.go
+++ b/config/env.go
@@ -0,0 +1,41 @@
+package config
+
+import (
+	"os"
+	"strconv"
+	"strings"
+)
+
+// 引导环境变量（无 INI）
+const (
+	envWorkPath  = "JIANG13_WORK_PATH"
+	envHTTPPort  = "JIANG13_HTTP_PORT"
+	envHTTPAddr  = "JIANG13_HTTP_ADDR"
+	envData      = "JIANG13_DATA"
+	envDBType    = "JIANG13_DB_TYPE"
+	envDBDSN     = "JIANG13_DB_DSN"
+	envDBHost    = "JIANG13_DB_HOST"
+	envDBUser    = "JIANG13_DB_USER"
+	envDBPass    = "JIANG13_DB_PASS"
+	envDBName    = "JIANG13_DB_NAME"
+	envDBSSLMode = "JIANG13_DB_SSLMODE"
+	envDBMaxOpen = "JIANG13_DB_MAX_OPEN"
+	envDBMaxIdle = "JIANG13_DB_MAX_IDLE"
+	envDBConnLife = "JIANG13_DB_CONN_MAX_LIFETIME_SEC"
+)
+
+func envOrDefault(key string) string {
+	return strings.TrimSpace(os.Getenv(key))
+}
+
+func envIntOrZero(key string) int {
+	v := envOrDefault(key)
+	if v == "" {
+		return 0
+	}
+	n, err := strconv.Atoi(v)
+	if err != nil || n <= 0 || n > 65535 {
+		return 0
+	}
+	return n
+}
--- a/config/paths.go
+++ b/config/paths.go
@@ -0,0 +1,69 @@
+package config
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"runtime"
+	"strings"
+)
+
+// resolveAppPath 返回可执行文件的绝对路径（解析符号链接）
+func resolveAppPath() (string, error) {
+	exe, err := os.Executable()
+	if err != nil {
+		return "", fmt.Errorf("获取可执行文件路径失败: %w", err)
+	}
+	exe, err = filepath.EvalSymlinks(exe)
+	if err != nil {
+		return "", fmt.Errorf("解析可执行文件路径失败: %w", err)
+	}
+	return exe, nil
+}
+
+// defaultWorkPath 类似 Gitea：默认可执行文件所在目录；
+// go run 时二进制在临时目录，回退为当前工作目录。
+func defaultWorkPath() (string, error) {
+	exe, err := resolveAppPath()
+	if err != nil {
+		return "", err
+	}
+	dir := filepath.Dir(exe)
+	if isEphemeralExeDir(dir) {
+		wd, err := os.Getwd()
+		if err != nil {
+			return "", fmt.Errorf("获取当前目录失败: %w", err)
+		}
+		return filepath.Clean(wd), nil
+	}
+	return dir, nil
+}
+
+func isEphemeralExeDir(dir string) bool {
+	lower := strings.ToLower(filepath.Clean(dir))
+	sep := string(filepath.Separator)
+	markers := []string{
+		sep + "go-build",
+		sep + "go-run",
+	}
+	if runtime.GOOS == "windows" {
+		markers = append(markers, "\\go-build", "\\go-run")
+	}
+	for _, m := range markers {
+		if strings.Contains(lower, strings.ToLower(m)) {
+			return true
+		}
+	}
+	return false
+}
+
+func absPath(base, p string) (string, error) {
+	p = strings.TrimSpace(p)
+	if p == "" {
+		return "", fmt.Errorf("路径为空")
+	}
+	if filepath.IsAbs(p) {
+		return filepath.Clean(p), nil
+	}
+	return filepath.Abs(filepath.Join(base, p))
+}
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -0,0 +1,37 @@
+# 姜十三论坛 — Docker Compose 单服务部署
+# 启动：docker compose up -d --build
+# 或：make compose-up / build.bat -Target compose-up
+#
+# 默认 SQLite（数据在 /data）。换库示例：
+#   JIANG13_DB_TYPE=postgres
+#   JIANG13_DB_DSN=postgres://forum:secret@host:5432/jiang13?sslmode=disable
+#   JIANG13_DB_TYPE=mysql
+#   JIANG13_DB_DSN=forum:secret@tcp(host:3306)/jiang13?parseTime=true&loc=Local&charset=utf8mb4
+
+services:
+  jiang13:
+    image: hangzhang714128/jiang13-forum:latest
+    build:
+      context: .
+      dockerfile: Dockerfile
+      args:
+        VERSION: dev
+    ports:
+      - "3000:3000"
+    volumes:
+      - jiang13-data:/data
+    environment:
+      TZ: Asia/Shanghai
+      # JIANG13_DB_TYPE: sqlite
+      # JIANG13_HTTP_PORT: "3000"
+    restart: unless-stopped
+    stop_grace_period: 15s
+    healthcheck:
+      test: ["CMD", "wget", "-qO-", "http://127.0.0.1:3000/health"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+      start_period: 15s
+
+volumes:
+  jiang13-data:
--- a/docker-entrypoint.sh
+++ b/docker-entrypoint.sh
@@ -0,0 +1,15 @@
+#!/bin/sh
+set -e
+
+# 宿主机 / 1Panel 挂载的 volume 常为 root 所有（uid 0），
+# 而应用以 jiang13（uid 1000）运行，需在启动时修正 /data 权限后降权。
+
+DATA_DIR="/data"
+
+if [ "$(id -u)" = '0' ]; then
+	mkdir -p "$DATA_DIR"
+	chown -R jiang13:jiang13 "$DATA_DIR"
+	exec su-exec jiang13 /app/jiang13 "$@"
+fi
+
+exec /app/jiang13 "$@"
--- a/docs/introduction.md
+++ b/docs/introduction.md
@@ -0,0 +1,158 @@
+# 姜十三论坛：为小圈子而生的轻量论坛
+
+> 轻量 · 好看 · 单文件部署  
+> 面向内部交流，不堆功能，把「能聊、好看、好装」做到位。
+
+---
+
+## 它是什么
+
+**姜十三论坛（Jiang13 Forum）** 是一款面向小圈子、团队与兴趣社群的现代化论坛软件。
+
+它不做「大而全」的社区平台，而是聚焦一件事：让几个人到几百人的内部交流，有一个干净、顺手、自己能掌控的地方。
+
+技术上，它是一个编译为 **单个 Go 二进制** 的 Web 应用：公开页用 **Go `html/template` 真 SSR**，`web_src` 做渐进增强 CSS/JS（`go:embed`），数据库默认 **SQLite**，拷贝到服务器就能跑。
+
+---
+
+## 为什么做它
+
+市面上的论坛方案往往落在两端：
+
+- **重型产品**（Discourse、phpBB 等）：功能完整，但部署与运维成本高，对小团队过重。
+- **即时通讯 / 文档工具**：适合聊天与协作，却缺少「发帖—回复—沉淀」的社区节奏。
+
+小圈子真正需要的，常常是中间态：
+
+- 有板块、帖子、楼层回复，讨论可追溯；
+- 界面清爽、信息密度够高，桌面与手机都好用；
+- 部署简单到「一个文件 + 一份配置」；
+- 数据在自己手里，备份一眼能懂。
+
+姜十三论坛正是为这个缺口而生。
+
+---
+
+## 谁适合用
+
+| 场景 | 说明 |
+|------|------|
+| 团队 / 工作室内部论坛 | 需求讨论、进度同步、知识沉淀 |
+| 兴趣小圈子 | 同好交流、作品分享、活动组织 |
+| 开源 / 私有项目配套社区 | 与 Gitea 等工具通过 OIDC（开放身份连接）做 SSO（单点登录） |
+| 想自己托管的个人站长 | 单机即可，无需云数据库与一堆微服务 |
+
+如果你需要百万用户级的公网社区、复杂插件生态或企业级工单流，它可能不是最优选；如果你要的是 **小而美、自己能装、自己能管**，它会对胃口。
+
+---
+
+## 用起来是什么感觉
+
+### 浏览：高密度、不臃肿
+
+前台采用熟悉的 **三栏布局**：
+
+- **左栏**：板块导航，可折叠；
+- **中间**：帖子 Feed（信息流），支持虚拟滚动，长列表依然流畅；
+- **右栏**：热门帖与最新评论，社区动态一目了然。
+
+Feed 可按 **最新发帖 / 最新回复 / 热门讨论** 切换。浅色与暗色主题一键切换，并会记住你的偏好。平板与手机上侧栏会自动收起，触控浏览同样顺手。
+
+整体气质更接近 V2EX / NGA 一类的信息密度——一屏能看更多内容，而不是大留白的营销站。
+
+### 发帖：Markdown，够用就好
+
+发帖使用 **Markdown 工具栏**（标题、粗斜体、列表、代码块、图片上传、内容门控插入）与服务端预览；标签、板块选择日常写帖够用。帖子支持置顶；编辑后保留 **修订历史**。管理员还可配置普通用户的 **编辑时限**，避免无限制改稿。
+
+### 讨论：楼层回复，聊得清楚
+
+评论是楼层式的：可回复指定楼层、引用原文；支持嵌套展示。点赞、收藏、热门帖，把活跃内容自然推到前面。
+
+### 管理：SSR 后台
+
+管理后台统一在 `/admin`，与公开页同一套模板布局：
+
+- 仪表盘、板块与帖子管理
+- 用户禁言、删帖删评
+- 论坛参数、限流、敏感词
+- SQLite **一键备份**
+
+权限模型很简单：**普通用户 / 管理员**；首次通过 **安装向导** 创建管理员账号。
+
+---
+
+## 部署：一个文件，真正开箱
+
+这大概是姜十三论坛最「硬核」的卖点之一。
+
+```text
+编译 → 得到一个 jiang13（或 jiang13.exe）
+放到目录里运行 → Env / CLI 引导（默认 SQLite）
+打开浏览器完成安装向导 → 创建管理员
+```
+
+要点：
+
+- **单二进制**：静态资源已内嵌，不必再配 Nginx 专门反代前端文件；
+- **零外部数据库**：SQLite 落在数据目录，备份就是拷贝文件；
+- **Env / CLI 引导**：端口、数据目录、数据库类型；业务项在管理后台热更新；
+- **系统服务**：内置 Linux systemd / Windows Service 安装与启停；
+- **跨平台**：Windows / Linux / macOS 均可编译与运行。
+
+典型启动后访问 `http://localhost:3000`，完成安装后即可开始。
+
+---
+
+## 技术素描（给好奇的人）
+
+| 层级 | 技术 |
+|------|------|
+| 后端 / SSR | Go · Gin · GORM · SQLite · `html/template` |
+| 渐进资源 | `web_src` → `public/assets`（`/ssr-assets/`） |
+| 构建 | `web_src` + `go:embed` templates/assets，单二进制 |
+| 认证 | bcrypt + 会话 Cookie；可选 OIDC Provider，对接 Gitea 等 SSO |
+
+对运维者：数据目录结构清晰（数据库、日志、上传、敏感词、备份）。对开发者：改模板/Go 后重启进程；改 `web_src` 后跑 `build.bat -Target web-src`。
+
+---
+
+## 现在走到哪一步
+
+项目仍在积极开发中，核心体验已经可用（分支 `rebuild/gitea-ssr`）：
+
+- ✅ 三栏布局、主题切换、Feed 排序、真 SSR 公开页
+- ✅ 发帖 / 评论 / 点赞收藏 / 修订历史（Markdown 编辑器）
+- ✅ SSR 管理后台与论坛参数配置
+- ✅ OIDC Provider（可作 Gitea 等站点的登录源）
+- ✅ 单二进制部署与系统服务
+
+计划中的方向见仓库 [ROADMAP.md](../ROADMAP.md) 与 [09-ssr-progress.md](rebuild-spec/09-ssr-progress.md)。
+
+---
+
+## 一句话总结
+
+**姜十三论坛** = 小圈子论坛该有的功能 × 清新好用的界面 × 真正能单文件带走的部署方式。
+
+如果你正在给团队或同好找一个「自己的小论坛」，不妨编译跑一下：注册第一个账号，从发第一帖开始。
+
+---
+
+## 快速上手
+
+```bash
+# Windows
+.\build.bat
+
+# Linux / macOS
+make build
+
+# 运行
+./dist/jiang13        # 或 Windows: .\dist\jiang13.exe
+```
+
+浏览器打开 `http://localhost:3000/register`，第一个注册用户即为管理员。
+
+更多细节（配置项、系统服务、前端开发）见项目 [README](../README.md)。欢迎通过 Issue / PR 参与共建。
+
+**许可证：** MIT
--- a/docs/issue-templates.md
+++ b/docs/issue-templates.md
@@ -0,0 +1,65 @@
+# Issue 预填模板
+
+以下可直接复制到本仓库 Issues 创建。本分支为 **SSR**（`rebuild/gitea-ssr`）；对照 SPA 请注明 `main`。
+
+---
+
+## Issue · Bug 模板
+
+**标题：** `[Bug] 简短描述`
+
+**标签：** `bug` `ui/ux`
+
+**正文：**
+
+### 问题描述
+
+（一句话）
+
+### 复现步骤
+
+1. …
+2. …
+
+### 期望行为 / 实际行为
+
+### 相关代码（若已知）
+
+- 模板：`templates/…`
+- 路由：`routers/web/…`
+- 样式/脚本：`web_src/…`
+
+### 环境
+
+- 分支：`rebuild/gitea-ssr`（或 `main` SPA）
+- 浏览器 / OS
+
+---
+
+## Issue · 功能增强模板
+
+**标题：** `[Feature] 简短描述`
+
+**标签：** `enhancement`
+
+**正文：**
+
+### 要解决的问题
+
+### 现状
+
+| 能力 | 状态 |
+| --- | --- |
+| 规格（`docs/rebuild-spec`） | ✅ / ❌ |
+| SSR 页面 / 表单 | ✅ / ❌ |
+| 业务 `services/` | ✅ / ❌ |
+
+### 期望方案
+
+1. …
+2. …
+
+### 相关代码
+
+- `routers/web/`、`templates/`、`services/`
+- 规格：`docs/rebuild-spec/02-features.md` / `06-pages-ux.md`
--- a/docs/rebuild-spec/01-product.md
+++ b/docs/rebuild-spec/01-product.md
@@ -0,0 +1,185 @@
+# 01 · 产品定位与模块地图
+
+> **读者**：重构架构师 / 产品对齐  
+> **前置**：[README.md](README.md)  
+> **后续**：[02-features.md](02-features.md)  
+> **源码**：[docs/introduction.md](../introduction.md)、[README.md](../../README.md)
+
+---
+
+## 1. 定位
+
+姜十三论坛不做大而全公网社区，只服务「几人到几百人」的内部交流：
+
+| 场景 | 说明 |
+|------|------|
+| 团队 / 工作室 | 需求讨论、进度同步、知识沉淀 |
+| 兴趣小圈子 | 同好交流、作品分享、活动组织 |
+| 项目配套社区 | 可与 Gitea 通过 OIDC（开放身份连接）做 SSO（单点登录） |
+| 个人站长 | 希望数据自管、部署简单 |
+
+**产品口号气质**：能聊 · 好看 · 好装（部署简单）。
+
+**规模预期**：非百万用户级；信息密度接近 V2EX / NGA 一类，而非大留白营销站。
+
+---
+
+## 2. 产品 vs 运维（拆开看待）
+
+| 维度 | 当前实现 | 重构时 |
+|------|----------|--------|
+| **产品** | 论坛功能全集（见模块地图） | **必须对齐**功能与规则 |
+| **运维** | 单二进制 + Env 引导 + SQLite/PG/MySQL + `forum_settings` 热更 | **本分支已落地**；无 `app.ini` |
+
+规格文档把「用户能做什么」写死；把「怎么打包发布」放在 [07-config-ops.md](07-config-ops.md) 供参考。
+
+---
+
+## 3. 角色模型
+
+| 角色 | 识别 | 能力摘要 |
+|------|------|----------|
+| **游客** | 未登录 | 浏览公开内容；可发表游客评论（需昵称等）；门控内容按规则遮盖 |
+| **登录用户** | JWT Cookie 有效且未禁言 | 发帖、评论、点赞收藏、私信、签到抽奖、友链申请、举报等 |
+| **认证用户** | `user.verified = true` | 与管理员一样：**发帖/评论免审**（`SkipsModeration`） |
+| **管理员** | `role = admin` | 全部后台能力；免审；看待审/被拒内容 |
+| **系统** | 私信 `from_user_id = 0` | 发系统通知（审核、回复提醒、举报结果等） |
+
+**引导规则**：站点**第一个注册用户自动成为管理员**（无安装向导单独建管步骤）。
+
+禁言用户（`banned`）：带鉴权的写接口被拒绝；浏览策略以实现为准，前端通常视为不可正常互动。
+
+---
+
+## 4. 模块地图
+
+```mermaid
+flowchart TB
+  subgraph core [核心社区]
+    auth[认证与账号]
+    board[板块]
+    feed[Feed与搜索]
+    post[帖子与特殊类型]
+    comment[评论]
+    gate[内容门控]
+  end
+  subgraph social [社交]
+    like[点赞收藏]
+    msg[私信与通知]
+    profile[用户主页]
+    report[举报]
+  end
+  subgraph economy [经济与成长]
+    points[积分钱包]
+    checkin[签到抽奖]
+    badge[徽章]
+    level[等级Exp]
+  end
+  subgraph site [站点扩展]
+    page[自定义单页]
+    links[友情链接]
+    gitea[Gitea码桶]
+    brand[品牌与SEO]
+  end
+  subgraph admin [管理与集成]
+    mod[审核回收站]
+    settings[系统设置]
+    oidc[OIDC Provider]
+    storage[本地或S3存储]
+    mail[SMTP邮件]
+  end
+  auth --> feed
+  board --> feed
+  feed --> post
+  post --> comment
+  post --> gate
+  post --> like
+  comment --> msg
+  points --> gate
+  points --> checkin
+  auth --> oidc
+  settings --> mail
+  settings --> storage
+```
+
+### 4.1 认证与账号
+
+- 注册 / 登录 / 登出；可选邮箱验证码；忘记密码重置
+- 图形验证码（注册场景）
+- 个人资料：昵称、签名、头像、改密
+- 邮件未配置时可能关闭公开注册（见业务规则）
+
+### 4.2 板块与 Feed
+
+- 多板块；图标与色板；排序
+- 首页「全部」+ `/board/:id`
+- 排序：最新发帖 / 最新回复 / 热门
+- 搜索：关键词、标签、作者、仅标题
+- 列表样式：仅标题 / 摘要 / 缩略图（后台可配）
+
+### 4.3 帖子
+
+- 富文本正文（HTML，TipTap 产出）+ 可选 Markdown 编辑面
+- 标签、修订历史与 diff
+- 五种类型：`normal` | `question` | `poll` | `bounty` | `lottery`
+- 运营标记：全局置顶、版内置顶、精华、禁止编辑、禁止评论
+- 审核状态：`pending` | `published` | `rejected`；软删回收站
+
+### 4.4 内容门控
+
+正文内嵌自定义标签（非独立表行，存在 `posts.content` HTML 中）：
+
+| 标签 | 含义 |
+|------|------|
+| `<members-only>` | 登录可见 |
+| `<reply-only>` | 本帖已回复可见 |
+| `<points-only data-cost="N">` | 积分解锁；按块计费 |
+
+### 4.5 评论
+
+- 楼层号；回复指定楼；嵌套展示；引用；@ 提及
+- 游客评论字段；私密评论（仅相关人可见）
+- 点赞、编辑时限、审核、软删
+
+### 4.6 积分经济与成长
+
+- **Points**：可消费积分（签到、抽奖、解锁、悬赏托管等）
+- **Exp**：不可消费经验 → 等级 Lv1–10
+- **CreatorIncomeTotal**：创作分成累计（徽章指标）
+- 徽章：自动（门槛）+ 限定（管理员发放）
+
+### 4.7 私信与通知
+
+统一走 `private_messages` 表，用 `kind` 区分用户私信与系统事件。
+
+### 4.8 友链与站点页
+
+- 管理员维护品牌友链 JSON；用户申请审核（可选回链检测）
+- 自定义单页（关于、版规等）：slug、发布、导航/页脚展示
+
+### 4.9 Gitea 开源码桶
+
+后台配置后定时同步公开仓库到 `gitea_repos`，前台 `/projects` 展示。
+
+### 4.10 OIDC Provider
+
+本站作为 IdP：Discovery / Authorize / Token / UserInfo / Logout / JWKS；多 OAuth 客户端。
+
+### 4.11 管理后台
+
+仪表盘、板块、单页、友链、帖/评、举报、用户、徽章、媒体、系统设置、SQLite 备份。
+
+### 4.12 SEO / 发现
+
+`robots.txt`、`sitemap.xml`、Open Graph / Twitter / JSON-LD；当前另有爬虫 HTML。新站应用 SSR 统一，但 **meta 字段集合应保留**（见 [07-config-ops.md](07-config-ops.md)）。
+
+---
+
+## 5. 权限一句话
+
+- **读公开内容**：人人可（含游客）  
+- **写内容**：登录（部分评论允许游客）  
+- **审与运营**：管理员  
+- **免审写**：管理员或 `verified`  
+
+细节状态机见 [05-business-rules.md](05-business-rules.md)。
--- a/docs/rebuild-spec/02-features.md
+++ b/docs/rebuild-spec/02-features.md
@@ -0,0 +1,215 @@
+# 02 · 功能清单（验收级）
+
+> **读者**：实现与验收  
+> **前置**：[01-product.md](01-product.md)  
+> **交叉**：[05-business-rules.md](05-business-rules.md)、[06-pages-ux.md](06-pages-ux.md)  
+> **源码对照**：[`frontend/src/App.tsx`](（仅 main）frontend/src/App.tsx)、[`router/router.go`](../../routers/setup.go)、[`README.md`](../../README.md)
+
+用复选框做验收；重构完成时应全部可勾选（或书面声明砍掉的功能）。
+
+---
+
+## A. 浏览与布局
+
+- [x] 三栏布局：左导航 / 中 Feed / 右栏小组件 — SSR（桌面；≤900px 隐藏右栏）
+- [x] 浅色 / 暗色主题；跟随系统偏好并本地记忆 — CSS `prefers-color-scheme` + `data-theme` 显式覆盖；顶栏循环：跟随系统 / 浅色 / 暗色（`j13-theme`）
+- [ ] 响应式：平板/手机收起侧栏
+- [ ] 长列表虚拟滚动或等价流畅方案
+- [x] Feed 排序：`latest`（最新发帖）/ `reply`（最新回复）/ `hot`（热门）
+- [x] 板块筛选：全部 + 单板块
+- [ ] 列表样式可配：`title` | `excerpt` | `thumbnail`
+- [x] 搜索：关键词、标签、作者、仅标题（`title_only`）— SSR Feed 面板（`/` / `/board/:id`）
+- [x] 右栏：热门帖、标签云、最新评论、最新用户、友链（可开关排序）— SSR 热门固定 + `aside_widgets`；Admin `/admin/settings` 侧栏组件编辑器
+- [x] 登录用户右栏/侧边：签到与抽奖入口 — SSR 右栏条（钱包详情仍在 `/profile#wallet`）
+- [ ] 下拉刷新（移动端）
+- [x] 可选伪静态：`/post/123.html` 等形式（后缀后台可配）— SSR `/admin/settings` 伪静态；公开路径 301 规范 URL
+- [x] 404 页
+
+---
+
+## B. 认证与个人中心
+
+- [x] 注册（用户名、密码、昵称、邮箱；可选邮箱验证码）— SSR `/register`
+- [x] 图形验证码接口（注册流程）— SSR 注册页强制；`GET /api/captcha` + `POST /api/register` 校验
+- [x] 登录 / 登出（opaque session Cookie `jiang13_session`）— SSR；SameSite=Lax；登出/禁言/改密吊销
+- [x] 忘记密码：邮箱验证码 + 重置 — SSR `/forgot-password`（依赖 SMTP 就绪）
+- [x] 注册配置：邮件就绪时强制验证码；安装后开放注册（不依赖 SMTP）
+- [x] ~~首个用户自动成为管理员~~ → 改为仅 `/install` 创建管理员
+- [x] 个人中心：改昵称、签名、密码、上传头像、积分钱包/签到/抽奖 — SSR `/profile`（裁剪未做）
+- [x] 个人活动统计：帖数、评数、收藏数、获赞 — `/profile` + `/user/:id`
+- [x] 公开用户主页 `/user/:id`（无邮箱）
+- [x] 禁言用户无法使用需登录写接口（中间件 + compose 门控）
+
+---
+
+## C. 板块
+
+- [x] 列出板块（含帖数等展示字段）— SSR `/boards` + 侧栏 + Admin
+- [x] 管理员：创建 / 改 / 删板块 — SSR `/admin/boards`
+- [x] 板块名称、描述、图标、色板索引、排序
+- [x] 默认板块保障（空站可引导创建）
+
+---
+
+## D. 帖子（通用）
+
+- [x] 发帖：选板块、标题、标签、正文 — SSR `/compose`（normal）
+- [x] 正文图片上传 — `/compose/upload` + Markdown 插入
+- [ ] TipTap 富文本能力（见 [06-pages-ux.md](06-pages-ux.md) 编辑器节）— **本分支不做 TipTap**；改用 Markdown 工具栏渐进增强
+- [x] Markdown 编辑（工具栏 + `/compose/preview`；发帖/改帖/评论共用 `shared/md_editor`）— 非 TipTap 双模
+- [x] 编辑帖子（时限、锁帖约束）— SSR `/post/:id/edit`
+- [x] 删除帖子 → 软删进回收站 — SSR Admin（帖详情 + `/admin/trash`）
+- [x] 修订历史列表与单条详情（可做 diff）— SSR `/post/:id/revisions`（作者/管理员；无 diff）
+- [x] 点赞切换；收藏切换；收藏列表 — SSR `/favorites`
+- [x] 浏览量 — 详情页计数
+- [x] 举报帖子 — SSR 表单 + `/admin/reports`
+- [x] 内容审核状态展示（作者可见待审/被拒）— SSR 帖详情横幅 + 评论楼层标签
+
+### D.1 帖子类型
+
+- [x] `normal` 普通讨论 — SSR compose 默认
+- [x] `question` 问答：可标记已解决 / 未解决 — SSR compose + 详情徽章与切换
+- [x] `poll` 投票：2–10 选项；单选/多选；可选截止时间；投票；作者可结束 — SSR compose + 详情卡
+- [x] `bounty` 悬赏：发帖托管积分；采纳评论发奖；可退款（规则见 05）— SSR compose + 详情条 + award/refund
+- [x] `lottery` 抽奖帖：设定中奖人数；从评论参与者开奖 — SSR compose + 详情卡 + draw
+
+### D.2 运营标记（管理员）
+
+- [x] 全局置顶 / 取消 — SSR 帖详情
+- [x] 版内置顶 / 取消（仅板块列表抬升）— SSR 帖详情
+- [x] 精华 / 取消 — SSR 帖详情
+- [x] 禁止编辑（edit lock）— SSR 帖详情
+- [x] 禁止评论 / 结贴（comments lock）— SSR 帖详情
+- [x] 审核通过 / 拒绝（拒绝可通知作者）— SSR `/admin/moderation`
+- [x] 回收站：恢复 / 彻底删除 — SSR `/admin/trash`
+
+---
+
+## E. 内容门控
+
+- [x] 编辑器可插入「登录可见」块 — compose 工具栏
+- [x] 编辑器可插入「回复可见」块 — compose 工具栏
+- [x] 编辑器可插入「积分可见」块（可设价格）— compose 工具栏 + prompt
+- [x] 未登录：遮盖 members-only 与 reply-only 正文，保留长度提示 — 锁定壳 UI
+- [x] 已登录未回复：遮盖 reply-only（作者与管理员始终可见）
+- [x] 积分块：未解锁遮盖；`POST /post/:id/unlock` 扣积分并返回 inner HTML
+- [x] 搜索 / SEO 出口对门控内容做红action，不泄露正文（既有）
+
+---
+
+## F. 评论
+
+- [x] 按帖拉取评论列表（楼层、引用目标）— SSR 帖详情；`ThreadParentID` 嵌套树 + 全局 `#floor` 缩进
+- [x] 发表评论（登录）；支持 `reply_to`、私密评论 — `POST /post/:id/comments`
+- [ ] 游客评论（公开接口可写，字段 guest_*）
+- [x] 编辑评论（时限）；删除评论 — SSR 帖详情入口 + `/comments/:cid/edit|delete`；作者软删进回收站
+- [x] 评论点赞 — `POST /post/:id/comments/:cid/like`
+- [x] 评论举报 — SSR
+- [x] @ 提及 → 通知 — SSR 发评/审通调用 `NotifyCommentMentions`
+- [x] 回复提醒（站内信 + 可选邮件）— SSR 发评/审通调用 `NotifyCommentPublished`
+- [x] 审核中 / 被拒评论可见性规则 — 服务层已有；SSR 楼层标签（作者/管理员）
+- [x] 管理员：通过 / 拒绝待审评论 — SSR `/admin/moderation`（回收站/修订未迁）
+
+---
+
+## G. 私信与通知
+
+- [x] 会话列表（含系统会话 peer=0）— SSR `/messages`
+- [x] 会话消息（分页 / before 游标）— SSR `/messages/with/:peerId`
+- [x] 发送私信 — 表单 PRG；用户主页「发私信」入口
+- [x] 未读数（可分私信 / 通知）— 列表分项 + 导航角标
+- [x] 标记会话已读 / 通知已读 / 全部已读 — 打开会话自动已读；全部标已读
+- [x] 系统通知种类：`system` / `reject` / `report_result` / `reply` / `mention` / `moderation` 等（写入已有；`/messages/with/0?kind=` 筛选）
+
+---
+
+## H. 积分、签到、抽奖、徽章、等级
+
+- [x] 积分流水查询 — SSR `/profile` 钱包近 N 条
+- [x] 每日签到：基础 5，连签每日 +1，封顶 15 — `POST /profile/checkin`
+- [x] 每日抽奖：奖池加权（0/2/5/10/20），成本 0 — `POST /profile/lottery`
+- [x] 积分解锁分成：读者付全额，作者约 70% — 门控 unlock 服务
+- [x] 短龄同 IP 互刷拒绝分成 — `UnlockPointsBlock` / `suspiciousUnlockPair`（双方注册未满 7 天且 LastLoginIP 相同）
+- [x] Exp → 等级 Lv1–10 — 门槛推导 + 发帖/评论/获赞加 Exp；Admin 设等级 SSR `/admin/users`
+- [x] 自动徽章（注册天数 / 获赞 / 创作分成）— 种子 + `EvaluateAuto`（用户页/资料页访问时评估）；无独立定时调度 UI
+- [x] 限定徽章：管理员定义与授予/撤销 — SSR `/admin/badges`
+- [x] 管理员调整积分、设定认证（免审）、设定等级 — SSR `/admin/users`
+
+---
+
+## I. 友链
+
+- [x] 前台友链页；导航/页脚入口可配 — SSR `/links`；`nav_show_friend_links` / `footer_show_friend_links`
+- [x] 用户申请（名称、URL、Logo、是否上首页、回链页）— `POST /links/apply`
+- [x] Logo 上传 — 表单 multipart 或 `POST /links/logo`
+- [x] 我的申请列表；取消待审 — `/links`（修改待审：取消后重提）
+- [x] 管理员审核：通过 / 拒绝 / 回链复检 — SSR `/admin/friend-links`（创建时可异步检测）
+- [x] 管理员维护品牌友链列表 — `/admin/friend-links` 增删
+
+---
+
+## J. 站点单页
+
+- [x] 公开：`/page/:slug` 列表入口（nav/footer）— SSR
+- [x] 管理员 CRUD；发布开关；排序；nav/footer 展示开关 — SSR `/admin/pages`
+
+---
+
+## K. Gitea 码桶（**后置**）
+
+> 本迭代**不做**产品化同步：不启后台定时任务、不挂管理入口。表结构与 settings 键可保留兼容。
+
+- [ ] （后置）后台开关、Base URL、Token、同步间隔
+- [ ] （后置）手动同步 + 后台定时同步
+- [ ] （后置）前台 `/projects` 列表与搜索
+
+---
+
+## L. OIDC Provider
+
+- [ ] Discovery、JWKS、Authorize、Token、UserInfo、Logout
+- [ ] 多 OAuth 客户端 CRUD；密钥哈希存储；PKCE 字段支持
+- [ ] groups claim 映射 admin/user 组
+
+---
+
+## M. 媒体与存储
+
+- [ ] 本地 uploads 或 S3 兼容存储（可热切换配置）— 后端已支持；Admin 热切换 UI 未迁
+- [x] 头像 / 帖图 / 站点品牌资源分类 — 上传路径 + Admin 分类筛选
+- [ ] 图片展示可选 WebP 转换（`/media/thumb/...`）— 路由已有；全站默认策略未产品化
+- [x] 管理后台媒体列表与删除 — SSR `/admin/media`
+- [x] 媒体索引表同步 — 启动扫盘 + Admin「同步索引」
+
+---
+
+## N. 管理后台其它
+
+- [x] 仪表盘：用户/帖/板块计数 + 待审帖/评 + 待处理举报 — SSR `/admin/dashboard`
+- [x] 敏感词：`forum_settings.filter_words` 读写 + 热更 — SSR `/admin/settings`
+- [x] 基础限流（post/comment/register/login/window）— SSR `/admin/settings`
+- [x] 完整 Limits（字数 / 编辑窗 / 分页 / 签名头像 / Feed 样式 / 新标签）— SSR `/admin/settings/content-limits`
+- [x] SMTP 配置与测试信 — SSR `/admin/settings` 邮件区
+- [x] 站点品牌文案：名称、标语、简介、keywords、Logo 字标、ICP — SSR `/admin/settings`
+- [x] Logo / Favicon / 默认 OG 图上传与清除 — SSR `/admin/settings/brand/upload|clear`；`<head>` favicon + og:image
+- [x] SQLite 一键备份与下载 — SSR `/admin/settings`（仅 sqlite；写入 data 目录后下载）
+
+---
+
+## O. 基础设施
+
+- [x] `GET /health` — `routers/setup.go`
+- [x] `robots.txt` / `sitemap.xml` — SSR 同源路径
+- [x] 静态上传文件可达 — `Static /uploads` → data/uploads
+- [x] 限流：发帖、评论、注册、登录、举报、私信、友链 — SSR 写路径已挂 `RateLimiter`
+
+---
+
+## 明确不在当前规格内（计划中可后做）
+
+摘自 [`ROADMAP.md`](../../ROADMAP.md)，**不是**现网必交验收项：
+
+- 通知动态 UX 大幅优化
+- 帖子搜索增强（组合筛选更强）
+
+若新站一并实现，可作为加分项，不阻塞「功能对等」验收。
--- a/docs/rebuild-spec/03-data-model.md
+++ b/docs/rebuild-spec/03-data-model.md
@@ -0,0 +1,473 @@
+# 03 · 数据模型
+
+> **读者**：实现数据库与领域层的 AI  
+> **前置**：[01-product.md](01-product.md)  
+> **后续**：[04-api.md](04-api.md)、[05-business-rules.md](05-business-rules.md)  
+> **源码**：[`model/models.go`](../../models/models.go)、[`model/oauth.go`](../../models/oauth.go)、[`model/gitea.go`](../../models/gitea.go)、[`model/level.go`](../../models/level.go)、[`model/db.go`](../../models/db.go)、[`model/user_view.go`](../../models/user_view.go)、[`service/settings.go`](../../services/settings.go)
+
+当前无独立 SQL migration；表由 GORM `AutoMigrate` 创建。新站可用正式 migration，但**字段语义应对齐**。
+
+---
+
+## 1. ER 概览
+
+```mermaid
+erDiagram
+  User ||--o{ Post : authors
+  User ||--o{ Comment : authors
+  Board ||--o{ Post : contains
+  Post ||--o{ Comment : has
+  Post ||--o{ PostLike : likes
+  Post ||--o{ PostFavorite : favorites
+  Post ||--o{ PostRevision : revisions
+  Comment ||--o{ CommentLike : likes
+  Comment ||--o{ CommentRevision : revisions
+  Post ||--o| Poll : poll
+  Poll ||--o{ PollOption : options
+  PollOption ||--o{ PollVote : votes
+  Post ||--o{ PostLotteryWinner : winners
+  Post ||--o{ PostContentUnlock : unlocks
+  User ||--o{ PointLedger : ledger
+  User ||--o{ CheckIn : checkins
+  User ||--o{ LotteryDraw : draws
+  User ||--o{ UserBadge : earns
+  BadgeDef ||--o{ UserBadge : defines
+  User ||--o{ PrivateMessage : sends
+  User ||--o{ PostReport : reports
+  User ||--o{ FriendLinkApply : applies
+  User ||--o{ Media : uploads
+```
+
+另有：`ForumSetting`（键值）、`Session`（浏览器 opaque 会话）、`OAuthClient` / `OAuthAuthCode`、`GiteaRepo`、`SitePage`。
+
+---
+
+## 2. 表与字段
+
+说明：`json:"-"` 表示默认 API 序列化隐藏；软删列 `deleted_at` 表示 GORM soft delete。
+
+### 2.0 sessions
+
+| 列 | 类型 | 说明 |
+|----|------|------|
+| id | string(64) PK | 密码学随机 opaque id（Cookie `jiang13_session` 的值） |
+| user_id | uint index | 用户 |
+| expires_at | time index | 过期；默认 TTL 7 天，滑动续期 |
+| created_at / last_seen_at | time | |
+| ip / user_agent | string | 可选审计 |
+
+登出删单行；禁言 / 改密删该用户全部 session。每次请求以 DB 中 `users.role` / 禁言为准。
+
+### 2.1 users
+
+| 字段 | 类型 | 约束 | 说明 |
+|------|------|------|------|
+| id | uint PK | | |
+| username | string(128) | unique, not null | 登录名 |
+| email | string(128) | index, default '' | 公开主页不返回 |
+| password | string(128) | not null | bcrypt 哈希，永不返回 |
+| nickname | string(64) | | 展示名 |
+| signature | string(512) | default '' | 个人签名 |
+| avatar | string(512) | | 相对或绝对 URL |
+| role | string(16) | default `user` | `user` \| `admin` |
+| verified | bool | index | 站长认证，免审 |
+| exp | int | default 0 | 经验（不可消费） |
+| points | int | default 0 | 可用积分 |
+| creator_income_total | int | default 0 | 创作分成累计 |
+| banned | bool | | 禁言 |
+| banned_at | *time | | |
+| last_login_at | *time | json 隐藏 | |
+| last_login_ip | string(45) | json 隐藏 | |
+| last_access_at | *time | json 隐藏 | 带鉴权访问 |
+| created_at / updated_at | time | | |
+| deleted_at | soft | | |
+
+**非落库展示字段**：`level`（由 Exp 推导）、`badges`（附加）。
+
+视图结构：`UserPublic` / `UserSelf` / `UserAdmin`（见 [`model/user_view.go`](../../models/user_view.go)）。
+
+### 2.2 boards
+
+| 字段 | 说明 |
+|------|------|
+| id, name(64), description(512) | |
+| icon(64), color_index(default -1) | -1=按 id 自动取色 |
+| sort_order | 升序 |
+| created_at, updated_at, deleted_at | |
+
+### 2.3 posts
+
+| 字段 | 说明 |
+|------|------|
+| id, board_id, user_id | FK 索引 |
+| title(256), content(text) | HTML 正文 |
+| content_plain(text) | 纯文本搜索索引，`json:"-"` |
+| tags(256) | 逗号或空格分隔标签串 |
+| post_type | `normal`\|`question`\|`poll`\|`bounty`\|`lottery` |
+| question_resolved | 仅问答 |
+| bounty_points, bounty_status, bounty_comment_id | 悬赏 |
+| lottery_winner_count, lottery_status | 抽奖帖 |
+| pinned | 全局置顶 |
+| board_pinned | 版内置顶 |
+| featured | 精华 |
+| edit_locked | 禁止编辑 |
+| comments_locked | 禁止新评论 |
+| status | `pending`\|`published`\|`rejected` |
+| like_count, view_count | |
+| timestamps + soft delete | |
+
+关联：Board, User, Comments。
+
+### 2.4 post_revisions
+
+每次修改前保存旧版：`post_id`, `editor_id`, `title`, `content`, `tags`, `created_at`。
+
+### 2.5 comments
+
+| 字段 | 说明 |
+|------|------|
+| post_id, user_id | user_id=0 表示游客 |
+| floor | 楼层号 |
+| content | HTML/富文本 |
+| reply_to | *uint 回复目标评论 |
+| guest_nick / guest_email / guest_url | 游客信息 |
+| is_private | 私密评论 |
+| status | pending\|published\|rejected |
+| like_count | |
+| soft delete | |
+
+**非落库**：`reply_target`, `thread_parent_id`, `content_hidden`, `liked`。
+
+### 2.6 comment_revisions
+
+`comment_id`, `editor_id`, `content`, `created_at`（管理员可查）。
+
+### 2.7 post_likes / comment_likes / post_favorites
+
+唯一索引：(post_id|comment_id, user_id)。收藏带 Post 关联。
+
+### 2.8 private_messages
+
+| 字段 | 说明 |
+|------|------|
+| from_user_id | 0=系统 |
+| to_user_id | |
+| subject(256), content(text) | |
+| kind | 见枚举 |
+| related_post_id, related_report_id | 可选 |
+| is_read | |
+| created_at | |
+
+### 2.9 post_reports
+
+帖或评举报：`post_id` 必填；`comment_id` 有值则为评论举报。  
+`reason`, `detail`, `status`, `handler_id`, `handle_note`, `handled_at`。
+
+### 2.10 friend_link_applies
+
+申请字段：name, url, description, logo, reciprocal_page_url, link_on_homepage,  
+reciprocal_verified / check_note / checked_at, status, review_note, reviewed_at + soft delete。
+
+### 2.11 media
+
+上传索引：`category`=`avatars`\|`posts`\|`site`；`name`, `url`(unique), `size`, `content_type`, `storage_type`=`local`\|`s3`, `user_id`。
+
+### 2.12 point_ledgers
+
+`user_id`, `delta`, `balance`(变动后), `reason`, `ref_type`, `ref_id`, `note`, `created_at`。
+
+### 2.13 check_ins
+
+唯一 `(user_id, day)`，day=`YYYY-MM-DD`；`points`, `streak`。
+
+### 2.14 lottery_draws
+
+每日抽奖唯一 `(user_id, day)`；`points` 可为 0。
+
+### 2.15 post_content_unlocks
+
+唯一 `(user_id, post_id, block_key)`；`cost`。
+
+### 2.16 site_pages
+
+`title`, `slug`(unique), `content`, `published`, `sort_order`, `show_in_footer`, `show_in_nav` + soft delete。
+
+### 2.17 polls / poll_options / poll_votes
+
+- Poll：`post_id` unique；`multi`, `max_choices`, `closed`, `ends_at`
+- Option：`post_id`, `text`(64), `sort_order`, `vote_count`
+- Vote：唯一 `(post_id, option_id, user_id)`（多选时多行）
+
+### 2.18 post_lottery_winners
+
+`post_id`, `user_id`, `comment_id`, `created_at`。
+
+### 2.19 badge_defs / user_badges
+
+BadgeDef：`code` unique, `name`, `description`, `icon`, `kind`=`auto`\|`limited`, `metric`, `threshold`, `sort_order`, `enabled`。  
+UserBadge：唯一 `(user_id, badge_id)`；`awarded_at`, `awarded_by`(0=系统)。
+
+### 2.20 forum_settings
+
+| 字段 | 说明 |
+|------|------|
+| key | PK string(64) |
+| value | string(2048) |
+
+### 2.21 oauth_clients / oauth_auth_codes
+
+Client：`client_id` unique, `client_secret_hash`, `name`, `redirect_uris`(可多行), `enabled`。  
+AuthCode：一次性码 + PKCE 字段 + `expires_at` + `used`。
+
+### 2.22 gitea_repos
+
+同步缓存：`gitea_id` unique, owner/name/full_name, description, html_url, language, stars/forks, private, updated_at_remote, forum_user_id, synced_at。
+
+---
+
+## 3. 枚举全集
+
+### 3.1 角色 Role
+
+`user` | `admin`
+
+### 3.2 内容状态 ContentStatus
+
+`pending` | `published` | `rejected`
+
+### 3.3 帖类型 PostType
+
+`normal` | `question` | `poll` | `bounty` | `lottery`
+
+### 3.4 悬赏 BountyStatus
+
+`open` | `awarded` | `refunded`（空串视为非悬赏）
+
+### 3.5 帖内抽奖 PostLotteryStatus
+
+`open` | `drawn`
+
+### 3.6 私信 kind
+
+| 值 | 含义 |
+|----|------|
+| user | 用户互发 |
+| system | 系统通知 |
+| reject | 帖/评被拒 |
+| report_result | 举报处理结果 |
+| reply | 被回复 |
+| mention | 被 @ |
+| moderation | 待审提醒管理员 |
+
+### 3.7 举报
+
+Status：`pending` | `resolved` | `dismissed`  
+Reason：`spam` | `abuse` | `illegal` | `irrelevant` | `other`
+
+### 3.8 友链申请
+
+`pending` | `approved` | `rejected`
+
+### 3.9 积分 reason
+
+| 值 | 含义 |
+|----|------|
+| check_in | 签到 |
+| lottery | 每日抽奖 |
+| unlock_spend | 解锁消费 |
+| creator_income | 创作分成 |
+| admin_adjust | 管理员调账 |
+| bounty_escrow | 悬赏托管 |
+| bounty_award | 悬赏发放 |
+| bounty_refund | 悬赏退回 |
+
+### 3.10 徽章
+
+Kind：`auto` | `limited`  
+Metric：`tenure_days` | `likes_received` | `creator_income`
+
+---
+
+## 4. 等级（Exp → Level）
+
+源：[`model/level.go`](../../models/level.go)
+
+| Level | 最低 Exp |
+|-------|----------|
+| 1 | 0 |
+| 2 | 20 |
+| 3 | 50 |
+| 4 | 100 |
+| 5 | 200 |
+| 6 | 400 |
+| 7 | 800 |
+| 8 | 1500 |
+| 9 | 3000 |
+| 10 | 5000 |
+
+管理员设等级时，应把 Exp 调到该等级门槛（见后台 API）。
+
+---
+
+## 5. 内置自动徽章（seed）
+
+源：[`model/db.go`](../../models/db.go) `seedDefaultBadges`
+
+| code | 名称 | metric | threshold |
+|------|------|--------|-----------|
+| tenure_30 | 初来乍到 | tenure_days | 30 |
+| tenure_365 | 资深居民 | tenure_days | 365 |
+| likes_10 | 小有人气 | likes_received | 10 |
+| likes_100 | 人气作者 | likes_received | 100 |
+| likes_1000 | 人气巨星 | likes_received | 1000 |
+| income_100 | 小有进账 | creator_income | 100 |
+| income_1000 | 创作达人 | creator_income | 1000 |
+
+已存在同 `code` 则跳过插入。
+
+---
+
+## 6. forum_settings 键与默认值
+
+源：[`service/settings.go`](../../services/settings.go)、[`service/permalink.go`](../../services/permalink.go)
+
+### 6.1 论坛限制
+
+| Key | 默认 | 说明 |
+|-----|------|------|
+| post_edit_window_hours | 24 | 0 可表示特殊策略，以实现为准 |
+| comment_edit_window_minutes | 3 | |
+| rate_limit_post | 10 | 窗口内次数 |
+| rate_limit_comment | 10 | |
+| rate_limit_register | 10 | |
+| rate_limit_login | 10 | |
+| rate_limit_window_sec | 60 | |
+| post_title_max | 128 | |
+| post_tags_max | 256 | |
+| post_content_max | 50000 | |
+| comment_max | 5000 | |
+| search_keyword_min | 1 | |
+| search_keyword_max | 50 | |
+| page_size_default | 30 | API 硬上限 100 |
+| password_min_len | 6 | |
+| avatar_max_mb | 2 | |
+| signature_max | 200 | |
+| open_posts_in_new_tab | 1 | |
+| open_content_links_in_new_tab | 1 | |
+
+### 6.2 Feed / 侧栏 / 友链展示
+
+| Key | 默认 |
+|-----|------|
+| feed_list_style | `title`（另有 `excerpt` / `thumbnail`） |
+| aside_show_tag_cloud | 0 |
+| aside_show_recent_comments | 0 |
+| aside_show_friend_links | 1 |
+| aside_widgets | JSON 数组，见下 |
+| nav_show_friend_links | 1 |
+| footer_show_friend_links | 1 |
+| friend_link_reciprocal_check | 0 |
+| permalink_enabled | 0 |
+| permalink_ext | `html` |
+
+默认 `aside_widgets`：
+
+```json
+[
+  {"id":"tag_cloud","enabled":false},
+  {"id":"recent_comments","enabled":false},
+  {"id":"friend_links","enabled":true}
+]
+```
+
+合法 widget id：`tag_cloud` | `recent_comments` | `recent_users` | `friend_links`。
+
+### 6.3 SMTP
+
+| Key | 默认 |
+|-----|------|
+| smtp_enabled | 0 |
+| smtp_host | |
+| smtp_port | 465 |
+| smtp_username / smtp_password | |
+| smtp_from | |
+| smtp_from_name | 姜十三论坛 |
+| smtp_encryption | `ssl`（另有 `none` / `starttls`） |
+
+### 6.4 OIDC
+
+| Key | 默认 |
+|-----|------|
+| oidc_enabled | 0 |
+| oidc_root_url | |
+| oidc_group_claim | groups |
+| oidc_admin_group | gitea-admin |
+| oidc_user_group | gitea-users |
+| oidc_rsa_private_pem | （空）启用 OIDC 时懒生成并写入；未启用不落盘 `.oidc_rsa.pem` |
+
+### 6.4b 敏感词
+
+| Key | 默认 |
+|-----|------|
+| filter_words | 默认词表文本；启动时从旧 `filter_words.txt` 导入（若键为空） |
+
+### 6.5 Gitea 同步（**后置**，键保留兼容）
+
+| Key | 默认 |
+|-----|------|
+| gitea_sync_enabled | 0 |
+| gitea_base_url | |
+| gitea_token | |
+| gitea_sync_interval_min | 60 |
+
+本迭代不启同步任务；见 [02-features.md](02-features.md) §K。
+
+### 6.6 存储
+
+| Key | 默认 |
+|-----|------|
+| storage_type | local |
+| storage_endpoint / region / bucket | region 默认 us-east-1 |
+| storage_access_key / storage_secret_key | |
+| storage_public_base_url / storage_prefix | |
+| storage_force_path_style | 1 |
+| storage_image_delivery | webp（或 original） |
+
+### 6.7 站点品牌
+
+| Key | 默认 |
+|-----|------|
+| site_name | 姜十三论坛 |
+| site_slogan | 拾三一隅，自在交流 |
+| site_description / site_keywords | 空 |
+| site_logo_mark | 姜 |
+| site_logo / site_favicon / site_og_image | 空 |
+| site_icp_beian | 空 |
+| site_icp_beian_url | https://beian.miit.gov.cn/ |
+| site_friend_links | `[]` JSON，最多 20 条 |
+
+---
+
+## 7. 升级兼容补丁（现网 InitDB）
+
+[`model/db.go`](../../models/db.go) 在 AutoMigrate 后：
+
+- 空 `status` 的帖/评 → `published`
+- 空 `post_type` → `normal`
+- Exp=0 用户按存量内容粗算经验：`posts*10 + comments*2 + like_sum`
+
+新站若从空库开始可忽略；若迁移旧库需保留等价 backfill。
+
+---
+
+## 8. 内容门控在库中的形态
+
+**无独立表**存放门控块；存在 `posts.content` HTML 中，例如：
+
+```html
+<members-only>...</members-only>
+<reply-only>...</reply-only>
+<points-only data-cost="10">...</points-only>
+```
+
+积分解锁 `block_key` = `sha256(innerHTML)[:16]`（hex），见 [`service/unlock.go`](../../services/unlock.go)。
--- a/docs/rebuild-spec/04-api.md
+++ b/docs/rebuild-spec/04-api.md
@@ -0,0 +1,391 @@
+# 04 · HTTP API 合约
+
+> **读者**：机器客户端 / 集成方；浏览器 UI **不**使用本文件作为主路径  
+> **前置**：[03-data-model.md](03-data-model.md)、[08-gitea-ssr-architecture.md](08-gitea-ssr-architecture.md)  
+> **源码**：[`routers/setup.go`](../../routers/setup.go)、[`modules/auth/auth.go`](../../modules/auth/auth.go)
+
+本分支（`rebuild/gitea-ssr`）浏览器走 **`routers/web` 模板 + 表单**。  
+**当前进程仅注册** health / OIDC / robots / sitemap / media thumb 等机器相关路由；论坛 CRUD 的 `/api/*` **handler 已从本分支删除**（对照实现见 `main`，合约形状见下文历史章节）。
+
+`main` 分支 SPA 仍完整实现下表；对照请 checkout `main`。
+
+---
+
+## 1. 本分支已注册的机器入口
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/health` | 探活 |
+| GET | `/robots.txt` | 抓取规则 |
+| GET | `/sitemap.xml` | 站点地图 |
+| GET/POST | `/oauth/*`、`/.well-known/openid-configuration` | OIDC Provider |
+| GET | `/media/thumb/*`、`/uploads/*` | 媒体 |
+
+---
+
+## 2. 历史 JSON 合约（main / 对照，本分支默认不挂载）
+
+以下章节描述原 SPA 使用的 `/api` 形状，便于迁移业务语义；**实现 UI 时请用 web 表单，勿恢复双轨。**
+
+### 通用约定（历史）
+
+| 项 | 约定 |
+|----|------|
+| Base | 同源；`credentials: 'same-origin'` |
+| 成功 | HTTP 2xx + JSON body |
+| 失败 | 非 2xx + `{ "error": "..." }` |
+| 鉴权 | Cookie `jiang13_session`（opaque）；机器 OIDC 用 Bearer |
+
+### 分页形态差异
+
+| 场景 | 典型字段 |
+|------|----------|
+| 前台帖列表 | `posts`, `total`, `page`, `size`, `has_more` |
+| 后台多数列表 | `total`, `page`, `total_pages` + 实体数组 |
+| 私信会话消息 | `before` 游标式 |
+
+---
+
+## 3. 基础设施 / SEO / 静态（节选，仍有效）
+
+| 方法 | 路径 | 鉴权 | 说明 |
+|------|------|------|------|
+| GET | `/health` | 无 | `{ "status": "ok" }` |
+| GET | `/robots.txt` | 无 | 文本 |
+| GET | `/sitemap.xml` | 无 | XML |
+| GET | `/media/thumb/*filepath` | 无 | 缩略图 / WebP 等 |
+| GET | `/uploads/*` | 无 | 静态上传文件 |
+
+---
+
+## 3. OIDC Provider
+
+| 方法 | 路径 | 鉴权 | 说明 |
+|------|------|------|------|
+| GET | `/.well-known/openid-configuration` | 无 | Discovery |
+| GET | `/oauth/jwks` | 无 | JWKS |
+| GET | `/oauth/authorize` | OptionalAuth | 授权码流程 |
+| POST | `/oauth/token` | 无（客户端凭证） | 换 token |
+| GET/POST | `/oauth/userinfo` | Bearer | 用户信息 |
+| GET/POST | `/oauth/logout` | 视实现 | 登出 |
+
+细节以 [`service/oidc.go`](../../services/oidc.go) / [`handler/oidc.go`](../../routers/api/oidc.go) 为准。
+
+---
+
+## 4. 公开 API（`/api` + OptionalAuth）
+
+### 4.1 会话与站点
+
+| 方法 | 路径 | 响应要点 |
+|------|------|----------|
+| GET | `/api/me` | `{ user: UserSelf \| null }` |
+| GET | `/api/stats` | `{ users, posts, boards, comments }` |
+| GET | `/api/forum-limits` | `ForumLimitsPublic`（无限流内部字段） |
+| GET | `/api/site-branding` | `SiteBranding`（可含 `site_url`） |
+| GET | `/api/captcha` | `{ id, image }` image 为 data URL 或 base64 |
+| GET | `/api/register/config` | 见下 |
+
+**RegisterConfig**
+
+```json
+{
+  "is_first_user": true,
+  "mail_ready": false,
+  "require_email_code": false,
+  "register_open": true,
+  "email_code_len": 6
+}
+```
+
+### 4.2 认证（限流）
+
+| 方法 | 路径 | Body | 响应 |
+|------|------|------|------|
+| POST | `/api/register` | Form/JSON: username, password, nickname, email, captcha_id, captcha, email_code? | 成功后通常种 cookie |
+| POST | `/api/login` | Form: username, password | 种 cookie |
+| POST | `/api/register/email-code` | JSON `{ email }` | `{ message }` |
+| POST | `/api/password-reset/email-code` | JSON `{ email }` | `{ message }` |
+| POST | `/api/password-reset` | JSON `{ email, email_code, new_password }` | `{ message }` |
+
+### 4.3 内容只读
+
+| 方法 | 路径 | Query / 说明 |
+|------|------|----------------|
+| GET | `/api/boards` | `{ boards: Board[] }` |
+| GET | `/api/posts` | 见下表 |
+| GET | `/api/posts/hot` | 热门列表 |
+| GET | `/api/posts/:id` | `skip_view=1` 可选；返回 `PostDetailResponse` |
+| GET | `/api/posts/:id/comments` | `my_ids` 可选（逗号分隔，便于标自己的楼） |
+| GET | `/api/tags` | `limit` 默认 40 → `{ tags: [{name,count}] }` |
+| GET | `/api/comments/recent` | `{ comments: RecentComment[] }` |
+| GET | `/api/users/search` | `q`, `limit` |
+| GET | `/api/users/recent` | `{ users: RecentUser[] }` |
+| GET | `/api/users/:id` | `{ user: UserPublic, stats }` |
+| GET | `/api/pages` | 已发布摘要列表 |
+| GET | `/api/pages/:slug` | 单页详情 |
+| GET | `/api/projects` | `page`, `limit`, `q` |
+
+**GET `/api/posts` Query**
+
+| 参数 | 说明 |
+|------|------|
+| page | 默认 1 |
+| size | 默认 page_size_default，上限 100 |
+| board_id | 0 或不传=全部 |
+| user_id | 某用户的帖 |
+| keyword | 搜索词 |
+| tag | 标签 |
+| author | 用户名优先，否则昵称精确匹配 |
+| title_only | `1`/`true` 仅搜标题 |
+| sort | `latest` \| `reply` \| `hot` |
+
+**响应示例**
+
+```json
+{
+  "posts": [ /* PostItem */ ],
+  "total": 100,
+  "page": 1,
+  "size": 30,
+  "has_more": true
+}
+```
+
+**PostDetailResponse 要点**
+
+```json
+{
+  "post": { /* PostItem + content */ },
+  "comment_count": 0,
+  "liked": false,
+  "favorited": false,
+  "has_replied": false,
+  "can_edit": true,
+  "edit_block_reason": "",
+  "is_edited": false,
+  "post_edit_window_hours": 24,
+  "poll": { /* PollView 可选 */ },
+  "lottery": { /* PostLotteryView 可选 */ },
+  "bounty_can_refund": false,
+  "bounty_refund_block_reason": "",
+  "bounty_eligible_reply_count": 0
+}
+```
+
+### 4.4 游客可写评论
+
+| 方法 | 路径 | 限流 | Body |
+|------|------|------|------|
+| POST | `/api/posts/:id/comments` | comment | Form: content, reply_to?, is_private?, 以及游客字段（以实现为准） |
+
+登录用户发评也走此路径（RequireAuth 组外公开组已注册该路由）。
+
+---
+
+## 5. 需登录 API（`/api` + RequireAuth）
+
+### 5.1 会话与资料
+
+| 方法 | 路径 | Body | 响应 |
+|------|------|------|------|
+| POST | `/api/logout` | | 清 cookie |
+| GET | `/api/favorites` | | `{ favorites, total }` |
+| GET | `/api/profile/stats` | | `{ stats: UserActivityStats }` |
+| POST | `/api/profile/nickname` | Form nickname | |
+| POST | `/api/profile/signature` | Form signature | `{ message, user }` |
+| POST | `/api/profile/password` | Form old_password, new_password | |
+| POST | `/api/profile/avatar` | Form avatar=file | `{ avatar }` |
+| POST | `/api/uploads/image` | Form image=file | `{ url }` |
+
+### 5.2 帖子写操作
+
+| 方法 | 路径 | Body | 响应 |
+|------|------|------|------|
+| POST | `/api/posts` | Form: board_id, title, content, tags?, post_type?, poll_options?, bounty_points?, lottery_winner_count? | `{ message, post_id, status }` |
+| PUT | `/api/posts/:id` | Form: title, content, tags?, board_id?, post_type? | `{ message }` |
+| DELETE | `/api/posts/:id` | | 软删 |
+| GET | `/api/posts/:id/revisions` | | `{ revisions }` |
+| GET | `/api/posts/:id/revisions/:revId` | | `{ revision }` |
+| POST | `/api/posts/:id/like` | | `{ liked, like_count }` |
+| POST | `/api/posts/:id/favorite` | | `{ favorited }` |
+| POST | `/api/posts/:id/resolve` | Form resolved=`1`\|`0` | `{ question_resolved }` |
+| POST | `/api/posts/:id/poll/vote` | JSON `{ option_ids: number[] }` | `{ poll }` |
+| POST | `/api/posts/:id/poll/close` | | `{ poll }` |
+| POST | `/api/posts/:id/bounty/award` | Form comment_id | |
+| POST | `/api/posts/:id/bounty/refund` | | |
+| POST | `/api/posts/:id/lottery/draw` | | `{ lottery }` |
+| POST | `/api/posts/:id/report` | JSON `{ reason, detail? }` | `{ report }` |
+| POST | `/api/posts/:id/unlock` | JSON `{ block_key }` | 见下 |
+
+**poll_options JSON 示例**（Form 字段字符串）
+
+```json
+{
+  "multi": false,
+  "max_choices": 1,
+  "ends_at": "2026-09-01T12:00:00Z",
+  "options": [{ "text": "选项A" }, { "text": "选项B" }]
+}
+```
+
+**unlock 响应**
+
+```json
+{
+  "message": "...",
+  "unlock": {
+    "block_key": "abcdef0123456789",
+    "cost": 10,
+    "points_balance": 90,
+    "inner_html": "<p>...</p>"
+  }
+}
+```
+
+### 5.3 评论写操作
+
+| 方法 | 路径 | Body |
+|------|------|------|
+| POST | `/api/comments/:id/like` | → `{ liked, like_count }` |
+| POST | `/api/comments/:id/report` | JSON `{ reason, detail? }` |
+| PUT | `/api/comments/:id` | Form content |
+| DELETE | `/api/comments/:id` | |
+
+### 5.4 私信
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/api/messages/unread-count` | `{ count, dm_count?, notify_count? }` |
+| GET | `/api/messages/notifications` | page, size, kind |
+| POST | `/api/messages/notifications/read` | |
+| GET | `/api/messages/conversations` | page, size |
+| GET | `/api/messages/conversations/:peerId` | size, before；peerId=0 为系统 |
+| POST | `/api/messages/conversations/:peerId/read` | |
+| POST | `/api/messages` | JSON `{ to_user_id, subject?, content }` |
+| POST | `/api/messages/read-all` | |
+
+### 5.5 经济
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/api/me/points` | page；含 ledger、check_in、lottery |
+| GET/POST | `/api/me/check-in` | 状态 / 执行签到 |
+| GET/POST | `/api/me/lottery` | 状态 / 抽奖 |
+
+### 5.6 友链申请
+
+| 方法 | 路径 | Body |
+|------|------|------|
+| POST | `/api/friend-links/apply` | JSON name, url, logo, link_on_homepage, reciprocal_page_url? |
+| POST | `/api/friend-links/logo` | Form logo=file → `{ url }` |
+| GET | `/api/friend-links/my-applies` | |
+| PUT | `/api/friend-links/applies/:id` | 同申请字段 |
+| DELETE | `/api/friend-links/applies/:id` | 取消 |
+
+---
+
+## 6. 管理 API（`/api/admin` + Auth + Admin）
+
+### 6.1 仪表盘与设置
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/dashboard` | AdminDashboard |
+| GET | `/settings` | AdminSettings 聚合 |
+| PUT | `/settings/forum` | ForumLimits |
+| PUT | `/settings/mail` | MailConfig |
+| POST | `/settings/mail/test` | `{ to }` |
+| PUT | `/settings/oidc` | OIDCConfig |
+| PUT | `/settings/gitea` | **后置**（501） |
+| POST | `/settings/gitea/sync` | **后置**（501） |
+| PUT | `/settings/storage` | StorageConfig |
+| PUT | `/settings/branding` | SiteBranding |
+| POST | `/settings/branding/upload` | Form kind=`logo`\|`favicon`\|`og_image`, file |
+| POST | `/settings/branding/clear` | JSON `{ kind }` |
+| GET/PUT | `/settings/filter-words` | GET 读；PUT `{ content }` |
+
+（上表路径均相对于 `/api/admin`。）
+
+### 6.2 OAuth 客户端
+
+| 方法 | 路径 |
+|------|------|
+| GET/POST | `/oauth/clients` |
+| PUT/DELETE | `/oauth/clients/:id` |
+
+创建/更新 body：`name`, `redirect_uris`, `client_id?`, `enabled?`, `client_secret?`, `rotate_secret?`。
+
+### 6.3 板块 / 单页 / 友链
+
+| 方法 | 路径 |
+|------|------|
+| POST/PUT/DELETE | `/boards`, `/boards/:id` |
+| GET/POST | `/pages` |
+| GET/PUT/DELETE | `/pages/:id` |
+| PUT | `/pages/:id/published` → `{ published }` |
+| GET | `/friend-link-applies` |
+| PUT | `/friend-link-settings` |
+| POST | `/friend-link-applies/:id/approve` \| `reject` \| `recheck` |
+
+### 6.4 帖子审核与运营
+
+| 方法 | 路径 | Body |
+|------|------|------|
+| GET | `/posts` | page, keyword, status |
+| GET | `/posts/trash` | |
+| POST | `/posts/:id/pin` | `{ pinned }` |
+| POST | `/posts/:id/board-pin` | `{ board_pinned }` |
+| POST | `/posts/:id/feature` | `{ featured }` |
+| POST | `/posts/:id/lock` | `{ locked }` → edit_locked |
+| POST | `/posts/:id/comments-lock` | `{ locked }` |
+| POST | `/posts/:id/approve` | |
+| POST | `/posts/:id/reject` | `{ reason }` |
+| POST | `/posts/:id/restore` | |
+| DELETE | `/posts/:id/purge` | 硬删 |
+| DELETE | `/posts/:id` | 软删 |
+
+### 6.5 评论 / 举报 / 用户 / 徽章 / 媒体 / 备份
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/comments`, `/comments/trash` | |
+| GET | `/comments/:id/revisions` | |
+| POST | `/comments/:id/approve` \| `reject` \| `restore` | reject 可带 reason |
+| DELETE | `/comments/:id`, `/comments/:id/purge` | |
+| GET | `/reports` | page, status |
+| POST | `/reports/:id/handle` | `{ action, handle_note?, reject_reason? }`；action=`dismiss`\|`resolve`\|`reject_post`\|`reject_comment` |
+| GET | `/users` | page, keyword, filter |
+| POST | `/users/:id/ban` | `{ banned }` |
+| POST | `/users/:id/verify` | `{ verified }` |
+| POST | `/users/:id/level` | `{ level }` |
+| POST | `/users/:id/points` | `{ delta, note? }` |
+| POST | `/users/:id/badges` | `{ badge_id, revoke? }` |
+| GET/POST | `/badges` | 列表 / upsert |
+| GET | `/media` | category, page, size, q |
+| POST | `/media/delete` | `{ urls: string[] }` |
+| POST | `/backup` | `{ filename, download }` |
+| GET | `/backup/download/:name` | 文件下载 |
+
+---
+
+## 7. 核心类型速查（与前端对齐）
+
+详见 [`frontend/src/api/types.ts`](（仅 main）frontend/src/api/types.ts)。实现时至少对齐：
+
+- `User` / `UserPublic` / `UserActivityStats`
+- `Board` / `PostItem` / `PostDetailResponse` / `Comment`
+- `ForumLimits` / `ForumLimitsPublic` / `SiteBranding`
+- `PollView` / `PostLotteryView`
+- `PrivateMessage` / `MessageConversation`
+- `PostReport` / `FriendLinkApply` / `BadgeDef` / `PointLedger`
+- `CheckInStatus` / `LotteryStatus`
+- `AdminDashboard` / `AdminSettings` / `StorageConfig` / `MailConfig` / `OIDCConfig`
+
+---
+
+## 8. 鉴权错误语义（现网）
+
+中间件对未登录 / 过期 / 禁言返回 JSON error（并可能清 cookie）。前端统一 `throw new Error(data.error)`。新站应保持可区分的错误文案或错误码，避免前端无法提示。
+
+源：[`middleware/auth.go`](../../modules/auth/auth.go)。
--- a/docs/rebuild-spec/05-business-rules.md
+++ b/docs/rebuild-spec/05-business-rules.md
@@ -0,0 +1,230 @@
+# 05 · 业务规则与状态机
+
+> **读者**：实现领域逻辑的 AI（最易「看起来像但算错」）  
+> **前置**：[03-data-model.md](03-data-model.md)、[04-api.md](04-api.md)  
+> **源码**：[`service/`](../../services/)、[`model/models.go`](../../models/models.go)
+
+---
+
+## 1. 注册与引导
+
+源：[`routers/web/auth.go`](../../routers/web/auth.go)、[`services/auth.go`](../../services/auth.go)
+
+| 规则 | 细节 |
+|------|------|
+| 管理员 | **仅** `/install` 向导创建（不再「首注册变管理员」） |
+| 开放注册 | 安装完成后开放；不依赖 SMTP |
+| 邮箱验证码 | `require_email_code = mailReady`；邮件未就绪时可无码注册 |
+| 会话 | Cookie `jiang13_session` = opaque id；表 `sessions`；HttpOnly + SameSite=Lax；HTTPS 时 Secure；TTL 7 天滑动续期 |
+| 吊销 | 登出删当前 session；禁言 / 重置密码删该用户全部 session |
+| HMAC 密钥 | `{DATA}/.jwt_secret` 仅 CSRF 等 HMAC（**不是**浏览器登录 JWT） |
+
+密码：bcrypt；最小长度来自 `password_min_len`（默认 6）。
+
+---
+
+## 2. 内容审核
+
+```mermaid
+stateDiagram-v2
+  [*] --> pending: 普通用户发帖或评论
+  [*] --> published: admin或verified免审
+  pending --> published: 管理员通过
+  pending --> rejected: 管理员拒绝
+  published --> pending: 非免审用户编辑后可再进审
+```
+
+| 规则 | 细节 |
+|------|------|
+| 免审 | `role=admin` 或 `verified=true`（`SkipsModeration`） |
+| 可见性 | `pending`/`rejected`：**仅作者与管理员**可见（对外表现为 404） |
+| 列表 | 公开 Feed 只出 `published` |
+| 拒绝 | 可写原因；通知作者（站内信 kind=`reject`，可选邮件） |
+| 待审提醒 | 通知管理员（kind=`moderation`） |
+| 游客评论 | 通常直接或按实现进入审核；勿假设与登录用户完全相同 |
+
+源：[`service/post.go`](../../services/post.go) `CanViewPost`、[`service/comment.go`](../../services/comment.go)。
+
+---
+
+## 3. 编辑时限与锁
+
+| 对象 | 规则 |
+|------|------|
+| 帖子 | 普通用户在 `post_edit_window_hours`（默认 24）内可编；超时不可（管理员除外） |
+| 帖子 | `edit_locked=true` 时非管理员不可编 |
+| 评论 | `comment_edit_window_minutes`（默认 3） |
+| 评论 | 帖子 `comments_locked` 时禁止新评论 |
+
+详情接口返回 `can_edit`、`edit_block_reason`、`post_edit_window_hours`。
+
+修订：每次成功修改前写入 `post_revisions` / `comment_revisions`（旧内容快照）。
+
+---
+
+## 4. 经验 Exp（不可消费）
+
+| 事件 | Delta |
+|------|------|
+| 发帖成功（公开路径） | +10 |
+| 评论成功 | +2 |
+| 帖子被点赞 | +1（作者） |
+
+源：[`service/post.go`](../../services/post.go)、[`service/comment.go`](../../services/comment.go)、[`service/badge.go`](../../services/badge.go) `AddExp`。
+
+等级门槛见 [03-data-model.md](03-data-model.md) §4。管理员设 level 时应同步 Exp 到门槛值。
+
+---
+
+## 5. 内容门控（红action）
+
+源：[`service/content.go`](../../services/content.go)、[`handler/api.go`](../../routers/api/api.go) `APIPostDetail`、[`service/unlock.go`](../../services/unlock.go)
+
+### 5.1 出口顺序（详情）
+
+1. `SanitizePostHTML`（消毒）
+2. 若 **游客**：`RedactMembersOnlyHTML` + `RedactReplyOnlyHTML`
+3. 若 **已登录** 且非管理员、非作者、且未回复：仅 `RedactReplyOnlyHTML`
+4. 作者与管理员：members/reply 块不遮
+5. 积分块：按已解锁 key 集合 `RedactPointsOnlyHTML`；作者/管理员策略以实现为准（作者可免费解锁记录）
+
+搜索 / SEO：`RedactGatedPostHTML` = members + reply + points 全遮。
+
+### 5.2 积分解锁
+
+| 项 | 值 |
+|----|-----|
+| block_key | `hex(sha256(innerHTML))[:16]` |
+| cost | `data-cost`，最小 1 |
+| 读者 | 扣 `cost`（reason=`unlock_spend`） |
+| 作者分成 | `cost * 70 / 100`（`CreatorSharePercent`），reason=`creator_income`；并累加 `creator_income_total` |
+| 平台留存 | 剩余 30%（无单独流水，表现为读者扣全额、作者只加 70%） |
+| 作者自己 | cost=0 记解锁，无分成 |
+| 已解锁 | 返回错误「已解锁」 |
+| 防刷 | 双方账号注册未满 **7 天** 且 **LastLoginIP 相同** → 拒绝整单 |
+
+---
+
+## 6. 特殊帖类型
+
+### 6.1 问答 question
+
+- `question_resolved` 布尔；作者（或管理员）可切换
+- 列表/详情用图标展示已解决状态
+
+### 6.2 投票 poll
+
+| 规则 | 细节 |
+|------|------|
+| 选项数 | 2–10；单选项 ≤64 字 |
+| 多选 | `multi`；`max_choices` 钳制在 1..选项数 |
+| 截止 | `ends_at` 可选；过期或 `closed` 不可再投 |
+| 投票 | 每用户每帖；已投不可改（`ErrPollAlreadyVoted`） |
+| 结束 | 作者或管理员 `poll/close` |
+
+### 6.3 悬赏 bounty
+
+```mermaid
+stateDiagram-v2
+  [*] --> open: 发帖托管积分
+  open --> awarded: 采纳他人已发布评论
+  open --> refunded: 退款
+```
+
+| 规则 | 细节 |
+|------|------|
+| 发帖 | 积分 ≥1；立即 `bounty_escrow` 扣作者积分 |
+| 采纳 | 不能采纳自己的回复；评论须 published；全额给评论作者 `bounty_award` |
+| 退款 | 状态 open；作者在**无他人已发布回复**时可退；**管理员始终可强制退** |
+| 退款后 | status=`refunded`，`bounty_points=0`，积分退回作者 |
+
+### 6.4 抽奖帖 lottery
+
+| 规则 | 细节 |
+|------|------|
+| 中奖人数 | 1–20 |
+| 参与者 | 已发布评论且 **非楼主**；按用户去重（保留最早评论） |
+| 开奖 | 作者/管理员；人数不足报错；随机抽取；写 `post_lottery_winners`；status=`drawn` |
+
+---
+
+## 7. 签到与每日抽奖
+
+源：[`service/points.go`](../../services/points.go)
+
+### 签到
+
+- 自然日 `YYYY-MM-DD`（服务器本地时区）每用户一次
+- 连续：若昨日报到则 streak+1，否则 1
+- 奖励：`5 + (streak-1)`，封顶 **15**，保底 5
+- 写 `check_ins` + `point_ledgers` reason=`check_in`
+
+### 每日抽奖
+
+- 每天一次；`cost=0`
+- 奖池权重：0×40, 2×30, 5×18, 10×10, 20×2
+- 中奖积分入账 reason=`lottery`
+
+---
+
+## 8. 评论特殊规则
+
+| 规则 | 细节 |
+|------|------|
+| 楼层 | 按帖递增 |
+| 私密评论 | 仅作者、帖作者、管理员、以及相关可见链可见（见 `canViewPrivate`） |
+| 嵌套 | `thread_parent_id` 在父不可见时回挂祖先 |
+| @提及 | 解析后发 kind=`mention` |
+| 回复提醒 | kind=`reply`；可选 SMTP |
+| HasUserReplied | 已发布或审核中的评论算「已回复」（不含被拒），用于 reply-only |
+
+---
+
+## 9. 举报处理
+
+管理员 `handle` action：
+
+| action | 效果 |
+|--------|------|
+| dismiss | 驳回举报 |
+| resolve | 标记已处理（不必然删内容） |
+| reject_post | 拒绝/下架帖 |
+| reject_comment | 拒绝评论 |
+
+结果通知举报人（kind=`report_result`）。
+
+---
+
+## 10. 友链
+
+| 规则 | 细节 |
+|------|------|
+| 申请 | 登录用户；可上传 logo |
+| 回链检测 | 设置开启时抓取 reciprocal 页检查是否含本站链接 |
+| 通过 | 可写入品牌 `site_friend_links`（视实现：首页展示链接） |
+| 展示开关 | nav / footer / aside 独立 |
+
+---
+
+## 11. 敏感词与限流
+
+- 敏感词：`forum_settings.filter_words`（Admin SSR 可改并热更）；旧文件可导入
+- 限流动作键：post / comment / register / login / report / message / friend_link 等；窗口秒与次数来自 settings（Admin 可改基础四项+窗口）
+
+---
+
+## 12. 徽章自动授予
+
+定期或触发时检查 `BadgeDef`（kind=auto）：tenure_days / likes_received / creator_income 达阈值则写入 `user_badges`。限定徽章仅管理员发放。
+
+---
+
+## 13. 置顶排序语义
+
+| 标记 | 首页全部 Feed | 板块 Feed |
+|------|---------------|-----------|
+| `pinned` | 抬升 | 抬升 |
+| `board_pinned` | **不**抬升 | 抬升 |
+| `featured` | 标记展示，不一定改变排序 | 同左 |
+
+具体 SQL/排序实现见 [`service/post.go`](../../services/post.go) ListItems。
--- a/docs/rebuild-spec/06-pages-ux.md
+++ b/docs/rebuild-spec/06-pages-ux.md
@@ -0,0 +1,229 @@
+# 06 · 页面、交互与信息架构
+
+> **读者**：实现前台 / 后台 UI 的 AI  
+> **前置**：[02-features.md](02-features.md)  
+> **源码**：[`frontend/src/App.tsx`](（仅 main）frontend/src/App.tsx)、[`frontend/src/pages/`](（仅 main）frontend/src/pages/)、[`frontend/src/components/`](（仅 main）frontend/src/components/)、[`frontend/src/layouts/`](（仅 main）frontend/src/layouts/)
+
+视觉可重设（见 [10-design-system.md](10-design-system.md)）；**信息架构与关键操作流应对齐**。新站建议 SSR 直出同等信息，而不是先空壳再 fetch。
+
+---
+
+## 1. 路由表
+
+> **本分支（`rebuild/gitea-ssr`）**：浏览器 UI 走 `routers/web` 模板 + 表单，**不依赖**论坛 JSON `/api`。下表「SSR」列表示是否已迁。
+
+### 1.1 认证
+
+| 路径 | 说明 | SSR |
+|------|------|-----|
+| `/login` | 登录 / 登出 | 已迁 |
+| `/register` | 注册（图形验证码；邮件就绪时要邮箱验证码） | 已迁 |
+| `/forgot-password` | 忘记密码 | 已迁 |
+
+### 1.2 前台
+
+| 路径 | 说明 | SSR |
+|------|------|-----|
+| `/` | Feed | 已迁 |
+| `/board/:id` | 板块 Feed | 已迁 |
+| `/boards` | 板块索引 | 已迁 |
+| `/post/:id` | 帖详情 + 评论（回复/赞/私密）/赞/藏 | 已迁 |
+| `/compose` | 发帖（类型字段 + Markdown 工具栏/预览/图片/门控） | 已迁 |
+| `/post/:id/edit` | 编辑帖 | 已迁 |
+| `/profile` | 个人中心（资料/密码/头像/积分钱包） | 已迁 |
+| `/user/:id` | 公开用户页 | 已迁 |
+| `/favorites` | 收藏 | 已迁 |
+| `/projects` | Gitea 码桶 | 后置 |
+| `/links` | 友链 | 已迁 |
+| `/messages` | 私信/通知会话列表 | 已迁 |
+| `/messages/with/:peerId` | 会话详情（peer=0 系统通知） | 已迁 |
+| `/page/:slug` | 站点单页 | 已迁 |
+| `*` | 404 / pending | 已迁 |
+
+### 1.3 后台（Admin SSR，表单 + CSRF，不挂管理 JSON `/api`）
+
+| 路径 | 说明 | SSR |
+|------|------|-----|
+| `/admin` | 重定向 dashboard | 已迁 |
+| `/admin/dashboard` | 概览计数 | 已迁 |
+| `/admin/boards` | 板块 CRUD | 已迁 |
+| `/admin/moderation` | 待审帖/评 通过/拒绝 | 已迁 |
+| `/admin/settings` | 品牌（含 Logo/Favicon/OG）+ 限流 + 内容限制 + 伪静态 + 敏感词 + SMTP + 备份 | 已迁 |
+| `/admin/friend-links` | 品牌友链、申请审核、入口开关 | 已迁 |
+| `/admin/pages` | 站点单页 CRUD / 发布 | 已迁 |
+| `/admin/reports` | 举报处理 | 已迁 |
+| `/admin/users` | 用户列表、禁言、认证、调积分 | 已迁 |
+| `/admin/badges` | 徽章定义 CRUD、限定颁发/收回 | 已迁 |
+| `/admin/media` | 媒体库分类浏览、删除、同步索引 | 已迁 |
+| `/admin/trash` | 帖回收站 | 已迁 |
+| `/admin/login` | 重定向前台登录 | 已迁 |
+
+未迁（原 SPA）：OIDC·Gitea·存储热切换 Admin 等。
+
+---
+
+## 2. 三栏布局（桌面）
+
+```text
+------------------+---------------------------+------------------+
+| Sidebar          | Feed / 主内容              | RightPanel       |
+| - 全部/收藏/码桶 | - FeedHeader / SortBar    | - 签到条(登录)   |
+| - 板块列表       | - VirtualPostList         | - 热门帖         |
+| - 站点页/友链    | - 或 PostDetail 等        | - aside_widgets  |
+| - 管理入口       |                           |   标签云/评论/   |
+|                  |                           |   用户/友链      |
+------------------+---------------------------+------------------+
+| Footer: ICP / 友链入口 / 站点页链接                              |
+------------------------------------------------------------------+
+```
+
+### 2.1 左栏 Sidebar
+
+- 全部帖子、我的收藏（登录）、开源码桶
+- 板块列表（图标 + 色点 + 名称）；空站引导「创建第一个板块」
+- 站点区：友链入口（`nav_show_friend_links`）、`show_in_nav` 的站点页
+- 管理员：管理后台入口
+
+### 2.2 中栏
+
+**Feed**：排序条（最新发帖 / 最新回复 / 热门）+ 搜索面板（关键词、标签、作者、仅标题；已迁 SSR GET）+ 列表项（标题、作者、板块徽章、回复数、置顶/精华）。虚拟滚动 / `feed_list_style` 未迁。
+
+**帖子详情**：标题区操作（赞、藏、举报、编辑、管理操作）→ 待审/被拒横幅（作者/管理员）→ 特殊组件（投票卡 / 悬赏条 / 抽奖卡）→ 正文 `PostContent`（门控块 UI）→ 文章目录 → 作者卡片 → 修订入口 → 评论线程 + 评论框。
+
+### 2.3 右栏 RightPanel
+
+- 登录用户：`AsideCheckInStrip`（签到 + 抽奖 + 积分入口）— **已迁** SSR 右栏；流水/详情仍在 `/profile#wallet`
+- 热门帖 — **已迁** SSR（固定块）
+- 可配置 widgets：`tag_cloud` / `recent_comments` / `recent_users` / `friend_links`（顺序与开关来自 `aside_widgets`）— **已迁** SSR；Admin `/admin/settings` 侧栏组件开关与排序；友链页 aside 勾选共用同一 JSON
+- 桌面三列；≤900px 隐藏右栏
+
+### 2.4 移动端
+
+- 侧栏抽屉化；顶栏搜索/发帖/登录触手可及
+- `PullToRefresh` 下拉刷新
+- 触控友好列表行高
+
+### 2.5 主题
+
+- 浅色 / 暗色；默认 **跟随系统**（CSS `@media (prefers-color-scheme)`）；`localStorage` 键 `j13-theme`（`system` | `light` | `dark`）
+- 显式浅/深时设 `<html data-theme="light|dark">`；`system` 时去掉该属性，交给媒体查询
+- 顶栏按钮循环切换；兼容旧 SPA 仅存 `light`/`dark` 的值
+
+---
+
+## 3. 发帖页 Compose
+
+组件：`ComposeHeader`、`ComposeContextBar`（帖类型）、`ComposeSpecialFields`、`ComposeDocument` / `ArticleEditor`。
+
+### 3.1 帖类型切换
+
+| 类型 | 附加 UI |
+|------|---------|
+| 讨论 | 无 |
+| 问答 | 无额外字段（解决状态在详情）— SSR compose 可选；详情切换已迁 |
+| 投票 | 选项列表、多选开关、最多可选、截止时间或无截止 |
+| 悬赏 | 积分输入（显示余额）— SSR compose；发帖托管 |
+| 抽奖 | 中奖人数 1–20 — SSR compose |
+
+### 3.2 编辑器能力（本分支：Markdown 渐进增强）
+
+源对照：[`ArticleEditor.tsx`](（仅 main）frontend/src/components/ArticleEditor.tsx)（TipTap，**不迁**）
+
+| 能力 | SSR 状态 |
+|------|----------|
+| 标题 h2–h6（`#` 映射为 h2） | Markdown 工具栏 + `ComposeBodyToHTML` |
+| 粗体/斜体/删除线/行内代码 | 已迁 |
+| 链接 | prompt 插入 |
+| 围栏代码块 | 已迁（语言 class） |
+| 列表 / 引用 | 已迁 |
+| 图片上传 | `/compose/upload` |
+| 登录/回复/积分可见门控 | compose 工具栏 |
+| 预览 | `POST /compose/preview`（同消毒管线） |
+| Tab 缩进 / 未保存离开 | `beforeunload` |
+| 表格 / 图片组 / 表情贴纸 / TipTap 双模 | **未做**（后置） |
+
+共用片段：`templates/shared/md_editor.tmpl`（发帖、改帖、评论、改评）。
+
+---
+
+## 4. 帖子详情关键交互
+
+| 模块 | 行为 |
+|------|------|
+| 门控块 | 锁定壳 UI（长度/价格/引导）；`POST /post/:id/unlock` 返回 inner HTML 后替换 |
+| 问答状态 | 已解决/未解决徽章；作者或管理员 `POST /post/:id/question/resolve` 切换 — SSR |
+| 投票卡 | 选选项提交；显示百分比；作者可结束 — SSR `/post/:id/poll/vote|close` |
+| 悬赏条 | 显示积分与状态；采纳按钮在他人评论上；退款按钮按规则禁用并提示 — SSR `/post/:id/bounty/award|refund` |
+| 抽奖卡 | 显示参与人数；开奖；中奖名单 — SSR `/post/:id/lottery/draw` |
+| 评论 | 楼层列表、`reply_to` 引用、嵌套树（`ThreadParentID` + 缩进，全局 `#floor`）、私密/赞/举报/编辑/删除、回复/@ 通知 — SSR |
+| 修订 | 列表 + 单条快照 — SSR `/post/:id/revisions`（作者/管理员；无 diff） |
+| 图片 | Lightbox 查看 |
+
+---
+
+## 5. 消息页
+
+- 左：会话列表（系统会话单独）— SSR `/messages`；快捷链到回复/提及筛选
+- 右：消息时间线；发送框 — SSR `/messages/with/:peerId`
+- 顶：未读角标（全局导航也可显示）
+- 通知筛选（kind）— 系统会话 `?kind=reply|mention|…`
+
+---
+
+## 6. 个人中心 / 公开主页
+
+- 资料编辑、密码、头像直传（**本迭代无裁剪器**）— SSR `/profile`
+- 公开页：签名、等级/积分只读、统计、最近帖 — SSR `/user/:id`（无邮箱）
+- 收藏列表 — SSR `/favorites`
+- 积分钱包面板（余额、近 N 条流水、签到/抽奖表单 PRG）— SSR `/profile`；导航展示当前积分
+- 徽章展示：用户主页 / 个人中心 — SSR（访问时 `EvaluateAuto`）
+
+---
+
+## 7. 友链页
+
+- 展示品牌友链 — SSR `/links`
+- 登录申请表单：名称、URL、Logo（地址或上传）、是否上首页、回链页 — `POST /links/apply`
+- 我的申请状态列表；待审可取消
+- Admin：`/admin/friend-links` 品牌增删、申请通过/拒绝、nav/footer/回链检测开关
+
+---
+
+## 8. 管理后台操作流（按页）
+
+| 页 | 关键操作 |
+|----|----------|
+| Dashboard | 看计数与待办；点进对应列表 |
+| Boards | 拖拽或数字排序；图标/色板选择；增删改 |
+| Pages | 列表发布开关；编辑正文（HTML textarea）；nav/footer 勾选 — SSR `/admin/pages` |
+| Links | 品牌友链增删；申请通过/拒绝/回链复检；回链检测开关；nav/footer/aside 开关 — SSR `/admin/friend-links`（aside 与 Settings 侧栏组件共用 `aside_widgets`） |
+| Posts | 审核通过/拒绝 — SSR `/admin/moderation`；置顶/版顶/精华/锁编/锁评/软删 — 帖详情 Admin 条；回收站恢复/清除 — SSR `/admin/trash` |
+| Comments | 审核 — SSR `/admin/moderation`；修订查看未迁 |
+| Reports | 处理动作：dismiss / resolve / reject_post / reject_comment — SSR `/admin/reports` |
+| Users | 搜索；禁言；认证；调积分；设等级 — SSR `/admin/users`（授徽章在 `/admin/badges`） |
+| Badges | 定义自动/限定徽章；颁发/收回限定 — SSR `/admin/badges` |
+| Media | 分类浏览；单删/批量删；同步索引 — SSR `/admin/media` |
+| Media | 分类浏览；批量删 |
+| Settings | 品牌（含 Logo/Favicon/OG）、限流、内容限制、伪静态、侧栏、敏感词、邮件、SQLite 备份 — SSR `/admin/settings`（OIDC/Gitea/存储热切换未迁） |
+
+---
+
+## 9. 全局 UX 细节
+
+- Toast（sonner）反馈成功/失败
+- 路由级 ErrorBoundary / AppRouteError
+- 懒加载页面 + retry（`lazyWithRetry`）
+- 新标签打开帖子 / 正文外链：受 `open_posts_in_new_tab`、`open_content_links_in_new_tab` 控制
+- 文档标题：`站点名 - 标语`；详情页应换成帖标题（SSR 时首屏即正确）
+
+---
+
+## 10. SSR 重构提示（交互层）
+
+当前 SPA 在客户端挂载后才拉 `/api/posts/:id`。新站应：
+
+1. 服务端渲染列表项与帖文 HTML（已按门控红action）
+2. 水合后接上赞/评/解锁等交互
+3. 管理后台仍可为 CSR，但前台公开页优先 SSR
+
+勿再维护「爬虫一套 HTML、用户一套空壳」双轨，除非过渡期兼容。
--- a/docs/rebuild-spec/07-config-ops.md
+++ b/docs/rebuild-spec/07-config-ops.md
@@ -0,0 +1,213 @@
+# 07 · 配置、运维与 SEO
+
+> **读者**：部署与运维、以及实现配置层的 AI  
+> **前置**：[README.md](README.md)  
+> **源码**：[`config/`](../../config/)、[`README.md`](../../README.md)、[`routers/api/seo.go`](../../routers/api/seo.go)、[`routers/install/`](../../routers/install/)
+
+运维形态可改；下列描述**本分支**行为。
+
+---
+
+## 0. 首次安装（Gitea 式）
+
+| 项 | 说明 |
+|----|------|
+| 锁文件 | `data/install.lock` |
+| 向导 | `GET/POST /install`（`templates/install.tmpl`） |
+| 未锁定 | 除 `/install`、`/ssr-assets/*`、`/health` 外重定向到向导 |
+| 管理员 | 仅安装向导创建；不再「首个注册用户变管理员」 |
+| 向导内容 | 站点名 + 管理员账号（数据库已在进程启动时连上） |
+| 旧数据 | 启动时若已有用户且无锁，自动补写锁 |
+
+**无 `app.ini`。** 引导仅 CLI / Env。
+
+---
+
+## 1. 配置分层与重启边界
+
+| 层 | 存什么 | 变更方式 | 需重启 |
+|----|--------|----------|--------|
+| **Bootstrap** | `DATA`、`HTTP_PORT`/`ADDR`、`DB_TYPE` + DSN/连接参数、工作目录 | CLI / Env | **是** |
+| **密钥文件** | App HMAC（`data/.jwt_secret`，文件名历史遗留）；OIDC RSA **仅启用时**写入 settings（可选遗留文件迁移） | 自动生成 | HMAC 换钥需重启 |
+| **站点运行时** | 品牌、邮件、OIDC 开关、限流、敏感词、存储、伪静态… | DB `forum_settings` | **否**（热更） |
+
+**优先级：** 命令行显式参数 > 环境变量 > 内置默认。
+
+### 进程引导
+
+| CLI | 环境变量 | 默认 | 说明 |
+|-----|----------|------|------|
+| `--port` | `JIANG13_HTTP_PORT` | 3000 | 监听端口 |
+| `--http-addr` | `JIANG13_HTTP_ADDR` | （空=全接口） | 监听地址 |
+| `--data` | `JIANG13_DATA` | `data` | 数据目录 |
+| `--work-path` | `JIANG13_WORK_PATH` | 可执行文件目录 | 工作目录 |
+| `--db-type` | `JIANG13_DB_TYPE` | `sqlite` | `sqlite` \| `postgres` \| `mysql` |
+| `--db-dsn` | `JIANG13_DB_DSN` | （sqlite 默认 `{DATA}/jiang13.db`） | 完整 DSN，优先 |
+| `--db-host` 等 | `JIANG13_DB_HOST` / `USER` / `PASS` / `NAME` / `SSLMODE` | | DSN 为空时拼接（pg/mysql） |
+| `--service` | | | install/uninstall/start/stop/restart/status |
+
+`{DATA}/.jwt_secret`：**App HMAC 密钥**（CSRF 双提交等），启动时自动生成。**不是**浏览器登录 JWT。`--config` / `--jwt-secret` / `JIANG13_JWT_SECRET` 已废弃。
+
+浏览器登录：DB `sessions` + Cookie `jiang13_session`。OIDC 对外 token 仍为 JWT，私钥在 `forum_settings.oidc_rsa_private_pem`（启用时懒加载；未启用不生成 `.oidc_rsa.pem`）。
+
+业务配置（邮件、OIDC、存储、品牌、敏感词等）在 **DB `forum_settings`**，管理后台热更新。
+
+### 数据库 Env 示例
+
+**SQLite（默认）：**
+
+```bash
+JIANG13_DATA=/data
+# 可不设 DB_*；库文件 = $JIANG13_DATA/jiang13.db
+```
+
+**PostgreSQL：**
+
+```bash
+JIANG13_DB_TYPE=postgres
+JIANG13_DB_DSN="postgres://forum:secret@db:5432/jiang13?sslmode=disable"
+# 或拆分：
+# JIANG13_DB_HOST=db:5432
+# JIANG13_DB_USER=forum
+# JIANG13_DB_PASS=secret
+# JIANG13_DB_NAME=jiang13
+# JIANG13_DB_SSLMODE=disable
+```
+
+**MySQL / MariaDB：**
+
+```bash
+JIANG13_DB_TYPE=mysql
+JIANG13_DB_DSN="forum:secret@tcp(db:3306)/jiang13?parseTime=true&loc=Local&charset=utf8mb4"
+```
+
+连库失败时进程**退出并打印 Env 提示**，不会静默回落 sqlite。
+
+### Docker Compose 多库示意
+
+```yaml
+services:
+  jiang13:
+    image: hangzhang714128/jiang13-forum:latest
+    environment:
+      JIANG13_DB_TYPE: postgres
+      JIANG13_DB_DSN: postgres://forum:secret@postgres:5432/jiang13?sslmode=disable
+    volumes:
+      - jiang13-data:/data
+    depends_on: [postgres]
+  postgres:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_USER: forum
+      POSTGRES_PASSWORD: secret
+      POSTGRES_DB: jiang13
+```
+
+---
+
+## 2. 数据目录结构
+
+```text
+data/
+├── install.lock            # 安装完成锁（与 DB 引擎无关）
+├── jiang13.db              # 仅 SQLite 时的主库文件（含 sessions / forum_settings）
+├── jiang13.log             # 运行日志
+├── filter_words.txt        # 遗留：启动时可导入 settings；新源以 DB 为准
+├── .jwt_secret             # App HMAC（CSRF 等；勿提交；非登录 JWT）
+├── .oidc_rsa.pem           # 遗留：仅启用 OIDC 且从文件迁移时可能存在；新站优先 DB
+├── uploads/
+│   ├── avatars/
+│   ├── posts/
+│   └── site/
+└── jiang13_backup_*.db     # SQLite 一键备份（其它引擎请用库方工具）
+```
+
+---
+
+## 3. 部署方式（现网）
+
+| 方式 | 说明 |
+|------|------|
+| 单二进制 | `build.bat` / `make build` → `dist/jiang13(.exe)` |
+| Docker | 镜像挂载 `/data`；健康检查 `GET /health` |
+| Compose | `docker compose up -d --build` |
+| systemd / Windows Service | `--service install` 后启停 |
+
+构建约定见 [`.cursor/rules/build-scripts.mdc`](../../.cursor/rules/build-scripts.mdc)：Windows 用 `build.bat`，勿直接 `make` / `.\build.ps1`。
+
+---
+
+## 4. 存储后端
+
+| type | 行为 |
+|------|------|
+| `local` | 文件落在 `data/uploads`；URL 通常 `/uploads/...` |
+| `s3` | S3 兼容；endpoint、bucket、密钥、public_base_url、prefix、force_path_style |
+
+`image_delivery`：`webp`（默认，经 `/media/thumb`）或 `original`。
+
+媒体索引表 `media` 供后台列表；启动时可后台 SyncMediaIndex。
+
+---
+
+## 5. SEO / 社交分享字段集合
+
+新站应用真 SSR，但 **meta 字段应对齐**：
+
+| 字段 | 来源 |
+|------|------|
+| `<title>` | 站点 DocumentTitle 或帖标题 |
+| meta description | 站点简介优先，否则标语；帖文则摘要 |
+| meta keywords | 站点 keywords |
+| canonical | 绝对 URL |
+| og:* / twitter:* | |
+| JSON-LD | 结构化数据 |
+| robots | 个别页可 noindex |
+
+| 机制 | 说明 |
+|------|------|
+| robots.txt / sitemap.xml | 动态生成 |
+
+重构验收：普通浏览器「查看网页源代码」应能看到帖文正文。
+
+---
+
+## 6. 伪静态 Permalink
+
+设置：`permalink_enabled`、`permalink_ext`（默认 `html`）。
+
+---
+
+## 7. 安全相关运维注意
+
+| 项 | 说明 |
+|----|------|
+| HMAC / OIDC | 勿提交 `.jwt_secret`；OIDC PEM 优先在 DB；遗留 `.oidc_rsa.pem` 亦勿提交 |
+| Cookie | `jiang13_session` HttpOnly + SameSite=Lax；生产 HTTPS 下 Secure |
+| 上传 | 类型/大小限制 |
+| 敏感词 | `forum_settings.filter_words`，后台可改热更 |
+| 备份 | SQLite 文件备份含哈希与私信；PG/MySQL 用官方工具 |
+
+---
+
+## 8. 健康检查
+
+`GET /health` → JSON `status`。DB 不可用时非 200。
+
+---
+
+## 9. 从旧站迁数据建议
+
+1. SQLite：复制 `jiang13.db`；或 dump 到 PG/MySQL 并映射表  
+2. 复制 `uploads/`、`.jwt_secret`（HMAC 兼容）；敏感词若仍在文件可启动导入  
+3. 迁移 `forum_settings` 或后台重配（含 `filter_words`）  
+4. OIDC：`oauth_clients` + settings 中 PEM（或遗留 `.oidc_rsa.pem` 一次迁移）  
+5. 旧站 JWT Cookie 无效；用户需重新登录（opaque session）
+
+表语义以 [03-data-model.md](03-data-model.md) 为准。
+
+---
+
+## 10. 文档包索引
+
+返回 [README.md](README.md) 阅读顺序；功能验收用 [02-features.md](02-features.md)；规则用 [05-business-rules.md](05-business-rules.md)。
--- a/docs/rebuild-spec/08-gitea-ssr-architecture.md
+++ b/docs/rebuild-spec/08-gitea-ssr-architecture.md
@@ -0,0 +1,105 @@
+# 08 · Gitea 式 SSR 架构（开发约定）
+
+> **读者**：在本仓库 `rebuild/gitea-ssr` 分支上开发的 AI / 开发者  
+> **前置**：[README.md](README.md)  
+> **对照上游**：[go-gitea/gitea](https://github.com/go-gitea/gitea)
+
+---
+
+## 目标栈（已确认）
+
+| 层 | 选择 |
+|----|------|
+| 公开页渲染 | Go `html/template` **真 SSR** |
+| 浏览器写操作 | `routers/web` HTML 表单 POST + CSRF + PRG |
+| JSON `/api` | **仅机器客户端**（OIDC、health、`/api/captcha`、`/api/register` 等）；不服务已迁页面 UI |
+| 渐进增强 | `web_src/` → `public/assets/` → `/ssr-assets/` |
+| 发布 | 单二进制 + `go:embed` |
+| 业务语义 | `01`–`07`；冲突时改代码并回写规格 |
+| 不做 | React SPA、爬虫/用户双轨 HTML、为旧 SPA 保留死代码 |
+
+---
+
+## 分支
+
+| 分支 | 用途 |
+|------|------|
+| `main` | React SPA 对照（git checkout / worktree） |
+| `rebuild/gitea-ssr` | 唯一重建分支 |
+
+---
+
+## 目录
+
+```text
+routers/
+  setup.go
+  install/       # INSTALL_LOCK 未置位时的安装向导
+  web/           # HTML + 表单
+  api/           # 精简机器接口（health / OIDC / robots / sitemap / media）
+modules/
+  webctx/        # Doer / CSRF / Flash / HTML / Redirect
+  auth/
+  webrender/
+  seo/
+templates/
+  install.tmpl
+  post-install.tmpl
+  base/ home/ post/ shared/ status/ auth/ admin/ profile/ user/ favorites/ messages/
+services/
+web_src/ → public/assets/
+```
+
+**已删除：** `frontend/`、`embed_static/`、`ServePublicSPA`、爬虫双轨 HTML、首注册变管理员 bootstrap、`app.ini`、浏览器 JWT Cookie 登录。
+
+**配置：** 引导 = CLI/Env（含 `DB_*`）；运行时 = `forum_settings` 热更；`.jwt_secret` = App HMAC；OIDC PEM 启用时进 settings。详见 [07-config-ops.md](07-config-ops.md)。
+
+**会话：** Cookie `jiang13_session` → 表 `sessions`；可吊销。
+
+**数据库：** GORM 方言 `sqlite`（默认）| `postgres` | `mysql`；连库失败不回落。
+
+**后置：** Gitea 仓库同步（不启后台任务）。
+
+---
+
+## 安装
+
+- 锁文件：`data/install.lock`
+- 未安装：除 `/install`、`/ssr-assets/*`、`/health` 外一律重定向到安装向导
+- 管理员仅由安装向导创建；已有用户数据启动时会自动补写锁
+- 向导不选库：库由启动 Env 决定
+
+---
+
+## 渲染与交互原则
+
+1. 已迁路径「查看源代码」须含内容 DOM。
+2. UI 读写不依赖 `/api` 灌首屏或写操作（`/compose/upload` 为同站表单辅助 JSON，带 CSRF）。
+3. 模板默认转义；`safeHTML` 仅用于消毒 + 门控后正文/评论 HTML。
+4. 未迁路径用 `status/pending.tmpl` 或 404，不维护 SPA 占位语义。
+5. 会话 Cookie：`jiang13_session`；`SameSite=Lax`；HTTPS 下 `Secure`。
+
+### 已迁路径（摘要）
+
+公开写：`/install`、`/login`、`/logout`、`/register`、`/forgot-password`（发码/重置）、`/compose`（含门控插入）、`/post/:id/edit`、帖详情评论（reply_to/赞/私密）/赞/藏、评论赞、积分解锁 `POST /post/:id/unlock`。
+
+个人闭环：`/profile`（昵称/签名/密码/头像、积分钱包/签到/抽奖）、`/user/:id`、`/favorites`。
+`POST /profile/checkin`、`POST /profile/lottery`（CSRF + PRG）。
+
+私信：`/messages`、`/messages/with/:peerId`（系统 peer=0 只读；打开会话标已读）。
+
+公开浏览：`/boards` 板块索引（链到 `/board/:id`）。
+
+Feed 搜索：`/` / `/board/:id` 面板（`keyword` / `tag` / `author` / `title_only`）；排序与分页 URL 保参；顶栏链到 `/#search`。
+
+右栏：首页与帖详情三栏；登录用户签到/抽奖条（PRG 可回跳当前 Feed/帖页）；固定热门帖 + `aside_widgets`（标签云 / 最新评论 / 最新用户 / 友链）；Admin `/admin/settings` 可开关排序，友链页 aside 勾选与其共用同一配置。
+
+友链：`/links`（列表、登录申请/取消、Logo 上传）；Admin `/admin/friend-links`（品牌增删、审核、nav/footer/aside 入口开关）。
+
+站点单页：公开 `/page/:slug`；nav/footer 按 `show_in_nav` / `show_in_footer` 注入；Admin `/admin/pages`（CRUD、发布、排序、展示开关）。
+
+举报：帖/评 SSR 表单；Admin `/admin/reports`（dismiss / resolve / reject_post / reject_comment）。
+
+运营标记：帖详情 Admin 条（全局/版内置顶、精华、禁编、锁评、软删）；回收站 `/admin/trash`（恢复/彻底删除）。
+
+Admin：`/admin/dashboard`、`/admin/boards`、`/admin/moderation`、`/admin/settings`（品牌/限流/侧栏组件/敏感词/SMTP）、`/admin/friend-links`、`/admin/pages`、`/admin/reports`、`/admin/trash`。
--- a/docs/rebuild-spec/09-ssr-progress.md
+++ b/docs/rebuild-spec/09-ssr-progress.md
@@ -0,0 +1,52 @@
+# 09 · SSR 重构进度与路线图
+
+> **读者**：产品方 / 实现 AI  
+> **分支**：`rebuild/gitea-ssr`（`main` = SPA 对照）  
+> **验收清单**： [02-features.md](02-features.md)
+
+---
+
+## 当前指针
+
+| 项 | 值 |
+|----|-----|
+| **上一刀** | 首页对齐 main SPA 视觉与交互（草绿壳 + Feed v2） |
+| **下一刀** | 需点名（移动抽屉 / 帖详情抛光 / OIDC Admin…） |
+| **工作区** | 应干净 |
+
+---
+
+## 一句话状态
+
+核心论坛、Admin、Limits/伪静态、嵌套评论、Markdown 编辑器、主题、清青产品壳与资源版本号、首页门面密度已齐；本分支 `routers/api` 仅保留机器入口。余量多为后置与体验打磨。
+
+---
+
+## 已完成（摘）
+
+| 域 | 状态 |
+|----|------|
+| 五种帖 + Admin P1 + §H | 已迁 |
+| Limits / 伪静态 / 品牌图 | 已迁 |
+| 评论嵌套树 UI | 已迁 |
+| Markdown 工具栏 + preview | 已迁 |
+| 浅色 / 暗色 / 跟随系统 | 已迁（CSS 媒体查询，无 head 防闪脚本） |
+| 未挂载论坛 JSON API | 已删（对照 `main`） |
+| 公开页设计系统 | 已迁（首页对齐 main SPA 草绿壳；[10-design-system.md](10-design-system.md)） |
+
+---
+
+## 未完成
+
+- P3：游客评论、修订 diff、响应式侧栏抽屉  
+- 编辑器后置：TipTap、表格、图片组、表情贴纸  
+- 后置：OIDC Admin UI、S3 热切换、Gitea `/projects`  
+
+---
+
+## 如何查阅
+
+| 问题 | 看哪里 |
+|------|--------|
+| 某功能做没做？ | [02-features.md](02-features.md) |
+| 现在该干什么？ | 本文「当前指针」 |
--- a/docs/rebuild-spec/10-design-system.md
+++ b/docs/rebuild-spec/10-design-system.md
@@ -0,0 +1,94 @@
+# 10 · 公开页设计系统
+
+> **读者**：实现公开页视觉 / CSS 的 AI  
+> **前置**：[01-product.md](01-product.md)、[06-pages-ux.md](06-pages-ux.md)  
+> **实现**：[`web_src/css/site.css`](../../web_src/css/site.css)、[`templates/base/`](../../templates/base/)  
+> **品牌**：默认「姜十三论坛」；首页视觉对齐 `main` SPA 草绿产品壳
+
+视觉可重设；**信息架构与关键操作流以 06 为准**。本文件只约定公开页壳层与内容表面的视觉语言。
+
+静态资源须带构建版本号：`/ssr-assets/site.css?v={{.AssetVersion}}`（长缓存 + query 穿透，对齐 Gitea）。
+
+---
+
+## 1. 气质
+
+| 项 | 约定 |
+|----|------|
+| 关键词 | 对齐 `main` SPA：草绿 `#18a058`、清新产品壳 |
+| 密度 | SPA 同款顶栏工具条 + Feed `post-row--v2` |
+| 反模式 | 紫渐变、暖奶油底、大圆角卡片墙、全幅 hero、Inter/Roboto |
+
+---
+
+## 2. Token
+
+### 2.1 色（CSS 变量 `--j13-*`）
+
+| Token | 浅色 | 暗色 | 用途 |
+|-------|------|------|------|
+| `--j13-bg` / page | `#f5f7fa` | `#141416` | 页底 |
+| `--j13-surface` | `#ffffff` | `#1f1f23` | 顶栏、主栏 |
+| `--j13-accent` / green | `#18a058` | `#23c36b` | 主色（对齐 main SPA） |
+| `--j13-accent-ink` | `#138f4c` | `#6ee7a0` | 强强调 |
+| `--j13-soft` / green-bg | `#edfbf3` / `rgba(24,160,88,.08)` | 绿 soft | active / hover |
+| `--j13-border` | `#e8edf2` | `#2e2e32` | 分隔 |
+
+语义色（ok / warn / err / pin / feat）随主题成对定义；feat 用青 soft，不用草绿。
+
+### 2.2 字号与字重
+
+| 阶 | 尺寸 | 用途 |
+|----|------|------|
+| `xs` | 0.72–0.75rem | 口号、辅助 |
+| `sm` | 0.8125rem | 元信息、侧栏、顶栏次级 |
+| `md` | 0.9375rem | 正文默认 |
+| `lg` | 1.15rem | Feed 标题 |
+| `xl` | 1.35rem | 帖标题 |
+| `brand` | 1.3rem / 700 | 顶栏站点名 |
+
+字体栈：**中文优先** PingFang SC / Hiragino / Microsoft YaHei / Noto Sans SC（与 SPA 一致，确保本机可见）；代码 Cascadia / Consolas。不引入 Inter/Roboto，不依赖本机 IBM Plex。
+
+### 2.3 间距与圆角
+
+- 栅格：4px 基准；总宽 `--j13-frame: 1320px`
+- 圆角：`--j13-radius: 8px`；搜索 pill / 排序分段可用满圆角
+- 阴影：sticky 顶栏微阴影
+
+### 2.4 动效
+
+| 处 | 行为 |
+|----|------|
+| 主题 | `color` / `background` / `border-color` `150ms ease` |
+| Feed 行 | hover 背景 |
+| 顶栏 | sticky 阴影；搜索 focus soft ring |
+
+---
+
+## 3. 布局
+
+| 断点 | 行为 |
+|------|------|
+| ≥901px | 三栏：左 210px / 中 1fr / 右 280px；总宽 ~1400px（对齐 SPA） |
+| ≤900px | 隐藏右栏；顶栏搜索折行（抽屉化 **下一刀**） |
+
+---
+
+## 4. 组件约定
+
+| 组件 | 规则 |
+|------|------|
+| 顶栏 | SPA：品牌 \| 搜索胶囊（筛选钮 + Ctrl+K）\| 发帖绿钮 \| 主题/私信/头像菜单 |
+| 左栏 | 浏览 / 板块；active 绿底；板块色槽 + 帖数 |
+| Feed 行 | `post-row--v2`：头像 · 徽章+标题 · 摘要（依 feed_list_style）· 元信息 · 回复数 |
+| 高级搜索 | 顶栏筛选打开；有条件时 details 展开 |
+| 排序 | SPA `feed-sort-tab` 绿 active |
+
+---
+
+## 5. 范围边界
+
+- **覆盖**：公开页壳层（含首页门面密度）、资源 `?v=`、浅/暗色
+- **不覆盖**：Admin 深重绘、移动抽屉、虚拟滚动、TipTap、改站名
+
+交叉：[06-pages-ux.md](06-pages-ux.md) · [09-ssr-progress.md](09-ssr-progress.md)
--- a/docs/rebuild-spec/README.md
+++ b/docs/rebuild-spec/README.md
@@ -0,0 +1,140 @@
+# 姜十三论坛 · 重构规格文档包
+
+> **读者**：准备用新栈（建议真 SSR）重写站点的 AI / 开发者  
+> **事实来源**：本仓库现有代码；规格描述「产品必须保留什么」，不是「必须继续用 Go + React SPA」  
+> **交叉引用**：[01-product](01-product.md) · [02-features](02-features.md) · [03-data-model](03-data-model.md) · [04-api](04-api.md) · [05-business-rules](05-business-rules.md) · [06-pages-ux](06-pages-ux.md) · [07-config-ops](07-config-ops.md) · [08-gitea-ssr-architecture](08-gitea-ssr-architecture.md) · [09-ssr-progress](09-ssr-progress.md) · [10-design-system](10-design-system.md)
+
+> **实现栈（重构分支）**：Gitea 式 Go 模板 SSR；开发分支 `rebuild/gitea-ssr`；`main` 保留 React SPA 对照。详见 [08](08-gitea-ssr-architecture.md)。
+
+---
+
+## 阅读顺序（请按序投喂）
+
+| 顺序 | 文件 | 用途 |
+|------|------|------|
+| 1 | 本文 `README.md` | 架构痛点、重构约束、术语 |
+| 2 | [01-product.md](01-product.md) | 产品定位、角色、模块地图 |
+| 3 | [02-features.md](02-features.md) | 验收级功能清单（可打勾） |
+| 4 | [03-data-model.md](03-data-model.md) | 表结构、枚举、设置键、等级徽章 |
+| 5 | [04-api.md](04-api.md) | HTTP 合约（路径 / 鉴权 / 请求响应） |
+| 6 | [05-business-rules.md](05-business-rules.md) | 状态机与数值规则 |
+| 7 | [06-pages-ux.md](06-pages-ux.md) | 路由、布局、编辑器、后台流程 |
+| 8 | [07-config-ops.md](07-config-ops.md) | 配置、数据目录、部署、SEO 字段 |
+| 9 | [08-gitea-ssr-architecture.md](08-gitea-ssr-architecture.md) | Gitea 式 SSR 分支与目录约定 |
+| 10 | [09-ssr-progress.md](09-ssr-progress.md) | **进度与刀序**（「现在做到哪 / 下一刀」） |
+| 11 | [10-design-system.md](10-design-system.md) | 公开页视觉 token / 组件（壳层重绘） |
+
+单次 context 不够时：先投喂 `README` + `01` + `02`；跟进度看 `09`；实现某模块时再追加对应 `03`–`06` 章节。
+
+---
+
+## 当前产品是什么
+
+**姜十三论坛（Jiang13 Forum）** 面向小圈子 / 团队 / 同好社群的轻量论坛。
+
+当前实现技术栈（**可抛弃，仅作对照**）：
+
+| 层 | 技术 |
+|----|------|
+| 后端 | Go · Gin · GORM · SQLite |
+| 前端 | React 18 SPA · TipTap · Tailwind · TanStack Virtual |
+| 发布 | Vite 构建 → `go:embed` 打进单二进制 |
+| 认证 | bcrypt + DB opaque session Cookie（`jiang13_session`） |
+
+演示站：https://bbs.iioio.com/
+
+---
+
+## 为何要重构：架构痛点（必须打破）
+
+```mermaid
+flowchart LR
+  browser[Browser]
+  spa[ReactSPA]
+  gin[GinAPI]
+  sqlite[SQLite]
+  bot[BotHTML]
+  browser -->|"用户"| spa
+  spa -->|"JSON /api"| gin
+  gin --> sqlite
+  browser -->|"爬虫 UA"| bot
+  bot --> gin
+```
+
+| 痛点 | 现状 | 对用户的影响 |
+|------|------|----------------|
+| 非真 SSR | 生产入口（`main` 的 `embed_static`）只注入 title / branding / Open Graph，**不渲染帖文 DOM** | 刷新先出壳再灌数据，体验不如 SSR |
+| 爬虫双轨 | [`routers/api/seo_bot.go`](../../routers/api/seo_bot.go) 对爬虫返回独立 HTML | 用户与爬虫看到的不是同一套渲染路径 |
+| 无正式 migration | Schema 靠 GORM `AutoMigrate`（[`models/db.go`](../../models/db.go)） | 升级靠「加字段」，难做破坏性迁移与审计 |
+| Cookie JWT（旧） | 浏览器登录曾用 JWT Cookie | **本分支已改为** DB `sessions` + opaque Cookie `jiang13_session`；`.jwt_secret` 仅 CSRF/HMAC |
+
+**新站目标**：用户首屏即可看到帖文 / 列表的服务端渲染（SSR）HTML；SEO meta 与正文同源。技术选型自定（Next.js / Nuxt / Remix / 其它均可）。
+
+---
+
+## 重构时必须保留 vs 可以改
+
+### 必须保留（产品语义）
+
+- [02-features.md](02-features.md) 中列出的功能能力
+- [03-data-model.md](03-data-model.md) 中的实体关系与枚举含义（表名可改，语义对齐）
+- [05-business-rules.md](05-business-rules.md) 中的数值与状态机（积分、审核、门控、悬赏分成等）
+- 角色模型：游客 / 用户 / 认证用户（`verified` 免审）/ 管理员；**管理员仅由 `/install` 创建**（不再首注册变管理员）
+
+### 建议兼容（降低迁移成本）
+
+- [04-api.md](04-api.md) 的 JSON 字段命名与路径形状（可做版本前缀，但旧字段名便于对照）
+- Cookie 名 `jiang13_session`（opaque session id；重建分支不做 `jiang13_token` 双读）
+- 数据目录语义：`jiang13.db`、`uploads/`；敏感词在 `forum_settings.filter_words`（旧 `filter_words.txt` 可导入）
+
+### 可以彻底改
+
+- 语言与框架（不必再 Go + React SPA）
+- 单二进制 / `go:embed`（可改为前后端分离部署）
+- SQLite（可换 PostgreSQL 等；规格不强制）
+- UI 视觉（布局信息密度见 [06-pages-ux.md](06-pages-ux.md)，视觉可重设）
+- 爬虫专用 HTML 双轨（用真 SSR 取代）
+
+---
+
+## 术语表（首次出现）
+
+| 术语 | 中文 | 说明 |
+|------|------|------|
+| SSR | 服务端渲染 | 首屏 HTML 含正文，非纯客户端壳 |
+| SPA | 单页应用 | 当前前台实现形态 |
+| OIDC | 开放身份连接 | 本站可作 Provider，供 Gitea 等 SSO |
+| JWT | JSON Web Token | OIDC 对外 `id_token`/`access_token` 仍用；**浏览器登录不用 JWT** |
+| Opaque session | 不透明会话 | Cookie 只存随机 id，服务端 `sessions` 表可吊销 |
+| Feed | 信息流 | 首页 / 板块帖列表 |
+| 门控 | Content gate | 登录可见 / 回复可见 / 积分可见区块 |
+| 伪静态 | Permalink | 如 `/post/123.html` 的可选后缀 |
+
+---
+
+## 源码速查（核对规格时）
+
+| 主题 | 路径 |
+|------|------|
+| 路由总装 | [`routers/setup.go`](../../routers/setup.go) |
+| GORM 模型 | [`models/models.go`](../../models/models.go) |
+| AutoMigrate | [`models/db.go`](../../models/db.go) |
+| 论坛设置键 | [`services/settings.go`](../../services/settings.go) |
+| SSR 页面路由 | [`routers/web/`](../../routers/web/) |
+| JSON API | [`routers/api/`](../../routers/api/) |
+| 前端 API / 页面（对照） | 仅 `main`：`frontend/src/api/`、`frontend/src/App.tsx` |
+| 产品介绍 | [`docs/introduction.md`](../introduction.md)、[`README.md`](../../README.md) |
+
+---
+
+## 文档包完成标准
+
+另一 AI 仅阅读本目录、**不打开业务源码**，应能：
+
+1. 列出全部用户可见功能与后台能力  
+2. 画出核心表 ER 并理解枚举  
+3. 实现或 mock 与现网兼容的 API 形状  
+4. 复现审核 / 积分 / 门控 / 特殊帖规则  
+5. 搭出等价的页面信息架构与关键交互  
+
+若规格与代码冲突：**以代码为准**，并应回写修正本目录文档。
--- a/docs/rebuild-spec/plans/admin-badges.md
+++ b/docs/rebuild-spec/plans/admin-badges.md
@@ -0,0 +1,22 @@
+# Admin 徽章管理（SSR）— 实现计划
+
+> 状态：已完成（SSR `/admin/badges`）  
+> 分支：`rebuild/gitea-ssr`
+
+## 范围
+
+| 能力 | 服务 | 路由 |
+|------|------|------|
+| 列表（含停用） | `BadgeService.ListDefs(true)` | `GET /admin/badges` |
+| 创建/更新定义 | `UpsertDef` | `POST /admin/badges`、`POST /admin/badges/:id` |
+| 删除定义 | `DeleteDef`（清 `user_badges`） | `POST /admin/badges/:id/delete` |
+| 颁发限定 | `AwardLimited` | `POST /admin/badges/award` |
+| 收回 | `Revoke` | `POST /admin/badges/revoke` |
+
+## 不做
+
+自动徽章规则引擎调度 UI（P2，服务层 `EvaluateAuto` 仍可被触发）、等级设定。
+
+## 验证
+
+`build.bat`；冒烟：创建限定徽章 → 颁发给用户 → 收回 → 删除。
--- a/docs/rebuild-spec/plans/admin-media.md
+++ b/docs/rebuild-spec/plans/admin-media.md
@@ -0,0 +1,21 @@
+# Admin 媒体库（SSR）— 实现计划
+
+> 状态：已完成（SSR `/admin/media`）  
+> 分支：`rebuild/gitea-ssr`
+
+## 范围
+
+| 能力 | 服务 | 路由 |
+|------|------|------|
+| 分类/搜索/分页列表 | `UploadStore.ListMedia` | `GET /admin/media` |
+| 单删 | `DeleteMediaByIDs` | `POST /admin/media/:id/delete` |
+| 批量删 | 同上 | `POST /admin/media/delete` |
+| 同步索引 | `SyncMediaIndex` | `POST /admin/media/sync` |
+
+## 不做
+
+S3 热切换 Admin、全站未引用扫描清理、WebP 产品化默认策略。
+
+## 验证
+
+`build.bat`；冒烟：写入 uploads → 同步索引 → 列表可见 → 删除。
--- a/docs/rebuild-spec/plans/admin-users.md
+++ b/docs/rebuild-spec/plans/admin-users.md
@@ -0,0 +1,30 @@
+# Admin 用户管理（SSR）— 实现计划
+
+> 状态：已完成（SSR `/admin/users`）  
+> 分支：`rebuild/gitea-ssr`
+
+## 范围
+
+在 Admin 增加用户列表与运营操作，复用已有服务层，不恢复浏览器管理 JSON `/api`。
+
+| 能力 | 服务 | 路由 |
+|------|------|------|
+| 列表/搜索/分页 | `UserService.ListUsers` | `GET /admin/users` |
+| 禁言/解禁 | `UserService.BanUser` | `POST /admin/users/:id/ban` |
+| 认证开关 | `SetVerified` | `POST /admin/users/:id/verify` |
+| 调积分 | `PointsService.AdminAdjust` | `POST /admin/users/:id/points` |
+
+## 实现要点
+
+1. [`routers/web/home.go`](../routers/web/home.go) admin 组注册上述路由  
+2. 新建 [`routers/web/admin_users.go`](../routers/web/admin_users.go)：渲染 + CSRF POST + PRG  
+3. [`templates/admin/users.tmpl`](../templates/admin/users.tmpl) + [`templates/admin/nav.tmpl`](../templates/admin/nav.tmpl) 入口  
+4. 回写 `02` §H（调积分/认证相关）、`06` `/admin/users` 已迁；更新 `09` 当前指针 → badges  
+
+## 不做
+
+等级设定 UI、徽章授予、批量导入、恢复 `/api/admin/users` 作 UI。
+
+## 验证
+
+`build.bat`；冒烟：搜索用户 → 禁言 → 调积分 → 切换 verified。
--- a/docs/rebuild-spec/plans/level-badges-display.md
+++ b/docs/rebuild-spec/plans/level-badges-display.md
@@ -0,0 +1,17 @@
+# P2 等级设定与徽章展示 — 实现计划
+
+> 状态：已完成  
+> 分支：`rebuild/gitea-ssr`
+
+## 范围
+
+| 能力 | 实现 |
+|------|------|
+| Admin 设等级 | `POST /admin/users/:id/level` → `SetUserLevel`（Exp 调至门槛） |
+| 公开等级 | 既有 `/user/:id`、`/profile` Lv/Exp |
+| 徽章展示 | 用户页 / 资料页列表；访问时 `EvaluateAuto` |
+| 防刷分成 | 确认 `suspiciousUnlockPair` 已落地并勾选 `02` |
+
+## 验证
+
+`build.bat`；冒烟：设用户 Lv5 → Exp=200；用户页可见等级。
--- a/docs/screenshots/home-dark.png
+++ b/docs/screenshots/home-dark.png
--- a/docs/screenshots/home-light.png
+++ b/docs/screenshots/home-light.png
--- a/docs/screenshots/mobile-home.png
+++ b/docs/screenshots/mobile-home.png
--- a/docs/screenshots/post-detail.png
+++ b/docs/screenshots/post-detail.png
--- a/docs/screenshots/post-rich.png
+++ b/docs/screenshots/post-rich.png
--- a/docs/site-posts/README.md
+++ b/docs/site-posts/README.md
@@ -0,0 +1,28 @@
+# 站务公告 · 发帖素材
+
+## 板块设置
+
+| 项 | 建议值 |
+| --- | --- |
+| 名称 | 站务公告 |
+| 描述 | 本站说明与姜十三论坛介绍。请勿灌水。 |
+| 图标 | `megaphone` |
+| 色标 | 建议第 0 或 1 槽 |
+| 排序 | `0` |
+
+## 主文（必发）
+
+| 文件 | 标题 | 标签 | 操作 |
+| --- | --- | --- | --- |
+| [about-jiang13.md](./about-jiang13.md) | 关于本站 · 姜十三论坛 | `站务` `介绍` | **置顶**（可选精华） |
+
+把原先分篇的「上手 / 功能 / 部署」三帖 **删除**，避免与长文重复。
+
+## 可选短文
+
+若站务区希望不止一篇，见 [optional.md](./optional.md)：
+
+- [community-guidelines.md](./community-guidelines.md) — 发帖约定  
+- [feedback.md](./feedback.md) — 反馈与建议  
+
+复制正文时：从各文件第一个 `---` **之后**开始粘贴。
--- a/docs/site-posts/about-jiang13.md
+++ b/docs/site-posts/about-jiang13.md
@@ -0,0 +1,185 @@
+# 关于本站 · 姜十三论坛
+
+> 建议标题：关于本站 · 姜十三论坛  
+> 建议标签：`站务` `介绍`  
+> 建议操作：置顶（可选精华）
+
+---
+
+你好，欢迎加入本站。
+
+这里运行的是开源论坛 **姜十三论坛（Jiang13 Forum）**——面向小圈子、团队与同好社群，目标很明确：
+
+**能聊 · 好看 · 好装**
+
+下文介绍它是什么、怎么上手、有哪些能力，以及为何采用单文件部署。读完即可开始发帖；细节可随时回来查阅。
+
+---
+
+## 一、它是什么
+
+姜十三论坛不是大而全的社区平台，而是一款轻量、现代化的论坛软件。
+
+它做好一件事：给「几人到几百人」的内部交流，一个干净、顺手、数据在自己手里的地方。
+
+- 有板块、帖子、楼层回复，讨论能沉淀、能追溯  
+- 界面清爽，信息密度适中，桌面与手机都好用  
+- 单个程序即可部署，备份路径清晰  
+
+技术上，它是一个 **Go 单二进制**：前端页面内嵌，数据库用内置 **SQLite**。拷到服务器、启动、注册——就可以用。
+
+### 谁适合用
+
+| 场景 | 说明 |
+| --- | --- |
+| 团队 / 工作室 | 需求讨论、进度同步、知识沉淀 |
+| 兴趣小圈子 | 同好交流、作品分享、活动组织 |
+| 项目配套社区 | 可与 Gitea 等做 SSO 联动 |
+| 个人站长 | 单机可跑，无需云数据库与一堆微服务 |
+
+若你需要百万级公网社区、复杂插件生态或企业级工单流，它可能不是最优选。  
+若你要的是 **小而美、自己能装、自己能管**，就对了。
+
+### 本板块说明
+
+「站务公告」只发站务与介绍类内容。日常聊天、提问、分享，请到其他讨论板块。
+
+---
+
+## 二、三分钟上手
+
+### 注册与登录
+
+1. 打开注册页，填写用户名、邮箱与密码。  
+2. 若已开启邮件服务，可能需要邮箱验证码。  
+3. **第一个注册用户自动成为管理员**，无需安装向导。
+
+登录后，右上角会出现头像与私信入口。
+
+### 认识首页
+
+| 区域 | 内容 |
+| --- | --- |
+| 左侧 | 板块导航、常用入口 |
+| 中间 | 帖子列表（Feed） |
+| 右侧 | 热门帖、最新评论等 |
+
+列表可按 **最新发帖 / 最新回复 / 热门** 切换。  
+支持浅色 / 暗色主题，偏好会记住。手机上侧栏会收起，不影响浏览与发帖。
+
+### 发帖与回复
+
+点「发帖」→ 选板块 → 写标题、标签（可选）与正文。  
+正文支持富文本与图片上传。评论是 **楼层式** 的，可回复、引用、@。
+
+帖子可点赞、收藏；公开主页可展示你的资料与动态。
+
+### 个人入口
+
+头像菜单常见项：个人主页、账号设置、站内私信、我的收藏。
+
+### 管理后台（仅管理员）
+
+访问 `/admin`：板块、帖子、评论、举报、用户、媒体、系统设置，以及备份等。
+
+| 改什么 | 去哪里 |
+| --- | --- |
+| 端口、数据目录、DB、JWT | CLI / Env + `data/.jwt_secret`（改引导项需重启） |
+| 品牌、OIDC、邮件、对象存储、限流、敏感词等 | 后台「系统设置」（保存即生效） |
+
+逛完板块，发第一帖或回一楼——聊起来就对了。
+
+---
+
+## 三、功能速览
+
+功能刻意收在「小圈子真正用得到」的范围内。
+
+### 浏览与发帖
+
+- 三栏布局，桌面 / 移动自适应  
+- Feed 排序  
+- 浅色 / 暗色主题（可跟随系统）；板块图标与主题色可配  
+- Markdown 编辑器、标签、正文图片、内容门控  
+- 楼层评论：回复、引用、嵌套树  
+- 点赞、收藏；置顶 / 精华  
+- 编辑修订历史  
+- 可配置普通用户的编辑时限  
+
+### 社交与个人
+
+- 公开用户主页  
+- 会话式站内私信  
+- 昵称、签名、头像等资料  
+
+### 管理后台
+
+SSR 后台统一在 `/admin`：
+
+| 模块 | 能力 |
+| --- | --- |
+| 仪表盘 | 站点概览 |
+| 板块 | 创建、编辑、排序、外观 |
+| 帖子 | 审核、置顶、精华、锁定、回收站 |
+| 评论 / 举报 | 审核与处理 |
+| 用户 | 禁言等 |
+| 媒体 | 查看与清理上传 |
+| 设置 | 品牌、限流、敏感词、邮件、OIDC、存储等 |
+| 备份 | SQLite 一键备份 |
+
+### 可选能力
+
+按需在后台开启，不是装完就必须用：
+
+- 邮件验证码注册  
+- OIDC Provider（可作 Gitea 等登录源）  
+- Gitea 公开仓库同步到「开源码桶」  
+- 本地磁盘或 S3 兼容对象存储  
+
+### 权限
+
+只有两种角色：**普通用户** / **管理员**。  
+第一个注册用户即管理员。小圈子够用，不堆角色矩阵。
+
+项目仍在积极开发。完整规划见仓库 `ROADMAP.md`，欢迎反馈与共建。
+
+---
+
+## 四、为什么是单文件部署
+
+最硬核的一点，是部署路径极短——不是「理论上能打包」，而是日常用法就是：
+
+1. 编译得到一个二进制  
+2. 放到目录里运行  
+3. 自动生成 `data/.jwt_secret`  
+4. 浏览器注册，第一个账号即管理员  
+
+### 它补哪块空缺
+
+论坛方案常落在两端：很重（功能全、运维贵），或很碎（聊天 / 文档方便，却缺少发帖沉淀）。  
+小圈子往往需要中间态：有论坛结构、界面顺手、一个人能装、备份好懂。单文件部署，就是为后两点服务的。
+
+### 具体意味着什么
+
+| 能力 | 说明 |
+| --- | --- |
+| 单二进制 | 前端已内嵌，不必单独部署前端目录 |
+| 内置 SQLite | 零外部数据库，数据在本地目录 |
+| Env / CLI 引导 | 端口、数据目录、数据库 |
+| 后台热配置 | OIDC、邮件、存储、品牌等保存即生效 |
+| 系统服务 | 内置 Linux systemd / Windows Service |
+| 跨平台 | Windows / Linux / macOS 均可编译运行 |
+
+备份也直观：数据库、上传、配置结构清晰，拷贝即可留存。
+
+进程级项改 Env/CLI 后重启；业务项在管理后台改。引导面保持精简，热更新走数据库。
+
+---
+
+## 写在最后
+
+**姜十三论坛** = 小圈子该有的论坛能力 × 清新界面 × 真正能单文件带走的部署。
+
+源码与说明见项目仓库。许可证：MIT。
+
+有问题可联系管理员。祝你在这里聊得愉快。
--- a/docs/site-posts/community-guidelines.md
+++ b/docs/site-posts/community-guidelines.md
@@ -0,0 +1,30 @@
+# 本站发帖约定
+
+> 建议标题：本站发帖约定  
+> 建议标签：`站务` `公约`  
+> 建议操作：普通发布（可选）
+
+---
+
+本站是小圈子论坛，约定尽量少、好遵守。
+
+## 请这样做
+
+- 选对板块再发；不确定就发到综合讨论类板块  
+- 标题写清楚在说什么，方便后人搜索  
+- 讨论对事不对人；引用、回复尽量指向具体楼层  
+- 分享链接时简单说明来源与用途  
+
+## 请避免
+
+- 在「站务公告」灌水、闲聊（请到其他板块）  
+- 无意义刷屏、重复灌帖  
+- 人身攻击、骚扰、泄露他人隐私  
+- 明显的广告、引流（除非板块明确允许）  
+
+## 管理说明
+
+管理员可能会：移动板块、编辑标题、锁定、删除或禁言。  
+有争议可私信管理员说明情况。
+
+一句话：**把讨论留给值得留下的内容。**
--- a/docs/site-posts/feedback.md
+++ b/docs/site-posts/feedback.md
@@ -0,0 +1,26 @@
+# 反馈与建议
+
+> 建议标题：反馈与建议  
+> 建议标签：`站务` `反馈`  
+> 建议操作：普通发布（可选）
+
+---
+
+本站程序是开源的 **姜十三论坛**，仍在积极开发。欢迎反馈。
+
+## 站内怎么说
+
+- **功能建议 / 体验吐槽**：开新帖，尽量写清场景与期望  
+- **疑似缺陷**：说明步骤、浏览器、是否可复现；有截图更好  
+- **站务问题**（注册、权限、内容处理）：私信管理员  
+
+## 开发仓库（可选）
+
+若你也参与程序本身：
+
+- 查路线图、提 Issue / PR：见项目仓库  
+- 许可证：MIT  
+
+站内讨论与仓库 Issue 不必重复提交；选一处说清楚即可。
+
+感谢一起把小圈子聊好。
--- a/docs/site-posts/optional.md
+++ b/docs/site-posts/optional.md
@@ -0,0 +1,10 @@
+# 可选短文（不与介绍长文重复）
+
+长文 [`about-jiang13.md`](./about-jiang13.md) 置顶后，原先分篇的「上手 / 功能 / 部署」建议 **直接删除**。
+
+若希望「站务公告」里还有几篇配套短帖，可用下面两篇（按需发，不必全发）。
+
+| 文件 | 标题 | 标签 | 说明 |
+| --- | --- | --- | --- |
+| [community-guidelines.md](./community-guidelines.md) | 本站发帖约定 | `站务` `公约` | 轻量规则，避免灌水 |
+| [feedback.md](./feedback.md) | 反馈与建议 | `站务` `反馈` | 引导提问题、提想法 |
--- a/embed_static/embed.go
+++ b/embed_static/embed.go
@@ -1,73 +0,0 @@
-package embed_static
-
-import (
-	"embed"
-	"html/template"
-	"io/fs"
-	"net/http"
-	"strings"
-
-	"github.com/gin-gonic/gin"
-)
-
-//go:embed static/*
-var staticFS embed.FS
-
-//go:embed templates/*
-var templatesFS embed.FS
-
-// SetupEmbed 配置内嵌资源：SPA 前端 + 后台 HTML 模板
-func SetupEmbed(r *gin.Engine) error {
-	tmpl, err := LoadTemplates()
-	if err != nil {
-		return err
-	}
-	r.SetHTMLTemplate(tmpl)
-
-	// React SPA 构建产物（Vite）
-	if sub, err := fs.Sub(staticFS, "static/spa/assets"); err == nil {
-		r.GET("/assets/*filepath", gin.WrapH(http.StripPrefix("/assets", http.FileServer(http.FS(sub)))))
-	}
-
-	// 后台管理遗留静态资源
-	if sub, err := fs.Sub(staticFS, "static/legacy"); err == nil {
-		r.GET("/legacy/*filepath", gin.WrapH(http.StripPrefix("/legacy", http.FileServer(http.FS(sub)))))
-	}
-
-	return nil
-}
-
-// ServeSPA 返回 React SPA 入口
-func ServeSPA(c *gin.Context) {
-	data, err := staticFS.ReadFile("static/spa/index.html")
-	if err != nil {
-		c.String(http.StatusNotFound, "前端未构建，请运行: cd frontend && npm run build")
-		return
-	}
-	c.Data(http.StatusOK, "text/html; charset=utf-8", data)
-}
-
-// IsSPARoute 判断是否应由 SPA 处理
-func IsSPARoute(path string) bool {
-	if strings.HasPrefix(path, "/api") ||
-		strings.HasPrefix(path, "/admin") ||
-		strings.HasPrefix(path, "/uploads") ||
-		strings.HasPrefix(path, "/legacy") ||
-		strings.HasPrefix(path, "/assets") {
-		return false
-	}
-	return true
-}
-
-func LoadTemplates() (*template.Template, error) {
-	sub, err := fs.Sub(templatesFS, "templates")
-	if err != nil {
-		return nil, err
-	}
-	tmpl := template.New("").Funcs(template.FuncMap{
-		"safeHTML": func(s string) template.HTML { return template.HTML(s) },
-		"add":      func(a, b int) int { return a + b },
-		"sub":      func(a, b int) int { return a - b },
-	})
-	return tmpl.ParseFS(sub, "*.html", "admin/*.html")
-}
--- a/embed_static/static/css/style.css
+++ b/embed_static/static/css/style.css
@@ -1,80 +0,0 @@
-/* 姜十三论坛全局样式 */
-:root {
-  --primary: #2c5530;
-  --primary-light: #3d7a44;
-  --accent: #c9a227;
-}
-
-body {
-  min-height: 100vh;
-  display: flex;
-  flex-direction: column;
-  background-color: #f8f9fa;
-}
-
-.navbar-brand {
-  font-weight: 700;
-  letter-spacing: 0.05em;
-}
-
-.site-footer {
-  margin-top: auto;
-  background: #212529;
-  color: #adb5bd;
-  padding: 1.5rem 0;
-  font-size: 0.875rem;
-}
-
-.post-content {
-  line-height: 1.8;
-  word-break: break-word;
-}
-
-.post-content img {
-  max-width: 100%;
-  height: auto;
-}
-
-.comment-floor {
-  border-left: 3px solid var(--primary);
-  padding-left: 1rem;
-}
-
-.avatar-sm {
-  width: 36px;
-  height: 36px;
-  object-fit: cover;
-  border-radius: 50%;
-}
-
-.avatar-md {
-  width: 64px;
-  height: 64px;
-  object-fit: cover;
-  border-radius: 50%;
-}
-
-.badge-pin {
-  background: var(--accent);
-}
-
-.admin-sidebar .nav-link.active {
-  background: var(--primary);
-  color: #fff;
-}
-
-.admin-sidebar .nav-link {
-  color: #333;
-  border-radius: 0.375rem;
-  margin-bottom: 0.25rem;
-}
-
-.login-slogan {
-  font-style: italic;
-  color: #6c757d;
-  letter-spacing: 0.1em;
-}
-
-@media (max-width: 576px) {
-  .navbar-brand span.en { display: none; }
-}
--- a/embed_static/static/js/app.js
+++ b/embed_static/static/js/app.js
@@ -1,28 +0,0 @@
-// 姜十三论坛前端通用脚本
-function apiPost(url, data, isForm) {
-  const opts = { method: 'POST', credentials: 'same-origin' };
-  if (isForm) {
-    opts.body = new FormData(data instanceof HTMLFormElement ? data : undefined);
-    if (!(data instanceof HTMLFormElement)) {
-      const fd = new FormData();
-      for (const k in data) fd.append(k, data[k]);
-      opts.body = fd;
-    }
-  } else {
-    opts.headers = { 'Content-Type': 'application/json' };
-    opts.body = JSON.stringify(data);
-  }
-  return fetch(url, opts).then(r => r.json());
-}
-
-function showToast(msg, type) {
-  const el = document.getElementById('toast');
-  if (!el) { alert(msg); return; }
-  el.className = 'toast align-items-center text-bg-' + (type || 'success') + ' border-0 show';
-  el.querySelector('.toast-body').textContent = msg;
-  new bootstrap.Toast(el).show();
-}
-
-function confirmAction(msg, callback) {
-  if (confirm(msg)) callback();
-}
--- a/embed_static/static/legacy/css/style.css
+++ b/embed_static/static/legacy/css/style.css
@@ -1,499 +0,0 @@
-/* 姜十三论坛 - 前台 + 管理后台样式 */
-:root {
-  --primary: #1a7f4b;
-  --primary-dark: #156b3f;
-  --primary-light: #e8f5ee;
-  --accent: #c9a227;
-  --admin-sidebar-w: 220px;
-}
-
-body {
-  min-height: 100vh;
-  background-color: #f4f6f8;
-  color: #1d2129;
-}
-
-/* ===== 管理后台 ===== */
-.admin-body {
-  display: flex;
-  flex-direction: column;
-  min-height: 100vh;
-  background: #f2f3f5;
-}
-
-.admin-topbar {
-  height: 56px;
-  background: var(--primary);
-  color: #fff;
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  padding: 0 24px;
-  position: sticky;
-  top: 0;
-  z-index: 100;
-  box-shadow: 0 2px 8px rgba(0,0,0,.1);
-}
-
-.admin-topbar-brand {
-  display: flex;
-  align-items: center;
-  gap: 12px;
-}
-
-.admin-topbar-mark {
-  width: 34px;
-  height: 34px;
-  border-radius: 8px;
-  background: rgba(255,255,255,.2);
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  font-weight: 700;
-  font-size: 15px;
-  flex-shrink: 0;
-}
-
-.admin-topbar-title {
-  display: block;
-  font-weight: 600;
-  font-size: 15px;
-  line-height: 1.3;
-}
-
-.admin-topbar-sub {
-  display: block;
-  font-size: 12px;
-  opacity: .75;
-  font-weight: 400;
-}
-
-.admin-topbar-actions {
-  display: flex;
-  align-items: center;
-  gap: 12px;
-}
-
-.admin-topbar-user {
-  font-size: 13px;
-  opacity: .9;
-  padding-right: 4px;
-  border-right: 1px solid rgba(255,255,255,.25);
-  margin-right: 4px;
-  padding-left: 0;
-}
-
-.admin-shell {
-  display: flex;
-  flex: 1;
-  min-height: 0;
-}
-
-.admin-sidebar {
-  width: var(--admin-sidebar-w);
-  flex-shrink: 0;
-  background: #fff;
-  border-right: 1px solid #e5e6eb;
-  padding: 20px 14px;
-  overflow-y: auto;
-}
-
-.admin-sidebar-section {
-  font-size: 11px;
-  font-weight: 600;
-  color: #86909c;
-  padding: 12px 12px 6px;
-  letter-spacing: .06em;
-}
-
-.admin-sidebar-section:first-child {
-  padding-top: 4px;
-}
-
-.admin-sidebar .nav-link {
-  display: block;
-  color: #4e5969;
-  border-radius: 8px;
-  padding: 10px 12px;
-  margin-bottom: 2px;
-  font-size: 14px;
-  text-decoration: none;
-  transition: background .15s, color .15s;
-  border-left: 3px solid transparent;
-}
-
-.admin-sidebar .nav-link:hover {
-  background: #f7f8fa;
-  color: #1d2129;
-}
-
-.admin-sidebar .nav-link.active {
-  background: var(--primary-light);
-  color: var(--primary);
-  font-weight: 600;
-  border-left-color: var(--primary);
-}
-
-.admin-main {
-  flex: 1;
-  min-width: 0;
-  padding: 28px 32px;
-  overflow-y: auto;
-  max-width: 1280px;
-}
-
-.admin-page-head {
-  display: flex;
-  justify-content: space-between;
-  align-items: flex-end;
-  gap: 16px;
-  margin-bottom: 24px;
-  flex-wrap: wrap;
-}
-
-.admin-page-head h1 {
-  font-size: 24px;
-  font-weight: 600;
-  margin: 0 0 6px;
-  color: #1d2129;
-}
-
-.admin-page-head p {
-  margin: 0;
-  color: #86909c;
-  font-size: 14px;
-}
-
-.admin-search-bar {
-  display: flex;
-  gap: 8px;
-  align-items: center;
-}
-
-.admin-search-bar .form-control {
-  width: 240px;
-  border-color: #e5e6eb;
-  font-size: 13px;
-}
-
-.admin-stat-grid {
-  display: grid;
-  grid-template-columns: repeat(5, 1fr);
-  gap: 16px;
-  margin-bottom: 24px;
-}
-
-.admin-stat-card {
-  background: #fff;
-  border: 1px solid #e5e6eb;
-  border-radius: 12px;
-  padding: 18px 20px;
-  display: flex;
-  align-items: center;
-  gap: 14px;
-  transition: box-shadow .2s;
-}
-
-.admin-stat-card:hover {
-  box-shadow: 0 4px 12px rgba(0,0,0,.06);
-}
-
-.admin-stat-icon {
-  width: 44px;
-  height: 44px;
-  border-radius: 10px;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  font-size: 15px;
-  font-weight: 700;
-  flex-shrink: 0;
-}
-
-.admin-stat-users .admin-stat-icon { background: #e8f3ff; color: #3491fa; }
-.admin-stat-posts .admin-stat-icon { background: #e8f5ee; color: var(--primary); }
-.admin-stat-boards .admin-stat-icon { background: #fff7e8; color: #ff7d00; }
-.admin-stat-comments .admin-stat-icon { background: #f5e8ff; color: #722ed1; }
-.admin-stat-online .admin-stat-icon { background: #e8ffea; color: #00b42a; }
-
-.admin-stat-users .value { color: #3491fa; }
-.admin-stat-posts .value { color: var(--primary); }
-.admin-stat-boards .value { color: #ff7d00; }
-.admin-stat-comments .value { color: #722ed1; }
-.admin-stat-online .value { color: #00b42a; }
-
-.admin-stat-card .value {
-  font-size: 26px;
-  font-weight: 700;
-  line-height: 1.2;
-}
-
-.admin-stat-card .label {
-  font-size: 13px;
-  color: #86909c;
-  margin-top: 2px;
-}
-
-.admin-card {
-  background: #fff;
-  border: 1px solid #e5e6eb;
-  border-radius: 12px;
-  margin-bottom: 20px;
-  overflow: hidden;
-  box-shadow: 0 1px 2px rgba(0,0,0,.04);
-}
-
-.admin-card-head {
-  padding: 16px 20px;
-  border-bottom: 1px solid #f2f3f5;
-  font-weight: 600;
-  font-size: 15px;
-  display: flex;
-  justify-content: space-between;
-  align-items: center;
-  color: #1d2129;
-}
-
-.admin-card-link {
-  font-size: 13px;
-  font-weight: 500;
-  color: var(--primary);
-  text-decoration: none;
-  transition: opacity .15s;
-}
-
-.admin-card-link:hover {
-  opacity: .75;
-  color: var(--primary-dark);
-}
-
-.admin-card-body {
-  padding: 20px;
-}
-
-.admin-table {
-  margin: 0;
-  font-size: 13px;
-  --bs-table-hover-bg: #f7f8fa;
-}
-
-.admin-table th {
-  background: #fafbfc;
-  font-weight: 600;
-  white-space: nowrap;
-  color: #4e5969;
-  font-size: 12px;
-  padding: 12px 16px;
-  border-bottom: 1px solid #e5e6eb;
-}
-
-.admin-table td {
-  vertical-align: middle;
-  padding: 12px 16px;
-  border-bottom: 1px solid #f2f3f5;
-  color: #1d2129;
-}
-
-.admin-table tbody tr:last-child td {
-  border-bottom: none;
-}
-
-.admin-table tbody tr:hover td {
-  background: #fafbfc;
-}
-
-.admin-table .btn-link {
-  color: var(--primary);
-  text-decoration: none;
-  font-weight: 500;
-}
-
-.admin-table .btn-link:hover {
-  text-decoration: underline;
-}
-
-.text-truncate-cell {
-  max-width: 360px;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-
-.badge-pin {
-  background: #ff7d00;
-  color: #fff;
-  font-weight: 500;
-  font-size: 11px;
-}
-
-.badge-admin {
-  background: var(--primary-light);
-  color: var(--primary);
-  font-weight: 500;
-}
-
-.badge-banned {
-  background: #ffece8;
-  color: #f53f3f;
-  font-weight: 500;
-}
-
-.admin-empty {
-  text-align: center;
-  padding: 48px 20px;
-  color: #86909c;
-  font-size: 14px;
-}
-
-.admin-pagination {
-  display: flex;
-  justify-content: center;
-  align-items: center;
-  gap: 10px;
-  padding: 16px 20px;
-  border-top: 1px solid #f2f3f5;
-}
-
-.admin-pagination-info {
-  font-size: 13px;
-  color: #86909c;
-  padding: 0 8px;
-}
-
-.admin-body .btn-success {
-  background: var(--primary);
-  border-color: var(--primary);
-}
-
-.admin-body .btn-success:hover {
-  background: var(--primary-dark);
-  border-color: var(--primary-dark);
-}
-
-.admin-body .btn-outline-success {
-  color: var(--primary);
-  border-color: var(--primary);
-}
-
-.admin-body .btn-outline-success:hover {
-  background: var(--primary);
-  border-color: var(--primary);
-}
-
-.admin-body .form-control:focus {
-  border-color: var(--primary);
-  box-shadow: 0 0 0 3px rgba(26,127,75,.12);
-}
-
-.admin-body .form-label {
-  color: #4e5969;
-  margin-bottom: 4px;
-}
-
-.admin-login-page {
-  min-height: 100vh;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  background: linear-gradient(160deg, #f2f3f5 0%, #e8f5ee 60%, #d4edda 100%);
-  padding: 24px;
-}
-
-.admin-login-card {
-  width: 100%;
-  max-width: 400px;
-  background: #fff;
-  border: 1px solid #e5e6eb;
-  border-radius: 16px;
-  padding: 36px 32px;
-  box-shadow: 0 12px 40px rgba(0,0,0,.08);
-}
-
-.admin-login-mark {
-  width: 52px;
-  height: 52px;
-  border-radius: 14px;
-  background: var(--primary);
-  color: #fff;
-  font-size: 24px;
-  font-weight: 700;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  margin: 0 auto 18px;
-  box-shadow: 0 4px 12px rgba(26,127,75,.25);
-}
-
-.login-slogan {
-  color: #86909c;
-  font-size: 13px;
-}
-
-.info-row {
-  display: flex;
-  gap: 12px;
-  padding: 12px 0;
-  border-bottom: 1px solid #f2f3f5;
-  font-size: 13px;
-}
-
-.info-row:last-child { border-bottom: none; }
-.info-row .info-label { width: 100px; color: #86909c; flex-shrink: 0; }
-.info-row .info-value { flex: 1; word-break: break-all; color: #1d2129; }
-
-#adminToast.toast {
-  background: #1d2129;
-  color: #fff;
-  border: none;
-  border-radius: 10px;
-  box-shadow: 0 8px 24px rgba(0,0,0,.15);
-}
-
-@media (max-width: 1100px) {
-  .admin-stat-grid {
-    grid-template-columns: repeat(3, 1fr);
-  }
-}
-
-@media (max-width: 768px) {
-  .admin-shell { flex-direction: column; }
-  .admin-sidebar {
-    width: 100%;
-    border-right: none;
-    border-bottom: 1px solid #e5e6eb;
-    display: flex;
-    flex-wrap: wrap;
-    gap: 4px;
-    padding: 10px 12px;
-  }
-  .admin-sidebar-section { display: none; }
-  .admin-sidebar .nav-link {
-    padding: 7px 12px;
-    font-size: 13px;
-    border-left: none;
-  }
-  .admin-sidebar .nav-link.active {
-    border-left: none;
-  }
-  .admin-main { padding: 16px; max-width: none; }
-  .admin-stat-grid {
-    grid-template-columns: repeat(2, 1fr);
-    gap: 12px;
-  }
-  .admin-stat-card { padding: 14px 16px; }
-  .admin-stat-card .value { font-size: 22px; }
-  .admin-topbar-user { display: none; }
-  .admin-search-bar .form-control { width: 160px; }
-}
-
-@media (max-width: 480px) {
-  .admin-stat-grid {
-    grid-template-columns: 1fr;
-  }
-}
-
-/* ===== 旧版前台兼容 ===== */
-.navbar-brand { font-weight: 700; letter-spacing: 0.05em; }
-.post-content { line-height: 1.8; word-break: break-word; }
-.post-content img { max-width: 100%; height: auto; }
-.avatar-sm { width: 36px; height: 36px; object-fit: cover; border-radius: 50%; }
--- a/embed_static/static/legacy/js/app.js
+++ b/embed_static/static/legacy/js/app.js
@@ -1,79 +0,0 @@
-// 姜十三论坛 - 管理后台通用脚本
-
-async function adminFetch(url, opts) {
-  opts = opts || {};
-  var res = await fetch(url, Object.assign({ credentials: 'same-origin' }, opts));
-  var data;
-  try {
-    data = await res.json();
-  } catch (e) {
-    throw new Error('服务器响应异常，请重新登录后再试');
-  }
-  if (!res.ok) {
-    throw new Error(data.error || '请求失败');
-  }
-  return data;
-}
-
-function showToast(msg, type) {
-  var el = document.getElementById('adminToast');
-  if (!el) {
-    alert(msg);
-    return;
-  }
-  el.className = 'toast align-items-center text-bg-' + (type || 'success') + ' border-0 show';
-  el.querySelector('.toast-body').textContent = msg;
-  bootstrap.Toast.getOrCreateInstance(el, { delay: 2800 }).show();
-}
-
-function adminConfirm(msg, fn) {
-  if (confirm(msg)) fn();
-}
-
-function setBtnLoading(btn, loading) {
-  if (!btn) return;
-  btn.disabled = loading;
-  if (loading) {
-    btn.dataset.originalHtml = btn.innerHTML;
-    btn.innerHTML = '<span class="spinner-border spinner-border-sm"></span>';
-  } else if (btn.dataset.originalHtml) {
-    btn.innerHTML = btn.dataset.originalHtml;
-  }
-}
-
-function adminLogout() {
-  adminFetch('/admin/api/logout', { method: 'POST' })
-    .then(function () { location.href = '/admin/login'; })
-    .catch(function (e) { showToast(e.message, 'danger'); });
-}
-
-function postForm(url, method, fields) {
-  var fd = new FormData();
-  Object.keys(fields).forEach(function (k) { fd.append(k, fields[k]); });
-  return adminFetch(url, { method: method, body: fd });
-}
-
-function reloadSoon() {
-  setTimeout(function () { location.reload(); }, 600);
-}
-
-// 兼容旧模板
-function apiPost(url, data, isForm) {
-  var opts = { method: 'POST', credentials: 'same-origin' };
-  if (isForm) {
-    opts.body = new FormData(data instanceof HTMLFormElement ? data : undefined);
-    if (!(data instanceof HTMLFormElement)) {
-      var fd = new FormData();
-      for (var k in data) fd.append(k, data[k]);
-      opts.body = fd;
-    }
-  } else {
-    opts.headers = { 'Content-Type': 'application/json' };
-    opts.body = JSON.stringify(data);
-  }
-  return fetch(url, opts).then(function (r) { return r.json(); });
-}
-
-function confirmAction(msg, callback) {
-  adminConfirm(msg, callback);
-}
--- a/embed_static/static/spa/assets/BoardsManagePage-DC-_uHJb.js
+++ b/embed_static/static/spa/assets/BoardsManagePage-DC-_uHJb.js
--- a/embed_static/static/spa/assets/ComposePage-Dv2Wt-UO.js
+++ b/embed_static/static/spa/assets/ComposePage-Dv2Wt-UO.js
--- a/embed_static/static/spa/assets/FavoritesPage-Dvc9bR9_.js
+++ b/embed_static/static/spa/assets/FavoritesPage-Dvc9bR9_.js
@@ -1 +0,0 @@
-import{e as j,r as n,j as s}from"./react-vendor-CgzNJrV9.js";import{u as f,a as g,B as p}from"./index-474mTIgd.js";import{S as N}from"./spinner-DH1syOsQ.js";import{n as v}from"./notify-Zesh5czd.js";import{f as y}from"./content-CKr4Ur51.js";import{A as k}from"./ui-vendor-CdH1UOKW.js";function E(){const t=j(),{user:a,loading:r}=f(),[i,h]=n.useState([]),[u,x]=n.useState(!0);return n.useEffect(()=>{if(!r){if(!a){t("/login");return}g.favorites().then(e=>h(Array.isArray(e.favorites)?e.favorites:[])).catch(e=>v.error(e.message)).finally(()=>x(!1))}},[a,r,t]),r||u?s.jsx("div",{className:"flex justify-center py-16",children:s.jsx(N,{size:"lg"})}):a?s.jsx("div",{className:"page-wrap",children:s.jsxs("div",{className:"page-inner-wide",children:[s.jsxs(p,{variant:"ghost",className:"mb-3",onClick:()=>t("/"),children:[s.jsx(k,{}),"返回"]}),s.jsx("h1",{className:"page-title",children:"我的收藏"}),s.jsxs("p",{className:"page-desc",children:["共 ",i.length," 篇收藏帖子"]}),i.length===0?s.jsxs("div",{className:"empty-state",children:[s.jsx("p",{children:"还没有收藏任何帖子"}),s.jsx(p,{onClick:()=>t("/"),children:"去逛逛"})]}):s.jsx("div",{className:"content-surface",children:i.map(e=>{var o,l,c,d,m;return s.jsx("div",{className:"post-row",onClick:()=>t(`/post/${e.post_id}`),children:s.jsxs("div",{className:"post-body",children:[s.jsx("div",{className:"post-title",children:((o=e.post)==null?void 0:o.title)||"帖子已删除"}),s.jsxs("div",{className:"post-meta",children:[((c=(l=e.post)==null?void 0:l.board)==null?void 0:c.name)&&s.jsx("span",{children:e.post.board.name}),((m=(d=e.post)==null?void 0:d.user)==null?void 0:m.nickname)&&s.jsx("span",{children:e.post.user.nickname}),s.jsxs("span",{children:["收藏于 ",y(e.created_at)]})]})]})},e.id)})})]})}):null}export{E as default};
--- a/embed_static/static/spa/assets/HomePage-D-Yzai0_.js
+++ b/embed_static/static/spa/assets/HomePage-D-Yzai0_.js
--- a/embed_static/static/spa/assets/LoginPage-XRVgE8q8.js
+++ b/embed_static/static/spa/assets/LoginPage-XRVgE8q8.js
@@ -1 +0,0 @@
-import{e as f,r as g,j as s,L as b}from"./react-vendor-CgzNJrV9.js";import{u as w,a as F,F as y,b as t,c as n,d as l,e as c,I as i,f as m,o as N,s as d}from"./form-BzHbu9bJ.js";import{u as v,B as L,a as S}from"./index-474mTIgd.js";import{n as u}from"./notify-Zesh5czd.js";import"./ui-vendor-CdH1UOKW.js";const C=N({username:d().min(1,"请输入用户名"),password:d().min(1,"请输入密码")});function z(){const x=f(),{refresh:p}=v(),[h,a]=g.useState(!1),r=w({resolver:F(C),defaultValues:{username:"",password:""}}),j=async e=>{a(!0);try{await S.login(e.username,e.password),await p(),u.success("登录成功"),x("/",{replace:!0})}catch(o){u.error(o instanceof Error?o.message:"登录失败")}finally{a(!1)}};return s.jsx("div",{className:"auth-page",children:s.jsxs("div",{className:"auth-box",children:[s.jsx("div",{className:"logo-mark",children:"姜"}),s.jsx("h1",{children:"登录姜十三论坛"}),s.jsx("p",{className:"subtitle",children:"拾三一隅，自在交流"}),s.jsx(y,{...r,children:s.jsxs("form",{onSubmit:r.handleSubmit(j),className:"space-y-4",children:[s.jsx(t,{control:r.control,name:"username",render:({field:e})=>s.jsxs(n,{children:[s.jsx(l,{children:"用户名"}),s.jsx(c,{children:s.jsx(i,{placeholder:"用户名",autoComplete:"username",...e})}),s.jsx(m,{})]})}),s.jsx(t,{control:r.control,name:"password",render:({field:e})=>s.jsxs(n,{children:[s.jsx(l,{children:"密码"}),s.jsx(c,{children:s.jsx(i,{type:"password",placeholder:"密码",autoComplete:"current-password",...e})}),s.jsx(m,{})]})}),s.jsx(L,{type:"submit",className:"w-full",loading:h,children:"登录"})]})}),s.jsxs("p",{style:{textAlign:"center",marginTop:16,fontSize:13,color:"var(--color-text-3)"},children:["没有账号？",s.jsx(b,{to:"/register",children:"注册"})]})]})})}export{z as default};
--- a/embed_static/static/spa/assets/PostDetailPage-D4qGd4ZA.js
+++ b/embed_static/static/spa/assets/PostDetailPage-D4qGd4ZA.js
--- a/embed_static/static/spa/assets/ProfilePage-nO8fm023.js
+++ b/embed_static/static/spa/assets/ProfilePage-nO8fm023.js
--- a/embed_static/static/spa/assets/RegisterPage-C4KCPGxX.js
+++ b/embed_static/static/spa/assets/RegisterPage-C4KCPGxX.js
@@ -1 +0,0 @@
-import{e as f,r as g,j as s,L as w}from"./react-vendor-CgzNJrV9.js";import{u as b,a as F,F as y,b as a,c as n,d as o,e as t,I as c,f as l,o as k,s as i}from"./form-BzHbu9bJ.js";import{u as N,B as S,a as v}from"./index-474mTIgd.js";import{n as x}from"./notify-Zesh5czd.js";import"./ui-vendor-CdH1UOKW.js";const C=k({username:i().min(1,"请输入用户名"),nickname:i().optional(),password:i().min(6,"密码至少 6 位")});function R(){const u=f(),{refresh:j}=N(),[p,m]=g.useState(!1),r=b({resolver:F(C),defaultValues:{username:"",nickname:"",password:""}}),h=async e=>{m(!0);try{await v.register(e.username,e.password,e.nickname||e.username),await j(),x.success("注册成功"),u("/",{replace:!0})}catch(d){x.error(d instanceof Error?d.message:"注册失败")}finally{m(!1)}};return s.jsx("div",{className:"auth-page",children:s.jsxs("div",{className:"auth-box",children:[s.jsx("div",{className:"logo-mark",children:"姜"}),s.jsx("h1",{children:"注册账号"}),s.jsx("p",{className:"subtitle",children:"首个注册用户自动成为管理员"}),s.jsx(y,{...r,children:s.jsxs("form",{onSubmit:r.handleSubmit(h),className:"space-y-4",children:[s.jsx(a,{control:r.control,name:"username",render:({field:e})=>s.jsxs(n,{children:[s.jsx(o,{children:"用户名"}),s.jsx(t,{children:s.jsx(c,{placeholder:"3-32 位字母数字下划线",autoComplete:"username",...e})}),s.jsx(l,{})]})}),s.jsx(a,{control:r.control,name:"nickname",render:({field:e})=>s.jsxs(n,{children:[s.jsx(o,{children:"昵称"}),s.jsx(t,{children:s.jsx(c,{placeholder:"显示名称（可选）",autoComplete:"nickname",...e})}),s.jsx(l,{})]})}),s.jsx(a,{control:r.control,name:"password",render:({field:e})=>s.jsxs(n,{children:[s.jsx(o,{children:"密码"}),s.jsx(t,{children:s.jsx(c,{type:"password",placeholder:"至少 6 位",autoComplete:"new-password",...e})}),s.jsx(l,{})]})}),s.jsx(S,{type:"submit",className:"w-full",loading:p,children:"注册"})]})}),s.jsxs("p",{style:{textAlign:"center",marginTop:16,fontSize:13,color:"var(--color-text-3)"},children:["已有账号？",s.jsx(w,{to:"/login",children:"登录"})]})]})})}export{R as default};
--- a/embed_static/static/spa/assets/badge-CsEfIQQ2.js
+++ b/embed_static/static/spa/assets/badge-CsEfIQQ2.js
@@ -1 +0,0 @@
-import{j as n}from"./react-vendor-CgzNJrV9.js";import{c as a,d as o}from"./index-474mTIgd.js";const s=o("inline-flex items-center rounded-md border px-2 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2",{variants:{variant:{default:"border-transparent bg-primary text-primary-foreground shadow",secondary:"border-transparent bg-secondary text-secondary-foreground",destructive:"border-transparent bg-destructive text-destructive-foreground shadow",outline:"text-foreground",green:"border-transparent bg-[var(--j13-green-bg)] text-[var(--j13-green)]",orange:"border-transparent bg-orange-100 text-orange-700 dark:bg-orange-950 dark:text-orange-300"}},defaultVariants:{variant:"default"}});function g({className:r,variant:e,...t}){return n.jsx("div",{className:a(s({variant:e}),r),...t})}export{g as B};
--- a/embed_static/static/spa/assets/content-CKr4Ur51.js
+++ b/embed_static/static/spa/assets/content-CKr4Ur51.js
@@ -1 +0,0 @@
-function a(n,t){return n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/@([\w\u4e00-\u9fa5_-]+)/g,'<span class="mention">@$1</span>')}function o(n){const t=new Date(n),e=(new Date().getTime()-t.getTime())/1e3;return e<60?"刚刚":e<3600?`${Math.floor(e/60)}分钟前`:e<86400?`${Math.floor(e/3600)}小时前`:`${t.getMonth()+1}-${t.getDate()} ${String(t.getHours()).padStart(2,"0")}:${String(t.getMinutes()).padStart(2,"0")}`}export{o as f,a as h};
--- a/embed_static/static/spa/assets/form-BzHbu9bJ.js
+++ b/embed_static/static/spa/assets/form-BzHbu9bJ.js
--- a/embed_static/static/spa/assets/index-474mTIgd.js
+++ b/embed_static/static/spa/assets/index-474mTIgd.js
--- a/embed_static/static/spa/assets/index-JNN-o0YU.css
+++ b/embed_static/static/spa/assets/index-JNN-o0YU.css
--- a/embed_static/static/spa/assets/markdown-vendor-DxR1h-Bq.js
+++ b/embed_static/static/spa/assets/markdown-vendor-DxR1h-Bq.js
--- a/embed_static/static/spa/assets/notify-Zesh5czd.js
+++ b/embed_static/static/spa/assets/notify-Zesh5czd.js
@@ -1 +0,0 @@
-import{t as s}from"./index-474mTIgd.js";const n={success:r=>s.success(r),error:r=>s.error(r),warning:r=>s.warning(r)};export{n};
--- a/embed_static/static/spa/assets/postContent-CNPsgNvN.js
+++ b/embed_static/static/spa/assets/postContent-CNPsgNvN.js
@@ -1,23 +0,0 @@
-import{p as m}from"./markdown-vendor-DxR1h-Bq.js";const d={ADD_TAGS:["members-only"],ADD_ATTR:["data-locked","data-length"]},c=`
-<div class="post-members-only__badge">
-  <span class="post-members-only__badge-icon" aria-hidden="true">
-    <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><rect width="18" height="11" x="3" y="11" rx="2" ry="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/></svg>
-  </span>
-  <span>登录可见</span>
-</div>`,a='<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect width="18" height="11" x="3" y="11" rx="2" ry="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/></svg>';function p(s){const r=s>0?Math.min(6,Math.max(3,Math.ceil(s/42))):4,n=Array.from({length:r},(l,i)=>{const o=i%3;return`<div class="post-members-only__preview-line${o===1?" post-members-only__preview-line--medium":o===2?" post-members-only__preview-line--short":""}"></div>`}).join(""),e=s>0?`约 ${s} 字的`:"一段";return`
-<div class="post-members-only__locked-wrap">
-  <div class="post-members-only__badge post-members-only__badge--locked">
-    <span class="post-members-only__badge-icon" aria-hidden="true">${a}</span>
-    <span>登录可见</span>
-  </div>
-  <div class="post-members-only__preview" aria-hidden="true">
-    ${n}
-  </div>
-  <div class="post-members-only__gate">
-    <div class="post-members-only__gate-icon" aria-hidden="true">${a}</div>
-    <p class="post-members-only__gate-title">此处有${e}专属内容</p>
-    <p class="post-members-only__gate-desc">作者已将这部分内容设为仅登录用户可见，登录后即可阅读全文。</p>
-    <button type="button" class="post-members-only__gate-btn" data-members-login>登录查看</button>
-    <span class="post-members-only__gate-alt">还没有账号？<button type="button" class="post-members-only__gate-link" data-members-register>免费注册</button></span>
-  </div>
-</div>`}function b(s,r){if(!s.trim())return"";const n=new DOMParser().parseFromString(m.sanitize(s,d),"text/html");return n.querySelectorAll("members-only").forEach(e=>{var o;if(e.getAttribute("data-locked")==="true"||!r){const t=parseInt(e.getAttribute("data-length")||"0",10)||0;e.setAttribute("data-locked","true"),e.className="post-members-only post-members-only--locked",e.innerHTML=p(t);return}const i=((o=e.querySelector(".post-members-only__body"))==null?void 0:o.innerHTML)??Array.from(e.childNodes).filter(t=>!(t instanceof Element&&t.classList.contains("post-members-only__badge"))).map(t=>t instanceof Element?t.outerHTML:t.textContent??"").join("");e.className="post-members-only post-members-only--visible",e.innerHTML=`${c}<div class="post-members-only__body">${i}</div>`}),n.body.innerHTML}export{d as P,b as r};
--- a/embed_static/static/spa/assets/react-vendor-CgzNJrV9.js
+++ b/embed_static/static/spa/assets/react-vendor-CgzNJrV9.js
--- a/embed_static/static/spa/assets/spinner-DH1syOsQ.js
+++ b/embed_static/static/spa/assets/spinner-DH1syOsQ.js
@@ -1 +0,0 @@
-import{j as e}from"./react-vendor-CgzNJrV9.js";import{c as s}from"./index-474mTIgd.js";import{p as m}from"./ui-vendor-CdH1UOKW.js";const t={sm:"h-4 w-4",md:"h-5 w-5",lg:"h-8 w-8"};function p({className:r,size:a="md"}){return e.jsx(m,{className:s("animate-spin text-[var(--j13-green)]",t[a],r),"aria-label":"加载中"})}export{p as S};
--- a/embed_static/static/spa/assets/ui-vendor-CdH1UOKW.js
+++ b/embed_static/static/spa/assets/ui-vendor-CdH1UOKW.js
--- a/embed_static/static/spa/assets/virtual-vendor-05wd80F5.js
+++ b/embed_static/static/spa/assets/virtual-vendor-05wd80F5.js
--- a/embed_static/static/spa/index.html
+++ b/embed_static/static/spa/index.html
@@ -1,38 +0,0 @@
-<!DOCTYPE html>
-<html lang="zh-CN">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>姜十三论坛 Jiang13 Forum</title>
-    <style>
-      /* 关键布局样式：在 JS/CSS 包加载前即固定三栏结构，避免刷新时组件错位 */
-      html { scrollbar-gutter: stable; }
-      html, body, #root { height: 100%; margin: 0; }
-      body { overflow: hidden; font-size: 14px; line-height: 1.5; }
-      .app-shell { height: 100%; max-height: 100dvh; display: flex; flex-direction: column; overflow: hidden; }
-      .app-frame { flex: 1; min-height: 0; height: 100%; max-width: 1400px; width: 100%; margin: 0 auto; display: flex; flex-direction: column; overflow: hidden; }
-      .app-header { height: 56px; flex-shrink: 0; }
-      .app-body { flex: 1; display: flex; min-height: 0; width: 100%; overflow: hidden; }
-      .content-workspace { flex: 1; display: flex; min-width: 0; min-height: 0; overflow: hidden; }
-      .sidebar { width: 210px; flex-shrink: 0; }
-      .main-content { flex: 1; min-width: 0; min-height: 0; display: flex; flex-direction: column; overflow: hidden; }
-      .aside-panel { width: 280px; flex-shrink: 0; }
-      @media (max-width: 1100px) { .aside-panel { display: none; } }
-      @media (max-width: 768px) { .sidebar { display: none; } }
-    </style>
-    <script>
-      (function () {
-        var theme = localStorage.getItem('j13-theme') || 'light';
-        document.documentElement.classList.toggle('dark', theme === 'dark');
-        document.documentElement.style.colorScheme = theme;
-      })();
-    </script>
-    <script type="module" crossorigin src="/assets/index-474mTIgd.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/react-vendor-CgzNJrV9.js">
-    <link rel="modulepreload" crossorigin href="/assets/ui-vendor-CdH1UOKW.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-JNN-o0YU.css">
-  </head>
-  <body>
-    <div id="root"></div>
-  </body>
-</html>
--- a/embed_static/templates/admin/boards.html
+++ b/embed_static/templates/admin/boards.html
@@ -1,95 +0,0 @@
-{{define "admin/boards.html"}}{{template "admin/layout" .}}{{end}}
-{{define "admin_content_boards"}}
-<div class="admin-page-head">
-  <div>
-    <h1>板块管理</h1>
-    <p>创建和维护论坛板块，有帖子的板块无法删除</p>
-  </div>
-</div>
-
-<div class="admin-card">
-  <div class="admin-card-head">新建板块</div>
-  <div class="admin-card-body">
-    <form id="createBoardForm" class="row g-2 align-items-end">
-      <div class="col-md-3">
-        <label class="form-label small">板块名称</label>
-        <input name="name" class="form-control" placeholder="如：技术交流" required maxlength="64">
-      </div>
-      <div class="col-md-4">
-        <label class="form-label small">简介</label>
-        <input name="description" class="form-control" placeholder="板块说明（可选）" maxlength="500">
-      </div>
-      <div class="col-md-2">
-        <label class="form-label small">排序</label>
-        <input name="sort_order" type="number" class="form-control" value="0">
-      </div>
-      <div class="col-md-2">
-        <button type="submit" class="btn btn-success w-100" id="createBoardBtn">创建板块</button>
-      </div>
-    </form>
-  </div>
-</div>
-
-<div class="admin-card">
-  <div class="admin-card-head">板块列表 <span class="text-muted fw-normal">共 {{len .Boards}} 个</span></div>
-  <div class="table-responsive">
-    <table class="table admin-table mb-0">
-      <thead><tr><th>ID</th><th>名称</th><th>描述</th><th>排序</th><th>帖子数</th><th width="160">操作</th></tr></thead>
-      <tbody>
-      {{range .Boards}}
-      <tr>
-        <td>{{.ID}}</td>
-        <td><input class="form-control form-control-sm" id="name-{{.ID}}" value="{{.Name}}"></td>
-        <td><input class="form-control form-control-sm" id="desc-{{.ID}}" value="{{.Description}}"></td>
-        <td><input class="form-control form-control-sm" id="sort-{{.ID}}" type="number" value="{{.SortOrder}}" style="width:72px"></td>
-        <td><span class="badge bg-secondary">{{.PostCount}}</span></td>
-        <td>
-          <button class="btn btn-sm btn-primary" onclick="updateBoard({{.ID}}, this)">保存</button>
-          <button class="btn btn-sm btn-outline-danger" onclick="deleteBoard({{.ID}}, {{.PostCount}})">删除</button>
-        </td>
-      </tr>
-      {{else}}
-      <tr><td colspan="6" class="admin-empty">还没有板块，请先创建</td></tr>
-      {{end}}
-      </tbody>
-    </table>
-  </div>
-</div>
-{{end}}
-
-{{define "admin_scripts_boards"}}
-<script>
-document.getElementById('createBoardForm').addEventListener('submit', function(e) {
-  e.preventDefault();
-  var btn = document.getElementById('createBoardBtn');
-  setBtnLoading(btn, true);
-  adminFetch('/admin/api/boards', { method: 'POST', body: new FormData(this) })
-    .then(function(d) { showToast(d.message); reloadSoon(); })
-    .catch(function(e) { showToast(e.message, 'danger'); })
-    .finally(function() { setBtnLoading(btn, false); });
-});
-
-function updateBoard(id, btn) {
-  setBtnLoading(btn, true);
-  postForm('/admin/api/boards/' + id, 'PUT', {
-    name: document.getElementById('name-' + id).value,
-    description: document.getElementById('desc-' + id).value,
-    sort_order: document.getElementById('sort-' + id).value
-  }).then(function(d) { showToast(d.message); })
-    .catch(function(e) { showToast(e.message, 'danger'); })
-    .finally(function() { setBtnLoading(btn, false); });
-}
-
-function deleteBoard(id, postCount) {
-  if (postCount > 0) {
-    showToast('该板块下还有 ' + postCount + ' 篇帖子，无法删除', 'warning');
-    return;
-  }
-  adminConfirm('确定删除该板块？此操作不可恢复。', function() {
-    adminFetch('/admin/api/boards/' + id, { method: 'DELETE' })
-      .then(function(d) { showToast(d.message); reloadSoon(); })
-      .catch(function(e) { showToast(e.message, 'danger'); });
-  });
-}
-</script>
-{{end}}
--- a/embed_static/templates/admin/comments.html
+++ b/embed_static/templates/admin/comments.html
@@ -1,58 +0,0 @@
-{{define "admin/comments.html"}}{{template "admin/layout" .}}{{end}}
-{{define "admin_content_comments"}}
-<div class="admin-page-head">
-  <div>
-    <h1>评论管理</h1>
-    <p>查看和删除评论，共 {{.Total}} 条</p>
-  </div>
-</div>
-
-<div class="admin-card">
-  <div class="table-responsive">
-    <table class="table admin-table mb-0">
-      <thead>
-        <tr><th>ID</th><th>楼层</th><th>帖子</th><th>作者</th><th>回复</th><th>内容</th><th>时间</th><th width="100">操作</th></tr>
-      </thead>
-      <tbody>
-      {{range .Comments}}
-      <tr>
-        <td>{{.ID}}</td>
-        <td>#{{.Floor}}</td>
-        <td class="text-truncate-cell">
-          {{if .Post}}
-          <a href="/post/{{.PostID}}" target="_blank">{{.Post.Title}}</a>
-          {{else}}帖子 #{{.PostID}}{{end}}
-        </td>
-        <td>{{if .UserID}}{{if .User}}{{.User.Nickname}}{{else}}-{{end}}{{else}}{{.GuestNick}}{{end}}</td>
-        <td>
-          {{if .ReplyTarget}}
-          @{{if .ReplyTarget.UserID}}{{if .ReplyTarget.User}}{{.ReplyTarget.User.Nickname}}{{else}}-{{end}}{{else}}{{.ReplyTarget.GuestNick}}{{end}}
-          {{else}}-{{end}}
-        </td>
-        <td class="text-truncate-cell">{{.Content}}</td>
-        <td>{{.CreatedAt.Format "01-02 15:04"}}</td>
-        <td>
-          <button class="btn btn-sm btn-outline-danger" onclick="deleteComment({{.ID}})">删除</button>
-        </td>
-      </tr>
-      {{else}}
-      <tr><td colspan="8" class="admin-empty">暂无评论</td></tr>
-      {{end}}
-      </tbody>
-    </table>
-  </div>
-  {{template "admin_pagination" .}}
-</div>
-{{end}}
-
-{{define "admin_scripts_comments"}}
-<script>
-function deleteComment(id) {
-  adminConfirm('确定删除该评论？', function() {
-    adminFetch('/admin/api/comments/' + id, { method: 'DELETE' })
-      .then(function(d) { showToast(d.message); reloadSoon(); })
-      .catch(function(e) { showToast(e.message, 'danger'); });
-  });
-}
-</script>
-{{end}}
--- a/embed_static/templates/admin/dashboard.html
+++ b/embed_static/templates/admin/dashboard.html
@@ -1,76 +0,0 @@
-{{define "admin/dashboard.html"}}{{template "admin/layout" .}}{{end}}
-{{define "admin_content_dashboard"}}
-<div class="admin-page-head">
-  <div>
-    <h1>仪表盘</h1>
-    <p>欢迎回来{{if .CurrentUser}}，{{.CurrentUser.Nickname}}{{end}} · 论坛运行概况</p>
-  </div>
-</div>
-
-<div class="admin-stat-grid">
-  <div class="admin-stat-card admin-stat-users">
-    <div class="admin-stat-icon">用</div>
-    <div class="admin-stat-info">
-      <div class="value">{{.UserCount}}</div>
-      <div class="label">注册用户</div>
-    </div>
-  </div>
-  <div class="admin-stat-card admin-stat-posts">
-    <div class="admin-stat-icon">帖</div>
-    <div class="admin-stat-info">
-      <div class="value">{{.PostCount}}</div>
-      <div class="label">帖子总数</div>
-    </div>
-  </div>
-  <div class="admin-stat-card admin-stat-boards">
-    <div class="admin-stat-icon">板</div>
-    <div class="admin-stat-info">
-      <div class="value">{{.BoardCount}}</div>
-      <div class="label">板块数量</div>
-    </div>
-  </div>
-  <div class="admin-stat-card admin-stat-comments">
-    <div class="admin-stat-icon">评</div>
-    <div class="admin-stat-info">
-      <div class="value">{{.CommentCount}}</div>
-      <div class="label">评论总数</div>
-    </div>
-  </div>
-  <div class="admin-stat-card admin-stat-online">
-    <div class="admin-stat-icon">线</div>
-    <div class="admin-stat-info">
-      <div class="value">{{.OnlineCount}}</div>
-      <div class="label">当前浏览</div>
-    </div>
-  </div>
-</div>
-
-<div class="admin-card">
-  <div class="admin-card-head">
-    <span>最近帖子</span>
-    <a href="/admin/posts" class="admin-card-link">查看全部 →</a>
-  </div>
-  <div class="table-responsive">
-    <table class="table admin-table mb-0">
-      <thead><tr><th>标题</th><th>板块</th><th>作者</th><th>时间</th><th width="80"></th></tr></thead>
-      <tbody>
-      {{range .RecentPosts}}
-      <tr>
-        <td class="text-truncate-cell">
-          {{if .Pinned}}<span class="badge badge-pin me-1">置顶</span>{{end}}{{.Title}}
-        </td>
-        <td>{{if .Board}}{{.Board.Name}}{{else}}-{{end}}</td>
-        <td>{{if .User}}{{.User.Nickname}}{{else}}-{{end}}</td>
-        <td class="text-muted">{{.CreatedAt.Format "01-02 15:04"}}</td>
-        <td><a href="/post/{{.ID}}" target="_blank" class="btn btn-sm btn-link px-0">查看</a></td>
-      </tr>
-      {{else}}
-      <tr><td colspan="5" class="admin-empty">暂无帖子</td></tr>
-      {{end}}
-      </tbody>
-    </table>
-  </div>
-</div>
-{{end}}
-
-{{define "admin_scripts_dashboard"}}{{end}}
--- a/embed_static/templates/admin/layout.html
+++ b/embed_static/templates/admin/layout.html
@@ -1,88 +0,0 @@
-{{define "admin/layout"}}
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>{{.Title}} - 姜十三论坛管理后台</title>
-  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet">
-  <link href="/legacy/css/style.css" rel="stylesheet">
-</head>
-<body class="admin-body">
-<div class="toast-container position-fixed top-0 end-0 p-3" style="z-index:9999">
-  <div id="adminToast" class="toast" role="alert">
-    <div class="d-flex">
-      <div class="toast-body"></div>
-      <button type="button" class="btn-close btn-close-white me-2 m-auto" data-bs-dismiss="toast"></button>
-    </div>
-  </div>
-</div>
-
-<header class="admin-topbar">
-  <div class="admin-topbar-brand">
-    <div class="admin-topbar-mark">姜</div>
-    <div>
-      <span class="admin-topbar-title">姜十三论坛</span>
-      <span class="admin-topbar-sub">管理后台</span>
-    </div>
-  </div>
-  <div class="admin-topbar-actions">
-    {{if .CurrentUser}}
-    <span class="admin-topbar-user">{{.CurrentUser.Nickname}}</span>
-    {{end}}
-    <a href="/" class="btn btn-outline-light btn-sm">返回前台</a>
-    <button class="btn btn-light btn-sm" onclick="adminLogout()">退出</button>
-  </div>
-</header>
-
-<div class="admin-shell">
-  <aside class="admin-sidebar">
-    <div class="admin-sidebar-section">概览</div>
-    <a href="/admin/dashboard" class="nav-link {{if eq .ActiveNav "dashboard"}}active{{end}}">仪表盘</a>
-
-    <div class="admin-sidebar-section">内容</div>
-    <a href="/admin/boards" class="nav-link {{if eq .ActiveNav "boards"}}active{{end}}">板块管理</a>
-    <a href="/admin/posts" class="nav-link {{if eq .ActiveNav "posts"}}active{{end}}">帖子管理</a>
-    <a href="/admin/comments" class="nav-link {{if eq .ActiveNav "comments"}}active{{end}}">评论管理</a>
-
-    <div class="admin-sidebar-section">系统</div>
-    <a href="/admin/users" class="nav-link {{if eq .ActiveNav "users"}}active{{end}}">用户管理</a>
-    <a href="/admin/settings" class="nav-link {{if eq .ActiveNav "settings"}}active{{end}}">系统设置</a>
-  </aside>
-
-  <main class="admin-main">
-    {{if eq .ActiveNav "dashboard"}}{{template "admin_content_dashboard" .}}
-    {{else if eq .ActiveNav "boards"}}{{template "admin_content_boards" .}}
-    {{else if eq .ActiveNav "posts"}}{{template "admin_content_posts" .}}
-    {{else if eq .ActiveNav "comments"}}{{template "admin_content_comments" .}}
-    {{else if eq .ActiveNav "users"}}{{template "admin_content_users" .}}
-    {{else if eq .ActiveNav "settings"}}{{template "admin_content_settings" .}}
-    {{end}}
-  </main>
-</div>
-
-<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script>
-<script src="/legacy/js/app.js"></script>
-{{if eq .ActiveNav "boards"}}{{template "admin_scripts_boards" .}}
-{{else if eq .ActiveNav "posts"}}{{template "admin_scripts_posts" .}}
-{{else if eq .ActiveNav "comments"}}{{template "admin_scripts_comments" .}}
-{{else if eq .ActiveNav "users"}}{{template "admin_scripts_users" .}}
-{{else if eq .ActiveNav "settings"}}{{template "admin_scripts_settings" .}}
-{{end}}
-</body>
-</html>
-{{end}}
-
-{{define "admin_pagination"}}
-{{if gt .TotalPages 1}}
-<nav class="admin-pagination">
-  {{if gt .Page 1}}
-  <a class="btn btn-sm btn-outline-secondary" href="?page={{sub .Page 1}}{{if .Keyword}}&keyword={{.Keyword}}{{end}}">上一页</a>
-  {{end}}
-  <span class="admin-pagination-info">第 {{.Page}} / {{.TotalPages}} 页</span>
-  {{if lt .Page .TotalPages}}
-  <a class="btn btn-sm btn-outline-secondary" href="?page={{add .Page 1}}{{if .Keyword}}&keyword={{.Keyword}}{{end}}">下一页</a>
-  {{end}}
-</nav>
-{{end}}
-{{end}}
--- a/embed_static/templates/admin/login.html
+++ b/embed_static/templates/admin/login.html
@@ -1,49 +0,0 @@
-{{define "admin/login.html"}}
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>后台登录 - 姜十三论坛</title>
-  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet">
-  <link href="/legacy/css/style.css" rel="stylesheet">
-</head>
-<body class="admin-login-page">
-<div class="admin-login-card">
-  <div class="admin-login-mark">姜</div>
-  <h4 class="text-center mb-1">管理后台登录</h4>
-  <p class="login-slogan text-center mb-4">姜十三论坛 · 仅管理员可访问</p>
-  {{if eq .QueryBanned "1"}}
-  <div class="alert alert-warning small py-2">账号已被禁言，无法登录后台</div>
-  {{end}}
-  <form id="adminLoginForm">
-    <div class="mb-2">
-      <label class="form-label small">管理员账号</label>
-      <input type="text" name="username" class="form-control" placeholder="用户名" required autofocus>
-    </div>
-    <div class="mb-3">
-      <label class="form-label small">密码</label>
-      <input type="password" name="password" class="form-control" placeholder="密码" required>
-    </div>
-    <button type="submit" class="btn btn-success w-100" id="loginBtn">登录</button>
-  </form>
-  <p class="text-center mt-3 mb-0 small">
-    <a href="/" class="text-muted">← 返回论坛前台</a>
-  </p>
-</div>
-<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script>
-<script src="/legacy/js/app.js"></script>
-<script>
-document.getElementById('adminLoginForm').addEventListener('submit', function(e) {
-  e.preventDefault();
-  var btn = document.getElementById('loginBtn');
-  setBtnLoading(btn, true);
-  adminFetch('/admin/api/login', { method: 'POST', body: new FormData(this) })
-    .then(function() { location.href = '/admin/dashboard'; })
-    .catch(function(err) { alert(err.message); })
-    .finally(function() { setBtnLoading(btn, false); });
-});
-</script>
-</body>
-</html>
-{{end}}
--- a/embed_static/templates/admin/posts.html
+++ b/embed_static/templates/admin/posts.html
@@ -1,67 +0,0 @@
-{{define "admin/posts.html"}}{{template "admin/layout" .}}{{end}}
-{{define "admin_content_posts"}}
-<div class="admin-page-head">
-  <div>
-    <h1>帖子管理</h1>
-    <p>置顶、删除帖子，共 {{.Total}} 篇</p>
-  </div>
-  <form class="admin-search-bar" method="get">
-    <input name="keyword" class="form-control form-control-sm" placeholder="搜索标题/内容..." value="{{.Keyword}}">
-    <button class="btn btn-sm btn-success">搜索</button>
-    {{if .Keyword}}<a href="/admin/posts" class="btn btn-sm btn-outline-secondary">清除</a>{{end}}
-  </form>
-</div>
-
-<div class="admin-card">
-  <div class="table-responsive">
-    <table class="table admin-table mb-0">
-      <thead>
-        <tr>
-          <th>ID</th><th>标题</th><th>板块</th><th>作者</th>
-          <th>置顶</th><th>点赞</th><th>浏览</th><th>时间</th><th width="180">操作</th>
-        </tr>
-      </thead>
-      <tbody>
-      {{range .Posts}}
-      <tr id="post-row-{{.ID}}">
-        <td>{{.ID}}</td>
-        <td class="text-truncate-cell">{{.Title}}</td>
-        <td>{{if .Board}}{{.Board.Name}}{{else}}-{{end}}</td>
-        <td>{{if .User}}{{.User.Nickname}}{{else}}-{{end}}</td>
-        <td>{{if .Pinned}}<span class="badge badge-pin">是</span>{{else}}<span class="text-muted">否</span>{{end}}</td>
-        <td>{{.LikeCount}}</td>
-        <td>{{.ViewCount}}</td>
-        <td>{{.CreatedAt.Format "01-02 15:04"}}</td>
-        <td>
-          <a href="/post/{{.ID}}" target="_blank" class="btn btn-sm btn-link">查看</a>
-          <button class="btn btn-sm btn-outline-warning" onclick="togglePin({{.ID}}, {{.Pinned}})">{{if .Pinned}}取消置顶{{else}}置顶{{end}}</button>
-          <button class="btn btn-sm btn-outline-danger" onclick="deletePost({{.ID}})">删除</button>
-        </td>
-      </tr>
-      {{else}}
-      <tr><td colspan="9" class="admin-empty">没有找到帖子</td></tr>
-      {{end}}
-      </tbody>
-    </table>
-  </div>
-  {{template "admin_pagination" .}}
-</div>
-{{end}}
-
-{{define "admin_scripts_posts"}}
-<script>
-function togglePin(id, pinned) {
-  postForm('/admin/api/posts/' + id + '/pin', 'POST', { pinned: pinned ? 'false' : 'true' })
-    .then(function(d) { showToast(d.message); reloadSoon(); })
-    .catch(function(e) { showToast(e.message, 'danger'); });
-}
-
-function deletePost(id) {
-  adminConfirm('确定删除该帖子？相关评论也将一并删除。', function() {
-    adminFetch('/admin/api/posts/' + id, { method: 'DELETE' })
-      .then(function(d) { showToast(d.message); reloadSoon(); })
-      .catch(function(e) { showToast(e.message, 'danger'); });
-  });
-}
-</script>
-{{end}}
--- a/embed_static/templates/admin/settings.html
+++ b/embed_static/templates/admin/settings.html
@@ -1,56 +0,0 @@
-{{define "admin/settings.html"}}{{template "admin/layout" .}}{{end}}
-{{define "admin_content_settings"}}
-<div class="admin-page-head">
-  <div>
-    <h1>系统设置</h1>
-    <p>数据目录、敏感词配置与数据库备份</p>
-  </div>
-</div>
-
-<div class="row g-3">
-  <div class="col-lg-6">
-    <div class="admin-card">
-      <div class="admin-card-head">运行信息</div>
-      <div class="admin-card-body">
-        <div class="info-row"><div class="info-label">数据目录</div><div class="info-value"><code>{{.DataDir}}</code></div></div>
-        <div class="info-row"><div class="info-label">数据库文件</div><div class="info-value"><code>{{.DBPath}}</code></div></div>
-        <div class="info-row"><div class="info-label">监听端口</div><div class="info-value">{{.Port}}</div></div>
-        <div class="info-row"><div class="info-label">敏感词配置</div><div class="info-value"><code>{{.FilterPath}}</code></div></div>
-        <p class="text-muted small mt-3 mb-0">敏感词文件每行一个词，<code>#</code> 开头为注释，修改后需重启服务生效。</p>
-      </div>
-    </div>
-  </div>
-  <div class="col-lg-6">
-    <div class="admin-card">
-      <div class="admin-card-head">数据库备份</div>
-      <div class="admin-card-body">
-        <p class="text-muted small">将 SQLite 数据库复制到数据目录，生成带时间戳的备份文件。</p>
-        <button class="btn btn-success" id="backupBtn" onclick="doBackup()">一键导出备份</button>
-        <div id="backupResult" class="mt-3"></div>
-      </div>
-    </div>
-  </div>
-</div>
-{{end}}
-
-{{define "admin_scripts_settings"}}
-<script>
-function doBackup() {
-  var btn = document.getElementById('backupBtn');
-  setBtnLoading(btn, true);
-  adminFetch('/admin/api/backup', { method: 'POST' })
-    .then(function(d) {
-      showToast(d.message);
-      var html = '<div class="alert alert-success small mb-0">';
-      html += '<div>备份文件：<code>' + d.filename + '</code></div>';
-      if (d.download) {
-        html += '<a href="' + d.download + '" class="btn btn-sm btn-outline-success mt-2">下载备份文件</a>';
-      }
-      html += '<div class="text-muted mt-2">存储路径：' + d.path + '</div></div>';
-      document.getElementById('backupResult').innerHTML = html;
-    })
-    .catch(function(e) { showToast(e.message, 'danger'); })
-    .finally(function() { setBtnLoading(btn, false); });
-}
-</script>
-{{end}}
--- a/embed_static/templates/admin/users.html
+++ b/embed_static/templates/admin/users.html
@@ -1,62 +0,0 @@
-{{define "admin/users.html"}}{{template "admin/layout" .}}{{end}}
-{{define "admin_content_users"}}
-<div class="admin-page-head">
-  <div>
-    <h1>用户管理</h1>
-    <p>禁言违规用户，共 {{.Total}} 位注册用户</p>
-  </div>
-</div>
-
-<div class="admin-card">
-  <div class="table-responsive">
-    <table class="table admin-table mb-0">
-      <thead>
-        <tr><th>ID</th><th>用户名</th><th>昵称</th><th>角色</th><th>状态</th><th>注册时间</th><th width="120">操作</th></tr>
-      </thead>
-      <tbody>
-      {{range .Users}}
-      <tr>
-        <td>{{.ID}}</td>
-        <td>{{.Username}}</td>
-        <td>{{.Nickname}}</td>
-        <td>
-          {{if eq .Role "admin"}}
-          <span class="badge badge-admin">管理员</span>
-          {{else}}普通用户{{end}}
-        </td>
-        <td>
-          {{if .Banned}}<span class="badge badge-banned">已禁言</span>{{else}}<span class="text-success">正常</span>{{end}}
-        </td>
-        <td>{{.CreatedAt.Format "2006-01-02"}}</td>
-        <td>
-          {{if eq .Role "admin"}}
-          <span class="text-muted small">—</span>
-          {{else if .Banned}}
-          <button class="btn btn-sm btn-success" onclick="banUser({{.ID}}, false)">解除禁言</button>
-          {{else}}
-          <button class="btn btn-sm btn-outline-warning" onclick="banUser({{.ID}}, true)">禁言</button>
-          {{end}}
-        </td>
-      </tr>
-      {{else}}
-      <tr><td colspan="7" class="admin-empty">暂无用户</td></tr>
-      {{end}}
-      </tbody>
-    </table>
-  </div>
-  {{template "admin_pagination" .}}
-</div>
-{{end}}
-
-{{define "admin_scripts_users"}}
-<script>
-function banUser(id, banned) {
-  var msg = banned ? '确定禁言该用户？禁言后无法登录和发帖。' : '确定解除该用户的禁言？';
-  adminConfirm(msg, function() {
-    postForm('/admin/api/users/' + id + '/ban', 'POST', { banned: banned ? 'true' : 'false' })
-      .then(function(d) { showToast(d.message); reloadSoon(); })
-      .catch(function(e) { showToast(e.message, 'danger'); });
-  });
-}
-</script>
-{{end}}
--- a/embed_static/templates/board.html
+++ b/embed_static/templates/board.html
@@ -1,16 +0,0 @@
-{{define "board.html"}}{{template "layout" .}}{{end}}
-{{define "content"}}
-<nav aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="/">首页</a></li><li class="breadcrumb-item active">{{.Board.Name}}</li></ol></nav>
-<h3>{{.Board.Name}}</h3>
-<p class="text-muted">{{.Board.Description}}</p>
-{{if .CurrentUser}}<a href="/post/new?board={{.Board.ID}}" class="btn btn-success btn-sm mb-3">在此板块发帖</a>{{end}}
-{{range .Posts}}
-<div class="card mb-2">
-  <div class="card-body py-2">
-    {{if .Pinned}}<span class="badge badge-pin me-1">置顶</span>{{end}}
-    <a href="/post/{{.ID}}" class="text-decoration-none fw-semibold">{{.Title}}</a>
-    <div class="small text-muted mt-1">{{.User.Nickname}} · {{.CreatedAt.Format "2006-01-02 15:04"}} · 👍 {{.LikeCount}}</div>
-  </div>
-</div>
-{{else}}<p class="text-muted">该板块暂无帖子</p>{{end}}
-{{end}}
--- a/embed_static/templates/error.html
+++ b/embed_static/templates/error.html
@@ -1,7 +0,0 @@
-{{define "error.html"}}{{template "layout" .}}{{end}}
-{{define "content"}}
-<div class="text-center py-5">
-  <h3>{{.Message}}</h3>
-  <a href="/" class="btn btn-primary mt-3">返回首页</a>
-</div>
-{{end}}
--- a/embed_static/templates/favorites.html
+++ b/embed_static/templates/favorites.html
@@ -1,10 +0,0 @@
-{{define "favorites.html"}}{{template "layout" .}}{{end}}
-{{define "content"}}
-<h3>我的收藏</h3>
-{{range .Favorites}}
-<div class="card mb-2"><div class="card-body py-2">
-  <a href="/post/{{.Post.ID}}" class="fw-semibold text-decoration-none">{{.Post.Title}}</a>
-  <div class="small text-muted">{{.Post.Board.Name}} · 收藏于 {{.CreatedAt.Format "2006-01-02"}}</div>
-</div></div>
-{{else}}<p class="text-muted">暂无收藏</p>{{end}}
-{{end}}
--- a/embed_static/templates/index.html
+++ b/embed_static/templates/index.html
@@ -1,34 +0,0 @@
-{{define "index.html"}}{{template "layout" .}}{{end}}
-{{define "content"}}
-<div class="row">
-  <div class="col-lg-8">
-    <h4 class="mb-3">最新帖子</h4>
-    {{range .Posts}}
-    <div class="card mb-2">
-      <div class="card-body py-2">
-        {{if .Pinned}}<span class="badge badge-pin me-1">置顶</span>{{end}}
-        <a href="/post/{{.ID}}" class="text-decoration-none fw-semibold">{{.Title}}</a>
-        <div class="small text-muted mt-1">
-          {{.Board.Name}} · {{.User.Nickname}} · {{.CreatedAt.Format "2006-01-02 15:04"}} · 👍 {{.LikeCount}} · 👁 {{.ViewCount}}
-        </div>
-      </div>
-    </div>
-    {{else}}
-    <p class="text-muted">暂无帖子，快来发帖吧！</p>
-    {{end}}
-  </div>
-  <div class="col-lg-4">
-    <h5>板块列表</h5>
-    <div class="list-group">
-      {{range .Boards}}
-      <a href="/board/{{.ID}}" class="list-group-item list-group-item-action">
-        <strong>{{.Name}}</strong>
-        <small class="d-block text-muted">{{.Description}}</small>
-      </a>
-      {{else}}
-      <p class="text-muted small">管理员尚未创建板块</p>
-      {{end}}
-    </div>
-  </div>
-</div>
-{{end}}
--- a/embed_static/templates/layout.html
+++ b/embed_static/templates/layout.html
@@ -1,56 +0,0 @@
-{{define "layout"}}
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>{{.Title}} - 姜十三论坛</title>
-  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet">
-  <link href="/assets/css/style.css" rel="stylesheet">
-</head>
-<body>
-<nav class="navbar navbar-expand-lg navbar-dark" style="background:var(--primary)">
-  <div class="container">
-    <a class="navbar-brand" href="/">姜十三论坛 <span class="en fs-6 opacity-75">Jiang13 Forum</span></a>
-    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#nav">
-      <span class="navbar-toggler-icon"></span>
-    </button>
-    <div class="collapse navbar-collapse" id="nav">
-      <ul class="navbar-nav me-auto">
-        <li class="nav-item"><a class="nav-link" href="/">首页</a></li>
-        {{if .CurrentUser}}
-        <li class="nav-item"><a class="nav-link" href="/post/new">发帖</a></li>
-        <li class="nav-item"><a class="nav-link" href="/favorites">我的收藏</a></li>
-        {{end}}
-        {{if .IsAdmin}}<li class="nav-item"><a class="nav-link" href="/admin/dashboard">管理后台</a></li>{{end}}
-      </ul>
-      <ul class="navbar-nav">
-        {{if .CurrentUser}}
-        <li class="nav-item"><a class="nav-link" href="/profile">{{.CurrentUser.Nickname}}</a></li>
-        <li class="nav-item"><a class="nav-link" href="#" onclick="logout()">退出</a></li>
-        {{else}}
-        <li class="nav-item"><a class="nav-link" href="/login">登录</a></li>
-        <li class="nav-item"><a class="nav-link" href="/register">注册</a></li>
-        {{end}}
-      </ul>
-    </div>
-  </div>
-</nav>
-<main class="container py-4 flex-grow-1">
-  {{template "content" .}}
-</main>
-<footer class="site-footer text-center">
-  <div class="container">&copy; 2026 姜十三论坛 Jiang13 Forum · 拾三一隅，自在交流</div>
-</footer>
-<div class="toast-container position-fixed bottom-0 end-0 p-3">
-  <div id="toast" class="toast" role="alert"><div class="toast-body"></div></div>
-</div>
-<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script>
-<script src="/assets/js/app.js"></script>
-<script>
-function logout(){ fetch('/api/logout',{method:'POST',credentials:'same-origin'}).then(()=>location.href='/'); }
-</script>
-{{block "scripts" .}}{{end}}
-</body>
-</html>
-{{end}}
--- a/embed_static/templates/login.html
+++ b/embed_static/templates/login.html
@@ -1,36 +0,0 @@
-{{define "login.html"}}{{template "layout" .}}{{end}}
-{{define "content"}}
-<div class="row justify-content-center">
-  <div class="col-md-5">
-    <div class="card shadow-sm">
-      <div class="card-body p-4">
-        <h3 class="text-center mb-1">登录</h3>
-        <p class="text-center login-slogan mb-4">拾三一隅，自在交流</p>
-        <form id="loginForm">
-          <div class="mb-3">
-            <label class="form-label">用户名</label>
-            <input type="text" name="username" class="form-control" required>
-          </div>
-          <div class="mb-3">
-            <label class="form-label">密码</label>
-            <input type="password" name="password" class="form-control" required>
-          </div>
-          <button type="submit" class="btn btn-success w-100">登录</button>
-        </form>
-        <p class="text-center mt-3 mb-0">还没有账号？<a href="/register">立即注册</a></p>
-      </div>
-    </div>
-  </div>
-</div>
-{{end}}
-{{define "scripts"}}
-<script>
-document.getElementById('loginForm').addEventListener('submit', function(e){
-  e.preventDefault();
-  apiPost('/api/login', this, true).then(d=>{
-    if(d.error){ showToast(d.error,'danger'); return; }
-    location.href='/';
-  });
-});
-</script>
-{{end}}
--- a/embed_static/templates/post.html
+++ b/embed_static/templates/post.html
@@ -1,72 +0,0 @@
-{{define "post.html"}}{{template "layout" .}}{{end}}
-{{define "content"}}
-<nav aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="/">首页</a></li><li class="breadcrumb-item"><a href="/board/{{.Post.BoardID}}">{{.Post.Board.Name}}</a></li><li class="breadcrumb-item active">帖子</li></ol></nav>
-<div class="card mb-4">
-  <div class="card-body">
-    <h3>{{if .Post.Pinned}}<span class="badge badge-pin me-1">置顶</span>{{end}}{{.Post.Title}}</h3>
-    <div class="small text-muted mb-3">
-      <a href="/user/{{.Post.UserID}}">{{.Post.User.Nickname}}</a> · {{.Post.CreatedAt.Format "2006-01-02 15:04"}} · 👁 {{.Post.ViewCount}}
-      {{if .Post.Tags}}· 标签：{{.Post.Tags}}{{end}}
-    </div>
-    <div class="post-content">{{safeHTML .Post.Content}}</div>
-    <div class="mt-3 d-flex gap-2 flex-wrap">
-      {{if .CurrentUser}}
-      <button class="btn btn-outline-primary btn-sm" id="likeBtn" onclick="toggleLike()">{{if .Liked}}已点赞{{else}}点赞{{end}}</button>
-      <button class="btn btn-outline-warning btn-sm" id="favBtn" onclick="toggleFav()">{{if .Favorited}}已收藏{{else}}收藏{{end}}</button>
-      {{if or (eq .CurrentUserID .Post.UserID) .IsAdmin}}
-      <a href="/post/{{.Post.ID}}/edit" class="btn btn-outline-secondary btn-sm">编辑</a>
-      <button class="btn btn-outline-danger btn-sm" onclick="deletePost()">删除</button>
-      {{end}}
-      {{if .IsAdmin}}
-      <button class="btn btn-outline-dark btn-sm" onclick="pinPost()">{{if .Post.Pinned}}取消置顶{{else}}置顶{{end}}</button>
-      {{end}}
-      {{else}}<a href="/login" class="btn btn-outline-primary btn-sm">登录后互动</a>{{end}}
-    </div>
-  </div>
-</div>
-<h5>评论 ({{len .Comments}})</h5>
-{{range .Comments}}
-<div class="card mb-2 comment-floor">
-  <div class="card-body py-2">
-    <div class="d-flex justify-content-between">
-      <strong>#{{.Floor}} {{.User.Nickname}}</strong>
-      <small class="text-muted">{{.CreatedAt.Format "01-02 15:04"}}</small>
-    </div>
-    {{if .ReplyUser}}<div class="small text-muted">回复 #{{.ReplyUser.Floor}} {{.ReplyUser.User.Nickname}}</div>{{end}}
-    <div class="mt-1">{{.Content}}</div>
-    {{if $.CurrentUser}}
-    <button class="btn btn-link btn-sm p-0" onclick="replyTo({{.ID}},{{.Floor}},'{{.User.Nickname}}')">回复</button>
-    {{if or (eq $.CurrentUserID .UserID) $.IsAdmin}}
-    <button class="btn btn-link btn-sm p-0 text-danger" onclick="deleteComment({{.ID}})">删除</button>
-    {{end}}
-    {{end}}
-  </div>
-</div>
-{{end}}
-{{if .CurrentUser}}
-<div class="card mt-3">
-  <div class="card-body">
-    <form id="commentForm">
-      <div id="replyHint" class="small text-muted mb-2" style="display:none"></div>
-      <input type="hidden" name="reply_to" id="replyTo">
-      <textarea name="content" class="form-control mb-2" rows="3" placeholder="写下你的评论..." required></textarea>
-      <button type="submit" class="btn btn-success btn-sm">发表评论</button>
-      <button type="button" class="btn btn-secondary btn-sm" onclick="cancelReply()" id="cancelReplyBtn" style="display:none">取消回复</button>
-    </form>
-  </div>
-</div>
-{{end}}
-{{end}}
-{{define "scripts"}}
-<script>
-const postId={{.Post.ID}};
-function toggleLike(){ fetch('/api/posts/'+postId+'/like',{method:'POST',credentials:'same-origin'}).then(r=>r.json()).then(d=>{ if(d.error){showToast(d.error,'danger');return;} document.getElementById('likeBtn').textContent=d.liked?'已点赞':'点赞'; }); }
-function toggleFav(){ fetch('/api/posts/'+postId+'/favorite',{method:'POST',credentials:'same-origin'}).then(r=>r.json()).then(d=>{ if(d.error){showToast(d.error,'danger');return;} document.getElementById('favBtn').textContent=d.favorited?'已收藏':'收藏'; }); }
-function deletePost(){ confirmAction('确定删除此帖？',()=>{ fetch('/api/posts/'+postId,{method:'DELETE',credentials:'same-origin'}).then(r=>r.json()).then(d=>{ if(d.error){showToast(d.error,'danger');return;} location.href='/board/{{.Post.BoardID}}'; }); }); }
-function pinPost(){ fetch('/admin/api/posts/'+postId+'/pin',{method:'POST',credentials:'same-origin',headers:{'Content-Type':'application/x-www-form-urlencoded'},body:'pinned={{if .Post.Pinned}}false{{else}}true{{end}}'}).then(r=>r.json()).then(()=>location.reload()); }
-function replyTo(id,floor,name){ document.getElementById('replyTo').value=id; document.getElementById('replyHint').style.display='block'; document.getElementById('replyHint').textContent='回复 #'+floor+' '+name; document.getElementById('cancelReplyBtn').style.display='inline-block'; }
-function cancelReply(){ document.getElementById('replyTo').value=''; document.getElementById('replyHint').style.display='none'; document.getElementById('cancelReplyBtn').style.display='none'; }
-function deleteComment(id){ confirmAction('确定删除？',()=>{ fetch('/api/comments/'+id,{method:'DELETE',credentials:'same-origin'}).then(()=>location.reload()); }); }
-document.getElementById('commentForm')?.addEventListener('submit',function(e){ e.preventDefault(); apiPost('/api/posts/'+postId+'/comments',this,true).then(d=>{ if(d.error){showToast(d.error,'danger');return;} location.reload(); }); });
-</script>
-{{end}}
--- a/embed_static/templates/post_edit.html
+++ b/embed_static/templates/post_edit.html
@@ -1,31 +0,0 @@
-{{define "post_edit.html"}}{{template "layout" .}}{{end}}
-{{define "content"}}
-<h3>编辑帖子</h3>
-<form id="editForm">
-  <div class="mb-3">
-    <label class="form-label">标题</label>
-    <input type="text" name="title" class="form-control" value="{{.Post.Title}}" required>
-  </div>
-  <div class="mb-3">
-    <label class="form-label">标签</label>
-    <input type="text" name="tags" class="form-control" value="{{.Post.Tags}}">
-  </div>
-  <div class="mb-3">
-    <label class="form-label">内容</label>
-    <textarea name="content" class="form-control" rows="12" required>{{.Post.Content}}</textarea>
-  </div>
-  <button type="submit" class="btn btn-success">保存</button>
-  <a href="/post/{{.Post.ID}}" class="btn btn-secondary">取消</a>
-</form>
-{{end}}
-{{define "scripts"}}
-<script>
-document.getElementById('editForm').addEventListener('submit',function(e){
-  e.preventDefault();
-  fetch('/api/posts/{{.Post.ID}}',{method:'PUT',credentials:'same-origin',body:new FormData(this)}).then(r=>r.json()).then(d=>{
-    if(d.error){showToast(d.error,'danger');return;}
-    location.href='/post/{{.Post.ID}}';
-  });
-});
-</script>
-{{end}}
--- a/embed_static/templates/post_new.html
+++ b/embed_static/templates/post_new.html
@@ -1,37 +0,0 @@
-{{define "post_new.html"}}{{template "layout" .}}{{end}}
-{{define "content"}}
-<h3>发布新帖</h3>
-<form id="postForm">
-  <div class="mb-3">
-    <label class="form-label">选择板块</label>
-    <select name="board_id" class="form-select" required>
-      {{range .Boards}}<option value="{{.ID}}">{{.Name}}</option>{{end}}
-    </select>
-  </div>
-  <div class="mb-3">
-    <label class="form-label">标题</label>
-    <input type="text" name="title" class="form-control" required maxlength="256">
-  </div>
-  <div class="mb-3">
-    <label class="form-label">标签（逗号分隔）</label>
-    <input type="text" name="tags" class="form-control" placeholder="Go,技术,交流">
-  </div>
-  <div class="mb-3">
-    <label class="form-label">内容（支持 HTML 富文本）</label>
-    <textarea name="content" class="form-control" rows="12" required></textarea>
-    <div class="form-text">可使用 &lt;b&gt;、&lt;i&gt;、&lt;a&gt;、&lt;img&gt; 等 HTML 标签</div>
-  </div>
-  <button type="submit" class="btn btn-success">发布</button>
-</form>
-{{end}}
-{{define "scripts"}}
-<script>
-document.getElementById('postForm').addEventListener('submit',function(e){
-  e.preventDefault();
-  apiPost('/api/posts',this,true).then(d=>{
-    if(d.error){showToast(d.error,'danger');return;}
-    location.href='/post/'+d.post_id;
-  });
-});
-</script>
-{{end}}
--- a/embed_static/templates/profile.html
+++ b/embed_static/templates/profile.html
@@ -1,34 +0,0 @@
-{{define "profile.html"}}{{template "layout" .}}{{end}}
-{{define "content"}}
-<div class="row">
-  <div class="col-md-4 text-center mb-4">
-    <img src="{{if .ProfileUser.Avatar}}{{.ProfileUser.Avatar}}{{else}}https://via.placeholder.com/128{{end}}" class="avatar-md mb-2" alt="avatar">
-    <h4>{{.ProfileUser.Nickname}}</h4>
-    <p class="text-muted">@{{.ProfileUser.Username}}</p>
-    <form id="avatarForm" enctype="multipart/form-data">
-      <input type="file" name="avatar" accept="image/*" class="form-control form-control-sm mb-2">
-      <button type="submit" class="btn btn-outline-primary btn-sm">更换头像</button>
-    </form>
-  </div>
-  <div class="col-md-8">
-    <div class="card mb-3"><div class="card-header">修改昵称</div><div class="card-body">
-      <form id="nickForm"><input type="text" name="nickname" class="form-control mb-2" value="{{.ProfileUser.Nickname}}">
-      <button class="btn btn-success btn-sm">保存昵称</button></form>
-    </div></div>
-    <div class="card"><div class="card-header">修改密码</div><div class="card-body">
-      <form id="pwdForm">
-        <input type="password" name="old_password" class="form-control mb-2" placeholder="原密码" required>
-        <input type="password" name="new_password" class="form-control mb-2" placeholder="新密码（至少6位）" required>
-        <button class="btn btn-success btn-sm">修改密码</button>
-      </form>
-    </div></div>
-  </div>
-</div>
-{{end}}
-{{define "scripts"}}
-<script>
-document.getElementById('nickForm').addEventListener('submit',function(e){ e.preventDefault(); apiPost('/api/profile/nickname',this,true).then(d=>{ showToast(d.error||d.message,d.error?'danger':'success'); }); });
-document.getElementById('pwdForm').addEventListener('submit',function(e){ e.preventDefault(); apiPost('/api/profile/password',this,true).then(d=>{ showToast(d.error||d.message,d.error?'danger':'success'); }); });
-document.getElementById('avatarForm').addEventListener('submit',function(e){ e.preventDefault(); fetch('/api/profile/avatar',{method:'POST',credentials:'same-origin',body:new FormData(this)}).then(r=>r.json()).then(d=>{ if(d.error){showToast(d.error,'danger');return;} location.reload(); }); });
-</script>
-{{end}}
--- a/embed_static/templates/register.html
+++ b/embed_static/templates/register.html
@@ -1,40 +0,0 @@
-{{define "register.html"}}{{template "layout" .}}{{end}}
-{{define "content"}}
-<div class="row justify-content-center">
-  <div class="col-md-5">
-    <div class="card shadow-sm">
-      <div class="card-body p-4">
-        <h3 class="text-center mb-4">注册账号</h3>
-        <p class="text-center text-muted small mb-3">本站首个注册用户将自动成为管理员</p>
-        <form id="regForm">
-          <div class="mb-3">
-            <label class="form-label">用户名（3-32位字母数字下划线）</label>
-            <input type="text" name="username" class="form-control" required>
-          </div>
-          <div class="mb-3">
-            <label class="form-label">昵称</label>
-            <input type="text" name="nickname" class="form-control">
-          </div>
-          <div class="mb-3">
-            <label class="form-label">密码（至少6位）</label>
-            <input type="password" name="password" class="form-control" required>
-          </div>
-          <button type="submit" class="btn btn-success w-100">注册</button>
-        </form>
-        <p class="text-center mt-3 mb-0">已有账号？<a href="/login">去登录</a></p>
-      </div>
-    </div>
-  </div>
-</div>
-{{end}}
-{{define "scripts"}}
-<script>
-document.getElementById('regForm').addEventListener('submit', function(e){
-  e.preventDefault();
-  apiPost('/api/register', this, true).then(d=>{
-    if(d.error){ showToast(d.error,'danger'); return; }
-    showToast('注册成功'); location.href='/';
-  });
-});
-</script>
-{{end}}
--- a/embed_static/templates/user_profile.html
+++ b/embed_static/templates/user_profile.html
@@ -1,8 +0,0 @@
-{{define "user_profile.html"}}{{template "layout" .}}{{end}}
-{{define "content"}}
-<div class="text-center py-4">
-  <img src="{{if .ProfileUser.Avatar}}{{.ProfileUser.Avatar}}{{else}}https://via.placeholder.com/128{{end}}" class="avatar-md mb-2">
-  <h3>{{.ProfileUser.Nickname}}</h3>
-  <p class="text-muted">@{{.ProfileUser.Username}} · 注册于 {{.ProfileUser.CreatedAt.Format "2006-01-02"}}</p>
-</div>
-{{end}}
--- a/frontend/components.json
+++ b/frontend/components.json
@@ -1,20 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema.json",
-  "style": "default",
-  "rsc": false,
-  "tsx": true,
-  "tailwind": {
-    "config": "tailwind.config.ts",
-    "css": "src/styles/global.css",
-    "baseColor": "neutral",
-    "cssVariables": true,
-    "prefix": ""
-  },
-  "aliases": {
-    "components": "@/components",
-    "utils": "@/lib/utils",
-    "ui": "@/components/ui",
-    "lib": "@/lib",
-    "hooks": "@/hooks"
-  }
-}
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -1,35 +0,0 @@
-<!DOCTYPE html>
-<html lang="zh-CN">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>姜十三论坛 Jiang13 Forum</title>
-    <style>
-      /* 关键布局样式：在 JS/CSS 包加载前即固定三栏结构，避免刷新时组件错位 */
-      html { scrollbar-gutter: stable; }
-      html, body, #root { height: 100%; margin: 0; }
-      body { overflow: hidden; font-size: 14px; line-height: 1.5; }
-      .app-shell { height: 100%; max-height: 100dvh; display: flex; flex-direction: column; overflow: hidden; }
-      .app-frame { flex: 1; min-height: 0; height: 100%; max-width: 1400px; width: 100%; margin: 0 auto; display: flex; flex-direction: column; overflow: hidden; }
-      .app-header { height: 56px; flex-shrink: 0; }
-      .app-body { flex: 1; display: flex; min-height: 0; width: 100%; overflow: hidden; }
-      .content-workspace { flex: 1; display: flex; min-width: 0; min-height: 0; overflow: hidden; }
-      .sidebar { width: 210px; flex-shrink: 0; }
-      .main-content { flex: 1; min-width: 0; min-height: 0; display: flex; flex-direction: column; overflow: hidden; }
-      .aside-panel { width: 280px; flex-shrink: 0; }
-      @media (max-width: 1100px) { .aside-panel { display: none; } }
-      @media (max-width: 768px) { .sidebar { display: none; } }
-    </style>
-    <script>
-      (function () {
-        var theme = localStorage.getItem('j13-theme') || 'light';
-        document.documentElement.classList.toggle('dark', theme === 'dark');
-        document.documentElement.style.colorScheme = theme;
-      })();
-    </script>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>
--- a/frontend/package-lock.json
+++ b/frontend/package-lock.json
--- a/Show More
+++ b/Show More
				`@@ -1 +0,0 @@`
				import{e as j,r as n,j as s}from"./react-vendor-CgzNJrV9.js";import{u as f,a as g,B as p}from"./index-474mTIgd.js";import{S as N}from"./spinner-DH1syOsQ.js";import{n as v}from"./notify-Zesh5czd.js";import{f as y}from"./content-CKr4Ur51.js";import{A as k}from"./ui-vendor-CdH1UOKW.js";function E(){const t=j(),{user:a,loading:r}=f(),[i,h]=n.useState([]),[u,x]=n.useState(!0);return n.useEffect(()=>{if(!r){if(!a){t("/login");return}g.favorites().then(e=>h(Array.isArray(e.favorites)?e.favorites:[])).catch(e=>v.error(e.message)).finally(()=>x(!1))}},[a,r,t]),r\|\|u?s.jsx("div",{className:"flex justify-center py-16",children:s.jsx(N,{size:"lg"})}):a?s.jsx("div",{className:"page-wrap",children:s.jsxs("div",{className:"page-inner-wide",children:[s.jsxs(p,{variant:"ghost",className:"mb-3",onClick:()=>t("/"),children:[s.jsx(k,{}),"返回"]}),s.jsx("h1",{className:"page-title",children:"我的收藏"}),s.jsxs("p",{className:"page-desc",children:["共 ",i.length," 篇收藏帖子"]}),i.length===0?s.jsxs("div",{className:"empty-state",children:[s.jsx("p",{children:"还没有收藏任何帖子"}),s.jsx(p,{onClick:()=>t("/"),children:"去逛逛"})]}):s.jsx("div",{className:"content-surface",children:i.map(e=>{var o,l,c,d,m;return s.jsx("div",{className:"post-row",onClick:()=>t(`/post/${e.post_id}`),children:s.jsxs("div",{className:"post-body",children:[s.jsx("div",{className:"post-title",children:((o=e.post)==null?void 0:o.title)\|\|"帖子已删除"}),s.jsxs("div",{className:"post-meta",children:[((c=(l=e.post)==null?void 0:l.board)==null?void 0:c.name)&&s.jsx("span",{children:e.post.board.name}),((m=(d=e.post)==null?void 0:d.user)==null?void 0:m.nickname)&&s.jsx("span",{children:e.post.user.nickname}),s.jsxs("span",{children:["收藏于 ",y(e.created_at)]})]})]})},e.id)})})]})}):null}export{E as default};
				`@@ -1 +0,0 @@`
				import{e as f,r as g,j as s,L as b}from"./react-vendor-CgzNJrV9.js";import{u as w,a as F,F as y,b as t,c as n,d as l,e as c,I as i,f as m,o as N,s as d}from"./form-BzHbu9bJ.js";import{u as v,B as L,a as S}from"./index-474mTIgd.js";import{n as u}from"./notify-Zesh5czd.js";import"./ui-vendor-CdH1UOKW.js";const C=N({username:d().min(1,"请输入用户名"),password:d().min(1,"请输入密码")});function z(){const x=f(),{refresh:p}=v(),[h,a]=g.useState(!1),r=w({resolver:F(C),defaultValues:{username:"",password:""}}),j=async e=>{a(!0);try{await S.login(e.username,e.password),await p(),u.success("登录成功"),x("/",{replace:!0})}catch(o){u.error(o instanceof Error?o.message:"登录失败")}finally{a(!1)}};return s.jsx("div",{className:"auth-page",children:s.jsxs("div",{className:"auth-box",children:[s.jsx("div",{className:"logo-mark",children:"姜"}),s.jsx("h1",{children:"登录姜十三论坛"}),s.jsx("p",{className:"subtitle",children:"拾三一隅，自在交流"}),s.jsx(y,{...r,children:s.jsxs("form",{onSubmit:r.handleSubmit(j),className:"space-y-4",children:[s.jsx(t,{control:r.control,name:"username",render:({field:e})=>s.jsxs(n,{children:[s.jsx(l,{children:"用户名"}),s.jsx(c,{children:s.jsx(i,{placeholder:"用户名",autoComplete:"username",...e})}),s.jsx(m,{})]})}),s.jsx(t,{control:r.control,name:"password",render:({field:e})=>s.jsxs(n,{children:[s.jsx(l,{children:"密码"}),s.jsx(c,{children:s.jsx(i,{type:"password",placeholder:"密码",autoComplete:"current-password",...e})}),s.jsx(m,{})]})}),s.jsx(L,{type:"submit",className:"w-full",loading:h,children:"登录"})]})}),s.jsxs("p",{style:{textAlign:"center",marginTop:16,fontSize:13,color:"var(--color-text-3)"},children:["没有账号？",s.jsx(b,{to:"/register",children:"注册"})]})]})})}export{z as default};
				`@@ -1 +0,0 @@`
				import{e as f,r as g,j as s,L as w}from"./react-vendor-CgzNJrV9.js";import{u as b,a as F,F as y,b as a,c as n,d as o,e as t,I as c,f as l,o as k,s as i}from"./form-BzHbu9bJ.js";import{u as N,B as S,a as v}from"./index-474mTIgd.js";import{n as x}from"./notify-Zesh5czd.js";import"./ui-vendor-CdH1UOKW.js";const C=k({username:i().min(1,"请输入用户名"),nickname:i().optional(),password:i().min(6,"密码至少 6 位")});function R(){const u=f(),{refresh:j}=N(),[p,m]=g.useState(!1),r=b({resolver:F(C),defaultValues:{username:"",nickname:"",password:""}}),h=async e=>{m(!0);try{await v.register(e.username,e.password,e.nickname\|\|e.username),await j(),x.success("注册成功"),u("/",{replace:!0})}catch(d){x.error(d instanceof Error?d.message:"注册失败")}finally{m(!1)}};return s.jsx("div",{className:"auth-page",children:s.jsxs("div",{className:"auth-box",children:[s.jsx("div",{className:"logo-mark",children:"姜"}),s.jsx("h1",{children:"注册账号"}),s.jsx("p",{className:"subtitle",children:"首个注册用户自动成为管理员"}),s.jsx(y,{...r,children:s.jsxs("form",{onSubmit:r.handleSubmit(h),className:"space-y-4",children:[s.jsx(a,{control:r.control,name:"username",render:({field:e})=>s.jsxs(n,{children:[s.jsx(o,{children:"用户名"}),s.jsx(t,{children:s.jsx(c,{placeholder:"3-32 位字母数字下划线",autoComplete:"username",...e})}),s.jsx(l,{})]})}),s.jsx(a,{control:r.control,name:"nickname",render:({field:e})=>s.jsxs(n,{children:[s.jsx(o,{children:"昵称"}),s.jsx(t,{children:s.jsx(c,{placeholder:"显示名称（可选）",autoComplete:"nickname",...e})}),s.jsx(l,{})]})}),s.jsx(a,{control:r.control,name:"password",render:({field:e})=>s.jsxs(n,{children:[s.jsx(o,{children:"密码"}),s.jsx(t,{children:s.jsx(c,{type:"password",placeholder:"至少 6 位",autoComplete:"new-password",...e})}),s.jsx(l,{})]})}),s.jsx(S,{type:"submit",className:"w-full",loading:p,children:"注册"})]})}),s.jsxs("p",{style:{textAlign:"center",marginTop:16,fontSize:13,color:"var(--color-text-3)"},children:["已有账号？",s.jsx(w,{to:"/login",children:"登录"})]})]})})}export{R as default};
				`@@ -1 +0,0 @@`
				import{j as n}from"./react-vendor-CgzNJrV9.js";import{c as a,d as o}from"./index-474mTIgd.js";const s=o("inline-flex items-center rounded-md border px-2 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2",{variants:{variant:{default:"border-transparent bg-primary text-primary-foreground shadow",secondary:"border-transparent bg-secondary text-secondary-foreground",destructive:"border-transparent bg-destructive text-destructive-foreground shadow",outline:"text-foreground",green:"border-transparent bg-[var(--j13-green-bg)] text-[var(--j13-green)]",orange:"border-transparent bg-orange-100 text-orange-700 dark:bg-orange-950 dark:text-orange-300"}},defaultVariants:{variant:"default"}});function g({className:r,variant:e,...t}){return n.jsx("div",{className:a(s({variant:e}),r),...t})}export{g as B};
				`@@ -1 +0,0 @@`
				function a(n,t){return n.replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/@([\w\u4e00-\u9fa5_-]+)/g,'<span class="mention">@$1</span>')}function o(n){const t=new Date(n),e=(new Date().getTime()-t.getTime())/1e3;return e<60?"刚刚":e<3600?`${Math.floor(e/60)}分钟前`:e<86400?`${Math.floor(e/3600)}小时前`:`${t.getMonth()+1}-${t.getDate()} ${String(t.getHours()).padStart(2,"0")}:${String(t.getMinutes()).padStart(2,"0")}`}export{o as f,a as h};
				`@@ -1 +0,0 @@`
				`import{t as s}from"./index-474mTIgd.js";const n={success:r=>s.success(r),error:r=>s.error(r),warning:r=>s.warning(r)};export{n};`
				`@@ -1 +0,0 @@`
				`import{j as e}from"./react-vendor-CgzNJrV9.js";import{c as s}from"./index-474mTIgd.js";import{p as m}from"./ui-vendor-CdH1UOKW.js";const t={sm:"h-4 w-4",md:"h-5 w-5",lg:"h-8 w-8"};function p({className:r,size:a="md"}){return e.jsx(m,{className:s("animate-spin text-[var(--j13-green)]",t[a],r),"aria-label":"加载中"})}export{p as S};`