Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

8.3 KB
Raw Blame

Open Claude UI 阅读与取舍

本文件是人工阅读笔记,不登记为可被线上字节覆盖的上游快照。原文、版本与哈希登记在 reference-sources.json 的 open-claude-ui-* 条目;采用的原则见 Peach 设计准则。

证据范围

  • 来源:Caho1/open-claude-ui,阅读日期 2026-10-15。固定源码树对应登记 revision。
  • 阅读七篇设计手册、code-examples/ 全部 32 个文件(30 个 TS/TSX 模块、CSS 与 Tailwind 配置)、包入口、清单、TypeScript 配置和资产说明;Storybook 核对资源加载与演示入口,未执行组件或安装上游依赖。
  • 实测(源码读取):公开仓库的代码、配置与本文指出的实现分支可按固定版本复查。上游 Storybook 的浏览器视觉、交互和 Claude 官方原始 bundle 均为 未取得。
  • 推导:从代码分支得出的能力边界与失败条件。推断:迁移至 Peach 的产品收益,须在实际实现时验收。作者关于「官方精确还原」「生产级」「消除色阶断层」的描述不作为 Peach 实测结论。
  • MIT 原文保存在 许可证。快照保留原文字节与版权声明;生产代码没有消费上游模块。

七篇手册的采用范围

手册范围 Peach 的判断
1. 设计哲学与 token 采用表面层级、减少重复外框、稳定几何、语义排版与等宽数字;颜色、尺寸、字重、阴影与光学补偿沿用 Peach 的证据与 token
2. 基础控件 采用独立边界、附件身份和状态、危险动作清楚表达的原则;按钮、互斥选择、Dialog 与等待反馈复用现有组件
3. 会话与指令 采用输入法保护、建议菜单的键盘优先级、对象与参数/结果分区;模型菜单、指令、Token 估算及每次工具调用强制授权不属于 Peach 的默认设计
4. 动效与渐隐 采用按角色选择动效、渐隐随实际溢出变化;多段渐变可选,数值须实测,持续光场与逐字模糊没有当前消费者
5. 媒体与产物 采用锚点缩放、图像实际范围、受限预载、分栏取消与恢复、增量更新;音频管线、专有 MIME 与代码编辑器不引入
6. 桌面与协作 采用真实任务状态、保持阅读位置、容器适配、可退出的键盘导航与可恢复重排;Electron、macOS 标题栏与 Cowork 架构不引入
7. 工程与资产 采用明确的依赖和资产归属;不加载上游全局 CSS、Tailwind 配置、字体或提示音,保留 Peach 已固定的运行依赖

组件源码逐项判断

下表文件均位于固定源码树的 code-examples/。判断是设计参考范围,不是运行验收或代码采用清单。

