paper-signal

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Paper Signal

Turn a subject or source into a complete visual production: understand it, choose a subject-aware minimal-zine composition, save the final prompt, render the bitmap, and judge the actual image rather than the intention.

将主题或素材转化为完整的视觉作品：理解主题，选择适配主题的极简Zine构图，保存最终提示词，渲染位图，并基于实际生成的图像而非预期进行评判。

Route the job

任务路径规划

Read
```
manifest.yaml
```
.
Read every file listed under
```
always_load
```
.
Select one delivery route:
- ```
single-card
```
  — one poster, cover, landscape treatment, portrait, object plate, or concept image.
- ```
restyle-existing
```
  — one or more supplied images are edit targets.
- ```
new-series
```
  — a social carousel, visual essay, story sequence, or evidence-led card set.
Select one subject route from
```
references/subject-routing.md
```
before choosing a layout.
Read only the route-specific and on-demand references needed for the job.
State the detected delivery route, subject route, and intended deliverables in one short user-facing line before production.

Default to

single-card

for a theme, sentence, scene, person, place, object, or one supplied photo. Default to

new-series

only when the user asks for several images or supplies content that clearly needs a sequence. Use

restyle-existing

when preservation of an existing image is the primary goal.

读取
```
manifest.yaml
```
文件。
读取
```
always_load
```
项下列出的所有文件。
选择一种交付路径：
- ```
single-card
```
  —— 单张海报、封面、风景处理图、人像、物品图或概念图。
- ```
restyle-existing
```
  —— 将一张或多张提供的图像作为编辑目标。
- ```
new-series
```
  —— 社交媒体轮播图、视觉随笔、故事序列或基于证据的卡片组。
在选择布局前，从
```
references/subject-routing.md
```
中选择一个主题路径。
仅读取完成任务所需的路径特定参考资料和按需参考资料。
在开始制作前，用一句简短的面向用户的语句说明检测到的交付路径、主题路径及预期交付内容。

如果是主题、句子、场景、人物、地点、物品或单张提供的照片，默认选择

single-card

。仅当用户要求生成多张图像或提供的内容明显需要序列展示时，默认选择

new-series

。当保留现有图像是主要目标时，选择

restyle-existing

。

Non-negotiable contract

不可妥协的规则

Preserve the subject before styling it. A landscape must still feel spatial, a portrait must retain identity, and a product or object must keep its defining form.
Preserve factual and semantic invariants when editing. Never invent or silently alter text, numbers, labels, identity, architecture, product features, or scene-defining details.
Use
```
minimal-zine-standard
```
as a material kernel, not a universal template. Choose an adaptive composition mode; do not force every subject into one tiny central data cluster.
Build texture from one plausible reproduction process. Do not simulate quality by piling random scratches, tape, coffee stains, and generic grunge onto a clean design.
Use real language or intentional abstraction. Never add faux Japanese/Korean characters, fake archival codes, fake coordinates, or meaningless pseudo-text to manufacture atmosphere.
Keep public source labels hidden by default while retaining provenance internally when facts or licensed material are involved.
Separate truth, interpretation, and voice. Never invent a rating, quote, review consensus, first-hand experience, or source.
Save the exact final prompt to
```
prompts/NN-{role}-{slug}.md
```
before generation.
Use a runtime-native raster image tool. In Codex, use the built-in
```
imagegen
```
skill/tool; do not substitute SVG, HTML, canvas, or programmatic poster rendering.
Never repair generated text by painting over the bitmap. Reduce text, correct the prompt, and regenerate to a versioned output.
Preserve user files and generated candidates. Never overwrite an existing artifact without a versioned sibling or timestamped backup.

