Skip to content

Latest commit

 

History

History
375 lines (311 loc) · 18.8 KB

DESIGN.md

File metadata and controls

375 lines (311 loc) · 18.8 KB
name CCB
description 紧凑侧栏与内嵌工作区的本地 AI 配置管理界面
colors
dark-pro-accent dark-pro-accent-solid dark-pro-accent-bg dark-pro-bg-base dark-pro-bg-panel dark-pro-bg-elevated dark-pro-bg-hover dark-pro-border dark-pro-text-primary dark-pro-text-secondary dark-pro-green dark-pro-yellow dark-pro-red minimal-accent minimal-accent-solid minimal-accent-bg minimal-bg-base minimal-bg-panel minimal-bg-elevated minimal-bg-hover minimal-border minimal-text-primary minimal-text-secondary minimal-green minimal-yellow minimal-red terminal-accent terminal-accent-solid terminal-accent-bg terminal-bg-base terminal-bg-panel terminal-bg-elevated terminal-bg-hover terminal-border terminal-text-primary terminal-text-secondary terminal-green terminal-yellow terminal-red light-accent light-accent-solid light-accent-bg light-bg-base light-bg-panel light-bg-elevated light-bg-hover light-border light-text-primary light-text-secondary light-green light-yellow light-red text-on-accent
#82b3ff
#2f6db5
#253750
#131518
#1a1c20
#22252b
#2b3039
#363c45
#edf0f5
#a3adbb
#6bd4b1
#ebc483
#ffa29a
#c0b0f5
#7660b3
#302940
#111113
#19191c
#222226
#2c2c32
#37373e
#f0eff4
#aaa7b7
#6bd4b1
#ebc483
#ffa29a
#87d7a2
#37744c
#243c2d
#101512
#151c18
#1c2620
#243029
#384a3d
#e2f0e7
#a0b7a7
#88d9aa
#ebc483
#ffa29a
#245b98
#285e9d
#eaf1fb
#f7f8fa
#ffffff
#f5f6f8
#edf0f5
#dfe3eb
#263345
#606c80
#15795c
#8f5d13
#b13332
#ffffff
typography
body label headline title light-body light-label light-headline light-title terminal-body terminal-label terminal-headline terminal-title mono mono-minimal mono-terminal
fontFamily fontSize fontWeight
'Segoe UI Variable', 'Segoe UI', 'Microsoft YaHei UI', sans-serif
14px
400
fontFamily fontSize fontWeight
'Segoe UI Variable', 'Segoe UI', 'Microsoft YaHei UI', sans-serif
12px
450
fontFamily fontSize fontWeight lineHeight letterSpacing
'Segoe UI Variable', 'Segoe UI', 'Microsoft YaHei UI', sans-serif
22px
550
1.35
-0.025em
fontFamily fontSize fontWeight
'Segoe UI Variable', 'Segoe UI', 'Microsoft YaHei UI', sans-serif
15px
550
fontFamily fontSize fontWeight
'Segoe UI Variable', 'Segoe UI', 'Microsoft YaHei UI', sans-serif
14px
450
fontFamily fontSize fontWeight
'Segoe UI Variable', 'Segoe UI', 'Microsoft YaHei UI', sans-serif
12px
500
fontFamily fontSize fontWeight lineHeight letterSpacing
'Segoe UI Variable', 'Segoe UI', 'Microsoft YaHei UI', sans-serif
22px
600
1.35
-0.025em
fontFamily fontSize fontWeight
'Segoe UI Variable', 'Segoe UI', 'Microsoft YaHei UI', sans-serif
15px
600
fontFamily fontSize fontWeight
'JetBrains Mono', 'SF Mono', 'Cascadia Code', monospace
14px
400
fontFamily fontSize fontWeight
'JetBrains Mono', 'SF Mono', 'Cascadia Code', monospace
12px
450
fontFamily fontSize fontWeight lineHeight letterSpacing
'JetBrains Mono', 'SF Mono', 'Cascadia Code', monospace
22px
550
1.35
-0.025em
fontFamily fontSize fontWeight
'JetBrains Mono', 'SF Mono', 'Cascadia Code', monospace
15px
550
fontFamily fontSize
'SF Mono', 'Cascadia Code', 'Consolas', monospace
12px
fontFamily fontSize
'SF Mono', 'JetBrains Mono', monospace
12px
fontFamily fontSize
'JetBrains Mono', 'SF Mono', 'Cascadia Code', monospace
12px
rounded
dark-pro-sm dark-pro-md dark-pro-lg minimal-sm minimal-md minimal-lg terminal-sm terminal-md terminal-lg light-sm light-md light-lg
5px
7px
8px
7px
9px
9px
2px
2px
8px
6px
8px
8px
spacing
dark-pro-xs dark-pro-sm dark-pro-md dark-pro-lg dark-pro-xl minimal-xs minimal-sm minimal-md minimal-lg minimal-xl terminal-xs terminal-sm terminal-md terminal-lg terminal-xl light-xs light-sm light-md light-lg light-xl workspace-inset page-padding section-gap inspector-padding column-gap
2px
4px
8px
12px
16px
4px
6px
10px
14px
20px
2px
4px
6px
8px
12px
2px
4px
8px
12px
16px
8px
28px
24px
22px
32px
components
button-primary button-secondary button-text text-input navigation-selected tag-neutral resource-inspector resource-row-selected agent-selector
backgroundColor textColor typography rounded padding height
{colors.dark-pro-accent-solid}
{colors.text-on-accent}
{typography.body}
{rounded.dark-pro-sm}
0px 15px
34px
backgroundColor textColor typography rounded padding height
{colors.dark-pro-bg-panel}
{colors.dark-pro-text-primary}
{typography.body}
{rounded.dark-pro-sm}
0px 15px
34px
backgroundColor textColor typography rounded height
transparent
{colors.dark-pro-text-primary}
{typography.body}
{rounded.dark-pro-sm}
34px
backgroundColor textColor typography rounded height
{colors.dark-pro-bg-elevated}
{colors.dark-pro-text-primary}
{typography.body}
{rounded.dark-pro-sm}
34px
backgroundColor textColor typography rounded padding
{colors.dark-pro-accent-bg}
{colors.dark-pro-accent}
{typography.label}
{rounded.dark-pro-md}
4px 8px
backgroundColor textColor rounded
{colors.dark-pro-bg-elevated}
{colors.dark-pro-text-secondary}
{rounded.dark-pro-sm}
backgroundColor textColor rounded padding
{colors.dark-pro-bg-elevated}
{colors.dark-pro-text-primary}
{rounded.dark-pro-md}
{spacing.inspector-padding}
backgroundColor textColor typography padding
{colors.dark-pro-bg-elevated}
{colors.dark-pro-text-primary}
{typography.body}
22px 16px
backgroundColor textColor typography rounded height width
{colors.dark-pro-bg-elevated}
{colors.dark-pro-text-primary}
{typography.body}
{rounded.dark-pro-sm}
34px
190px

