Skip to content

DEVELOPMENT.md

Latest commit

 

History

History
375 lines (268 loc) · 6.64 KB

DEVELOPMENT.md

File metadata and controls

375 lines (268 loc) · 6.64 KB
Raw

bb-browser �砍撘����?

�� 敹恍��憪?

Windows �冽

# 1. 餈�霈曄蔭�
test-setup.bat

# 2. �臬 daemon
bb-browser daemon start

# 3. 敹恍��霂?
quick-test.bat

# 4. 摰瘚�
node test\test-api-fetch.js

Linux/macOS �冽

# 1. 餈�霈曄蔭�
chmod +x test-setup.sh quick-test.sh
./test-setup.sh

# 2. �臬 daemon
bb-browser daemon start

# 3. 敹恍��霂?
./quick-test.sh

# 4. 摰瘚�
node test/test-api-fetch.js

�� 霂衣�甇仿炊

1. �貉蝸�典��

憒�銋�摰�餈?bb-browser嚗��貉蝸嚗?

npm uninstall -g bb-browser

2. 摰�靘�

pnpm install

憒�瘝⊥� pnpm嚗�摰�嚗?

npm install -g pnpm

3. �遣憿寧

pnpm build

餈��遣���?packages嚗?

  • @bb-browser/shared - �曹澈蝐餃���霈?
  • @bb-browser/daemon - Daemon �
  • @bb-browser/cli - CLI �賭誘
  • @bb-browser/mcp - MCP ��?

4. �暹�啣撅�

npm link

餈��遣銝�銝芸撅�蝚血�暹嚗�����啣����研�?

5. 撉�摰�

bb-browser --version

摨砲�曄內敶���瘀�憒?0.11.5嚗�?

�妒 瘚��啣��?

�臬 daemon

bb-browser daemon start

Daemon 隡�餈�嚗��?http://localhost:6666�?

瘚� /api/fetch 蝡舐

雿輻 cURL

curl -X POST http://localhost:6666/api/fetch \
  -H "Content-Type: application/json" \
  -d '{"url": "https://api.github.com/users/octocat"}'

雿輻 Node.js 瘚��

node test/test-api-fetch.js

雿輻 Python 瘚��

python test/test-api-fetch.py

餈�蝷箔�隞��

node examples/fetch-api-example.js

�� 撘���蝔?

靽格隞���?

  1. ��遣嚗?

    pnpm build

  2. � daemon嚗��耨�嫣� daemon 隞��嚗�

    bb-browser daemon shutdown
bb-browser daemon start

�芣�撱箇摰?package

# �芣�撱?daemon
cd packages/daemon
pnpm build

# �芣�撱?shared
cd packages/shared
pnpm build

�璅∪�嚗���刻�嚗?

# �?package �桀�銝?
pnpm build --watch

�� 憿寧蝏�

bb-browser/
���� packages/
�?  ���� shared/          # �曹澈蝐餃���霈?
�?  �?  ���� src/
�?  �?      ���� protocol.ts    # �?瘛餃�鈭?fetch action
�?  ���� daemon/          # Daemon �
�?  �?  ���� src/
�?  �?      ���� command-dispatch.ts  # �?瘛餃�鈭?fetch �賭誘憭�
�?  �?      ���� http-server.ts       # �?瘛餃�鈭?/api/fetch 頝舐
�?  ���� cli/             # CLI �賭誘
�?  ���� mcp/             # MCP ��?
���� docs/                # �﹝
�?  ���� api-fetch.md              # �?API �﹝嚗��
�?  ���� api-fetch.zh-CN.md        # �?API �﹝嚗葉��
�?  ���� api-fetch-implementation.md  # �?摰霂湔�
���� test/                # 瘚��
�?  ���� test-api-fetch.js         # �?Node.js 瘚�
�?  ���� test-api-fetch.py         # �?Python 瘚�
�?  ���� README.md                 # �?瘚�霂湔�
���� examples/            # 蝷箔�隞��
�?  ���� fetch-api-example.js      # �?雿輻蝷箔�
���� test-setup.sh        # �?霈曄蔭�嚗inux/macOS嚗?
���� test-setup.bat       # �?霈曄蔭�嚗indows嚗?
���� quick-test.sh        # �?敹恍��霂�Linux/macOS嚗?
���� quick-test.bat       # �?敹恍��霂�Windows嚗?
���� FETCH_API_SUMMARY.md # �?��餌�

�?= �祆活�啣��耨�寧��辣

�� ���

�桅� 1: bb-browser: command not found

��: npm link 瘝⊥���

閫��寞�:

npm link
# ��蝙�函�撖寡楝敺?
npm link /path/to/bb-browser

�桅� 2: Daemon �臬憭梯揖

��: Chrome �芾�銵�蝡臬鋡怠��?

閫��寞�:

# 璉��?Chrome �臬餈�
# 璉��亦垢���西◤�
netstat -ano | findstr :9222  # Windows
lsof -i :9222                 # Linux/macOS

# 雿輻銝�蝡臬
bb-browser daemon start --port 19824

�桅� 3: �遣憭梯揖

��: 靘��芸�鋆��銝�?

閫��寞�:

# 皜�撟園��啣�鋆?
rm -rf node_modules pnpm-lock.yaml
pnpm install
pnpm build

�桅� 4: 瘚�憭梯揖

��: Daemon �芾�銵�蝵��桅�

閫��寞�:

# 璉��?daemon �嗆�?
curl http://localhost:6666/status

# �亦� daemon �亙�
bb-browser daemon start  # �餈��亦��亙�

�� �扯��

�亦� daemon �嗆�?

curl http://localhost:6666/status | jq

餈�嚗?

{
  "running": true,
  "cdpConnected": true,
  "uptime": 123,
  "currentSeq": 456,
  "tabs": [...]
}

�蝵�霂瑟�

bb-browser network --with-body

�亦��批�唳敹?

bb-browser console

� 靚���撌?

1. 雿輻 Chrome DevTools

�� Chrome嚗挪�?chrome://inspect嚗隞亦��唳��?CDP 餈�?

2. �亦� daemon �亙�

# �餈� daemon
bb-browser daemon start

# ���敹�隞塚�憒���
tail -f ~/.bb-browser/daemon.log

3. 雿輻 VS Code 靚�

�?.vscode/launch.json 銝剜溶��

{
  "type": "node",
  "request": "launch",
  "name": "Debug Daemon",
  "program": "${workspaceFolder}/packages/daemon/src/index.ts",
  "preLaunchTask": "npm: build",
  "outFiles": ["${workspaceFolder}/dist/**/*.js"]
}

�� �漱隞��

1. 餈�瘚�

pnpm test

2. 璉��乩誨���?

pnpm lint

3. �漱

git add .
git commit -m "feat(daemon): 瘛餃� /api/fetch HTTP 頝舐"

�� ��瘚�

1. �湔�

npm version patch  # 0.11.5 -> 0.11.6
npm version minor  # 0.11.5 -> 0.12.0
npm version major  # 0.11.5 -> 1.0.0

2. �遣

pnpm build

3. ��

npm publish

�� �詨韏�

� 撘��遣霈?

  1. 雿輻 TypeScript: ���隞���賢�霂乩蝙�?TypeScript
  2. �萄儐�唳�璅∪�: ���誨��憌���?
  3. 瘛餃�瘚�: 銝箸�瘛餃�瘚��其�
  4. �湔�﹝: 靽格隞����啁�單�獢?
  5. 撠郊�漱: 瘥葵��孵��祆�鈭?

�� 摮虫�韏�

蟡���敹恬� ��