bb-browser 0.4.2 → 0.4.3

package/dist/cli.js

@@ -2459,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");