Design System: CCB

Overview

Creative North Star: "内嵌配置工作区"

CCB 用紧凑侧栏组织入口,把当前任务放在连续的主工作区内。中性色承担背景、容器、输入与分隔;强调色标记当前导航、焦点和主要动作。列表保持可扫描的名称、格式与状态,详情区承接路径和后续操作。

保留 CCB 名称、标识、中英双语和四个主题 ID。Dark Pro、Minimal、Terminal 为深色,Light 为浅色;默认使用 Dark Pro。前三者的色相与密度各有差异,Terminal 使用等宽 UI,其余使用系统无衬线字体。组件通过同一主题变量和 Ant Design token 配对,避免切换主题后出现不一致的背景、文字和控件。

Key Characteristics:

  • 紧凑侧栏与内嵌主工作区。
  • 柔和背景层次、可辨认的控件边界与明确焦点。
  • 通用资源入口与 Claude Code 专属入口分组。
  • 路径和代码使用等宽字体,数字使用等宽数字。

本规范从当前源码提取。运行时主题以 themes/index.ts 为准,布局与状态以 workspace.css、ModernLayout、资源页样式 和 main.tsx 为准。启动前的 globals.css 兜底值和旧 Tailwind 调色板不代表当前主题。文档结构遵循 DESIGN.md format。

