dave-yxw commented 3 years ago

现在很多人都选择在百度网盘内建群或加好友来分享文件了，这样的好处是增加了资源被传播的难度，不能像分享链接一样只要分享出一串链接文本就可以了。

我通过chrome开发者工具对群和好友分享文件的操作request请求，我对网络编程不熟，您看一下能否把这一块加到项目中。

群、好友分享的数据结构

uk: 每个用户对应的user_id
gid: 一个群组会话id
from_uk, to_uk: 一个分享文件是由谁分享的，分享给谁。如果在群组中，文件是共享给群组成员的，没有to_uk
msg_id: 会话中的一次分享，绑定一个from_uk. 如果是好友间的会话，一个msg_id还有一个to_uk. 一个msg_id下可能有多个分享文件/文件夹
fs_id: 对应一个文件或文件夹

群组接口

列出群组列表

py: list_groups() -> List[PcsGroup]
web request:
- type: get
- url: https://pan.baidu.com/mbox/group/list?start=0&limit=20&type=1&t=1634355729443&bdstoken=6c21411b9b16244472b094f15304ca72&channel=chunlei&web=1&app_id=250528&logid=MTYzNDM1NTcyOTQ0NDAuMjQwMDAxMzY5MzA0ODQxNzM=&clienttype=0
- simple url: https://pan.baidu.com/mbox/group/list?start=0&limit=20
- 返回内容： count字段指示一共有多少个会话session
```
{
errno: 0,
request_id: 8996736399603225000,
records: [{
        gid: "461057192968828484",
        name: "星辰学院VIP资源A18群",
        type: "1",
        uname: "小田***88",
        uk: 29515193,
        ...
    },
    {...},
    {...},
    {...},
    {...},
    {...}
],
count: 6,
timestamp: 1634355920
}
```
  列出对话Session

包括群会话和个人会话，没什么用

url: https://pan.baidu.com/mbox/group/groupsession

列出群组中的共享文件/文件夹

py: list_group_shares(group_id) -> List[PcsGroupShareFile]

web request

url: https://pan.baidu.com/mbox/group/listshare?gid=461057192968828484&limit=50&type=2
type: get

返回内容：可以看到群组中的所有分享msg_list，每次分享对应一个msg_id,msg的uk, 一个msg_id下有一个List[fs_ids]

{
errno: 0,
request_id: 8998245719243090000,
has_more: 0,
timestamp: 1634361543,
records: {
    msg_count: 6,
    msg_list: [{
            msg_id: "6217907761116094706",
            group_id: "461057192968828484",
            msg_type: 100,
            file_list: [{
                category: "6",
                fs_id: "748932364151706",
                isdir: "1",
                path: "/星辰学院课程目录09.11更新",
                server_filename: "星辰学院课程目录09.11更新",
                size: "0",
                ...
            }],
            uk: 29515193,
            uname: "小田***88",
        },
        {...},
        {...},
        {...},
        {...},
        {...}
    ]
}
}

列出文件夹下的文件列表

py: list_group_share_file(PcsGroupShareFile) -> List[PcsGroupShareFile]

web request:

url: https://pan.baidu.com/mbox/msg/shareinfo?msg_id=6217907761116094706&page=1&from_uk=29515193&gid=461057192968828484&type=2&fs_id=748932364151706&num=50
type: get

返回内容: 这里虽然有一个dlink, 但是不知道怎么用

{
errno: 0,
request_id: 8998394438598065000,
records: [
    {
        category: 4,
        fs_id: 919955398128988,
        isdir: 0,
        path: "/星辰学院课程目录09.11更新/课程目录使用详解.docx",
        server_filename: "课程目录使用详解.docx",
        size: 316017,
        dlink: "U2tyufKRM4ZbmoxP/ygY3HKUVdIIOb+ShnqZKjX/HlhrAcKoKCbF3kknM5D4itJERkqq4Jjm+W3+OenhgjYxaySneLYGTbuLwbApub10Q3Iu3g16y3g60CTLgiN2TUpDMONsOvfsMbCiiS5DOexTvYd8q5YIhKpf2vF3/DuLmL60gipByItjBjuHFwZd4IiUuq0C+QwIaWKsvcrel/AJev+ORmu7PdLiapMMRo97oWqme/fm/Bqs1uIhN7j0hjTvCPrG+ZGYGNv7D3aqxeMcyPye0gTr6fGSPy+XrR2hPOd6JdQeAwqHiXbZY3oKbB7bCZlOhjSY8Ny8g271vmNi0TIWEU7PheCPPyVZOxZ4bmgD/JMzlgbfFoG/uG3Udq5vhVEoPrPtvKVESP48WwU+HbaEpn5qhZXmouzo52NwuIoSzg9dW251CwIn00Kt3Gwatiaz7EtUI8f+06h7OeUs70apX3kIt1R1Ko01IdtrOlBEBGF0I/OLOaBU/SlQH0nlPOoX",
    },
    {...}
],
timestamp: 1634362097,
has_more: 0
}

