Files
opendance-windows/tasks/009-source-display.md
T
opendance 4913760a8b docs: 消除 Gitea 模棱两可 Unicode 告警(全角标点紧邻 ASCII 时改为半角)
依据 Gitea v1.27.3 modules/charset/escape_stream.go 的判定规则
(analyzeDetectResults:仅当左右相邻字符都不是非 ASCII 时才标记,
且 _common 表恒定生效),把说明文档中会被标记的全角标点
(,:;?!() 等)改为半角,并保证成对括号宽度一致。
中文语境中的全角标点(左右均为中文)保持原样,不动代码与契约语义。
2026-09-15 21:45:51 +08:00

1.1 KiB

T-WIN-009 来源信息展示

  • 状态: done
  • 依赖: T-WIN-008

目标

在客户端展示模型/动作的来源五元组(来源类型、名称、链接、许可、作者)。

load

DSH.md
contracts/data-models.md      # 锚点:1 来源五元组
src/ui/source_panel.gd
src/net/catalog_types.gd

交付物

src/ui/source_panel.gd(可复用组件)+ CatalogTypes.SourceInfo(含 type_label() 与 is_complete())。

展示规则

  • 标题 + 来源类型中文标签(原创 / 已获授权 / Creative Commons / 公共领域 / 用户上传 / 其他)
  • 资产名 | 来源名称
  • 作者
  • 许可 + 可点击外链跳转到 sourceUrl
  • 五元组不齐备时显式告警("⚠ 来源信息不完整,请联系管理员补全后再使用"),不静默展示

使用位置

  • 主菜单:选中动作时显示
  • 游戏页:当前跟练动作
  • 结算页:本轮动作

验收

tests/test_api_integration.gd 对真实服务端断言曲目与模型的来源五元组齐备 (song.source.is_complete()),保证展示组件拿到的数据完整。