mirror of https://github.com/affaan-m/ECC.git synced 2026-08-17 21:15:40 +02:00

Files

T

28e53a0bc1 feat(install): add guided multi-harness installer (#2649 )

* feat(install): add guided Claude plugin setup

* fix: support Claude command shims on Windows

* feat: support safe Claude plugin scope migration

* fix(install): preserve interactive setup terminal

* fix(install): auto-migrate setup scope changes

* feat(install): add guided multi-harness installer

* fix(install): sync Yarn binary metadata

* fix(install): handle wizard EOF on Node 18

* ci: allow installer matrix tests to finish

* test(install): allow slower PowerShell delegation

* fix(install): harden guided provider reconciliation

* test(install): harden packaged and local compatibility

* chore: prepare guided installer release 2.2.0

* fix(install): report refreshed Codex marketplace state

* fix(install): verify managed content provenance

* test(install): allow empty Yarn smoke fixture

* test(install): invoke Windows package shims safely

* fix(install): close cross-platform release gaps

* fix(install): require trusted GitHub origins

* fix(install): preserve hook profile precedence

* refactor(install): centralize trusted GitHub origins

* ci: retrigger workflow run after merge of main

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

2026-08-06 15:39:49 -04:00

7.1 KiB

Raw Blame History

name, description, metadata

name

description

metadata

configure-ecc

在 Claude Code、Codex 或 Kimi 内引导 ECC 安装、更新或重新配置，同时严格遵守各家工具真实的插件、范围和 Hook 能力。

origin
ECC

配置 Everything Claude Code

在当前工具内运行对话式向导：先检查，只收集受支持的选项，预览，只确认一次，以非交互方式执行，验证，最后才显示欢迎信息。不要把 ECC 克隆到临时目录，也不要手动复制插件组件。

在用户自己操作的终端中，规范入口是 ecc setup 和 npx ecc-universal setup。在工具内请改用下方参数完整的非交互命令。

按当前工具分流

Claude Code：使用下面完整的范围与 Hook 向导。
Codex：使用 Codex 原生插件生命周期；不要提供 Claude 范围，也不要映射 Claude 的四种 ECC Hook 配置。
Kimi：把项目表面安装到 ./.kimi-code；Kimi 不支持 ECC 的 Claude 生命周期 Hook 配置。
无法确定工具时，先说明检测依据，再询问要配置哪一个，不要直接修改。

此技能是安装后的重新配置路径，无法拦截或取代提供商内置的首次安装界面。

Claude Code：运行完整对话式向导

1. 只读检查

运行以下两条命令，总结 ECC 的安装范围、启用状态和 marketplace 来源：

claude plugin list --json
claude plugin marketplace list --json

只有一个现有 ecc@ecc 时，将本次视为重新配置。不要把 Claude 提供商所有的 “Open home page”控件当作安装证据。若 setup 报告多个 ECC 范围、旧版或手动安装、配置损坏或 marketplace 冲突，请停止并原样报告恢复建议，不要猜测要删除哪个。

2. 只收集两个选择

只询问一次安装范围，并要求且仅要求一个值：

user | project | local
user 对当前用户全局可用。
project 通过仓库设置共享。
local 仅当前项目私有。

界面中只能把选中的一个范围显示为已选或正在安装。如果用户从唯一现有范围切换到另一范围，说明这是范围迁移，并在下方命令中加入 --move-scope。

只询问一次 Hook 模式，并要求且仅要求一个值：

off | minimal | standard | strict
off 保留技能和命令，但关闭 ECC Hook 自动化。
minimal 只启用最轻量的生命周期和安全自动化。
standard 平衡质量和安全自动化。
strict 启用最严格的检查和提醒。

Hook 偏好是个人 Claude 插件配置，不会跟随所选安装范围。

3. 预览并只确认一次

优先使用插件自带的 setup 脚本。替换两个已选值，只在范围迁移时加入 --move-scope：

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

如果 $CLAUDE_PLUGIN_ROOT 不可用，使用已发布的 npm 包：

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --dry-run --json

只显示一次确认摘要，内容包含计划操作、唯一范围、唯一 Hook 模式、marketplace 操作和任何从来源到目标的迁移。只问一个是/否问题。不要通过工具的 Shell 调用不带参数的交互式 ecc setup，因为该 Shell 通常不是 TTY。

4. 应用明确选择

确认后，使用同一路径但去掉 --dry-run。保留每个明确选择，并请求 JSON：

node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

备用命令：

npx --yes --package ecc-universal ecc setup --mode claude-plugin \
  --scope <scope> --hooks <hooks> [--move-scope] --yes --json

5. 先验证，再显示欢迎信息

必须得到零退出状态，且 setup 结果中的 scope 和 hooks 必须等于所选值。然后独立运行：

claude plugin list --json

只有在所选范围中恰好存在一个已启用的 ecc@ecc 条目时才继续。如果 $CLAUDE_PLUGIN_ROOT 可用，把成功 setup 的 action（installed、updated、 migrated、resumed 或 already-migrated）传给内置渲染器：

调用前必须确认提供方报告的版本匹配 scripts/lib/terminal-welcome.js 中的 ECC_VERSION_PATTERN。异常版本文本应被拒绝，不得插入 shell 命令。

node -e 'const { renderTerminalWelcome } = require(process.env.CLAUDE_PLUGIN_ROOT + "/scripts/lib/terminal-welcome"); process.stdout.write(renderTerminalWelcome({ action: process.argv[1], version: process.argv[2], color: process.stdout.isTTY }));' "<action>" "<installed-version>"

欢迎信息只渲染一次。失败、预览、取消、范围或 Hook 不匹配、无法验证时都不显示；改为报告错误和恢复方法。验证完成后，提醒用户运行 /reload-plugins 或重启 Claude Code。

Codex：使用原生插件生命周期

使用 codex plugin marketplace list --json 和 codex plugin list --available --json 检查。 Codex 的原生插件命令没有 Claude 式 user | project | local 选择器。不要询问 Claude 范围或 Hook 四档模式。Codex 原生插件支持提供商专用 Hook，但 Codex 会要求用户明确信任。让 Codex 显示该信任决定；不要声称 Claude 的四种配置可以映射到 Codex。

如果缺少 ECC marketplace，请添加；否则刷新快照：

codex plugin marketplace add affaan-m/ECC
codex plugin marketplace upgrade ecc --json

只确认一次，然后安装或幂等刷新已安装缓存，并验证：

codex plugin add ecc@ecc --json
codex plugin list --json

只有 JSON 报告 ECC 已安装并提供 installedPath 时才继续，然后渲染已验证组合包的欢迎信息：

installedPath 只能使用 Codex JSON 返回的原始绝对路径，并拒绝控制字符。版本必须通过 ECC_VERSION_PATTERN 验证。请使用下面的 argument array 直接调用 node；这是工具 API 调用，不是 shell 命令：

["<installedPath>/scripts/welcome.js", "--action", "configured", "--version", "<installed-version>"]

如果当前工具无法把可执行文件与 argument array 分开传递，请跳过欢迎信息。不得使用 Codex JSON 中的值构造 shell 命令。

绝不要声称 Claude 的 off | minimal | standard | strict 配置已应用到 Codex。

Kimi：安装项目表面

确认前说明能力摘要：目标为 ./.kimi-code；ECC 生命周期 Hook 为 hooks=unsupported。不要询问 Claude 范围或 Hook 模式。先预览：

npx --yes --package ecc-universal ecc install --profile core --target kimi --dry-run

只针对该项目目标确认一次，然后执行去掉 --dry-run 的同一命令。使用以下命令验证：

npx --yes --package ecc-universal ecc doctor --target kimi

只有 doctor 成功，且已安装的指令和技能仍位于 ./.kimi-code 内时才运行：

npx --yes --package ecc-universal ecc welcome --action configured

不要声称 Kimi 已安装或配置 ECC 生命周期 Hook。

7.1 KiB Raw Blame History Unescape Escape