分享文件到群组

py: share_to_group(List[PcsFile], group_id)
web request:
- url: https://pan.baidu.com/mbox/msg/send?msg_type=2&fs_ids=%5B575188784639307%5D&receiver=%5B%22191120229286385670%22%5D&send_type=4&bdstoken=6c21411b9b16244472b094f15304ca72
  - 参数： fs_ids=[575188784639307], reciever=["191120229286385670"]为群组id，bdtokens这里不加出错
- type: get
- 返回msg_id
```
{
"msg_id":"3989047495999476555",
...
}
```

转存文件

py: transfer_group_file(List[PcsGroupShareFile], remote_save_dir)
web request:
- url: https://pan.baidu.com/mbox/msg/transfer
- type: post
- post data:
```
from_uk:29515193,
msg_id:"6217907761116094706",
path:/remote_save_dir,
ondup:newcopy,
async:1,
type:2,
gid:461057192968828484,
fs_ids:"[59479004746095,29253795039390]"
```
- 返回内容：
```
{"errno":0,"request_id":8999504730235608174}
```
- 在chrome中测试时，这个transfer接口偶尔会返回errno=4的错误(QPS达到上限)，但实际文件却又是转存成功的。
  下载文件
  
  这里的方法得到的下载链接在chrome中只对小文件有效(测试文件<20M)，可以直接在浏览器中下载。对大文件(测试文件>80M)，得到的下载链接在浏览器打开返回错误码。对文件夹未测试，估计无效。

web request:

url: https://pan.baidu.com/api/sharedownload?sign=&timestamp=
type: post

post data，其中参数primaryid填msg_id

encrypt:0,
uk:4263942265,
product:mbox,
primaryid:6217907761116094706,
fid_list:[780363705487750],
extra:{"type":"group","gid":"461057192968828484"}

返回内容

{
errno: 0
list: [{
    category: 4
    context: "uk=4263942265&primaryid=6217907761116094706&fid_list=[780363705487750]&product=mbox&extra=%7B%22type%22%3A%22group%22%2C%22gid%22%3A%22461057192968828484%22%2C%22from_uk%22%3A29515193%7D&token=8dba38dfe062e693b47b486a0050316f"
    dlink: "https://d.pcs.baidu.com/file/393165686c0aab0613f2883d6043a016?fid=29515193-250528-780363705487750&dstime=1634369746&rt=sn-gp&sign=FDtAERVYJoK-DCb740ccc5511e5e8fedcff06b081203-o5Cbpy3aPKC4PX%2F5X4OtFqZEIA0%3D&expires=8h&chkv=1&chkbd=0&chkpc=et&dp-logid=9000447706778851077&dp-callid=0&shareid=6217907761116094706&r=308706202&vuk=4263942265&file_type=0"
    fs_id: 780363705487750
    isdir: 0
    md5: "393165686c0aab0613f2883d6043a016"
    path: "/星辰学院课程目录09.11更新/课程目录使用详解.pdf"
    server_filename: "课程目录使用详解.pdf"
    size: 376978
    ...
}]
request_id: 9000447706778851000
server_time: 1634369746
}

好友接口

好友接口与群组接口只相差一点点，在具体代码实现时可以考虑合并到一起。

列出好友列表

py list_friends() -> List[PcsFriend]
web request:
- type: get
- url: https://pan.baidu.com/mbox/relation/getfollowlist?start=0&limit=20&t=1634356445781&bdstoken=6c21411b9b16244472b094f15304ca72&channel=chunlei&web=1&app_id=250528&logid=MTYzNDM1NjQ0NTc4MjAuMDAyNTMzMzU4OTQwNzUyNzk0Ng==&clienttype=0
- simple url: https://pan.baidu.com/mbox/relation/getfollowlist?start=0&limit=20
- 返回内容：has_more字段指示是否已列完
```
{
errno: 0,
request_id: 8996887877156740000,
records: [{
        uk: 1100959212114,
        uname: "竹节**翠6",
        nick_name: "",
        vip_type: 0,
        isFriend: 2,
    },
    {...},
    {...}
],
has_more: 0
}
```

列出好友的共享文件/文件夹

py: list_friend_shares(from_uk) -> List[PcsFriendShareFile]

web request1

url: https://pan.baidu.com/mbox/msg/sessioninfo?to_uk=1100959212114&type=2
type: get

返回内容：可以看到好友中的所有分享msg_list，每次分享对应一个msg_id,msg的from_uk和to_uk, 一个msg_id下有一个List[fs_ids]。这里第一次请求得到的是对方分享给我的文件，has_more字段指示还有更多文件，cursor用于拼写请求更多文件的url。

