dsh-openrouter-sync-models
使 DeepSeek Harness OpenRouter 模型列表与 OpenRouter 目录保持同步，包括账户预设
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:m1khal3v/dsh-openrouter-sync-models#e147a0db5280b5cdacce6316bbd76fb3b650fd43Openrouter Sync Models 以 dsh-openrouter-sync-models 发布，当前版本为 0.1.7。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
An always-current OpenRouter model catalog for DeepSeek Harness.
Keeps the llm-pi-ai OpenRouter route in sync at startup, every six hours, and whenever your key changes — including account-only @preset/... models.
ctx.llm and writes through ctx.settings, with no profile paths or build-mode branches.DSH_HOME, no DSH_PROFILE, no backups or status files. DSH owns atomic writes, revision checks, and HMR.ctx.logger diagnostics plus a live openrouter/models-synced event.OpenRouter Sync Plugin Settings (Patch) llm-pi-ai
│ │ │ │
│ │ GET /api/v1/models │ │
│◄────────────────────────│ (resolves token) │ │
│ (Bearer token) │ │ │
│ │ │ │
│ JSON Catalog Array │ │ │
│────────────────────────►│ │ │
│ │ ctx.settings.mutate() │ │
│ │──────────────────────────►│ │
│ │ (filtered & projected) │ │
│ │ │ DSH persists & │
│ │ │ validates patch │
│ │ │─────────────────┐ │
│ │ │ │ │
│ │ │◄────────────────┘ │
│ │ │ │
│ │ │ Applies live via HMR │
│ │ │────────────────────────────►│
openrouter route through ctx.llm.listConfigurableProviders().apiKeyEnv through ctx.credentials and requests the authenticated catalog.api and models are written, through ctx.settings.mutate().No restart is needed for model updates.
dsh plugin --profile <profile> add dsh-openrouter-sync-models
<profile> is the profile directory name under $DSH_HOME/profiles/<name>. Install the plugin into every profile you actually boot.
<profile> | What it runs | How to install |
|---|---|---|
web | Shipped browser surface, booted by dsh web or dsh --profile web | dsh plugin --profile web add dsh-openrouter-sync-models |
headless | Shipped one-shot CLI, booted by dsh --profile headless "job" | dsh plugin --profile headless add dsh-openrouter-sync-models |
sdk | Shipped SDK host over JSON-RPC stdio | dsh plugin --profile sdk add dsh-openrouter-sync-models |
sdk-minimal | Shipped minimal SDK agent tree | dsh plugin --profile sdk-minimal add dsh-openrouter-sync-models |
acp | Shipped ACP stdio host | dsh plugin --profile acp add dsh-openrouter-sync-models |
desktop | Electron-owned desktop profile | Use the app's Plugins page, or the desktop-installed dsh command. The npm CLI rejects plugin management for desktop. |
<name> (custom) | Any other profile directory | Initialize it with dsh --profile <name> --from-default-profile web (or another shipped template), then install the plugin into it. |
The shipped web, headless, sdk, sdk-minimal, and acp profiles initialize automatically on first use. A custom profile name is just a directory under $DSH_HOME/profiles/, so the same plugin can be installed independently into several profiles.
If a profile omits the settings or credentials services, the plugin still loads but leaves synchronization inactive.
Or from a local checkout:
pnpm install
pnpm run build
dsh plugin --profile <profile> add file:~/projects/mine/dsh-openrouter-sync-models
The plugin only writes api and models; the route itself stays user-owned:
- id: llm-pi-ai
name: '@deepseek-ai/dsh-llm-pi-ai'
config:
providers:
openrouter:
apiKeyEnv: OPENROUTER_API_KEY
# api and models are maintained by dsh-openrouter-sync-models
Store OPENROUTER_API_KEY through the harness credential store, the environment, or the profile's credential layer.
The catalog endpoint is public, but the authenticated response is the one that contains @preset/... models. Without a key the plugin skips the pass by default rather than deleting every preset.
Every field is optional.
| Key | Default | Description |
|---|---|---|
provider | openrouter | llm-pi-ai provider route to synchronize |
endpoint | https://openrouter.ai/api/v1/models | Catalog endpoint |
api | openai-completions | Route-level wire protocol written beside the list |
apiKeyEnv | OPENROUTER_API_KEY | Credential reference used when the route names none |
requireKey | true | Skip when the credential cannot be resolved |
includePresets | true | Include account-specific @preset/... models |
freeOnly | false | Keep only zero-priced models |
requireTools | true | Keep only models advertising tool calling |
requireTextOutput | true | Keep only plain-text output models |
requireChatEndpoint | true | Drop :batch entries with no chat endpoint |
minContextWindow | 0 | Minimum advertised context in tokens |
maxOutputTokens | 0 | Clamp a known output cap; 0 keeps the advertised value |
excludeModels | [] | Exact model ids to leave out |
intervalHours | 6 | Refresh interval |
timeoutMs | 45000 | HTTP timeout |
startupGraceMs | 30000 | How long startup waits for the provider directory |
Example override:
- id: openrouter-sync-models
name: dsh-openrouter-sync-models
config:
freeOnly: true
minContextWindow: 64000
excludeModels:
- openrouter/auto
With the defaults, a 2026-11-02 authenticated sample of 416 catalog entries yields roughly 305 models, including account presets. Set freeOnly: true to reproduce the old free-only behavior.
OpenRouter fields are projected into the subset DSH can actually serve:
| OpenRouter | DSH |
|---|---|
id | id |
name | name |
min(context_length, top_provider.context_length) | contextWindow |
top_provider.max_completion_tokens | maxTokens |
architecture.input_modalities | input (text/image only) |
reasoning.supported_efforts | reasoningEfforts |
reasoning.mandatory | removes the off level |
supported_parameters | selected compat flags |
A field OpenRouter omits stays omitted. In particular, when max_completion_tokens is absent, maxTokens is not written: pi-ai falls back to the installed catalog entry and then to the route default exactly as it does for a hand-written profile.
Compatibility switches are only declared when evidenced:
thinkingFormat: 'openrouter' for chat modelsmaxTokensField: 'max_tokens' when the model accepts max_tokens but not max_completion_tokenssupportsStrictMode: true when structured_outputs is advertisedcacheControlFormat: 'anthropic' for Anthropic-backed entries, including presets identified by canonical_slugsupportsDeveloperRole: true for OpenAI/Anthropic-backed entriesrequiresReasoningContentOnAssistantMessages: true for DeepSeek-backed entriesDSH has no model-config field for OpenRouter description, pricing, benchmarks, default_parameters, voices, links, or alias_target, so those are intentionally not projected.
llm-pi-ai settings descriptor, gives the loader and its network/proxy plugins one second to settle, then retries briefly (0 → 1 → 3 → 10 s) on target-ordering skips, settings-write races, or a transient fetch failed. This prevents an install-time pass from sleeping until the next interval.apiKeyEnv, then the configured fallback) changes. Updates are debounced, and a change during a running pass queues at most one follow-up.AsyncLocalStorage context, so the settings write queues behind the active reconciliation instead of failing with HMR transactions cannot be nested. The route and settings revision are then re-read after the catalog fetch, and a transient SETTINGS_CONFLICT or reload race is retried with the fresh revision before the pass is reported as failed.modelOverrides is respected. If the route uses modelOverrides, the plugin skips it because DSH refuses models beside modelOverrides.dsh-openrouter-sync beside this plugin. Both target the same models list.apiKeyEnv. A route authenticated only through pi-ai's OAuth record has no environment reference; configure apiKeyEnv for catalog synchronization even if inference signs in interactively.Logs go through:
ctx.logger('openrouter-sync-models')
Every attempt, including a skip, also writes its last terminal report to:
$DSH_HOME/cache/openrouter-sync-models.json
The record includes at, trigger, attempt, status, and reason, which answers “did the install-time pass run, and if not, why” even when the desktop build sends stdout to /dev/null. A failure also carries the provider or settings error message in detail; network failures include the nested cause (ENOTFOUND, ECONNRESET, CERT_HAS_EXPIRED, …) instead of a bare fetch failed.
Model changes are also published as a live event:
ctx.on('openrouter/models-synced', report => {
// report.status: updated | unchanged | skipped | failed
// report.reason: stable reason for a skip/failure
// report.added / report.removed: model ids
})
The event never enters the session log.
pnpm install
pnpm run verify # typecheck + tests
pnpm run build
lib/ is generated by tsdown; declarations come from tsc -p tsconfig.types.json.
The package publishes through GitHub Actions on v* tags with npm provenance. Before the first release tag, configure the package's npm Trusted Publisher for the m1khal3v/dsh-openrouter-sync-models repository and the release.yml workflow. The workflow uses OIDC and stores no npm token.