控制台使用指南

场景模板控制台指南接入文档独立页面上下文

适用任务

业务页面与使用指南共享产品导航；章节可独立打开、刷新和返回，阅读说明后回到原来的业务范围。

适合: 已有控制台需要可独立访问的使用、接入或排障章节时选用；章节名称、拆分粒度及业务返回路径由目标产品决定。局部内容切换仍可保留为 tab。
主要风险: 当前为私有候选；不新增真实采集、账号或安装服务。独立 URL 也可由路由参数实现；URL 机制按产品栈选择，示例不规定后端实现。

体验意图

未标注意图；可按模板正文判断是否适用。

单独使用这个子页面

属于用量与调用观测工作台。本页应用与审核 Prompt 只针对当前子项。

页面衔接

仅在本次采用范围与目标已有关系中使用以下规则。

总览 → 对象详情 → 记录探索 → 请求详情使用目标项目真实的对象与请求标识，保留适用的时间范围、筛选和返回位置。独立借用一个页面时只对接目标已有入口。
请求详情先给结论摘要，再给尝试链、用量费用和原始证据；路由诊断在该详情内解释历史尝试与候选证据，当前配置不能代替历史事实。
账号额度按各自 Provider 与窗口表达；调用费用、订阅额度及临时预算分别保持来源、时间和单位，不能互相推算。预算规划卡片可嵌入已有总览，不要求建立真实预算账本。

这个模板提供什么

复用方式: 按场景调整信息结构与交互；可直接采用默认设计，视觉风格按需另选。
结构与交互: 提供布局与组件说明。
视觉设计: 提供默认视觉参数，可按项目品牌或明确选择的风格调整。
应用后检查: 提供本场景的操作检查。

交互预览

1 个

示例适用范围

已有控制台需要可独立访问的使用、接入或排障章节时选用；章节名称、拆分粒度及业务返回路径由目标产品决定。局部内容切换仍可保留为 tab。

参照页面

agent-monitor · Monitor 项目适配记录
适配推导 · 公开展示材料 · 观察于日期未记录
同一外壳、独立章节、区域命名、查询与返回、旧链接兼容
项目源记录；公开可达性未核实，应用时以本模板完整定义为准。
项目本机及 MacStudio 的指南页面在 2026-10-20 验证。此来源链接指设计记录，不冒充在线网页；当前示例为独立提炼，用户尚未终审模板。

按模板应用无需访问来源网站；需要研究未覆盖组件时，可从这些入口继续查证。

应用前了解

会改变什么: 将选定指南章节接入产品导航，并实现独立访问、当前项和适用的返回上下文。
迁移确实存在的旧入口；指南范围外的 tabs 和页面保持其任务语义。
数据条件与适用限制: 目标有需要独立访问的指南内容、业务区域入口及适用的返回状态；具体内容由产品提供。

应用后的页面

主题

三个控制台场景共享的视觉默认与交互规则；视觉风格仅替换视觉部分，品牌与业务约束由项目保留。；可选：采用控制台基线并保留项目品牌、按项目明确的设计约束调整

布局 · 统一产品外壳

指南沿用业务区域的导航组件、页头位置和正文内距，清楚区分区域与当前页。章节作为独立可寻址页面，当前项在直接打开、刷新和历史返回时都正确。

布局 · 单章节阅读

一次展示当前章节的主要内容；标题、说明、相关步骤和可复制内容按任务排列。章节多时采用适合目标产品的导航，不把所有正文挤进一个长页。

组件 · 章节导航

具名链接使用独立 URL；上级区域名称取自目标产品。当前页可辨，键盘和窄屏入口可达；不把单个页面内的普通 tabs 一律转换成页面。

组件 · 回到业务

从业务页进入指南、跨章节再返回时保留适用的时间、筛选和页面位置。直接打开指南时提供明确默认业务入口；返回目标只能是应用内允许的路由。

组件 · 指南正文与复制

每章回答一个具体使用问题，命令与参数使用目标真实事实。复制控件提供成功或失败反馈；示例代码必须明确为演示，不能伪装可执行安装流程。

组件 · 已有链接迁移

若替换原有长页或锚点，旧链接应定位到对应章节并保留适用查询；新产品没有旧链接时无需新造兼容层。

项目覆盖

主题默认复用目标控制台，未指定主题时使用 console profile；可另选 Pulse 或其他视觉风格。章节、前缀和路由按产品事实确定，不硬编码 agent-monitor 的名称。

共同设计规则

默认视觉

中性色画布与表面，以轻边线区分层级，阴影用于浮层。主操作有清楚的视觉重点，状态色同时配文字；保留项目品牌色、键盘焦点和可读对比度。
文字按职责分层：页标题24px、区块标题16px、正文及控件14px、辅助信息12px、指标28px；数值等宽对齐。间距、控件和表格采用同一组 tokens；这些是默认值，不是所有网页的合格阈值。
同一项目各页共享字体、间距和控件外观。显式选择其他风格时只替换视觉表达，保持场景的信息优先级、交互和业务语义。

共同交互

