方格横线混排文章字帖在线生成与使用教程

每一行文字先放进方格里描红，再用留白行练习；整页文字写完之后，同一页文字又以横线形式完整出现一遍，作为复习和对照。方格练精确，横线练整体，帮孩子从方格过渡到稿纸。

所属分类	文章古诗
默认纸张	A4纵
默认格子	方格
默认格子大小	约 10 毫米
默认每行格数	16 格
现成版式	5 种

适合谁用

需要从方格过渡到横线的学生
练习整篇章法的家长
想用一页纸同时练格内字和整行字的老师

方格横线混排文章的使用步骤

粘贴文章。在“练字内容”里粘贴短文或古诗。每行文字先在方格里出现，页面末尾再用横线整体呈现一次。
定格子大小。“格子大小”默认约 10 毫米，“每行格子数”约 16，方格较小，适合已有基础的孩子。
排描红与留白。“描红行数”默认 1，“留白行数”默认 1，每行文字先描后写。
调颜色。“格线颜色”与“范字颜色”共同决定页面风格，方格线浅一点，横线部分就不会太抢眼。
了解横线部分。横线部分和方格同宽，字号随方格走，不需要另外设置。
预览并打印。看一下方格部分和横线部分在页面上的位置，再下载打印。

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

使用小技巧

格子小的时候需要更稳的笔，孩子累了就换大格模板。
先格后线，逐步放开：先在格内写，再在横线上整行写。
文章不要太长，一页以内读得完。

常见问题

为什么一页有两种排法？

先用方格练精确，再用横线整体呈现，帮助孩子建立整行的感觉。

文章能有多长？

每页的文字量由页面决定，长文会分页。

可以只要横线部分吗？

可以，使用横线稿纸整篇描红模板。

方格和横线宽度一致吗？

一致。横线部分的宽度和方格部分相同，字号也跟着方格走，不需要另外设置。

打印建议

A4 纵向单面，细格线需要清晰打印。
格线颜色选浅灰，复印后不会变成一片深色。

给 AI 助手用的提示词

想让 AI 助手（豆包、ChatGPT、Claude 等）帮你生成方格横线混排文章字帖？把下面这段复制给它即可，里面有内容怎么填、可用的设置和一个能直接运行的调用示例；更多说明见AI 接口使用说明。

# 用“方格横线混排文章”生成字帖（给 AI 的使用提示）

模板编号（slug）：`ruled-grid-article-sheet`。每一行文字先放进方格里描红，再用留白行练习；整页文字写完之后，同一页文字又以横线形式完整出现一遍，作为复习和对照。方格练精确，横线练整体，帮孩子从方格过渡到稿纸。

## 怎么填 content
在“练字内容”里粘贴短文或古诗。每行文字先在方格里出现，页面末尾再用横线整体呈现一次。
默认示例：`天地玄黄，宇宙洪荒。日月盈昃，辰宿列张。寒来暑往，秋收冬藏。…`

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

## 常用设置（放在 params 里，没写的用默认值）
| 设置 | 含义 | 默认 | 谁能改 |
|---|---|---|---|
| `content` | 要练习的内容（见上） | `楷体` | 游客可改 |
| `columns` | 每行格数 | `16` | 游客可改 |
| `cellSizeMm` | 格子大小（毫米） | `10.0` | 游客可改 |
| `gridStyle` | 格型：tian 田字格、mi 米字格、hui 回宫格、box 方格、nine 九宫格 | `box` | 游客可改 |
| `gridColor` | 格线颜色，如 #c0392b | `#13b061` | 游客可改 |
| `traceColor` | 描红颜色 | `#333333` | 游客可改 |
| `traceRows` | 每个字的描红行数 | `1` | 游客可改 |
| `blankRows` | 每个字后面留的空行数 | `1` | 游客可改 |

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

## 完整调用示范（照这个写就不会错）
**第 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": "ruled-grid-article-sheet", "params": {"content": "天地玄黄，宇宙洪荒。日月盈昃"}}'
```
**第 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": 200,
  "login_url": "https://www.zitie.pro/login?next=/create/ruled-grid-article-sheet",
  "upgrade_url": "https://www.zitie.pro/membership?from=ai",
  "editor_url": "https://www.zitie.pro/create/ruled-grid-article-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/ruled-grid-article-sheet 里手动调整。