Appearance
设计原则
Core 不理解业务
Core 不能包含产品页面、领域状态、接口路径、品牌和 Token 值。它只负责可复用机制:配置、命令解析、诊断、验证、报告和安全写入。
这样做的代价是需要更多显式配置;收益是 Harness 不会被某个业务项目绑死。
项目事实归项目所有
.fe-harness/project.yaml 是目标项目拥有的配置。项目选择 profile、platform、stack,并把符号化验证步骤映射到真实命令。
Harness 可以提供模板和默认值,但不能长期替项目保存真实业务事实。
初始化必须安全
接入已有项目时,Harness 要先预检所有目标文件。只要有真实冲突,就停止写入。已有相同文件保留,已有不同内容报告为项目已维护或冲突。
这条原则是为了避免工程工具用“初始化”的名义覆盖用户维护的规则。
能力默认轻量,按需展开
新项目默认只安装聚合 Consumer H5 Skill。命令级 Skills、OpenAPI、UI System、Design Token discovery 和视觉基线都是按任务需要启用。
这不是删除能力,而是降低默认认知成本。
验证是完成证据
验证报告不是形式化步骤,而是任务完成的证据。失败命令、环境阻塞、未配置能力和业务失败应该被区分记录。
Consumer H5 的完整功能验收不只看构建和首屏,还要看需求闭环。