Sloptrim 快速入门

这是什么？适合谁？

Sloptrim 是一个本地运行的 AI 写作模式探测器：给你的 Agent 落盘的每个散文文件打分，标记出 AI 味的片段并要求修复。纯 Python 标准库实现，无网络、无模型——只处理散文，永不碰代码。在 AI 生成内容同质化泛滥的当下，它是”反 AI 腔”的第一道质检闸。

适合人群：用 Agent 批量生成文档/博客/文案的创作者与团队、需要给 AI 内容定质量门的编辑流程负责人、在意”AI 味”的技术写作者。 使用前提：Python 3 环境、一个会写文件的 coding agent（Claude Code / Codex / Cursor 均可）。

快速上手（3 步）

第一步：安装为 Agent 插件

最简单的方式——在你的 coding agent 里粘贴：

Install the sloptrim plugin from https://github.com/seyedehsanhadi/sloptrim

或走插件市场：

/plugin marketplace add seyedehsanhadi/sloptrim
/plugin install sloptrim@sloptrim

重启后运行 /sloptrim doctor，应返回四行 [OK]。

第二步：手动安装（备选）

git clone https://github.com/seyedehsanhadi/sloptrim.git ~/.claude/skills/sloptrim
mkdir -p ~/.claude/commands
cp ~/.claude/skills/sloptrim/install/sloptrim-command.md ~/.claude/commands/sloptrim.md

注意别跳过 mkdir——新机器上 ~/.claude/commands 不存在，直接 copy 会报 “No such file or directory”。

第三步：扫描你的第一个文件

对任意 Agent 生成的 Markdown/散文文件运行扫描，查看逐片段的 AI 模式标记与评分，按提示让 Agent 修复被标记的 span。

初级用法

• 命令行独立使用：不依赖 agent 也能对目录批量打分，适合接入 CI。
• 模式库学习：references/patterns.md 列出全部检测模式，读一遍能显著提升你”肉眼识别 AI 腔”的能力。
• 伦理边界：README 带 ETHICS 章节——它是质检工具不是洗稿工具，定位清晰。

高级玩法

1. 写作流水线质检门：Agent 产出 → sloptrim 打分 → 分数阈值拦截 → 不过关自动打回重写，全程本地零成本。
2. 团队风格基线：对团队历史人写文档跑一遍，找出”误报率”可接受的阈值，再应用到 AI 产出检查。
3. 与其他质检器串联：sloptrim 管”AI 腔”，链接检查器管死链，拼写检查管错字——组合成完整发布前检查链。

常见踩坑（5 条）

踩坑 1：对代码文件运行

• 现象：想让它检查代码注释以外的东西
• 原因：设计边界明确——“Prose only, never code”
• 解决：代码质量交给 linter，sloptrim 只管散文

踩坑 2：复制命令的目录不存在

• 现象：手动安装 copy 失败
• 原因：~/.claude/commands 在新机器上不存在
• 解决：先 mkdir -p（PowerShell 用 New-Item -ItemType Directory -Force）

踩坑 3：以为有网页版

• 现象：搜到同名网站
• 原因：README 明确声明：无网站、无托管版，任何同名网站与本仓库无关
• 解决：只用 GitHub 仓库安装，文本永不离开你的机器

踩坑 4：误报引发过度修改

• 现象：人写的正常表达被标记
• 原因：部分模式（如常见连接词）在人写文本中也会出现
• 解决：把 sloptrim 当”提示器”而非”审判官”，标记 span 人工复核后再改

踩坑 5：跳过 doctor 直接用

• 现象：行为不符合预期
• 原因：安装不完整（四项检查未全过）
• 解决：先跑 /sloptrim doctor 拿到四行 [OK]

FAQ（5 个常见问题）

Q1：Sloptrim 免费吗？ A：Apache-2.0 开源免费，纯本地运行，零 API 成本。

Q2：它怎么检测”AI 味”，需要模型吗？ A：不需要模型——基于规则模式库（references/patterns.md）本地匹配打分，所以无网络、可复现、毫秒级。

Q3：支持中文吗？ A：README 为英文，检测模式以英文散文为主；中文检测效果未实测，建议先小样本验证。

Q4：能集成到 CI 吗？ A：可以，命令行形态天然适合 CI：低于阈值即 fail。

Q5：它能保证内容不是 AI 生成的吗？ A：不能也不试图——它检测的是”AI 写作模式”，是对抗同质化的质检工具，不是 AI 检测器（ETHICS 章节有明确边界说明）。

小技巧（5 条）

1. 先读 patterns.md 再用：理解每个模式的含义，你会更快判断哪些标记值得改。
2. 阈值分级：草稿容忍高分，发布线收紧阈值。
3. 只修被标记的 span：别让 Agent 整篇重写——局部修复保留原有结构与事实。
4. 搭配人写范文：让 Agent 修复时提供一段你认可的文风样例。
5. 定期更新：模式库随版本演进，跟进新模式对抗新 AI 腔。

进阶学习建议

• 精读 references/patterns.md 的完整模式清单，把高频模式做成自己的”写作黑名单”
• 研究纯标准库实现（无依赖）的工程取舍，学习”小工具做透一件事”的设计哲学
• 用它批量扫描你过往的 AI 生成文档，统计最常见的三类 AI 腔，针对性改提示词
• 把 sloptrim 接入你的发布流水线，与 spell-check、link-check 组成三件套

参考链接

• Sloptrim GitHub 仓库

本文基于公开资料于 2026-08-17 整理，社区指标反映 GitHub 公开数据。独立实测未进行，功能和配置项可能随版本更新而变化，请以官方文档为准。