Community图像github.com

Linejig

一种图像技能,使用 Three.js 绘制交互式 3D 线条插画。每个物体由少量圆角实体构成,采用等距视角(2:1 轴测),统一使用细线宽、黑白灰层次,保持一致的插画风格。物体以堆叠或绘制方式呈现,其核心部件(如指针、盖子、键盘按键)响应悬停和点击,用户可拖拽旋转和缩放。纯插画,无文字、引线或标注。

Linejig 是什么?

Linejig 是一个专注于绘制交互式 3D 线条插画的 AI 技能,基于 Three.js 和 Hairline 图形内核。它遵循严格的视觉规范:每个插画只包含一个物体,由 8-12 个圆角实体(rounded prisms)构建,采用 2:1 轴测正交相机,所有线条统一为 1px 宽度,仅使用黑白灰五色调(plate、edge、mid、lo、hi),无文字、徽标、纹理或渐变色。该技能支持 Claude Code、Cursor 等 AI 编码代理,用户可通过自然语言描述概念,AI 会先提出三个设计概念供选择,然后生成约 100-150 行的 JavaScript 代码,使用 linejig.js 内核创建完整的交互式插画。核心交互包括:用户可拖拽旋转和缩放物体;一个“英雄部件”(hero part)响应悬停(如指针随鼠标转动)和点击(触发动作);开场动画支持“堆叠”(物体从地面逐层搭建)或“绘制”(线条逐笔出现)。Linejig 还支持 Pro 风格(品牌色、点阵图)、深色模式、reduced motion 以及嵌入到现有组件库(如 shadcn/ui)中。生成的作品可锁定到画廊清单中,供嵌入和分享。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/37degree-studio/linejig/tree/HEAD/skills/linejig

Installed? Explore more 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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。

绘制之前:先思考

用户在评估执行力之前先判断创意。

  1. 用一句话说明该图形将置于何物旁边。
  2. 写出三个概念(references/metaphors.md):“物体 Z,英雄部件 H,因为……,其开场方式和唯一动作 M。” 如果某个概念需要文字说明才能理解,则放弃它。推荐一个概念并等待用户选择。
  3. 如果用户提供了参考图,请解释每个参考图在构建前如何发挥作用。

不包含的内容

  • 插画中无文字。 无引线、指示点、零件上的数字、说明文字、标题、标签或“图”标记。如果宿主页面需要文字,那是页面的职责,而非插画的。
  • 无小细节。 无铆钉、条带、交叉线、雕刻、纹理、阴影、渐变或发光。
  • 无 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 毫秒时点击英雄部件。

工作流程

  1. 思考(见上文):信息、物体、英雄部件、其唯一动作及悬停响应。对于 stack 开场,还需写出物体的装配表(类型、基底、每个零件的安装面及 from 方向;参见 references/motion.md,“规划堆叠”)。
  2. 基于内核从 scripts/starter.html 开始构建:用你自己的模型、ASSEMBLY 和 HERO 替换占位内容(将英雄部件的行标记为 hero: true),分配色调,设置移动。切勿将内核代码复制到图形文件中。
  3. 在移动的开始、中间和结束位置,以两种调色板、桌面和手机宽度渲染冻结帧(references/verify.md)。仔细检查;修复并重新渲染。
  4. 检查控制台是否有错误。使用固定库版本发布。
  5. 锁定到画廊中(仅在源仓库中工作时适用),在用户批准后(他们说已锁定、最终版或已批准)。在源仓库的 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 捕获。

相关技能