0 Fork 0

Files

T

Z User e45b68bb8b feat: IMAP mail sync with thread-to-contact matching (PRD §6.1)

Real IMAP connection via imapflow library:
- Connects to IMAP server (IMAPFlow, TLS on port 993)
- Fetches recent messages (configurable limit, default 20)
- Extracts: from, fromEmail, subject, date, snippet (200 chars)
- Thread-to-contact matching (PRD §6.1):
  1. Match sender email against persons table
  2. If no person match, extract domain and match against company.website
  3. Returns matchedCompany + matchedPerson for each email
- Audit-logged (action: crm.mailsync:imap)
- Zod validated (host, port, user, password, folder, limit)
- 502 on IMAP connection failure with detail
- 400 on validation failure

Tested: invalid creds → 502 'IMAP connection failed', missing host → 400

2026-10-27 22:50:50 +00:00

12 KiB

Executable File

Raw Permalink Blame History

标题断句与一般断行 Title Line Breaking & Word Wrapping

中文排版里最容易被忽略的一组规则。正文断行和标题断行逻辑完全相反——正文按字、标题按词。这个差异不知道，就会把"我外交部强烈谴责伊拉克"和"大使馆被炸事件"在标题里硬切两行。

一、核心原则

文本类型	断行逻辑	原因
正文	按字断，不按词	汉语双音节词约占 60%，按词断会形成锯齿状右缘，方块字硕大无法形成西文那样的"波浪状"
标题	必须按词断	字数少、视觉占比大，词被切开会产生歧义和阅读阻塞
诗词	按句断（每句独占一行或按对齐排列）	节奏感优先
目录、列表	按条目断（必要时换行用次行缩进）	凸排（hanging）保持检索性

二、标题断行规则

1. 不可在词中间断开

绝对不可拆的"词单位"：

专有名词：人名（毛泽东 / 习近平 / 苏炳添）、地名（北京 / 哈尔滨 / 上海浦东）、机构名（外交部 / 中央电视台）、品牌（华为 / 字节跳动）
术语：人工智能、深度学习、量子纠缠、新冠肺炎
数字 + 单位：3 公斤、500 万、第 5 章
数字串：2024 年、100 元
书名 / 影片名 / 歌名：《静夜思》、《流浪地球 2》
成语 / 熟语：守株待兔、海纳百川（4 字成语整体不拆）

2. 虚词位禁忌

字 / 词	禁忌位置	原因
的、地、得、之、所	不入行首	修饰关系断了
和、与、及、或、跟、同	不入行末	并列关系悬空
是、为、乃	不入行首	系动词需有主语
在、于、对、向、从	不入行末	介词需带宾语
了、着、过	不入行首	助词依附前字
吗、呢、吧、啊、哦	不入行首（语气词通常）	同上

3. 标题反例与修正

❌ 反例 1（歧义）：

我外交部强烈谴责伊拉克
大使馆被炸事件

读者可能误解为"伊拉克大使馆被炸"。

✅ 修正：

我外交部强烈谴责
伊拉克大使馆被炸事件

❌ 反例 2（词中断）：

苹果发布全新人工智
能芯片 M5

✅ 修正：

苹果发布全新
人工智能芯片 M5

❌ 反例 3（虚词位）：

中国队战胜了美国队和
日本队

✅ 修正（"和"不入行末）：

中国队战胜了
美国队和日本队

4. 标题占行规则（铅排经验值）

标题必须占整数倍正文行高，否则跨栏对不齐。

标题层级	占行（含上下空白）	典型字号（正文 9pt 时）
大标题（章首）	4–5 行	18–24pt
中标题（节首）	2–3 行	12–15pt
小标题	1–2 行	10–12pt
双行标题（主 + 副）	3 行	主 12pt + 副 9pt
同行标题（小节首）	1 行（接续正文）	9pt 加粗

关键原则：标题字号 + 上下空白 = 正文行高 × N。否则后面所有正文都对不齐基线。

5. 标题在页面中的位置

大标题（章首）：必出现在正面页
- 横排左翻书 → 右页（奇数页）
- 直排右翻书 → 左页（奇数页）
- 若大标题前一章末页停在正面页 → 反面页留空白（"双白页"是必要的，不要为省纸打破）
换页 vs 单页起：
- 换页：从新页开始，不论奇偶（中小标题用）
- 单页起：必从正面页开始（大标题用）
中小标题孤行处理：若中小标题落到页末且后续正文容不下，整个标题换到下一页开头

