89 lines
10 KiB
Markdown
89 lines
10 KiB
Markdown
> 最新迁移状态：主上下文已将本包安装到用户 YCode，原文/技能/头像资源与激活及原生鼠标召唤验证通过。四包共356项资源验收，详见[四位专家迁入记录](四位专家迁入YCode-2026-10-16.md)。本文“未安装/只读”描述保留为恢复子任务阶段范围。
|
||
|
||
# UI设计师｜像素君：REA 包恢复与兼容拆解（2026-10-16）
|
||
|
||
本轮已恢复完整功能包，共 **143 文件、6,249,920 字节**，全部与固定 REA 目录库存及保留导出的 SHA/字节核验一致。未安装到用户 YCode，未执行原 Python/JS/HTML，未调用 MiniMax 或浏览器服务；安装与实际运行由主任务继续验证。本结论是包内容恢复，不能据此宣称专家运行结果或 UI 已完成 1:1。
|
||
|
||
## 原版身份与证据范围
|
||
|
||
- 产品基线：WorkBuddy 5.8.2；专家包自身版本 **1.0.1**，两个版本不可混同。
|
||
- 正式 REA 选中目录：`C:/Users/Administrator/.workbuddy/plugins/marketplaces/experts/plugins/ui-designer`。本轮仅将此路径传入隔离 REA 公共 CLI；所有内容分析均读取 REA 导出副本，没有直接读取原目录。
|
||
- 完整目录库存 Evidence：`ev_a3defb3a940984c72aa5664163fab523b10ab867192a529ba9d3a672f0e7b95b`，保留于 `.tmp/rea-ui-designer-inventory-20261016.json`，coverage 为 `container-entries/complete`。
|
||
- 固定 root SHA256：`c9c83df190f0f0f871706d52b7e372f20b7ad63fde739f59cf9181ace1d08afa`。这是 REA 目录身份，不能与单文件 SHA 混同。
|
||
- 完整恢复目录：`.tmp/rea-ui-designer-recovered-20261016/`。`evidence-manifest.json` 每项含 `path/bytes/sha256/evidenceId/retainedExport/encoding`，二进制另含 mediaType；`remaining=[]`。
|
||
- 原库存 144 文件、6,249,944B，仅排除 `.downloaded_at` 24B（WorkBuddy 下载宿主标记）。未发现需要排除的其他 session 标记。恢复目录新增的 `evidence-manifest.json` 是本项目审计文件，不是原专家包成员，安装 helper 应继续排除该审计文件。
|
||
|
||
以下单文件 SHA 均由库存、REA 选中导出和恢复副本三方核验；其他文件身份在 manifest 中完整保留。
|
||
|
||
| 原相对路径 | 字节 | SHA256 |
|
||
| --- | ---: | --- |
|
||
| `.codebuddy-plugin/plugin.json` | 1928 | `e612a42daaff52e5be8d66c26d1d6748f31e4a4e2cd3506acc59d897b55e6d85` |
|
||
| `agents/ui-designer.md` | 15703 | `d6e54ca64ab54c6d3122ff0114a46d3820cedd1f05a5a14c541afa6a55e654aa` |
|
||
| `avatars/expert.png` | 291079 | `86399b938def53e15c84d7c3e3e7542248c2d834862511b6e2e78ed62b332014` |
|
||
| `skills/impeccable/SKILL.md` | 10412 | `dc66284a2a16f49773eabe1b96a92ec88f9a5a7f39c1320a3c9b87940d679a7c` |
|
||
| `skills/frontend-dev/SKILL.md` | 20710 | `6cc0f077f282b56b4fa666be6c7549f3176e88510eeda7becc271bf188a0444a` |
|
||
| `skills/browser-use/SKILL.md` | 10909 | `fb839ae844ae8c3aa16d07ed6f5d1db448718d0cea9ef3a30a8ed934796f1208` |
|
||
| `skills/frontend-dev/templates/generator_template.js` | 7822 | `b601d56dc95b4749adc1fcbae0ab889f93e83403ce8b07ccf1bd201638437944` |
|
||
| `skills/frontend-dev/templates/viewer.html` | 20714 | `f3584b5b365b36f17a5a87047ac7c1e5cd12c26f3b1dd24b6fa3d7cc77462d10` |
|
||
|
||
## 角色、技能与工作流
|
||
|
||
`plugin.json` 的真实显示名为中文 **像素君**、英文 **Sam**；职业为 **UI设计师 / UI Designer**，内部 name/agentName 为 `ui-designer`，expertType 为 `agent`，categoryId 为 `01-ProductDesign`。原头像、三个标签、三个 quickPrompts、双语 description 和 defaultInitPrompt 均原样保留。
|
||
|
||
角色主体 `agents/ui-designer.md` 是 UI Designer 身份与设计方法说明。定位为视觉设计系统、组件库、可访问性、精确界面和开发交付。四阶段分别在原恢复文件行 239/246/252/258：Design System Foundation、Component Architecture、Visual Hierarchy System、Developer Handoff。它不是预生成网页或确定性 UI 渲染器。
|
||
|
||
manifest 实际声明的技能仅三项，均已恢复 SKILL.md 与全部包内参考资源：
|
||
|
||
| 技能 | 原声明 | 主要工作流与资源 |
|
||
| --- | --- | --- |
|
||
| `impeccable` | version 2.0.0；allowed-tools Read,Write,Bash | 先读 `.impeccable.md`，缺失时读 `references/teach-impeccable.md` 收集设计上下文（SKILL.md 58–59行）；按审查、排版、色彩、空间、响应式、动效、交互、文案等能力组合。30 份 references 全恢复。 |
|
||
| `frontend-dev` | 顶层 version 0.1.1；metadata.version 1.0.0 | 六阶段：设计架构→动效架构→资产生成→文案→实现UI→质量门（169/174/178/185/188/191行）；10份参考文档、4个Python媒体脚本、生成艺术 JS/HTML 模板、54个 TTF 与27个OFL文本。 |
|
||
| `browser-use` | version 2.0.0；allowed-tools Bash(browser-use:*) | `open→state→click/input→state/screenshot` 循环（34–37行）；本地 headless/可见浏览器、连接 Chrome/profile、可选 cloud。2份 references 全恢复。 |
|
||
|
||
`frontend-dev` 的生成艺术分支要求先创作 philosophy，再实施算法并保留模板的结构、seed 控件。`viewer.html` 原文有算法与参数处理的 `fill this in`，这是预期供模型改写的模板，不能把未改写模板标成已完成产物。JS 模板同样是算法结构参考。
|
||
|
||
## 完整目录覆盖
|
||
|
||
恢复文件扩展统计：JSON1、Markdown47、PNG1、LICENSE7、TXT27、TTF54、Python4、JavaScript1、HTML1，总数143。
|
||
|
||
| 资源组 | 文件数 | 字节 |
|
||
| --- | ---: | ---: |
|
||
| `skills/frontend-dev/canvas-fonts/`（TTF+OFL文本） | 81 | 5,530,719 |
|
||
| 其中 TTF | 54 | 5,412,104 |
|
||
| `skills/impeccable/references/` | 30 | 199,872 |
|
||
| `skills/frontend-dev/references/` | 10 | 80,923 |
|
||
| `skills/browser-use/references/` | 2 | 6,467 |
|
||
| `license/` | 7 | 31,081 |
|
||
| `avatars/expert.png` | 1 | 291,079 |
|
||
|
||
许可包括 agency-agents/browser-use MIT、anthropics-skills Apache-2.0 与字体 OFL；恢复保留原文件及字体目录中的 OFL 文本，未改写授权声明。
|
||
|
||
## 真实依赖、原包矛盾与 YCode 边界
|
||
|
||
1. **没有包级 MCP 配置。** manifest 无 MCP/connector 依赖字段，完整库存也没有 `.mcp.json`。`browser-use` 文档中的可用能力不能冒充已注册 YCode MCP 工具。
|
||
2. **MiniMax 媒体生成需要真实环境。** 四个 `scripts/minimax_*.py` 都 `import requests`，都读取 `MINIMAX_API_KEY` 和 `MINIMAX_API_BASE`；缺少 API_BASE 会立即退出，缺 key 在请求前退出。接口涉及 image_generation、music_generation、t2a_v2、video_generation 及查询/下载。需要 Python+requests 与显式凭据/网络，不应静默复用对话模型 key。`references/env-setup.md` 6行及 SKILL.md 385行只提 key，遗漏脚本实际必需的 API_BASE，属于原包文档不一致。FFmpeg 为文档提到的可选音频后处理依赖。
|
||
3. **browser-use 是独立 CLI 宿主依赖。** SKILL.md 14–17行要求 binary 与 Unix curl/bash 安装命令；Windows 可运行性、版本、浏览器/daemon 安装都待验。cloud 模式另需 `BROWSER_USE_API_KEY`（133行）。YCode 的 WebContentsView 存在不等于该 CLI 已安装或 API 等价。本轮没有安装、连接用户 Chrome、同步 profile、开 tunnel、调用 cloud。
|
||
4. **HTML 不是完全离线自包含。** `viewer.html` 23–26行直接引用 p5.js **1.7.0** cdnjs 和 Google Fonts Poppins/Lora；已保留原 URL，未联网抓取依赖。包内字体不能自动替代模板中的远程字体。断网、CSP、字体fallback、CDN版本效果仍需运行验收。
|
||
5. **UI 工程依赖按任务选择。** frontend-dev 提及 React/Next 等框架、Tailwind、Framer Motion/GSAP/Three.js/Lottie 等动效工具，不表示这些都随专家包打包或已经安装。模型需要依据目标项目检查并选择依赖。
|
||
6. **两个角色自报技能不在包内。** Agent 398–401行提及 `brand-guidelines` 与 `canvas-design`，但 manifest 和完整库存均没有它们；实际注册必须依据上述三项。不能凭文字补造缺失 SKILL.md 或把其他本机技能拼入包。Agent 列表也未列实际声明的 browser-use。
|
||
7. **角色文本保留与宿主权限分别处理。** Agent 13行声称身份覆盖 prior identity 等，该内容已按原数据保留；它不能提升宿主权限、覆盖系统指令或授权联网/读取用户资料。技能 allowed-tools 同样只是包的声明。
|
||
8. **容量和资源读取。** 包约6.25MB，原 YCode4MiB总包限制会拒绝，root 已接管统一升至16MiB及 HTML/LICENSE 文本支持。54个TTF必须作为二进制原文件保留；文本 resource 工具不能单凭返回字符串交付字体或 PNG。后续需要明确、受限的本地资源路径/复制使用通路。此轮未改 production。
|
||
|
||
## 恢复与核验命令
|
||
|
||
入口脚本都仅通过公共 REA CLI 读取原版。无需重新 prepare；旧 prepare 可能覆盖 root 此轮统一增强的 provider。
|
||
|
||
```powershell
|
||
node scripts/rea/ui-designer-inventory.mjs
|
||
node scripts/rea/ui-designer-recover.mjs --text-supported
|
||
node scripts/rea/ui-designer-recover.mjs --all
|
||
node scripts/rea/ui-designer-recover.mjs --verify
|
||
node scripts/rea/ui-designer-audit.mjs
|
||
```
|
||
|
||
已执行结果：最初80个已有文本类型恢复；增强后另8文本与55二进制（avatar+54TTF）恢复。最终 `--verify` 完成，audit 将全部143项与库存、10份保留 REA export、落盘副本逐字节比对，**143/143通过，remaining0**。报告 `.tmp/rea-ui-designer-audit-20261016.json`，含每项检查、技能 YAML、原 template URL 与脚本依赖摘要。
|
||
|
||
10份 export 的完整 Evidence ID 和保留路径在 manifest 中；新增类型的 Evidence 为：文本 `ev_87a0455d315432eba3eab54db60a20bc0052fce97648995aa7873545af7444fe`；二进制 `ev_e957f76844c1027d6b71082a174a49e430947bbcadc16d40529ca24dd660eb71`、`ev_1a96bd5f0318afd1bdbbdb602dce964168177bfc953742ba80b6b35d69fadf4c`、`ev_35e6daa82ade3e59e7d9aa747ea5701d5aa5e81a284df6015764c5482042c2b4`、`ev_aa2295332cd76efb5f3555842d7a48f6d523f0318adade2ca3718f787edfa82a`。
|
||
|
||
安装后仍需验证：角色/三技能实际进入模型上下文；references/templates可读取；头像可见；字体/模板可安全用于项目；缺依赖时诚实报错；外部媒体/浏览器任务在用户授权与真实环境下成功。以上尚未验证，不纳入本轮恢复通过结论。
|