文件 源码判断与 Peach 边界
CdsButton.tsx 变体与尺寸明确;忙态使用原生 disabled、opacity 和按压缩放,Peach 使用现有 Button/setActionBusy 契约
SegmentedControl.tsx 单一移动底板可参考;没有方向键漫游,固定 layoutId,Peach 使用已有 Switch/Tabs/ViewGlide
StatusIndicators.tsx 不同等待形态可参考;不复制颜色、周期或流式装饰光标
AttachmentCard.tsx 身份、大小、移除与上传进度分区可参考;可点击 div 的键盘语义与进度可访问属性不完整
ChatComposer.tsx 附件仅模拟添加,Enter 路径没有合成检查;不作为输入保护实现
ChatMessageBubbles.tsx 正文与产物分层可参考;没有真实聊天传输,复制未等待结果,固定计时不用于成功反馈
ThinkingAccordion.tsx 任务与显示状态可分开;触发器是可点击 div,运行中强制展开不迁移到 Peach 日志
RichComposerWithMentions.tsx 合成状态、isComposing 与 229 守卫存在;只采用输入保护,建议源和 Token 算式是示例数据
ModelSwitcherWithTokenGauge.tsx 指标分解的展示层可参考;默认 Token 数值和模型矩阵不用于真实状态或成本判断
McpToolDecisionCard.tsx 对象、入参与结果分区可参考;1200ms 计时器直接设 success,不代表真实执行;拒绝与失败也合用状态
ClaudeMotionPresets.ts 按交互角色分预设可参考;四套数值、收敛时间及自写弹簧求解器不引入
ReasoningAmbientGlow.tsx 具有持续 Canvas 和多重装饰等待;没有当前消费者,不作为状态反馈模板
ScrollFadeContainer.tsx 纵向多段遮罩与边缘状态可参考;横向是线性遮罩,both 返回空样式;ResizeObserver 只观察容器自身
ClaudeAudioPlayer.ts 代码合成音效确实存在;没有手册描述的 AudioWorklet 流式 PCM 管线,不作为 Peach 播放器替代
LiveMicActivityBars.tsx 六段采样与门限映射存在;语音场景无当前消费者,循环调用 Hook 与 idle 持续帧循环需独立验证
MediaLightboxViewer.tsx 锚点公式和受限图像窗口可参考;没有 Tab 焦点圈定,拖动会累计起点位移,测量读取变换后矩形,不替换 Swiper
useClaudeSharedElementTransition.ts 图像内切范围与 reduced motion 分支可参考;目标名称在 ready 后设置,不能仅凭源码声明共享元素视觉通过
ArtifactsSplitPaneResizer.tsx 取消回滚与展开入口可参考;没有 4px 门槛、pointercancel 或方向键调节,窄容器可能使 min/max 冲突
EpitaxyIframeBridge.tsx source/origin 校验存在;祖先页面曾经激活不证明当前 iframe 手势,不能作为可靠授权边界;不引入此桥
StreamingDiffViewer.tsx 统一/分屏、行号与内容的归属可参考;实际是每次全量解析并渲染表格,没有 Shadow DOM、Worker 或增量 feed
CodeBlock.tsx 复制动作与局部反馈可参考;没有等待剪贴板 Promise,Peach 成功回执以实际结果为准
createClaudeMainWindow.ts Electron 专属窗口工厂;Peach 的浏览器服务与托盘入口不采用此宿主
ClaudeDesktopHeader.tsx 系统控件避让只属于特定宿主;普通 Web 页面不继承 macOS 交通灯占位
DraggableSessionList.tsx 落点提示与键盘重排可参考;数据只在本组件内存,移出原项后的插入索引需验证,不作为持久化实现
CoworkAgentCanvas.tsx 任务、成员与产物分区可参考;静态示例数据,没有宣称的 BroadcastChannel 同步
useClaudeScrollPinning.ts 解除跟随与跳至最新可参考;需要调用方接线,150ms/40px/120px 不成为 Peach 固定参数
ContainerResponsiveBar.tsx 按容器宽度压缩辅助标签可参考;固定模型名与断点不是通用工具栏组件
useClaudeRovingFocus.ts 单一 Tab 停靠点与 RTL 意图可参考;首项向前时 -1 同时被用作无目标标记,循环回绕分支不执行;没有真实二维网格几何
useRateLimitBackoff.ts 等待、倒计时和手动恢复可参考;重试策略仍归服务端,±15% 抖动不等于 Full Jitter,不能照搬等待时限
cds-theme.css 分层和语义别名可参考;全局选择器与可变字体补偿会覆盖 Peach,保留自身 token
tailwind.config.js 展示上游样式词汇;Peach 使用已有 Tailwind 4 与 BoardUI 构建,不加载该配置

保留的 Peach 差异

采用的是设计准则;运行时保持 React、BoardUI、React Aria、Motion、Swiper、现有菜单、滚动与任务契约。普通按钮按下不缩放,选中态继续使用项目既定填充;「单一外框」允许独立字段与可访问焦点的必要边界。

上游 Storybook 需要 Tailwind CDN、React/ReactDOM UMD、Babel 和 Google Fonts;它不是可直接作为离线验收入口的自包含页面。package.json 为 1.0.0,build 调用 tsc,而配置 noEmit: true;未执行构建,不能据此认定可安装产物可用。

设计准则不新增业务功能、批准范围、依赖或生产设置,不写真实 ledger。页面采用时需验证输入法、焦点、取消、部分失败、快速反向操作、窄容器、缺图与减少动态效果;不存在当前消费者的能力不提前接入。