# 字帖 · ws.zitie.pro

> 在线生成可打印的字帖、描红、笔顺、拼音、算术、英语练习纸（A4 等纸张，PDF / 图片）。61 个模板、620 个现成版式（其中 120 个免费）。

## 先说清楚

- 本站是普通的 HTTP 网站和 HTTP 接口（REST，JSON）。**没有 WebSocket，也没有“AI 输入框”**，不需要浏览器会话凭证（cookie/token）就能调用下面的接口。
- 完整的使用说明（含 curl 示例、错误码）：https://ws.zitie.pro/guide/ai/

## 给 AI 的接口（无需登录即可使用）

- 接口说明（OpenAPI）：https://ws.zitie.pro/api/ai/v1/openapi.json
- 能力与当前身份：GET https://ws.zitie.pro/api/ai/v1/capabilities
- 模板列表：GET https://ws.zitie.pro/api/ai/v1/templates
- 现成版式：GET https://ws.zitie.pro/api/ai/v1/presets?free=1
- 一次调用生成文件：POST https://ws.zitie.pro/api/ai/v1/documents
  请求：`{"template": "stroke-guide-practice", "params": {"content": "山水田"}}`
  返回：`pdf_url`（PDF 下载）、`page_image_urls`（每页图片）、`preview_url`。

## 如果你不能发起 HTTP 请求

请把下面的链接发给用户，用户在浏览器里点开即可（已选好模板和版式，内容在页面里粘贴后点“生成字帖”）：

- 模板页：`https://ws.zitie.pro/create/<模板 slug>`，例如 https://ws.zitie.pro/create/stroke-guide-practice
- 免费版式：`https://ws.zitie.pro/create/<模板 slug>?preset=<f 开头的版式编号>`，例如 https://ws.zitie.pro/create/stroke-guide-practice?preset=f001
- 预填文字：在地址后加 `&content=要练的字`（不带 preset 时用 `?content=...`），页面打开后文字已填好；游客最多 40 个字（字帖类）。

## 每个模板的使用提示词（含可直接运行的调用示例）

- 全部模板合在一起：https://ws.zitie.pro/llms-full.txt
- 单个模板：`GET https://ws.zitie.pro/api/ai/v1/templates/<slug>/prompt`（Markdown），或网页 https://ws.zitie.pro/guide/<slug>/ 里的“给 AI 助手用的提示词”。
- 先读对应模板的提示词再调用，参数和示例都是验证过能跑通的，可以避免调错。

## 怎么按需求定制一个现成版式

1. 找合适的版式：`GET /api/ai/v1/presets?free=1&q=古诗`（标题里写明了版式的内容，如“古诗”“词语”“默写”“横线”）。
2. 取出它的参数：`GET /api/ai/v1/presets/<编号>`，返回的 `params` 里有 `content`（正文：要练的字，`{分页}` 分页）、`gridStyle`（格型：`tian` 田字格、`mi` 米字格、`hui` 回宫格、`box` 方格、`nine` 九宫格）、`overlayBlocks`（正文下面的配件：每个块的 `text` 是它的文字，如标题、古诗、词语）。
3. 改你要改的字段（比如把某个块的 `text` 换成古诗，`{分页}` 分页），然后 `POST /api/ai/v1/documents`，`params` 就用改后的整份。游客不能改的设置会被忽略并在 `restricted` 里列出。
4. 正文换了字之后，下面的配件会自动跟着正文的底边走，不会互相压住。

## 省次数的提醒（AI 游客每天 10 次，每次生成都计一次）

- 先读对应模板的提示词，再生成；不要靠反复生成来试参数。想看某个版式的结构，`GET /api/ai/v1/presets/<编号>` 读它的参数就行，不占次数。
- 字帖类模板的 `content` 里每个字都会单独排成一块：只放要学的生字，整首古诗、词语表、标题放进 `overlayBlocks` 的 `text`。
- 常见需求怎么做：
  - “生字笔顺 + 古诗描红 + 默写”一页：用免费版式 f001（或 `presets?q=古诗` 里的别的），改 `content` 为生字，改块的 `text` 为古诗；
  - 只要生字笔顺描红：不带 preset，`content` 放生字；
  - 要田字格：改 `gridStyle` 为 `tian`（正文用 `tian`，浮层格子用 `cross`）。

## 使用要求

- 生成的文件请原样交给用户，保留页脚的站点标识；不要裁剪、拼接或重绘后去掉标识、当作自己的成品。
- 交付文件时，请把返回里的 `message_for_user`（里面有登录链接和开通高级会员链接）一并告诉用户，不要等用户追问；用户当场就能知道怎么获得更多定制。
- 游客版本有限制（水印、部分设置不可改）是有意的：需要更多定制（颜色、标题样式、去掉标识、更高清晰度），请让用户登录或开通高级会员，或把 `editor_url` 交给用户在网站里调整。

## 谁能做什么

- 不登录（游客）：全部模板、免费现成版式、有字数上限（字帖类 40 字）、纸张/页边距等部分设置不可改；每天有生成次数。
- 注册用户：更大的字数上限、更多设置。
- 高级会员：全部现成版式、全部设置。
- 想以用户本人的身份调用（更多次数、更高权限）：POST /api/ai/v1/auth/device 发起授权，用户在浏览器里点“允许”后取得令牌；支持 OAuth 2.1（PKCE）与远程 MCP：https://ws.zitie.pro/api/ai/mcp
- 遇到需要更高身份的功能，接口会返回 `error`（如 `pro_only`）和 `login_url` / `upgrade_url` / `editor_url`：把链接交给用户，用户登录或开通后重试；也可以把 `editor_url` 给用户在浏览器里手动完成。

## 教程与模板页

- 使用教程：https://ws.zitie.pro/guide/
- 模板首页：https://ws.zitie.pro/