bb-browser 0.4.1 → 0.4.3

package/dist/cli.js

@@ -31,7 +31,14 @@ async function sendCommand(request) {
         return {
           id: request.id,
           success: false,
-          error: "\u6269\u5C55\u672A\u8FDE\u63A5"
+          error: [
+            "Chrome extension not connected.",
+            "",
+            "1. Download extension: https://github.com/epiral/bb-browser/releases/latest",
+            "2. Unzip the downloaded file",
+            "3. Open chrome://extensions/ \u2192 Enable Developer Mode",
+            '4. Click "Load unpacked" \u2192 select the unzipped folder'
+          ].join("\n")
         };
       }
       return {
@@ -52,7 +59,15 @@ async function sendCommand(request) {
         };
       }
       if (error.message.includes("fetch failed") || error.message.includes("ECONNREFUSED")) {
-        throw new Error("\u65E0\u6CD5\u8FDE\u63A5\u5230 Daemon\uFF0C\u8BF7\u786E\u4FDD Daemon \u6B63\u5728\u8FD0\u884C");
+        throw new Error([
+          "Cannot connect to daemon.",
+          "",
+          "Start the daemon first:",
+          "  bb-browser daemon",
+          "",
+          "Then load the Chrome extension:",
+          "  chrome://extensions/ \u2192 Developer Mode \u2192 Load unpacked \u2192 node_modules/bb-browser/extension/"
+        ].join("\n"));
       }
       throw error;
     }