页面先回答当前任务：总览给状态与归因，列表给结果，详情给对象结论。管理与采集说明按需展开，影响结论的缺失、过期和错误保持可见。
同一工作区跨页保留产品导航的结构、身份和当前位置；局部筛选属于页面内容区。窄屏沿用产品统一导航方式，列表图表使用可用宽度，表格局部滚动，主要动作仍可达。
常用筛选直接可见，其余放入具名高级筛选。已选条件可见、可单独清除；下钻和返回保留范围。昂贵统计沿项目既有策略按需加载。
表格优先展示对象、结果和可比较数值，长技术标识在详情中完整查看。详情先展示结果与时间摘要；请求诊断按摘要、尝试链、用量费用明细、原始证据递进，摘要可保留已有总耗时与总费用；关闭恢复查询和焦点。
金额保留币种与统计范围，未知、已知零和小额正值可辨。没有数据不生成虚假趋势；真实错误不能作为辅助说明隐藏。
加载时先呈现 URL 中的当前查询与已选条件，选项名称未就绪时保留条件身份；条件可清除、导航可用。已知结果明确所属范围，迟到响应不能覆盖新查询；空结果可清除条件，失败提供适用的恢复入口。按实际改动验证相关状态。

应用后检查

CG-01 每章可从导航和独立 URL 进入；刷新、前进与后退显示相同章节和正确当前项。
CG-02 业务页带条件进入指南，跨至少两个章节再返回，查询上下文保持；直接进入指南有明确默认返回。
CG-03 宽窄屏均能到达当前章和其他章节，正文与代码可读，复制结果与按钮反馈一致。
CG-04 仅对实际存在的旧路径或锚点验证迁移，章节映射和适用参数保持；不凭视觉风格扩张页面范围。

Prompt 模板

1 条

中文默认

## 执行方式

本 Prompt 依赖 skill web-ui-workflows（公开仓 https://github.com/lindong28/lindong-skills 的 web-ui-workflows/ 目录）。若尚未安装，先 git clone 该仓库到独立目录，取得完整 web-ui-workflows/；可放到 Claude Code 的 ~/.claude/skills/ 或 Codex 的 ~/.agents/skills/，已有同名目录不直接覆盖。无论是否已安装，本次会话都先读取该目录 SKILL.md 及下方指定工作流的正文，按其中的依赖说明准备工具并执行，不等待宿主重新发现 skill。下方占位符表示尚缺输入，先复用对话已有信息，只向用户询问仍影响任务的缺项；无需用户预先安装作者的配置。

## 任务

使用 `web-ui-workflows apply-ui-template`，按“控制台使用指南”模板优化目标 Web UI。

本次范围：只采用“用量与调用观测工作台”中的“控制台使用指南”子页面。读取 suite_context，共同规则仅在目标有对应关系时适用；不因此新增整套页面。

模板：console-guide
模板定义：https://prompts.aiplanet.live/api/webui/v3/templates/usage-observability-workspace/sections/console-guide.json
目标仓库：[填写仓库路径]
产品入口：[填写 URL]
应用范围：[页面或路由集合]
项目明确约束：[有则填写]

读取定义与关联示例，按 skill 的有效设计规则适配目标；来源和项目推导边界随定义保留，无需访问来源站。主题沿用目标控制台，可另选视觉风格。按产品内容确定章节、区域名称和返回状态；仅对已有旧入口进行兼容迁移。

完成适配与实现。从实际入口验证 acceptance 声明的路径、宽窄屏与本次涉及的状态，记录实际来源、有效设计、项目例外、读数和未核实部分；尚未取得的用户反馈保持未取得。

审核现有页面

只审核，不修改

## 执行方式

本 Prompt 依赖 skill web-ui-workflows（公开仓 https://github.com/lindong28/lindong-skills 的 web-ui-workflows/ 目录）。若尚未安装，先 git clone 该仓库到独立目录，取得完整 web-ui-workflows/；可放到 Claude Code 的 ~/.claude/skills/ 或 Codex 的 ~/.agents/skills/，已有同名目录不直接覆盖。无论是否已安装，本次会话都先读取该目录 SKILL.md 及下方指定工作流的正文，按其中的依赖说明准备工具并执行，不等待宿主重新发现 skill。下方占位符表示尚缺输入，先复用对话已有信息，只向用户询问仍影响任务的缺项；无需用户预先安装作者的配置。

## 任务

使用 `web-ui-workflows review-ui`，按“控制台使用指南”模板审核目标 Web UI。

本次范围：只采用“用量与调用观测工作台”中的“控制台使用指南”子页面。读取 suite_context，共同规则仅在目标有对应关系时适用；不因此新增整套页面。

模板：console-guide
模板定义：https://prompts.aiplanet.live/api/webui/v3/templates/usage-observability-workspace/sections/console-guide.json
目标仓库：[填写仓库路径]
产品入口：[填写 URL]
应用范围：[页面或路由集合]
项目明确约束：[有则填写]

读取定义与关联示例，按 skill 的有效设计规则适配目标；来源和项目推导边界随定义保留，无需访问来源站。主题沿用目标控制台，可另选视觉风格。按产品内容确定章节、区域名称和返回状态；仅对已有旧入口进行兼容迁移。

本次只审核，不修改。从实际入口验证 acceptance 声明的路径、宽窄屏与本次涉及的状态，记录实际来源、有效设计、项目例外、读数和未核实部分；尚未取得的用户反馈保持未取得。