前言¶

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