diff --git a/customization/README.md b/customization/README.md index d3082a4..346f9f0 100644 --- a/customization/README.md +++ b/customization/README.md @@ -68,6 +68,7 @@ Gitea 把模板 / 语言 / 静态资源都编进了二进制,但读取时走 `as | 首页指向 | `[server] LANDING_PAGE` | `GITEA__server__LANDING_PAGE` | | meta 作者/描述/关键词 | `[ui.meta] AUTHOR/DESCRIPTION/KEYWORDS` | `GITEA__ui_0X2E_meta__DESCRIPTION` 等 | | 页脚 Powered by / 版本号 | `[other] SHOW_FOOTER_POWERED_BY` / `SHOW_FOOTER_VERSION` | `GITEA__other__SHOW_FOOTER_POWERED_BY` | +| Issue 显示姓名而非学号 | `[ui] DEFAULT_SHOW_FULL_NAME` | `GITEA__ui__DEFAULT_SHOW_FULL_NAME` | | 自定义主题配色 | `[ui] THEMES` + `custom/public/assets/css/theme-*.css` | `GITEA__ui__THEMES` | | 关闭通行密钥(WebAuthn) | `[service] ENABLE_PASSKEY_AUTHENTICATION` | `GITEA__service__ENABLE_PASSKEY_AUTHENTICATION` | | 关闭用户名/密码表单 | `[service] ENABLE_PASSWORD_SIGNIN_FORM` | `GITEA__service__ENABLE_PASSWORD_SIGNIN_FORM` | @@ -260,6 +261,8 @@ GITEA_CUSTOM_DIR=../customization/custom GITEA__ui_0X2E_meta__KEYWORDS: 同济大学,高级语言程序设计,答疑,Issue GITEA__other__SHOW_FOOTER_POWERED_BY: "false" GITEA__other__SHOW_FOOTER_VERSION: "false" + # Issue 发布者/评论者显示姓名(导入时 full_name=姓名, login=学号) + GITEA__ui__DEFAULT_SHOW_FULL_NAME: "true" ``` 设计取舍: @@ -365,6 +368,8 @@ cd deploy && ./scripts/backup.sh --quiesce && docker compose pull gitea && docke - ✅ 关闭 `ENABLE_PASSKEY_AUTHENTICATION` 后,登录页不再出现空的通行密钥方框 - ✅ 首页(登录后)顶部出现学期答疑入口卡片: 只认 `tjhlp-<5 位数字>`、取最新学期、 无匹配则不显示(预览里用 3 个用户 × 4 个组织验证过) +- ✅ 打开 `[ui] DEFAULT_SHOW_FULL_NAME` 后, Issue 的「由 X 创建」与正文/评论作者 + 显示 `full_name`(姓名), 未填姓名的用户回退显示 login(学号)(预览实测) 尚未覆盖(需要时按同样套路加): diff --git a/customization/preview/compose.yaml b/customization/preview/compose.yaml index 1741fe8..ec155c7 100644 --- a/customization/preview/compose.yaml +++ b/customization/preview/compose.yaml @@ -84,6 +84,11 @@ services: GITEA__other__SHOW_FOOTER_POWERED_BY: "false" GITEA__other__SHOW_FOOTER_VERSION: "false" + # --- 显示名称: 与生产一致, Issue 显示姓名而不是学号 ---------------- + # 说明见 deploy/compose.yaml 同位置。这里给上才能让预览里验证 + # 「发布者/回答者显示姓名」的效果。 + GITEA__ui__DEFAULT_SHOW_FULL_NAME: "true" + GITEA__log__MODE: console GITEA__log__LEVEL: ${GITEA_LOG_LEVEL:-info} diff --git a/deploy/compose.yaml b/deploy/compose.yaml index c713f8d..0517a1e 100644 --- a/deploy/compose.yaml +++ b/deploy/compose.yaml @@ -92,6 +92,14 @@ services: GITEA__other__SHOW_FOOTER_POWERED_BY: "false" GITEA__other__SHOW_FOOTER_VERSION: "false" + # --- 显示名称: Issue 发布者/评论者显示姓名, 而不是学号 --------------- + # 导入用户时 full_name = 真实姓名、login = 学号(见 scripts/.../users.py); + # Gitea 默认只显示 login, 打开这个开关后 Issue 的「由 X 创建」、正文/评论作者 + # 以及其它用 GetDisplayName() 的地方都改为显示 full_name, 没填姓名的回退学号。 + # 证据: models/user/user.go 的 GetDisplayName(); templates/shared/user/authorlink.tmpl。 + # 这是站点级设置, 没有按用户的开关。改完需重建容器(up -d)才生效。 + GITEA__ui__DEFAULT_SHOW_FULL_NAME: "true" + # --- 数据库 --------------------------------------------------------- GITEA__database__DB_TYPE: postgres GITEA__database__HOST: db:5432 diff --git a/scripts/README.md b/scripts/README.md index 4fd34c0..a6acbd3 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -156,6 +156,20 @@ uv run tjhlp labels sync tjhlp-2025f/hw03 uv run tjhlp webhooks list tjhlp-2025f/general ``` +### 显示名维护(学号-姓名) + +Issue 页显示的是 `full_name`。OIDC 登录时会把 `full_name` 覆盖成认证源 +`FullNameClaimName` 对应的 claim(`display_name` = `学号-姓名`),因此**存量用户 +需要重新登录**才会刷新。若不想等用户重登,用 `tools/fix_full_name.py` 直接刷一遍: + +```bash +export TJHLP_GITEA_TOKEN= # 或建 scripts/.secrets.toml +uv run python tools/fix_full_name.py # dry-run,只打印 +uv run python tools/fix_full_name.py --apply # 实际写入 +``` + +脚本只改 `full_name`(成 `学号-姓名`),不动用户名/邮箱和团队归属;默认跳过 `admin`。 + ### 学期结束清理 ```bash diff --git a/scripts/settings.toml b/scripts/settings.toml index 91b2bef..39fbedc 100644 --- a/scripts/settings.toml +++ b/scripts/settings.toml @@ -1,5 +1,5 @@ [default.gitea] -url = "http://10.80.42.185:3000" +url = "http://127.0.0.1:2080" # 同学实际访问的平台地址(Apache 反代 /QA -> 127.0.0.1:2080)。 # 用于 Issue Template 等面向用户的链接; url 只用于 CLI 调 API。 public_url = "http://10.80.42.185/QA"