@danceiny/gotry 0.0.1-rc.16 → 0.0.1-rc.17

package/dist/src/i18n.js

@@ -74,4 +74,4 @@ export function enCoverage() {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/i18n.ts
+//# sourceURL=ts/src/i18n.ts

package/dist/src/index.js

@@ -18,12 +18,18 @@ import { anythingSearch } from '../capabilities/anything.js';
 import { readUrl, reach, reachStatus } from '../capabilities/agent-reach.js';
 import { videoSubtitle, githubSearch } from '../capabilities/agent-reach-deep.js';
 import { sessionLogin } from '../capabilities/session-login.js';
+import { EXTENSION_STORE_URL } from '../capabilities/session/extension-bridge.js';
 import { createConsentGate, approvalFromContext } from '../capabilities/session-consent.js';
+import { installModelOverride } from '../capabilities/model-override.js';
 import { listArtifacts, readArtifact } from '../capabilities/artifacts.js';
 import { interpretEffect, declinedObservation } from '../capabilities/effect.js';
 import { appendFacts, loadFactRegistry } from '../capabilities/fact-log.js';
 import { factsFromFlyai, factsFromSession } from './bookable-facts.js';
 import { gateArtifact } from './artifact-gate.js';
+import { installToolBudget } from './tool-budget.js';
+import { registerBenchmarkEnvironmentBridge } from './benchmark-environment-bridge.js';
+import { installBenchmarkToolIsolation } from './benchmark-tool-isolation.js';
+import { installBenchmarkAgentConformance } from './benchmark-agent-conformance.js';
 let airlineAirportMapCache = null;
 async function loadAirlineAirportMap() {
     if (airlineAirportMapCache) return airlineAirportMapCache;
@@ -44,7 +50,8 @@ export const Config = z.object({
     stateRoot: z.string().default('.'),
     timeoutMs: z.number().default(30_000),
     hbcliBin: z.string().default('hbcli'),
-    sessionAccess: z.string().default('ask')
+    sessionAccess: z.string().default('ask'),
+    benchmarkEnvironmentConfigPath: z.string().default('')
 });
 const unwrapQuery = interpretArgs;
 function renderMotivationBrief(stateRoot) {
@@ -89,6 +96,17 @@ function readTimelineTrips(stateRoot) {
         })).sort((a, b)=>a.start < b.start ? 1 : -1).slice(0, 3);
 }
 export function apply(ctx, config) {
+    installToolBudget(ctx);
+    const rawBenchmarkEnvironmentConfigPath = config.benchmarkEnvironmentConfigPath ?? '';
+    if (rawBenchmarkEnvironmentConfigPath.trim()) {
+        installModelOverride(ctx);
+        const getService = ctx.get;
+        const directSubprocess = typeof getService === 'function' ? getService.call(ctx, 'subprocess') : undefined;
+        const projection = registerBenchmarkEnvironmentBridge(rawBenchmarkEnvironmentConfigPath, (tool)=>ctx.tools.register(tool), directSubprocess);
+        installBenchmarkToolIsolation(ctx);
+        installBenchmarkAgentConformance(ctx, projection);
+        return;
+    }
     const sp = ctx['systemPrompt'];
     sp?.variable?.('current_date', ()=>{
         const d = new Date();
@@ -117,6 +135,7 @@ export function apply(ctx, config) {
             approval: approvalFromContext(ctx)
         }));
     }
