Carapace 用于构建或修改 OpenClaw 应用界面,核心是共享基础与框架中立的视觉原语。其思路是:把可跨消费者复用的视觉实现放入共享包,而把消费者特有的行为、数据、路由与布局组合保留在本地。
使用前应先阅读 tokens.md 再选择颜色、间距、字体、圆角和阴影,并根据当前框架阅读 consumer-adapters.md。处理外壳、面板、设置或运营界面时读 application-surfaces.md;设计或审计终端界面时读 terminal-ui.md;界面渲染在宿主框架内(如 MCP 应用)时读 embedded-surfaces.md。创建组件前先检查消费者已有的共享原语,界面意图用语义令牌,调色板原语仅用于有文档记录的例外情况。除非任务另有说明,不要改变应用行为、路由和信息架构。
接口规则要求:导入完整 CSS 契约或其聚焦的导出入口;在添加一次性视觉实现前先组合 components.css 中的共享类;优先使用本地共享原语而非原生控件。每个决策区域保留一个主操作,纯图标命令使用常见图标并提供无障碍名称。状态色用于状态、警告、成功、错误和信息含义。卡片、控件和重复的固定格式元素应保持尺寸稳定,避免嵌套装饰性卡片和把页面区块做成浮动卡片;表面、控件和内边距通过语义圆角令牌保持方正,圆形几何仅保留给头像、状态点等真正圆形的指示器。焦点、悬停、激活、禁用、加载和无效状态需保持一致,文本要在支持的视口尺寸内保持在容器中,运营类产品界面优先采用密集、易扫读的布局。共享应用结构但不强制 Web 与原生实现像素级一致。
归属原则:当接口与框架无关且对多个消费者有用时,把视觉实现移入本仓库;运行时行为和框架适配器保留在本地,直到至少两个消费者需要相同的接口与行为。验证方面,应使用现有测试和真实浏览器截图验证受影响的路线。资料未提供具体安装命令、收费与价格信息。