{
errno: 0,
request_id: 8999975063782876000,
records: {
    list: [{
        filelist: {
            list: [{
                category: "6",
                fs_id: "669116894181201",
                isdir: "1",
                path: "/星辰学院已压缩/洋葱数学",
                server_filename: "洋葱数学",
                size: "0",
            }],
            total: 1
        },
        msg_id: "6066366433724808064",
        from_uk: 1100959212114,
        to_uk: 4263942265,
        from_uname: "竹节**翠6",
        to_uname: "ya***nbd",
        msg_type: 100,
        is_share: "1"
    }],
    has_more: 1,
    cursor: "MTYzNDM2NzUxMDc3NCYxNjM0MzY3NTEwNzc0"
}
}

web request2

url: https://pan.baidu.com/mbox/msg/sessioninfo?to_uk=1100959212114&cursor=MTYzNDM2NzUxMDc3NCYxNjM0MzY3NTEwNzc0&type=2
- url中的cursor参数来自于第一次请求
type: get

返回内容:

{
errno: 0,
request_id: 8999910272200854000,
records: {
    list: [{
        filelist: {
            list: [{
                category: "6",
                fs_id: "553185097408759",
                isdir: "1",
                path: "/tmp/蜀山战纪",
                server_filename: "蜀山战纪",
                size: "0",
            }],
            total: 1
        },
        msg_id: "630301755343958566",
        from_uk: 4263942265,
        to_uk: 1100959212114,
        from_uname: "ya***nbd",
        to_uname: "竹节**翠6",
        msg_type: 100,
        is_share: "1"
    }],
    has_more: 0,
    cursor: "MTYzNDM2NzQxODUyMiYxNjM0MzY3NTEwNzc0"
}
}

列出文件夹下的文件列表

py: list_friend_share_file(PcsFriendShareFile) -> List[PcsFriendShareFile]
web request:
- url: https://pan.baidu.com/mbox/msg/shareinfo?msg_id=6066366433724808064&page=1&from_uk=1100959212114&to_uk=4263942265&type=1&fs_id=669116894181201&num=50
- url: https://pan.baidu.com/mbox/msg/shareinfo?msg_id=630301755343958566&page=1&from_uk=4263942265&to_uk=1100959212114&type=1&fs_id=553185097408759&num=50
- 对比group同类接口，这里参数gid、from_uk换成了from_uk、to_uk, type=2换成了type=1
- type: get
- 返回内容:
```
{
errno: 0,
request_id: 9000076928880206000,
records: [{
        category: 6,
        fs_id: 810572750068084,
        isdir: 1,
        local_ctime: 1633807068,
        local_mtime: 1633807068,
        path: "/星辰学院已压缩/洋葱数学/小学",
        server_ctime: 1633807068,
        server_filename: "小学",
        server_mtime: 1633855185,
        size: 0
    },
    {...}
],
timestamp: 1634368364,
has_more: 0
}
```

转存文件

py: transfer_friend_file(List[PcsFriendShareFile], remote_save_dir)
web request:
- url: https://pan.baidu.com/mbox/msg/transfer
- type: post
- post data: 这里观察到的fs_ids的引号位置有点奇怪，不知道是不是因为js的原因
```
from_uk:1100959212114
to_uk:4263942265
msg_id:6066366433724808064
path:/remote_save_dir
ondup:newcopy
async:1
type:1
fs_ids:["669116894181201"]
```
- 返回内容：
```
{"errno":0,"request_id":9000190836497545056}
```
  下载文件
  
  略

photkey commented 3 years ago

同求！最近在找类似的开源项目，github来回翻了好几遍也没找到。

silegon commented 2 years ago

这部分工作我自行开发了，存在一些复杂的地方，已经不是光这个项目能覆盖的了，可能需要对应的持久化管理。难点： 1.以前的操作都是单步操作。而将群组里的文件眷村到自己的文件夹涉及到几步操作。分别是：1.列出信息列表；2.定位群组信息；拉去对应群的信息；3.定位文件分享消息，拉取其中的文件夹列表，逐个复制。（可以突破文件转存数量限制） 2.在操作操作的过程中，需要将以前的异步操作转化为同步操作。不然可能会出现多个命令操作同一个文件夹的情况，出现错误。 3.操作频率高了也会出现错误，这些都需要每一步判断处理，否则影响下一步的操作基础要素。 4.这些都是网络操作。可能要应对网络通信问题。

总而言之，这些操作涉及到网络、批量、多步操作的问题。需要花时间调试处理。另外最终的产品形态以及使用方法也不会简单。

albert285957606 commented 2 years ago

下载文件的fid_list是什么，我使用文件的fs_id，但返回出的结果还是error

albert285957606 commented 2 years ago

这个真不好搞，有没有辅助app，那个验证过一会儿就失效了

PeterDing / BaiduPCS-Py

能否添加对群、好友分享文件的操作功能 #73

群、好友分享的数据结构

群组接口

列出群组列表

列出对话Session

列出群组中的共享文件/文件夹

列出文件夹下的文件列表

分享文件到群组

转存文件

下载文件

好友接口

列出好友列表

列出好友的共享文件/文件夹

列出文件夹下的文件列表

转存文件

下载文件