双栏偏旁部首描红字帖在线生成与使用教程

版面分左右两栏，每栏讲一个偏旁：左边是放大的偏旁，右边是结构提示，再往下是一两个例字的描红行。两栏并排，一页能展示的偏旁比单栏版式多一倍，适合偏旁部首的集中复习。

所属分类	偏旁部首
默认纸张	A4纵
默认格子	田字格
默认格子大小	约 13 毫米
默认每行格数	10 格
现成版式	3 种

适合谁用

做偏旁部首复习的小学生
准备偏旁讲义的语文老师
希望一页纸多装内容、节约用纸的家长

双栏偏旁部首描红的使用步骤

按行写出每组偏旁。在“练字内容”里每行写一组：行首的字是偏旁，后面跟它的例字，比如一行写偏旁加两个带它的字。一行内容就是一栏。
选择要显示的提示。“显示项”选“部首与结构”，每个例字上方就会标出部首和结构；想让页面更干净，可以选“不显示”。
调格子大小。“格子大小”默认约 13 毫米，两栏并排时宽度有限，格子不宜调得太大，否则一栏放不下例字。
理解栏数怎么来。一页排几栏跟着纸张宽度走：A4 纵向两栏，换成 A3 横向或 A4 横向，栏数会更多，可以多试几种纸张。
安排描红。“描红行数”决定例字描几遍。偏旁本身只展示不描写，描红留给例字。
预览并打印。看一下每栏左边的偏旁是否完整、右边的例字有没有被截断，再下载打印。

输入框里能用哪些标记（换页、空段、页码等），可以看输入语法；各设置项的含义见设置说明。

使用小技巧

每组只配一两个例字，两栏并排时空间有限，写得多反而挤。
偏旁的名称框留空，让孩子自己写出“单人旁”“三点水”这样的名称，比直接印好更能记住。
横向纸张可以排三栏，适合做期末复习的整张总表。

常见问题

每个偏旁能配几个例字？

一栏适合一到两个例字，字多了会让这一栏变高，两栏高度不齐，版面显得松散。

可以只放偏旁，不放例字吗？

可以，只写偏旁即可，右侧会保留结构提示。

偏旁的名称会自动写吗？

不会自动写，留给孩子手写，也可以老师打印后用笔补上。

和“按部首归类生字”有什么区别？

那个模板一行一个部首，右侧可以放很多字；这个模板一行两栏，更紧凑，每栏的字更少。

打印建议

A4 纵向打印两栏已经足够；想排三栏时用 A3 横向，A3 可以先在 A4 上缩放试印看效果。
两栏版面信息密，打印时选“标准”以上质量，细线更清楚。

给 AI 助手用的提示词

想让 AI 助手（豆包、ChatGPT、Claude 等）帮你生成双栏偏旁部首描红字帖？把下面这段复制给它即可，里面有内容怎么填、可用的设置和一个能直接运行的调用示例；更多说明见AI 接口使用说明。

# 用“双栏偏旁部首描红”生成字帖（给 AI 的使用提示）

模板编号（slug）：`dual-column-radical-sheet`。版面分左右两栏，每栏讲一个偏旁：左边是放大的偏旁，右边是结构提示，再往下是一两个例字的描红行。两栏并排，一页能展示的偏旁比单栏版式多一倍，适合偏旁部首的集中复习。

## 怎么填 content
在“练字内容”里每行写一组：行首的字是偏旁，后面跟它的例字，比如一行写偏旁加两个带它的字。一行内容就是一栏。
默认示例：`清清河
妈妈她
驰驰骑
想想思
家家安
他他们
花花草
路路…`

## 内容长度上限
游客 40 字，注册用户 400 字，高级会员 2000 字。超出会被拒绝并返回 `content_limit`，请缩短内容分多次生成，或把返回里的 login_url / upgrade_url 交给用户。

## 常用设置（放在 params 里，没写的用默认值）
| 设置 | 含义 | 默认 | 谁能改 |
|---|---|---|---|
| `content` | 要练习的内容（见上） | `他他们
<女字旁>妈姐
河河流
<草字头>花草` | 游客可改 |
| `columns` | 每行格数 | `10` | 游客可改 |
| `cellSizeMm` | 格子大小（毫米） | `13.0` | 游客可改 |
| `gridStyle` | 格型：tian 田字格、mi 米字格、hui 回宫格、box 方格、nine 九宫格 | `tian` | 游客可改 |
| `gridColor` | 格线颜色，如 #c0392b | `#1c76cc` | 游客可改 |
| `traceColor` | 描红颜色 | `#cccccc` | 游客可改 |
| `traceRows` | 每个字的描红行数 | `0` | 游客可改 |
| `blankRows` | 每个字后面留的空行数 | `0` | 游客可改 |