6. 标题对齐方式

排版方向	大标题对齐	小标题对齐
横排	多居中	多左对齐 / 段首空格
直排	对行首（顶天） / 下沉（如下字常用 2 字位）	同

直排标题"下字 2 字位置"：直排时标题从天头空 2 字开始，避免顶天造成压抑。

7. 同行标题

小节标题不换行，直接接续正文。处理：

四、本章小结  本章我们讨论了……
       ↑
   1 字空白

标题与正文之间空 1 字位置
若标题字号非整数倍，调整空白让正文头尾对齐

三、CSS / HTML 实现标题断行

方法 1：手工 `<br>` 控制断点（最稳）

<h1>
  我外交部强烈谴责<br>
  伊拉克大使馆被炸事件
</h1>

方法 2：`<wbr>` 提示断点（允许在此换行）

<h1>苹果发布全新<wbr>人工智能芯片 M5</h1>

方法 3：U+2060 WORD JOINER（禁止在此换行）

<h1>第&#8288;5&#8288;章&nbsp;深度学习</h1>

注意：不要用 ‍（U+200D ZERO WIDTH JOINER）—— 那是给阿拉伯文/天城文连写用的，对中文断行无效。

方法 4：CSS `text-wrap: balance`（现代浏览器）

h1, h2, h3 {
  text-wrap: balance;       /* 让多行标题各行字数尽量均衡 */
}

方法 5：响应式断点（不同屏宽换不同断点）

<h1>
  我外交部强烈谴责<br class="md-only">
  <wbr>伊拉克大使馆被炸事件
</h1>
<style>
  @media (min-width: 768px) {
    .md-only { display: inline; }
  }
</style>

四、正文断行规则

正文按字断，但 6 类位置不能拆（不可分离禁则）：

1. 阿拉伯数字内部不拆

❌ 100
0 元
✅ 整体到下一行

2. 数字 + 单位不拆

数字 + %、‰、°、℃、℉ 不拆
数字 + ±、+、− 之前的符号不拆
数字 + 货币 ¥、$、€、£ 不拆

3. 上下标 / 注释记号 + 被标记词不拆

❌ m
²
❌ 苹果¹
公司
✅ 注释上标紧贴前一个字

4. 破折号 / 省略号不可拆开

破折号 ——（2 字宽）不可在中间断开
省略号 ……（2 字宽）不可在中间断开
连续多个破折号 ———— 允许在每一组之间拆

5. 西文单词按 hyphenation 断

横排中混排的西文单词遇行尾按西文连字符规则断词
直排中旋转 90° 的西文单词除连字符外不拆

6. URL / 邮件地址特殊处理

建议在 @、/、? 等符号处断行
不得加连字符（连字符会被误解为 URL 的一部分）
不改大小写
CSS：overflow-wrap: anywhere（针对长 URL）

CSS 实现"不可分离禁则"

.body-text {
  word-break: keep-all;            /* 不在词中间断 */
  overflow-wrap: break-word;        /* 但允许长 URL 换行 */
  line-break: strict;               /* 严格避头尾 */
  text-spacing-trim: space-all;     /* 标点空间挤压 */
  hanging-punctuation: allow-end;   /* 末行标点悬挂 */
}

/* 关键：不要这样写 */
.bad {
  word-break: break-all;            /* ❌ 会让中文按字硬断，避头尾全失效 */
}

/* 不可断的小组：数字+单位、上下标 */
.unit, .superscript-group {
  white-space: nowrap;              /* 整组不换行 */
}

不可断小组的 HTML 标记

<!-- 数字+单位 -->
温度 <span class="unit">25 ℃</span>
价格 <span class="unit">¥ 999.99</span>

<!-- 上下标 -->
面积 <span class="superscript-group">10 m<sup>2</sup></span>

<!-- 注释记号 -->
苹果公司<sup class="superscript-group">①</sup>

<!-- 用 U+2060 也可 -->
温度 25&#8288;℃

五、孤行孤字（Widow & Orphan）

排版的"末页综合症"：段末单字、页首单行。不修就是失败。

