patina-cli 3.11.0 → 4.0.0

package/README_ZH.md

@@ -6,34 +6,60 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Skill](https://img.shields.io/badge/Skill-Claude%20Code%20%7C%20Codex%20%7C%20Cursor%20%7C%20OpenCode-blueviolet)](#快速开始)
 [![Multi-language](https://img.shields.io/badge/Languages-KO%20%7C%20EN%20%7C%20ZH%20%7C%20JA-green)](https://github.com/devswha/patina)
-[![Version](https://img.shields.io/badge/version-3.11.0-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-4.0.0-blue)](CHANGELOG.md)
 
-> **只剥掉 AI 包装，保留原意。**
+<p align="center">
+  <img src="assets/demo/patina-demo-en.gif" alt="patina 将带有 AI 味的英文文案改写并显示评分的终端演示 GIF" width="780">
+</p>
 
-patina 会在中文、韩文、英文和日文里找出 AI 味比较重的写作模式，并在不改动原意的前提下重写。它可以作为 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[Codex CLI](https://github.com/openai/codex)、[Cursor](https://cursor.sh)、OpenCode 的技能使用，也可以作为独立的 Node.js CLI 运行。
+<p align="center">
+  <a href="https://patina.vibetip.help/"><b>用你自己的文本试用 — 无需安装</b></a>
+</p>
 
-它不是黑盒改写器。patina **基于模式且可审计**：会说明改了什么、为什么改，以及原文的主张是否保留下来。
+> **去掉 AI 味，保留原意。**
+
+patina 会在中文、韩文、英文和日文中找出 AI 味较重的表达，并在不改变主张、数字、立场和因果关系的前提下改写。你可以把它装成 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[Codex CLI](https://github.com/openai/codex)、[Cursor](https://cursor.sh)、OpenCode 的 agent skill，也可以直接运行独立的 Node.js CLI。
+
+它不是黑盒式改写器，也不是用来绕过 AI 检测器的工具。patina **基于清晰的模式规则，并且可审计**：会说明改了什么、为什么改，以及原文的主张是否保留下来。只要 `codex`、`claude`、`gemini` 任一 CLI 已登录，就可以不填 API 密钥使用。
 
 ## 效果展示
 
-**修改前** *(AI 风格)*：
-> 咖啡已成为**深刻改变**全球社交互动的**核心文化现象**。这种备受喜爱的饮品充当了社区建设的催化剂，促进了有意义的联结，并推动了跨文化对话。
+**修改前** *(AI 风格；当前 GIF 使用的是英文示例)*：
+> The newly released Notion template pack is an **innovative solution** designed to **transform productivity** for modern teams. It offers 30 templates optimized for diverse workflows, with a user-friendly design that enables anyone to leverage them effortlessly. This product introduces a **new paradigm** for maximizing work efficiency.
+
+**修改后** *(`/patina --lang en --tone marketing` — 事实不变，只去掉 AI 味)*：
+> If Notion still starts as a blank page for your team, open this pack first. It includes 30 templates for common workflows. Duplicate one, adjust the fields you need, and use it for a team project or your own planning without starting from scratch.
+
+> **Score = 0.0%** · 30 个模板 ✓ · 适配工作流 ✓ · 复制后可调整使用 ✓
+
+**更多例子**
+
+| 输入类型 | 去掉的 AI 味 | 保留的含义 |
+|---|---|---|
+| 韩语营销文案 | “혁신적인 솔루션”, “새로운 패러다임” | 30 个 Notion 模板、适配工作流、复制后可自行修改 |
+| 学术文本 | “획기적인 성과”, 宽泛的意义宣称 | 60 个 GitHub 项目、72h→10m 设置时间、p<0.01、限制说明 |
+| 技术文档 | “핵심적인 역할”, 未来标准式夸张 | GPU 管理、一条命令完成配置、5× 结果的注意事项 |
+
+## 浏览器直接体验 — 无需安装
+
+**[patina.vibetip.help](https://patina.vibetip.help/)** 可以在浏览器里直接检查 KO / EN / ZH / JA 段落中的 AI 写作信号。
 
-**修改后** *(`/patina --lang zh` 处理 — 同样内容，仅去除 AI 包装)*：
-> 咖啡在不知不觉中改变了人们见面的方式。和人坐下来聊久了，关系自然就有了，哪怕文化背景完全不同也能聊到一起。
+> **仅检测。** playground 只在你的浏览器内运行确定性的文体统计分析。它不会改写文本，不会调用外部 LLM，也不会把 API key 发到服务器。需要实际改写时，请使用下面的 CLI 或 skill。
 
-> **MPS = 100** · 社交变革 ✓ · 社区建设 ✓ · 有意义的联结 ✓ · 跨文化对话 ✓
+完整改写流程见 [30 秒终端演示](docs/DEMO.md)。更多例子见 [Before/After Gallery](docs/EXAMPLES.md)（[한국어](docs/EXAMPLES_KR.md)）。
+品牌资源：[logo](assets/brand/patina-logo.svg)、[mark](assets/brand/patina-mark.svg)、[icon](assets/brand/patina-icon.svg)、[social preview](assets/social/patina-og.svg)、[before/after card](assets/social/patina-before-after.svg)。使用指南见 [BRANDING.md](docs/BRANDING.md)。
 
 ## 一览
 
 |  |  |
 |---|---|
-| **160 个模式** | 韩文 40 + 英文 40 + 中文 40 + 日文 40 (各含8个仅评分的 viral-hook) — [PATTERNS.md](docs/PATTERNS.md) |
-| **编辑热点召回率** | 韩文 91% [84.0–95.4%] (n=100) / 英文 76% [66.7–83.3%] (n=100), binomial 95% CI |
-| **误检率** | 人类文本不同体裁 13–25% 点估计范围 *(不是 CI；百科风格本质局限，[已记录](core/stylometry.md))* |
+| **168 条模式** | 每种语言 33 条可改写模式 + 9 条仅评分的病毒式钩子模式（KO/EN/ZH/JA 各 42 条） — [PATTERNS.md](docs/PATTERNS.md) |
+| **编辑热点召回率** | 2026-05-22 现代模型重基线：GPT-5.5 / Claude Sonnet 4.6 / Gemini 2.5 Pro 的总体命中率为 67.3% [63.5–71.0%]（n=600，韩文+英文） |
+| **基准报告** | 可复现的 ko/en/zh/ja 可疑区间基准：[overview](docs/benchmarks/README.md) · [latest.md](docs/benchmarks/latest.md) · [latest.json](docs/benchmarks/latest.json) · [2026 rebaseline](docs/benchmarks/rebaseline-latest.md) · [detector comparison](docs/benchmarks/detector-comparison.md) |
+| **误检率** | 2026-05-22 KO+EN 人类对照为 16.0% [11.6–21.7%]（n=200）；不同文体的边界见 [stylometry.md](core/stylometry.md) — [报告误检](https://github.com/devswha/patina/issues/new?template=false_positive.yml) |
 | **模式** | rewrite · audit · score · diff · ouroboros |
-| **免费层** | 支持 — 通过 `codex` CLI（无需 API 密钥） |
-| **确定性** | 评分公式是确定性的；LLM 严重度判定阶段 ±8–10pt 波动（[scoring.md §8](core/scoring.md)） |
+| **免费使用** | 已登录的 `codex`、`claude` 或 `gemini` CLI 可直接运行，无需 API 密钥 |
+| **确定性** | 评分公式是确定性的；LLM 严重度判定阶段会有 ±8–10pt 波动（[scoring.md §8](core/scoring.md)） |
 | **许可证** | MIT |
 
 ## 快速开始
@@ -44,7 +70,7 @@ patina 会在中文、韩文、英文和日文里找出 AI 味比较重的写作
 curl -fsSL https://raw.githubusercontent.com/devswha/patina/main/install.sh | bash
 ```
 
-安装脚本会把 patina 一次性接入 Claude Code、[Codex CLI](https://github.com/openai/codex)、Cursor、OpenCode。它会在 checkout 前把 repository HEAD 解析到具体 commit；如果需要完全固定安装，请设置 `PATINA_REF=<tag-or-full-sha>`。然后：
+安装脚本会把 patina 一次接入 Claude Code、[Codex CLI](https://github.com/openai/codex)、Cursor 和 OpenCode。安装时会先把远程 HEAD 固定到具体 commit；如果想固定到某个版本，请设置 `PATINA_REF=<tag-or-full-sha>`。然后：
 
 ```
 /patina --lang zh
@@ -52,7 +78,7 @@ curl -fsSL https://raw.githubusercontent.com/devswha/patina/main/install.sh | ba
 [在此粘贴你的文本]
 ```
 
-以特定语调改写：
+按指定语气改写：
 
 ```
 /patina --tone narrative
@@ -60,7 +86,7 @@ curl -fsSL https://raw.githubusercontent.com/devswha/patina/main/install.sh | ba
 [在此粘贴你的随笔草稿]
 ```
 
-自动检测最适合的语调：
+自动选择合适的语气：
 
 ```
 /patina --tone auto --lang en
@@ -68,11 +94,18 @@ curl -fsSL https://raw.githubusercontent.com/devswha/patina/main/install.sh | ba
 [在此粘贴你的文本]
 ```
 
-> 注意：`--tone`（含 `auto`）在 v1 仅对 ko/en 生效。zh/ja 使用任何语调均会触发警告并回退到 profile-only 模式。
+> 注意：`--tone`（含 `auto`）在 v1 仅对 ko/en 生效。zh/ja 使用任何语气都会触发警告，并回退到 profile-only 模式。
 
 ### 作为独立 CLI
 
-需要 Node.js ≥ 18。
+需要 Node.js ≥ 18。npm 包已公开，可以直接运行：
+
+```bash
+npx patina-cli doctor
+npx patina-cli --lang zh input.txt
+```
+
+如果想拉下仓库本地修改再试：
 
 ```bash
 git clone https://github.com/devswha/patina.git
@@ -80,35 +113,59 @@ cd patina && npm install && npm link
 patina --lang zh input.txt
 ```
 
-也可以 link 后通过 stdin 试用：
+`npm link` 后也可以通过 stdin 试用：
 
 ```bash
 printf '%s\n' '咖啡已成为一种关键文化现象，从根本上改变了全球各地的社会互动。' \
   | patina --lang zh --backend codex-cli
 ```
 
-> 🆓 **无需 API 密钥** — 只要 [`codex`](https://github.com/openai/codex)、[`claude`](https://docs.anthropic.com/en/docs/claude-code)、[`gemini`](https://github.com/google-gemini/gemini-cli) 任一 CLI 已登录即可。可通过 `--backend codex-cli | claude-cli | gemini-cli` 直接选择，或用 `--model claude-*` / `--model gemini-*` 按模型名路由。完整后端列表见 [AUTHENTICATION.md](docs/AUTHENTICATION.md)。
+> 🆓 **无需 API 密钥** — 只要 [`codex`](https://github.com/openai/codex)、[`claude`](https://docs.anthropic.com/en/docs/claude-code)、[`gemini`](https://github.com/google-gemini/gemini-cli)、[`kimi`](https://moonshotai.github.io/kimi-cli/) 任一 CLI 已登录即可。可以用 `--backend codex-cli | claude-cli | gemini-cli | kimi-cli` 直接选择，也可以用 `--backend claude-cli,codex-cli` 指定后备顺序；还可以交给模型名自动路由（如 `--model claude-*` 或 `--model kimi-*` → 对应 CLI）。未传 `--model` 时，patina 会按 backend 传入默认模型：`gpt-5.5`、`claude-sonnet-4-6`、`gemini-2.5-pro` 或 `kimi-code/kimi-for-coding`。完整后端列表见 [AUTHENTICATION.md](docs/AUTHENTICATION.md)。
 
-### CI integrations
+### CI 集成
 
-Patina 提供不需要 live model key 的确定性 CI prose review：
+Patina 提供确定性的 CI 文档检查，不需要 live model key：
 
 ```yaml
 # .github/workflows/patina.yml
-steps:
-  - uses: actions/checkout@v6
-  - uses: devswha/patina-action@main # npm 发布并打 Action 标签后改用 @v1
-    with:
-      patina-package: github:devswha/patina # patina-cli@latest 发布到 npm 后删除
-      report-threshold: 30
-      comment: true
+name: Patina prose score
+
+on:
+  pull_request:
+    paths:
+      - '**/*.md'
+      - '**/*.mdx'
+
+permissions:
+  contents: read
+  pull-requests: read
+  issues: write
+
+jobs:
+  patina:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: devswha/patina-action@v1
+        with:
+          score-threshold: 30
+          lang: auto
+          comment: true
+```
+
+Docker 镜像发布与 npm release 路径分开追踪。GHCR 镜像公开前，需要容器时请先构建本地镜像：
+
+```bash
+docker build -t patina:local .
+printf '%s\n' '咖啡已成为一种关键文化现象。' \
+  | docker run --rm -i -e PATINA_API_KEY patina:local --lang zh --provider openai
 ```
 
 Pre-commit、Husky、Lefthook、Docker 和 release workflow 说明见 [docs/integrations/](docs/integrations/)。
 
-## 预期用途
+## 正确使用目的
 
-Patina 适合在作者可以使用 AI 辅助时，用来做 AI 后编辑、保留审计轨迹和清理 voice。它不承诺文本“原本由人类写成”，也不应被用于规避学术 honor-code、绕过出版方 disclosure、洗白抄袭，或声称 detector-bypass。见 [ETHICS.md](docs/ETHICS.md)。
+Patina 适合在作者可以使用 AI 辅助起草的场景中，用来编辑草稿、看清改了哪里和为什么改，并让文字读起来更自然。它不保证文本“原本由人类写成”，也不应被用于规避学术 honor code、绕过出版方 disclosure、洗白抄袭，或声称可以 bypass detector。分数只是有误报和漏报的编辑信号，不是作者身份的证明。见 [ETHICS.md](docs/ETHICS.md)。
 
 ## 模式
 
@@ -121,52 +178,47 @@ patina --lang <ko|en|zh|ja> [模式] [--profile <名称>] input.txt
 | *(默认)* | 改写 |
 | `--audit` | 仅检测 AI 模式 |
 | `--score` | 0–100 AI 相似度评分 + 类别细分 |
-| `--score --exit-on <n>` | 保持 CI 严格：当 `overall > n` 时以退出码 `3` 结束（`--gate` 保留为 alias） |
+| `--score --exit-on <n>` | 保持 CI 严格：当 `overall > n` 时以退出码 `3` 结束 |
 | `--diff` | 按模式逐项展示改动 |
 | `--ouroboros` | 反复改写直到分数收敛（含 MPS 回滚） |
 | `--lang <ko\|en\|zh\|ja>` | 选择语言（默认：`ko`） |
-| `--profile <名称>` | 语气预设：`blog`, `academic`, `technical`, `formal`, `social`, `email`, `legal`, `medical`, `marketing`, `narrative`, `instructional`, `casual-conversation` |
+| `--profile <名称>` | 语气预设：`blog`, `academic`, `technical`, `formal`, `social`, `email`, `legal`, `medical`, `marketing`, `narrative`, `instructional`, `casual-conversation`, `code-comment`, `commit-message`, `release-notes`, `namuwiki` |
 | `--tone <名称>` | 语调类别：`casual`, `professional`, `academic`, `narrative`, `marketing`, `instructional`, `auto` |
 | `--batch` | 把位置参数当作文件列表（例：`--batch docs/*.md`） |
 | `--format json\|text\|markdown` | 选择 JSON、纯文本或默认 Markdown 输出 |
-| `--prompt-mode strict\|minimal\|auto` | 选择完整模式包提示、压缩提示，或按后端自动选择 |
-| `--variants <1-5>` | 生成多个改写变体，同时保留相同事实和意义锚点 |
-
-完整选项请运行 `patina --help`。
-
-### 仅评分模式
+| `--quiet` | 隐藏 stderr 中的状态、警告和进度日志 |
 
-`--score` 和 `--audit` 测量的信号范围比 `--rewrite` 略广。viral-hook 包（`ko/en/zh/ja-viral-hook`，每种语言 8 个模式：数字震撼钩子、标题党收尾、跳过来源的权威断言、适合呼吸节奏的短句堆叠、夸张互动词汇、伪统计引用、头衔堆叠、未来自我承诺）为**仅检测**模式。
+完整选项请运行 `patina --help`。`patina doctor --json` 可在不调用 LLM 的情况下检查 Node/backend/tmux/API-key 状态。项目配置是可选的；一次性运行请用 flags，只有需要固定默认值时再添加 `.patina.yaml`。
 
-这些信号只会出现在评分和审计中，用来让基准更贴近用户对四种语言 SNS 营销文案的直觉。`--rewrite`/`--diff`/`--ouroboros` 会跳过它们，因为这些信号往往是有意的修辞。实例: [`examples/viral-hook/`](examples/viral-hook/).
+Markdown 较多的工程流程可以使用开发者 profile：`code-comment` 会收紧 inline comments/docstrings，`commit-message` 会把 Git 历史文本改成更强调意图和验证，`release-notes` 会把 changelog bullets 改成面向用户影响的发布说明，并保留迁移风险。`namuwiki` 是仅适用于韩文的 wiki 风格 profile，只包含原创的 license-safe 指南，不复制 NamuWiki 文章文本。
 
-### 提示模式调优 (v3.11)
-
-`--prompt-mode strict|minimal|auto` 可在完整模式包（约 34KB 结构化提示）和压缩的轻量指令（约 3KB）之间取舍。`auto` 会按后端选择 — Gemini 在 minimal 下表现更好（长结构化提示会让它过度受限），Claude 能利用完整模式包，Codex 大致不敏感。case-05 记录了 A/B 结果。
+### 仅评分模式
 
-### 多个风格变体 (v3.11)
+`--score` 和 `--audit` 测量的信号范围比 `--rewrite` 略广。viral-hook 包（`ko/en/zh/ja-viral-hook`，每种语言 9 个模式：数字震撼钩子、标题党收尾、跳过来源的权威断言、适合呼吸节奏的短句堆叠、夸张互动词汇、伪统计引用、头衔堆叠、未来自我承诺、格言式收束句）为**仅检测**模式。
 
-`--variants <1-5>` 会在一次调用中请求 N 个改写声音变体（例如 V1 casual、V2 direct、V3 measured）— 事实、数字和因果关系在所有变体中保持一致。每个结果会以 `## Variant N` 返回，方便你选择需要的语气。
+这些信号只会出现在评分和审计中，用来让基准更贴近用户对四种语言 SNS 营销文案的直觉。`--rewrite`/`--diff`/`--ouroboros` 会跳过它们，因为这些表达往往是有意的修辞。实例：[`examples/viral-hook/`](examples/viral-hook/)。
 
 ### 短文本评分增强 (v3.11)
 
-当输入不超过 200 个字符或不超过 3 个段落时，对 register 敏感的类别（`language`、`style`、`viral-hook`）会获得 1.5 倍 severity multiplier，让单段文本里的声音变化也能体现在分数中。case-04 发现这些信号会被长文本公式低估。
+当输入不超过 200 个字符或不超过 3 个段落时，对语气更敏感的类别（`language`、`style`、`viral-hook`）会获得 1.5 倍权重，让单段文本里的声音变化也能体现在分数中。case-04 发现这些信号会被长文本公式低估。
 
 ### 自审隔离 (v3.11)
 
-在 rewrite 模式中，模型会把自审笔记放在 `[SELF_AUDIT]`/`[/SELF_AUDIT]` 标签内，并包裹一个 `[BODY]`/`[/BODY]` 块（当 `--variants > 1` 时则是 `[VARIANT n]` 块）。patina 会在展示给用户前移除审计内容，因此原始输出保持干净 — 早期版本有时会把 “남아 있는 AI 티” 或 “Phase 3” 之类的前言泄漏到用户可见文本中。
+在 rewrite 模式中，模型会把自审笔记放在 `[SELF_AUDIT]`/`[/SELF_AUDIT]` 标签内，并包裹一个 `[BODY]`/`[/BODY]` 块。patina 会在展示给用户前移除审计内容，因此原始输出保持干净。早期版本有时会把 “남아 있는 AI 티” 或 “Phase 3” 之类的前言泄漏到用户可见文本中。
 
-### Machine-readable output and exit codes
+### 机器可读输出和退出码
 
-`--format json` 会把所有模式包进稳定 envelope，包含 `overall`、`categories[]`、`tone`、`mps`、`gateResult` 和清理后的 `output` 正文。`--format markdown` 是默认值；`--format text` 保留无 YAML tone footer 的用户可见正文。退出码见 [EXIT-CODES.md](docs/EXIT-CODES.md)：`0` 成功，`1` runtime/backend，`2` input/usage，`3` score gate 超限，`4` MAX MPS fallback/all-candidates-failed。
+`--format json` 会把所有模式包进稳定的 JSON envelope，包含 `overall`、`categories[]`、`tone`、`mps`、`gateResult` 和清理后的 `output` 正文。`--quiet` 则为只需要 stdout 的脚本隐藏状态、警告和进度日志。`--format markdown` 是默认值；`--format text` 保留无 YAML tone footer 的用户可见正文。退出码见 [EXIT-CODES.md](docs/EXIT-CODES.md)：`0` 成功，`1` runtime/backend，`2` input/usage，`3` score gate 超限。
 
 ### 分数权重漂移检测 (v3.11)
 
-`--score` 运行会把模型输出的 Weight 列与配置中的 `category-weights` 交叉检查。如果模型凭空创造类别（例如 `discord`）或替换成不同数字，stderr 会出现 `[patina]` 警告 — 这只用于可观测性，不会改变分数本身。
+`--score` 运行会把模型输出的 Weight 列与配置中的 `category-weights` 对照。如果模型凭空创造类别（例如 `discord`）或替换成不同数字，stderr 会出现 `[patina]` 警告。这只用于可观测性，权重检查本身不会改变分数。确定性 shadow score 也会从 `src/features/*` 记录；当它与 LLM 分数相差超过 20 分时，patina 会警告并使用更保守的分数作为 gate。
+
+使用 `--voice-sample <path>` 或配置中的 `voice-sample: <path>`，可以让 rewrite 参考你写过的 1–3 个段落。Profile 和 tone 仍然决定目标 register；sample 只学习节奏、具体度、视角和句子质感，prompt 会明确禁止引入 sample facts。
 
 ## 语调
 
-`--tone` 是叠加在模式改写之上的具名声音轴。优先级：`--tone` CLI > `tone:` 配置 > `profile:` 配置。
+`--tone` 是叠加在模式改写之上的具名语气轴。优先级：`--tone` CLI > `tone:` 配置 > `profile:` 配置。
 
 | 语调 | 适用 | 主要特征 |
 |------|------|----------|
@@ -177,17 +229,7 @@ patina --lang <ko|en|zh|ja> [模式] [--profile <名称>] input.txt
 | `marketing` | 广告文案、落地页、产品公告 | 短促有力、有说服力、CTA 友好 |
 | `instructional` | 教程、操作指南、技术文档 | 命令式动词、编号结构、抑制猜测语 |
 
-`--tone auto` 通过启发式（词汇 + 结构信号）自动选择最契合的语调。zh/ja 上使用任何语调（包括 `auto`）均会发出警告并回退到 profile-only 模式 — Phase 4.5b 启发式仅覆盖 ko/en。
-
-### MAX 模式
-
-将同一段文本独立交给 Claude、Codex、Gemini。通过 MPS ≥ 70 门槛后，AI 分数最低（最像人写）的结果胜出：
-
-```
-/patina-max
-
-[在此粘贴你的文本]
-```
+`--tone auto` 通过启发式（词汇 + 结构信号）自动选择最契合的语气。zh/ja 上使用任何语气（包括 `auto`）都会发出警告并回退到 profile-only 模式，因为 Phase 4.5b 启发式仅覆盖 ko/en。
 
 ## 工作原理
 
@@ -195,54 +237,69 @@ patina --lang <ko|en|zh|ja> [模式] [--profile <名称>] input.txt
 输入
   ↓
 [步骤 4.5]   语义锚点提取 (主张、极性、因果、数值)
-[步骤 4.6]   文体统计预处理 (burstiness CV + MATTR)
-[步骤 4.7]   AI 词汇重叠 (英 ~108 / 韩 102 项)
+[步骤 4.6]   文体统计预处理 (burstiness CV + MATTR; zh/ja 字符 token fallback)
+[步骤 4.7]   AI 词汇重叠 (英文 88 / 韩文 102 / 中文 60 / 日文 60 项)
 [阶段 1]     结构扫描 + 锚点验证
 [阶段 2]     句子改写 + 锚点验证
 [阶段 3]     自审 (极性、回归、MPS)
   ↓
-自然的文本（语义已验证）
+自然文本（语义已验证）
 ```
 
-任一验证阶段语义偏移则重试或回滚。
+如果任一验证阶段发现语义偏移，patina 会重试或回滚。
 
-**校准** *(500 段语料，可通过 `.omc/research/v3_8_remeasure.py` 复现)*：HC3 ChatGPT (en) 编辑热点召回率 76% [66.7–83.3%]，paired ko/AI 语料 91% [84.0–95.4%]（各 n=100，binomial 95% CI）。人类写作误检以不同体裁 13–25% 点估计范围单独报告。接受门槛：AI ≥ 75%，最大 FP ≤ 25%。算法见 [stylometry.md](core/stylometry.md)。
+**校准** *(2026-05-22 现代模型重基线；方法见 [2026-rebaseline.md](docs/research/2026-rebaseline.md))*：在 GPT-5.5、Claude Sonnet 4.6、Gemini 2.5 Pro CLI 样本上，确定性编辑热点命中率为 67.3% [63.5–71.0%]（n=600，韩文+英文）。人类对照误检率为 16.0% [11.6–21.7%]（n=200）。语言×模型的细分结果见 [rebaseline-latest.md](docs/benchmarks/rebaseline-latest.md)。这只是编辑信号，不是作者判定，也不是绕过检测的承诺。
 
 ## 配置
 
 ```yaml
 # .patina.default.yaml
-version: "3.11.0"
+version: "4.0.0"
 language: ko              # ko | en | zh | ja
 profile: default
 output: rewrite           # rewrite | diff | audit | score
 tone:                     # casual | professional | academic | narrative | marketing | instructional | auto
-max-models: [claude, gemini]
 ```
 
-模式包按语言前缀自动发现。工作目录中的 `.patina.yaml` 会覆盖默认值。扩展检测的列表键（`blocklist`、`allowlist`、`skip-patterns`）会在 default/global/project 配置之间追加合并；`max-models` 等 provider 列表会替换原值，便于用户选择精确的后端集合。
+模式包按语言前缀自动发现。工作目录中的 `.patina.yaml` 会覆盖默认值。用于扩展检测的列表键（`blocklist`、`allowlist`、`skip-patterns`）会在 default/global/project 配置之间追加合并；其他数组键会直接替换，方便用户指定精确值。
 
 ## 文档
 
+- **[Cookbook](docs/COOKBOOK.md)** — 实用配方（Hugo 批量打分、GitHub Actions、误报 triage、自定义 profile、pre-commit）
 - **[Glossary](docs/GLOSSARY.md)** — MPS、fidelity、burstiness、MATTR、模式等常见术语的简短定义
 - **[Demo](docs/DEMO.md)** — 终端 transcript 与多种体裁的 before/after 快照
-- **[Patterns](docs/PATTERNS.md)** — 160 个模式目录
-- **[Authentication](docs/AUTHENTICATION.md)** — 后端、服务商、免费层设置
-- **[CLI Contract](docs/CLI.md)** — score gate、退出码，以及适合自动化的接口边界
-- **[Flag Parity](docs/FLAG-PARITY.md)** — standalone CLI、`/patina`、`/patina-max` 的选项支持范围
-- **[Ethics](docs/ETHICS.md)** — 预期用途、禁止用途和披露立场
-- **[FAQ](docs/FAQ.md)** — detector-bypass 疑虑、MPS、误报、贡献起点
+- **[Patterns](docs/PATTERNS.md)** — 168 个模式目录
+- **[Authentication](docs/AUTHENTICATION.md)** ([한국어](docs/AUTHENTICATION_KR.md)) — 后端、服务商、免费层设置
+- **[GitHub Action](docs/integrations/github-action.md)** — 无需 live model key 即可生成 PR hotspot 评论与 README score badge
+- **[Pre-commit](docs/integrations/pre-commit.md)** — pre-commit、Husky 与 Lefthook 的 score-only 配方
+- **[Static-site Stencils](docs/integrations/static-sites.md)** — Hugo、Astro 与 Next.js MDX 构建期打分配方
+- **[Docker](docs/integrations/docker.md)** — GHCR 镜像用法与 release tag
+- **[Release workflow](docs/integrations/release.md)** — npm provenance + GHCR 发布清单
+- **[CLI Contract](docs/CLI.md)** — score gate、JSON/text/Markdown 输出，以及适合自动化的接口边界
+- **[API Reference](docs/API.md)** — 用于编程式导入与打分 helper 的生成 JSDoc 参考
+- **[Flag Parity](docs/FLAG-PARITY.md)** — standalone CLI 与 `/patina` 的选项支持范围
+- **[Exit Codes](docs/EXIT-CODES.md)** — 面向 CI 与编辑器集成的进程退出码约定
+- **[Ethics](docs/ETHICS.md)** — 正确使用目的、禁止用途和披露立场
+- **[FAQ](docs/FAQ.md)** ([한국어](docs/FAQ_KR.md)) — detector-bypass 疑虑、MPS、误报、贡献起点
+- **[False-positive Gallery](docs/FALSE-POSITIVES.md)** — 应被视为编辑提示而非指控的人类文风示例
 - **[Comparison](docs/COMPARISON.md)** — 与常见 paraphraser/humanizer 工具的事实比较
 - **[Branding](docs/BRANDING.md)** — canonical logo/social assets 和 OG 设置说明
 - **[Design](DESIGN.md)** — repo-native SVG 与 README surface 的产品/品牌基准
 - **[Roadmap](docs/ROADMAP.md)** — 质量、基准、产品、社区和发布优先级
+- **[Docs Platform RFC](docs/RESEARCH-DOCS-PLATFORM.md)** — Docusaurus、Astro Starlight、MkDocs 与 GitHub Pages 调研
+- **[Benchmark Reports](docs/benchmarks/README.md)** — 已签入的基准产物、刷新命令与 public-claim gate
 - **[Benchmark Report](docs/benchmarks/latest.md)** — 最新可复现 suspect-zone 基准摘要
+- **[Detector Comparison Harness](docs/benchmarks/detector-comparison.md)** — 第三方 detector 的离线/手动对比协议
 - **[AI/Human Metrics Research](docs/research/ai-human-metrics.md)** — 用于测量 AI-like writing signals 的基准设计说明
-- **[Launch Copy](docs/social/patina-launch-copy.md)** — Show HN、Reddit、X、韩国社区草稿
+- **[2026 Modern-model Rebaseline](docs/research/2026-rebaseline.md)** — 带当前日期戳的 KO+EN catch/FP claim
+- **[2025+ Re-baseline Plan](docs/research/2025-rebaseline-plan.md)** — 面向更广 model-era claim 的协议
+- **[zh/ja Lexicon Calibration](docs/research/zh-ja-lexicon-calibration.md)** — starter lexicon gate 与剩余 corpus risk
+- **[Launch Copy](docs/social/patina-launch-copy.md)** — launch sequence、score gate 与 Show HN/Product Hunt/Reddit/X/韩国社区草稿
+- **[Signs of AI Writing](docs/social/signs-of-ai-writing.md)** ([한국어](docs/social/signs-of-ai-writing_KR.md)) — 附带引用示例的可分享编辑 checklist
 - **[Stylometry](core/stylometry.md)** — burstiness + MATTR + AI 词汇算法
 - **[Scoring](core/scoring.md)** — AI 相似度 + 忠实度 + MPS
 - **[Changelog](CHANGELOG.md)** — 发布说明和方法论
-- **[Contributing](CONTRIBUTING.md)** — 模式提交、误报 triage、基准 fixture、版本管理
+- **[Contributing](CONTRIBUTING.md)** ([한국어](CONTRIBUTING_KR.md)) — 模式提交、误报 triage、基准 fixture、版本管理
 - **[Governance](GOVERNANCE.md)** / **[Maintainers](MAINTAINERS.md)** — 轻量级项目决策规则
 
 ## 致谢

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: patina
-version: 3.11.0
+version: 4.0.0
 description: Detect and rewrite AI writing patterns in Korean, English, Chinese, and Japanese text so it reads as if a human wrote it. Meaning-preservation (MPS) verified.
 allowed-tools:
   - Read
@@ -32,7 +32,6 @@ Glob .patina.default.yaml → Read
 - `output`: 출력 모드 (`rewrite` | `diff` | `audit` | `score`)
 - `blocklist`: 추가 감지 어휘
 - `allowlist`: 감지 제외 어휘
-- `prompt-mode`: 프롬프트 로딩 방식 (`strict` | `minimal` | `auto`, 기본: `strict`)
 
 `$ARGUMENTS`에서 옵션을 파싱하여 설정을 오버라이드:
 - `--profile <name>`: 프로필 변경
@@ -42,8 +41,6 @@ Glob .patina.default.yaml → Read
 - `--ouroboros`: ouroboros 모드 (반복 교정 + 점수 수렴)
 - `--lang <code>`: 처리 언어 변경 (ko, en, zh, ja). 설정 파일의 `language` 값을 오버라이드한다.
 - `--tone <name>`: 톤 카테고리 지정. 유효값: `casual | professional | academic | narrative | marketing | instructional | auto`. 알 수 없는 값이면 즉시 오류: "Unknown tone '<name>'. Valid tones: casual, professional, academic, narrative, marketing, instructional, auto"
-- `--prompt-mode <strict|minimal|auto>`: 패턴 팩 전체를 쓰는 strict 모드와 압축 지시문 minimal 모드 중 선택한다. `auto`는 백엔드/문맥별로 선택하되, 불확실하면 strict를 사용한다.
-- `--variants <1-5>`: rewrite 모드에서 같은 의미 앵커를 보존한 N개의 문체 변형을 요청한다. `--audit`, `--score`, `--diff`에는 적용하지 않는다.
 - `--batch <files>`: 여러 파일을 한꺼번에 처리 (glob 또는 명시적 경로 목록).
   - `--in-place`: 원본 파일을 교정된 텍스트로 덮어쓴다.
   - `--suffix <ext>`: 결과를 `{원본명}{ext}` 파일로 저장한다 (예: `--suffix .humanized`).
@@ -115,7 +112,7 @@ Read profiles/{profile}.md
 Glob custom/profiles/{profile}.md → Read (사용자 커스텀 프로필 우선 로드)
 ```
 
-커스텀 프로필(`custom/profiles/{profile}.md`)이 있으면 우선 사용한다. 없으면 `profiles/{profile}.md`를 사용한다. 둘 다 없으면 `profiles/default.md`를 사용한다.
+커스텀 프로필(`custom/profiles/{profile}.md`)이 있으면 우선 사용한다. 없으면 `profiles/{profile}.md`를 사용한다. 둘 다 없으면 `profiles/default.md`를 사용한다. `profiles/namuwiki.md`는 한국어 전용이므로 `--lang`이 `ko`가 아니면 기본 프로필로 폴백한다.
 
 프로필에 `voice-overrides`와 `pattern-overrides`가 있으면 이를 파싱하여 5단계에서 적용한다.
 - `voice-overrides`: voice.md 지침의 강도를 프로필별로 조절 (amplify/allow/suppress)
@@ -141,7 +138,7 @@ Read core/voice.md
 
 > **주의:** 텍스트가 1개 단락 이하이고 2개 문장 이하이면 추출을 건너뛰고 파이프라인을 정상 실행한다 (오버헤드 불필요).
 >
-> **참고:** 앵커 추출이 건너뛰어지거나 추출된 앵커가 0개이면, MPS는 N/A로 표시되며 ouroboros와 MAX mode의 MPS 게이팅을 면제한다.
+> **참고:** 앵커 추출이 건너뛰어지거나 추출된 앵커가 0개이면, MPS는 N/A로 표시되며 ouroboros의 MPS 게이팅을 면제한다.
 
 ### 앵커 유형
 
@@ -223,13 +220,13 @@ tone_confidence: high
 
 > **주의:** 텍스트가 단락 ≤2 또는 전체 문장 ≤2 이면 4.6단계를 통째로 건너뛴다 (4.5단계와 동일 임계).
 >
-> **언어 제한 (v1):** `stylometry.languages` 설정에 포함된 언어에서만 실행한다. 기본값은 `[ko, en]`. 처리 언어가 `zh` 또는 `ja` 인 경우 4.6단계를 skip 하고 파이프라인을 정상 진행한다 (zh/ja 토큰화는 v2 이후 로드맵).
+> **언어 제한:** `stylometry.languages` 설정에 포함된 언어에서만 실행한다. 기본값은 `[ko, en, zh, ja]`. 처리 언어가 `zh` 또는 `ja` 인 경우 whitespace 단어가 아니라 문자 토큰 fallback으로 4.6단계를 실행한다.
 
 ### 메트릭 정의
 
 전체 알고리즘 정의는 `core/stylometry.md`를 참조한다. 핵심 공식만 인라인으로 제시한다.
 
-**Tokenization** — whitespace 기준 분할 + edge-punctuation strip. ko=어절, en=단어. 형태소 분석기 미사용.
+**Tokenization** — ko/en은 whitespace 기준 분할 + edge-punctuation strip(ko=어절, en=단어)을 사용한다. zh/ja는 Han/Kana 문자와 ASCII run을 토큰으로 삼는 deterministic character-token fallback을 사용한다. 형태소 분석기 미사용.
 
 **Burstiness (CV, 문장 길이 변동성)**
 
@@ -301,7 +298,7 @@ hot 단락 내부에서 인접 문장 토큰 수 차이 < 20% 인 연속 문장
 
 > **주의:** 텍스트가 단락 ≤2 또는 전체 문장 ≤2 이면 4.7단계를 통째로 건너뛴다 (4.6단계와 동일 임계).
 >
-> **언어 제한 (v1):** `lexicon.languages` 설정에 포함된 언어에서만 실행한다. 기본값은 `[en, ko]`. 처리 언어가 `zh` 또는 `ja` 인 경우 4.7단계를 skip 하고 파이프라인을 정상 진행한다 (zh/ja lexicon 큐레이션은 v2 이후 로드맵).
+> **언어 제한:** `lexicon.languages` 설정에 포함된 언어에서만 실행한다. 기본값은 `[en, ko, zh, ja]`. zh/ja는 character-token fallback 특성상 기본 사전을 phrase-only로 유지한다.
 
 ### 사전 로드
 
@@ -311,8 +308,8 @@ Glob custom/lexicon/ai-{lang}.md → Read (사용자 커스텀 우선)
 ```
 
 각 lexicon 파일은 두 섹션으로 구성된다:
-- `## Strict matches`: 대소문자 무시 whole-word 매칭 (한국어 어절은 substring 근사)
-- `## Multi-word phrases`: 대소문자 무시 substring 매칭. 한국어 `~` placeholder 는 wildcard 로 취급
+- `## Strict matches`: 대소문자 무시 whole-word 매칭 (CJK ko/zh/ja는 substring 근사)
+- `## Multi-word phrases`: 대소문자 무시 substring 매칭. `~` placeholder 는 wildcard 로 취급
 
 ### 알고리즘
 
@@ -505,7 +502,7 @@ FOR each anchor IN anchor_list:
 
 0. **Suspect zone 활용** — 4.6단계의 hot 문장 그룹(`P{n}.S{m}-S{k}`)을 우선 재작성 대상으로 처리. meta block 의 sub-flag 정보를 사용해 패턴 스캔 우선순위를 결정한다. 4.7단계의 lexicon hit 인용("AI-lexicon hits: ..." 부분) 도 우선 재작성 신호로 사용 — 인용된 AI 어구가 등장하는 문장을 패턴 스캔 우선순위 상단에 둔다
 1. **AI 패턴 식별** - 로드된 문장/어휘 패턴 팩의 모든 패턴을 스캔
-2. **문제 구간 다시 쓰기** - AI스러운 표현을 자연스러운 대안으로 교체
+2. **문제 구간 다시 쓰기** - AI스러운 표현을 토큰 단위로 치환하지 말고, 문맥을 읽은 뒤 절/문장 단위로 자연스럽게 다시 쓴다
 3. **의미 보존** - 핵심 메시지를 유지
 4. **어조 맞추기** - 프로필의 어조 지침에 따라 톤 조절
 5. **개성 불어넣기** - voice.md의 지침에 따라 실제 사람의 목소리를 넣기
@@ -528,6 +525,8 @@ FOR each anchor IN anchor_list:
 
 9. **의미 보존 제약 주입** — 의미 위험도가 HIGH인 패턴을 적용할 때, 해당 문단의 앵커를 교정 프롬프트에 포함한다: "다음 주장을 반드시 유지하라: {앵커 목록}". MEDIUM 위험도 패턴은 극성(Polarity) 또는 부정(Negation) 앵커가 있는 문단에서만 제약을 주입한다. LOW 위험도 패턴은 제약 없이 적용한다.
 
+**CJK 절/문장 단위 교정 가드 (issue #352):** `--lang ko|zh|ja`에서는 구두점이나 단어 1개만 1:1로 바꾸지 않는다. em dash, 콜론, 세미콜론, 슬래시, 쉼표 접속, 괄호식 삽입구처럼 절 관계를 표시하는 구두점이 AI 신호와 함께 보이면, 문장 전체를 읽고 목표 언어의 자연스러운 절 구조·문장 분리·접속 표현으로 다시 짠다. 번역체/직역 명사구가 구두점에 붙어 있으면 둘을 함께 고친다. 한국어 예: `무 TUI` 식 직역은 `TUI 없이 완전 자율로 설치하려면 ...`처럼 풀고, `"끝난 것 같아요"로는 부족한 열린 작업`은 `"끝난 것 같아요"만으로는 부족한, 결과를 끝까지 확인해야 하는 열린 작업`처럼 절 관계를 드러낸다. 교정 중 행위자·극성·조건·숫자·인과는 유지한다.
+
 > **주의:** 5a단계에서 이미 교정한 구간을 5b단계에서 다시 "정돈된 공식문"으로 되돌리지 않도록 주의한다.
 
 ---
@@ -582,14 +581,6 @@ tone_confidence: low | medium | high
 
 > **주의 (A7):** rewrite 최종본 본문에 tone 정보를 언급하거나 삽입하지 않는다. "이 텍스트는 casual 톤으로 재작성되었습니다" 같은 내러티브 인터젝션 금지.
 
-#### 변형 출력 (`--variants`)
-
-`--variants N`이 주어지면 최종본을 하나로 고정하지 말고 `## Variant 1` … `## Variant N` 형식으로 반환한다. 각 변형은 같은 의미 앵커(주장, 수치, 인과관계, 고유명사, 극성)를 보존해야 하며, 문체 축만 달라져야 한다.
-
-- Variant 1: 기본 프로필/톤을 가장 충실히 따른다.
-- Variant 2+: 더 직설적, 더 캐주얼, 더 절제된 식으로 리듬과 레지스터를 바꾼다.
-- 각 variant마다 `[SELF_AUDIT]` 메모는 내부 검수용으로만 사용하고 사용자-facing 본문에는 남기지 않는다.
-
 ### diff 모드 (`--diff`)
 
 변경 사항을 패턴별로 표시한다. 뭘 왜 바꿨는지 보여준다. 끝에 YAML footer 추가.