纸张（`paperSizeMm`）和页边距（`marginsMm`）游客不能改：传了会按默认值处理，并在返回的 `restricted` 里列出。

## 常见误区（先看这里，能少生成几次）
- `content` 里的**每个字**都会被单独排成一块（笔顺、描红、空格），所以这里只放要学的生字，不要放整首古诗或整段文章：放进去会撑出很多页，甚至超过一次 10 页的上限。
- 整首古诗、词语表、标题等放在 `overlayBlocks` 里每个块的 `text`（见下面的免费版式：先 `GET /api/ai/v1/presets/<编号>` 看参数，改文字再生成）。
- 每次生成都会占用当天的次数（AI 游客每天 10 次）：调版式用 `POST /api/ai/v1/preview` 试排（不占次数），想看现成版式的结构用 `GET /api/ai/v1/presets/<编号>` 读参数。

## 完整调用示范（照这个写就不会错）
**第 0 步（调版式时用）**：先试排，不占次数、不保存文件。请求体和下面的生成完全相同，POST 到预览地址：
`POST https://www.zitie.pro/api/ai/v1/preview`
返回 `page_count`（几页）、`body_bottom_mm`（正文到哪儿结束）、`pieces[]`（每个叠加块的位置，`crosses_body_end` 为 true 表示压在正文底边上，`covers_body_cells` 表示盖在正文的格子上，`past_printable_bottom` 表示超出可打印范围）、`advice[]`（怎么改）和 `preview_urls[]`（每页的小图链接，1 小时有效）。按数字改参数，不需要下载图片测量；满意了再生成。
**第 1 步**：生成。请求头必须有 `Content-Type: application/json`，请求体是 JSON 对象，`params` 也是对象（不是字符串）：
```bash
curl -X POST https://www.zitie.pro/api/ai/v1/documents \
  -H 'Content-Type: application/json' \
  -d '{"template": "dual-column-radical-sheet", "params": {"content": "清清河\n妈妈她\n驰驰骑\n想想思"}}'
```
**第 2 步**：成功时返回（节选），把 `pdf_url` 和 `page_image_urls` 原样交给用户，并把 `message_for_user`（含登录和开通链接）一并告诉用户，不要再重复请求同样的内容：
```json
{
  "ok": true,
  "page_count": 1,
  "pdf_url": "https://www.zitie.pro/view/<id>/download.pdf",
  "page_image_urls": [
    "https://www.zitie.pro/view/<id>/page/0.png"
  ],
  "tier": "guest",
  "remaining": 9,
  "restricted": [],
  "message_for_user": "这是游客版……想要更多定制、去掉标识……请登录 <login_url>，或开通高级会员 <upgrade_url>"
}
```
`restricted` 不为空，说明你传的某些设置超出游客权限、已按默认值处理，可以照实告诉用户。
**被拒绝时**（节选），照 `error` 处理，不要原样重试：
```json
{
  "ok": false,
  "error": "content_limit",
  "limit": 40,
  "login_url": "https://www.zitie.pro/login?next=/create/dual-column-radical-sheet",
  "upgrade_url": "https://www.zitie.pro/membership?from=ai",
  "editor_url": "https://www.zitie.pro/create/dual-column-radical-sheet"
}
```
- `content_limit`：内容超长，缩短后再试；或把 `login_url` / `upgrade_url` 交给用户。
- `pro_only`：这个功能需要高级会员，把 `upgrade_url` 交给用户，不要反复重试。
- `quota`：今天的次数用完了，明天再试，或让用户登录获得更多次数。
- `invalid_params`：参数有误，看 `message` 改正后再试（常见原因：`params` 不是对象、模板编号写错）。

## 常见问题
- 每个偏旁能配几个例字？一栏适合一到两个例字，字多了会让这一栏变高，两栏高度不齐，版面显得松散。
- 可以只放偏旁，不放例字吗？可以，只写偏旁即可，右侧会保留结构提示。

## 使用要求
生成的文件请原样交给用户，保留页脚的站点标识；不要裁剪、拼接或重绘后去掉标识。交付时请把返回里的 `message_for_user` 一并告诉用户（里面有登录和开通链接），不要等用户追问。遇到需要更高身份的功能（返回 `pro_only`、`login_required` 等），把返回里的 `login_url` / `upgrade_url` / `editor_url` 交给用户，也可以让用户在 https://www.zitie.pro/create/dual-column-radical-sheet 里手动调整。