先保留主体特征，再进行风格化处理。风景图必须保留空间感，人像必须保留身份特征，产品或物品必须保留其标志性形态。
编辑时保留事实和语义不变量。不得凭空创造或擅自修改文字、数字、标签、身份信息、建筑结构、产品特征或场景关键细节。
将
```
minimal-zine-standard
```
作为核心材质基准，而非通用模板。选择自适应构图模式，不得将所有主题强行套入单一的小型核心布局。
基于一种合理的复刻工艺构建纹理。不得通过在简洁设计上叠加随机划痕、胶带痕迹、咖啡渍或通用污渍来模拟质感。
使用真实语言或刻意的抽象表达。不得添加伪日文/韩文、虚假档案编码、虚假坐标或无意义的伪文本营造氛围。
默认隐藏公开来源标签，但涉及事实或授权素材时需在内部保留来源信息。
区分事实、解读和观点。不得凭空创造评分、引用、评论共识、第一手体验或来源。
在生成前将最终的精准提示词保存至
```
prompts/NN-{role}-{slug}.md
```
。
使用运行时原生光栅图像工具。在Codex中，使用内置的
```
imagegen
```
技能/工具；不得替换为SVG、HTML、canvas或程序化海报渲染。
不得通过涂抹位图修复生成的文字。应精简文字、修正提示词并重新生成带版本号的输出结果。
保留用户文件和生成的候选图像。不得在没有版本副本或时间戳备份的情况下覆盖现有成品。

Production workflow

制作工作流

1. Resolve the brief

1. 明确需求

Extract the intended use, subject, mood, audience, output count, aspect ratio, exact visible text, edit invariants, reference-image roles, and any factual or rights constraints.

Use these defaults when the request leaves them open:

delivery route:
```
single-card
```
subject route: infer from
```
references/subject-routing.md
```
aspect ratio: preserve the edit target; otherwise
```
3:4
```
for social cards and
```
3:5
```
for standalone posters
visible text: one short phrase or none
public source labels: hidden
preset:
```
minimal-zine-standard
```
anchor hue: derive from the subject; cobalt is the fallback

Load the first available preference file, if present:

```
.paper-signal/PREFERENCES.md
```

${XDG_CONFIG_HOME:-$HOME/.config}/paper-signal/PREFERENCES.md

When a file exists, read

references/preferences.md

and apply its contract. Preferences refine the brief but never override the current request.

提取预期用途、主题、氛围、受众、输出数量、宽高比、明确可见的文字、编辑不变量、参考图像作用以及任何事实或权限约束。

当请求未明确以下内容时，使用默认值：

交付路径：
```
single-card
```
主题路径：从
```
references/subject-routing.md
```
推断
宽高比：保留编辑目标的比例；否则社交媒体卡片使用
```
3:4
```
，独立海报使用
```
3:5
```
可见文字：一句简短短语或无
公开来源标签：隐藏
预设：
```
minimal-zine-standard
```
主色调：从主题推导；默认使用钴蓝色

加载首个可用的偏好设置文件（如果存在）：

```
.paper-signal/PREFERENCES.md
```

${XDG_CONFIG_HOME:-$HOME/.config}/paper-signal/PREFERENCES.md

当文件存在时，读取

references/preferences.md

并应用其规则。偏好设置用于细化需求，但不得覆盖当前请求。

2. Inspect and classify inputs

2. 检查并分类输入内容

For each image, label it

edit-target

style-reference

content-reference

, or

series-anchor

. Inspect local images with

view_image

before editing or using them for detailed art direction.

For an existing photo, record the subject, crop, horizon or pose, identity, light, key colors, text, and protected details. For a new image, extract one imageable core rather than illustrating every idea.

为每张图像标记

edit-target

、

style-reference

、

content-reference

或

series-anchor

。在编辑或用于详细艺术指导前，使用

view_image

检查本地图像。

对于现有照片，记录主题、裁剪范围、地平线或姿态、身份特征、光线、关键色彩、文字及需保护的细节。对于新图像，提取一个可视觉化的核心内容，而非展示所有想法。

3. Choose subject and composition modes

3. 选择主题与构图模式

Read

references/subject-routing.md

, then apply

references/visual-language.md

and select a preset from

references/presets.md

Choose one composition mode that serves the subject:

```
airy-fragment
```
```
photo-window
```
```
panorama-strip
```
```
dual-frame
```
```
specimen-plate
```
```
portrait-archive
```
```
type-object
```

Lock paper family, reproduction process, type character, anchor hue, and texture intensity. Let image scale, crop, and negative space adapt to the selected mode.

阅读

references/subject-routing.md

，然后应用

references/visual-language.md

并从

references/presets.md

中选择一个预设。

