Skip to content
Back to search

desktop-agent-ui

SkillWorks with Claude CodeGitHub

设计、实现与审查现代桌面 Agent/AI 应用的窗口外壳、会话状态流、输入框、工具执行反馈与工作区布局;沉淀深度桌面工程实践与避坑经验,重点处理阴影裁切、滚动性能、输入法守卫、多窗口状态与原生桌面语义。普通营销页、纯移动端与独立视频不走此入口;仅改动效时沿用项目动效方案。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ludi-herry--desktop-agent-ui/badge.svg)](/listings/ludi-herry--desktop-agent-ui)

HTML

<a href="/listings/ludi-herry--desktop-agent-ui"><img src="/api/listings/ludi-herry--desktop-agent-ui/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 121 lines
  1. ---
  2. name: desktop-agent-ui
  3. description: 设计、实现与审查现代桌面 Agent/AI 应用的窗口外壳、会话状态流、输入框、工具执行反馈与工作区布局;沉淀深度桌面工程实践与避坑经验,重点处理阴影裁切、滚动性能、输入法守卫、多窗口状态与原生桌面语义。普通营销页、纯移动端与独立视频不走此入口;仅改动效时沿用项目动效方案。
  4. ---
  5. # 桌面 Agent UI 设计与工程规范
  6. 把桌面应用的实际操作体验与 Agent 的自主可控性紧密结合。像 **Linear 官网或 Apple Notes 一样纯粹克制(简单目的、简单架构、简单设计、简单实现)**;每个决定必须同时提升 **UX(用户体验)、DX(开发者体验)与 AX(智能体体验)**。
  7. 本 Skill 汇总了现代桌面端生产级实践与深度工程架构,涵盖组件系统、状态流、交互物理学与踩坑防御规约。
  8. ## 按任务读取
  9. | 当前任务 | 必读参考 | 核心产出 |
  10. | --- | --- | --- |
  11. | 借鉴现代桌面体系、拆解组件与工作区 | [桌面参考实现手册导读](references/open-claude-manual.md) | 结构分层、组件状态机、Zero-JS 纯 CSS 滚动驱动动效与可迁移机制 |
  12. | 修桌面窗口、阴影裁切、滚动跳动、图标与焦点 | [桌面工程经验与防复发指南](references/desktop-pitfalls.md) | 根因排查、双层裁切分工、滚动槽位锁定与真实渲染验证 |
  13. | 设计 Agent 工作台、会话状态、工具调用与画布 | [Agent 交互与任务状态](references/agent-interaction.md) | 任务生命周期、RICH 委托控制权、三层披露与产物分层 |
  14. | 细化输入框、自适应高度、消息跟随、动效契约 | [组件实现与动效契约](references/components-motion.md) | 果冻增高与局部隐藏原生滚动条、CJK 输入法 500ms 守卫、分栏吸附闭环 |
  15. | 交付检查、阴影审计与真实环境验收 | [质量验收清单](references/acceptance.md) | 自动化阴影裁切审计(clip-audit)、窗口物理边界与最小交付记录 |
  16. | 溯源技术分类与规范背景 | [架构与参考索引](references/sources.md) | 知识点与工程背景对应表 |
  17. 建议按需读取对应参考文件,无需每次全量加载。例如处理裁切问题时,重点查阅 [桌面工程经验](references/desktop-pitfalls.md) 与 [验收清单](references/acceptance.md)。
  18. ## 设计系统与组件库决策流(Design System Decision Flow)
  19. > [!IMPORTANT]
  20. > **技术栈与设计系统完全中立**:本 Skill **没有预设、不设定、也不包含任何特定的组件库或设计系统代码模板**。它专注于桌面 Agent 交互物理学、状态机与避坑验收门禁。无论项目使用 `shadcn/ui`、`Ant Design`、`Radix UI`、`Tailwind CSS` 还是原生自绘,本规范均通用生效。
  21. 在开启涉及新界面开发或组件选型任务时,Agent 必须遵循以下决策树:
  22. ```mermaid
  23. flowchart TD
  24. A["开始:检测目标项目环境"] --> B{"项目是否已有明确的设计系统/组件库?"}
  25. B -- "已有 (如已装 shadcn / AntD / 自有 Tokens)" --> C["直接沿用项目现有系统<br>严禁引入第二套重复库<br>结合本 Skill 物理学推进工作"]
  26. B -- "无/新项目 (尚未确立设计系统)" --> D["Agent 主动询问用户偏好:<br>1. 是否已有指定组件库/设计系统偏好?<br>2. 是否希望采用 Claude 桌面设计系统风格?"]
  27. D -- "用户指定其他库 (如 shadcn 等)" --> E["按用户偏好配置对应库<br>遵循本 Skill 桌面规约推进"]
  28. D -- "用户确认想用 Claude 那套体系" --> F["指引前往上游获取:<br>在线手册: openclaudeui.com<br>代码仓库: github.com/Caho1/open-claude-ui<br>复用其 Design Tokens 与参考组件"]
  29. ```
  30. 1. **自动探测(Auto-Detection)**:先检查项目 `package.json`、样式表与组件目录,判断是否已存在既定设计系统;
  31. 2. **已有系统不折腾**:只要项目已具备成熟组件或设计令牌,直接继续推进,严禁为了“风格统一”强行重构;
  32. 3. **从零起步先询问**:未检测到设计系统时,不得擅自替用户做主引入庞大框架,向用户确认设计方向;
  33. 4. **按需向上游获取**:若确定需要复刻或借鉴 Claude 设计系统(Claude Design System),直接查阅上游 [Open Claude UI](https://github.com/Caho1/open-claude-ui) 及 [在线手册](https://openclaudeui.com/) 获取其 Design Tokens 与生产级参考实现。
  34. ## 推荐工作流
  35. 1. **审视基础与环境**:确认当前项目技术栈(Electron / Tauri / Web)、窗口框架(无边框透明 / 自绘标题栏)、用户实际操作任务以及本轮改动边界。
  36. 2. **确认交互形态**:区分是局部细节修复还是全局布局重构;若涉及新界面架构分歧,先输出可审阅的结构原型。
  37. 3. **匹配对应经验与规约**:对照避坑指南核验,确认是否命中阴影外扩超限、CJK 伴生输入冲突、滚动条跳动、多窗口状态冲突,以及排版视觉精致度门禁。
  38. 4. **最小可验证实现**:优先复用成熟组件库与系统原生交互语义,状态机与物理焦点先于修饰性动效。
  39. 5. **真实环境闭环验收**:桌面壳行为必须在实际桌面运行时(真窗、透明背景、真实滚轮与输入法)进行校验,执行 `clip-audit.js` 确保 `cut === 0`,并核验视觉与文案规范。
  40. ## 界面排版、文案与视觉精致度八大铁律(UI Refinement & Craftsmanship)
  41. 在实现、优化与 review 任何界面时,Agent 必须强制遵守以下 8 条视觉与交互精致度铁律:
  42. 1. **禁用中点分隔符**:严禁使用中点 “·” 作为文案或标签的分隔符。若界面中已存在,一律将其移除,改用布局留白、微弱色阶标签或极细分隔线。
  43. 2. **剔除冗余解释性描述**:严禁在卡片、模块与表单中滥用副标题、占位式 slogan 或说明书式辅助提示。冗余文案不仅会弄脏 UI 界面,还会浪费用户的宝贵注意力;依赖排版层级、间距与组件布局本身传递结构和意图(Let the layout do the explaining)。
  44. 3. **文案场景化审查(Tone & Concision)**:审查界面文案时,确保措辞与当前界面面向的目标人群高度契合。做到清晰好懂、容易理解,但不过于口语化或轻佻;文字长短严密匹配功能场景与控件尺寸,严禁冗长堆砌与随意生造新词。
  45. 4. **光学对齐与同心圆圆角(Concentric Border Radius)**:
  46. - 优化界面元素与排版的对齐效果,以视觉重心的“光学对齐”为准,而非单纯依靠几何边界机械居中;
  47. - 存在容器嵌套时,必须做同心圆圆角处理:内层圆角 $R_{inner} = \max(0, R_{outer} - padding)$,杜绝内外圆角不平行导致的生硬凹凸感。
  48. 5. **精细边框标准(0.5px Borders)**:凡需使用线条、容器描边或卡片边框时,统一使用极细的 **0.5px** 边框(在高分屏/Retina 屏下呈现精致轻盈的半像素 Hairline 质感),拒绝笨重粗边框。
  49. 6. **字号阶梯收敛(≤4 种,推荐 3 种)与 12px 最小门禁**:
  50. - 全页面出现的文字字号严禁超过 4 种,推荐严格控制在 3 种以内;
  51. - 界面上最小可用文字尺寸硬性规定为 **12px**,严禁使用小于 12px 的字体损害可读性;
  52. - 当需要表达更多信息层级时,优先通过**字重(font-weight 400/500/600)、字体灰阶/色彩对比(muted/subtle)以及间距设计(spacing)**来调整层次结构,而非随意增加新字号。
  53. 7. **决策负荷收敛与优先级秩序**:
  54. - 尽量减少页面中需要用户主动停下进行判断的交互阻断;必须由用户做决策时,将选项直接放置在用户原本就打算做选择的自然路径上;
  55. - 重新审视页面中包含的功能与元素,基于用户真实场景判断信息优先级,使用更有秩序、结构化的做法进行精简与组织。
  56. 8. **克制使用圆角与阴影,严禁左边缘彩条卡片**:
  57. - 尽量不要随意在页面中使用圆角和阴影;若功能场景确需使用,必须严格审定其数值(如仅窗口、浮层 Popover、按键赋予明确层级),避免无意义的装饰性堆砌;
  58. - **严禁使用“卡片左边缘带颜色的线条”(彩条卡片)**这一过时、碎片化且破坏整体现代感的装饰性反模式。
  59. 9. **等宽数字防抖、暗色字重补偿与防孤字成行**:
  60. - Agent 思考耗时(如 `Thinking: 00:03.4s`)、Token 速率、运行指标等动态变动数值,全量锁死 `tabular-nums`,消除数字跳动时的横向震颤;
  61. - 标题与关键卡片说明启用 `text-wrap: balance`,杜绝末尾单字孤单成行;
  62. - 进入暗色模式(Dark Mode)时,全站字重自动下调一档(500 调至 400,600 调至 500),以抵消视网膜光晕扩散带来的视觉发胖。
  63. 10. **出海多语言与 RTL 桌面端规约**:
  64. - 顶栏按钮与快捷操作胶囊严禁写死固定像素宽度(如 `w-20`),外文长词(短词膨胀定律)弹性自适应;超长词优先压为动词或通用图标;
  65. - 适配阿拉伯语 RTL 逻辑属性,但**终端代码块(Terminal / Code Snippets)、会话流进度条、指标数字与版本号必须强制保持 LTR(从左往右)**;
  66. - 泰语/越南语/阿语音标行高必须 $\ge 1.5$ 且杜绝滥用 `overflow: hidden` 削顶削底。
  67. 11. **去 AI 味四大纯粹性铁律(EP20 & Tw93 11 条)**:
  68. - **页面默认平 (Zero Shadow on Panels)**:常规卡片、工作区面板一律纯平,采用 0.5px 微边框切分,大阴影只留给离屏真实浮层(Popover/Modal/Dropdown/Drawer),杜绝浮躁的大阴影与外发光;
  69. - **全界面仅一个强调色**:除核心发送/提交主按钮外,其余次要操作、状态 Badge 与折叠图标一律收敛为暖中性灰,消灭五颜六色霓虹乱窜;
  70. - **大标题纯粹性与去 Eyebrow**:大标题内严禁挑选单字刻意着色或倾斜;坚决移除卡片正上方无意义的全大写悬顶小标签(eyebrow);
  71. - **数字全量带单位与格式**:金额、耗时与指标数字带千分位并紧随物理单位,严禁裸露无格式数字。
  72. 12. **去 AI Slop 五指令、按钮 6 态与 AX 防退化(EP21/22/24)**:
  73. - **Design Token、连续圆角与 4px 对称网格**:色彩与圆角统一由全局 CSS 变量管理(条件允许且性能无忧时采用连续圆角),参考业界成熟组件库构建语义 Do/Don't 范例;所有间距严格使用 4 的倍数,元素嵌套必要时四边内边距一致;
  74. - **按频次折叠 UX 文案**:保留核心标题与关键键值对,说明文字书面严谨、禁止营销或口语化;低频说明按需采用 `Tooltip`/`Alert` 折叠收纳,不常驻显示;
  75. - **按钮 6 种完整状态 (EP24)**:确保 Default / Hover / Active 下沉 / Disabled / **Loading(转圈+防重点击锁定)** / **Focus-visible(键盘 Tab 聚焦外框,严禁全局写 `outline: none`)** 全量到位;
  76. - **AI 协作防注意力稀释协议 (AX · EP21/22)**:外置 Token 契约并复用既定组件,单窗口修改超过 5 轮跑偏果断开新窗并只喂最小充分切片上下文。
  77. ## 核心设计与工程铁律
  78. - **动作与状态严格真实对应**:草稿、已提交、排队中、执行中、等待授权、已完成、失败、已终止必须以底层真实事件为准;严禁用动画延迟或前端计时器伪造执行进度。
  79. - **用户对 Agent 的完整控制权**:明确用户何时可以编辑草稿、补充上下文、中止任务以及安全重试;必须展示清晰的执行影响范围。
  80. - **捍卫桌面原生语义**:窗口控制区、系统快捷键、焦点捕获、文本选择、IME 组合输入与原生滚动各有归属;自绘界面必须完整保留原生交互契约。
  81. - **骨架屏双模与扫光真值(Skeleton Dual-Mode)**:全量采用 2.0s 105° 扫光带(RTL 255°),大卡片使用 `[data-motion="wave"]` 逐块 90ms 级联延迟,密集列表使用 `[data-motion="lockstep"]` 齐步微呼吸,配合 `data-hold` 延迟防闪烁,杜绝生硬水平色块。
  82. - **附件卡片原生视图过渡(View Transitions)**:输入框上下文附件增删重排全面拥抱 View Transitions API,实现零复杂 JS 的原生级物理平滑位移。
  83. - **成熟组件与架构优先**:复杂弹窗、伸缩分栏(Resizable)与拖拽交互坚决复用成熟库;明确区分系统原生滚动、组件库 ScrollArea 与自绘 thumb。
  84. - **内外分层的裁切规约**:圆角内容裁切放内层,投影与阴影放外层。涉及阴影或透明窗口时,执行 `scripts/clip-audit.js` 进行自动化测算,阴影外扩距离必须满足 `offset + blur + spread` 的物理余量要求。
  85. - **真实证据沉淀**:保留修改前报错现场、修改后运行证据与截图。
  86. ## 目录结构
  87. ```text
  88. desktop-agent-ui/
  89. ├── SKILL.md
  90. ├── README.md
  91. ├── LICENSE
  92. ├── references/
  93. │ ├── open-claude-manual.md # 桌面参考实现手册导读与深度工程机制
  94. │ ├── desktop-pitfalls.md # 桌面工程经验、高频返工与避坑指南
  95. │ ├── agent-interaction.md # Agent 交互、状态流与控制权体系
  96. │ ├── components-motion.md # 组件实现、动效契约与输入框配方
  97. │ ├── acceptance.md # 自动化裁切审计与全量验收清单
  98. │ └── sources.md # 架构分类与技术参考索引
  99. └── scripts/
  100. └── clip-audit.js # 阴影与祖先裁切自动化审计脚本
  101. ```
README.md · README · 123 lines
  1. # Desktop Agent UI
  2. > 现代桌面 Agent / AI 应用的设计规范、交互物理学与深度工程实践指南。
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  4. [![Skill: Agent UI](https://img.shields.io/badge/Skill-Desktop%20Agent%20UI-emerald.svg)](SKILL.md)
  5. ---
  6. ## 📖 项目简介
  7. **Desktop Agent UI** 是一套专为现代桌面 AI / Agent 应用打造的设计系统与工程避坑规范。
  8. 在桌面大屏、长文本会话流、异步工具调用与复杂多面板工作台的场景下,传统的 Web 聊天界面往往会遭遇严重的阴影裁切、滚动性能瓶颈、输入法误触与状态机死锁。本项目沉淀了业界经过大规模生产验证的深度交互物理学、CSS 规范标准与自动化验收工具,帮助开发者打造丝滑、可控且坚固的桌面级 Agent 用户体验。
  9. ---
  10. ## ⚡ 核心工程亮点
  11. 1. **Zero-JS 纯 CSS 滚动渐变遮罩(Scroll-Driven Animations)**:
  12. - Chromium 115+ 环境下利用 CSS Houdini `@property` 与 `animation-timeline: scroll()` 在合成器线程驱动;
  13. - 达成 **0.0% CPU 占用** 与 **0ms 主线程阻塞**,彻底消除长列表滚动卡顿。
  14. 2. **CJK 输入法 500ms 伴生 Enter 幽灵键精密守卫**:
  15. - 监听 `compositionend` 时间戳,精准拦截中文拼音选词确认瞬间伴生的冒充 Enter;
  16. - 拦截后立即复位时间戳,保证正常连续击键畅通无阻,杜绝消息误发。
  17. 3. **分栏拖拽(18%/82% 折叠吸附)与 Escape 取消状态机闭环**:
  18. - 双栏工作台边缘自适应吸附折叠;
  19. - 捕获拖拽中途的 `Escape` 键,执行安全的三步状态机复位,防止手柄 DOM 卸载导致界面死锁。
  20. 4. **内外分层的阴影与裁切规约 + 自动化审计脚本**:
  21. - 严格遵循 `offset + blur + spread` 物理外扩余量与内外分层(内层圆角、外层投影);
  22. - 内置 [`scripts/clip-audit.js`](scripts/clip-audit.js),一键在 DevTools / 浏览器环境中自动化遍历所有祖先容器,以 `cut === 0` 作为交付硬性门禁。
  23. 5. **智能自适应增高输入框(Composer)与局部滚动条收敛**:
  24. - 结合 `field-sizing: content` 与尺寸监听的弹性高度过渡;
  25. - 达到最大高度后局部消除粗糙的灰色系统滚动条外观,同时完整保留原生滚动语义与可访问性。
  26. 6. **多窗口状态一致性与工作区写锁(Broker-Replica)**:
  27. - 主窗口权威 Broker 与弹出子窗口 Replica 订阅不可变状态流,通过乐观基线锁仲裁并发冲突。
  28. 7. **骨架屏(Skeleton)双模动效与 105° 扫光物理学(Issue #25)**:
  29. - 对齐官方 `@ant/desktop 3.6556.2` 生产真值,采用 2.0s、105° 线性倾角扫光(RTL 下精确翻转至 255°);
  30. - 大卡片/Hero 采用 `[data-motion="wave"]` 配合 `--cds-skel-i * 90ms` 级联延迟;密集列表采用 `[data-motion="lockstep"]` 同步微呼吸;
  31. - 配合 `data-hold` 延迟揭示防闪烁机制与系统级减弱动效双层守卫。
  32. 8. **附件卡片原生视图过渡(Attachment View Transitions)**:
  33. - Composer 附件卡片增删换位全面接入现代 Chromium 原生 View Transitions API,结合 `@starting-style` 进场与 `cds-attachment-out` 退场,达成零复杂 JS 的平滑重排物理流动。
  34. 9. **界面排版、文案与视觉精致度八大铁律(UI Refinement & Craftsmanship)**:
  35. - 彻底禁用中点 “·” 分隔符,改用布局留白或极细分隔线;
  36. - 剔除弄脏 UI 界面的冗余副标题与解释性文字,让布局结构自我说明(Let the layout do the explaining);
  37. - 界面文案贴合受众,通俗易懂但不口语化,长短精准匹配控件,杜绝生造词;
  38. - 追求视觉重心光学对齐,嵌套容器严格落实同心圆圆角计算($R_{inner} = \max(0, R_{outer} - padding)$);
  39. - 统一采用 0.5px 精细微边框,高分屏下呈现轻盈通透质感;
  40. - 全页字号阶梯严格收敛至 3~4 种,坚守 12px 最小文字门禁,优先借由字重与灰阶表达主次;
  41. - 收敛交互决策负荷,必要选项就近上下文呈现,信息按优先级秩序化重构;
  42. - 克制设定圆角与阴影,坚决封杀卡片左边缘带颜色线条(彩条卡片)的陈旧装饰反模式;
  43. - 动态数值全量锁死等宽数字(`tabular-nums`),彻底消除 Agent 思考计时与 Token 速率跳动时的左右乱颤;
  44. - 标题文本启用 `text-wrap: balance` 防孤字成行,深色模式(Dark Mode)下字重自动下调一档以抵消人眼光晕效应发胖;
  45. - 出海多语言短词膨胀保护(顶栏按钮不写死固定像素宽度),阿语 RTL 下终端代码块、运行日志与进度条强制保持 LTR,多语言文本行高 $\ge 1.5$ 防音标削顶。
  46. 10. **去 AI Slop 极简哲学、按钮完整态与 AX 协作防稀释(EP20–24)**:
  47. - **Linear / Apple Notes 极简与 UX × DX × AX 三效协同**:删除多余标语与辅助说明,让布局自身自解释;低频提示用 `Tooltip`/`Alert` 按需折叠,文案书面严谨;
  48. - **全局变量圆角、连续圆角与 4px 对称网格**:色彩与圆角收敛为全局 Token;间距采用 4 的倍数且嵌套四边内边距一致;参考业界组件语义库建立 Do/Don't 范例;
  49. - **按钮 6 种完整状态(EP24)**:完整覆盖 Default/Hover/Active 下沉/Disabled/**Loading(转圈+锁点击防重复触发)**/**Focus-visible(Tab 聚焦外框,禁删 `outline`)**;
  50. - **AI 长窗口防注意力稀释协议(EP21/22)**:外置 Design Tokens 真源、复用现成组件组装、单窗连续修改超 5 轮跑偏果断开新窗并只喂最小切片。
  51. ---
  52. ## 💡 设计系统与技术栈边界(Framework & Design System Agnostic)
  53. - **不强制绑定特定组件库**:本 Skill **不设定、不限定任何特定 UI 库**(无论您的项目使用 `shadcn/ui`、`Ant Design`、`Radix UI`、`Tailwind CSS` 还是原生自绘,本规约均 100% 适用);
  54. - **不包含预制代码模板**:本 Skill **不包含任何预制的设计系统模板或样式代码包**。它的核心定位是桌面 Agent 场景下的**底层交互物理学、状态机设计原则、输入法防误触与自动化避坑验收门禁**;
  55. - **Agent 执行决策流**:
  56. 1. **已有项目**:Agent 优先自动检测项目环境,**严格沿用项目既有的成熟设计系统与组件库**,严禁引入重复依赖;
  57. 2. **从零起步**:若未检测到既定设计系统,Agent 会主动询问您是否有指定的组件库偏好;
  58. 3. **若需使用 Claude 设计系统风格**:若您希望复用或参考 Claude 的桌面设计系统(Claude Design System),可直接前往上游 [Open Claude UI](https://github.com/Caho1/open-claude-ui) 与 [在线文档](https://openclaudeui.com/) 获取其完整的 Design Tokens 与组件源码。
  59. ---
  60. ## 📂 仓库结构
  61. ```text
  62. desktop-agent-ui/
  63. ├── SKILL.md # Skill 入口定义与推荐工作流
  64. ├── README.md # 仓库介绍与使用说明
  65. ├── LICENSE # MIT 开源协议
  66. ├── references/
  67. │ ├── open-claude-manual.md # 现代桌面体系导读与核心工程机制
  68. │ ├── desktop-pitfalls.md # 桌面工程避坑指南(阴影、IME、焦点、滚动跳动)
  69. │ ├── agent-interaction.md # Agent 交互结构、生命周期与 RICH 委托控制权
  70. │ ├── components-motion.md # 核心组件实现、自适应高度配方与动效物理学
  71. │ ├── acceptance.md # 质量验收清单与 clip-audit 审计指南
  72. │ └── sources.md # 架构分类与技术参考索引(ENG-01 ~ ENG-17)
  73. └── scripts/
  74. └── clip-audit.js # 阴影与祖先裁切自动化计算脚本
  75. ```
  76. ---
  77. ## 🚀 使用方法
  78. ### 作为 Agent Skill 使用
  79. 将本仓库放置或链接至您的 Agent 技能目录(如 `~/.agents/skills/desktop-agent-ui` 或 `~/.gemini/antigravity-cli/skills/desktop-agent-ui`),Agent 在处理桌面端应用、AI 对话工作台或修复窗口裁切问题时将自动选用并遵照规范执行。
  80. ### 运行自动化阴影裁切审计
  81. 在浏览器控制台或自动化测试脚本(Puppeteer / Playwright)中运行内置的 [`scripts/clip-audit.js`](scripts/clip-audit.js):
  82. ```javascript
  83. // 在无边框透明窗口下进行全量审计
  84. const audit = (/* 将 clip-audit.js 内容粘贴于此 */);
  85. const result = audit({ viewport: true, tol: 1 });
  86. console.log(result); // 确保 result.cut === 0
  87. ```
  88. ---
  89. ## 🙏 致谢(Acknowledgments)
  90. 本项目深度参考、吸收并致敬以下优秀的上游开源工作与技术成果:
  91. 1. **Anthropic**:致谢 Anthropic 团队打造了卓越的 Claude 桌面端与 Web 客户端体验,其在设计系统(Claude Design System)、人机交互物理学与精致桌面工程标准上的深厚造诣,为整个 AI Agent 桌面应用领域树立了标杆;
  92. 2. [**Open Claude UI 手册** (`Caho1/open-claude-ui`)](https://github.com/Caho1/open-claude-ui)(在线文档:[openclaudeui.com](https://openclaudeui.com/)):感谢上游手册项目对现代桌面级 Agent 客户端界面拓扑、设计令牌体系、原子控件与架构细节的系统性拆解与开创性整理;
  93. 3. [**REA(Reverse Engineered Artifacts)仓库** (`morluto/rea`)](https://github.com/morluto/rea):感谢 REA 项目提供的底层精度审计、深入逆向洞察与生产级架构参考实现支持;
  94. 4. 感谢社区相关桌面设计规范与动效物理学 Skill 的启发与贡献。
  95. ---
  96. ## 📄 开源许可证
  97. 本项目采用 [MIT 许可证](LICENSE)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.