Linejig 是做什么的?
Linejig 为每幅插画绘制一个物体,使用 Three.js 呈现为交互式 3D 线条艺术,并基于共享的内核引擎确保每个图形保持统一风格。该技能所需的一切均在此文件夹中。
适用于每个图形的惯例
- 是否已有现成图形? 在绘制之前,请检查画廊清单(https://linejig.com/illustrations.json;画廊位于 https://linejig.com/library.html,每个图形位于 https://linejig.com//)。仅当该图形字面上展示了页面所讨论的内容时才使用它。
- 概念:一个物体,三个选项。 写出三个概念,用一句话推荐其中一个,并等待用户选择,除非用户说“直接画”。选择后,在绘图完成前不再停止。
- 一个在缩略图尺寸下也能辨认的剪影, 其特点在于改变轮廓,而不仅仅位于轮廓内部。
- 逻辑运动。 所有运动遵循真实的因果顺序:零件按照现实物体的组装方式组合,英雄部件执行现实部件应有的动作。
- 命名所展示的内容,绝不展示归属: 绘图及其文字中不得包含任何徽标、公司、产品或人物。
- 文字中不得使用长破折号。
绘图规则遵循 Lucas Marques 的 Hairline 图形内核(MIT 许可证):https://hairline.lucasmarkes.com 和 npm 包 @lucasmarkes/hairline。
绘制之前:先思考
用户在评估执行力之前先判断创意。
- 用一句话说明该图形将置于何物旁边。
- 写出三个概念(
references/metaphors.md):“物体 Z,英雄部件 H,因为……,其开场方式和唯一动作 M。” 如果某个概念需要文字说明才能理解,则放弃它。推荐一个概念并等待用户选择。 - 如果用户提供了参考图,请解释每个参考图在构建前如何发挥作用。
不包含的内容
- 插画中无文字。 无引线、指示点、零件上的数字、说明文字、标题、标签或“图”标记。如果宿主页面需要文字,那是页面的职责,而非插画的。
- 无小细节。 无铆钉、条带、交叉线、雕刻、纹理、阴影、渐变或发光。
- 无 AI 图像或视频, 也不得描摹生成的图片。所有内容均通过代码绘制。
内核
每个图形均基于共享内核构建:https://linejig.com/kernel/linejig.js(MIT 许可证;其头部注释即为 API;可在线阅读,或在源仓库中查看 site/kernel/linejig.js)。一个图形文件仅包含其模型、ASSEMBLY 表和 HERO 处理器,约 100 至 150 行:
import { createFigure } from '../kernel/linejig.js';
createFigure({ id, center, fit: { points }, ASSEMBLY, model(K, st) { ... }, state(K) { ... }, HERO: { onHover, onLeave, onClick } });
内核拥有相机和适配、调色板和样式、圆角棱柱和画家填充、线宽和 0.5 像素宽度、缓动和弹簧动画、两种开场、轨道控制、缩放、点击测试、光标、减少运动、捕获钩子、嵌入契约、动作事件(HERO.action,当英雄部件的移动达到打开状态时触发,以便空状态或引导步骤可移交至宿主页面)以及 ?mode=turntable(无鼠标交互,用于加载屏幕和录制循环的慢速旋转)。导入 https://linejig.com/kernel/linejig.js 并链接 https://linejig.com/kernel/linejig.css,同时附带 Three.js 导入映射,如 scripts/starter.html 所示。品牌和点阵风格属于 Linejig Pro,位于其旁边的 linejig-pro.js 中:内核会在需要时自动加载该文件一次,仅当图形要求使用品牌或点阵风格时,因此线条艺术页面永远不会下载它。要查看已完成图形,请从画廊打开并阅读其源码。
风格
此技能默认绘制线条艺术(references/styles.md),即内核的默认风格:仅黑白两色,灰色渐变,英雄部件使用 hi 色调,无文字。品牌和点阵风格(英雄部件使用品牌颜色;图形呈现为点阵)来自 Linejig Pro 技能(https://linejig.com/pricing)。如果已安装该技能,则遵循其规则;否则,以线条艺术风格绘制。无论哪种风格,模型、装配和英雄部件均相同,因此在此制作的图形适用于所有风格。
外观简述
完整规则和数值见 references/drawing.md。
- 少量圆角实体。 使用少量圆角足迹(圆角矩形、圆形)挤出为棱柱来构建物体。每个棱柱显示其剪影和一个紧贴顶部边缘的折痕环。使用足够多的零件(通常 8 到 12 个)使物体能明确辨识为该物体,并将次要细节(刻度、接缝、玫瑰点)以低调的
lo线条呈现,而非增加更多重量。 - 单一相机。 正交 2:1 轴测:方位角 45°,仰角正弦值 0.5。物体居中,约占 5:4 画板的 60% 至 75%。
- 使用底色填充。 每个面以画板颜色填充,并从后往前绘制,以便近处零件遮挡远处零件。
- 统一线宽。 所有线条在屏幕上约为 1 px,任何尺寸下均如此(Three.js
LineMaterial,worldUnits: false)。当绘图密集时,用一根线代替两根;若确实需要第二根线,其宽度在lo中约为 0.5 px。 - 黑白两色。 亮色主题下使用近乎白色的画板,暗色主题下使用近乎黑色的画板,以及灰色渐变。无颜色。
- 仅通过色调建立层次。 五种色调:
plate(底色和填充)、edge(剪影)、mid(默认线条)、lo(暗淡和背景线条)以及hi,即唯一明亮的强调色,用于唯一重要的零件。此外还有虚线引导线和点。绘图不设置其他颜色。
英雄部件
每幅插画有一个英雄部件,或一组工作方式相同的相同部件家族(如键盘的按键):即承载信息的部件(指南针的指针、保险箱的盖子、钥匙、天平横梁)。在思考阶段决定它,在构建前写出:“物体 Z,英雄部件 H,因为……”。英雄部件是 hi 色调部分,执行唯一动作,并且是唯一响应用户交互的部件。其他所有部件保持简单静止,仅随用户旋转或缩放整个物体而移动。
交互简述
完整规则见 references/interaction.md。开场动画结束后:
- 旋转: 拖拽可在限定范围内旋转相机,约 2 秒后弹回默认视角。
- 缩放: 滚轮或捏合,以指针为中心,0.8 倍至 2.5 倍;双击重置。线条保持 1 px。
- 英雄部件: 悬停时,英雄部件以现实方式响应(如指针像磁铁一样转向鼠标,离开后弹回);点击则给予一次推动。光标是唯一提示:无文字、无 UI。
动效简述
完整规则见 references/motion.md。
- Three.js 0.160.0,Line2 / LineSegments2 粗线,固定,附带导入映射(内核处理其余部分)。
- 开场动画由用户选择,默认
stack:draw(线条逐笔绘制)或stack(物体从地面逐层搭建),更多创意见references/motion.md。提供INTRO设置,可通过?intro=覆盖。 - 一个有意义的动作, 且只执行一次:开场动画播放完毕后,物体执行其设计动作(指针定位、盖子升起、钥匙转动、望远镜旋转),或者镜头推近或平移。
- 时序。 离散移动使用 700 ms 缓动,曲线为
cubic-bezier(.32,.72,0,1);需要轻微超调并稳定的动作(如指针)使用弹簧动画(k 100,c 18,m 1)。线条绘制约 1200 ms,从左到右。 - 以最终图形结束。 保持静止或极慢速空转(每分钟一两度)。
- 减少运动(
prefers-reduced-motion或?reduced=1):立即显示最终状态。 - 捕获钩子:
?freeze=MS在开始后 MS 毫秒停止时钟;?click=ID@MS在 MS 毫秒时点击英雄部件。
工作流程
- 思考(见上文):信息、物体、英雄部件、其唯一动作及悬停响应。对于
stack开场,还需写出物体的装配表(类型、基底、每个零件的安装面及from方向;参见references/motion.md,“规划堆叠”)。 - 基于内核从
scripts/starter.html开始构建:用你自己的模型、ASSEMBLY和HERO替换占位内容(将英雄部件的行标记为hero: true),分配色调,设置移动。切勿将内核代码复制到图形文件中。 - 在移动的开始、中间和结束位置,以两种调色板、桌面和手机宽度渲染冻结帧(
references/verify.md)。仔细检查;修复并重新渲染。 - 检查控制台是否有错误。使用固定库版本发布。
- 锁定到画廊中(仅在源仓库中工作时适用),在用户批准后(他们说已锁定、最终版或已批准)。在源仓库的
site/<id>/index.html中构建,然后向画廊清单site/illustrations.json中添加一个条目(id、name、path、category、message、hero、hover、click、intros、locked、date和可选的action: {id, label}(当英雄部件移交时)),无其他内容;画廊位于site/library.html,按category(清单中的categories列表)分组。要在批准前向用户展示图形,请以locked: false添加:画廊会将其标记为草稿(?drafts=0隐藏草稿)。批准后,设置locked: true,推送并重新部署站点的 Vercel 项目。内核保留嵌入契约,因此画廊可以驱动每个图形。
与现有项目配合使用
大多数图形会嵌入已有视觉风格的产品中。完整说明见 references/integration.md。
- 在组件库上(如 shadcn/ui 或任何基于 token 的主题):图形所在的表面 token 成为画板(
?plate=<light>,<dark>),墨色保留内核的灰色渐变,框架以 5:4 比例置于卡片中,基于 class 的深色模式通过?theme=和theme消息传递。 - 从用户自己的插画或 SVG: 读取其中的物体及其零件,将每个形状重建为内核足迹(内核没有 SVG 导入,因此不会自动描摹任何内容),丢弃小细节和所有文字,选择英雄部件,并像任何其他图形一样赋予其悬停和点击交互。
源仓库
画廊、内核源码和图形页面位于 Linejig 源仓库中(site/kernel/linejig.js、site/<id>/、site/illustrations.json)。标记为“仅在源仓库中工作时适用”的步骤仅在那里适用;其他地方,请从 https://linejig.com/kernel/ 导入已发布的内核。
经验教训(不可重犯)
- 浅薄的想法会被拒绝, 无论画得多好。先思考。
- 细节不等于质量。 早期绘图带有铆钉、条带和三种线宽;更简单的线条艺术在缩略图下更易阅读,动画也更干净。
- 不得使用 AI 生成 绘图或动效;用户已拒绝。
- 停止未显示的内容。 一个持续运行的绘图曾覆盖在其他幻灯片上(如一个天平衡量图形出现在演示文稿中)。当插画离开时,隐藏它并停止其循环。
参考资料
references/metaphors.md:为信息选择合适的物体,附带示例集合。references/drawing.md:相机、圆角棱柱、画家填充、统一线宽、五种色调、调色板。references/motion.md:移动、时序、弹簧、线条绘制、减少运动、移交。references/styles.md:线条艺术、英雄部件、地面网格、Pro 风格位置。references/interaction.md:英雄部件、悬停和点击响应、轨道、缩放、点击测试、光标。references/verify.md:无头 Chrome 捕获、冻结帧、控制台错误。references/integration.md:基于组件库(token、卡片、深色模式)及从用户自己的插画或 SVG 集成。- https://linejig.com/kernel/linejig.js:内核;其头部即为 API。
- https://linejig.com/illustrations.json:画廊清单;每个条目的
path为可读取的图形页面。 scripts/starter.html:一个基于内核的简易图形,含占位物体。可打开它,或使用?freeze=MS捕获。