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 只能保存非敏感标签键值，token、password、cookie、account、api_key、auth、login、session 等敏感 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.4.tar.gz (14.5 kB view details)

Uploaded Aug 11, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

chatbrowser-0.1.4-py3-none-any.whl (13.2 kB view details)

Uploaded Aug 11, 2026 Python 3

File details

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

File metadata

Download URL: chatbrowser-0.1.4.tar.gz
Upload date: Aug 11, 2026
Size: 14.5 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.4.tar.gz
Algorithm	Hash digest
SHA256	`4ff645ba33747b4956d9ddb219d5fa2e0723ae3f5213c523ff94007b12051684`
MD5	`d0570b9d0cae4920503209c086353bf0`
BLAKE2b-256	`3789e284befad0ae91fdcb2dffa77e0a6173d1bbd16190788bc0021368ddb3c7`

See more details on using hashes here.

Provenance

The following attestation bundles were made for chatbrowser-0.1.4.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: chatbrowser-0.1.4.tar.gz
- Subject digest: 4ff645ba33747b4956d9ddb219d5fa2e0723ae3f5213c523ff94007b12051684
- Sigstore transparency entry: 2424836532
- Sigstore integration time: Aug 11, 2026
Source repository:
- Permalink: ChatArch/ChatBrowser@1d6bac9c061d91d5078f293be48332821ba3595f
- Branch / Tag: refs/tags/v0.1.4
- Owner: https://github.com/ChatArch
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@1d6bac9c061d91d5078f293be48332821ba3595f
- Trigger Event: push