dsh-oliver-qol
为 DeepSeek Harness 提供的个人便利功能
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:oliverkim5017/dsh-oliver-qol#4e9074e83f974faa50f4bd094721814d69157f5dOliver Qol 以 dsh-oliver-qol 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Personal quality-of-life features for the DeepSeek Harness (dsh), bundled as one plugin. Each feature lives in its own module under src/features/, carries its own config section, locale namespace, route prefix, and tests, and never imports another feature.
| Feature | State | What it does |
|---|---|---|
session-delete | implemented | Permanently deletes a stored session (log, projection cache, workspace accounting) from the session row menu, cascading into its subagent child sessions |
extend-settings | implemented | Adds an Extend settings tab (last) to the settings page; it declares the settings.extend-settings.item list slot every QoL setting row registers into |
permission-default | implemented | First row of that tab: picks the default permission mode of newly created sessions (permission.defaultPreset, applies to every workspace), Full access included, written immediately without a confirmation dialog |
opencode-search | implemented | Second row of that tab: routes the built-in web_search tool through OpenCode Go — endpoint and key reference follow the dsh-opencode-go plugin settings, while the search model and the proxy address (host + port) are set in the row itself and touch nothing else. Off by default; while off it delegates to the built-in DeepSeek search provider |
Built against dsh 0.2.0-rc.2. dsh APIs are pre-stable, so this plugin pins the exact @deepseek-ai/* versions it was developed with; expect to update them together with dsh.
The plugin is a dsh bundle: its package.json declares dsh.bundle (host half) and dsh.client (browser half).
:: from GitHub (needs a built artifact; pnpm runs `prepare`)
dsh plugin --profile web add github:oliverkim5017/dsh-oliver-qol
:: from a local checkout (development loop)
dsh plugin --profile web add link:D:\2Code\dsh-oliver-qol
Git installs run this package's prepare script, so the profile's pnpm-workspace.yaml must allow it:
allowBuilds:
dsh-oliver-qol: true
Restart dsh after adding, updating, or removing the plugin. The bundle patch (cordis.patch.yml) mounts one row (id: oliver-qol, name: dsh-oliver-qol) and points the web seam's searchProvider at the opencode-go provider this bundle registers.
- id: oliver-qol
config:
sessionDelete:
sessionsRoot: <path> # default: dshHomePath('sessions')
quiescenceTimeoutMs: 15000 # default: 15000
quiescencePollMs: 200 # default: 200
opencodeSearch:
enabled: false # default: delegate to the built-in search provider
model: deepseek-v4.1-flash # auxiliary Messages model; any OpenCode Go id
proxyUrl: '' # search-only proxy host; empty connects directly
proxyPort: '' # search-only proxy port; empty keeps the URL's own
sessionDelete.sessionsRoot must match the root of the profile's session-persistence-jsonl row ($DSH_HOME/sessions by default). If a deployment moves that root, set both.
opencodeSearch is a live section: the Extend settings row writes it without a restart. Per search, the provider reads the baseURL and apiKeyEnv that the opencode-go profile row (the dsh-opencode-go plugin) currently resolves, and resolves that credential reference through the credentials service — the same OPENCODE_API_KEY the chat route uses. Those are the only two facts it borrows: the proxy is the row's own (proxyUrl/proxyPort), so nothing configured for chat traffic reaches a search, and nothing a search sets reaches chat. Without that plugin the documented defaults apply (https://opencode.ai/zen/go/v1, OPENCODE_API_KEY).
proxyUrl takes a host (127.0.0.1), a host and port (127.0.0.1:7890), or a full URL with a scheme (socks5://127.0.0.1); a bare host is read as HTTP. proxyPort is a decimal 1–65535 and overrides any port inside proxyUrl; empty means the search uses whatever port the address carries. Both empty connects directly. The Extend-settings row commits each half on blur or Enter — one typed address is one write — and refuses a port the host would refuse, so the row and the next search cannot disagree.
The bundle patch points the web seam at this provider (web.searchProvider: opencode-go). While the Extend-settings row is off, the provider delegates every search to the built-in deepseek-official provider, so installing this plugin changes nothing until the feature is enabled. A deployment can drop the web override from cordis.patch.yml (or its own profile patch) to ignore the provider entirely.
One search is one auxiliary model turn against the OpenCode Go endpoint with the native web_search_20250305 server tool — latency plus tokens count against the Go usage quota. deepseek-v4.1-flash is verified end-to-end through this provider (10 structured results, ~10k input tokens); other Go model ids are selectable but unverified for server-side search. OpenCode Go requires x-opencode-session on every request: the provider sends the initiating conversation's id and, outside a conversation, one stable per-instance id.
pnpm install
pnpm test # vitest
pnpm typecheck # tsc, no emit
pnpm lint # oxlint
pnpm build # tsc host half -> lib/, esbuild browser half -> lib/client.js
lib/ is not committed. The client bundle is one CJS artifact wrapped in window.__ModuleLoader__.load({ id: 'dsh-oliver-qol', factory }); platform modules (react, react/jsx-runtime, @deepseek-ai/dsh-client-ui-primitives, @deepseek-ai/dsh-client-store) stay external and resolve through the injected require.
Adding a feature: create src/features/<name>/ (with its own client/ half when it has UI), then add one line to src/features/index.ts and one to src/client/index.ts. A client-only feature skips src/features/index.ts and adds only its client line. A setting row registers one entry into the settings.extend-settings.item slot declared by extend-settings — the slot key (and nothing else) is the contract between the hub and the row. Keep features independent — share code only through a src/shared/ module that at least two features actually use.
After dsh plugin --profile web add link:... and a restart of dsh web:
Delete session sits below Archive session, in red.$DSH_HOME/sessions/<project>/<id>/ is gone.session_projcache rows are gone.$DSH_HOME/storages/session_projcache no longer holds rows for the deleted ids, and that workspace accounting ($DSH_HOME/storages/workspace.json) dropped them./permission).deepseek-v4.1-flash, and ask the model to search the web: the tool result lists sources instead of the DEEPSEEK_API_KEY error. Disable the toggle and search again: the search falls back to the built-in provider (behavior and errors as before).127.0.0.1 / 7890): the write lands when the field is left, the next search dials through it, and chat traffic is unaffected. Clear both fields and search again: the search connects directly.0, 99999) into the port field and leave it: nothing is written, and the field keeps the text so it can be corrected. An address the transport cannot read (not a url) stays saved and makes the next search fail loudly, naming the address.session-delete/busy) on Windows file locks; retry after that process stops.busy and can be retried.src/features/session-delete/jsonl-layout.ts and removal.ts and must be re-checked on dsh upgrades.opencode-search delegates to the built-in provider by reading the web service's provider registry (web.searchProviders) — a dsh-internal surface pinned to the 0.2.0-rc.2 line; re-check it on upgrades. The Extend-settings row writes the oliver-qol profile entry, so renaming the bundle row id makes the row report unavailable.opencode-search follows the opencode-go entry's base apiKeyEnv reference only; multi-account setups (accounts/autoSwitch in dsh-opencode-go) are not followed per search.opencode-search's proxy is its own setting: it applies to the search request only. A deployment that wants the search behind the same proxy as chat has to type that address into the new row as well — there is no "follow the OpenCode Go proxy" mode.web/deepseek-search-llm-request session event.