ShuaiMXu/happyhands
ShuaiMXu/happyhands has 429 GitHub stars and 10 forks. GitHot measured +40 stars in 24 hours and +325 in 7 days. Last checked 2026-11-11 23:43 UTC. Last push 2026-11-05.
Open-source, AI-assisted UI design review for coding agents. Inspect screenshots, scope code changes and compare results in a local workbench. Alpha.
实测星标增长
- 24小时
- +40
- 7天
- +325
- 15天
- 更新延迟
- 1个月
- 更新延迟
各周期内的星标净变化，周期相互重叠，并非每日新增。缺失的测量保持空白。星标代表关注度，不代表软件质量。
README.zh-CN.md
原文
让每一次界面修改都有依据。
在本地发现界面问题、调用编码 Agent 修复，再核对修改结果。
HappyHands 将界面诊断、Agent 修复和前后对比放在同一个本地工作台中。查看页面与交互状态，发起一次范围明确的修复，再决定是否采纳并提交草稿 PR。
产品演示
37 秒产品演示。
https://github.com/user-attachments/assets/19607c8f-3fb4-4db5-826e-ff664980dbce
开始使用
准备 Git、Node.js 22.15+、pnpm 11.19，以及用于浏览器采集的已安装 Chrome 或 Edge。本仓库提供本地工作台与 Harness 源码。工作台内置模型诊断和视觉复核需要已配置、已登录的 Codex CLI；代码实现所需的 CLI 配置取决于所选执行器。区别见配合你的编码工具。
git clone https://github.com/ShuaiMXu/happyhands.git
cd happyhands
pnpm install --frozen-lockfile
pnpm workbench
保持这个终端运行。pnpm workbench 会启动 HappyHands 本地工作台，并打开 http://127.0.0.1:4190/apps/designer/。这个地址需要启动服务后才能在你的电脑上访问，不是官网，也不是主题工作室。
确保待审阅产品有可用的预览。如果需要本地服务，请另开一个终端，按照该项目自身的说明启动。确认预览地址能在浏览器中打开后，再到 HappyHands 工作台连接项目，提供本地仓库目录、预览地址和具体的用户任务。
下面是需要提供的信息示例，不是终端命令。请将目录和地址替换为项目的实际值；3000 只是示例端口，与工作台使用的 4190 不同。
项目仓库：/path/to/your-product
预览地址：http://localhost:3000
用户任务：完成注册并创建第一个项目
已有设计资料（可选）：DESIGN.md、src/styles/tokens.css、src/components
设计资料是待审阅仓库中已有的规范文件、样式或组件目录，供审阅参考。上面的路径只是示例，并非必须具备的文件；请使用实际路径，没有的可以省略。
采集前核对建议的页面、设备和交互状态。项目配置和命令行操作见 Harness 指南。官网 提供使用指引和设计资源；仓库审阅和代码修改在本地执行。
一次审阅怎么进行
- 查看问题。 连接仓库和预览，核对采集范围，查看桌面、手机截图及对应问题。在当前审阅中切换设备、版本和交互状态，点击截图即可页内放大。
- 一键修复。 工作台根据当前源码核实诊断问题，准备修改范围和计划，再调用编码 Agent 在隔离的 Git 工作副本中执行。完成后重新采集页面，运行适用检查和独立视觉复核。缺失证据和失败记录会保留。
- 核对结果。 查看前后对比，决定接受或拒绝。接受时理由选填；拒绝或提交反证重新复核时需说明原因。已接受且通过验证的修复，可再点击提交草稿 PR，工作台不会替你合并或部署。
一键修复代表你授权工作台处理本轮中间的范围与计划步骤，最终结果仍由你判断。没有原页面的新界面，依然需要先明确批准设计基础，再开始实现。
问题需要什么依据
正式问题需要有可复现的现象、明确的错误说明，以及对应的 skill 快照引用。Harness 会核对引用的章节、行号和原文。宽泛的设计建议、个人审美偏好不能单独成为自动修复依据。
修改遵循被审项目自己的设计来源。HappyHands UI 规范用于工作台，以及明确采用这套规范的项目。原始截图、早期失败和未录入建议都会保留，具体要求见问题录入与判断依据。
HappyClaw 重审记录 展示了一次实际过程：补充反证后重新独立复核，同时保留原失败报告。这份记录说明的是该案例的审阅路径，不代表整个产品已验收或部署。
设计资源
官网 提供 Design.md 参考、设计系统、组件和主题工作室，可用于选择设计方向、预览主题和准备项目设计文件。这些是审阅时的可选输入，浏览某个参考不会自动把它批准为项目规范。
配合你的编码工具
HappyHands 支持任意 AI CLI 参与开放的编码 Agent 工作流。外部 Agent 具备所需的本地终端、仓库和浏览器访问能力时，可以操作 Harness；在 Harness 外完成的修改也可采集和审阅。通过 harness execute 直接执行则需要已注册的适配器，当前默认使用 Codex。这不代表每个 CLI 都有内置接入，也不代表所有功能都已在每个 CLI 上验证。
| 工具 | 当前用途 |
|---|---|
| Codex CLI | 内置模型诊断、截图视觉复核，也是默认代码执行适配器；执行路径已有使用记录，不等于所有功能均已完成全流程验证。 |
| Claude Code | 对已确认任务提供代码执行适配器；需先完成配置，完整端到端验证仍待完成。 |
| Cursor、Kimi Code、WorkBuddy | 工具具备本地浏览器、终端和仓库访问能力时，可以指导和操作 Harness；目前没有各自的代码执行适配器。 |
运行 pnpm harness agents 查看已注册执行器，通过 harness execute --agent ID 选择；--command PATH 只更改该适配器的二进制路径，不改变 CLI 协议。其他 CLI 若要直接执行，需要添加适配器。外部修改没有 Harness Agent 执行记录，审阅时需单独说明。具体行为和限制见适配器说明。
当前范围
HappyHands 目前是免费的本地 Web Alpha。外部模型和 CLI 服务可能需要单独的账号、订阅或按量付费。结论以采集计划和已完成检查为准，未查看的页面、未测试的交互仍属未审阅范围。专业校准、真实用户验收等缺口见当前待办。
运行记录存放在 .harness/。模型辅助步骤会通过 CLI 将所选源码上下文和图片发送给配置的模型服务。工作副本与仓库检查属于流程保护，不是安全沙箱。分享导出记录前应检查敏感内容，详见数据与执行说明。
开发与仓库说明
pnpm dev # 本地开发，端口 4173
pnpm design:check # 设计文档和接入契约检查
pnpm test # 工程测试
pnpm regression # 版本化发布案例
pnpm build # 契约检查及生产构建
pnpm harness skills # 已注册方法及其成熟度
工作台界面位于 apps/designer/，本地服务位于 packages/workbench/，采集、执行和运行记录位于 packages/harness-core/。当前公开官网由 happyhands-site 独立维护；本仓库的静态构建不提供可写本地服务。
贡献前阅读 AGENTS.md、DESIGN.md 和架构文档。保留批准边界、来源信息及完整上游 Skills，如实记录实际执行的检查；不要提交凭证、私有截图或本地运行记录。
项目链接
官网 / Harness 指南 / 待办 / 问题反馈
关注核心项目：
自有 HappyHands 源码采用 MIT。第三方代码和依赖保留各自许可，包括 tldraw 独立的生产使用要求，详见 第三方声明。