fnos-cli-skill：给 DeepSeek Harness 用的 fnOS 命令行技能

它是做什么的？

fnOS CLI Skill 是 DeepSeek Harness（DSH）的 fnOS 命令行技能插件，把 fnOS CLI 0.2.0 的能力以可被 Agent 调用的 Skill 形式接入 DSH。它解决的是「Agent 想操作 fnOS 却不知道命令怎么用」的问题，让 Agent 先加载 fnOS 技能文档，再按包内说明执行只读或授权后的命令。仓库由 fnnas-labs 维护，采用 MIT 协议，仅包含生成的技能文档与可审查的集成文件，不含原生 CLI 源码或二进制。

核心功能

• 技能注册：插件包内的适配器会显式注册 fnOS CLI 技能，安装组合包本身并不等于技能被发现，注册动作由适配器完成。
• 命令解析：适配器从依赖的资源目录中解析 CLI，DSH 命令无需全局安装 CLI 即可运行。
• 技能文档分发：仓库提供生成好的技能文档与可审查的集成文件，Agent 加载后按包内调用说明操作。
• 版本锁定：桥接包精确依赖 fnOS CLI 0.2.0，保证技能文档与命令行为一致。
• 审计快照：仓库内检入的适配器快照与 npm 发布版本一致，便于人工核对，而非运行时入口。

怎么使用这个插件？

在 DSH 中启用后，Agent 会先加载 fnOS 技能，再依据包内说明调用命令。登录必须由用户在真实终端中亲自完成：打开授权链接、在浏览器中登录并批准访问，然后把一次性验证码粘贴回 CLI 提示符，切勿把密码、授权码或访问令牌交给 Agent。授权完成后可先执行只读请求验证连通性，再逐步使用技能。DSH 场景需在同一台 DSH 主机、同一系统用户、同一配置环境与同一 profile 下的终端中操作，远程浏览器、SSH 会话与容器不会自动共享该会话；macOS 上后台访问钥匙串可能还需要系统授权。

报错怎么排查？

若命令找不到或技能未被发现，先确认适配器已完成技能注册，并核对所用 profile 与配置环境是否一致。若登录状态异常，检查是否在真实交互终端中完成授权，远程环境不会自动继承会话。macOS 上若出现钥匙串访问被拒，按系统提示授予权限后重试。