w-dispatch-ai 1.0.26 → 1.0.27

package/src/dispatchOpencode.mjs

@@ -18,6 +18,19 @@ import dfTimeoutMs from './dfTimeoutMs.mjs'
 //   帶入真實key → 正常回應。以env傳入「不會改寫」auth.json(實測md5前後一致)，
 //   屬process層級，可與同時執行的其他專案並行而互不干擾。
 //   註：OPENCODE_API_KEY在auth.json已有憑證時不生效，故一律走OPENCODE_AUTH_CONTENT。
+//   原始碼依據(anomalyco/opencode dev, packages/opencode/src/auth/index.ts之Auth.all):
+//   `if (process.env.OPENCODE_AUTH_CONTENT) return JSON.parse(...)`, 解析成功即整份取代, 不與auth.json合併;
+//   空字串為falsy、非法JSON會落回讀auth.json。auth.json位於<XDG_DATA_HOME|~/.local/share>/opencode/。
+//
+// 【不讀auth.json之匿名呼叫: useStoredAuth:false(2026-09-17實測後新增)】
+//   未注入金鑰時opencode會自動沿用auth.json之登入; 該帳號工作區若未開某免費模型(如union-alpha),
+//   就回`Error: Model is disabled`, 而同一模型在「無auth.json」之機器上匿名可用——結果隨執行機器而異。
+//   useStoredAuth:false時注入OPENCODE_AUTH_CONTENT='{}'(空憑證), 令本次不讀auth.json而以匿名免費存取。
+//   實測(以XDG_DATA_HOME指向內含opencode金鑰之暫存auth.json): 不帶key→Model is disabled;
+//   加'{}'→7.0s成功; 改注入''→仍Model is disabled(空字串無效, 故不可讓呼叫端自填); auth.json前後md5一致。
+//   同時給key與provider時金鑰注入本就整份取代auth.json, 此旗標不再作用。
+//   風險備忘: 原始碼Auth.set會以Auth.all()(即注入內容)為底寫回auth.json, 僅於OAuth權杖刷新等寫入時發生;
+//   api型金鑰與空憑證皆無刷新, 實測未觸發。
 //
 // 【provider與model必須配對】不同provider的金鑰不可互換：
 //   實測把agnes-ai的金鑰用於opencode/...模型 → `Invalid API key`。
@@ -38,7 +51,7 @@ let DEFAULT_AGENT = 'build'
 
 
 //本轉接器自用之設定鍵, 其餘鍵一律原樣轉傳execCli
