feat(title): 标题自由位置拖拽后端支持——pos_x/pos_y 注入 \pos 定位 #1592

Merged

xiaoxia merged 1 commits from feat/title-drag-position into develop 2026-09-01 12:31:12 +08:00

Conversation 2 Commits 1 Files Changed -

xiaoxia commented 2026-09-01 01:26:02 +08:00

Owner

Copy Link

Copy Source

工单 #1405 方案 B：标题自由位置拖拽（后端）

前端支持用户在预览画面自由拖拽标题位置，后端烧录 ASS 时按坐标定位。只改 Title（标题），Subtitle（配音字幕）逻辑不动。

改动

packages/domain/ass_subtitle_builder.py：

• title_config 新增可选字段 pos_x、pos_y（PlayRes 坐标系像素整数，PlayResX/Y = video_width/video_height）
• 两字段同时存在、为 int（bool/float/字符串/None 拒绝）、且落在 [0, video_width]×[0, video_height] 闭区间内时：
  • TitleStyle Alignment 固定 5（\an5 中对齐，使 \pos 锚点为文本块中心）
  • Title Dialogue 文本前注入 {\pos(x,y)} override tag（如 {\pos(540,300)}标题文本）
• 字段缺失/非法/越界 → 一律回退现有 position → alignment 三档逻辑，top/center/bottom 输出一字节不变
• 未动：subtitle 段、position_to_ass_alignment、Style 行格式

测试

新增 9 个单测：

1. 合法坐标 → Dialogue 含 {\pos(x,y)} 且 TitleStyle Alignment=5
2. 边界值 (0, height)/(width, 0) 合法
3. 不传坐标 → 输出与现有断言完全一致（回归保护）
4. 越界坐标（负值/超宽高）→ 回退且输出逐字节一致
5. 非法类型（字符串/None/bool/float）→ 回退
6. 只传 pos_x 或 pos_y → 回退
7. 三档 top=8/center=5/bottom=2 对齐不变
8. 有 pos 时覆盖 position，Alignment 恒为 5
9. Subtitle 段不受 pos 影响

3140 相关测试全过。

## 工单 #1405 方案 B：标题自由位置拖拽（后端） 前端支持用户在预览画面自由拖拽标题位置，后端烧录 ASS 时按坐标定位。**只改 Title（标题），Subtitle（配音字幕）逻辑不动。** ## 改动 `packages/domain/ass_subtitle_builder.py`： - `title_config` 新增可选字段 `pos_x`、`pos_y`（PlayRes 坐标系像素整数，PlayResX/Y = video_width/video_height） - 两字段同时存在、为 int（bool/float/字符串/None 拒绝）、且落在 `[0, video_width]×[0, video_height]` 闭区间内时： - TitleStyle Alignment 固定 **5**（`\an5` 中对齐，使 `\pos` 锚点为文本块中心） - Title Dialogue 文本前注入 `{\pos(x,y)}` override tag（如 `{\pos(540,300)}标题文本`） - 字段缺失/非法/越界 → 一律回退现有 position → alignment 三档逻辑，top/center/bottom 输出**一字节不变** - 未动：subtitle 段、`position_to_ass_alignment`、Style 行格式 ## 测试 新增 9 个单测： 1. 合法坐标 → Dialogue 含 `{\pos(x,y)}` 且 TitleStyle Alignment=5 2. 边界值 (0, height)/(width, 0) 合法 3. 不传坐标 → 输出与现有断言完全一致（回归保护） 4. 越界坐标（负值/超宽高）→ 回退且输出逐字节一致 5. 非法类型（字符串/None/bool/float）→ 回退 6. 只传 pos_x 或 pos_y → 回退 7. 三档 top=8/center=5/bottom=2 对齐不变 8. 有 pos 时覆盖 position，Alignment 恒为 5 9. Subtitle 段不受 pos 影响 3140 相关测试全过。

xiaoxia added 1 commit 2026-09-01 01:26:03 +08:00

feat(title): 标题自由位置拖拽后端支持——pos_x/pos_y 注入 \\pos 定位 ... 34e8c56584

工单 #1405 方案 B：前端支持用户在预览画面自由拖拽标题位置，
后端烧录 ASS 时按坐标定位。只动 Title，Subtitle 逻辑不变。

- title_config 新增可选字段 pos_x、pos_y（PlayRes 像素整数，
  PlayResX/Y = video_width/video_height）
- 两字段同时存在、为 int（bool/float/字符串拒绝）、且落在
  [0,video_width]×[0,video_height] 闭区间内时：
  - TitleStyle Alignment 固定 5（\an5 中对齐，\pos 锚点为文本块中心）
  - Dialogue 文本前注入 {\pos(x,y)} override tag
- 字段缺失/非法/越界一律回退 position → alignment 三档逻辑，
  现有 top/center/bottom 输出一字节不变
- 新增 9 个单测：合法坐标注入、边界值、无坐标回归、越界回退、
  非法类型回退（含 bool/float/None/字符串）、单字段回退、
  三档对齐不变、pos 覆盖 position、subtitle 不受影响

gitea-actions bot commented 2026-09-01 01:32:15 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1592
预览链接	https://pr-1592.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1592 | | 预览链接 | [https://pr-1592.preview.xiaoxiajianji.com](https://pr-1592.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

xiaoxia referenced this issue from a commit 2026-09-01 01:52:55 +08:00

feat(title): 标题自由位置拖拽后端支持——pos_x/pos_y 注入 \pos 定位 (#1592)

xiaoxia added 1 commit 2026-09-01 12:31:01 +08:00

Merge branch 'develop' into feat/title-drag-position 32f1107595

xiaoxia merged commit 1a2c4b89be into develop 2026-09-01 12:31:12 +08:00

gitea-actions bot commented 2026-09-01 12:36:35 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1592 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1592 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

2 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1592