前言¶

DeepSeek Harness（DSH）采用插件化架构扩展功能。对于需要通过智能体（Agent）管理 fnOS CLI 的开发者，fnOS CLI Skill 插件提供了一个将 CLI 挂载到 DSH 环境的桥接方案。

插件介绍¶

fnOS CLI Skill 是 fnOS CLI 的 DSH 插件，由 fnnas-labs 维护。该插件本身包含生成的文档和集成文件，但不包含原生 CLI 的源代码或二进制文件。它主要用于在 DSH 环境中调用 fnOS CLI。

核心功能¶

1. 公共桥安装：插件会将公共桥安装到 DSH 的指定配置文件中。
2. 依赖解析：当插件解析依赖时，会自动请求 @fnnas-labs/fnos-cli@latest 版本。
3. Agent 执行流程：Agent 首先加载 fnOS CLI，随后遵循该 CLI 包内部的本地调用指令进行执行。

安装与启用¶

通过 DSH 安装该插件：

dsh plugin --profile headless add github:fnnas-labs/fnos-cli-skill

注意：现有安装不会自动更新。如需更新，请手动重复执行上述安装命令。

典型用法¶

使用该插件进行授权和验证。

授权流程：
1. Agent 会生成一个授权链接。
2. 在浏览器中打开该链接，完成登录并批准访问权限。
3. 将返回的一次性代码发送给 Agent。

验证请求：
授权成功后，可以执行只读请求进行验证：

fnos-cli --profile home system info

适用场景与注意¶

该插件适合需要通过 DSH Agent 来管理或操作 fnOS CLI 的用户。

使用时需要注意以下几点：

• 代码敏感：一次性授权代码和令牌非常敏感。聊天记录、工具记录和进程参数可能会保留这些代码。请勿在公开场合或非安全渠道发送密码、访问令牌或刷新令牌。
• 安装不等于登录：安装插件本身不会自动完成登录或授权写入操作。
• 源码分发：该仓库不包含原生 CLI 的源代码或二进制文件。
• TTY 约束：DSH 使用其包本地启动器来处理无 TTY（终端）环境的调用。

总结¶

fnOS CLI Skill 通过 DSH 为 fnOS CLI 提供了标准化的 Agent 调用入口。开发者可以通过该插件将 fnOS CLI 的能力集成到 DSH 的工作流中。

• 目录页：fnOS CLI Skill - SkillHub
• GitHub：fnOS CLI Skill