-let OWN_KEYS = ['exe', 'model', 'key', 'provider', 'agent', 'config', 'extraArgs', 'input', 'env']
+let OWN_KEYS = ['exe', 'model', 'key', 'provider', 'useStoredAuth', 'agent', 'config', 'extraArgs', 'input', 'env']
 
 
 /**
@@ -49,7 +62,7 @@ let OWN_KEYS = ['exe', 'model', 'key', 'provider', 'agent', 'config', 'extraArgs
  * 而opencode run未帶位置message時即從stdin讀取；
  * 同時給予key與provider時，以OPENCODE_AUTH_CONTENT環境變數逐次注入金鑰，
  * 該注入僅作用於當次子進程且不改寫auth.json，故可多把金鑰輪替並與其他程序並行；
- * 未給key或provider時沿用CLI既有登入狀態；
+ * 未給key或provider時沿用CLI既有登入狀態(auth.json)，useStoredAuth為false則改以匿名存取；
  * 使用opencode未內建之第三方provider時，須另以config給予其provider定義；
  * 本函數不會reject，一律以結果物件之ok與error欄位回報成敗
  *
@@ -59,6 +72,7 @@ let OWN_KEYS = ['exe', 'model', 'key', 'provider', 'agent', 'config', 'extraArgs
  * @param {String} [opt.model=''] 輸入模型ID字串，例如'opencode/deepseek-v4-flash-free'，預設''代表不帶`-m`旗標
  * @param {String} [opt.key=''] 輸入該provider之API key字串，須與provider同時給予才會注入，預設''代表沿用CLI既有登入狀態
  * @param {String} [opt.provider=''] 輸入key所屬provider名稱字串，須與key同時給予才會注入，且須與model為同一組，預設''
+ * @param {Boolean} [opt.useStoredAuth=true] 輸入未注入金鑰時是否沿用本機auth.json之登入布林值，false代表注入空憑證令本次以匿名存取(適用opencode之免費模型，避免結果隨本機登入帳號而異)；已同時給key與provider時不作用，預設true
  * @param {Object|String} [opt.config=null] 輸入opencode設定內容物件或其JSON字串，將以OPENCODE_CONFIG_CONTENT逐次注入，供補上第三方provider之定義，預設null代表沿用使用者既有設定檔
  * @param {String} [opt.agent='build'] 輸入opencode代理名稱字串，預設'build'
  * @param {Array} [opt.extraArgs=[]] 輸入額外命令列旗標字串陣列，將接於固定旗標之後，預設[]
@@ -166,15 +180,23 @@ async function dispatchOpencode(prompt, opt = {}) {
         }
     }
 
-    //key與provider皆有效才注入, 否則沿用auth.json既有登入狀態(單金鑰時即為原有行為)
+    //key與provider皆有效才注入, 否則沿用auth.json既有登入狀態(單金鑰時即為原有行為);
+    //useStoredAuth為false且未注入金鑰時, 注入'{}'令opencode本次不讀auth.json(匿名, 見檔頭)
     let key = get(opt, 'key', null)
     let provider = get(opt, 'provider', null)
+    let useStoredAuth = get(opt, 'useStoredAuth', null) !== false
     if (isestr(key) && isestr(provider)) {
         env = {
             ...env,
             OPENCODE_AUTH_CONTENT: JSON.stringify({ [provider]: { type: 'api', key } }),
         }
     }
+    else if (!useStoredAuth) {
+        env = {
+            ...env,
+            OPENCODE_AUTH_CONTENT: '{}',
+        }
+    }
 
     //timeoutMs, 無效回退全套件統一預設(dfTimeoutMs=300000), 各轉接器一致令呼叫方無須記多套數字
     let timeoutMs = castPintOr(get(opt, 'timeoutMs', null), dfTimeoutMs)

package/src/providers.mjs

@@ -173,13 +173,16 @@ let providers = [
         model: 'opencode/union-alpha',
         kind: 'opencode',
         provider: 'opencode',
+        useStoredAuth: false,
         config: {
             permission: { edit: 'deny', write: 'deny', bash: 'deny' },
         },
         //Union Alpha Free(官方文件: 限時免費之stealth模型, 端點/messages)。2026-09-17實測(opencode CLI 1.18.31):
-        //刻意不帶envVar——不注入金鑰時opencode走自身免費存取, 實測6.8s成功; OPENCODE_KEYS之第1把金鑰
-        //所屬工作區未開此模型(回Model is disabled), 第2把雖可用但該工作區會預設開啟新模型(可能非免費), 不採用。
-        //前提是本機opencode未登入(無auth.json); 若日後以金鑰登入, 須於該工作區開啟此模型。
+        //刻意不帶envVar且useStoredAuth:false——以匿名免費存取呼叫, 不隨本機登入帳號而異。
+        //OPENCODE_KEYS之第1把金鑰所屬工作區未開此模型(回Model is disabled), 第2把雖可用但該工作區
+        //會預設開啟新模型(可能非免費), 皆不採用。原先只「不帶envVar」, 但未注入金鑰時opencode會沿用
+        //本機auth.json之登入: 登入帳號之工作區未開此模型的機器即回Model is disabled(使用端回報並經本機以
+        //XDG_DATA_HOME暫存auth.json重現), 故加useStoredAuth:false令本次不讀auth.json(實測7.0s成功)。
         //REST不收zen:版: /messages對免費模型回403 FreeTierError(free tier can only be used from within OpenCode)
     },
     {

package/test/unit-dispatchOpencode.test.mjs

@@ -82,6 +82,31 @@ describe('dispatchOpencode', function() {
         assert.strict.deepEqual(r, rr)
     })
 
+    it('useStoredAuth為false且未注入金鑰時注入空憑證\'{}\'(不讀auth.json); 非false一律不注入; 旗標不進命令列', async function() {
+        let t1 = await dispatchOpencode('abc', { exe: fake.exe, provider: 'opencode', useStoredAuth: false })
+        let t2 = await dispatchOpencode('abc', { exe: fake.exe, useStoredAuth: false })
+        let t3 = await dispatchOpencode('abc', { exe: fake.exe, useStoredAuth: true })
+        let t4 = await dispatchOpencode('abc', { exe: fake.exe, useStoredAuth: 'false' })
+        let r = [
+            JSON.parse(t1.stdout).env.OPENCODE_AUTH_CONTENT,
+            JSON.parse(t2.stdout).env.OPENCODE_AUTH_CONTENT,
+            JSON.parse(t3.stdout).env.OPENCODE_AUTH_CONTENT,
+            JSON.parse(t4.stdout).env.OPENCODE_AUTH_CONTENT,
+            JSON.parse(t1.stdout).args,
+        ]
+        let rr = ['{}', '{}', '', '', ['run', '--agent', 'build']]
+        assert.strict.deepEqual(r, rr)
+    })
+
+    it('useStoredAuth為false但同時給key與provider時以金鑰注入為準; 亦覆寫呼叫端env內之同名變數', async function() {
+        let t1 = await dispatchOpencode('abc', { exe: fake.exe, provider: 'opencode', key: 'sk-abc123', useStoredAuth: false })
+        let t2 = await dispatchOpencode('abc', { exe: fake.exe, useStoredAuth: false, env: { OPENCODE_AUTH_CONTENT: '', FAKE_ENV: 'x' } })
+        let o2 = JSON.parse(t2.stdout)
+        let r = [JSON.parse(JSON.parse(t1.stdout).env.OPENCODE_AUTH_CONTENT), o2.env.OPENCODE_AUTH_CONTENT, o2.env.FAKE_ENV]
+        let rr = [{ opencode: { type: 'api', key: 'sk-abc123' } }, '{}', 'x']
+        assert.strict.deepEqual(r, rr)
+    })
+
     it('金鑰注入僅作用於當次子進程, 不影響本進程之process.env', async function() {
         let before = process.env.OPENCODE_AUTH_CONTENT
         let t = await dispatchOpencode('abc', { exe: fake.exe, provider: 'opencode', key: 'sk-abc123' })

package/test/unit-providers.test.mjs

@@ -57,6 +57,13 @@ describe('providers', function() {
         assert.strict.deepEqual(r, rr)
     })
 
+    it('opencode條目不帶envVar者必設useStoredAuth:false(否則會沿用本機auth.json, 結果隨執行機器之登入帳號而異)', function() {
+        let noKey = providers.filter((p) => p.kind === 'opencode' && p.envVar === undefined)
+        let r = noKey.map((p) => [p.id, p.useStoredAuth])
+        let rr = noKey.map((p) => [p.id, false])
+        assert.strict.deepEqual([noKey.length > 0, r], [true, rr])
+    })
+
     it('決策型條目(api-typesafe-systemone)不位於清單末端, 免得全取遞補全敗時以「questions必填」掩蓋真正錯誤', function() {
         let idx = providers.map((p, i) => p.kind === 'api-typesafe-systemone' ? i : -1).filter((i) => i >= 0)
         let r = [idx.length > 0, idx.every((i) => i < providers.length - 1)]