# @cleanslop/cli 中文文档

规范地址：https://npmcn.com/package/%40cleanslop/cli/

版本：0\.2\.0
npm 元数据更新时间：2026-11-10T21:38:19.305Z
中文译文更新时间：2026-11-10T21:39:32.335Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cleanslop/cli
原文对照：https://npmcn.com/package/%40cleanslop/cli/?lang=original
项目主页：https://cleanslop.com/agents
源码仓库：https://github.com/cleanslop/cli

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：550 kB，124 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：0 个
- 首次发布：2026-10-14T07:36:28.762Z
- 最新版本发布：2026-11-10T21:38:18.894Z
- 近 30 天下载量：8350（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：75（近 12 个月 75 个）

## 中文简介

CleanSlop CLI – 从您的编码代理器进行准备扫描

## 安装

```sh
npm install @cleanslop/cli
```

也可以使用：`pnpm add @cleanslop/cli`、`yarn add @cleanslop/cli`、`bun add @cleanslop/cli`

## README

# 清理Slop 中央LI

[![npm](https://img.shields.io/npm/v/@cleanslop/cli)](https://www.npmjs.com/package/@cleanslop/cli) [![license](https://img.shields.io/npm/l/@cleanslop/cli)](https://npmcn.com/package/%40cleanslop/cli/LICENSE) [![node](https://img.shields.io/node/v/@cleanslop/cli)](https://npmcn.com/package/%40cleanslop/cli/package.json)

准备扫描你的编码代理。 CLI开始 [清除Slop](https://cleanslop.com/) 扫描你的回购,等待它, 并把报告拿回来 这样特工就可以修复它找到的东西。 发表于 `@cleanslop/cli` (宾) `cleanslop`) (中文(简体) ).

-   设置指南和 FAQ : [https://cleanslop.com/agents (中文(简体) )](https://cleanslop.com/agents)
-   代理向导( Markdown) : [https://cleanslop.com/agents.md (英语)](https://cleanslop.com/agents.md)
-   喜欢MCP吗? 安装远程服务器 : [https://cleanslop.com/mcp (英语)](https://cleanslop.com/mcp)

## 0.2.0 新设

-   **Rescans只检查什么改变了.** `cleanslop scan` 以同一分支或同一上传文件夹的最后一次扫描为基础,费用仅是自此而改变的文件。 它印着它所依赖的扫描, 或者它为什么进行全扫描. `--full` 重新扫描所有的东西;当一切都没有改变时,它会问在这样做之前.
-   **功劳.** 余额、计划和包数计入入计量。 超过4个入分的扫描在收费前停止并询问;在回答是后,重新运行 `--confirm-credits <credits>`。 。 。 .
-   **Claude 代码插件已移动** 改为 [清洁/技能](https://github.com/cleanslop/skills)。 。 。 .

其他东西都在里面 [变动情况](https://npmcn.com/package/%40cleanslop/cli/CHANGELOG.md)。 。 。 .

## 快开始

```bash
npx -y @cleanslop/cli scan
```

检查一下谁的 `HEAD` (原始内容存档于2018-09-29). 被推入github.com. 礛 `npx -y @cleanslop/cli setup` 安装 Claude 代码、 Cursor 和 Codex 的技巧或规则, 所以您的代理为您运行 .

要求节点22或更晚(节点20是寿命终止;npm警告在那里). **零运行时间依赖关系.** 链接命令外壳到 `link-cli` 1.2.0或以后: `CLEANSLOP_LINK_CLI` 否则 `link-cli` 打开 `PATH` 当它足够新, 否则被钉住 `npx @stripe/link-cli@1.3.0`. link-cli 从 CLI 的配置文件夹中运行到工程的 `node_modules/.bin` 关 `PATH`,因此扫描的回波无法选择;上传了内置的焦油刻录器包.

## 图标

| 命令 | 目的 |
| --- | --- |
| `scan` (默认) | 解析 github.com 来源 + Head 并启动扫描 。 它建立在分支(或上传的文件夹)的最后一次扫描上,并且只花费自此而改变的文件. `--wait` 等待报告; `--full` 重新扫描所有东西; `--upload` 扫描本地文件,而不是被推动的(在人类选择之后); `--confirm-credits <credits>` 批准4分以上的价钱 只有在人类同意之后; `--force` 跳过同一承诺去dupe |
| `login [--link [--agree]] [--no-wait | --resume]` | RFC 8628 设备流. 印刷品 `verification_uri_complete` 财务报告和审定财务报表 `user_code`。 。 。 . `--no-wait` 存储设备代码; `--resume` 结束了. `--link` 使用 Frede 链接在其中签名 `link-cli` 而不是 GitHub; 通过 `--agree` 只有在人类对引用的术语问题表示同意后 永不印出证相. |
| `logout [--all]` | 撤销服务器侧面, 删除此来源的证书, 并放弃其待定的 GitHub 登录和 Link 支付 . `--all` 取消每个保存的源代码并删除所有本地 CleanSlop 数据( Link 自己的会话和 `~/.link-cli` 文件保留; `link-cli auth logout` 清除会话) |
| `whoami` | 已连接 `@login`,指代后4号,每月计分计划,还有积分(扫描成本多少). `--json` 添加 `creditBalance` |
| `status [id] [--wait]` | Poll 扫描状态 |
| `report [id] [--format md|json] [--preview]` | 获取 `cleanslop.report.v1` (整个清单: `limit=250`) (中文(简体) ). 最终的Markdown报告附有经确认或需要投入的调查结果,然后由 `fix_findings` 问题( 给它们 / 先给我看 / 现在不行 ) ; `scan` 做同样的。 出口停留0. |
| `setup` | 专业技能/规则。 从不登录,从不写一个符号 |
| `redeem <code>` | 重写一个广告代号 人类给你的奖金`POST /api/agent/v1/credits/redeem`) (中文(简体) ). 每个账户一个代码; `promo_invalid` 编号 : `promo_already_redeemed` 12号出口 `ask_human` 块. |
| `credits buy --link [--pack p5|p15|p40] [--no-promo] [--no-wait | --resume]` | 链接账户:从链接核准中购买一次性信用包(`link-cli spend-request create`,则 `POST /api/agent/v1/credits/purchases`。 。 。 . `--pack` 需要没有终端(人类取出) `p5`。 。 。 . `--no-promo` 跳过促进码选择. `--no-wait` 打印批准内容并退出10; `--resume` 继续, 保存在 `pending-spend-request.json`。 。 。 . |
| `billing` | 链接账户 : `POST /api/agent/v1/billing/sign-in-link` 拥有服务器电子邮件与账户的Link地址的登录链接,其中人类订阅,购买信用或取消计划. 打印它去的面具地址,加 `/signin/email?from=agent` 和未到时输入的被遮盖的邮件。 当服务器无法发送( 电子邮件登录, 速率有限) 或年龄较大( 404) 时, 读取 `webBilling` 从 `GET /me`),它只打印出输入的地址页。 CLI从来没有看到链接。 出口 10 带有一个 `ask_human` 块; `--json` 指纹 `{sent, expiresAt | reason, webBilling}`。打印“本账户不可用”(Exit 0),不包含 `webBilling`。 。 。 . |
| `plan [starter|pro|max]` | 链接账户:启动每月一次的每月计划,从经常性的链接核准中支付(`link-cli spend-request create --recurring-interval month`,则 `POST /api/agent/v1/plans/purchases`。没有计划名称 经纪人得到一个 `link_plan` 问题(Startter, Pro, Max, 每月价格, 现在不行). 一样 `--no-wait` 编号 : `--resume` 流动为 `credits buy --link`,保存在自己的 `pending-plan-request.json`当CleanSlop不提供链接计划时,它会做什么 `billing` 已经 印刷"开始"清扫"......计划"(出道0). 更改或取消计划 `billing`。 。 。 . |

### 单单

-   `--wait` 默认为 **8分钟** 当没有规定期限时.
-   `--wait 75m` 是克劳德代码的背景预算.
-   持续时间: `30s`, (中文(简体) ), `8m`, (中文(简体) ), `1h`。 。 。 .
-   荣誉 `pollAfterSec` (10个待通过/第一次通过,20个审查,30个过去p90);投票从不快于3秒. 等待时打印ETA.
-   截止时间: 退出 **第75条** 打印 ETA + `cleanslop status <id> --wait`。 。 。 .

### 设置

默认是 **用户范围**数字 :

| 探员 | 路径 |
| --- | --- |
| 克劳德代码 | `~/.claude/skills/cleanslop/SKILL.md` |
| 光标 | `~/.cursor/rules/cleanslop.mdc` |
| 代码 | 标记块 `~/.codex/AGENTS.md` |

`--project` 写入 `.cursor/rules/cleanslop.mdc` 还有一个 `AGENTS.md` 在当前 repo 中标记. `--dry-run` / 非TTY 无 `--yes` 只打印计划. `--uninstall` 删除标记块/ 拥有的文件.

技能 / 光标规则 / AGENTS 片断来自 [`assets/skill-core.md`](https://npmcn.com/package/%40cleanslop/cli/assets/skill-core.md)。克劳德代码插件 `SKILL.md` 内 [清洁/技能](https://github.com/cleanslop/skills) 由同一文件提供。 远程 MCP 是一个单独的安装: 见 [https://cleanslop.com/mcp (英语)](https://cleanslop.com/mcp)。 。 。 .

## 全权证书

-   `$XDG_CONFIG_HOME/cleanslop/credentials.json` 或者说 `~/.config/cleanslop/` (温道: `%APPDATA%\cleanslop\`(中文(简体) )
-   目录 `0700`,文件 `0600`
-   拒绝在当前 git 工作树内写入
-   `CLEANSLOP_TOKEN` 财务报告和审定财务报表 `CLEANSLOP_ORIGIN` 覆盖文件/ 默认来源( n)`https://cleanslop.com`(中文(简体) )
-   该标志从未被印出; `whoami` 显示最后4

## 退出代码

| 代码 | 含义 |
| --- | --- |
| 0 个 | 完成 |
| 1个 | 意外错误 |
| 2个 | 用法或配置 |
| 10个 | 人类行动(同意、安装、重新安装或如扫描价格等问题以确认) |
| 第11个 | 付款(402起) |
| 第12条 | 政策(等待名单、β、上限) |
| 第13条 | 来源不可用( 脏, 未 pushed, 不是 github.com) |
| 20国 | 扫描失败的服务器侧 |
| 第75条 | 仍在运行; 已打印恢复命令 |

`CLEANSLOP_ACTION_REQUIRED` 块去 Stderr。 永远不要打开、批准或支付。 区块可以以 `CLEANSLOP_QUESTION:` JSON线`id`, (中文(简体) ), `header`, (中文(简体) ), `question`, (中文(简体) ), `options[]` 与 `value`, (中文(简体) ), `label`选项 `description`,以及 `run` 用于准确的下一个命令或 `next` 以平平的下一步; 具有多选择问题工具(例如克洛德密码的AskUserQuestions)的特工们应该随同询问,准确使用这些选项,从不为人类回答. 同意问题从不包含 `--agree`。 。 。 .

## Claude 代码插件

将技能和远程 MCP 服务器捆绑在一起的插件 [清洁/技能](https://github.com/cleanslop/skills)数字 :

```text
/plugin marketplace add cleanslop/skills
/plugin install cleanslop@cleanslop
```

这个 `cleanslop` 该寄存器库中的市场仍然有效;它现在从清洁/技能安装插件.

## 发展

```bash
npm ci
npm test
npm run build
node dist/index.js scan
```

`test/` 用途 `node:test` c8对一个假的HTTP服务器. 覆盖底线为90%的线路,声明和功能,分行为80%. `npm test` 并检查树名是否没有只包含上游的主机或路径(`scripts/check-public.mjs`) (中文(简体) ).

此寄存器是 CLI 上游源的只读镜像; 见 [捐款额](https://npmcn.com/package/%40cleanslop/cli/CONTRIBUTING.md) 如何拉拉要求着陆。 每个同步到 `main` 下个补丁释放阶段(`scripts/release-version.mjs`) 与 npm 出处,一个维护者在 npmjs.com 上的 Staged 包下批准它,然后发布 GitHub 版本 [变动情况](https://npmcn.com/package/%40cleanslop/cli/CHANGELOG.md)选择 `npm publish` 手边.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40cleanslop/cli/LICENSE)

## 常见问题

### @cleanslop/cli 是什么？

CleanSlop CLI – 从您的编码代理器进行准备扫描

### 如何安装 @cleanslop/cli？

在项目目录运行 npm install @cleanslop/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cleanslop，可以用 npx cleanslop 直接运行。

### @cleanslop/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cleanslop\_\_cli 是否存在。

### @cleanslop/cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cleanslop/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cleanslop/cli 可以商用吗？

@cleanslop/cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cleanslop/cli 的下载量有多少？

根据 npm 官方下载统计，@cleanslop/cli 在 2026/10/10 – 2026/11/08 这 30 天内被下载 8,350 次，日均约 278 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cleanslop/cli 还在维护吗？

最新版本 0\.2\.0 发布于 2026/11/11（今天）；至今共发布 75 个版本，其中过去 12 个月发布了 75 个；首次发布于 2026/10/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。