Skip to content

AGENTS.md

Latest commit

 

History

History
153 lines (111 loc) · 5.85 KB

AGENTS.md

File metadata and controls

153 lines (111 loc) · 5.85 KB
Raw

bb-browser Agent 撘����?

�嗆�

CLI (packages/cli) ����HTTP�����?Daemon (packages/daemon) ����CDP WebSocket�����?Chrome
MCP (packages/mcp) ����HTTP�����?      �?
                              ���������氯��������?
                              �? HTTP   �?
                              �?Server  �?
                              ���������砂��������?
                                   �?
                         �������������������潑������������������?
                         �?        �?        �?
                    CdpConnection  �? CommandDispatch
                    (WebSocket)    �? (request �?handler)
                                   �?
                            TabStateManager
                            (�?ID, seq 摨,
                             per-tab 鈭辣蝻)

*Daemon 蝏辣嚗?

  • CdpConnection �?蝏湔��?Chrome DevTools Protocol �?WebSocket �輯��乓��典��?Chrome嚗恣�?session 憭嚗�銝?tab 銝�銝?session嚗�?
  • TabStateManager �?蝞∠� per-tab �嗆���� ID嚗argetId �?4+ 雿?hex嚗�霂銝�嚗�輕�文撅����� seq 霈⊥�具��銝?tab ���臬耦蝻鈭辣��嚗etwork/console/errors嚗�?
  • CommandDispatch �?撠?Request.action ���啣���啜������交 CdpConnection �圾���?TabState嚗��蒂 tab嚗 ID嚗� seq �?Response�?

*�詨�璁艙嚗?

  • �?tab ID �?�?CDP targetId �怠偏嚗�撠?4 摮泵嚗１��芸�拙����窈瘙?��銝剔�?ID �� tab�?
  • *seq 霈⊥�? �?�典������湔嚗�甈⊥�雿�瘥葵�鈭辣�賡����?since 餈誘���霂Ｕ�?
  • Per-tab 鈭辣蝻 �?�臬耦蝻嚗etwork: 500 �? console: 200 �? errors: 100 �∴�嚗蒂 seq �倌��� since�filter�method�status�limit �亥砭�?

�曹澈蝐餃�摰�嚗packages/shared/src/protocol.ts`

瘛餃��啣隞?

3 銝芣�隞塚�

  1. packages/shared/src/protocol.ts �?瘛餃� ActionType + Request 摮挾 + ResponseData 摮挾
  2. packages/daemon/src/command-dispatch.ts �?�?dispatchRequest 銝剜溶�����?
  3. packages/cli/src/commands/<name>.ts + packages/cli/src/index.ts �?CLI �賭誘 + 頝舐

�舫��packages/mcp/src/index.ts �?憒���閬�脖蛹 MCP tool

霈曇恣銝��?

�嫣誨��敹粉���遙雿��⊿�?bug�?

  • INV-1: ����雿�摨�憿餃��?tab嚗 ID嚗� seq嚗��瘀�
  • INV-2: 閫�蝐餃�摨�network/console/errors嚗�憿餃��?cursor
  • INV-3: �� tab ID 敹◆�仿�嚗��捂�� fallback
  • INV-4: seq �典�����嚗��臬���
  • INV-5: per-tab 鈭辣�氖 �?tab A ��隞嗡�隡�啣 tab B �霂Ｖ葉
  • INV-6: tab �喲�園��曄 ID嚗��支�隞嗥��?
  • INV-7: tab_new �券 tab �嗡��臬極雿��?ensurePageTarget 銋�憭�嚗?

UX 閫�嚗gent �犖蝐餃��冽嚗?

bb-browser �舅蝐餌�瘀�鈭箇掩嚗�亦 CLI嚗� AI Agent嚗�� bash/MCP 靚嚗�gent �舀‘璇?�?霂餃� bb-browser 颲撟嗥蕃霂�鈭箇掩��銝芣��祈”�ａ閬��嗆��∩舅��?

site list �膩

�砍�嚗{�其�} ({English keywords}: {�詨�餈�摮挾})`

# 撌?�?Agent ���遙�∪�?
�瑕��芰��∠巨摰銵�

# 憟?�?�祗�舀�蝝ｇ��曄內餈��捆
�∠巨摰銵� (stock quote: price, change%, market cap)

site info <name>

Agent ��啁倌���脣��?@meta嚗?

  • args �?required/optional ��餈?
  • example �怠�扯��隞?
  • readOnly�domain`

JSON 摮挾�賢�

摮挾�停�?Agent �犖蝐餉圾��桃�霂��?

閫� 撌? 憟?
摰�望��� chgPct changePercent
�澆蒂�� 155 "1.55%"
憭扳�航粉 177320000000 "1.77銝瑪"
憪�� URL (蝻箏仃) "url": "https://..."
ISO �園�? 1710000000 "2026-03-15T01:40:31.000Z"

�秤蝏�

瘥葵�秤敹◆��銝芸�畾蛛�

{
  "error": "HTTP 401",
  "hint": "��閬��餃��芰�嚗窈�瘚��其葉�� xueqiu.com 撟嗥敶?,
  "action": "bb-browser open https://xueqiu.com"
}
  • error �?���臬���Agent �斗�臬�航�其耨憭�
  • hint �?鈭箇掩�航粉閫��嚗gent ���芸靽桀��嗅��瑁蓮颲橘�
  • action �?�舀銵�靽桀��賭誘嚗銝箇征嚗gent 隡�撠��扯�嚗?

�賭誘��蝷?

瘥葵��嗡�銝�甇亦��賭誘颲摨��思�銵�蝷綽�

# site update 銋�嚗?
� 餈� bb-browser site recommend ���芯�����閫��臬�?

--help ��

��瑟��曉�蝏��������

  1. *撘�憪蝙�? �?site recommend, site list, site info, site, guide
  2. *瘚��冽�雿? �?open, snapshot, click, fill, type, press, scroll
  3. 憿菟靽⊥ �?get, screenshot, eval, fetch
  4. *�倌憿? �?tab
  5. 靚� �?network, console, errors, trace, history

site recommend

鈭箇掩�?Agent ��閬�典隞歹�

  • 鈭文�撘 history domains �?site list
  • �曄內 "available"嚗蝷箔��賭誘嚗� "not_available"嚗霈輸甈⊥嚗?
  • JSON 颲蝏����� Agent �賢�撘紡

隞��閫�

  • Commit message嚗(): `嚗�?
  • 蝐餃�嚗fix/feat/refactor/chore/docs`
  • �冽�Ｘ��祉銝剜�嚗誨�?瘜券��刻�?
  • �萄儐�唳�璅∪�嚗溶� CLI �賭誘��霂?trace.ts
  • �遣嚗隞��寧敶銵?pnpm build
  • site adapter 銝�閬�瘚�

瘚�

  • pnpm test �?餈�����霂��� turbo 蝻�嚗?
  • pnpm build �?蝐餃�摰璉��伐��漱��憿餉�銵�
  • pnpm lint �?隞��憌嚗aemon, mcp, shared嚗?

瘚���嚗?

  • ��瘚� �?�唳蝏�嚗ingBuffer�abState� ID ��嚗?
  • 憟漲瘚� �?�悅銝��湔�扼�挽霈∩���撉