安装
pip install humanizer-ru适合谁
适合要把从聊天界面贴出来的俄文先做可核对卫生检查,再决定是否润色的人。humanizer-ru 面向俄语文本,提供可验证的粘贴卫生处理。走 MCP 时,同一套命令通过 stdio 上的 humanizer-mcp 暴露,对应 contract.v1.json 里的工具;文本留在本进程,不会被这套工具送出进程。
不适合主要处理 Markdown 文稿、又打算直接跑 polish 的人:polish 会去掉 ##、**、书名号式引号和破折号。只有带 --preserve-markup 时,才允许在带标记的文本上做 polish。也不适合还没装 Python 包、却只改客户端配置的人——服务命令是安装后提供的 humanizer-mcp。
3 分钟完成第一次尝试
只走一条官方路径:先装包,再把唯一的 MCP 配置写成 humanizer-mcp。不要并列第二套安装器。
pip install humanizer-ru
客户端配置位置是 MCP 服务器表里的这一项:
{
"mcpServers": {
"humanizer-ru": { "command": "humanizer-mcp" }
}
}
前置条件:本机已有能跑 pip 的 Python,以及能启动 stdio MCP 的客户端。配置里不要填密钥占位符,这条服务没有要求 API key。
第一次调用用原文写明的扫描命令,先看标记、不要先 polish。按原文准备样例并扫描:
python -c "open('primer.txt','w',encoding='utf-8').write('Согласно отчёту :contentReference[oaicite:3]{index=3}, рост заявок.\n')"
humanizer-markers --scan primer.txt; echo "rc=$?"
成功信号是命令跑完并打印 rc= 后面的退出码,且你能看到扫描是否在样例里标出聊天残留。MCP 侧同一套命令走 JSON-RPC 信封,错误按合同用 isError 表示。这是本地读文件并扫描,不是零风险:它会在本机写入 primer.txt 并读取该文件。
确认扫描可用之后,如果要润色,再考虑 MCP 工具 humanizer_polish;对 Markdown 必须加 --preserve-markup,否则会剥掉标题和加粗标记。
使用案例
案例一:检查聊天粘贴里的残留标记。用 humanizer-markers --scan(MCP 里是同一套命令)扫描刚贴进编辑器的俄文。适合先确认“有没有聊天引用残渣”,再决定改写。证据只示范了对 primer.txt 的扫描和退出码,没有列出全部标记种类。
案例二:在确认不是排版稿之后做事实核对或润色。MCP 提供 humanizer_facts,以及与命令行相同模式的 humanizer_polish。polish 不要直接打在 Markdown 上;需要保留标记时用 --preserve-markup。证据没有给出这两个工具的参数表,缺了就停在名称与上述限制。
使用边界
包名是 humanizer-ru,MCP 进程是 humanizer-mcp,合同是 contract.v1.json。文本不离开进程,但仍会读本地文件,并可能写入如 primer.txt 的样例。polish 会破坏 Markdown,除非 --preserve-markup。证据没有写撤销路径。JSON-RPC 错误看 isError。官方说明见
https://github.com/Vladimir-Human/humanizer-ru