ChatECNU

ChatECNU 是 ECNU 门户与校园网联网工具包。安装包名仍是 ChatECNU，日常命令主推 ecnu。

文档入口

任务	链接
安装和最小验证	https://arch.gh.wzhecnu.cn/ChatECNU/quickstart/
命令树	https://arch.gh.wzhecnu.cn/ChatECNU/cli-tree/
ChatEnv 变量	https://arch.gh.wzhecnu.cn/ChatECNU/chatenv/
ECNU 使用	https://arch.gh.wzhecnu.cn/ChatECNU/ecnu/

安装

pip install ChatECNU

如需验证码识别能力：

pip install "ChatECNU[captcha]"

命令结构

ChatECNU 的命令面可用 ecnu --tree 从当前 Click 注册表直接回读：

ecnu
├── --help  # Show this message and exit.
├── --version  # Show the installed ChatECNU version.
├── --tree  # Print this registered command tree and exit.
├── --env ENV-PROFILE  # ChatEnv 配置名。
├── home  # ECNU 门户。
│   ├── info [--json]  # 门户首页摘要。
│   ├── login [--username USERNAME] [--password PASSWORD] [--sms-code SMS-CODE] [--json] [--interactive]  # 登录门户。
│   ├── logout [--json]  # 退出门户会话。
│   ├── status [--json]  # 门户会话状态。
│   └── user [--json]  # 门户用户信息。
├── net  # 校园网联网。
│   ├── check [--auth-client AUTH-CLIENT-PATH] [--setting-file SETTING-FILE] [--json]  # 检查在线状态。
│   ├── ensure-login [--auth-client AUTH-CLIENT-PATH] [--setting-file SETTING-FILE] [--username USERNAME] [--password PASSWORD] [--allow-argv-password] [--json] [--interactive]  # 离线时登录。
│   ├── login [--auth-client AUTH-CLIENT-PATH] [--setting-file SETTING-FILE] [--username USERNAME] [--password PASSWORD] [--allow-argv-password] [--json] [--interactive]  # 登录。
│   └── logout [--auth-client AUTH-CLIENT-PATH] [--setting-file SETTING-FILE] [--username USERNAME] [--json] [--interactive]  # 退出校园网。
└── visitor  # 访客账号。
    ├── create [--remark REMARK] [--dry-run] [--json] [--interactive]  # 创建访客账号。
    ├── default [--password1 PASSWORD1] [--password2 PASSWORD2] [--remark REMARK] [--json] [--interactive]  # 维护默认访客账号。
    ├── delete [--id VISITOR-ID] [--dry-run] [--json] [--interactive]  # 删除访客账号。
    ├── get [--id VISITOR-ID] [--account ACCOUNT] [--json]  # 查询访客账号。
    ├── list [--json]  # 列出访客账号。
    └── update [--id VISITOR-ID] [--remark REMARK] [--password PASSWORD] [--dry-run] [--json] [--interactive]  # 更新访客备注和密码。

门户命令统一放在 home 下：

ecnu home login -i
ecnu home info
ecnu home status
ecnu home user
ecnu home logout

门户会话默认写入 ChatEnv runtime token-store：~/.chatarch/tokens/ECNU/<profile>.json；ecnu home status --json 只回读安全摘要，不输出原始 Cookie/CSRF。chatenv token refresh ECNU <profile> 可从同名 stable env profile 发起非交互 OCR 自动登录并由 ChatEnv 写入 runtime token-store；遇到短信验证码或验证码候选失败时会安全失败。

校园网联网统一放在 net 下：

ecnu net check --json
ecnu net login -I --allow-argv-password
ecnu net logout -I
ecnu net ensure-login -I --allow-argv-password

ChatECNU 的 PyPI wheel/sdist 内置 Linux x86_64 auth_client，默认 ecnu net ... 会优先使用该内置二进制；如需覆盖，可用 --auth-client 或 ECNU_AUTH_CLIENT 指定路径。账号密码使用同一组 ECNU_USERNAME / ECNU_PASSWORD。net check 会显示当前 online/account/username；net logout 未提供用户名时会先从 auth_client check 的 Username=... 自动提取。

敏感值（密码、Cookie、短信码、会话）不要打印或提交。

Download files

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

Source Distribution

chatecnu-0.2.5.tar.gz (5.3 MB 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.

chatecnu-0.2.5-py3-none-any.whl (5.3 MB view details)

Uploaded Aug 11, 2026 Python 3

File details

Details for the file chatecnu-0.2.5.tar.gz.

File metadata

Download URL: chatecnu-0.2.5.tar.gz
Upload date: Aug 11, 2026
Size: 5.3 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for chatecnu-0.2.5.tar.gz
Algorithm	Hash digest
SHA256	`f0722bc1eb87498b5a199b4c827031450b0d247b9b8b8ffd501a80150e3018db`
MD5	`4bae710eaac4c699e1b9ce14f91aeb83`
BLAKE2b-256	`11cfbc53946933a71dd8d20c1093ad04aa596c56e710620bb04686a4bdf5779d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for chatecnu-0.2.5.tar.gz:

Publisher: publish.yml on ChatArch/ChatECNU

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: chatecnu-0.2.5.tar.gz
- Subject digest: f0722bc1eb87498b5a199b4c827031450b0d247b9b8b8ffd501a80150e3018db
- Sigstore transparency entry: 2427127351
- Sigstore integration time: Aug 11, 2026
Source repository:
- Permalink: ChatArch/ChatECNU@a25bdb0704cbdcdd30600744909019692f0e8433
- Branch / Tag: refs/tags/v0.2.5
- Owner: https://github.com/ChatArch
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@a25bdb0704cbdcdd30600744909019692f0e8433
- Trigger Event: push