选择一种适配主题的构图模式：

```
airy-fragment
```
```
photo-window
```
```
panorama-strip
```
```
dual-frame
```
```
specimen-plate
```
```
portrait-archive
```
```
type-object
```

锁定纸张类型、复刻工艺、字体特征、主色调和纹理强度。让图像尺寸、裁剪范围和留白适配所选模式。

4. Add editorial structure only when needed

4. 仅在必要时添加编辑结构

For a series, read

references/content-architecture.md

and plan the swipe rhythm before styling. For facts, reviews, data, rankings, or source documents, create

evidence.json

using

references/evidence-ledger.md

. For personal sharing or recommendation copy, apply

references/human-voice.md

Do not make a single landscape, portrait, object, or mood poster carry a social-card evidence workflow it does not need.

对于系列内容，阅读

references/content-architecture.md

并在风格化前规划滑动节奏。对于事实、评论、数据、排名或源文档，使用

references/evidence-ledger.md

创建

evidence.json

。对于个人分享或推荐文案，应用

references/human-voice.md

。

不得让单张风景、人像、物品或氛围海报承载其不需要的社交媒体卡片证据工作流。

5. Create a reproducible project

5. 创建可复现的项目

For a project that needs an artifact trail, run:

bash

python scripts/init_project.py <topic-slug> --path <parent-directory> --cards <count> \
  --subject <subject-route> --composition <composition-mode>

Use a 2-5 word lowercase kebab-case slug. Create a versioned sibling when the directory exists. Follow

references/project-schema.md

对于需要成品追踪的项目，运行：

bash

python scripts/init_project.py <topic-slug> --path <parent-directory> --cards <count> \
  --subject <subject-route> --composition <composition-mode>

使用2-5个单词的小写短横线命名格式（kebab-case）作为slug。当目录已存在时，创建带版本的同级目录。遵循

references/project-schema.md

规范。

6. Compile and save prompts

6. 编写并保存提示词

Read

references/prompt-compiler.md

. Save only the compact final image prompt that will reach the raster model. Use four paragraphs:

canvas, paper field, adaptive image geometry, and protected crop/safe zones
subject, spatial or identity invariants, and one physical image treatment
exact sparse text, type behaviour, anchor hue/form, and valid print defects
emotional temperature, flat-material finish, and targeted hard avoids

When editing, repeat the preservation clause in every prompt. Keep text short enough for image generation.

阅读

references/prompt-compiler.md

。仅保存将发送至光栅模型的精简最终图像提示词。使用四段式结构：

画布、纸张基底、自适应图像几何结构及受保护的裁剪/安全区域
主题、空间或身份不变量，以及一种实体图像处理工艺
明确的简约文字、字体样式、主色调/形态及合理的印刷瑕疵
情感基调、哑光材质质感及需严格避免的元素

编辑时，需在每个提示词中重复保留主体特征的条款。文字需简短到适合图像生成。

7. Confirm once, then render

7. 确认后再渲染

Before rendering, show the route, subject route, composition mode, preset, hue, output count, edit invariants, and output directory. Ask for confirmation unless the user explicitly requested direct generation or default execution.

Then:

Generate a single image without an unnecessary series reference.
For a series, accept card 1 as the material anchor before generating later cards.
Generate each distinct image with a distinct call; use the accepted anchor as a style reference when supported.
Keep batches to four or fewer calls.
Inspect every result at full size and thumbnail size.
Retry a failed image once with one targeted correction.
Copy selected project-bound outputs into
```
outputs/
```
with stable filenames.

渲染前，展示路径、主题路径、构图模式、预设、色调、输出数量、编辑不变量及输出目录。除非用户明确要求直接生成或默认执行，否则需请求确认。

随后：

生成单张图像，无需不必要的系列参考。
对于系列内容，先确认第一张卡片作为风格基准，再生成后续卡片。
每张独特图像使用独立调用生成；若支持，使用已确认的基准作为风格参考。
批量调用不超过4次。
以全尺寸和缩略图尺寸检查所有结果。
失败的图像可针对性修正后重试一次。
将选中的项目绑定输出复制到
```
outputs/
```
目录，使用稳定的文件名。

8. Audit and deliver

8. 审核并交付

