shuorenhua-skilllisted

# 说人话 · 双外脑中文改写 > 看不懂的话，让两个模型各说一遍人话，再对着原文裁判。意思不变是底线，流畅是目标。 ## 核心理念 三条，全部来自实践： 1. **改写交给外脑，裁判留在本地。** 让 GPT-4o 和 Gemini 各改一版——两个模型的坏习惯不一样，一个改绕了另一个往往是直的。本地 agent 不动笔，只对照原文逐句检查意思、挑句子、合终稿。自己改自己查，查不出问题。 2. **原文永远不动、永远保留。** 改写附在原文后面，不覆盖。改砸了随时能退回去；两版都失败就明说失败，绝不输出改了一半的东西。（这条抄自 gvzdv/claudish-to-english：它给 Claude 的回复附一段大白话翻译，原文照旧。） 3. **意思不变优先于一切。** 数字、人名、术语、引文、结论，一个都不能变。改得再顺，意思跑了就是废稿。拿不准的地方保留原词，宁可难懂，不能编。 跟 MrGeDiao/shuorenhua（1.2k★ 的规则库路线）的区别：那个是给本地模型一套「AI 痕迹清单」照着自查，主攻去 AI 味；这个是把活儿外包给两个模型交叉改写，主攻「看不懂的话变成看得懂的」。两个可以叠着用。 ## 三个入口 | 入口 | 什么时候 | 目标 | `--scene` | |------|----------|------|-----------| | **单独用** | 用户扔来一段看不懂的文字 | 读一遍就懂 | 不加 | | **备料** | 写作前，素材本身难啃（采访转写、翻译腔文档、论文摘要、会议纪要） | 素材能直接用；信息一条不能丢 | `beiliao` | | **出稿** | 成稿交付前 | 句子通顺；作者的观点、语气、结构不动 | `chugao` | 在任何写作流程里挂两刀：素材进来时过一遍备料，稿子出去前过一遍出稿。中间的创作不管。 ## 执行流程 ### 第 0 步 · key 引擎需要 OpenRouter key（一个 key 就能同时调 GPT-4o 和 Gemini）。先直接跑第 1 步，脚本自己会按顺序找：`--key-env` 指定的环境变量 → `OPENROUTER_API_KEY` → `~/.config/shuorenhua/key`。 退出码 2 = 没 key。这时停下来向用户要，话术照这个说： > 需要一个 OpenRouter key（openrouter.ai/keys 免费注册就能领，按量付费）。**别把 key 贴进对话**——聊天记录会留底。请在终端里自己执行 `python3 tools/shuorenhua.py --save-key`（输入不回显，存到本机、权限 600），或者 `export OPENROUTER_API_KEY=…`，配好回我一声。 用户有凭据管理器（比如 `secret` CLI）的话优先走它：`secret exec 你的KEY名 -- python3 tools/shuorenhua.py 文件 --key-env 你的KEY名`。key 永远不进命令行参数、不进对话、不进日志。 ### 第 1 步 · 双模型改写 ```bash python3 tools/shuorenhua.py 输入文件.md # 单独用 python3 tools/shuorenhua.py 素材.md --scene beiliao # 备料 python3 tools/shuoren