English | 简体中文

dsh-octen

为 DeepSeek Harness 提供 Octen 网页搜索和网页抓取。

插件把 Octen 注册为 harness 网页能力（ctx.web）的 provider，内置的 web_search 和 web_fetch 工具因此改走 Octen。不会多出新工具，模型看到的工具定义也和原来一样。

工具	Octen 接口	模型拿到的内容
`web_search`	`POST /search`	每条结果的标题、URL、与查询相关的摘录、发布时间
`web_fetch`	`POST /extract`	页面正文，转成干净的 Markdown，开头是页面标题

安装

需要 DeepSeek Harness 0.2.0-rc.2 或更新版本，以及一个 Octen API Key（在 octen.ai 获取）。

在 Web 界面安装： 打开插件，点 添加插件，填入 @octen.ai/dsh-octen，点安装。然后打开这个插件的页面，在 Octen API Key 里粘贴密钥，点保存。

在终端安装：

dsh plugin --profile web add @octen.ai/dsh-octen

然后在 Web 界面的插件页面保存密钥，或者在启动 DeepSeek Harness 的环境里导出：

export OCTEN_API_KEY=your-key

装好后，web_search 和 web_fetch 都会走 Octen。问 agent 一个需要最新信息的问题就能试。

选择哪些工具走 Octen

搜索和抓取是分开选的。如果只想用 Octen 搜索，抓取仍用自带的 HTTP 抓取，在 profile 的 cordis.patch.yml（例如 ~/.dsh/profiles/web/cordis.patch.yml）里加：

- id: web
  config:
    searchProvider: octen
    fetchProvider: http

想换回自带搜索，就写 searchProvider: deepseek-official。profile 自己的 patch 层在插件之后生效，所以以它为准。

配置

插件行的 id 是 dsh-octen。所有字段都可以不填；每次调用都会重新读取，改完不用重启。

字段	默认值	含义
`apiKeyEnv`	`OCTEN_API_KEY`	读取密钥用的凭据引用：先查凭据存储（插件页面保存的就在这里），再查环境变量
`apiKey`	无	直接写明文密钥。建议用 `apiKeyEnv`，避免把密钥写进配置文件
`baseURL`	先取 `$OCTEN_API_URL`，再用 `https://api.octen.ai`	Octen API 地址。必须是 HTTPS，或者指向 `localhost` 的 HTTP。`OCTEN_API_URL` 只从进程环境或 `~/.dsh/.env` 读取，不读项目里的 `.env`
`extractTimeoutSeconds`	`25`	`web_fetch` 单个 URL 的提取超时，1–60 秒。要小于 `web_fetch` 工具的超时（默认 30 秒）

示例：

- id: dsh-octen
  config:
    apiKeyEnv: TEAM_OCTEN_KEY
    extractTimeoutSeconds: 20

行为说明

搜索。 结果条数由 harness 决定（默认 8 条），插件把它作为 count 传给 Octen。没有 URL 的结果会被丢弃；缺标题、摘录或日期时直接留空，不会编造。
抓取。 页面由 Octen 在服务端提取，harness 本地不下载、也不转换 HTML。Octen 不返回源站的状态码，所以提取成功一律报 HTTP 200。提取失败时，工具调用会带着 Octen 给的原因报错，例如 Failed to resolve domain。
错误。 没有密钥时，请求发出之前就报 WEB_PROVIDER_CREDENTIAL_MISSING。密钥无效、余额不足、限流或服务端错误都报 WEB_PROVIDER_ERROR，并附上 Octen 的错误信息。取消报 WEB_ABORTED。
安全。 密钥放在 x-api-key 请求头里；请求拒绝重定向，而且只发往 HTTPS 地址（或 localhost 上的 HTTP）。项目里的 .env 改不了接口地址，所以打开一个不可信的仓库也没法把你的密钥引到别处。

开发

pnpm install
pnpm run typecheck
pnpm test                         # 单元测试，跑在本地桩服务上
OCTEN_API_KEY=... pnpm test:live  # 真实调用 api.octen.ai
pnpm run build                    # 产出 lib/index.js（host 侧）和 lib/client.js（设置页）

想试本地构建，可以打包后把 tarball 装进 profile：

npm pack
dsh plugin --profile web add "$PWD/octen.ai-dsh-octen-0.1.0.tgz"

代码分两部分。src/index.ts 是注册 provider 的 host 插件。src/client/ 是插件页面上的设置区块，打包成 window.__ModuleLoader__ 工厂，由 harness 的 Web 外壳加载。

许可证

MIT

dsh-octen

Install

Source

Tags

Creators

Readme

dsh-octen

安装

选择哪些工具走 Octen

配置

行为说明

开发

许可证