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 的“一切皆插件”架构、可组合运行时、插件生态系统和实践体验。