安裝
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