← Back to Skills Marketplace
fslong520

笔痕

by fslong · GitHub ↗ · v1.3.0 · MIT-0
cross-platform ✓ Security Clean
38
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install brushtrace
Description
小说章节配图生成器。自动检索项目中的角色设定和已有插画,为指定章节生成风格统一、角色一致的插图Prompt。AI按需判断是否添加漫画文字层(无气泡无字框)。
README (SKILL.md)

笔痕 - 小说章节配图生成器

这个技能是做什么的?

一句话:输入章节或情节片段,输出1-3个结构化插画Prompt。

工作流程

输入章节 → 搜角色档案 → 锁定风格 → 【基调分析】→ 选配图节点 → 输出结构化Prompt

输出格式

  • Markdown 结构化版(可直接嵌入章节注释)
  • JSON 版(便于程序调用/二次编辑)
  • 纯文本版(便于直接复制到绘图工具)

思考维度框架(12 维度)

场景插图不同于角色立绘——核心不是"角色长什么样",是"这一刻发生了什么"。

〇、基调层(1 维度)——先于一切

维度 思考问题 示例方向
tone 这段情节的情绪底色是什么? 发点糖/刀/燃/虐/诙谐/悬疑/温暖

基调决定一切。同样是灯下对视——恋爱喜剧的用光是粉橘色柔光,悬疑片的用光是冷白侧光,悲剧的用光是夕阳逆光。同一段文字可以出十种不同情绪的图,AI要选的不是"最准确的",是"最匹配小说这一章情绪的"。

一、叙事层(2 维度)

维度 思考问题 示例方向
subject 这幅画在说什么?用一句话概括 "有人在她睡着时无声潜入,留下了一碗水"
moment 选在动作的哪一瞬间定格? 触碰前一刻/对话中沉默的间隙/火焰蔓延的顶点

二、角色层(1 维度)

维度 思考问题 示例方向
characters 画面中有谁?每个角色的面容/姿态/服装/位置关系 每个角色内嵌 age/face/pose/hair/costume

三、环境层(3 维度)

维度 思考问题 示例方向
environment 场景在哪?有什么器物暗示故事背景? 据点卧室/书库废墟/地下通道
lighting 光从哪来?什么色温?有什么特别的光影? 门缝光/烛火/天光破口/冷白顶光
dynamics 画面中有什么在动? 水汽/火焰/飘落的灰烬/翻飞的纸页

四、视觉层(3 维度)

维度 思考问题 示例方向
composition 镜头类型?主体位置?纵深关系? 俯角近景/中景平视/黄金分割/剪影
color 主色?辅色?对比色?冷暖倾向? 暗蓝与暖黄/冷白与暖橙/全暖调赭褐
style 艺术风格?技术特征? 新海诚动漫风/精细水汽/电影感光影

五、控制层(2 维度)

维度 思考问题 示例方向
negative 避免什么? 写实照片感/恐怖感/过度卡通/脏乱
aspect_ratio 用途决定比例 16:9 宽幅/4:3 传统/3:4 竖版

六、文字层(1 维度)——按需

维度 思考问题 示例方向
text_layer 这幅画需要文字吗?放在哪?什么字体?什么效果? 旁白/拟声词/手写体/墨迹调

AI自行判断是否添加文字层。若场景有此需要(如关键台词、拟声词增强画面冲击力),按以下规范描述:

文字层分二型:

  • 旁白——嵌入场景的叙事文字/对话,无气泡无框,如"活着的人总要吃早饭"浮在灶火旁的暗部
  • 拟声词——嵌入场景的动作/声音文字,如"十二米"沿纸锋弧线排列,墨色含金芒

:白底字框、对话气泡尾巴、圆角方框透明底、任何形式的独立文字容器。

若需文字层,定义如下:

文字层
├── type: 旁白/拟声词
├── position: 在画面中的位置(越具体越好)
├── content: 具体文字内容
├── font: 字体风格描述(手写/印刷、粗细、墨色)
└── effect: 与场景融合的效果(如"字色与灶火余烬同温"、"边缘有金芒粒子消散")

层级化描述法则

每个维度的描述遵循三层结构:

维度名称
├── 基础描述(一句话定义核心)
├── 特征列表(3-5 个关键词或条目)
└── 细节补充(可选,具体参数)

美学深度框架(三层递进)

每幅小说配图应追求三层递进的美学深度:

第一层:悦目层(画面美感)

  • 视觉完成度:色彩协调、光影层次、构图张力
  • 场景真实感:器物、服饰、环境的时代/世界观一致性
  • 评判标准:画面本身是否"好看"

第二层:悦意层(情感共鸣)

  • 情感准确性:画面情绪是否与章节基调一致
  • 角色情感:表情、姿态是否传达出内心状态
  • 评判标准:读者是否"有感觉"

