如何一键暂停AI改写claudish-to-english运行时开关与调试日志实战教程【免费下载链接】claudish-to-english项目地址: https://gitcode.com/gh_mirrors/cl/claudish-to-englishclaudish-to-english 是一款 Claude Code 插件它能调用本地 LLMollama把 AI 助手的每条回复额外改写为通俗易懂的白话文。本教程教你两个高频操作一键暂停 AI 改写运行时开关和打开调试日志排查问题全程只需几行命令。为什么需要运行时开关插件的配置环境变量在会话启动时就被冻结了——会话进行到一半修改配置是不会生效的。但标志文件机制打破了这个限制两个钩子脚本每次被触发时都会实时检查文件是否存在所以你可以在会话进行到一半时瞬间暂停或恢复改写无需重启 Claude Code。核心开关一览开关生效时机适用场景~/.claude/claudish-off标志文件立即生效每条消息实时检查会话中途一键暂停/恢复CLAUDISH_ENABLED0下次启动会话生效彻底关闭插件CLAUDISH_DEBUG1下次启动会话生效打开调试日志 即使暂停或关闭失败插件遵循fail-open失败放行契约任何异常都只会原样显示 Claude 的原始文字绝不会吞掉或损坏回答。一键暂停改写claudish-off 标志文件实战这是最常用的操作。在终端里创建或删除一个空文件即可touch ~/.claude/claudish-off # 暂停改写下一条消息立即生效 rm ~/.claude/claudish-off # 恢复改写实现原理在 rewrite.sh 中只有一行关键判断# 运行时开关每次调用都是全新进程标志文件检查始终实时 [ -f ${CLAUDISH_OFF_FILE:-$HOME/.claude/claudish-off} ] ENABLED0Windows 用户PowerShell 等效命令Windows 上通过 Git Bash 运行钩子脚本PowerShell 里对应写法如下来自 README.md 的官方说明New-Item -ItemType File $HOME\.claude\claudish-off # 暂停改写 Remove-Item $HOME\.claude\claudish-off # 恢复进阶快捷键一键切换官方推荐把两行切换脚本绑定到键盘热键这样所有正在运行的会话会同时被暂停/恢复非常适合多窗口开发场景。标志文件路径还可以通过CLAUDISH_OFF_FILE环境变量自定义默认~/.claude/claudish-off方便统一团队约定或放在共享位置。彻底关闭插件CLAUDISH_ENABLED 主开关如果不想每条消息都检查而是干脆不用这个插件可以把主开关设为0# 一次性会话生效 CLAUDISH_ENABLED0 claude或在~/.claude/settings.json的env块中永久设置{ env: { CLAUDISH_ENABLED: 0 } }⚠️ 两个易踩的坑修改env后必须重启 Claude Code——环境变量在启动时捕获运行中的会话仍是旧值env不会跨作用域合并——优先级最高的那份 settings 文件提供整个env块managed → local → project → user请把CLAUDISH_*变量都写在胜出的那个文件里。更多变量显示模式CLAUDISH_MODE、超时、最短改写长度等完整清单见 README.md 的 Configuration (env vars) 章节。调试日志实战用 CLAUDISH_DEBUG 看清每一次改写改写没出现模型超时了想确认钩子到底有没有触发打开调试日志{ env: { CLAUDISH_DEBUG: 1 } }重启 Claude Code 后两个钩子会把带时间戳和进程号的运行记录追加写入系统临时目录日志文件来源记录内容$TMPDIR/claudish-to-english/debug.log显示钩子 rewrite.sh分片缓冲、正文字数、最终改写结果、跳过原因$TMPDIR/claudish-to-english/debug-md.logMarkdown 文件钩子 rewrite-md.sh候选文件、frontmatter 拆分、写入目标日志条目格式为HH:MM:SS [PID] 说明例如14:32:01 [8821] chunk idx0 finalfalse midmsg_abc modeappend 14:32:03 [8824] final: prose_len1520 min200 modeappend full_bytes4830 14:32:05 [8824] ollama modelgemma4:26b-mlx curl_rc0 http200 resp_bytes2104 rewrite_bytes1987 truncatedfalse errnone第三行由共享的 provider 层 providers.sh 输出能一眼看到 HTTP 状态、响应字节数、是否被截断和错误信息——排查改写偶发丢失时最有用。Windows 上的日志位置Git Bash 的临时目录通常是C:\Users\你\AppData\Local\Temp\claudish-to-english\。配套提示会话内一次性通知CLAUDISH_NOTICE就算不开调试日志插件也会在每个会话只提示一次改写被跳过的原因服务商不可达、超时、缺 API key、模型未拉取等并追加显示在屏幕底部。觉得碍眼可用CLAUDISH_NOTICE0彻底静默纯 fail-open 模式。该机制自 0.1.1 版本引入详见 CHANGELOG.md。常见排查清单症状先查这里创建标志文件后仍在改写确认删除/创建的是同一文件会话中途生效的是标志文件env修改需重启屏幕上出现 ⚠️ 一次性通知按通知提示检查 ollama 是否在运行、模型是否已ollama pull改写迟迟不出现CLAUDISH_DEBUG1后看debug.log的curl_rc与http字段短消息没有改写属正常正文字数低于CLAUDISH_MIN_CHARS默认 200会跳过插件钩子没注册查看/plugin的 Errors 标签页必要时执行/reload-plugins钩子注册配置见 hooks/hooks.jsonMessageDisplay事件绑定 rewrite.sh60 秒超时PostToolUse绑定 rewrite-md.sh180 秒超时两者共享 providers.sh 提供的 ollama / Anthropic / OpenAI 兼容三通道。小结一键暂停touch ~/.claude/claudish-off下一条消息立即生效rm恢复彻底关闭CLAUDISH_ENABLED0下次会话生效看日志CLAUDISH_DEBUG1盯住$TMPDIR/claudish-to-english/下的debug.log和debug-md.log一切异常都 fail-open原始回答永远安全。掌握这三招你就能对 claudish-to-english 的运行时行为做到完全可控、随时可查。【免费下载链接】claudish-to-english项目地址: https://gitcode.com/gh_mirrors/cl/claudish-to-english创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考