Colors

四套主题都使用低饱和的中性背景,以及可区分的文字强调色和实心动作色。Frontmatter 的主题前缀分别为 dark-pro、minimal、terminal、light,后缀对应同名 CSS 变量;text-on-accent 为四主题共用值。

Primary

主题 ID 强调色特征 使用方式
ccb-dark-pro 柔和浅蓝与深蓝动作色 accent 用于链接、当前导航与焦点;accent-solid 用于主要按钮
ccb-minimal 柔和浅紫与灰紫动作色 延续相同角色,保持深灰工作区
ccb-terminal 柔和浅绿与深绿动作色 延续相同角色,配合等宽文字
ccb-light 深蓝文字与蓝色动作色 在浅色表面维持可辨认的操作层次

accent-bg 只承接选中状态的背景。主要按钮使用 text-on-accent;悬停背景采用源码中的 accent-solid 与 bg-panel 混色。

Secondary

green、yellow、red 对应成功、警告与错误,并传给 Ant Design 的语义 token。状态提示同时保留图标或文字,颜色本身不承担全部含义。

Neutral

  • bg-base 同时用于窗口基底与侧栏;bg-panel 用于主工作表面。
  • bg-elevated 与同主题的 bg-input 值相同,用于浮层、输入和资源详情区。
  • bg-hover 用于可交互行和导航的悬停;border 用于分隔与普通容器边界。
  • text-primary 用于主要内容;text-secondary 同时承担当前主题的辅助文字与占位文字。
  • 控件边框单独使用 border-control:深色由 text-secondary 与 bg-panel 按源码中的 60% 比例混合,浅色使用 82%。它比容器分隔线更明显。

The Theme Pairing Rule. 同一表面只使用当前主题前缀的颜色、圆角与密度;自定义 CSS 与 Ant Design 必须读取同一个主题。

Typography

Body Font: Segoe UI Variable,依次回退到 Segoe UI、Microsoft YaHei UI 和 sans-serif;Terminal 的 UI 使用 JetBrains Mono、SF Mono、Cascadia Code、monospace。

Label/Mono Font: Dark Pro 与 Light 的路径、代码使用 SF Mono、Cascadia Code、Consolas、monospace;Minimal 使用 SF Mono、JetBrains Mono、monospace;Terminal 与其 UI 字体一致。字体均按系统可用情况回退,不承诺已安装特定字体。

Hierarchy

  • Headline: 资源页标题(22px),紧凑行高(1.35)与轻微负字距;使用主题 heading 字重。
  • Title: 详情区标题(15px),使用主题 heading 字重。
  • Body: 普通界面(14px)。深色 body、label、heading 字重依次为 400、450、550;Light 为 450、500、600。Ant Design 按钮保留组件自身的普通字重。
  • Label: 导航文字与辅助尺寸(12px);资源字段标签沿用正文尺寸并使用主题 label 字重。路径与代码预览使用等宽字体(12px)。
  • Numbers: 页面、表格、统计、标签及终端日志使用 tabular-nums,减少数值变化造成的宽度跳动。

没有独立的大字号 Display 层级。标题平衡换行,说明文字使用自然换行;长名称与路径允许断行。

The UI and Code Rule. 普通界面使用当前主题的 UI 字体;路径、差异和代码使用该主题的等宽字体。Terminal 保持全等宽。

