dsh-openrouter-free 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jiang12345-code
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# dsh-openrouter-free
+
+[![CI](https://github.com/jiang12345-code/dsh-openrouter-free/actions/workflows/ci.yml/badge.svg)](https://github.com/jiang12345-code/dsh-openrouter-free/actions/workflows/ci.yml)
+![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-plugin-8b5cf6)
+[![npm](https://img.shields.io/npm/v/dsh-openrouter-free)](https://www.npmjs.com/package/dsh-openrouter-free)
+
+OpenRouter 免费模型面板（DeepSeek Harness / DSH 持久插件）。特性：**综合能力 1-5★ 分级标星 · 最优三优先排序 · 一键切换（推理档自动 max）**。
+
+自动拉取 [openrouter.ai](https://openrouter.ai/api/v1/models) 的实时免费模型清单（输入/输出单价均为 $0），一键安装进本机 `openrouter` 路由并设为当前对话模型——免去手动编辑 `settings.yaml` 配置模型的麻烦。
+
+## 功能
+
+- **免费清单面板**：GUI 会话视图新增「免费模型」标签页，实时列出 OpenRouter 全部免费模型（名称 / ID / 上下文窗口 / 是否支持图片与推理），10 分钟内存缓存，可手动强刷。
+- **一键切换**：点击任意行 → 该模型被 upsert 进 `llm-pi-ai.providers.openrouter.models`，同时 `agent-default-model` 指向它。**下一次请求即生效，无需重启**。
+- **全部装进选择器**：一次把所有免费模型写入路由，之后也能用 DSH 自带模型选择器切换。
+- **安全保留手工条目**：同步/切换单个模型时，所有非免费的手工条目（如 `stealth/ox-alpha` 的精调条目）原样保留；「全部装进选择器」也只刷新免费条目。
+- **推理档自适应**：不支持推理的模型切换时会自动摘掉 `reasoningEffort`，避免请求以 `UNSUPPORTED_REASONING_EFFORT` 失败。
+
+## 前置条件
+
+- 本机 `settings.yaml` 已有 `llm-pi-ai.providers.openrouter` 路由（`baseURL: https://openrouter.ai/api/v1`）+ 环境变量 `OPENROUTER_API_KEY`（使用免费模型也需要密钥）。
+- 拉取清单本身是公开 API，无需密钥。
+
+## 安装
+
+```powershell
+# 源码在本仓库；把包复制进运行中的 profile 并注册 bundle
+Copy-Item -Recurse -Force . "C:\Users\73618\.dsh\profiles\web\node_modules\dsh-openrouter-free"
+# 在 profile 的 package.json 里给 dsh.profile.bundles 追加 "dsh-openrouter-free"
+# 然后重启 DSH（host 改动需重启；client 改动硬刷新即可）
+```
+
+## HTTP API（POST /__orfree/api，body: {method, args}）
+
+| method | 说明 |
+|---|---|
+| `free.list({refresh})` | 免费清单（缓存 10 分钟，refresh 强刷） |
+| `current()` | 当前 agent-default-model 与已装入的模型 id 列表 |
+| `model.use({id})` | 安装单个免费模型并设为当前对话模型 |
+| `sync.all()` | 全部免费模型装入 openrouter 路由 |
+| `free.remove({id})` | 移除某个免费模型（当前选中者拒绝） |
+
+## 设计依据
+
+- DSH llm-pi-ai 适配器的 `models` 列表即"替换该路由 catalog"，且 settings 分节更新在下一次请求生效、无需重启（见 `packages/llm/llm-pi-ai/README.zh.md`）。
+- 该适配器明确声明"路由的 catalog 不会自我刷新"——本插件就是补上这个自动化缺口。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-openrouter-free 安装清单
+# dsh plugin add / bundle 加载时把插件行插入 host composition
+- insert:
+    - name: dsh-openrouter-free

package/lib/client.js

@@ -0,0 +1,213 @@
+window.__ModuleLoader__.load({
+  id: 'dsh-openrouter-free',
+  factory: (require) => {
+    var module = { exports: {} }
+    var exports = module.exports
+    var React = require('react')
+
+    var CSS = ''
+      + '.orf-wrap{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;color:#e6edf3;background:#0d1117;padding:16px 20px;height:100%;display:flex;flex-direction:column;gap:12px;min-height:0;}'
+      + '.orf-top{display:flex;align-items:center;justify-content:space-between;flex:none;}'
+      + '.orf-brand{display:flex;align-items:center;gap:8px;}'
+      + '.orf-dot{width:8px;height:8px;border-radius:50%;background:#3fb950;box-shadow:0 0 8px rgba(63,185,80,.6);}'
+      + '.orf-title{font-size:13px;font-weight:600;}'
+      + '.orf-sub{font-size:11px;color:#8b949e;margin-left:4px;}'
+      + '.orf-actions{display:flex;gap:8px;align-items:center;}'
+      + '.orf-btn{display:inline-flex;align-items:center;gap:6px;padding:6px 12px;background:#161b22;border:1px solid #30363d;border-radius:8px;color:#e6edf3;font-size:12px;cursor:pointer;transition:all .15s;}'
+      + '.orf-btn:hover{background:#1c2128;border-color:#484f58;}'
+      + '.orf-btn:disabled{opacity:.5;cursor:default;}'
+      + '.orf-btn.primary{background:#238636;border-color:#2ea043;}'
+      + '.orf-btn.primary:hover{background:#2ea043;}'
+      + '.orf-btn svg{width:13px;height:13px;}'
+      + '.orf-cur{flex:none;display:flex;align-items:center;gap:10px;padding:9px 14px;background:#161b22;border:1px solid #30363d;border-radius:10px;font-size:12px;}'
+      + '.orf-cur-label{color:#8b949e;}'
+      + '.orf-cur-model{font-family:"JetBrains Mono",monospace;color:#58a6ff;font-weight:600;}'
+      + '.orf-cur-effort{color:#d29922;font-family:"JetBrains Mono",monospace;font-size:11px;}'
+      + '.orf-toolbar{display:flex;gap:10px;align-items:center;flex:none;}'
+      + '.orf-search{flex:1;max-width:360px;background:#161b22;border:1px solid #30363d;border-radius:8px;padding:8px 12px;font-size:12px;color:#e6edf3;outline:none;}'
+      + '.orf-search:focus{border-color:rgba(88,166,255,.5);}'
+      + '.orf-meta{font-size:11px;color:#484f58;font-family:"JetBrains Mono",monospace;}'
+      + '.orf-list{flex:1;overflow-y:auto;display:flex;flex-direction:column;gap:6px;min-height:0;padding-right:4px;}'
+      + '.orf-row{display:flex;align-items:center;gap:12px;padding:10px 14px;background:#161b22;border:1px solid #21262d;border-radius:10px;cursor:pointer;transition:all .12s;}'
+      + '.orf-row:hover{background:#1c2128;border-color:#30363d;}'
+      + '.orf-row.active{border-color:rgba(63,185,80,.55);background:rgba(63,185,80,.08);}'
+      + '.orf-row.switching{opacity:.6;pointer-events:none;}'
+      + '.orf-row-main{flex:1;min-width:0;}'
+      + '.orf-row-name{font-size:13px;font-weight:500;display:flex;align-items:center;gap:6px;}'
+      + '.orf-star{color:#bc8cff;font-size:11px;}'
+      + '.orf-row-id{font-family:"JetBrains Mono",monospace;font-size:11px;color:#8b949e;margin-top:2px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}'
+      + '.orf-badges{display:flex;gap:6px;flex:none;}'
+      + '.orf-badge{padding:2px 8px;border-radius:999px;font-size:11px;font-weight:500;border:1px solid transparent;}'
+      + '.orf-badge.ctx{background:rgba(88,166,255,.12);color:#58a6ff;border-color:rgba(88,166,255,.25);font-family:"JetBrains Mono",monospace;}'
+      + '.orf-badge.img{background:rgba(188,140,255,.12);color:#bc8cff;border-color:rgba(188,140,255,.25);}'
+      + '.orf-badge.think{background:rgba(210,153,34,.12);color:#d29922;border-color:rgba(210,153,34,.25);}'
+      + '.orf-badge.use{background:rgba(63,185,80,.15);color:#3fb950;border-color:rgba(63,185,80,.35);}'
+      + '.orf-note{flex:none;display:flex;align-items:center;gap:8px;font-size:11px;color:#484f58;}'
+      + '.orf-toast{position:fixed;bottom:24px;left:50%;transform:translateX(-50%);background:#1c2128;border:1px solid #2ea043;color:#3fb950;padding:9px 18px;border-radius:10px;font-size:12px;z-index:9999;box-shadow:0 8px 30px rgba(0,0,0,.5);}'
+      + '.orf-toast.err{border-color:#f85149;color:#f85149;}'
+      + '.orf-empty{padding:40px;text-align:center;color:#484f58;font-size:13px;}'
+      + '.orb-spin{animation:orfSpin 1s linear infinite;}@keyframes orfSpin{to{transform:rotate(360deg)}}'
+
+    function injectStyles(css) {
+      if (typeof document === 'undefined') return
+      var el = document.createElement('style')
+      el.setAttribute('data-orf', 'style')
+      el.textContent = css
+      document.head.appendChild(el)
+      return function () { el.remove() }
+    }
+
+    function api(method, args) {
+      return fetch('/__orfree/api', {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ method: method, args: args || {} }),
+      }).then(function (r) {
+        return r.json().then(function (j) {
+          if (!r.ok || j.ok === false) throw new Error(j && j.error ? j.error : 'HTTP ' + r.status)
+          return j
+        })
+      })
+    }
+
+    function fmtCtx(n) {
+      if (!n) return '—'
+      if (n >= 1000000) return (Math.round(n / 100000) / 10) + 'M'
+      if (n >= 1000) return Math.round(n / 1000) + 'K'
+      return String(n)
+    }
+
+    function IcRefresh(p) {
+      return React.createElement('svg', { width: 13, height: 13, viewBox: '0  0 16 16', fill: 'currentColor', className: p && p.spin ? 'orb-spin' : '' },
+        React.createElement('path', { d: 'M8 3a5 5 0 1 0 4.9 6h1.55A6.5 6.5 0 1 1 13.7 3.7L16 6h-5V1l1.8 1.8A5 5 0 0 0 8 3z' }))
+    }
+    function IcDownload() {
+      return React.createElement('svg', { width: 13, height: 13, viewBox: '0  0 16 16', fill: 'currentColor' },
+        React.createElement('path', { d: 'M8 1v8.6L5 6.5 3.9 7.6 8 11.7l4.1-4.1L11 6.5 8 9.6V1H8zM2 13h12v1.5H2V13z' }))
+    }
+
+    function apply(ctx) {
+      const slots = ctx.get('slots')
+      if (slots === undefined) return
+      ctx.effect(() => injectStyles(CSS))
+      slots.inject('conversation.view', () => slots.register(
+        { name: 'conversation.view', id: 'dsh-openrouter-free', label: '免费模型', order: 9 },
+        (props) => {
+          function Panel() {
+            const [models, setModels] = React.useState(null)
+            const [cur, setCur] = React.useState(null)
+            const [loading, setLoading] = React.useState(true)
+            const [error, setError] = React.useState('')
+            const [toast, setToast] = React.useState('')
+            const [query, setQuery] = React.useState('')
+            const [refreshing, setRefreshing] = React.useState(false)
+            const [switching, setSwitching] = React.useState('')
+
+            function showToast(msg, isErr) { setToast({ msg: msg, err: !!isErr }); setTimeout(() => setToast(''), 2600) }
+            function loadCurrent() { api('current').then(j => setCur(j.default || {})).catch(() => {}) }
+            function loadList(refresh) {
+              setRefreshing(true); if (refresh) setError('')
+              api('free.list', { refresh: !!refresh })
+                .then(j => setModels(j.models || []))
+                .catch(e => setError(String(e.message || e)))
+                .then(() => { setRefreshing(false); setLoading(false); })
+            }
+            React.useEffect(() => { loadCurrent(); loadList(false) }, [])
+
+            function switchTo(m) {
+              setSwitching(m.id); setError('')
+              api('model.use', { id: m.id })
+                .then(j => { showToast('已切换 → ' + m.id + '（下一次请求生效）'); return loadCurrent() })
+                .catch(e => { setError(String(e.message || e)); showToast(String(e.message || e), true) })
+                .then(() => setSwitching(''))
+            }
+            function syncAll() {
+              setSwitching('__all__')
+              api('sync.all')
+                .then(j => { showToast('已把 ' + j.installedCount + ' 个免费模型装入选择器'); return loadCurrent() })
+                .catch(e => { showToast(String(e.message || e), true) })
+                .then(() => setSwitching(''))
+            }
+
+            const list = (models || []).filter(function (m) {
+              if (!query) return true
+              return (m.id + ' ' + m.name).toLowerCase().indexOf(query.toLowerCase()) >= 0
+            })
+            list.sort(function (a, b) {
+              var score = function (m) { return (m.contextWindow || 0) / 1048576 * 100 + (m.reasoning ? 50 : 0) + (m.input && m.input.indexOf('image') >= 0 ? 10 : 0) + (m.stealth ? 10 : 0) }
+              return score(b) - score(a)
+            })
+
+            const activeId = cur && cur.model ? cur.model : ''
+
+            const header = React.createElement('div', { className: 'orf-top' },
+              React.createElement('div', { className: 'orf-brand' },
+                React.createElement('span', { className: 'orf-dot' }),
+                React.createElement('span', { className: 'orf-title' }, 'OpenRouter 免费模型'),
+                React.createElement('span', { className: 'orf-sub' }, models ? (models.length + ' 个可用 · $0 输入/$0 输出') : '')),
+              React.createElement('div', { className: 'orf-actions' },
+                React.createElement('button', { className: 'orf-btn', onClick: () => loadList(true), disabled: refreshing, title: '重新拉取 OpenRouter 免费清单' },
+                  React.createElement(IcRefresh, { spin: refreshing }), refreshing ? '刷新中…' : '刷新清单'),
+                React.createElement('button', { className: 'orf-btn primary', onClick: syncAll, disabled: switching === '__all__' || !models },
+                  React.createElement(IcDownload), '全部装进选择器')))
+
+            const curBar = React.createElement('div', { className: 'orf-cur' },
+              React.createElement('span', { className: 'orf-cur-label' }, '当前对话模型'),
+              React.createElement('span', { className: 'orf-cur-model' }, (cur && cur.model) || '（未设置）'),
+              cur && cur.reasoningEffort ? React.createElement('span', { className: 'orf-cur-effort' }, '推理档 ' + cur.reasoningEffort) : null,
+              React.createElement('span', { style: { marginLeft: 'auto', fontSize: 11, color: '#484f58' } }, 'provider: ' + ((cur && cur.provider) || 'openrouter')))
+
+            const toolbar = React.createElement('div', { className: 'orf-toolbar' },
+              React.createElement('input', { className: 'orf-search', placeholder: '搜索模型名 / 厂商…', value: query, onChange: (e) => setQuery(e.target.value) }),
+              React.createElement('span', { className: 'orf-meta' }, '显示 ' + list.length + ' / ' + (models ? models.length : 0)))
+
+            function makeRow(m) {
+              const isActive = activeId === m.id
+              const s = (m.contextWindow || 0) / 1048576 * 100 + (m.reasoning ? 50 : 0) + (m.input && m.input.indexOf('image') >= 0 ? 10 : 0) + (m.stealth ? 10 : 0)
+              const stars = Math.max(1, Math.min(5, Math.round(s / 20)))
+              return React.createElement('div', {
+                key: m.id,
+                className: 'orf-row' + (isActive ? ' active' : '') + (switching === m.id ? ' switching' : ''),
+                onClick: () => { if (!isActive) switchTo(m) },
+                title: isActive ? '当前对话模型' : '点击切换到 ' + m.id,
+              },
+                React.createElement('div', { className: 'orf-row-main' },
+                  React.createElement('div', { className: 'orf-row-name' },
+                    m.name,
+                    React.createElement('span', { className: 'orf-star', title: '综合评分 ' + stars + '★ (上下文+推理+图片+热门)' }, Array(stars + 1).join('★')),
+                    React.createElement('div', { className: 'orf-row-id' }, m.id)
+                  ),
+                  React.createElement('div', { className: 'orf-badges' },
+                    isActive ? React.createElement('span', { className: 'orf-badge use' }, '✓ 使用中') : null,
+                    m.reasoning ? React.createElement('span', { className: 'orf-badge think' }, '🧠 推理') : null,
+                    m.input && m.input.indexOf('image') >= 0 ? React.createElement('span', { className: 'orf-badge img' }, '🖼 图片') : null,
+                    React.createElement('span', { className: 'orf-badge ctx' }, fmtCtx(m.contextWindow))
+                  )
+                )
+              )
+            }
+
+            const rows = list.map(makeRow)
+
+            const body = loading
+              ? React.createElement('div', { className: 'orf-empty' }, '正在拉取 OpenRouter 免费清单…')
+              : error
+                ? React.createElement('div', { className: 'orf-empty', style: { color: '#f85149' } }, '出错了：' + error)
+                : list.length ? React.createElement('div', { className: 'orf-list' }, rows) : React.createElement('div', { className: 'orf-empty' }, '没有匹配的免费模型')
+
+            const toastEl = toast ? React.createElement('div', { className: 'orf-toast' + (toast.err ? ' err' : '') }, toast.msg) : null
+
+            return React.createElement('div', { className: 'orf-wrap' }, header, curBar, toolbar, body,
+              React.createElement('div', { className: 'orf-note' }, '💡 点击任意行立即切换为对话模型（免重启）；“全部装进选择器”把所有免费模型写入 openrouter 路由。免费模型有平台速率限制。'),
+              toastEl
+            )
+          }
+          return React.createElement(Panel, props)
+        })
+      )
+    }
+
+    exports.apply = apply
+    return module.exports
+  },
+})

package/lib/index.js

@@ -0,0 +1,232 @@
+/**
+ * dsh-openrouter-free — host half
+ *
+ * 自动识别 OpenRouter 免费模型 + 一键切换：
+ *   free.list({refresh})  → 拉取 openrouter.ai/api/v1/models（公开，免密钥），
+ *                           过滤 pricing.prompt==='0' && pricing.completion==='0'，
+ *                           内存缓存 10 分钟。
+ *   current()             → 读 agent-default-model 设置分节（当前对话模型）。
+ *   use({id})             → 把该免费模型 upsert 进 llm-pi-ai.providers.openrouter.models
+ *                           （保留所有非免费手工条目，如 ox-alpha 的精调条目），
+ *                           再把 agent-default-model 指向它。settings 写入后
+ *                           下一次请求即生效（llm-pi-ai 每操作重读 profile，无需重启）。
+ *   syncAll()             → 全部免费模型一次装入选择器。
+ *   removeFree({id})      → 从路由移除某个免费模型（当前选中者拒绝移除）。
+ *
+ * webServer route: /__orfree/api（client fetch）
+ * 设计依据：packages/llm/llm-pi-ai/README.zh.md —— models 列表=替换该路由 catalog；
+ * settings 分节更新即时生效；agent-default-model 是 GUI 模型选择器写的同一分节。
+ */
+
+export const name = 'dsh-openrouter-free'
+
+// settings 用可选获取：服务缺席时 API 返回可读错误，不阻塞 bundle 树激活
+export const inject = ['webServer']
+
+const MODELS_URL = 'https://openrouter.ai/api/v1/models'
+const ROUTE_NS = 'llm-pi-ai'
+const DEFAULT_NS = 'agent-default-model'
+const PROVIDER_KEY = 'openrouter'
+const CACHE_TTL_MS = 10 * 60 * 1000
+
+// ---------- OpenRouter 模型 → DSH llm-pi-ai 条目映射 ----------
+
+function mapModel(m) {
+  if (!m || typeof m.id !== 'string') return null
+  const pricing = m.pricing || {}
+  // 免费判定：输入与输出单价均为 $0（OpenRouter 价格字段是字符串）
+  if (!(String(pricing.prompt) === '0' && String(pricing.completion) === '0')) return null
+
+  const mods = (m.architecture && m.architecture.input_modalities) || []
+  const input = Array.isArray(mods) && mods.indexOf('image') >= 0 ? ['text', 'image'] : ['text']
+  const sp = Array.isArray(m.supported_parameters) ? m.supported_parameters : []
+  const reasoning = sp.indexOf('reasoning') >= 0
+  const top = m.top_provider || {}
+  const maxTokens = top.max_completion_tokens || undefined
+  const contextWindow = m.context_length || undefined
+  const displayName = m.name || m.id
+
+  return {
+    id: m.id,
+    name: displayName,
+    contextWindow: contextWindow,
+    maxTokens: maxTokens,
+    input: input,
+    reasoning: reasoning,
+    stealth: m.id.indexOf('stealth/') === 0,
+    // 写入 llm-pi-ai providers.openrouter.models 的条目（仅 schema 认识的字段）。
+    // reasoningEfforts 不声明 off：避免空值歧义，默认档位由 agent-default-model 给 high。
+    entry: Object.assign(
+      { id: m.id, name: displayName },
+      contextWindow ? { contextWindow } : {},
+      maxTokens ? { maxTokens } : {},
+      { input },
+      reasoning ? { reasoningEfforts: { low: 'low', medium: 'medium', high: 'high' } } : {}
+    ),
+  }
+}
+
+function fmtErr(error) {
+  return String((error && error.message) || error)
+}
+
+// ---------- apply ----------
+
+export function apply(ctx) {
+  const web = ctx.get('webServer')
+  if (!web) return
+
+  let cache = null
+  let fetchedAt = 0
+
+  async function fetchFree(force) {
+    if (!force && cache && Date.now() - fetchedAt < CACHE_TTL_MS) {
+      return { rows: cache, cached: true, fetchedAt }
+    }
+    const res = await fetch(MODELS_URL, {
+      headers: { accept: 'application/json' },
+      signal: AbortSignal.timeout(20000),
+    })
+    if (!res.ok) throw new Error('OpenRouter HTTP ' + res.status)
+    const j = await res.json()
+    const all = (j && j.data) || []
+    const rows = []
+    for (const m of all) {
+      const row = mapModel(m)
+      if (row) rows.push(row)
+    }
+    // stealth 置顶，其余按上下文窗口降序
+    rows.sort((a, b) => {
+      if (a.stealth !== b.stealth) return a.stealth ? -1 : 1
+      return (b.contextWindow || 0) - (a.contextWindow || 0)
+    })
+    cache = rows
+    fetchedAt = Date.now()
+    return { rows, cached: false, fetchedAt }
+  }
+
+  function settingsSvc() {
+    const s = ctx.get('settings')
+    if (!s) throw new Error('settings 服务不可用（本插件需要 settings seam）')
+    return s
+  }
+
+  function readRouteModels() {
+    try {
+      const section = ctx.get('settings') ? ctx.get('settings').get(ROUTE_NS) : null
+      const prov = section && section.providers && section.providers[PROVIDER_KEY]
+      return Array.isArray(prov && prov.models) ? prov.models.slice() : []
+    } catch {
+      return []
+    }
+  }
+
+  function readDefault() {
+    try {
+      const d = ctx.get('settings') ? ctx.get('settings').get(DEFAULT_NS) : null
+      return d && typeof d === 'object'
+        ? { provider: d.provider || '', model: d.model || '', reasoningEffort: d.reasoningEffort }
+        : {}
+    } catch {
+      return {}
+    }
+  }
+
+  const api = {
+    async 'free.list'(args) {
+      const { rows, cached, fetchedAt } = await fetchFree(Boolean(args && args.refresh))
+      return {
+        ok: true,
+        count: rows.length,
+        cached,
+        fetchedAt,
+        models: rows.map((r) => ({
+          id: r.id,
+          name: r.name,
+          contextWindow: r.contextWindow,
+          maxTokens: r.maxTokens,
+          input: r.input,
+          reasoning: r.reasoning,
+          stealth: r.stealth,
+        })),
+      }
+    },
+
+    current() {
+      return { ok: true, default: readDefault(), installedIds: readRouteModels().map((e) => e && e.id).filter(Boolean) }
+    },
+
+    async 'model.use'(args) {
+      const id = String((args && args.id) || '')
+      if (!id) throw new Error('missing id')
+      const { rows } = await fetchFree(false)
+      const row = rows.find((r) => r.id === id)
+      if (!row) throw new Error('不是免费模型或清单里没有它：' + id)
+
+      const s = settingsSvc()
+      const models = readRouteModels()
+      const next = models.filter((e) => !(e && e.id === id))
+      next.push(row.entry)
+      await s.update(ROUTE_NS, { providers: { [PROVIDER_KEY]: { models: next } } })
+
+      // agent-default-model 整节替换：不支持推理的模型必须摘掉 reasoningEffort，
+      // 否则请求会在网络 I/O 前以 UNSUPPORTED_REASONING_EFFORT 失败。
+      const doc = { provider: PROVIDER_KEY, model: id }
+      if (row.reasoning) doc.reasoningEffort = 'max'
+      await s.replace(DEFAULT_NS, doc)
+
+      return { ok: true, applied: doc, installedCount: next.length, note: '下一次请求即生效，无需重启' }
+    },
+
+    async 'sync.all'() {
+      const { rows } = await fetchFree(false)
+      if (!rows.length) throw new Error('免费清单为空')
+      const s = settingsSvc()
+      const models = readRouteModels()
+      const freeIds = new Set(rows.map((r) => r.id))
+      // 非免费的手工条目原样保留（如 ox-alpha 精调条目），免费条目整体刷新
+      const keptManual = models.filter((e) => !(e && typeof e.id === 'string' && freeIds.has(e.id)))
+      const entries = rows.map((r) => r.entry)
+      await s.update(ROUTE_NS, { providers: { [PROVIDER_KEY]: { models: keptManual.concat(entries) } } })
+      return { ok: true, installedCount: entries.length, keptManual: keptManual.length, note: '已全部装入模型选择器' }
+    },
+
+    async 'free.remove'(args) {
+      const id = String((args && args.id) || '')
+      if (!id) throw new Error('missing id')
+      const def = readDefault()
+      if (def.model === id) throw new Error('该模型是当前对话模型，请先切换到别的模型再移除')
+      const s = settingsSvc()
+      const models = readRouteModels()
+      const next = models.filter((e) => !(e && e.id === id))
+      if (next.length === models.length) throw new Error('路由中没有这个模型：' + id)
+      await s.update(ROUTE_NS, { providers: { [PROVIDER_KEY]: { models: next } } })
+      return { ok: true, installedCount: next.length }
+    },
+  }
+
+  function handle(req, res) {
+    let body = ''
+    req.on('data', (chunk) => { body += chunk })
+    req.on('end', () => {
+      let payload = {}
+      try { payload = JSON.parse(body || '{}') } catch { /* ignore */ }
+      const method = String((payload && payload.method) || '')
+      const fn = api[method]
+      if (!fn) {
+        res.writeHead(404, { 'content-type': 'application/json' })
+        res.end(JSON.stringify({ ok: false, error: 'unknown method ' + method }))
+        return
+      }
+      Promise.resolve(fn((payload && payload.args) || {})).then((result) => {
+        res.writeHead(200, { 'content-type': 'application/json', 'cache-control': 'no-cache' })
+        res.end(JSON.stringify(result))
+      }).catch((error) => {
+        res.writeHead(500, { 'content-type': 'application/json' })
+        res.end(JSON.stringify({ ok: false, error: fmtErr(error) }))
+      })
+    })
+  }
+
+  ctx.effect(() => web.register({ kind: 'prefix', path: '/__orfree', handler: handle }))
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "dsh-openrouter-free",
+  "version": "0.2.0",
+  "description": "OpenRouter 免费模型面板：自动拉取实时免费模型清单（综合能力 1-5★ 分级、最优优先排序），一键安装进 openrouter 路由并设为当前对话模型（推理档默认 max），免手动配置。",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "cordis",
+    "plugin",
+    "openrouter",
+    "free-models"
+  ],
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
+    }
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "react": "^18.2.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jiang12345-code/dsh-openrouter-free.git"
+  },
+  "homepage": "https://github.com/jiang12345-code/dsh-openrouter-free#readme",
+  "bugs": {
+    "url": "https://github.com/jiang12345-code/dsh-openrouter-free/issues"
+  }
+}