fnos-cli-skill

fnOS CLI Skill

fnOS 的使用指南与公开集成内容。运行时 CLI 与 Skill 来自同一 npm 包版本。 安装 Skill

独立 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 或执行策略阻止启动时先处理本机环境，再重试原入口。 授权与使用

从 Skill 主入口开始。Agent 运行 login --authorize-only --agent-name ' ' 提供链接，用户自行在浏览器登录并回传一次性 code。Agent 保持目标、profile 与执行环境一致，运行 login --code 并验证令牌保存及只读请求。无需用户终端；不要提供密码或 token。详细流程见 OAuth 指南。fnOS 的 DSH 使用同包启动器和 Skill。 许可

标准 MIT，版权主体为 Guangzhou TR Intelligent Manufacturing Technology Co., Ltd.，覆盖分发的 CLI、Skill 与集成代码，不覆盖 NAS 操作系统、服务端或 API 访问授权。详见 LICENSE 与 第三方声明。 fnOS CLI 的 DSH 集成

@fnnas-labs/fnos-cli 包含固定版本的 CLI 启动器、同版本 Skill 和 DSH bundle。bundle 激活 npm/dsh.mjs，向 Skill 服务显式注册 fnos-cli；安装 bundle 与注册 Skill 是两个步骤。

安装到实际使用的 DSH profile，例如：

npm 处理发布期间 latest 可能仍为上一版。检查安装版本及命令帮助；已有 DSH 安装需要显式升级。复现特定版本时，用明确版本替换 latest。

Skill 根据资源目录定位同包 ../npm/run.cjs，并指导 Agent 通过 Node 调用；不依赖全局命令。适配器仅加载包内文档，不执行命令、不自动添加写确认参数、不登录。 首次运行与共享缓存

轻量包的首次 --version、--help 或业务调用才会下载执行主机对应的一份原生 CLI；安装 bundle、导入适配器和注册 Skill 本身不触发下载。同包运行清单绑定产品、版本和 SHA-256，不使用 PATH 上其他 CLI，也不在运行时解析 latest。