Patina 多语言文本润色器
识别并改写中、英、韩、日文本中的 AI 腔，同时守住原意、数字、极性与因果关系。
按维度查看评分与理由
工作流默认采用只读权限，数据集、npm、GHCR 等发布操作均有显式布尔开关、分支或标签约束、环境隔离及来源提交校验；浏览器测试还阻断非同源请求，拒绝未通过门槛的结果，并验证取消行为。敏感文本、API 密钥和令牌被明确列为安全范围，README 声称 BYOK 密钥不存储、不记录，但所给材料没有包含实现代码或完整隐私/保留政策，因此数据流透明度和敏感数据处理未得满分。生产依赖很少，部分发布 Action 固定到提交，但其他 Action 仅用主要版本标签，且未见锁文件、漏洞扫描或依赖更新策略。输入文件在拒绝时保持不变、候选输出不落盘，提供一定恢复性，但没有面向普通用户的完整回滚流程。MIT 版权、NOTICE、灵感来源及仓库归属均有清晰标注。
README、package.json、工作流和测试对 8.10.0、Node 要求、命令及验证门槛大体一致，且发布流程检查元数据、测试、基准漂移和制品身份。不过 README 徽章的替代文本仍写着 8.8.0，展示值却是 8.10.0；已发布 npm 版本也落后至 8.9.0，虽有说明但仍降低整体一致性。依赖和后端选择有说明，离线评分可用，但在线重写、托管 API、外部 CLI 和浏览器运行仍依赖未在材料中建立可用性保证的服务。浏览器与 CLI 测试覆盖服务不可用、语义漂移、取消、超时和拒绝写入，并验证清晰的可见错误状态，因此失败信息证据充分。
材料清楚覆盖 KO、EN、ZH、JA，区分浏览器、Agent skill、CLI、CI、批处理、博客及多种文档类型，并把文档类型、Persona、Register 拆成独立轴。能力边界明确：它是编辑工具而非作者身份判定或检测器绕过工具，分数存在假阳性和假阴性，且省略轴时保留原文特征。触发命令和模式较明确，但推荐让 Agent 从 main 分支的原始 URL 执行安装说明，缺少修订固定，降低触发与安装的精确性。Node 版本、配置示例、离线模式、多后端及窄屏浏览器测试对环境适配提供了较强证据。
README 结构完整，集中链接安装、CLI 合约、架构、认证、Cookbook、示例、模式目录、研究、FAQ、贡献指南和变更记录；Quick Start 同时覆盖免安装浏览器、Agent skill 和 Node CLI。命令、配置及前后示例丰富，且明确说明示例为合成内容。已知限制、退役客户端和非作者鉴定用途均有披露。LICENSE 与 package 元数据一致为 MIT。版本号和发布渠道有明确说明并引用 CHANGELOG，但未提供 CHANGELOG 内容，且徽章替代文本存在陈旧版本，因此版本治理未得满分。SECURITY.md 指明 main 分支维护、私密漏洞报告路径和普通问题入口，但发布者身份未经验证、未点名维护负责人或响应时限，所以维护责任仅属充分但不完整。
输出可通过 diff、audit、score、verify、结构化收据和门槛状态检查；测试显示已批准结果可复制，漂移、传输失败和取消结果不会获得复制动作，CLI 也不会写入被拒绝的候选，因此可用性证据强。四语模式库、独立风格轴和意义保护相对普通改写具有明确增量价值，但 189 模式、校准数据和研究结论所引用的完整文件未在材料中提供，无法全面审查其方法和适用范围。项目提供浏览器、离线评分、BYOK、Pro 和本地 CLI 等路径，但没有价格、延迟、资源消耗或不同后端成本数据，故成本效益只能给中等分。
README 将模式数量、校准区间、研究、基准和架构等主张指向具体仓库文件，工作流还检查基准漂移、来源提交、发布制品和版本身份；所给浏览器及 CLI 测试也直接印证门槛拒绝、取消、凭据传输形式和拒绝写入等行为。不过多数被引用的研究、模式目录、认证文档、实现代码和生成报告未包含在本次证据中，因此核心效果数字只能追踪到文件名，不能在此复核。材料明确区分合成示例、历史录屏、实时运行和测量分数，并说明分数只是编辑信号而非作者身份证明，事实与推断分离较好。
- 本次仅为静态审查；未执行代码、测试、安装脚本、托管服务或发布流程。
- 浏览器重写会把私密草稿发送到服务器；BYOK 密钥“不存储、不记录”的说法在所给材料中缺少实现与保留政策佐证，敏感内容投入前应另行验证。
- Agent 安装提示引用可变的 main 分支原始文件；在受控环境中应固定到已审查的提交或发布制品。
- 189 个模式、校准指标及研究结果依赖未提供的文档和数据，不能据此把意义保持或效果视为已独立证实。
- 部分 GitHub Actions 使用主要版本标签而非提交固定；还应核验锁文件、依赖审计和供应链更新策略。
- 发布者身份未知但不因此被视为可疑；仍应在采用前确认维护联系人、响应预期及正式更新渠道。
这个 Agent 能做什么，适合哪些场景？
Patina 是一个面向韩语、英语、中文和日语的确定性、模式驱动型文本润色工具。它通过 189 个具名模式定位疑似 AI 式表达，并在不改变主张、数字、极性或因果关系的前提下进行改写。项目提供 Claude Code、Codex、Cursor 和 OpenCode 技能、Node.js 命令行工具以及无需安装的浏览器界面。CLI 支持 rewrite、verify、audit、score 和 diff 模式，还能按文档类型、人物语气和表达正式程度分别控制输出。浏览器端在服务器上执行改写，并以 MPS 和 fidelity 阈值拒绝语义漂移；离线评分则可作为不需要 API 密钥的确定性 CI 检查。它适合合规的 AI 辅助写作与编辑，不应被当作作者身份鉴定或检测器规避工具。
Patina 读取粘贴到浏览器的文本或传给 patina/patina-cli 的输入文件，以具名模式识别 AI 味表达并计算编辑信号。默认流程可以改写文本；--audit 只检测模式，--score --offline 生成确定性评分，--diff 列出逐模式修改及原因，--verify 在改写后执行 MPS/fidelity 下限检查。用户可通过 --document-type 控制体裁和结构策略，通过 --persona 复用从样本文本学习的声音特征，通过 --register casual|professional 调整表达方式；未指定的轴会保留源文本特征。它还能用 --batch 批量处理文件并将结果写入指定目录，或通过 persona new 从样本建立可复用人物语气。浏览器改写在服务端运行；API 模式会逐次转发用户自己的密钥，项目声明不会存储或记录该密钥。
- 使用 AI 起草中、英、韩、日邮件的职场用户，在发送前压缩套话并通过
--diff核对每处修改。 - 维护文档仓库的团队，用
--score --offline --exit-on 30在 CI 中标记需要人工编辑的高风险文本，而不调用外部模型。 - 内容编辑为同一品牌处理不同体裁时，用 Document Type 保持体裁规范，并用 Persona 维持可复用的表达习惯。
- 需要严格保护数字和论断的作者，用
--verify或/patina --strict对改写结果执行 MPS/fidelity 检查。 - 批量整理 Markdown 文档的技术写作者，用
--batch docs/*.md --outdir cleaned/生成集中存放的润色版本。 - 不想安装本地工具的偶尔使用者，直接在浏览器界面粘贴文本并获取经过语义门控的改写。
这个 Agent 有哪些优点和局限？
- 189 个模式均有名称，且
--diff能显示具体修改及理由，比不可审计的黑箱改写更容易复核。 - MPS/fidelity 门控明确保护主张、数字、极性和因果关系，并会拒绝发生语义漂移的改写。
- 文档类型、Persona 和 Register 是三个互不代填的控制轴，便于分别管理体裁、个人声音和正式程度。
- 同时提供 Agent 技能、Node.js CLI、批处理、离线 CI 评分和浏览器入口，可覆盖交互编辑与自动化流程。
- 项目明确披露评分存在假阳性和假阴性，并给出校准区间及改写失败研究，而非把评分包装成作者身份证明。
- 评分只是编辑热点信号，不能证明文本是否由 AI 创作；资料给出的 KO+EN 人类对照假阳性率为 16.0%。
- CLI 要求 Node.js 18 或更高版本；需要模型改写时还可能依赖网络、用户密钥或已登录的外部模型 CLI。
- 仓库标注 8.10.0，而 npm 当前提供 8.9.0，直接使用
npx时可能无法获得仓库中的最新行为。 - 公布的校准数据覆盖韩语和英语，并未提供同等的中文、日文校准结果。
- VS Code、Obsidian 和 Gmail 预览客户端已停止维护，依赖这些编辑器原生工作流的团队需要改用 CLI、技能或浏览器。
- 模式驱动方案只能处理目录已覆盖的表达特征；项目自身也承认改写并非总能成功。
如何安装或部署这个 Agent？
命令行运行环境要求 Node.js 18 或更高版本；无需全局安装即可使用 npx patina-cli。Agent 技能可在 Claude Code、Codex CLI、Cursor 或其他 Agent 中提交：Install patina by following https://raw.githubusercontent.com/devswha/patina/main/INSTALLATION.md。已经使用 skills.sh CLI 的用户可运行 npx skills add devswha/patina。浏览器版本直接打开 https://patina.vibetip.help/?lang=en，无需安装。CLI 若选用已登录的 codex、claude 或 gemini CLI，可指定 --backend codex-cli 且不需要另配 API 密钥；浏览器 API 模式需要用户逐次提供自己的密钥。仓库版本标为 8.10.0，但 npm 上的 patina-cli 与 patina-humanizer 当前为 8.9.0，采用时应注意渠道版本差异。
如何使用这个 Agent？
首次命令行改写可运行 npx patina-cli --lang en input.txt；先检查后端和密钥状态可运行 npx patina-cli doctor。安装 Agent 技能后，执行 /patina --lang en 并粘贴文本。只检测不改写使用 patina --audit input.txt；查看修改原因使用 patina --diff input.txt；改写并验证语义下限使用 patina --verify input.txt。确定性离线 CI 检查可运行 patina --score --offline --exit-on 30 input.txt。需要专业邮件输出时可运行 patina --document-type email --register professional input.txt。项目配置写入 .patina.yaml，可设置 version: "8.10.0"、language、document-type，并按需省略或填写 persona 与 register。
常见问题
使用 Patina 是否一定需要 API 密钥？
--score --offline 可在无密钥情况下运行；已登录的 codex、claude 或 gemini CLI 也可作为后端。浏览器 API 模式则要求用户按请求提供自己的密钥。它能证明一段文字是不是 AI 写的吗？
改写会不会更改数字或结论？
--verify、严格模式以及浏览器端的 MPS/fidelity 门控用于发现并拒绝语义漂移，但重要文本仍应人工复核。