Layout

当前桌面壳采用侧栏与主内容区的横向布局。窗口外边距与两区间隔一致(8px);侧栏展开宽度(200px),收起宽度(56px)。主工作区有独立圆角并裁剪内部溢出,原生窗口标题栏保留。

内容区顶部工具栏保留唯一管理 Agent 选择器,选择器宽度(190px),工具栏最小高度(64px),水平内边距(24px)。主内容区滚动,默认内边距(28px);侧栏独立滚动。

侧栏中,配置管理、MCP、Skills、子 Agent 使用全局管理目标。Claude Code 分组保留项目、统计与托管模式;自动化规则、环境排查与应用设置归入“工具”。工具页按操作本身指定的目标运行,提示其作用范围,不把侧栏归类变更表述为新增多 Agent 能力。

资源工作区居中且限制最大宽度(1500px)。资源列表与详情区使用两列:列表吸收剩余宽度,详情区从 240px 到 310px,列间距(32px)。搜索框不超过 360px。行内按“名称与描述、格式、状态”排列,行内间距(24px),内边距(22px 16px)。

Density and responsive behavior

  • Frontmatter 的各主题 xs–xl 对应源码 space 变量,用于侧栏和既有组件。资源页的 22px、24px、28px、32px 为实际布局值,不把整页强制改成单一等差比例。
  • 宽度不超过 1100px 时,资源列表与详情区改为单列。
  • 不超过 1000px 时,工具栏水平内边距改为 16px,内容内边距改为 20px,工具栏作用域标签隐藏;资源页仍说明作用域。
  • 不超过 800px 时,资源页标题与动作上下排列,差异预览改为单列,行内间距减为 12px、内边距减为 18px 10px。
  • 既有 768px 侧栏规则继续存在;该规则本身不构成移动端支持或触屏验收结论。

Elevation & Depth

主工作区、侧栏与普通卡片保持平面结构,通过中性底色、输入背景和细分隔线建立层次。详情区使用输入背景,避免在每一行外再套卡片。选择器、Tooltip、Popover、Modal 与 Drawer 仍保留浮层语义。

Shadow Vocabulary

  • Select dropdown: 使用 globals.css 的实际投影(0 2px 8px rgba(0, 0, 0, 0.45))。
  • Input focus: 焦点边框外先留表面色间隔(1px),再显示淡强调色外环(4px 范围,强调色 24%)。键盘焦点另外保留可见轮廓(2px,外移 3px)。
  • 组件库按钮与浮层继续使用当前 Ant Design algorithm 的阴影;不要把未生效的旧阴影变量当成新增表面规则。

The Tonal Surface Rule. 主工作区、侧栏和普通卡片依靠背景层次与分隔线区分,浮层和焦点保留各自的深度提示。

Shapes

圆角使用当前主题的 sm、md、lg,具体值由 Frontmatter 给出。sm 用于按钮、输入与普通标签,md 用于导航、卡片和资源详情区,lg 用于主工作区。Terminal 的控件保持接近直角的轮廓;其主工作区仍有实际使用的外圆角。

容器与列表使用细边界(1px)。资源行保持平直,仅以底部分隔线组织连续列表。状态点保留圆形,不把普通按钮或输入改成胶囊。主要动作、普通动作与只读文字通过背景、边界和状态区分。

Components

Buttons

动作简短,复用 Ant Design 的 primary、default、text、danger 与 loading 状态。常规控件高度(34px),小号(28px);默认按钮水平内边距由已安装 Ant Design 计算为 15px。主要按钮使用实心强调色与 text-on-accent,普通按钮保持表面色,工具栏图标动作使用 text 按钮。

悬停、键盘焦点和不可操作状态都必须可辨认。保存时使用 loading,资源只读或写入进行中时按现有能力禁用动作。复制路径保留成功图标反馈;成功缩放反馈时长(0.22s),启用减少动态时缩短动画和过渡。

