Flaq AI 智能體指南

使用 DeepSeek Harness 連接 Flaq AI OpenAI 相容 API 的實用指南

執行開源的 DeepSeek Harness Web UI，將其連接至 Flaq AI 的 OpenAI 相容端點，再接入支援的 DeepSeek v4 模型，用於程式碼儲存庫分析和編碼工作流程。DeepSeek Harness 採用「一切皆外掛」架構：模型配接器、工具、Agent 迴圈、工作階段儲存、權限、沙箱、遙測和 Web UI 均可透過外掛與設定進行組合或替換。

智能體指南

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1DeepSeek Harness/api/v1ZCode/api/v1

安裝

執行 DeepSeek Harness

DeepSeek Harness 需要 Node.js 22.19+ 或 24+ 版本。請從要作為預設檔案系統位置的專案目錄中啟動；官方 npm 指令預設會在 http://127.0.0.1:3080 啟動 Web UI。

1

執行 DeepSeek Harness Web UI

使用官方 npm 套件啟動 Web UI。使用 DeepSeek Harness 期間，請讓此終端機保持執行。

首次執行時會下載目前版本的 @deepseek-ai/dsh 套件，並初始化 Web UI 設定檔。

官方 npm 指令

npx @deepseek-ai/dsh web

儲存庫：請前往 DeepSeek Harness 官方 GitHub 儲存庫查看最新安裝說明、版本發布、相容性說明和原始碼。

配置

將 DeepSeek Harness 連接至 Flaq AI

在 DeepSeek Harness 中開啟 Settings → Models，將 Flaq AI 新增為自訂提供商，然後輸入你的 Flaq API 金鑰。提供商 ID 儲存後無法變更，因此除非你確實需要不同的路由名稱，否則請使用 flaq。儲存提供商後，請先選擇工作區再開始工作階段。

推薦使用的 DeepSeek v4 Pro 模型，適合程式碼儲存庫分析、編碼任務，以及需要更強推理能力的工作流程。

在 Settings → Models 中，選擇 Add provider → Add a custom provider。輸入下方的值，並手動新增所選模型 ID，不要使用 Fetch available models。儲存提供商，然後為新工作階段選擇該模型。除非宣告了其他模態，否則 DeepSeek Harness 會將手動輸入的模型視為純文字模型。

請使用準確的 Flaq 基礎 URL 和 openai-completions 協定。將預留位置替換為你的 Flaq API 金鑰，並確保模型 ID 與所示內容完全一致。

Flaq AI 自訂提供商

Provider ID: flaqDisplay name: Flaq AIBase URL: https://api.flaq.ai/api/v1API protocol: openai-completionsCredential / API key: Your_Flaq_Api_KeyModel ID: deepseek-v4-pro-text-to-text

驗證

在 DeepSeek Harness 中驗證 Flaq

開啟 Web UI，選擇啟動 DeepSeek Harness 時所在的專案目錄，選擇已設定的 Flaq 模型，然後建立新工作階段。在選擇工作區之前，輸入區會一直無法使用。

DeepSeek Harness 會在終端機中輸出目前使用的 URL。預設本機位址如下所示。

開啟 Web UI

http://127.0.0.1:3080

先傳送一項唯讀任務。如果正常回答能反映所選工作區的內容，即可確認 DeepSeek Harness 能夠存取 Flaq 端點並使用已設定的模型。

測試程式碼儲存庫存取

Summarize this repository and identify its main packages. Do not modify any files.

外掛範例

安裝 DeepSeek Harness 外掛

以 DSH OpenPencil 為例瞭解 DeepSeek Harness 的「一切皆外掛」架構。完成上述 Flaq 提供商設定和驗證，停止執行中的 Web UI，然後將外掛新增至 web 設定檔，並重新啟動相同版本的 DeepSeek Harness。DSH OpenPencil 增加了可在對話中建立、預覽、檢查和編輯 .op 設計文件的工具。

1

安裝 DSH OpenPencil

使用外掛目前測試通過的 DeepSeek Harness 版本，將公開的 OpenPencil 套件新增至 web 設定檔。請在執行 DeepSeek Harness 的同一專案目錄中執行此指令。

安裝 DSH OpenPencil

npx --yes -p @deepseek-ai/[email protected] dsh plugin --profile web add @zseven-w/dsh-openpencil@latest

儲存庫：請前往 DSH OpenPencil GitHub 儲存庫查看原始碼、設定要求、版本發布和相容性說明。

2

重新啟動 Web UI

再次啟動已測試的 DeepSeek Harness 版本，讓 web 設定檔載入 DSH OpenPencil。重新開啟 Web UI 時，請讓此終端機保持執行。

重新啟動 Web UI

npx --yes -p @deepseek-ai/[email protected] dsh web
3

使用 Flaq AI 測試 DSH OpenPencil

選擇已設定的 Flaq 模型和工作區，開始新工作階段，然後傳送下方要求。當 OpenPencil 二進位檔可用時，外掛應建立一份 .op 文件，並在對話中顯示可編輯的預覽。

使用 Flaq AI 測試 DSH OpenPencil

Create a simple editable OpenPencil document with a title, a subtitle, and two feature cards. Save it as openpencil-demo.op, then render an editable preview.

開放原始碼

探索 DeepSeek Harness 官方儲存庫

DeepSeek Harness 是由 DeepSeek AI 開發的開源 Agent Harness。造訪官方儲存庫即可查看原始碼、追蹤版本發布和相容性變更、閱讀最新文件，並在開發者預覽期間回報問題。

GitHub 上的 DeepSeek Harness

開啟 DeepSeek Harness 官方儲存庫，查看原始碼、設定文件、開發說明、討論和專案更新。

開放原始碼指南

探索 Flaq AI 的開源 DeepSeek Harness 指南

透過 Flaq AI 獨立維護的社群版 DeepSeek Harness 指南，進一步瞭解初始設定以外的內容。瞭解其外掛樹、設定檔、Bundle、修補層、可替換的 Agent 迴圈、模型配接器、工具、工作階段服務、權限原則、沙箱和 Web UI 擴充功能如何支援自訂 Agent 工作流程。

GitHub 上的 DeepSeek Harness 指南

探索實用架構說明、使用手冊、外掛開發教學、多語言文件和可重複使用的 Agent Skill，協助你理解、擴充並以 DeepSeek Harness 為基礎進行建置。

疑難排解

DeepSeek Harness 常見問題

在本指南情境中使用時，可能會顯著增加 token 用量。

X（Twitter）上的 DeepSeek Harness 討論

查看開發者和早期參與者關於 DeepSeek Harness（DSH）的討論，內容涵蓋這款開源 Agent Harness 的「一切皆外掛」架構、可組合執行階段、外掛生態系統和實際使用體驗。