# Jessy视觉系统 · Agent使用指南

这份指南是视觉系统的交接入口。它供现有Skill、设计师和其他Agent按任务取用规则，不是已安装Skill，也不修改既有Skill。

## 读取顺序

1. 读同目录 [`brand-system.json`](./brand-system.json)：身份、颜色分工、场景、流程和验收。
2. 读同目录 [`tokens.json`](./tokens.json)：准确数字色值、字号、间距、圆角、语义色与参数。`$value`可能引用其他token，使用时应解析。
3. 读 [`../assets/asset-index.json`](../assets/asset-index.json)：按`assetId`找到实际文件、尺寸、来源和确认状态。
4. **实际打开M01主参考图片，再开始生成或编辑人物。**不能只读文字描述、文件名或alt。连续漫画还须实际打开M02，查看分镜与动作因果。

规则来源是V2.3手册，内容基线沿用V2.2；该手册的DOCX排版不是新的角色标准。颜色、材质、组件与新人物仍保留候选状态。

## 素材的权限范围

| 编号 | 可以参考 | 不能推导 |
|---|---|---|
| M01 | 已认可人物身份与细腻Q版画法 | 图中一切道具或旧猫都自动获认可 |
| M02 | 已认可系列的历史叙事与分镜布局 | 猫咪毛色、产品标识、小字号是新标准 |
| C01 | 视角与服装候选 | 真90度侧面、精确且统一的头身比 |
| C02 | 表情与动作候选 | 每种表情已获用户确认 |
| C03 | 正面站姿透明候选 | 清晰度更高就取代M01 |
| C04 | 向画面左侧讲解透明候选 | 发丝边缘、脸型与比例已定稿 |
| C05 | 含座椅的坐姿邀请透明候选 | 坐姿透视能用来测站姿比例 |
| C06 | 昼夜氛围与材质候选 | HEX准确色卡、连续动画帧或人物母版 |
| A01 / H01 | 索引登记的氛围或局部构图 | 历史内容全部有效 |

确认范围要写清。新生成、自动检查通过、模型觉得更像，都不能把候选升为“已确认”。用户最新明确指令优先于旧规范。可在用户已授权的任务中使用候选制作可审阅效果，无须为每次选择重复请求许可；交付时保留候选标识。

## 不变与可变

身份固定：成年女性；M01的圆脸、眼型、五官关系、头身与细腻画法；蓝黑渐变长发；常用头顶墨镜。日常基准是宽松黑色长袖、黑裤、无logo白鞋。

按任务变化：表情、观看方向、动作、场景、天气、日夜和合理场景服装；运动可以束发。变化之后仍须认得出同一人。不要捏造精确比例，先对照M01。

包不常驻，不使用书包。机器人不是默认陪伴或每次代劳的角色。人物主动观察、尝试、判断与修改。没有依据不加品牌logo、产品细节或客户成绩。

FU是**英短蓝猫**，255是**英短乳白猫**。必须用真实照片校准脸、体型与毛色；目前正式猫咪母版待补。缺参考就省略猫，不编造，不用旧图里的黑猫或橘白猫代替。

## 按任务执行

### 做封面、教程、漫画或尾页

输入：真实选题、目标读者、信息重点、最终文案、动作、是否出现猫/产品、交付尺寸。

执行：

1. 读取三个数据入口并打开所需主参考。
2. 选1080×1440（3:4）模板；先分配文字空间，再选姿态与场景。
3. 根据内容改变动作、构图和信息密度，保持人物身份。漫画保留动作因果与读图顺序。
4. 用昼夜语义色；不要把识别蓝当小字正文。插画自然肤色与发丝不逐像素套HEX。
5. 输出实际成品、可编辑稿和360px宽手机预览。默认4–6页可按任务调整，不删故事换留白。

复核：360px宽预览必读正文等效至少16px（1080px原图相当于48px），对白约18px，标题28px以上；文字不被人物挡住；每页任务明确；实际品牌或猫有来源。

### 做Home、Library或Studio应用

| 空间 | 第一任务 | 视觉密度候选 |
|---|---|---|
| Home | 作品、缘起、感受和个人表达 | 场景约首屏55% |
| Library | 方法、步骤、解释和可复用知识 | 场景约首屏15% |
| Studio | 客户需求、方案、案例与交付 | 场景约首屏8% |

