AnyShare-Unofficial

AiShu AnyShare Cloud Drive Unofficial API Client Library
爱数 AnyShare 云盘非官方 API 库

简介 _Intro

此项目是爱数 Anyshare 云盘的非官方 Python API 库，支持对 Anyshare v7.0（2025 年构建版）云盘服务进行 API 操作。

PyPI 项目主页：https://pypi.org/project/AnyShare-Unofficial

PyPI 上发布的最新版本：

实现的功能

• AnonymousClient：匿名分享链接访问，支持的功能包括：

  • 浏览分享链接中的文件和文件夹；
  • 下载和上传文件（如果该分享链接开启了对应权限）。

• AuthenticatedClient：基于已登录用户的会话 Cookie 认证访问，支持的功能包括：

  • 获取用户信息和存储配额；
  • 浏览文档库和文件夹的内容；
  • 上传、下载、删除、移动和重命名文件；
  • 联系人和部门信息查询；
  • 共享管理查询。

使用方法 _Usage

安装

需要 Python 3.9 或更高版本。

需要安装 httpx>=0.28.1和 pydantic>=2.13.4 库。

随后通过下面的命令安装本库：

pip install anyshare-unofficial
# 或
poetry add anyshare-unofficial

示例：匿名访问云盘

借助 AnonymousClient 能力，无需登录，只要获得了分享链接即可浏览、下载文件。如果分享链接开放了上传权限，也可上传文件。

from anyshare_unofficial import AnonymousClient, OnDup

# 创建匿名客户端实例
client = AnonymousClient(
    "https://example.com/link/ABC123...",  # 这里填分享链接
    base_url="https://example.com",  # 这里填云盘主URL
)

# 列出分享链接中的条目
entries = client.list_entries()
# 更常用的做法
entry = client.get_first_entry()

# 递归浏览文件夹
contents = client.browse_folder(entry.id)
for f in contents.files:
    print(f"{f.name} ({f.size / 1024:.1f} KB)")

# 下载文件
file = contents.files[0]
auth, result = client.get_download_url(contents.files[0])
print(f"name={result.name}, link={auth.url}")
# 更简单的做法
client.download_file(file, "/local/path/")

# 覆盖上传（需要分享链接开放上传权限）
client.upload_file("/local/file.pdf", entry.id, ondup=OnDup.OVERWRITE)

示例：认证访问云盘

借助 AuthenticatedClient 能力，传入已获取的会话 Cookie 字符串，即可使用全部的 API。

from anyshare_unofficial import AuthenticatedClient, OnDup

# 创建认证客户端实例
client = AuthenticatedClient(
    "Authorization=xxx; JSESSIONID=xxx; ...",  # 这里填 Cookie
    base_url="https://example.com",
)

# 获取用户信息和配额
user = client.get_current_user()
print(f"User: {user.name} ({user.account})")
quota = client.get_quota()
print(f"Quota: {quota.used / 1024 ** 3:.1f}/{quota.allocated / 1024 ** 3:.1f}GB")

# 浏览文档库
doc_libs = client.list_doc_libs()
for lib in doc_libs:
    print(f"Doc lib: {lib.name} ({lib.type})")

# 浏览文件夹
content = client.browse_folder(doc_libs[0].id)
for d in content.dirs:
    print(f"Dir: {d.name}")
for f in content.files:
    print(f"File: {f.name} ({f.size / 1024:.1f} KB)")

# 删除和移动文件
# GNS 路径可以通过 file.id 获取
client.delete_file("gns://xxx/file")
client.move_file("gns://xxx/file", "gns://xxx/dest", ondup=OnDup.OVERWRITE)

# 创建目录
client.create_directory("gns://xxx/parent", "NewFolder", ondup=OnDup.RENAME)

# 下载文件
auth, result = client.get_download_url("gns://xxx/file", savename="file.pdf")
# 或者更简单的做法
client.download_file("gns://xxx/file", "/downloads/", savename="file.pdf")

# 联系人与部门
groups = client.get_contact_groups()
depts = client.get_department_roots()

# 共享管理
shares = client.list_shares_with_anyone()

# 关闭连接
client.close()

API 概览 _{API Overview}

1. 基类（BaseClient）

客户端均继承自此基类，提供 HTTP 会话管理和错误处理。

2. 匿名客户端（AnonymousClient）

3. 认证客户端（AuthenticatedClient）

用户

注意：get_user_basic_info() 的 directdepinfos 可能只包含部门路径 deppath，不同于 get_current_user() 返回的标准部门对象。

文档库

文件浏览

文件操作

目录操作

上传

权限

联系人

共享管理

其他

5. 枚举类型

6. 异常类型

7. 路径解析

AnyShare 使用 gns:// 格式的内部路径标识对象。格式为：

gns://{doc_lib_id}/{folder_id}/.../{file_or_folder_id}

库提供 anyshare_unofficial.utils.gns 模块中的辅助函数：

• is_gns_path(path) — 验证 GNS 路径
• parse_gns_path(path) — 拆分为段列表
• build_gns_path(*segments) — 从段构建
• quote_gns_path(path) — URL 编码

许可证 _Licensing

本项目基于 MIT 开源许可证，详情参见 LICENSE 页面。