文档截图
截图应证明真实的用户场景。不要使用随机测试数据或私人信息。
演示数据
使用稳定的演示数据集:角色明确的员工、不同状态的任务、没有真实客户的 CRM 实体、中性的文档名称,以及专门为场景创建的通知。
任务演示场景
任务区不需要一张通用截图,而需要一组演示场景。每个场景展示 LadVen OS 中的一个具体工作情境,并应在所有语言中保持一致。
| 场景 | 在 LadVen OS 中准备什么 | 文档展示什么 |
|---|---|---|
task-new | 带名称、描述、期限和负责人的新任务 | 正确提出结果 |
task-ready-to-work | 带参与者、项目、客户、文件和检查清单的任务 | 开始前的完整工作上下文 |
task-in-progress | 带活动计时器、评论和部分完成检查清单的任务 | 执行和当前控制 |
task-blocked | 评论中有阻塞因素并存在期限风险的任务 | 如何记录障碍 |
task-review | 带最终文件和验收请求的任务 | 向负责人交付结果 |
task-rework | 带具体评论退回修改的任务 | 正确反馈 |
task-overdue | 列表和卡片中的逾期任务 | 期限控制和管理风险 |
task-template | 带描述、角色和检查清单的模板 | 重复工作标准化 |
task-recurring | 带计划的定期任务 | 无需手动提醒的日程流程 |
task-automation | 带条件和动作的自动化规则 | LadVen OS 对流程事件的响应 |
演示任务名称应保持中性,不包含真实客户。可用示例:“准备客户启动报告”、“审批前检查合同”、“提交材料验收”、“每周检查逾期任务”。
任务截图第一批
第一批覆盖用户对任务周期的理解:创建、执行、控制、验收和标准化。
| Screenshot ID | 页面 | 拍摄内容 |
|---|---|---|
tasks.create-task.details-light-desktop | tasks/create-task.md | 创建表单打开详情:期限、优先级、估算、项目、客户 |
tasks.create-task.participants-light-desktop | tasks/create-task.md | 参与者区:提出人、负责人、协作者和观察者 |
tasks.drawer.progress-light-desktop | tasks/task-drawer.md | 执行中卡片:部分检查清单、活跃讨论、文件 |
tasks.drawer.review-light-desktop | tasks/task-drawer.md | 验收中卡片,带最终文件和检查请求 |
tasks.comments.blocker-light-desktop | tasks/comments.md | 带阻塞因素、提及参与者和预期动作的评论 |
tasks.list.saved-views-light-desktop | tasks/list-views.md | 负责人保存切片:逾期、验收、无负责人 |
tasks.list.people-schedule-light-desktop | tasks/list-views.md | 按人员日程,用于评估部门负载 |
tasks.close.rework-light-desktop | tasks/close-task.md | 带具体评论的退回修改 |
tasks.automation.template-light-desktop | tasks/templates-automation.md | 带角色、检查清单和完成标准的任务模板 |
tasks.automation.recurring-light-desktop | tasks/templates-automation.md | 带计划和完成期限的定期任务 |
tasks.automation.guard-light-desktop | tasks/templates-automation.md | 关闭或改状态前的保护性检查 |
每个 ID 应同时写入 screenshot-manifest.json 的所有语言。只有对应语言的界面已拍摄并检查后,才在该语言页面加入 PNG。
推荐的任务批量拍摄顺序
不要逐个 ID 零散拍摄,按共享演示数据分批拍摄。这样优先页面更快完成,相邻截图也不会出现同一任务的不同版本。
| Batch | 一起拍摄的 ID | 演示场景 | 优先收益页面 |
|---|---|---|---|
| 1. 任务基础周期 | 创建、文件、检查清单、详情、参与者、查看卡片、执行进度、评论、阻塞、计时器 | task-new, task-ready-to-work, task-in-progress, task-blocked | tasks/create-task.md, tasks/task-drawer.md, tasks/comments.md, tasks/checklist.md, tasks/files.md, tasks/participants.md, tasks/time.md |
| 2. 负责人控制和工作变更 | 筛选器、Kanban、日程、保存切片、按人员日程、批量部分结果、排序分组、验收和退回 | task-overdue, task-review, task-rework, task-in-progress | tasks/list-views.md, tasks/details-context.md, tasks/relations.md, tasks/edit-task.md, tasks/activity-history.md, tasks/close-task.md |
| 3. 标准化、自动化和移动端 | 自动化中心、规则、管理、模板、定期任务、保护性检查、移动查看和编辑 | task-template, task-recurring, task-automation, 移动版 task-ready-to-work | tasks/templates-automation.md, tasks/task-drawer.md, tasks/edit-task.md, 本地化任务页面 |
任务 P0 截图计划
表单创建之后,下一组 P0 截图应覆盖负责人最容易误解的高风险场景。
| ID | 应看到什么 | 为什么重要 |
|---|---|---|
tasks.kanban.light-desktop | 状态列、检查中 或 进行中 的积压、卡片上的负责人和期限 | 负责人看到流程瓶颈,而不只是任务列表 |
tasks.block.bulk-actions.partial-result | 修改了多少任务、哪些未应用、每行原因和下一步 | 批量动作必须检查结果,尤其涉及权限和保护性检查时 |
tasks.surface.automation.rules | 条件、动作、作用范围和后果 preview | 规则不能盲目启用,负责人要理解变更规模 |
tasks.automation.recurring-light-desktop | 计划、负责人、流程所有者、期限和重复策略 | 定期任务应是可管理流程,而不是日程噪音 |
tasks.automation.guard-light-desktop | 被限制的动作、未满足条件和清楚修正方式 | 保护性检查应告诉用户如何把任务带到正确状态 |
规则
- 截取真实 UI,而不是绘制的 mockup;
- 关键页面检查浅色和深色主题;
- 移动场景使用移动断点截图;
- 隐藏 token、私人 URL、真实姓名、电话、邮箱和商业数据;
- 将截图保存在与 UI 语言匹配的本地化文件夹中。
截图本地化
最终标准:每个已发布截图都必须覆盖门户支持的所有语言:ru、en、de、zh、es、fr、kk、ky。
截图可以逐步补齐,但语言覆盖必须被记录。如果某个场景已经至少在一种语言中截图,其余语言必须在 screenshot-manifest.json 中标记状态:
ready- 文件已存在并被使用;planned- 需要该截图,但尚未截取;blocked- 暂时无法截取,原因写在note中。
不要把俄语 UI 截图作为其他语言页面的最终版本。它们只能作为临时工作材料,不能发布在本地化文章中。
如果本地化 PNG 还没有拍摄,不要在翻译 Markdown 中插入其他语言的图片路径。保持该位置没有截图,使用本地化 SVG 流程图,或把场景加入截图拍摄计划。
文件名
static/img/zh/tasks/create-task/light-desktop.png
static/img/en/tasks/create-task/light-desktop.png
static/img/de/tasks/create-task/light-desktop.png
PR 中记录什么
记录文档页面、门户路由、UI 语言、主题、breakpoint、截图路径,以及 screenshot-manifest.json 中的状态。