docs(web): define structured outline layout
This commit is contained in:
@@ -233,6 +233,8 @@ bun scripts/cli.ts web-probe console-verify \
|
||||
- 全局概览使用 PostgreSQL 单次聚合 API;
|
||||
- 禁止前端逐组请求 timeline;
|
||||
- 详情页支持三级缩进和逐级折叠;
|
||||
- 大纲编号、层级控件和 Markdown 标题遵循
|
||||
`$unidesk-webdev` 的结构化树设计规则;
|
||||
- 左侧标题与右侧时间条的组内滚动同步;
|
||||
- 标题占满可用单行宽度后才使用省略号;
|
||||
- Markdown 链接渲染为链接;
|
||||
|
||||
@@ -32,6 +32,15 @@
|
||||
- 页面可见文案默认使用中文;协议字段、实体名、命令、路径、`runId`、`traceId`、`SHA256`、`HWPOD` 等机器或领域标识可保留原文,状态码旁应提供中文含义,禁止整块工作区只显示英文标题和状态。
|
||||
- 新建、配置、probe、reindex 等低频表单用对话框或抽屉承载;默认版面不要常驻新建框、配置表或调试面板。高频命令保留为稳定按钮或图标按钮,并配清晰状态。
|
||||
- 文档/任务类页面优先就地阅读和就地编辑:标题和正文双击或显式编辑态切换,不为常规查看单独铺满输入框;正文渲染态必须可见,不能只显示 taskRef、文件名或更新时间。
|
||||
- 树和大纲中的结构化编号、层级控件与标题内容必须职责分离:
|
||||
- `R1`、`R1.2` 等结构化编号使用独立稳定列,不嵌入 Markdown 标题流,
|
||||
不因编号长度或层级深度改变同级标题起点;
|
||||
- 展开按钮、树导线和缩进只表达层级,不重复推动编号列;
|
||||
- 状态点属于标题内容列,不能夹在展开控件与编号之间制造视觉噪声;
|
||||
- 导入标题已带旧结构编号时,只在展示层去重,禁止修改原始标题或破坏
|
||||
Markdown 链接;
|
||||
- 不使用逐行断开的硬分隔线模拟列边界,优先依靠稳定对齐、字重和留白表达
|
||||
信息层次。
|
||||
- 报告、Markdown、日志和 JSON 片段要用成熟 Markdown/代码块渲染,代码块采用浅色 Workbench 风格、可滚动且不撑破布局;不要把裸 JSON 或长日志直接挤爆页面。
|
||||
- 页面状态要可深链:重要 source/file/task/report/session 选择进入 RESTful URL,并能刷新后恢复;联动其他功能只通过公共 API、稳定 id 和 URL,不把两个功能互相嵌入成强依赖。
|
||||
- 设计验收必须用截图或 web-probe 样本检查真实版面:
|
||||
|
||||
Reference in New Issue
Block a user