@octen.ai/dsh-octen
DeepSeek Harness 的 Octen 网页搜索和抓取：通过 Octen /search 使用 web_search，通过 Octen /extract 使用 web_fetch。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Octen-Team/dsh-octen#2b68131eef8767891284dcf97bce8fd556b91d2cOcten 以 @octen.ai/dsh-octen 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →English | 简体中文
Octen web search and page fetch for DeepSeek Harness.
The plugin registers Octen as a provider on the harness web seam (ctx.web), so the built-in web_search and web_fetch tools run through Octen. You do not get new tools to learn, and the model sees the same tool schema as before.
| Tool | Octen endpoint | What the model gets |
|---|---|---|
web_search | POST /search | Title, URL, a query-relevant highlight, and the publication time for each result |
web_fetch | POST /extract | The page's main content as clean Markdown, headed by its title |
You need DeepSeek Harness 0.2.0-rc.2 or later and an Octen API key from octen.ai.
From the web UI: open Plugins, click Add plugin, enter @octen.ai/dsh-octen, and click Install. Then open the plugin's page, paste your key into Octen API key, and click Save.
From a terminal: use the profile you run. The desktop app's profile is desktop; dsh web uses web.
dsh plugin --profile desktop add @octen.ai/dsh-octen
If your shell says command not found: dsh, open the desktop app and choose DeepSeek Harness → Manage dsh Command… → Install, then open a new terminal. Restart the desktop app afterwards if it was running.
Then save the key on the plugin's page in the web UI, or export it in the environment that launches DeepSeek Harness:
export OCTEN_API_KEY=your-key
Installing the plugin points both web_search and web_fetch at Octen. Ask the agent something current to try it.
Search and fetch are selected separately. To keep Octen search but go back to the shipped HTTP fetch, add this to your profile's cordis.patch.yml (for example ~/.dsh/profiles/desktop/cordis.patch.yml):
- id: web
config:
searchProvider: octen
fetchProvider: http
Use searchProvider: deepseek-official to go back to the shipped search. Your profile's patch layer applies after the plugin's own, so it wins.
The plugin's row id is dsh-octen. All fields are optional and are read again for every call, so changes apply without a restart.
| Field | Default | Meaning |
|---|---|---|
apiKeyEnv | OCTEN_API_KEY | Credential reference the key is read from: the credentials store (what the Plugins page writes), then the environment |
apiKey | none | Literal key. Prefer apiKeyEnv, so no secret goes into a config file |
baseURL | $OCTEN_API_URL, then https://api.octen.ai | Octen API base. Must be HTTPS, or HTTP to localhost. OCTEN_API_URL is read from the process environment or ~/.dsh/.env, never from a project's .env |
extractTimeoutSeconds | 25 | Per-URL extraction timeout for web_fetch, 1–60. Keep it below the web_fetch tool budget (30 s by default) |
Example:
- id: dsh-octen
config:
apiKeyEnv: TEAM_OCTEN_KEY
extractTimeoutSeconds: 20
count. Results without a URL are dropped; a missing title, highlight, or date is left out instead of being made up.Failed to resolve domain.WEB_PROVIDER_CREDENTIAL_MISSING before any request is sent. A rejected key, an exhausted balance, a rate limit, or a server error fails with WEB_PROVIDER_ERROR and Octen's message. Cancellation reports WEB_ABORTED.x-api-key header, refuse redirects, and go only to an HTTPS base (or HTTP on localhost). A project's .env cannot change the endpoint, so opening an untrusted repository cannot redirect your key.pnpm install
pnpm run typecheck
pnpm test # unit tests against a local stub server
OCTEN_API_KEY=... pnpm test:live # real calls to api.octen.ai
pnpm run build # lib/index.js (host) and lib/client.js (settings page)
To try a local build, pack it and add the tarball to a profile:
npm pack
dsh plugin --profile desktop add "$PWD/octen.ai-dsh-octen-0.1.0.tgz"
The package has two halves. src/index.ts is the host plugin that registers the providers. src/client/ is the settings section on the plugin's Plugins page, bundled as a window.__ModuleLoader__ factory that the harness web shell loads.
MIT