dsh-openrouter-free 0.2.0 → 0.2.2

package/README.md

@@ -4,17 +4,18 @@
 ![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 免费模型面板（DeepSeek Harness / DSH 持久插件）。特性：**综合能力 1-5★ 分级标星 · 最优三优先排序 · 一键切换（会话级 + 全局双写，推理档自动预校验）**。
 
 自动拉取 [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` 指向它。**下一次请求即生效，无需重启**。
+- **一键切换（会话级 + 全局双写）**：点击任意行 → 该模型被 upsert 进 `llm-pi-ai.providers.openrouter.models`，同时经原生 `sessionController.selectModel()` 写入**当前会话**的模型选择并更新 `agent-default-model`。**下一次请求即生效，无需重启**（对有请求历史的会话，只改全局默认不够——三层优先级 pending→lastUsed→default 会压住它）。
+- **推理档自动预校验**：切换时从高到低试选该模型真正支持的档位（low/medium/high）；不支持推理的模型自动摘掉 `reasoningEffort`，避免请求以 `UNSUPPORTED_REASONING_EFFORT` 失败。
+- **凭据面板**：内置 OpenRouter API Key 设置入口，缺密钥时直接提示补填。
 - **全部装进选择器**：一次把所有免费模型写入路由，之后也能用 DSH 自带模型选择器切换。
 - **安全保留手工条目**：同步/切换单个模型时，所有非免费的手工条目（如 `stealth/ox-alpha` 的精调条目）原样保留；「全部装进选择器」也只刷新免费条目。
-- **推理档自适应**：不支持推理的模型切换时会自动摘掉 `reasoningEffort`，避免请求以 `UNSUPPORTED_REASONING_EFFORT` 失败。
 
 ## 前置条件
 

package/lib/client.js

@@ -47,6 +47,12 @@ window.__ModuleLoader__.load({
       + '.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)}}'
+      + '.orf-keywarn{flex:none;display:flex;flex-direction:column;gap:8px;padding:10px 14px;background:rgba(210,153,34,.08);border:1px solid rgba(210,153,34,.45);border-radius:10px;font-size:12px;color:#d29922;}'
+      + '.orf-keywarn-title{font-weight:600;}'
+      + '.orf-keyrow{display:flex;gap:8px;}'
+      + '.orf-keyinput{flex:1;background:#161b22;border:1px solid #30363d;border-radius:8px;padding:7px 12px;font-size:12px;color:#e6edf3;outline:none;font-family:"JetBrains Mono",monospace;}'
+      + '.orf-keyinput:focus{border-color:rgba(210,153,34,.6);}'
+      + '.orf-keyhint{font-size:11px;color:#8b949e;}'
 
     function injectStyles(css) {
       if (typeof document === 'undefined') return
@@ -94,6 +100,7 @@ window.__ModuleLoader__.load({
         { name: 'conversation.view', id: 'dsh-openrouter-free', label: '免费模型', order: 9 },
         (props) => {
           function Panel() {
+            const sessionId = props && props.sessionId ? String(props.sessionId) : ''
             const [models, setModels] = React.useState(null)
             const [cur, setCur] = React.useState(null)
             const [loading, setLoading] = React.useState(true)
@@ -102,9 +109,22 @@ window.__ModuleLoader__.load({
             const [query, setQuery] = React.useState('')
             const [refreshing, setRefreshing] = React.useState(false)
             const [switching, setSwitching] = React.useState('')
+            const [keyInfo, setKeyInfo] = React.useState(null)
+            const [keyDraft, setKeyDraft] = React.useState('')
+            const [savingKey, setSavingKey] = React.useState(false)
 
             function showToast(msg, isErr) { setToast({ msg: msg, err: !!isErr }); setTimeout(() => setToast(''), 2600) }
             function loadCurrent() { api('current').then(j => setCur(j.default || {})).catch(() => {}) }
+            function loadKeyStatus() { api('key.status').then(j => setKeyInfo(j)).catch(() => {}) }
+            function saveKey() {
+              const keyDraftValue = keyDraft.trim()
+              if (!keyDraftValue) { showToast('请先粘贴 API Key', true); return }
+              setSavingKey(true)
+              api('key.set', { key: keyDraftValue })
+                .then(j => { setKeyDraft(''); return loadKeyStatus().then(() => showToast(j.note || '已保存')) })
+                .catch(e => showToast(String(e.message || e), true))
+                .then(() => setSavingKey(false))
+            }
             function loadList(refresh) {
               setRefreshing(true); if (refresh) setError('')
               api('free.list', { refresh: !!refresh })
@@ -112,12 +132,17 @@ window.__ModuleLoader__.load({
                 .catch(e => setError(String(e.message || e)))
                 .then(() => { setRefreshing(false); setLoading(false); })
             }
-            React.useEffect(() => { loadCurrent(); loadList(false) }, [])
+            React.useEffect(() => { loadCurrent(); loadKeyStatus(); loadList(false) }, [])
 
             function switchTo(m) {
               setSwitching(m.id); setError('')
-              api('model.use', { id: m.id })
-                .then(j => { showToast('已切换 → ' + m.id + '（下一次请求生效）'); return loadCurrent() })
+              api('model.use', { id: m.id, sessionId: sessionId })
+                .then(j => {
+                  showToast(j.sessionApplied
+                    ? '已切换 → ' + m.id + '（本会话与全局默认都已生效）'
+                    : '已切换 → ' + m.id + '（' + (j.note || '下一次请求生效') + '）')
+                  return loadCurrent()
+                })
                 .catch(e => { setError(String(e.message || e)); showToast(String(e.message || e), true) })
                 .then(() => setSwitching(''))
             }
@@ -189,6 +214,20 @@ window.__ModuleLoader__.load({
 
             const rows = list.map(makeRow)
 
+            const keyBar = keyInfo && keyInfo.configured === false
+              ? React.createElement('div', { className: 'orf-keywarn' },
+                  React.createElement('div', { className: 'orf-keywarn-title' }, '⚠ OpenRouter API Key 未配置——免费模型也需要 Key 认证，否则发消息报 MISSING_CREDENTIAL'),
+                  React.createElement('div', { className: 'orf-keyrow' },
+                    React.createElement('input', {
+                      className: 'orf-keyinput', type: 'password',
+                      placeholder: '粘贴 OpenRouter API Key（sk-or-v1-…）', value: keyDraft,
+                      onChange: (e) => setKeyDraft(e.target.value),
+                    }),
+                    React.createElement('button', { className: 'orf-btn primary', onClick: saveKey, disabled: savingKey },
+                      savingKey ? '保存中…' : '保存 Key')),
+                  React.createElement('div', { className: 'orf-keyhint' }, '在 openrouter.ai/keys 免费注册获取；Key 只存进本机凭据库，保存后面板警告自动消失，无需重启。'))
+              : null
+
             const body = loading
               ? React.createElement('div', { className: 'orf-empty' }, '正在拉取 OpenRouter 免费清单…')
               : error
@@ -197,8 +236,8 @@ window.__ModuleLoader__.load({
 
             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 路由。免费模型有平台速率限制。'),
+            return React.createElement('div', { className: 'orf-wrap' }, header, curBar, keyBar, toolbar, body,
+              React.createElement('div', { className: 'orf-note' }, '💡 点击任意行立即切换为对话模型（本会话 + 全局默认一起切，免重启）；“全部装进选择器”把所有免费模型写入 openrouter 路由。免费模型有平台速率限制。'),
               toastEl
             )
           }

package/lib/index.js

@@ -27,6 +27,7 @@ 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 KEY_REF = 'OPENROUTER_API_KEY'
 const CACHE_TTL_MS = 10 * 60 * 1000
 
 // ---------- OpenRouter 模型 → DSH llm-pi-ai 条目映射 ----------
@@ -169,13 +170,92 @@ export function apply(ctx) {
       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)
+      // 选一个该模型真正支持的推理档：mapModel 给推理模型只声明 {low,medium,high}
+      // （无 max），故从高到低试 resolveCallConfig 挑第一个通过的档；非推理模型直接
+      // 省略 reasoningEffort（设任何档都会触发 UNSUPPORTED_REASONING_EFFORT）。
+      const llm = ctx.get('llm')
+      const candidates = row.reasoning ? ['high', 'medium', 'low'] : [undefined]
+      let chosenEffort
+      let resolvedOk = false
+      if (llm && typeof llm.resolveCallConfig === 'function') {
+        for (const eff of candidates) {
+          const cfg = { provider: PROVIDER_KEY, model: id }
+          if (eff !== undefined) cfg.reasoningEffort = eff
+          try { await llm.resolveCallConfig(cfg); chosenEffort = eff; resolvedOk = true; break } catch { /* 试下一档 */ }
+        }
+        if (!resolvedOk) throw new Error('模型预校验失败（未切换）：openrouter/' + id + ' 无法解析为可用调用配置')
+      } else {
+        chosenEffort = row.reasoning ? 'high' : undefined
+      }
+      const selected = { provider: PROVIDER_KEY, model: id }
+      if (chosenEffort !== undefined) selected.reasoningEffort = chosenEffort
+      await s.replace(DEFAULT_NS, selected)
+
+      // 会话级同步：已有请求历史的会话，其模型锁在会话投影（modelSelection
+      // 事件）里，只改全局默认对该会话无效。原生底部选择器走的是
+      // sessionController.selectModel（commands.ts L118）= resolveAgent（含冷会话
+      // resume）→ selectForNextRequest（写 model/selection 会话事件 + 内存
+      // selection 双写）→ agentDefaultModel.saveSelection。
+      // ⚠️ 不能用 ctx.get('agents').selectForNextRequest —— 公开的 agents 服务是
+      // core/agent 的 AgentRegistry（只有 get/list/create/resume…），
+      // selectForNextRequest 在 session-controller 的内部类
+      // ApiSessionAgentController 上，不在任何公开服务接口里（2026-09-03 问题一
+      // 根因：v0.2.1 调了这个不存在的幻影 API，会话级那一笔从未落地）。
+      // 这里直调 sessionController.selectModel 公开方法，与原生切换行为完全一致。
+      const sessionId = String((args && args.sessionId) || '')
+      let sessionApplied = false
+      let sessionNote = ''
+      if (sessionId) {
+        const controller = ctx.get('sessionController')
+        if (controller && typeof controller.selectModel === 'function') {
+          try {
+            await controller.selectModel(Object.assign({ sessionId: sessionId }, selected))
+            sessionApplied = true
+          } catch (error) {
+            sessionNote = '会话级写入失败，已改全局默认（该会话请用底部模型选择器重选一次）：' + fmtErr(error)
+          }
+        } else {
+          sessionNote = 'sessionController 服务不可用，仅改全局默认'
+        }
+      } else {
+        sessionNote = '未收到会话 id（前端未取到 sessionId），仅改全局默认'
+      }
+
+      return {
+        ok: true,
+        applied: selected,
+        installedCount: next.length,
+        sessionApplied,
+        sessionIdSeen: sessionId !== '',
+        ...(sessionNote ? { note: sessionNote } : { note: '下一次请求即生效，无需重启' }),
+      }
+    },
 
-      return { ok: true, applied: doc, installedCount: next.length, note: '下一次请求即生效，无需重启' }
+    // ---------- OpenRouter API Key（免费模型也必须带 key 认证） ----------
+
+    async 'key.status'() {
+      const cred = ctx.get('credentials')
+      if (!cred) throw new Error('credentials 服务不可用')
+      const info = await cred.describe(KEY_REF)
+      return { ok: true, configured: info.configured === true, source: info.source, writable: info.writable !== false }
+    },
+
+    async 'key.set'(args) {
+      const value = String((args && args.key) || '').trim()
+      if (!value) throw new Error('key 为空')
+      if (!/^[\x21-\x7E]+$/.test(value)) throw new Error('key 含非法字符（只允许可见 ASCII）')
+      if (value.length < 20) throw new Error('key 太短，不像有效的 API Key')
+      const cred = ctx.get('credentials')
+      if (!cred) throw new Error('credentials 服务不可用')
+      await cred.set(KEY_REF, value)
+      return { ok: true, note: 'OPENROUTER_API_KEY 已写入凭据库，下一次请求即生效' }
+    },
+
+    async 'key.unset'() {
+      const cred = ctx.get('credentials')
+      if (!cred) throw new Error('credentials 服务不可用')
+      await cred.unset(KEY_REF)
+      return { ok: true }
     },
 
     async 'sync.all'() {
@@ -205,7 +285,19 @@ export function apply(ctx) {
     },
   }
 
+  // host-auth 只包 /api 前缀，自定义前缀须自建 loopback 围栏
+  //（本端点可改凭据，绝不能对局域网开放）。
+  function isLoopback(req) {
+    const addr = String((req.socket && req.socket.remoteAddress) || '')
+    return addr === '127.0.0.1' || addr === '::1' || addr === '::ffff:127.0.0.1'
+  }
+
   function handle(req, res) {
+    if (!isLoopback(req)) {
+      res.writeHead(403, { 'content-type': 'application/json' })
+      res.end(JSON.stringify({ ok: false, error: 'loopback only' }))
+      return
+    }
     let body = ''
     req.on('data', (chunk) => { body += chunk })
     req.on('end', () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-openrouter-free",
-  "version": "0.2.0",
-  "description": "OpenRouter 免费模型面板：自动拉取实时免费模型清单（综合能力 1-5★ 分级、最优优先排序），一键安装进 openrouter 路由并设为当前对话模型（推理档默认 max），免手动配置。",
+  "version": "0.2.2",
+  "description": "OpenRouter 免费模型面板：自动拉取实时免费模型清单（综合能力 1-5★ 分级、最优优先排序），一键安装进 openrouter 路由并切换当前对话模型（全局默认 + 会话级双写，推理档自动选该模型支持的最高档），免手动配置。",
   "keywords": [
     "deepseek-harness",
     "dsh",