Northern_Lights/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

整理主目录，更新AI总结文档 (#871)

Browse Source 
* 整理README中的目录信息，使之与项目中的文档一一对应。

更新AI总结的文档，修复card_info.md中出现的格式错乱。

* 修改AI总结文档的错误内容
This commit is contained in:
EssentialCuber
2023-11-23 13:40:54 +08:00
committed by GitHub
parent 86ba55259d
commit a01ef3bdc2
3 changed files with 366 additions and 291 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
docs/dynamic/card_info.md
View File

@@ -13,12 +13,13 @@
需注意账号转发视频投稿，其他用户的动态以及分享收藏夹等均为转发类内容，并不属于type=4300的收藏类动态等。
在type=1的转发类动态中，解析出的对象包含以下内容：
| 字段 | 类型 | 内容 | 备注 |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| user | obj | 转发者用户信息 | 包含用户名，用户id和头像 |
| item | obj | 转发相关信息 | `content`字段为转发附言 | |
| origin | str | 被转发动态信息 | 即本文档所描述的动态详细信息字段。<br/>动态类型为`item`对象的`orig_type`字段 |
| origin_extend_json | str | 被转发动态补充信息 | |
| user | obj | 转发者用户信息 | 包含用户名，用户id和头像 |
| item | obj | 转发相关信息 | `content`字段为转发附言 | |
| origin | str | 被转发动态信息 | 即本文档所描述的动态详细信息字段。<br/>动态类型为`item`对象的`orig_type`字段 |
| origin_extend_json | str | 被转发动态补充信息 | |
| origin_user | obj | 被转发用户信息 | |
| activity_infos | obj | 被转发动态参与的活动 | |
@@ -106,10 +107,11 @@
## 在图片动态中（type=2）
在type=2的图片动态中，解析出的对象包含以下内容：
| 字段 | 类型 | 内容 | 备注 |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| item | obj | 图片动态内容 | `description`字段为文字内容<br/>`pictures`字段图片 | |
| user | obj | 发布者用户信息 | 包含用户名，用户id和头像 |
| item | obj | 图片动态内容 | `description`字段为文字内容<br/>`pictures`字段图片 | |
| user | obj | 发布者用户信息 | 包含用户名，用户id和头像 |
<details>
@@ -166,14 +168,14 @@
</details>
## 在文字动态中（type=4）
在type=4的文字动态中，解析出的对象包含以下内容：
| 字段 | 类型 | 内容 | 备注 |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| item | obj | 文字动态内容 | `description`字段为文字内容 | |
| user | obj | 发布者用户信息 | 包含用户名，用户id和头像 |
| item | obj | 文字动态内容 | `description`字段为文字内容 | |
| user | obj | 发布者用户信息 | 包含用户名，用户id和头像 |
<details>
@@ -204,9 +206,10 @@
## 在视频投稿动态中（type=8）
在type=8的视频投稿动态中，解析出的对象包含以下内容：
| 字段 | 类型 | 内容 | 备注 |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| aid | num | 视频avid | |
| aid | num | 视频avid | |
| attribute | num | `0` | [可能已弃用](https://shakaianee.top/archives/9/) |
| cid | num | 视频cid | |
| copyright | num | 原创信息 | 1为原创，2为转载 |
@@ -215,7 +218,7 @@
| duration | num | 视频时长 | 单位秒 |
| dynamic | str | 动态文字内容 | |
| first_frame | str | 视频第一帧图片 | 图片链接 |
| jump_url | str | 视频跳转链接 | |
| jump_url | str | 视频跳转链接 | |
| mission_id | num | 稿件参与的活动id | |
| owner | obj | 动态作者信息 | 即up主 |
| pic | str | 视频封面 | |
@@ -223,7 +226,7 @@
| pubdate | num | 发布时间 | 时间戳 |
| rights | obj | 联合投稿，是否付费等信息 | 可能用来代替原`attribute`字段 |
| stat | obj | 视频数据 | 点赞投币等 |
| state | num | 视频状态 | 详情见**属性数据文档** |
| state | num | 视频状态 | 详情见**属性数据文档** |
| tid | num | 视频分区编号 | |
| title | str | 视频标题 | |
| tname | str | 视频分区名称 | |
@@ -302,7 +305,8 @@
## 在专栏投稿动态中（type=64）
在type=64的专栏投稿动态中，解析出的对象包含以下内容：
| 字段 | 类型 | 内容 | 备注 |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| id | num | 专栏的id，即cv号 | |
| category | obj | 分类号和分类名称 | |
@@ -313,10 +317,10 @@
| template_id | num | 模板信息 | |
| state | num | 专栏状态 | |
| author | obj | 作者信息 | 包含了头像挂件和勋章等 |
| reprint | num | 可能是转载 | |
| reprint | num | 可能是转载 | |
| image_urls | obj | 图片链接 | |
| publish_time | num | 发布时间 | 时间戳，应该指专栏 |
| ctime | num | 发布时间 | 时间戳，应该指动态 |
| publish_time | num | 发布时间 | 时间戳，应该指专栏 |
| ctime | num | 发布时间 | 时间戳，应该指动态 |
| stats | obj | 专栏数据,点赞之类 | 有点踩字段，但并未实装此功能 |
| words | num | 字数 | |
| origin_image_urls | obj | 源图片地址 | |
@@ -448,7 +452,8 @@
## 在音频投稿动态中（type=256）
在type=256的音频投稿动态中，解析出的对象包含以下内容：
| 字段 | 类型 | 内容 | 备注 |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| id | num | 投稿编号 | 即au号 |
| upId | num | 音乐人id | 与用户uid不同 |
@@ -456,7 +461,7 @@
| upper | str | 上传者名称 | |
| cover | str | 封面图链接 | |
| author | str | 作者名称 | |
| ctime | num | 上传时间 | 时间戳的后面加了三个0 |
| ctime | num | 上传时间 | 时间戳的后面加了三个0 |
| playCnt | num | 播放量 | |
| intro | str | 音频介绍 | |
| schema | str | 跳转链接 | 似乎并不只是url |

285
docs/video/summary.md
View File

@@ -1,5 +1,3 @@
**# 视频AI总结**
@@ -18,70 +16,65 @@
**请求方式: Get**
认证方式: Cookie(SESSDATA)
认证方式: 无需认证
限制游客访问，需要登录
鉴权方式：[Wbi 签名](../misc/sign/wbi.md)
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ------------------------------------ |
| bvid | str | 稿件bvid | 必要 | |
| cid | num | 稿件cid | 必要 | |
| up_mid | num | UP主mid | 必要 | |
| w_rid | str | Wbi 签名 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
| wts | num | 当前时间戳 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|--------|-----|--------|-----|----------------------------------|
| bvid | str | 稿件bvid | 必要 | |
| cid | num | 稿件cid | 必要 | |
| up_mid | num | UP主mid | 必要 | |
| w_rid | str | Wbi 签名 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
| wts | num | 当前时间戳 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | -------------------------------- |
| code | num | 返回值 | 0: 成功<br /> -403: 访问权限不足 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 数据本体 | |
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|--------------------------|
| code | num | 返回值 | 0: 成功<br /> -403: 访问权限不足 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 数据本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0: 有摘要<br />-1: 没有摘要 |
| model_result | obj | 摘要内容 | |
| 字段 | 类型 | 内容 | 备注 |
|--------------|-----|------|----------------------|
| code | num | 返回值 | 0: 有摘要<br />-1: 没有摘要 |
| model_result | obj | 摘要内容 | |
`model_result`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------------- | ----------------------------------------------------------- |
| result_type | num | 数据类型 | 0: 没有摘要或者没有时间线<br />2: 有时间线<br />(1暂不知晓) |
| summary | str | 整个视频总结 | |
| outline | obj | 时间线 | 没有时间线为None |
| like_num | num | 喜欢人数 | |
| dislike_num | num | 不喜欢人数 | |
| stid | num | 摘要id | 没有摘要为0 |
| status | num | 状态(暂不知晓) | 正常为0 |
| 字段 | 类型 | 内容 | 备注 |
|-------------|-----|----------|------------------------------------------|
| result_type | num | 数据类型 | 0: 没有摘要或者没有时间线<br />2: 有时间线<br />(1暂不知晓) |
| summary | str | 整个视频总结 | |
| outline | obj | 时间线 | 没有时间线为None |
| like_num | num | 喜欢人数 | |
| dislike_num | num | 不喜欢人数 | |
| stid | num | 摘要id | 没有摘要为0 |
| status | num | 状态(暂不知晓) | 正常为0 |
`outline`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | -------- | ---- |
| title | str | 分段标题 | |
| part_outline | obj | 分段小结 | |
| 字段 | 类型 | 内容 | 备注 |
|--------------|-----|------|----|
| title | str | 分段标题 | |
| part_outline | obj | 分段小结 | |
`part_outline`对象:
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ---------- | ---- |
| timestamp | num | 小结时间戳 | |
| content | str | 小结内容 | |
| 字段 | 类型 | 内容 | 备注 |
|-----------|-----|-------|----|
| timestamp | num | 小结时间戳 | |
| content | str | 小结内容 | |
**示例**
@@ -92,66 +85,93 @@ curl 'https://api.bilibili.com/x/web-interface/view/conclusion/get?bvid=BV1L94y1
--compressed
```
<details>
<summary>查看Python Demo</summary>
```python
import requests
headers = {
# 需要附带上Cookie等信息
'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36',
}
params = {
'bvid': 'BV1d94y1375U',
'cid': '1334003541',
'up_mid': '407275913',
'w_rid': '5cafe844afcb813ecd129f08e6ea73b5', # 参见Wbi签名章节
'wts': '1700579155',
}
response = requests.get(
'https://api.bilibili.com/x/web-interface/view/conclusion/get',
params=params,
headers=headers,
)
```
</details>
有摘要示例:
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"code": 0,
"model_result": {
"result_type": 2,
"summary": "在网上阅读时遇到错别字和语言梗的烦恼,以及正确使用语言的重要性。作者认为,我们每个人都应该有包容心,不掉渣,不纠正别人的错误,同时也需要明辨是非,规范使用语言。视频还提到了一些常见的语言梗和错误用法,呼吁大家不要过分使用网络词汇,而应该注重语言的艺术性和深度。最后,作者欢迎大家关注他的微信公众号。",
"outline": [
{
"title": "现代人使用中文时面临的困境,包括错别字、用法不正确等问题,并呼吁大家规范使用中文。",
"part_outline": [
{
"timestamp": 1,
"content": "网友评论有错别字，勉强能看懂，但难受。"
},
{
"timestamp": 39,
"content": "重来一次，明辨是非。"
},
{
"timestamp": 167,
"content": "粉墨登场是贬义词，形容坏人打扮好老登场。"
}
],
"timestamp": 1
},
{
"title": "网络词汇的过度使用导致语言生硬,以及对流行语言梗的短暂使用感到厌倦。",
"part_outline": [
{
"timestamp": 241,
"content": "网络词汇过分使用会误导别人，使规范词汇生硬"
},
{
"timestamp": 270,
"content": "以前的语言梗有深度，现在的流行梗很短命"
},
{
"timestamp": 338,
"content": "巨星之间需要化学反应的过程，前几场发挥欠佳"
}
],
"timestamp": 241
}
]
"model_result": {
"result_type": 2,
"summary": "在网上阅读时遇到错别字和语言梗的烦恼,以及正确使用语言的重要性。作者认为,我们每个人都应该有包容心,不掉渣,不纠正别人的错误,同时也需要明辨是非,规范使用语言。视频还提到了一些常见的语言梗和错误用法,呼吁大家不要过分使用网络词汇,而应该注重语言的艺术性和深度。最后,作者欢迎大家关注他的微信公众号。",
"outline": [
{
"title": "现代人使用中文时面临的困境,包括错别字、用法不正确等问题,并呼吁大家规范使用中文。",
"part_outline": [
{
"timestamp": 1,
"content": "网友评论有错别字，勉强能看懂，但难受。"
},
{
"timestamp": 39,
"content": "重来一次，明辨是非。"
},
{
"timestamp": 167,
"content": "粉墨登场是贬义词，形容坏人打扮好老登场。"
}
],
"timestamp": 1
},
"stid": "5117037934391059183",
"status": 0,
"like_num": 3,
"dislike_num": 0
}
{
"title": "网络词汇的过度使用导致语言生硬,以及对流行语言梗的短暂使用感到厌倦。",
"part_outline": [
{
"timestamp": 241,
"content": "网络词汇过分使用会误导别人，使规范词汇生硬"
},
{
"timestamp": 270,
"content": "以前的语言梗有深度，现在的流行梗很短命"
},
{
"timestamp": 338,
"content": "巨星之间需要化学反应的过程，前几场发挥欠佳"
}
],
"timestamp": 241
}
]
},
"stid": "5117037934391059183",
"status": 0,
"like_num": 3,
"dislike_num": 0
}
}
```
@@ -188,37 +208,37 @@ curl 'https://api.bilibili.com/x/web-interface/view/conclusion/get?bvid=BV1L94y1
认证方式：Cookie(SESSDATA)
限制游客访问，需要登录
鉴权方式：[Wbi 签名](../misc/sign/wbi.md)
***\*url参数:\****
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ------------------------------------ |
| w_rid | str | Wbi 签名 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
| wts | num | 当前时间戳 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|-------|-----|--------|-----|----------------------------------|
| w_rid | str | Wbi 签名 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
| wts | num | 当前时间戳 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
**正文参数( application/x-www-form-urlencoded ):**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | --------------------------------- |
| bvid | str | 稿件bvid | 必要 | |
| cid | num | 稿件cid | 必要 | |
| up_mid | num | UP主mid | 必要 | |
| stid | num | 摘要id | 必要 | |
| like_state | num | 喜欢状态 | 必要 | 1: 点赞<br />2: 取消<br />3: 点踩 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|------------|-----|----------------------|-----|-----------------------------|
| bvid | str | 稿件bvid | 必要 | |
| cid | num | 稿件cid | 必要 | |
| up_mid | num | UP主mid | 必要 | |
| stid | num | 摘要id | 必要 | |
| like_state | num | 喜欢状态 | 必要 | 1: 点赞<br />2: 取消<br />3: 点踩 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | -------------------------------------------------- |
| code | num | 返回值 | 0: 成功 <br />-400: 请求错误<br />65006: 已赞/踩过 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|------------------------------------------|
| code | num | 返回值 | 0: 成功 <br />-400: 请求错误<br />65006: 已赞/踩过 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
**示例：**
@@ -230,11 +250,46 @@ curl 'https://api.bilibili.com/x/web-interface/view/conclusion/set?w_rid=edb471f
--compressed
```
<details>
<summary>查看Python Demo</summary>
```python
import requests
headers = {
# 需要附带上Cookie等信息
'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36',
}
params = {
'w_rid': 'edb471fc926646ef3889a80488166b66',
'wts': '1700358953',
}
data = {
'bvid': 'BV1L94y1H7CV',
'cid': '1335073288',
'up_mid': '297242063',
'stid': '5117037934391059183',
'like_state': '1',
'csrf': '522xxxxxxxxxxxxxxx6f4',
}
response = requests.post(
'https://api.bilibili.com/x/web-interface/view/conclusion/set',
params=params,
data=data
)
```
</details>
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,