+    installModelOverride(ctx);
     const registerGuarded = (tool)=>{
         const t = {
             ...tool
@@ -964,7 +983,7 @@ export function apply(ctx, config) {
     }));
     registerGuarded(defineTool({
         name: 'gotry_session_login',
-        description: 'Productized login bootstrap for the account session channel (call this when gotry_session_search returns needs-login — the user never needs a terminal). ' + 'AUTO-DETECTION FIRST: it reads ticket-cookie NAMES before anything else — if the user already logged in (on the external site) it confirms instantly WITHOUT opening any page. ' + 'OPENS the site login entry in the USER\'S OWN Chrome (foreground tab, left open for the user) and waits for the user to finish logging in on the external site. ' + 'GoTry NEVER collects, stores, or transmits credentials: no passwords, no SMS codes, no cookie values — it only checks the boolean fact "already logged in" (reads cookie NAMES only, zero values). ' + 'Transport: the GoTry Session Bridge browser extension (one-time install, ZERO Chrome system dialogs). ' + 'verdict logged-in (tickets detected) | pending (login tab opened, user not done yet — offer to re-check later) | needs-extension (one-time extension install: npx gotry setup, then chrome://extensions → load unpacked ~/.gotry/extension). ' + 'Evidence [会话:<site>-login@ts].',
+        description: 'Productized login bootstrap for the account session channel (call this when gotry_session_search returns needs-login — the user never needs a terminal). ' + 'AUTO-DETECTION FIRST: it reads ticket-cookie NAMES before anything else — if the user already logged in (on the external site) it confirms instantly WITHOUT opening any page. ' + 'OPENS the site login entry in the USER\'S OWN Chrome (foreground tab, left open for the user) and waits for the user to finish logging in on the external site. ' + 'GoTry NEVER collects, stores, or transmits credentials: no passwords, no SMS codes, no cookie values — it only checks the boolean fact "already logged in" (reads cookie NAMES only, zero values). ' + 'Transport: the GoTry Session Bridge browser extension (one-time install, ZERO Chrome system dialogs). ' + `verdict logged-in (tickets detected) | pending (login tab opened, user not done yet — offer to re-check later) | needs-extension (one-time extension install: the verdict surfaces the Chrome Web Store installUrl as a clickable link for dsh UI to render — installation is a browser concern, not gotry's). ` + 'Evidence [会话:<site>-login@ts].',
         parameters: {
             query: {
                 type: 'json',
@@ -988,7 +1007,7 @@ export function apply(ctx, config) {
             const r = await sessionLogin({
                 waitMs: typeof q?.waitSeconds === 'number' ? q.waitSeconds * 1000 : undefined
             });
-            const summary = r.verdict === 'logged-in' ? `${r.site} 登录完成确认(票据 cookie 名已检出,只读名字)。说明:登录是在携程官网、用你自己的浏览器完成的——gotry 全程未接触任何密码/验证码/cookie 值。现在可以继续会话检索了。${r.evidence}` : r.verdict === 'pending' ? `登录入口已在你的 Chrome 打开;请在弹出的标签页里正常登录携程(登录由你在官网完成,不属于 gotry)。完成后说一声"继续",我再确认。gotry 只检查"是否已登录",永不收集你的账号信息。${r.evidence}` : r.verdict === 'needs-extension' ? `需要一次性安装 GoTry Session Bridge 浏览器扩展(约 30 秒,装完零弹窗):跑 npx gotry setup 拿安装指引,在 chrome://extensions 开发者模式「加载已解压的扩展程序」指向 ~/.gotry/extension,装好后说一声"重试"。${r.evidence}` : r.verdict === 'needs-attach' ? `cdp 车道需要一次性开启你 Chrome 的远程调试开关:在你的 Chrome 地址栏打开 chrome://inspect/#remote-debugging 并打开开关,然后说一声"重试"(默认走扩展车道,无需此步)。${r.evidence}` : `登录引导未完成:${r.error ?? '未知原因'} ${r.evidence}`;
+            const summary = r.verdict === 'logged-in' ? `${r.site} 登录完成确认(票据 cookie 名已检出,只读名字)。说明:登录是在携程官网、用你自己的浏览器完成的——gotry 全程未接触任何密码/验证码/cookie 值。现在可以继续会话检索了。${r.evidence}` : r.verdict === 'pending' ? `登录入口已在你的 Chrome 打开;请在弹出的标签页里正常登录携程(登录由你在官网完成,不属于 gotry)。完成后说一声"继续",我再确认。gotry 只检查"是否已登录",永不收集你的账号信息。${r.evidence}` : r.verdict === 'needs-extension' ? `需要一次性安装 GoTry Session Bridge 浏览器扩展:这是浏览器的事,gotry 不弹面板不开剪贴板——请直接在 Chrome 应用商店一键装(add-to-chrome 自动更新)。storeUrl=${EXTENSION_STORE_URL}. 装好即生效,装完后告诉我「重试」即可。${r.evidence}` : r.verdict === 'needs-attach' ? `cdp 车道需要一次性开启你 Chrome 的远程调试开关:在你的 Chrome 地址栏打开 chrome://inspect/#remote-debugging 并打开开关,然后说一声"重试"(默认走扩展车道,无需此步)。${r.evidence}` : `登录引导未完成:${r.error ?? '未知原因'} ${r.evidence}`;
             return JSON.parse(JSON.stringify({
                 ...r,
                 summary
@@ -1002,22 +1021,28 @@ export function apply(ctx, config) {
             }),
         presentResult: (_args, value)=>{
             const r = value;
-            const label = r.verdict === 'logged-in' ? `已登录(${(r.tickets ?? []).length} 票据)` : r.verdict === 'pending' ? '等待你在携程页面完成登录' : r.verdict ?? '降级';
+            const needsExt = r.verdict === 'needs-extension';
+            const label = r.verdict === 'logged-in' ? `已登录(${(r.tickets ?? []).length} 票据)` : r.verdict === 'pending' ? '等待你在携程页面完成登录' : needsExt ? '🧩 需装 GoTry Session Bridge 扩展(浏览器商店一键装,自动更新)' : r.verdict ?? '降级';
+            const content = [
+                {
+                    type: 'text',
+                    text: String(value.summary ?? '')
+                }
+            ];
+            if (needsExt && r.installUrl) content.push({
+                type: 'text',
+                text: `安装链接:${r.installUrl}`
+            });
             return {
                 card: 'generic',
                 title: `账号登录:${label}`,
-                content: [
-                    {
-                        type: 'text',
-                        text: String(value.summary ?? '')
-                    }
-                ]
+                content
             };
         }
     }));
     registerGuarded(defineTool({
         name: 'gotry_session_search',
-        description: 'Search on the USER\'S OWN logged-in browser session (Ctrip flights today; the account channel, not an anonymous instance). ' + 'Consent gate: the FIRST call in a session asks the user via the runtime approval card; once granted it holds for the session, a refusal revokes it for the session (no repeat prompting). ' + 'Transport: GoTry Session Bridge browser extension (one-time install) — the agent side never talks to Chrome debugging, ZERO system dialogs; read-only by construction (the extension never issues requests; it only passively forwards the site\'s own search responses; agent NEVER touches credentials/captcha; on captcha it stops and returns challenged). ' + 'Currently ctrip-flight: sniffs the site search API for structured options. Evidence [会话:ctrip-flight@ts]. ' + 'verdict needs-login = call gotry_session_login (opens the Ctrip login entry in the user\'s own foreground tab — no terminal, no credentials through GoTry); ' + 'needs-extension = one-time browser-extension install (npx gotry setup for instructions) — the DEFAULT transport; cdp (chrome://inspect remote debugging) is a diagnostic fallback only via GOTRY_SESSION_TRANSPORT=cdp. ' + 'Rate-limited (≥30s between same-site calls; a challenged/timeout verdict means STOP — never retry, fall back to other tools).',
+        description: 'Search on the USER\'S OWN logged-in browser session (Ctrip flights today; the account channel, not an anonymous instance). ' + 'Consent gate: the FIRST call in a session asks the user via the runtime approval card; once granted it holds for the session, a refusal revokes it for the session (no repeat prompting). ' + 'Transport: GoTry Session Bridge browser extension (one-time install) — the agent side never talks to Chrome debugging, ZERO system dialogs; read-only by construction (the extension never issues requests; it only passively forwards the site\'s own search responses; agent NEVER touches credentials/captcha; on captcha it stops and returns challenged). ' + 'Currently ctrip-flight: sniffs the site search API for structured options. Evidence [会话:ctrip-flight@ts]. ' + 'verdict needs-login = call gotry_session_login (opens the Ctrip login entry in the user\'s own foreground tab — no terminal, no credentials through GoTry); ' + `needs-extension = one-time browser-extension install (Chrome Web Store one-click, installUrl is also surfaced as a clickable link in the verdict field for dsh UI to render) — the DEFAULT transport; cdp (chrome://inspect remote debugging) is a diagnostic fallback only via GOTRY_SESSION_TRANSPORT=cdp. ` + 'Rate-limited (≥30s between same-site calls; a challenged/timeout verdict means STOP — never retry, fall back to other tools).',
         parameters: {
             query: {
                 type: 'json',
@@ -1076,16 +1101,22 @@ export function apply(ctx, config) {
             }),
         presentResult: (_args, value)=>{
             const r = value;
-            const label = r.verdict === 'hit' ? `会话 ${r.options.length} 条` : r.verdict === 'needs-login' ? '需登录' : r.verdict === 'needs-extension' ? '需装扩展(一次性)' : r.verdict ?? '降级';
+            const needsExt = r.verdict === 'needs-extension';
+            const label = r.verdict === 'hit' ? `会话 ${r.options.length} 条` : r.verdict === 'needs-login' ? '需登录' : needsExt ? '🧩 需装 GoTry Session Bridge 扩展(浏览器商店一键装,自动更新)' : r.verdict ?? '降级';
+            const content = [
+                {
+                    type: 'text',
+                    text: String(value.summary ?? '')
+                }
+            ];
+            if (needsExt && r.installUrl) content.push({
+                type: 'text',
+                text: `安装链接:${r.installUrl}`
+            });
             return {
                 card: 'generic',
                 title: `会话检索:${label}`,
-                content: [
-                    {
-                        type: 'text',
-                        text: String(value.summary ?? '')
-                    }
-                ]
+                content
             };
         }
     }));
@@ -1636,4 +1667,4 @@ export function apply(ctx, config) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/index.ts
+//# sourceURL=ts/src/index.ts

package/dist/src/journey.js

@@ -140,4 +140,4 @@ export function parseFlightPackLegs(pack) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/journey.ts
+//# sourceURL=ts/src/journey.ts

package/dist/src/loop.js

@@ -408,4 +408,4 @@ export function probePoi(msg) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/loop.ts
+//# sourceURL=ts/src/loop.ts

package/dist/src/memory-capture.js

@@ -37,4 +37,4 @@ export function mergeProfile(current, patch) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/memory-capture.ts
+//# sourceURL=ts/src/memory-capture.ts

package/dist/src/memory-decay.js

@@ -28,4 +28,4 @@ function round4(x) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/memory-decay.ts
+//# sourceURL=ts/src/memory-decay.ts

package/dist/src/memory-utility.js

@@ -52,4 +52,4 @@ export function projectUtility(events) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/memory-utility.ts
+//# sourceURL=ts/src/memory-utility.ts

package/dist/src/mock-llm.js

@@ -100,4 +100,4 @@ export function createMockLlm(flightPackPath, slotScript = []) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/mock-llm.ts
+//# sourceURL=ts/src/mock-llm.ts

package/dist/src/model.js

@@ -131,4 +131,4 @@ export function trueCostToDict(t) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/model.ts
+//# sourceURL=ts/src/model.ts

package/dist/src/realtime-pricing.js

@@ -109,4 +109,4 @@ export function realtimeSolvePort(base, opts = {}) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/realtime-pricing.ts
+//# sourceURL=ts/src/realtime-pricing.ts

package/dist/src/slot-spec.js

@@ -162,4 +162,4 @@ export function specDateMismatches(spec, resolved) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/slot-spec.ts
+//# sourceURL=ts/src/slot-spec.ts

package/dist/src/state-ledger.js

@@ -694,6 +694,7 @@ export class StateLedger {
     }
     close() {
         this.db.close();
+        for (const [key, value] of openLedgers)if (value === this) openLedgers.delete(key);
     }
 }
 const openLedgers = new Map();
@@ -924,4 +925,4 @@ export function readCompanionsWithFallback(stateRoot) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/state-ledger.ts
+//# sourceURL=ts/src/state-ledger.ts

package/dist/src/time-anchor.js

@@ -97,4 +97,4 @@ export function parseAbsoluteDate(expr, anchorYear) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/time-anchor.ts
+//# sourceURL=ts/src/time-anchor.ts

package/dist/src/tool-budget.js

@@ -0,0 +1,136 @@
+import { randomUUID } from 'node:crypto';
+export const TOOL_BUDGET_SOFT_CALL = 16;
+export const TOOL_BUDGET_HARD_CALL = 18;
+export const TOOL_BUDGET_EXHAUSTED = 'TOOL_BUDGET_EXHAUSTED';
+export function toolBudgetDecision(callNumber) {
+    if (callNumber > TOOL_BUDGET_HARD_CALL) {
+        return {
+            kind: 'deny',
+            reason: `${TOOL_BUDGET_EXHAUSTED}: maximum ${TOOL_BUDGET_HARD_CALL} real tool dispatches per agent turn reached; provide a final answer using existing results`
+        };
+    }
+    return {
+        kind: 'allow',
+        softSignal: callNumber === TOOL_BUDGET_SOFT_CALL,
+        exhaustsBudget: callNumber === TOOL_BUDGET_HARD_CALL
+    };
+}
+export function createToolBudgetState() {
+    let calls = 0;
+    return {
+        nextCall () {
+            calls += 1;
+            return {
+                ...toolBudgetDecision(calls),
+                callNumber: calls
+            };
+        }
+    };
+}
+function convergenceContext(code, text) {
+    return {
+        id: randomUUID(),
+        role: 'user',
+        content: [
+            {
+                type: 'text',
+                text: `${code}: ${text}`
+            }
+        ],
+        source: {
+            kind: 'plugin',
+            plugin: 'gotry-tool-budget'
+        }
+    };
+}
+function exhaustionResult(reason) {
+    return {
+        isError: true,
+        error: {
+            message: reason,
+            info: {
+                name: 'ToolBudgetError',
+                code: TOOL_BUDGET_EXHAUSTED
+            }
+        },
+        content: [
+            {
+                type: 'text',
+                text: reason
+            }
+        ],
+        additionalContexts: [
+            convergenceContext(TOOL_BUDGET_EXHAUSTED, 'No more tool dispatches are permitted in this turn. Produce the final answer from existing results.')
+        ]
+    };
+}
+export function installToolBudget(ctx) {
+    if (typeof ctx.on !== 'function') return;
+    const budgetByAgent = new Map();
+    const softExecutions = new Map();
+    const pendingFinalOnly = new Map();
+    const finalOnlyDisposers = new Map();
+    const clearAgent = (agentId)=>{
+        budgetByAgent.delete(agentId);
+        for (const [token, owner] of softExecutions){
+            if (owner === agentId) softExecutions.delete(token);
+        }
+        pendingFinalOnly.delete(agentId);
+        finalOnlyDisposers.get(agentId)?.();
+        finalOnlyDisposers.delete(agentId);
+    };
+    const enterFinalOnly = (agent)=>{
+        const agentId = String(agent.id);
+        if (finalOnlyDisposers.has(agentId)) return;
+        const globalTools = ctx.tools;
+        const scopedTools = agent.ctx?.tools;
+        if (typeof globalTools.schemas !== 'function' || typeof scopedTools?.restrict !== 'function') return;
+        const inheritedNames = globalTools.schemas().map((schema)=>schema.name).filter((name)=>name !== 'run_code');
+        if (inheritedNames.length === 0) return;
+        finalOnlyDisposers.set(agentId, scopedTools.restrict({
+            deny: inheritedNames
+        }));
+    };
+    ctx.on('session/event', (subject, event)=>{
+        const agentId = String(subject.id);
+        if (event.type === 'turn/start' || event.type === 'turn/end') {
+            clearAgent(agentId);
+            return;
+        }
+        if (event.type === 'step/end') {
+            const agent = pendingFinalOnly.get(agentId);
+            if (agent) {
+                pendingFinalOnly.delete(agentId);
+                enterFinalOnly(agent);
+            }
+        }
+    });
+    ctx.on('session/disposed', (subject)=>clearAgent(String(subject.id)));
+    ctx.on('tools/execute', (exec, next)=>{
+        if (!exec.agent) return next();
+        const agentId = String(exec.agent.id);
+        const state = budgetByAgent.get(agentId) ?? createToolBudgetState();
+        budgetByAgent.set(agentId, state);
+        const decision = state.nextCall();
+        if (decision.kind === 'deny') {
+            pendingFinalOnly.set(agentId, exec.agent);
+            return Promise.resolve(exhaustionResult(decision.reason));
+        }
+        if (decision.softSignal) softExecutions.set(exec.token, agentId);
+        if (decision.exhaustsBudget) pendingFinalOnly.set(agentId, exec.agent);
+        return next();
+    });
+    ctx.on('tools/post-execute', (exec, _result, next)=>{
+        if (!softExecutions.delete(exec.token)) return next();
+        return next().then((decision)=>({
+                ...decision,
+                additionalContexts: [
+                    ...decision.additionalContexts ?? [],
+                    convergenceContext('TOOL_BUDGET_SOFT', 'Tool call 16 reached. Converge now and produce the final answer from gathered evidence.')
+                ]
+            }));
+    });
+}
+
+
+//# sourceURL=ts/src/tool-budget.ts

package/dist/src/tool-packet.js

@@ -9,4 +9,4 @@ export function interpretArgs(args, stringKey) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/tool-packet.ts
+//# sourceURL=ts/src/tool-packet.ts

package/dist/src/travel-slots.js

@@ -141,4 +141,4 @@ export function scoreExtraction(expected, actual) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/travel-slots.ts
+//# sourceURL=ts/src/travel-slots.ts

package/dist/src/travel-timeline.js

@@ -75,4 +75,4 @@ export function timelineGapsForVerified(timeline, verifiedWishes) {
 export { ymd };
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/travel-timeline.ts
+//# sourceURL=ts/src/travel-timeline.ts

package/dist/src/unified.js

@@ -588,4 +588,4 @@ function renderCandidateMarkdown(req, verdicts, recommended) {
 export { minToHhmm };
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/unified.ts
+//# sourceURL=ts/src/unified.ts

package/dist/src/wish-pool.js

@@ -24,4 +24,4 @@ export function pickNudgeWish(pool, ctx) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/wish-pool.ts
+//# sourceURL=ts/src/wish-pool.ts

package/dist/src/z3-shared.js

@@ -15,4 +15,4 @@ export async function withZ3(label, session) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry-publish/ts/src/z3-shared.ts
+//# sourceURL=ts/src/z3-shared.ts

package/extension/README.md

@@ -11,16 +11,40 @@
 - ❌ 不向任何站点发起请求(检索请求由站点页面自己发出,扩展只听不写);
 - ❌ 不动你已打开的任何标签页(只创建/关闭自己的检索标签;登录标签留给你)。
 
-## 安装(每台浏览器一次,约 30 秒)
+## 安装(每台浏览器一次)
 
-1. 跑一次 `npx gotry setup`(或手动:把本目录整体拷到任意固定位置,建议 `~/.gotry/extension/`);
-2. Chrome 地址栏打开 `chrome://extensions`;
-3. 右上角开启「开发者模式」;
-4. 点「加载已解压的扩展程序」,选择本目录(manifest.json 所在目录)。
+### 方式一(推荐):Chrome 应用商店一键安装
+
+打开商店页点「添加至 Chrome」即可,零开发者模式、零手动加载,**自动更新**:
+
+**https://chromewebstore.google.com/detail/gotry-session-bridge/oeajpiccmonococjcegddlooeeohlbgd**
+
+商店版经 Google 审核上架(2026-09-02),版本跟随商店发版节奏。
+
+### 方式二:GitHub Releases 本地加载(免审核,版本更新更快)
+
+不经商店审核,版本化 tarball + SHA256 校验,与 npm 发版节奏解耦,更新比商店快:
+
+```bash
+npx gotry setup --extension-from=github   # 自动下载校验并落位 ~/.gotry/extension
+```
+
+(或手动:从 [github.com/Danceiny/gotry/releases](https://github.com/Danceiny/gotry/releases) 标签 `ext-*` 下载 `gotry-session-bridge.tar.gz` 解压到任意固定位置。)
+
+然后在 Chrome 地址栏打开 `chrome://extensions` → 右上角开启「开发者模式」→ 点「加载已解压的扩展程序」选择该目录。
+
+### 方式三:npm 包内副本本地加载(离线确定性)
+
+```bash
+npx gotry setup   # 把包内扩展落位到 ~/.gotry/extension
+```
+
+再按方式二的 `chrome://extensions` 三步加载该目录。
 
 装好即生效,无任何系统弹窗。卸载/随时可停:扩展卡片上的开关即是总闸(仍受 gotry 授权闸 `sessionAccess` 双重控制)。
 
 ## 自检
 
-- 扩展 ID 应为固定的 `olpgkofjhhiiiahdkkbcninhjmegghfe`(manifest 带 `key`,跨机器稳定)——若不一致,说明 manifest 被改动过,不要安装;
-- gotry 侧运行 `npx gotry` 后发起一次会话检索,扩展图标应出现(无需点击);桥状态可看 `curl http://127.0.0.1:8791/status`(仅本机回环)。
+- 商店版扩展 ID 固定为 `oeajpiccmonococjcegddlooeeohlbgd`(商店用自己的签名 key,与 unpacked 版 ID 不同,二者都是同一扩展,本机 gotry 桥双通道同信);
+- 本地加载(unpacked)版扩展 ID 应为固定的 `olpgkofjhhiiiahdkkbcninhjmegghfe`(manifest 带 `key`,跨机器稳定)——若不一致,说明 manifest 被改动过,不要加载;
+- gotry 侧运行 `npx gotry` 后发起一次会话检索,扩展图标应出现(无需点击);桥状态可看 `curl http://127.0.0.1:8791/status`(仅本机回环)。