ECC（affaan-m 出品）

# ECC：智能体运行框架操作系统（Agent Harness Operating System）安装说明

这个工具包里是 Mindket 写的安装说明，不含任何 ECC 自己的文件。智能体、技能、命令、钩子和插件都从 affaan-m 的仓库安装：https://github.com/affaan-m/ECC

由 Affaan Mustafa（affaan-m）制作，由 Mindket 上架。

许可证：MIT，Copyright (c) 2026 Affaan Mustafa。全文见 https://github.com/affaan-m/ECC/blob/HEAD/LICENSE

这些说明里的每条命令都照抄自作者的 README：https://github.com/affaan-m/ECC#readme

## 安装的内容

出自 README 的“Install ECC”和“Advanced Install Options”两节：

- 智能体、技能和命令。Claude Code 插件的命令带 ecc: 前缀，比如 /ecc:plan。
- 运行本地脚本的钩子，比如在会话开始、会话结束和压缩上下文之前运行。用插件安装时，它们会自动加载。
- 可选的规则包。Claude Code 插件无法附带规则，所以你要手动复制想用的那些（见 setup/claude-code.md）。
- 安装状态有记录，所以 ECC 只会删除属于它自己的文件。
- 默认定义了一个 MCP 连接器 chrome-devtools，但用插件安装时不会开启 MCP 服务器。

## 工具包里的文件

- setup/claude-code.md
- setup/codex.md
- setup/cursor.md
- setup/opencode.md
- setup/gemini-cli.md
- setup/github-copilot.md
- setup/other-agents.md（Qoder、Zed、Antigravity、Qwen、Hermes、OpenClaw、Kimi Code、CodeBuddy、JoyCode）

## 每个智能体只选一种安装方式

README 提醒不要叠加多种安装方式。往同一个智能体里装两次 ECC，可能让技能、命令、钩子或配置重复。给几个不同的智能体各装一次则没有问题。

## 更新或卸载

出自 README 的“Reset / Uninstall ECC”一节：

```
npx ecc-universal@2.2.3 list-installed
npx ecc-universal@2.2.3 doctor
npx ecc-universal@2.2.3 repair
npx ecc-universal@2.2.3 uninstall --dry-run
npx ecc-universal@2.2.3 uninstall
```

这些命令要在当初安装时所在的项目目录里运行，因为受管理的安装状态就存在那里。再次运行 `npx ecc-universal@2.2.3 setup` 可以更新 ECC，或更改它的安装范围。

如果你装的是 Claude Code 插件，先在 Claude Code 里移除插件，再只删除你手动复制过、且不再需要的规则文件夹。

如果是从源码检出的：

```
node scripts/uninstall.js --dry-run
node scripts/uninstall.js
```

Codex 有自己的更新步骤，见 setup/codex.md。

## 安全说明

- npm 包 ecc-universal 2.2.3 由 npm 用户 cogsec 发布，其登记的邮箱在作者自己的域名下。它的 repository 字段指向 github.com/affaan-m/ECC，并且没有声明 preinstall、install 或 postinstall 脚本。2026-11-01 核对，来源：https://registry.npmjs.org/ecc-universal/latest
- 作者列出的官方来源有：GitHub 仓库、ecc@ecc 插件，以及 npm 包 ecc-universal 和 ecc-agentshield。ECC Tools GitHub App 和 ecc.tools 也是官方来源。README 提醒，在别处重新上传的副本可能含有恶意软件。
- README 指出，锁定版本号不等于做过安全审计。运行包里的代码之前，先审查该版本的源码。
- /astra-review 会通过你本地的 Codex CLI 登录把 diff 发给 OpenAI，而且只在你运行它时才发送。
- ECC 不会自行上传诊断数据。

README.md  3 KB
setup/claude-code.md  3 KB
setup/codex.md  1 KB
setup/cursor.md  665 B
setup/gemini-cli.md  381 B
setup/github-copilot.md  549 B
setup/opencode.md  559 B
setup/other-agents.md  2 KB