HappyHands 是什么？
HappyHands 是面向 AI 编程项目的本地设计审阅工作台。它把页面截图、项目设计来源、问题、修改计划和复核记录放在同一流程中，最终由人决定接受或拒绝修改。
从发现问题到复核结果
采集确认范围内的页面、设备和交互状态；结合截图、源码和项目设计规则检查问题。选定问题并确认计划后，由编码 Agent 在隔离的 Git 工作副本中修改，再复采对照、执行适用检查并独立复核。最终由你接受或拒绝。
选择设计系统与组件
设计资源页提供 HappyHands、Quartz、Lime 系统入口，以及组件和设计参考。先核对项目已有规范、上游许可与技术兼容性，再决定采用范围。外部示例和参考不等于已安装到你的项目。
自定义主题并导出
在主题工作室选择预设后即可预览，调整颜色、字体、圆角等变量，查看浅色与深色示例。可导出 CSS、Tailwind、registry 或兼容 Harness 的设计基础审批文件；浏览器草稿不会自动写入仓库。
打开主题工作室在本地启动
准备 Git、Node.js 22.15+、pnpm 11.19.0 和 Chrome 或 Edge。模型诊断与截图复核需要已配置并登录的 Codex CLI。以下命令在本机终端执行，打开工作台后再连接你有权审阅的项目。
git clone https://github.com/ShuaiMXu/happyhands.git
cd happyhands
pnpm install --frozen-lockfile
pnpm workbench打开 http://127.0.0.1:4190/apps/designer/。提供本地仓库、可运行预览、核心任务和设计规范来源；采集前确认页面、设备和状态。
配合已有编码工具
Codex CLI 支持诊断、截图复核和代码执行；Claude Code 提供执行适配器，完整端到端验证仍在进行。Cursor、Kimi Code、WorkBuddy 可在具备本地浏览器、终端及仓库访问能力时按 Harness 流程操作，没有各自的专用执行适配器。
数据、许可与 Alpha 范围
运行记录在本地 .harness/；模型辅助步骤会把选定源码上下文和截图发送给配置的模型服务。自有核心代码采用 MIT，第三方资源保留各自许可；模型服务费用另计。当前为 Local Web Alpha，未检查的页面与交互仍属未审阅范围。
常见问题
官网可以直接输入网址并自动改代码吗？
官网提供接入提示词、设计资源和主题工作室。本地工作台与 Harness 执行审阅流程；提供网址后，编码工具仍需核对预览和采集条件。代码修改需要可访问的本地仓库、确认的范围与执行适配器。
支持哪些编码工具？
Codex CLI 可用于模型诊断、截图复核与代码执行。Claude Code 有代码执行适配器，完整端到端验证仍在进行。Cursor、Kimi Code、WorkBuddy 在具备本地浏览器、终端及仓库访问能力时可操作 Harness，目前没有各自的专用执行适配器。
如何使用现有设计规范？
提供项目自己的 DESIGN.md、样式 token 和组件源码。提取到的设计规则先作为待确认候选，不能自动成为已批准规范。主题工作室可导出兼容 Harness 的设计基础审批文件。
源码是否开源？使用是否产生费用？
自有 HappyHands 核心源码采用 MIT 许可。第三方代码、素材与依赖保留各自许可，tldraw 的生产使用有独立要求。你配置的模型服务可能另行计费。
数据会发送到哪里？
运行记录保存在本地 .harness/。模型辅助步骤通过配置的 CLI 将选中的源码上下文和截图发送给模型服务，并非所有计算都在本机完成。分享导出记录前应检查敏感信息。
当前版本有哪些边界？
当前为 Local Web Alpha。审阅范围由采集计划和已完成检查决定；没有查看的页面和没有测试的交互不属于已通过范围。模型复核不能替代人工验收。