docs: 更新协议文档和设计文档
This commit is contained in:
@@ -139,7 +139,19 @@ tool 结果不再走 UI 编译链路:`TOOL_CALL_RESULT` 提供 `tool_call_args
|
||||
3. 执行 GoRouter 跳转(建议 `context.go(...)`)。
|
||||
- `path` 必须是已落地页面路由,且应是已实参化路径(如 `/todo/123`,而非 `/todo/:id`)。
|
||||
|
||||
### 7.3 约束建议
|
||||
### 7.3 路由表达粒度(Route-First 约束)
|
||||
|
||||
- 关键业务动作(创建、编辑、分享、处理邀请等)应优先设计为可深链页面路由,而不是仅存在于临时弹层。
|
||||
- 若 UI 采用 sheet 风格展示,也应由页面路由承载状态,再以页面内 surface 呈现 sheet 视觉。
|
||||
- `todo.edit` 必须落地为独立子页面(`/todo/{id}/edit`),不应通过详情页内弹窗承载编辑主流程。
|
||||
- 推荐后端优先使用以下 route_id 生成导航(示例):
|
||||
- `calendar.event_create` -> `/calendar/events/new`
|
||||
- `calendar.event_edit` -> `/calendar/events/{id}/edit`
|
||||
- `calendar.event_share` -> `/calendar/events/{id}/share`
|
||||
- `todo.create` -> `/todo/new`
|
||||
- `todo.edit` -> `/todo/{id}/edit`
|
||||
|
||||
### 7.4 约束建议
|
||||
|
||||
- 为了让前端只保留一种解析逻辑,推荐强约束:
|
||||
- `path` 只接受内部路由;
|
||||
|
||||
Reference in New Issue
Block a user