第三层:悦神层(叙事意味)

  • 深层隐喻:画面是否承载更深层的叙事功能
  • 开放性:留白与想象空间,观者可二次解读
  • 评判值:画面是否"值得回味"

执行建议

生成Prompt时,先确保悦目层达标,再追问:

  • 这幅画的情感内核是什么?(悦意层)
  • 有没有更深层的叙事可能?(悦神层)
  • 画面中的"静"能否暗示"动"?(开放收束)

执行流程

步骤 1:加载小说上下文

搜索项目目录,自行判断哪些文件含有角色描述、风格参考或历史插图记录。读入后建立角色档案。

步骤 2:角色一致性分析

从已读文件中提取每个出场角色的视觉特征。同一角色在不同文件中描述不一致时,以最先建立的插画记录为准。

若无任何角色定义文件,则从章节文本中提取第一印象,生成后将角色特征写入项目供后续复用。

步骤 3:基调分析 ← 新增

判断输入章节的情绪底色——这段情节是甜是虐是燃是悬?从以下维度分析:

  • 用户对本章的直接描述(如"发点糖"、"刀"、"轻松诙谐")
  • 章节中的对话节奏和用词倾向
  • 角色之间的互动模式(打闹/沉默/对抗)
  • 环境描写的情绪暗示(阳光 vs 阴雨 vs 烛火)

确定基调后,后续所有视觉决策必须与基调一致

  • 暖调 → lighting色温偏暖,color主色选金黄/橘/粉
  • 虐/悲 → lighting对比强烈,color偏冷蓝/灰
  • 燃 → lighting高对比,dynamics丰富,color饱和
  • 轻松 → lighting柔和自然,color明亮,composition不压抑

步骤 4:场景分析

分析输入段落的可配图节点,每个节点按五类打分:

节点类型 优先级 说明
情感高潮 ★★★★★ 对话中情感浓度最高的瞬间,角色表情/动作的爆发
关键转场 ★★★★ 角色首次登场、场景切换、重大决定
视觉冲击 ★★★★ 原文中有强烈画面感的描述(火、光、废墟、战斗)
动态瞬间 ★★★ 追逐、打斗、奔跑等有动作性的场景
安静时刻 ★★★ 氛围感强的静止画面(雨、雪、灯下、对视)

每段选1-3个节点,标注优先级和选择理由。选择理由必须与基调挂钩——发点糖章的"安静时刻"选的是暖的安静而非压抑的安静。

步骤 5:风格锁定

读取已有插画的风格关键词。若无已有插画,引导用户确定风格后再生成。同一项目锁定同一套风格标签。

步骤 6:Prompt生成

按13维度框架逐一填充(含按需字段text_layer),输出两种格式。

Markdown 结构化版(嵌入章节注释用):

{
  "tone": "本章情绪底色(决定所有视觉选择的方向)",
  "subject": "一句话概括画面",
  "moment": "定格的瞬间",
  "characters": [{
    "id": "角色名",
    "age": "年龄段",
    "face": "面容特征/表情",
    "pose": "姿态动作",
    "hair": "发型特征",
    "costume": "服装材质/颜色/风格"
  }],
  "environment": {
    "场景": "地点描述",
    "细节": ["特征1", "特征2", "特征3"]
  },
  "lighting": {
    "光源": "方向/类型",
    "色温": "冷暖描述",
    "特征": "特别的光影效果"
  },
  "dynamics": "画面中的动态元素描述",
  "composition": {
    "镜头": "远景/中景/近景/特写/俯仰",
    "焦点": "视觉锚点",
    "纵深": "前后层次关系"
  },
  "color": {
    "主色": "占画面最大面积的颜色",
    "辅色": "次要颜色",
    "对比": "色彩对比关系",
    "倾向": "整体冷暖倾向"
  },
  "style": {
    "风格": "艺术风格",
    "特征": ["技术标签1", "技术标签2"]
  },
  "mood": ["情绪词1", "情绪词2", "情绪词3"],
  "text_layer": [
    {
      "type": "旁白/拟声词",
      "position": "画面中的具体位置",
      "content": "文字内容",
      "font": "字体风格描述",
      "effect": "与场景融合的效果"
    }
  ],
  "negative": ["避免1", "避免2"],
  "aspect_ratio": "宽高比"
}

纯文本版(复制即用):

[风格关键词],[场景描述]。[角色描述]。[环境与光影]。[构图]。[配色]。[特殊效果]。
【文字层】[文字内容与放置说明]——[字体/墨色/融合效果]。
--no [负面避免]
aspect ratio [比例]

可选·英文版(适用于 Midjourney 等英文模型):