这些是起点，不是硬像素比例。不要三站套同一种卡片。人物不能挡正文、表单或付款。应用演示不能宣称对应真实网站已重建、已上线或已完成交易集成。

在375、430、768、1024、1440 CSS px检查：无横向溢出、遮挡和截断；核心操作可用键盘；焦点可见；重要入口不只在Hover出现；减弱动态和关闭玻璃后内容仍清楚。

### 给另一个人复用

保留“输入—参考—规则—应用—复核”的流程，替换人物、识别特征、颜色、字体、性格与空间选择。用同一组头像、封面、内页、主页任务测试，保留失败与修改记录。不能只换名字、换蓝紫色就声称完成不同IP。目前这项实测**未开始**，不得写成已完成案例或可量化成效。

## 颜色、材质与交互

- 基色和语义层以`tokens.json`为数字依据。原八个基色保留；新增链接深蓝`#42549B`是候选，不替换识别蓝`#5F73C8`。
- 日间正文`#2C3148`、链接`#42549B`；夜间正文`#F2F1FA`、链接/焦点`#B9B7E8`。链接持续下划线，状态同时用名称、原因与图标/形状。
- `#5F73C8`在月光白上约4.12:1，不作普通小字；在墨蓝上约2.91:1，不作必要边界。普通文字至少4.5:1；大字和必要非文本按适用规则至少3:1。按未舍入结果判定。
- 导航玻璃日间72%、夜间80%、blur 24px、阅读底96%是起测值。真实合成背景最不利处重新检查；正文100%不透明，重要内容用稳定实色底。关闭玻璃后使用对应`semantic.surface.base`。
- 微交互通常180–280ms、悬停2–4px。尊重`prefers-reduced-motion`；天气、雨、云、3D和重粒子可关闭。静态板不等于性能实测。
- 数字交付使用sRGB HEX/RGB。未校色、未打样，不写统一CMYK或Pantone等价值。

## 字体与已有差异

中文优先Noto Sans SC同系思源黑体。tokens里的Georgia/Times是英文展示候选，V2.3文档使用DejaVu代用字体；两者均不代表正式字标定稿。使用现有字体替代须重查字宽、换行、中文缺字和最终渲染。

旧`components-preview.html`与组件SVG属于前轮候选；新制作使用tokens的`semantic`、`controlBorder`等新语义层。雾银仅作装饰边界，不把旧板上低对比颜色沿用为必要控件边界。

源包`design/color/03g-three-spaces.png`为0字节，不能加载为图片；应使用有效SVG或有记录的新渲染预览。C01/C02在源包中没有同名独立文件，必须按资产索引映射板图，不能杜撰路径。

## 验收与交接

分别记录三类结果：**自动检查、实际视觉复核、用户确认**。未运行写“未运行”，没有用户确认时证据为`null`。同类失败两次后缩小修改范围，或返回M01重新对照。

最终交付前阻断项：人物身份或画风漂移、编造猫/品牌/客户/结果、必读文字不可读、核心操作不可用、虚假确认或虚假实测。候选设计可供审阅，但不能因此宣称最终定稿。

交接最少包含：

1. 实际画面或可运行应用。
2. 使用的`assetId`与版本、引用的规则/token。
3. 改了什么、为何这样处理、怎样检查。
4. 已知问题、候选状态和需要用户确认的具体对象。

推荐记录字段与完整QA见`brand-system.json`的`qa.reviewRecord`。只改本次任务范围，保留原始认可母版，不用整册截图代替独立可编辑素材。


## 本门户的素材定位

在 `../assets/asset-index.json` 的 `assetGroups` 中按编号查找，例如 `assetGroups.M01.primary` 是原始认可母版，`preview` 只用于快速预览。C01有视角与服装两项，C02包含六个表情和候选姿态编号。`available: false` 表示历史资产未收入门户，不能猜路径或用新候选替代。


## 应用制作与任务交接

门户1.1的场景制作台可修改封面标题、配文、邀请问题与署名，导出1080×1440 PNG或文字可编辑的自包含SVG。人物使用原始透明PNG内嵌，不重绘；所有结果仍为应用候选。

任务书生成器按小红书图组、漫画、插画或三个站点用途选择参考和规则章节。生成的MD与JSON表示尚未执行的制作请求，不能当作已验收结果。门户保持私密，须把任务书列出的规则文件与真实母版一并交给执行Agent。