@@ -1845,9 +1860,13 @@ async function siteRun(name, args, options) {
   const evalReq = { id: generateId(), action: "eval", script, tabId: targetTabId };
   const evalResp = await sendCommand(evalReq);
   if (!evalResp.success) {
-    console.error(`[error] site ${name}: eval failed.`);
-    console.error(`  ${evalResp.error}`);
-    console.error(`  Check: is ${site.domain} open and logged in?`);
+    const hint = site.domain ? `Open https://${site.domain} in your browser, make sure you are logged in, then retry.` : void 0;
+    if (options.json) {
+      console.log(JSON.stringify({ id: evalReq.id, success: false, error: evalResp.error || "eval failed", hint }));
+    } else {
+      console.error(`[error] site ${name}: ${evalResp.error || "eval failed"}`);
+      if (hint) console.error(`  Hint: ${hint}`);
+    }
     process.exit(1);
   }
   const result = evalResp.data?.result;
@@ -1867,11 +1886,18 @@ async function siteRun(name, args, options) {
   }
   if (typeof parsed === "object" && parsed !== null && "error" in parsed) {
     const errObj = parsed;
+    const checkText = `${errObj.error} ${errObj.hint || ""}`;
+    const isAuthError = /401|403|unauthorized|forbidden|not.?logged|login.?required|sign.?in|auth/i.test(checkText);
+    const loginHint = isAuthError && site.domain ? `Please log in to https://${site.domain} in your browser first, then retry.` : void 0;
+    const hint = loginHint || errObj.hint;
+    const reportHint = `If this is an adapter bug, report via: gh issue create --repo epiral/bb-sites --title "[${name}] <description>" OR: bb-browser site github/issue-create epiral/bb-sites --title "[${name}] <description>"`;
     if (options.json) {
-      console.log(JSON.stringify({ id: evalReq.id, success: false, error: errObj.error, hint: errObj.hint }));
+      console.log(JSON.stringify({ id: evalReq.id, success: false, error: errObj.error, hint, reportHint }));
     } else {
       console.error(`[error] site ${name}: ${errObj.error}`);
-      if (errObj.hint) console.error(`  Hint: ${errObj.hint}`);
+      if (hint) console.error(`  Hint: ${hint}`);
+      console.error(`  Report: gh issue create --repo epiral/bb-sites --title "[${name}] ..."`);
+      console.error(`     or: bb-browser site github/issue-create epiral/bb-sites --title "[${name}] ..."`);
     }
     process.exit(1);
   }
@@ -1902,7 +1928,12 @@ async function siteCommand(args, options = {}) {
   bb-browser site list
   bb-browser site reddit/thread https://www.reddit.com/r/LocalLLaMA/comments/...
   bb-browser site twitter/user yan5xu
-  bb-browser site search reddit`);
+  bb-browser site search reddit
+
+Adapter \u7ED3\u679C\u4E0D\u7B26\u5408\u9884\u671F\uFF1F\u62A5\u544A\u95EE\u9898\uFF1A
+  gh issue create --repo epiral/bb-sites --title "[adapter-name] \u63CF\u8FF0"
+  \u6216: https://github.com/epiral/bb-sites/issues
+\u8D21\u732E\u65B0 adapter: https://github.com/epiral/bb-sites`);
     return;
   }
   switch (subCommand) {
@@ -2428,6 +2459,66 @@ async function main() {
         await siteCommand(parsed.args, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
+      case "guide": {
+        console.log(`How to turn any website into a bb-browser site adapter
+=======================================================
+
+1. REVERSE ENGINEER the API
+   bb-browser network clear --tab <tabId>
+   bb-browser refresh --tab <tabId>
+   bb-browser network requests --filter "api" --with-body --json --tab <tabId>
+
+2. TEST if direct fetch works (Tier 1)
+   bb-browser eval "fetch('/api/endpoint',{credentials:'include'}).then(r=>r.json())" --tab <tabId>
+
+   If it works \u2192 Tier 1 (Cookie auth, like Reddit/GitHub/Zhihu/Bilibili)
+   If needs extra headers \u2192 Tier 2 (like Twitter: Bearer + CSRF token)
+   If needs request signing \u2192 Tier 3 (like Xiaohongshu: Pinia store actions)
+
+3. WRITE the adapter (one JS file per operation)
+
+   /* @meta
+   {
+     "name": "platform/command",
+     "description": "What it does",
+     "domain": "www.example.com",
+     "args": { "query": {"required": true, "description": "Search query"} },
+     "readOnly": true,
+     "example": "bb-browser site platform/command value"
+   }
+   */
+   async function(args) {
+     if (!args.query) return {error: 'Missing argument: query'};
+     const resp = await fetch('/api/search?q=' + encodeURIComponent(args.query), {credentials: 'include'});
+     if (!resp.ok) return {error: 'HTTP ' + resp.status, hint: 'Not logged in?'};
+     return await resp.json();
+   }
+
+4. TEST it
+   Save to ~/.bb-browser/sites/platform/command.js (private, takes priority)
+   bb-browser site platform/command "test query" --json
+
+5. CONTRIBUTE
+   Option A (with gh CLI):
+     git clone https://github.com/epiral/bb-sites && cd bb-sites
+     git checkout -b feat-platform
+     # add adapter files
+     git push -u origin feat-platform
+     gh pr create --repo epiral/bb-sites
+
+   Option B (without gh CLI, using bb-browser itself):
+     bb-browser site github/fork epiral/bb-sites
+     git clone https://github.com/YOUR_USER/bb-sites && cd bb-sites
+     git checkout -b feat-platform
+     # add adapter files
+     git push -u origin feat-platform
+     bb-browser site github/pr-create epiral/bb-sites --title "feat(platform): add adapters" --head "YOUR_USER:feat-platform"
+
+Private adapters:  ~/.bb-browser/sites/<platform>/<command>.js
+Community:         ~/.bb-browser/bb-sites/ (via bb-browser site update)
+Full guide:        https://github.com/epiral/bb-sites/blob/main/SKILL.md`);
+        break;
+      }
       default: {
         console.error(`\u9519\u8BEF\uFF1A\u672A\u77E5\u547D\u4EE4 "${parsed.command}"`);
         console.error("\u8FD0\u884C bb-browser --help \u67E5\u770B\u53EF\u7528\u547D\u4EE4");