1. 孤字不成行（Orphan）

症状：段落最后一行只有 1 个字 + 1 个标点。

3 种救济（按优先级）：

救济 A：挤进上行（首选）

通过标点宽度调整：把上一行的标点全部从全宽改为半宽，腾出空间
通过中西间距调整：把中西混排的 1/4 em 间距压到 1/8 em
通过字距均压：上一行字距压缩 1/24 em

救济 B：删字让孤字回前行

与作者商议删去 1–2 个字
修改句法（"非常" → "很"）

救济 C：加字让末行≥3 字

与作者商议补 1 字让末行不再"孤"
加补缀词（"了"、"的"、"则"）

救济 D（次选）：均排末行

让末行 1 个字均排到整个版心宽度
适用于诗歌、对联，不适用于现代文（看着别扭）

2. 孤行不成页（Widow）

症状：页首是前段的最后一行（1 行 + 段间空白）。

4 种救济（按优先级）：

救济 A：孤行回前页（突出版心）

让孤行超出地脚版心 1 行，与前段连在一起
此页地脚临时缩小 1 行（在不严格场合允许）

救济 B：前页末段取 1 行

修改前段，让前段在前页最后一行结束自然停顿
让新段从本页开始（最自然）

救济 C：删字

删本段开头 1 行字数，让孤行不再孤

救济 D：加字

在前段补 1 行字数

3. CSS 实现

p {
  orphans: 2;       /* 段末至少留 2 行（避免 1 字孤悬）*/
  widows: 2;        /* 段首至少留 2 行（避免 1 行孤悬）*/
}

/* 段不要被分页符切断 */
h1, h2, h3 {
  page-break-after: avoid;       /* 标题后不分页 */
  break-after: avoid-page;        /* 同上，现代写法 */
}

img, figure {
  page-break-inside: avoid;       /* 图片不被切断 */
  break-inside: avoid;
}

六、断行控制工具汇总

工具	控制粒度	用法	平台
`<br>`	强制换行	HTML	所有
`<wbr>`	软断点（允许在此换行）	HTML5	现代浏览器
`⁠` (U+2060 WJ)	禁止在此换行	HTML 字符	现代浏览器
` `	不可换行空格	HTML 字符	所有
`white-space: nowrap`	整段不换行	CSS	所有
`word-break: keep-all`	单词内不断（不要 `break-all`）	CSS	所有现代
`overflow-wrap: break-word`	超长词允许换行	CSS	现代浏览器
`line-break: strict`	严格避头尾	CSS	现代浏览器
`text-wrap: balance`	多行均衡	CSS	现代浏览器（2024+）
`hyphens: auto`	西文自动连字符	CSS	现代浏览器

七、InDesign / Word 中的断行设置

InDesign

关闭"连数字"（默认开启会把"以防万一"中的"万一"误判数字）：
- 不打开任何文档 → 段落面板选项 → 关闭"连数字" → 影响所有新文档
选用 Adobe CJK 单行书写器（不是段落书写器）
- 段落书写器会把单行字距调整污染相邻行
避头尾设置：选"简体中文避头尾"，避头尾间断类型选"先推入"或"确定调整量优先级"
**段落面板"禁止断字"**勾选（默认开），破折号才不被拆

Word

段落对话框 → 中文版式
勾选"允许标点溢出边界"
勾选"按中文习惯控制首尾字符"
"首尾字符"选"标准"或"严格"
注意：Word 默认中文"后置标点"不包含 U+2014，破折号需要手动加入"自定义后置标点"

八、检查清单（断行相关）

排印完成前必过：

所有标题是否按词断、不在词中间硬断？
标题中"的"是否在行首？"和/与"是否在行末？
标题占行是否为正文行高整数倍？
大标题是否在正面页（横右页 / 直左页）？
数字 + 单位是否整组不分行？（用 <span class="unit"> 或 ⁠）
破折号、省略号是否未被中间拆开？
注释上标是否与被标记词紧贴？
段末是否有"孤字 + 标点"？
页首是否有"孤行"？
URL / 邮箱是否在合理位置断（不加连字符）？
CSS 是否用 word-break: keep-all 而不是 break-all？

12 KiB Executable File Raw Permalink Blame History Unescape Escape

标题断句 与 一般断行 Title Line Breaking & Word Wrapping