## 变更说明

<!-- 简述本次变更的目的和实现方式 -->

## 变更类型

- [ ] feat: 新功能
- [ ] fix: Bug 修复
- [ ] perf: 性能优化
- [ ] refactor: 重构
- [ ] test: 测试
- [ ] docs: 文档
- [ ] build/ci: 构建/CI
- [ ] chore: 杂项

## 影响范围

<!-- 列出受影响的服务/包 -->

- 服务：
- 包：
- 数据库迁移：是 / 否
- protobuf 契约变更：是 / 否（如变更是否向后兼容）
- Kafka topic 变更：是 / 否
- 架构文档变更：是 / 否

## 测试情况

- [ ] 单元测试通过
- [ ] 集成测试通过
- [ ] 本地手动测试通过
- [ ] 新增测试覆盖新功能

### 按语言的校验结果

- TS 服务：`pnpm run lint` + `pnpm run typecheck`（如缺失脚本请说明）
- Go 服务：`go vet ./...` + `go build ./...`
- Python 服务：`ruff check src/`

## 文档同步

- [ ] 已更新服务 README（如涉及服务结构变更）
- [ ] 已更新架构文档（如涉及架构变更）
- [ ] 已运行 `pnpm run arch:scan` 更新 arch.db（arch.db 不入库，但本地验证必须通过）
- [ ] 已更新 `docs/troubleshooting/known-issues.md`（如遇到新问题/经验）
- [ ] 已更新 `.github/CODEOWNERS`（如新增服务/包）

## Breaking Change

- [ ] 否
- [ ] 是（请在下方说明影响和迁移路径）

## 关联 Issue

Closes #