Apply

references/quality-contract.md

, then run the project validator when a project manifest exists:

bash

python scripts/validate_project.py <project-directory> --require-images

Return the rendered images inline, absolute output paths, final prompt or prompt directory, detected modes, validation result, and honest caveats. Include caption and evidence files only when that route required them.

应用

references/quality-contract.md

规则，若存在项目清单则运行项目验证器：

bash

python scripts/validate_project.py <project-directory> --require-images

返回内嵌的渲染图像、绝对输出路径、最终提示词或提示词目录、检测到的模式、验证结果及真实的说明。仅当对应路径要求时，才包含说明和证据文件。

Failure policy

故障处理规则

Subject lost under styling: restore crop, silhouette, horizon, face, or defining object geometry; reduce graphic intervention.
Output resembles a generic clean poster: introduce one real image-bearing fragment, imperfect ink edges, and paper-specific tonal variation; simplify the layout.
Output resembles a scrapbook: remove decorative layers until one reproduction process and one anchor relation remain.
Image feels too empty for the subject: move from
```
airy-fragment
```
to
```
photo-window
```
,
```
panorama-strip
```
,
```
portrait-archive
```
, or
```
dual-frame
```
; do not fill space with arbitrary text.
Image feels like a dashboard: retain one decision-worthy signal, collapse boxes into printed fragments, and move nuance to the caption.
Garbled text: shorten or remove exact strings and regenerate; never overlay replacements.
No raster backend: report the blocker and return saved prompts; do not silently ship code-rendered substitutes.

风格化后丢失主体特征：恢复裁剪范围、轮廓、地平线、面部或物品标志性形态；减少图形干预。
输出类似通用简洁海报：添加一个真实的图像片段、不完美的墨边及纸张特有的色调变化；简化布局。
输出类似剪贴簿：移除装饰层，直到仅保留一种复刻工艺和一种基准关联。
图像相对于主题过于空旷：从
```
airy-fragment
```
切换为
```
photo-window
```
、
```
panorama-strip
```
、
```
portrait-archive
```
或
```
dual-frame
```
；不得用任意文字填充空间。
图像类似仪表盘：保留一个有决策价值的核心信息，将框体合并为印刷片段，把细节移至说明文字。
文字混乱：缩短或移除明确字符串并重新生成；不得覆盖替换。
无光栅后端支持：报告障碍并返回已保存的提示词；不得静默交付代码渲染的替代内容。

Reference map

参考资料映射

```
manifest.yaml
```
: route and progressive-loading map.
```
references/core-workflow.md
```
: production state machine.
```
references/subject-routing.md
```
: subject detection, preservation rules, and mode selection.
```
references/visual-language.md
```
: universal Paper Signal material and composition kernel.
```
references/presets.md
```
: controlled material variants.
```
references/prompt-compiler.md
```
: subject-aware prompt grammar.
```
references/restyle-contract.md
```
: existing-image invariants.
```
references/content-architecture.md
```
: social-series pacing and card budgeting.
```
references/evidence-ledger.md
```
: factual provenance.
```
references/human-voice.md
```
: truthful conversational copy.
```
references/quality-contract.md
```
: visual, factual, and delivery QA.
```
references/project-schema.md
```
: manifest and file schemas.
```
references/preferences.md
```
: optional project/user defaults and precedence.

```
manifest.yaml
```
：路径与渐进式加载映射。
```
references/core-workflow.md
```
：制作状态机。
```
references/subject-routing.md
```
：主题检测、保留规则及模式选择。
```
references/visual-language.md
```
：Paper Signal通用材质与构图核心规范。
```
references/presets.md
```
：受控材质变体。
```
references/prompt-compiler.md
```
：适配主题的提示词语法。
```
references/restyle-contract.md
```
：现有图像不变量规则。
```
references/content-architecture.md
```
：社交系列内容节奏与卡片规划。
```
references/evidence-ledger.md
```
：事实来源记录。
```
references/human-voice.md
```
：真实对话式文案规范。
```
references/quality-contract.md
```
：视觉、事实与交付质量审核。
```
references/project-schema.md
```
：清单与文件规范。
```
references/preferences.md
```
：可选项目/用户默认设置及优先级。