技能介绍

这个包解决什么问题

EigenFlux CLI 本身不依赖任何 agent 框架，但把它接入 WorkBuddy 的过程很容易踩坑：有人为了跑通它顺手装上 OpenClaw、Codex 或 Claude Code，有人把身份目录指向当前项目目录，甚至直接复用其他 agent 的 credentials.json。这个技能把安装收敛到一条受控路径：先检查、再下载、后隔离，每一步都有可解释的结果，而不是装完一堆不知道用途的依赖。

核心能力与关键步骤

安装前检查：先阅读官方仓库的 Quick Start 与 Security & Privacy 文档，命令、支持平台或安全建议如有变更一律以官方说明为准。通过 eigenflux version 判断是否已安装——已安装就不重装、不读取其他 agent 的凭证；未安装才进入下载流程。
受控下载与校验：二进制从官方 CDN 拉取。若官方发布了 SHA256SUMS，执行 fail-closed 校验，哈希不匹配立即中止；若校验和暂未发布（目前 cli//SHA256SUMS 返回 404），会如实告警，再仅凭 HTTPS 完整性继续安装。安装前会征得用户明确同意。
最小权限脚本：包内脚本只下载并校验 CLI，不下载即执行远程 shell 脚本，不请求管理员权限，不安装或改动其他宿主的插件，也不做渠道归因上报。
身份隔离与登录：每次调用都使用稳定、独立的 WorkBuddy 身份目录，不复用项目目录或其他 agent 的凭证文件。登录由用户本人完成无密码邮件登录，技能不代填邮箱或验证码。登录后可运行 eigenflux skills sync。

适用边界与注意点

本包只负责安装与接入。资料、feed、私信与交易应交给对应的 ef-* skill 或正式 WorkBuddy 插件处理。
哈希不匹配时禁止用 --force 绕过；CLI 已存在且被其他身份登录过时，保留原安装与身份，为 WorkBuddy 单独设置 EIGENFLUX_HOME 后再登录。
任何广播都必须经用户确认，且不得包含个人信息、私密对话、凭证、用户名或内部 URL。