dsh-workspace-api-key 0.2.15 → 0.2.16

package/README.md

@@ -79,7 +79,7 @@ The command forwards its arguments to pnpm inside the profile directory, so the
 pnpm add dsh-workspace-api-key          # or: npm install dsh-workspace-api-key
 ```
 
-Pin a version with `dsh-workspace-api-key@0.2.15`, or install straight from the repository with `dsh-workspace-api-key@github:COH2357/dsh-workspace-api-key` (a git-hosted plugin is built from source on install).
+Pin a version with `dsh-workspace-api-key@0.2.16`, or install straight from the repository with `dsh-workspace-api-key@github:COH2357/dsh-workspace-api-key` (a git-hosted plugin is built from source on install).
 
 Then add `"dsh-workspace-api-key"` to `dsh.profile.bundles` in that profile's `package.json` and restart DSH. For local development, use a link instead:
 

package/README.zh.md

@@ -79,7 +79,7 @@ dsh plugin --profile web add dsh-workspace-api-key
 pnpm add dsh-workspace-api-key          # 或者：npm install dsh-workspace-api-key
 ```
 
-锁版本用 `dsh-workspace-api-key@0.2.15`；直接从仓库装则用 `dsh-workspace-api-key@github:COH2357/dsh-workspace-api-key`（git 来源的插件会在安装时现场构建）。
+锁版本用 `dsh-workspace-api-key@0.2.16`；直接从仓库装则用 `dsh-workspace-api-key@github:COH2357/dsh-workspace-api-key`（git 来源的插件会在安装时现场构建）。
 
 然后把 `"dsh-workspace-api-key"` 加进该 profile `package.json` 的 `dsh.profile.bundles`，重启 DSH。本地开发用 link 代替：
 

package/lib/index.js

@@ -83,18 +83,29 @@ const SEARCH_DEFAULT_REF = 'DEEPSEEK_API_KEY_SEARCH'
  *
  * 配置本身用缓存：`credentials.resolve` 是热路径，不能每次都去 `settings.describe()`。
  */
-/** 重新读一次官方「网页搜索」配置（同步，无缓存——配置随时可能被官方页改掉）。 */
+let webCache
+
+/** 重新读一次官方「网页搜索」配置（只在请求/面板刷新这类「非热路径」里调用）。 */
 function refreshWebCache(ctx) {
   try {
-    return readWebSettings(ctx)
+    webCache = readWebSettings(ctx)
   } catch {
-    return webDefaults()
+    webCache = webCache ?? webDefaults()
   }
+  return webCache
 }
 
-/** 取官方「网页搜索」配置。 */
+/**
+ * 取官方「网页搜索」配置——**只读缓存，绝不在 resolve 热路径里重新解析**。
+ *
+ * `settings.describe()` 会 interpolate 各条目的配置，而配置里可能有 `credential-ref`，
+ * 那等于从 credentials 服务内部再调回 credentials。0.2.15 就是在 resolve 里调 describe：
+ * 搜索 → resolve(搜索 ref) → describe → describe 又去 resolve → 服务自己等自己，
+ * promise 永远不 settle。表现就是 `web_search` 卡满 60 秒，面板接口也一起挂住。
+ * 缓存由 apply()、每个 HTTP 请求入口、面板刷新时更新。
+ */
 function currentWeb(ctx) {
-  return refreshWebCache(ctx)
+  return webCache ?? webDefaults()
 }
 
 /**
@@ -1294,6 +1305,16 @@ export function apply(ctx) {
 
   // ── 1. 包装 credentials.resolve（按 ref 分辨搜索/抓取通道）──────────
   refreshWebCache(ctx)
+  // 官方页改了「网页搜索」配置就丢掉缓存：解析热路径只读缓存，不能自己去 describe。
+  try {
+    ctx.effect(() =>
+      ctx.on('settings/document-updated', () => {
+        webCache = undefined
+      }),
+    )
+  } catch (err) {
+    log('settings listener unavailable: %s', String(err?.message ?? err))
+  }
   installResolver(ctx, state)
   // 「直接禁用官方页面里的搜索 key 设置」：把官方 apiKeyEnv 指到插件自有 ref（异步、失败不影响启动）。
   void reconcileOfficialSearchRef(ctx)
@@ -1634,6 +1655,8 @@ function hasVisibleSession(rows) {
 }
 
 async function snapshot(ctx, state) {
+  // 官方「网页搜索」配置：每次面板刷新都重读一次（缓存只在请求入口更新，解析路径只读）。
+  refreshWebCache(ctx)
   const credentials = ctx.get('credentials')
   const defaultRefName = 'DEEPSEEK_API_KEY'
   const defaultInfo = await describeKey(ctx, defaultRefName)
@@ -1936,6 +1959,20 @@ async function searchStateOf(ctx, state, { sessionId, cwd }) {
 }
 
 async function handle(ctx, state, req, res) {
+  // 每个请求进来先刷新一次网页搜索配置：解析热路径只读缓存。
+  refreshWebCache(ctx)
+  // 看门狗：任何一次 await 卡住都不该让面板/测试按钮一直转圈。
+  const watchdog = setTimeout(() => {
+    if (res.writableEnded === true) return
+    try {
+      res.writeHead(504, { 'content-type': 'application/json; charset=utf-8' })
+      res.end(JSON.stringify({ ok: false, error: '面板请求超时（8 秒）：DSH 的某个服务没有响应' }))
+    } catch {
+      /* 已经写过了就忽略 */
+    }
+  }, 8000)
+  watchdog.unref?.()
+  if (typeof res.on === 'function') res.on('close', () => clearTimeout(watchdog))
   if (!isTrusted(req)) {
     res.writeHead(403)
     res.end('forbidden')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-workspace-api-key",
-  "version": "0.2.15",
+  "version": "0.2.16",
   "description": "A DeepSeek Harness plugin that binds a separate DeepSeek API key to each workspace, or to a single session, so the spend of one key stays with the sessions you choose.",
   "type": "module",
   "license": "MIT",