@fydeos/cli

中文文档
0.1.0-beta.19发布于 2026/11/11BSD-3-Clause零依赖近 30 天下载 3832

FydeOS 管理云CLI

中文使用文档
文档目录7 节
  1. 安装
  2. 选择环境并签名于
  3. 检查和更改设置
  4. 连接代码或克劳德
  5. 用 AI 代理安装
  6. 取消访问
  7. 许可证

FydeOS 管理云CLI

fyde 是FydeOS管理云(Admin Console)的命令行客户端。 检查资源,预览配置更改,并在授权权限下应用计划. Codex和克洛德可以通过MCP使用相同的连接.

这是一个β释放。 使用节点.js 20或后.

安装

一个命令安装 fyde并连接克洛德代码和代码 从您的管理控制台( MCP 访问) 复制, 或者使用您的环境端点 :

npx -y @fydeos/cli@latest install --endpoint https://policy.fydeos.io/mcp

它问在安装全局前 fyde 命令 (--yes 跳过问题, --skip-global 暂时的拷贝 npx 运行不计为已安装),打开控制台以批准登录(检查一次性代码),安装捆绑的技能并注册 a fydeos 安装时使用 Claude Code和Codex 的 MCP 服务器,保留任何已存在的条目. 它默认请求写入访问; 使用 --read-only 读取。 对于Codex,包括ChatGPT桌面应用程序所构建的Codex,它附加一个 [mcp_servers.fydeos] 表格为 ~/.codex/config.toml (单位:千美元)$CODEX_HOME/config.toml )在支持文件后;现有设置不更改。 完成后列出下一步: 运行 fyde context (或 npx -y @fydeos/cli@latest context ))以确认登录并授予访问权限,重新启动它所配置的AI客户端,以及如何连接任何它无法连接的功能.

fyde 是您的 AI 代理为您运行的一发命令; 运行时无需参数即可显示如何启动和命令列表 .

要手动安装 :

npm install --global @fydeos/cli@latest
fyde --version

包中包含macOS arm64/amd64,Linux arm64/amd64和Windows amd64的二进制. 它在当地选择匹配的二进制并检查其SHA-256. 安装需要访问 npm; 它不联系我们内部的 GitLab 服务器 。 完整的包被压缩了约20 MB.

选择环境并签名于

管理控制台MCP 终点
https://admin.fydeos.io (英语)https://policy.fydeos.io/mcp (英语)
https://admin.fydeos.com (中文(简体) )https://policy.fydeos.com/mcp 页面存档备份,存于互联网档案馆

选择您企业注册的生产环境 。 可用性取决于部署的后端版本. 端点决定环境;npm的下个通道选择CLIβ版本.

fyde auth login --endpoint https://policy.fydeos.io/mcp
fyde auth status
fyde context

登录打开匹配的 Admin Console 授权页面 。 审批前先审查一次性代码,企业,组织范围和类别. 默认情况下请求写入访问(批准管理员可以缩小其范围). 添加 -- read- only 请求只读访问,或者 -- no-browser 手动打开所显示的链接 。 登录使它成为了当前登录:后来的命令不用任何额外的旗帜使用. 每个登录都保存在从它的Admin Console主机取来的名称下(例如admin.fydeos.io);再次登录到同一端点重复使用它,所以你从不选择或输入名称. --profile(或FYDE PROFILE)只需要为同一端点保留两个登录,例如两个企业;由更旧的发布(例如prod-io)所保存的登录继续工作. Admin Console MCP访问页面显示自己环境的确切命令. auth 登录会删除证书和已保存的登录 .

配置文件以 ~/.config/fyde/config.toml 活出,并包含端点,不是符号. 证书留在OS密钥环中,并被绑定到准确的终点. 在 CI 中, 将 FYDE ENDPOINT 和 FYDE TOKEN 通过秘密设置一起输入; 此双重置覆盖已保存的配置文件, 并且不持续 。 不要将密码或令牌放入命令参数或共享配置.

检查和更改设置

在准备更改前先读取活计 。 将组织单位ID改为授权您管理的:

fyde search guest --page-all
fyde schema device.guest_mode
fyde policy get device.guest_mode --ou 12
# Preview only; requires a write credential:
fyde policy set device.guest_mode --ou 12 --set guest_mode_enabled=false
# Review and apply the returned plan:
fyde plan show PLAN_ID
fyde plan apply PLAN_ID --wait
fyde op get OPERATION_ID

命令还涵盖应用程序和Kiosk,网络和证书,FydeSign,设备,目录和企业设置. 运行 fyde -- help,然后是命令组的 -- help,用于使用. 命令和可写字字段取决于服务器的活式计划,证书范围,管理员权限和适用的许可证.

默认写入预览 。 在审核计划后明确应用. 如果应用出时,则检查原操作并重试相同的计划和偶应键;不要为不确定的写入创建替换计划. 保存的设置或成功的通知不能证明物理设备应用过它.

连接代码或克劳德

fyde mcp config --client codex
fyde mcp config --client claude
fyde skills install --client all

在您的AI客户端的MCP配置中添加相应的打印片段. 它开始 fyde mcp 服务与所选的配置文件, 并且没有包含任何符号 。 首先在全球安装fyde,以便AI客户端能够找到命令. 技能安装保存已存在的文件,除非您明确使用 --force。 MCP客户使用相同的授权和计划工作流程.

用 AI 代理安装

在Admin Console中,打开 MCP 访问 → 设置指南 → 让 AI 代理安装它,并将指令粘入运行在您计算机上的 Claude Code, Codex 或类似代理. 它们包含了这一环境的确切终点和概况。 代理安装 @fydeos/cli@latest 并开始登录;您仍然检查一次性代码,并在浏览器中自行批准。 代理从不处理一个令牌,并在应用前预览更改. 完整的代理指导船只 以这个包件 AGENT_INSTALL.md 网址为https://unpkg.com/@fydeos/cli@latest/AGENT INSTALL.md.

取消访问

fyde auth logout --revoke

这将取消连接的证书并删除其本地密钥环条目 。 环境证书也必须从进程或保密设置中删除。 管理员可以在匹配的Admin Console中管理和吊销证书.

许可证

BSD 3-Clause许可证. 版权 (c) 2026, Fyde Innovations Limited. 见 LICENSE 此软件包中的文件; 捆绑的第三方组件的许可证在 THIRD_PARTY_NOTICES。使用FydeOS管理云本身须遵守 FydeOS 服务条件。 。 。 .

版本与发布记录

@fydeos/cli 共发布 18 个版本,首次发布于 2026/11/02;过去 12 个月发布了 18 个版本。

版本发布日期距今
0.1.0-beta.19latest2026/11/114 天前
0.1.0-beta.172026/11/105 天前
0.1.0-beta.162026/11/105 天前
0.1.0-beta.152026/11/0411 天前
0.1.0-beta.142026/11/0411 天前
0.1.0-beta.132026/11/0312 天前

关于 @fydeos/cli 的常见问题

@fydeos/cli 是什么?

FydeOS 管理云CLI

如何安装 @fydeos/cli?

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

@fydeos/cli 支持 TypeScript 吗?

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

@fydeos/cli 需要什么版本的 Node.js?

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

@fydeos/cli 可以商用吗?

@fydeos/cli 使用 BSD-3-Clause 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括,不构成法律意见,请以许可原文为准。

@fydeos/cli 的下载量有多少?

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

@fydeos/cli 还在维护吗?

最新版本 0.1.0-beta.19 发布于 2026/11/11(4 天前);至今共发布 18 个版本,其中过去 12 个月发布了 18 个;首次发布于 2026/11/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。