[English style keywords], [scene description]. [characters]. [environment and lighting]. [composition]. [color palette]. [special effects].

COMIC TEXT LAYER: [text content and placement description] — [font/ink color/fusion effect].

--no [negative keywords]
aspect ratio [ratio]

步骤 7:重复检查

检索已有插图记录,避免为同一场景重复生成。如确需重出(换风格/换角度),标注"重制"并说明理由。


画面比例说明

比例 用途 说明
16:9 宽幅场景 电影感,适合风景、对峙、全景
4:3 传统叙事 温和舒适,适合对话、日常
3:4 竖版角色 适合单人角色登场、情感特写
2:3 竖版海报 正式角色立绘、封面
9:16 手机竖屏 短视频封面、手机壁纸
1:1 方图 社交媒体、头像

默认逻辑

  • 场景类插图 → 16:9 或 4:3
  • 角色特写 → 3:4
  • 战斗场面 → 16:9
  • 用户指定 → 优先

Principles

原则 说明
基调优先 画面情绪必须与章节基调一致——暖章出暖图,虐章出冷图,不在甜章里制造阴森
角色一致性 同一角色在不同插画中外观必须一致。不一致时以最先建立的插画为准
风格一致性 同一系列插画的风格标签必须一致。用户未指定时以第一批为准
文本优先 画面描述优先基于原文。原文未提供的细节(角度/焦距)由AI补充并标注
文字层按需 AI自行判断是否添加文字层。若加,须遵守就地书写规范——文字像墨迹/刻痕/霜花一样长在画面中,无气泡无字框
就地书写 文字层不可有框体、气泡尾、透明底圆角方框——文字应当像墨迹、刻痕、霜花、灰烬拼字一样直接生长在画面中

AVOID

  • 基调和场景物理环境混为一谈——凌晨两点可以出暖图,正午也可以出冷图
  • 同一角色在不同插画中出现不必要的面貌变化
  • 为平淡叙述段配插图——不是每一个段落都值得配图
  • 过度解读角色情绪——空表情的角色不需要强行加戏
  • 文字内容混入样式参数(font:、size:)
  • 风格飘移——同一项目锁定同一套风格关键词
  • 文字层带任何形式的框体——若加文字层,不可有气泡、白底字框、透明底圆角方框、对话气泡尾巴
  • 文字层若存在,不可追求OCR级清晰——文字作为场景肌理的一部分,而非可精确识别的印刷字体

更新日期: 2026-05-27

变更记录

  • 2026-05-27: v1.2.0 新增文字层维度(text_layer)为按需字段。AI自行判断是否添加。若加,文字直接写在画面中,无气泡无字框。更新JSON模板、纯文本版、英文版输出格式。
  • 2026-05-20: v1.1.0 新增基调分析(tone维度),基调和场景物理环境分离——凌晨两点也可以出暖图,正午也可以出冷图
  • 2026-05-20: v1.0.0 初始版本,11维度场景插画框架
Usage Guidance
Before installing, understand that the skill may read novel project files to infer characters and style, and may write reusable character notes for consistency. Use it in project folders where that local story context is appropriate to inspect.
Capability Assessment
Purpose & Capability
The stated purpose is to generate structured illustration prompts for novel chapters, and the instructions focus on character consistency, style matching, scene selection, and prompt formats.
Instruction Scope
The skill asks the agent to search project files for character descriptions, style references, and prior illustration records, and to write character features if none exist; this is disclosed and aligned with maintaining visual consistency.
Install Mechanism
The artifact is a single Markdown skill file with no executable scripts, package dependencies, installers, or network setup.
Credentials
Read, Glob, Grep, and Write access are proportionate for inspecting and maintaining project-local novel context; Task is declared but the artifact does not instruct background workers or autonomous delegation.
Persistence & Privilege
The only persistence described is saving inferred character features for future reuse inside the project, with no credential handling, external transmission, privilege escalation, or destructive actions.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install brushtrace
  3. After installation, invoke the skill by name or use /brushtrace
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.3.0
融入《美学四讲》三层递进美学深度框架(悦目→悦意→悦神),新增美学深度框架章节
Metadata
Slug brushtrace
Version 1.3.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is 笔痕?

小说章节配图生成器。自动检索项目中的角色设定和已有插画,为指定章节生成风格统一、角色一致的插图Prompt。AI按需判断是否添加漫画文字层(无气泡无字框)。 It is an AI Agent Skill for Claude Code / OpenClaw, with 38 downloads so far.

How do I install 笔痕?

Run "/install brushtrace" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is 笔痕 free?

Yes, 笔痕 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 笔痕 support?

笔痕 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 笔痕?

It is built and maintained by fslong (@fslong520); the current version is v1.3.0.

💬 Comments