bb-browser 0.4.2 → 0.4.4

package/dist/cli.js

@@ -1930,10 +1930,9 @@ async function siteCommand(args, options = {}) {
   bb-browser site twitter/user yan5xu
   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`);
+\u521B\u5EFA\u65B0 adapter: bb-browser guide
+\u62A5\u544A\u95EE\u9898: gh issue create --repo epiral/bb-sites --title "[adapter-name] \u63CF\u8FF0"
+\u8D21\u732E\u793E\u533A: https://github.com/epiral/bb-sites`);
     return;
   }
   switch (subCommand) {
@@ -2035,6 +2034,7 @@ bb-browser - AI Agent \u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u5DE5\u5177
   site search <q>   \u641C\u7D22 adapter
   site <name>       \u8FD0\u884C adapter\uFF08\u5982 site reddit/thread <url>\uFF09
   site update       \u66F4\u65B0\u793E\u533A adapter \u5E93
+  guide             \u5982\u4F55\u628A\u4EFB\u4F55\u7F51\u7AD9\u53D8\u6210 site adapter\uFF08\u5F00\u53D1\u6307\u5357\uFF09
 
 \u9009\u9879\uFF1A
   --json          \u4EE5 JSON \u683C\u5F0F\u8F93\u51FA
@@ -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");