Chips

普通 Tag 使用 elevated 背景、辅助文字和细边框,表示作用域、格式与只读能力。成功、警告、错误标签继续走组件库的语义状态。标签用于说明当前事实,不能单凭着色表示资源已经运行成功。

Cards / Containers

既有卡片使用 panel 背景、md 圆角、细边框。资源详情区使用 elevated 背景与内边距(22px),显示名称、说明、位置、验证状态及查看、编辑、删除动作。普通详情区不添加悬停抬升。

Inputs / Fields

输入、Textarea 与 Select 使用 input 背景、sm 圆角和可辨认的控制边框。聚焦时切到 accent 边框并显示双环,光标使用 accent。占位文字保留完整不透明度并使用辅助文字颜色。错误和禁用状态继续使用 Ant Design 的语义状态;字段保留可关联的 label。

Navigation

第一组依次为配置、MCP、Skills、子 Agent;第二组标明 Claude Code,容纳其专属功能;设置入口单独保留。选中项使用 accent-bg 与 accent,悬停使用 hover 背景;按钮可接收键盘焦点。侧栏收起后保留图标入口。顶部管理对象选择器说明当前 Agent 与用户范围;导入流程中的来源选择器承担另一项明确任务。

Resource list and inspector

主列表使用连续的可选择行;名称和说明在左,格式与配置状态在右。选择一行后由旁侧详情区承接后续动作。页头保留创建与导入,搜索后展示数量,底部说明“已配置”与运行验证的区别。加载使用 Skeleton,空列表使用 Empty,读取失败显示错误与重试入口,只读能力同时显示标签并禁用写操作。

Editors, import preview and draft decisions

长内容在 Drawer 内编辑,宽度为 min(900px, 92vw),编辑区高度(55vh);只读查看复用相同结构。Claude 专属高级界面使用独立 Drawer,宽度为 min(1200px, 96vw)。

导入使用宽度(920px)的 Modal,按来源、预览、结果分步。预览显示目标路径、冲突、错误、警告和逐项处理选择,源码与目标内容在宽屏并排、窄屏上下排列。写入时保留进度并阻止关闭或重复写入,结果逐项显示。

脏草稿的确认 Modal 宽度(520px),提供保存后继续、放弃后继续、留在当前页。写入期间禁用决策动作;保存失败显示错误并保留草稿。遮罩点击不关闭编辑、导入或草稿决策。

.impeccable/design.json 保存九个自包含的 HTML/CSS 预览。默认展示 Dark Pro,优先继承应用的 CSS 变量,缺省值来自 Frontmatter。预览说明形状与状态,不替代 React、Ant Design 或实际业务行为。派生色带仅供查看,不是运行时 token。

Do's and Don'ts

Do:

  • Do 从当前主题读取配色、圆角和字体,并同步 Ant Design token。
  • Do 使用细边框区分输入区,保留键盘焦点、双环输入焦点和可见的复制结果。
  • Do 让名称可扫描、路径可复制,长路径和预览内容允许换行。
  • Do 在资源详情中明确只读能力和“已配置、尚未验证”的状态。
  • Do 让导入预览先展示目标、冲突、不可兼容字段和处理选择,再提供写入动作。
  • Do 尊重 prefers-reduced-motion,并保留保存、放弃、取消三种草稿决策。

Don't:

  • Don't 改名或替换四个既有主题 ID,也不要把 Minimal 设为浅色主题。
  • Don't 在通用资源页另设管理对象选择器;导入来源选择器只说明来源。
  • Don't 用“已配置”表示工具已经运行或通过验证。
  • Don't 用通用等宽字体覆盖非 Terminal 主题的普通界面文字。
  • Don't 把仅用于色带预览的派生颜色作为新增运行时主题 token。
  • Don't 在当前设计中加入逐字模糊动画、独立思考框或拖拽操作。