10 KiB
最新迁移状态:主上下文已将本包安装到用户 YCode,原文/技能/头像资源与激活及原生鼠标召唤验证通过。四包共356项资源验收,详见四位专家迁入记录。本文“未安装/只读”描述保留为恢复子任务阶段范围。
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_at24B(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 边界
- 没有包级 MCP 配置。 manifest 无 MCP/connector 依赖字段,完整库存也没有
.mcp.json。browser-use文档中的可用能力不能冒充已注册 YCode MCP 工具。 - 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.md6行及 SKILL.md 385行只提 key,遗漏脚本实际必需的 API_BASE,属于原包文档不一致。FFmpeg 为文档提到的可选音频后处理依赖。 - 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。 - HTML 不是完全离线自包含。
viewer.html23–26行直接引用 p5.js 1.7.0 cdnjs 和 Google Fonts Poppins/Lora;已保留原 URL,未联网抓取依赖。包内字体不能自动替代模板中的远程字体。断网、CSP、字体fallback、CDN版本效果仍需运行验收。 - UI 工程依赖按任务选择。 frontend-dev 提及 React/Next 等框架、Tailwind、Framer Motion/GSAP/Three.js/Lottie 等动效工具,不表示这些都随专家包打包或已经安装。模型需要依据目标项目检查并选择依赖。
- 两个角色自报技能不在包内。 Agent 398–401行提及
brand-guidelines与canvas-design,但 manifest 和完整库存均没有它们;实际注册必须依据上述三项。不能凭文字补造缺失 SKILL.md 或把其他本机技能拼入包。Agent 列表也未列实际声明的 browser-use。 - 角色文本保留与宿主权限分别处理。 Agent 13行声称身份覆盖 prior identity 等,该内容已按原数据保留;它不能提升宿主权限、覆盖系统指令或授权联网/读取用户资料。技能 allowed-tools 同样只是包的声明。
- 容量和资源读取。 包约6.25MB,原 YCode4MiB总包限制会拒绝,root 已接管统一升至16MiB及 HTML/LICENSE 文本支持。54个TTF必须作为二进制原文件保留;文本 resource 工具不能单凭返回字符串交付字体或 PNG。后续需要明确、受限的本地资源路径/复制使用通路。此轮未改 production。
恢复与核验命令
入口脚本都仅通过公共 REA CLI 读取原版。无需重新 prepare;旧 prepare 可能覆盖 root 此轮统一增强的 provider。
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可读取;头像可见;字体/模板可安全用于项目;缺依赖时诚实报错;外部媒体/浏览器任务在用户授权与真实环境下成功。以上尚未验证,不纳入本轮恢复通过结论。