mcpField
F
fnos-cli

fnos-cli

github.com/fnnas-labsCloud & DevOps2548 installsUpdated 1w ago
Repository

About fnos-cli

fnos-cli is a skill for Agents managing fnOS devices from the command line. It covers files, apps, Docker, storage, networking, system tasks, and authorization, with explicit handling for installation, upgrades, and high-risk writes.

Key features

  1. 01Manage files, photos, and shared folders
  2. 02Manage apps, Docker, and downloads
  3. 03Inspect monitoring, logs, and storage
  4. 04Manage networking, system, and permissions
  5. 05Handle OAuth authorization by procedure

Use cases

  1. 01Search or upload NAS files
  2. 02Check container, app, and download status
  3. 03Inspect storage, hardware, and runtime metrics
  4. 04Run device management commands after authorization

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/fnnas-labs/fnos-cli-skill --skill fnos-cli

After installing, type/fnos-cliin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

LICENSE
entries/
trim-app.md
trim-baidu-netdisk.md
trim-docker.md
trim-download.md
trim-file.md
trim-log.md
trim-monitor.md
trim-network.md
trim-photos.md
trim-shared.md
trim-storage.md
trim-system.md
trim-user.md
reference/
_conventions.md
_index.md
app-center.md
baidu-netdisk.md
dockermgr.md
download.md
file.md
log.md
network.md
oauth.md
photos.md
power.md
resmon.md
stor.md
sysinfo.md
user.md

Details

From the project README

fnOS

使用 fnos-cli 管理设备。安装与升级都是显式操作；执行前检查实际版本和命令帮助。

独立 Skill 启动器

从当前加载的 Skill 目录定位 scripts/fnos-cli（macOS/Linux）或 scripts/fnos-cli.cmd（Windows），使用绝对路径。将本 Skill 示例中的 fnos-cli 替换为该路径，保留每个参数及其引号。先执行 --version 和相关 --help。

首次执行自动下载本机所需的一份固定版本 CLI；提示写入 stderr，成功后复用当前用户缓存。独立执行无需 Node/npm 或全局 CLI。macOS/Linux 需要系统的 curl、gzip、SHA-256 工具（sha256sum 或 shasum）及常用 shell 工具。下载失败、缓存损坏或镜像配置请读首次运行指南，按其中步骤恢复后重试原命令。更新 Skill 是显式操作，已有入口不自动升级。

Windows 可在 PowerShell 5.1 或 7 中调用 scripts/fnos-cli.ps1；.cmd 入口使用系统 Windows PowerShell。按当前 shell 规则传递参数，PowerShell 的 JSON 参数建议用单引号。Windows 使用系统 .NET 下载和解压，不需要 Unix 工具；缺少 PowerShell 或执行策略阻止启动时先处理本机环境，再重试原入口。

授权与连接

登录、profile、连接失败及授权恢复先读连接入口和 OAuth 指南。字段约定见公共约定，模块使用方式见索引。

  1. Agent 在用户指定的目标和 profile 执行 login --authorize-only，把返回链接交给用户。
  2. 用户自行在浏览器登录并授权，把一次性 code 主动发回。用户无需运行终端。
  3. Agent 在同一执行主机、系统用户、配置环境、profile 和连接参数下执行 login --code。确认令牌已保存并执行只读验证后才报告连接成功。
fnos-cli --profile home --host <host> --port <port> login --authorize-only
fnos-cli --profile home --host <host> --port <port> login --code '<code>'
fnos-cli --profile home system info

用户密码、2FA 和浏览器确认由用户处理。只接收用户主动发来的 code，不复述、额外落盘或转发。code 可能留在聊天、工具调用和进程参数中；不能承诺无留存。token 与 PKCE verifier 留在 CLI 受控存储，不输出到聊天。

使用规则

  • 两产品的命令、配置、profile 与登录状态独立。新版需重新授权，不读取或迁移旧登录数据，也不自动删除旧凭据。
  • 只使用本产品的 FNOS_CLI_* 配置变量。没有显式连接参数时，仅恢复当前产品、当前 profile 的目标；无记录时使用 localhost:5666。
  • 文件写操作默认使用具体 /vol{n}/... 路径。高风险操作须核实用户意图及命令的 --yes 要求；不把设备验收变成默认写操作。
  • raw 仅对内置审计过的只读端点免除 --yes；未知端点名称不能证明只读。
  • CLI 和 Skill 来自同一版本的包。首次安装、升级或公开文档变化后检查实际 --version 和相关 --help，不假定 latest 已完成传播。

命令与任务一览

  • 连接与授权: 登录、选择连接目标或 profile、排查登录状态和连接问题，以及应用通用安全规则时使用。
  • 文件: 列出或搜索文件、上传本地文件、检查共享目录和 ACL，或判断当前用户目录与 NAS 路径语义时使用。
  • 照片: 浏览相册扫描目录、搜索照片、查看详情，以及获取缩略图或原图预览地址时使用。
  • 应用中心: 管理已安装应用、应用中心安装、FPK 软件包、更新、应用入口与生命周期操作。
  • Docker: 查看和管理 Docker 镜像、容器、Compose 项目及长时间运行的生命周期操作。
  • 下载: 列出、搜索、创建和控制下载任务，查看任务文件、统计和状态变化。
  • 百度网盘: 检查百度网盘授权、容量、云端文件、分享保存、NAS 传输和定时同步。
  • 日志: 浏览筛选日志、列举日志模块、清除或导出记录、配置归档，并复制或取消诊断日志。
  • 监控: 查看 CPU、内存、网络、磁盘、进程、服务、电池、风扇、GPU/NPU 与蜂鸣器告警等运行时指标。
  • 网络: 管理网络服务开关，包括开启或关闭 SSH，并确认写操作的授权要求。
  • 存储: 查看存储池、磁盘与 SMART 数据，或执行挂载、扩容、磁盘替换、格式化等高风险存储写操作。
  • 系统与电源: 查看静态系统标识、机型、版本、卷、硬件和电源计划，或重启、关闭设备。
  • 用户与权限: 查看用户、组、登录设备和当前权限，管理用户，或选择正确的已授权 profile。

Comments

Markdown supported