pansh 是一个面向 AnyShare / 网盘的命令行工具，支持交互式 shell 和单行命令两种使用方式，提供登录、目录浏览、查找、上传、下载等稳定能力。
已明确兼容并优先测试：
- Python 3.10
- Python 3.11
- Python 3.12
- Python 3.13
推荐优先使用 Python 3.11 或 3.12。更老版本未支持；更新版本如果没有在 release note 中说明，视为“未专门验证”。
PyPI 安装：
pip install pansh更推荐用 pipx 隔离安装，能减少和现有科研/工程环境的依赖冲突：
pipx install pansh安装后可验证：
pansh --help
python -m pansh --help
pansh --version开发安装：
pip install -e .进入交互式 shell：
pansh或显式进入 shell：
pansh shell单行命令示例：
pansh ls .
pansh find 报告 --path .
pansh upload README.md .
pansh download /home/file.pdf ./downloadspansh 把非敏感连接配置与认证状态分开，并支持两种 session mode：
personal 环境默认使用 persistent。登录成功后只更新当前 profile 的用户名、加密凭据和 token，后续进程可以复用：
pansh login
pansh --profile kaiwei
pansh login --profile kaiweiephemeral 不读取、写入或清除任何磁盘认证状态；账号、加密密码和 token 只存在当前 Python 进程。它仍可读取指定 profile 的 host、pubkey、verify_tls 等非敏感连接配置：
pansh --ephemeral
pansh --ephemeral ls .
pansh --profile work1 --ephemeral共享服务器推荐显式启用 shared 环境：
PANSH_SHARED=1 pansh说明：
PANSH_SHARED=1、--shared或 settings 中的 shared 环境默认选择 ephemeral，避免静默复用磁盘账号。--once和--no-store-login是--ephemeral的兼容别名。- 交互式 TTY 中，
pansh login --no-store会提示后直接进入同一进程的 ephemeral shell；退出后 session 自然销毁。 - 非交互环境中的
login --no-store会返回非零退出码，请改用pansh --ephemeral <command>。 - ephemeral shell 中多个命令复用同一个 manager；
exit、quit、EOF 或logout后关闭。 - ephemeral 的
logout只清理内存，不会清除任何 persistent profile。 - 如果当前是 persistent 会话，
logout会清除本地保存的凭据和 token。
pansh profiles list
pansh profiles create work1
pansh profiles path work1
pansh profiles delete work1profile 名只允许字母、数字、.、_ 和 -，不能使用路径。profile 用于避免误覆盖和复用其他 profile 的认证状态，但不是操作系统安全边界：共享同一个 Linux UID 的用户仍可读取该 UID 有权访问的文件。多人共用同一 UID 时应使用 ephemeral；如果需要真正隔离，请使用不同系统账号或容器权限边界。
pansh whoami
pansh ls .
pansh tree . --depth 2
pansh stat /home/file.pdf
pansh find 报告 --path /home/docspansh upload a.txt b.txt .
pansh upload --glob "*.pdf" .
pansh upload --regex ".*\\.(pdf|docx)$" ./docs . --recursive规则说明：
upload不写远端目标时，默认使用当前远端工作目录。- 多文件上传时，最后一个参数只有在明显是远端目标时才会被当作目标目录。
pansh download /home/a.pdf
pansh download /home/a.pdf /home/b.pdf
pansh download --glob "*.zip" .
pansh download --regex ".*2026.*\\.pdf$" /home/docs ./downloads --recursive规则说明：
download不写本地目标时，默认使用当前本地工作目录。--glob适合*.pdf这类通配符。--regex适合更复杂的正则匹配。
pansh ls . --json
pansh stat /home/file.pdf --json
pansh find 报告 --json诊断安装来源、运行环境和当前会话配置（不会输出 token、密码或加密凭据）：
pansh doctor
pansh doctor --json进入后可使用：
helpclearlogoutpwd,cdlpwd,lcd,lls!<command>- 以及稳定 CLI 命令：
whoami、ls、tree、stat、find、mkdir、touch、rm、mv、cp、cat、upload、download
在 shell 内查看某个命令参数：
help upload
find --help
download -h补充说明：
- shell 启动时会自动登录
logout会注销当前会话并退出 shellexit/quit只退出 shell，不清理已保存的登录信息
默认配置采用用户目录，不依赖仓库根目录。
典型路径：
- Linux 配置：
~/.config/pansh/；认证状态：~/.local/state/pansh/ - macOS：
~/Library/Application Support/pansh/对应的配置/状态目录 - Windows：
%APPDATA%\\pansh\\对应的配置/状态目录
主要文件（实际根目录由 platformdirs 按平台解析）：
settings.yamlprofiles/<profile>/profile.yaml：非敏感连接配置- 状态目录中的
profiles/<profile>/auth.json：当前 profile 的认证状态
profile.yaml 可按需填写：
host: bhpan.buaa.edu.cn
verify_tls: true
store_password: true可通过环境变量覆盖：
PANSH_CONFIG=/path/to/settings.yaml
PANSH_AUTH_DIR=/private/state/directory补充说明：
- 首次运行会自动生成默认
settings.yaml PANSH_PROFILE选择 profile；PANSH_SESSION_MODE=ephemeral|persistent选择模式；PANSH_SHARED=1开启 shared 默认值- 优先级为命令行 > 环境变量 >
settings.yaml> 内置默认值 - 旧
~/.config/pansh/auth.json（以及更早的bhpan/config.json）只会在首次使用 persistentdefaultprofile 且新认证文件不存在时迁移；迁移前生成.bak备份，成功验证后删除旧文件 - ephemeral 和非 default profile 都不会触发旧认证文件迁移
PANSH_CONFIG及旧的pansh_CONFIG仍可用于覆盖 settings 路径
当前正式对外支持并在帮助中显示的命令以“稳定可用”为优先。以下内部实现暂不作为公开能力展示：
- quota
- link
- revisions
- restore-revision
这些能力即使在代码中保留了内部实现，也不属于当前 README 承诺范围。
pip install .
python -m pansh --help
pansh --help
pansh login --no-store
pansh upload README.md .
pansh download /home/file.pdfpansh 目前默认按北航的 AnyShare 配置工作。如果你所在学校也在使用爱数 AnyShare / 爱数云盘，通常也可以复用这套 CLI，但可能需要自行适配 host、登录入口或认证细节。
我目前确认到的公开案例包括：
- 中山大学：https://pan.sysu.edu.cn/
- 天津大学：https://pan.tju.edu.cn/
- 北京大学：https://disk.pku.edu.cn/
- 中国人民大学：https://pan.ruc.edu.cn/
如果你来自其他学校并完成了适配，欢迎提 PR 合并配置���明或兼容补丁。