nopus

nopus 是一款专为编码代理（Coding Agents）设计的辅助工具，解决大语言模型（LLM）在生成代码解释或技术文档时常见的“抽象胡言乱语”问题。它通过确定性的散文复杂度分析，自动识别并标记那些超出用户设定阈值的响应，触发代理进行一轮更清晰、更直接的改写。目前，nopus 已支持 Pi、Claude Code 和 Codex 三大主流编码代理平台。

核心工作原理：确定性散文检查

nopus 并不依赖另一个 LLM 来评估清晰度，而是采用基于词频和句法结构的确定性算法，测量以下关键特征：

• 措辞罕见度：识别在日常对话或广泛书面英语中极少使用的词汇（如用 “Commence” 代替 “Start”，用 “Ameliorate” 代替 “Fix”）。
• 抽象性检测：标记缺乏具体指代的概念词（如 “capability”, “governance”, “strategy”）及其构成的抽象句子。
• 名词堆叠：识别三个或更多名词/修饰语压缩成的难读短语（如 “repository state mutation verification strategy”）。
• 公式化风格：捕捉膨胀的填充性短语（如 “Here’s where it gets interesting”）。

智能过滤机制：
为了避免误伤必要的技术内容，nopus 在分析前会移除代码块、URL、文件路径等，并降低已建立的计算术语权重。它使用比例和密度而非绝对数量，确保长回复不会仅因长度受罚。只有当多个负面特征组合超过阈值时，才会触发改写。

功能亮点

• 自动清晰度改写：
  当检测到复杂度过高时，nopus 会向代理发送针对性的改写指令，要求保留含义但替换公式化框架，提供平实直接的表达。
• 三级灵敏度调节：
  • Low (5.3% 触发率)：仅干预最晦涩的响应。
  • Medium (9.9% 触发率)：平衡默认设置，捕获持续的困难表达。
  • High (18.6% 触发率)：倾向于极致的平实语言，接受更高频率的干预。
• 额外简单模式 (Extra-Simple)：
  启用后，nopus 会要求代理提供简短的初始答案，仅保留核心结论、立即行动及关键警告，将理由和细节留待后续追问。
• 避免无限循环：
  每个响应最多请求一次自动改写，防止陷入重试死循环。

安装与使用

1. Pi

# 从 npm 安装
pi install npm:@syzom/nopus
# 或从 GitHub 安装
pi install git:github.com/Vistyy/nopus

常用命令：/nopus status, /nopus on/off, /nopus extra-simple on/off

2. Claude Code

/plugin marketplace add Vistyy/nopus
/plugin install nopus@nopus

3. Codex

codex plugin marketplace add Vistyy/nopus
codex plugin add nopus@nopus

配置与管理

nopus 支持通过配置文件 ($XDG_CONFIG_HOME/nopus/config.json) 或环境变量进行深度定制：

• 灵敏度：complexitySensitivity (low/medium/high)
• 证据展示：includeEvidence (是否在改写请求中展示具体问题示例)
• 隐藏原响应：pi.hideOriginalResponse (仅在 Pi 中有效，隐藏被判定为复杂的原始响应)

手动简化：如果 nopus 未自动触发但你仍觉得回复啰嗦，可使用手动命令（如 Pi 中的 /skill:nopus-simplify）立即请求改写。