Skip to main content

ChatBrowser

ChatBrowser 是 ChatArch 的浏览器运行态基础包。它不做平台账号语义,也不安装系统依赖;它只管理浏览器 backend 探测、profile 元数据、本机 loopback CDP endpoint 注册和 session endpoint 读取,供 ChatPost、Wechatsync 等上层发布工具复用。

文档入口:https://arch.gh.wzhecnu.cn/ChatBrowser/

边界

ChatUp       = setup / install / configure
ChatBrowser  = browser backend / profile metadata / session endpoint / CDP registry
Wechatsync   = platform adapter / auth check / draft write
ChatPost     = post/task orchestration / multi-platform publishing workflow

ChatBrowser 不读取、打印或迁移平台账号数据;profile 目录里的浏览器状态由浏览器自己维护。--label 只能保存非敏感标签键值,tokenpasswordcookieaccountapi_keyauthloginsession 等敏感 key 会被拒绝。

快速开始

pip install ChatBrowser
chatbrowser --help
chatbrowser doctor --output json
chatbrowser backend list --output json

注册一个已有浏览器 profile 目录:

chatbrowser profile create zhihu-test \
  --path /path/to/browser-profile \
  --backend chrome-for-testing \
  --output json

chatbrowser profile show zhihu-test --output json
chatbrowser profile path zhihu-test

接入一个已经运行的本机 loopback CDP endpoint(只接受不含 userinfo/path/query/fragment 的 http://127.0.0.1:<port> / http://localhost:<port> / IPv6 localhost),不接管也不关闭该浏览器:

chatbrowser connect \
  --cdp-url http://127.0.0.1:9229 \
  --as-session-name zhihu-test-existing \
  --profile zhihu-test \
  --output json

chatbrowser session endpoint zhihu-test-existing
chatbrowser disconnect zhihu-test-existing

当前 CLI

chatbrowser
├── doctor
├── backend
│   ├── list
│   ├── show <name>
│   └── resolve <name>
├── profile
│   ├── list
│   ├── create <name>
│   ├── show <name>
│   ├── path <name>
│   └── status <name>
├── connect
├── disconnect <session-id>
└── session
    ├── list
    ├── show <session-id>
    └── endpoint <session-id>

开发检查

pip install -e ".[dev,docs]"
python -m pytest -q
python -m build
mkdocs build --strict

新增命令时保持 CLI 是薄封装:核心逻辑先放进可 import Python API,再让 Click 命令调用它。

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chatbrowser-0.1.2.tar.gz (12.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chatbrowser-0.1.2-py3-none-any.whl (12.3 kB view details)

Uploaded Python 3

File details

Details for the file chatbrowser-0.1.2.tar.gz.

File metadata

  • Download URL: chatbrowser-0.1.2.tar.gz
  • Upload date:
  • Size: 12.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for chatbrowser-0.1.2.tar.gz
Algorithm Hash digest
SHA256 a2695d1febd01c54af5bd506d6e8c306ee8ff2830440e564f9764221fc6b2873
MD5 a32e3b35ffa7c4a7f7ea7fc17649bb7a
BLAKE2b-256 8e45b31b6718ef1e8b6fcaf938b9b3119ba548f6f9e4d025af3b88e1d1a09eb8

See more details on using hashes here.

Provenance

The following attestation bundles were made for chatbrowser-0.1.2.tar.gz:

Publisher: publish.yml on ChatArch/ChatBrowser

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file chatbrowser-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: chatbrowser-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 12.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for chatbrowser-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 0e15ea1e8bdbb3ad46faf5112c3aecc36f144b3d21111f816acf13d61594bd50
MD5 bee2f544a382515c4dd03151a271924d
BLAKE2b-256 12d273b18ba4204d4635eacade8b89e9619e9065651d982ee2dc375e9e254298

See more details on using hashes here.

Provenance

The following attestation bundles were made for chatbrowser-0.1.2-py3-none-any.whl:

Publisher: publish.yml on ChatArch/ChatBrowser

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page