# 玉尺 · 量一量中文的呼吸

> 原作者：ZhongQuinnKing（主号署名）
> 许可：见 [LICENSE](LICENSE)（内容 CC BY-NC-ND 4.0）与 [LICENSE-CODE](LICENSE-CODE)（代码 MIT）（五档：免费用／自改自由／转发署名／改版发布先授权／商用零豁免——本许可本身不授予商用权）
> 商用授权与合作：需商用请先联系 hello@xinchuan.dev 取得书面授权（标题注明【商用授权】或【改编授权】）；也可走本仓库 issue

> 「仙人持玉尺，度君多少才。」
> ——旧题李白《上清宝鼎诗》（作者有考证争议，《全唐诗》补遗收入李白名下）

把一段文字贴进来，玉尺说出哪里读起来“不像人写的”，指到句子，告诉你怎么改。量的是节奏，不是词表。

玉尺做两件事，同等对待：**把文章写好**，和**把诗写好**。文章与诗不分主次，各求各的领域最强。

*English TL;DR — Yuchi (“jade ruler”) is a rhythm-based diagnostic for Chinese writing: sentence-length breathing, filler and cliché density, structure. It points at the exact sentences that read machine-like and shows how to fix them. Ships as CLI, a web page, and an AI skill pack. Chinese-first.*

## 这是什么

中文写作里，“机器味”从来不是几个词的错。真正的分界在结构：句子的长短起伏、连接词的分量、段落是推进还是平铺。玉尺把那道分界量成数：

- **节奏层**：句长呼吸、句内节奏、平滑段定位
- **密度层**：套话与连接词、破折号、虚词与空夸词
- **结构层**：清单式还是推进式
- **具体层**：形容词有没有落到数字、动作、场面
- **段落层**：段落参差度

量完给三样：分数（有气 / 气弱 / 气滞 / 无气）、问题定位、落到句子的改法。

**作诗方向**（与写作同标准推进）：诗模式已能体检——贴一首诗，看行长呼吸、逐字平仄标注与读感（“连着四个仄声，念起来发紧”这类）；「景到诗」在建设中——把眼前的溪流与蓝天简单描绘，得到合心意的句子；近体诗、词、曲、联、赋五类已都能体检（词：818 词牌对谱；曲：中原音韵声调与韵脚；联：四验；赋：四六骈句报数与句末韵部）。

## 三件套

1. **网页版**：打开就能量，贴文字出诊断卡（`web/index.html`，可直接挂 GitHub Pages）
2. **命令行**：`python3 yuchi.py 你的文章.txt`（零依赖，纯标准库；另有 `--poem` 诗、`--ci 词牌` 词、`--qu` 曲、`--lian` 联、`--fu` 赋、`--html` 报告卡、`--json` 结构化输出、`--batch` 多文件对照）
3. **技能包**：`SKILL.md` 加十五篇教材，装进 Claude、豆包等 AI 助手——AI 写中文、改中文时按它办

**在线试用（不用装）**：https://zhongquinnking.github.io/yuchi/

## 怎么装

**AI 助手（技能包）**

- 豆包等：对它说一句“请安装这个 skill：https://github.com/ZhongQuinnKing/yuchi”
- Claude Code / Codex：`git clone https://github.com/ZhongQuinnKing/yuchi ~/.claude/skills/yuchi`
- 其他一线 AI（ChatGPT / Kimi / 通义 / 元宝 / 智谱 / Gemini / DeepSeek…）：把仓库喂进它的知识库/智能体，或直接发仓库地址请它自装（仓库带 `AGENTS.md`——Codex 这类读它的助手，进目录即懂规矩）

**命令行 / 网页**：clone 下来即用，无需安装任何东西。

**给 AI 用户的开口模板**（详见 `references/10-AI协作.md`）：

> 请你写一篇（标题与用途：＿＿）。料（用这些素材，一个字不许编）：＿＿。谱（照着写）：每 200 字至少一句十二个字以内的短句；不许用“首先、其次、最后”串联；不许出现“值得注意的是、综上所述”；破折号全文最多两处；形容词尽量换成数字、动作、例子。样子（语气参考）：＿＿。完事后自查一遍，把没过的项报给我。

## 边界（先说清楚）

- **不测 AI 率，不承诺检测数字**。“检测率”是检测器的输出，玉尺不打这个分，不宣传，也不针对任何检测器做优化。
- **分数是参考**：清单是底线，尺子是尺度，作者是主人。
- **改稿不改事实**：只动结构，数字、人名、日期、引语一个字不动。
- **学术场景**：只教方法、给改法，不代写正文。

## 判断从哪来

写在 `references/07-验证与依据.md` 里：研究结论（句长节奏是最强判别特征，多项研究以句长加标点密度组合达到 96% 至 98% 的准确率）、语料校准（真人语料对 AI 合成腔与真实 AI 输出两组，满分点按人类语料 p75 标定；真实复验的结论：分数量的不是作者身份，是文字本身）、几百年的中文写作传统。工具的已知局限、教材自评口径，那一篇里全摊开。

## 十五篇篇目

- **写作十二篇**：节奏 / 密度 / 结构 / 具体 / 改稿流程 / 自检清单 / 验证与依据 / 文体 / 腔调 / AI 协作 / 开头与结尾 / 练习
- **作诗与地图**：诗的呼吸（从看见到成篇）/ 工具与资源地图（从有想法到成篇的每一站）
- **歌词**：担着曲子的字（两种工序路、前置两道、咬合四条、词法六条）

## 姊妹篇

- [采诗](https://github.com/ZhongQuinnKing/caishi)：让 AI 读懂中文互联网
- [夜诵](https://github.com/ZhongQuinnKing/yesong)：AI 睡着时替你盯世界
- [拾级](https://github.com/ZhongQuinnKing/shiji)：从高三到工位的军师

名字都从旧书里来：采诗去读，夜诵去守，拾级陪你，玉尺量你。

2026 年 10 月起，收录于 [chinese-independent-developer](https://github.com/1c7/chinese-independent-developer)（国内独立开发者项目清单，6 万+ 星）程序员版。

## 许可

内容（教材、文档）采用 CC BY-NC-ND 4.0：自己用、自己改（不发布）完全自由；原样分享免费（署名）；修改后对外发布须先取得授权；商用须先联系。代码（脚本）采用 MIT。