From a071605b1fcc690de16629d682624d92576c95ed Mon Sep 17 00:00:00 2001
From: Marcus233 <102860926+MarcusYYDS@users.noreply.github.com>
Date: Sun, 19 Nov 2023 11:48:45 +0800
Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0AI=E6=91=98=E8=A6=81=E6=96=87?=
=?UTF-8?q?=E6=A1=A3=20(#865)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
* add:增加AI摘要文档
* Update:摘要点赞/踩,更多示例
* fix: 语法错误
---
assets/img/aiSummary.svg | 1 +
docs/video/summary.md | 246 +++++++++++++++++++++++++++++++++++++++
2 files changed, 247 insertions(+)
create mode 100644 assets/img/aiSummary.svg
create mode 100644 docs/video/summary.md
diff --git a/assets/img/aiSummary.svg b/assets/img/aiSummary.svg
new file mode 100644
index 0000000..efa4420
--- /dev/null
+++ b/assets/img/aiSummary.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/docs/video/summary.md b/docs/video/summary.md
new file mode 100644
index 0000000..9e5a0bc
--- /dev/null
+++ b/docs/video/summary.md
@@ -0,0 +1,246 @@
+
+
+**# 视频AI总结**
+
+
+
+
+
+
+
+**## 获取总结**
+
+
+
+> https://api.bilibili.com/x/web-interface/view/conclusion/get
+
+
+
+**请求方式: Get**
+
+
+
+认证方式: 无需认证
+
+
+
+鉴权方式:[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) |
+
+**json回复:**
+
+根对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | -------------------------------- |
+| code | num | 返回值 | 0: 成功
-403: 访问权限不足 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 数据本体 | |
+
+`data`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------------ | ---- | -------- | --------------------------- |
+| code | num | 返回值 | 0: 有摘要
-1: 没有摘要 |
+| model_result | obj | 摘要内容 | |
+
+`model_result`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ---- | -------------- | ----------------------------------------------------------- |
+| result_type | num | 数据类型 | 0: 没有摘要或者没有时间线
2: 有时间线
(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 | 分段小结 | |
+
+`part_outline`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| --------- | ---- | ---------- | ---- |
+| timestamp | num | 小结时间戳 | |
+| content | str | 小结内容 | |
+
+**示例**
+
+得到视频`BV1L94y1H7CV`的摘要
+
+```shell
+curl 'https://api.bilibili.com/x/web-interface/view/conclusion/get?bvid=BV1L94y1H7CV&cid=1335073288&up_mid=297242063&web_location=333.788&w_rid=d76ea8eaa47b3c9f0c4a910a8b9b66f5&wts=1700358732' \
+ --compressed
+```
+
+有摘要示例:
+
+
+查看响应示例:
+
+
+```json
+{
+ "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
+ }
+ ]
+ },
+ "stid": "5117037934391059183",
+ "status": 0,
+ "like_num": 3,
+ "dislike_num": 0
+ }
+}
+```
+
+
+
+无摘要示例:
+
+
+查看响应示例:
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "code": 1,
+ "model_result": {
+ "result_type": 0,
+ "summary": "",
+ "outline": None
+ },
+ "stid": "0",
+ "status": 0,
+ "like_num": 0,
+ "dislike_num": 0
+ }
+}
+```
+
+
+
+## 点赞&点踩摘要(对应上面link_num&dislike_num)
+
+认证方式:Cookie(SESSDATA)
+
+鉴权方式:[Wbi 签名](../misc/sign/wbi.md)
+
+
+
+***\*url参数:\****
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ---------- | ------ | ------------------------------------ |
+| 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: 点赞
2: 取消
3: 点踩 |
+| csrf | str | CSRF Token(位于cookie) | 必要 | |
+
+**json回复:**
+
+根对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | -------------------------------------------------- |
+| code | num | 返回值 | 0: 成功
-400: 请求错误
65006: 已赞/踩过 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+
+**示例:**
+
+为视频`BV1L94y1H7CV`的摘要`5117037934391059183`点赞
+
+```shell
+curl 'https://api.bilibili.com/x/web-interface/view/conclusion/set?w_rid=edb471fc926646ef3889a80488166b66&wts=1700358953' \
+ --data-raw 'bvid=BV1L94y1H7CV&cid=1335073288&up_mid=297242063&stid=5117037934391059183&like_state=1&csrf=522xxxxxxxxxxxxxxx6f4' \
+ --compressed
+```
+
+
+查看响应示例:
+
+
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1
+}
+```
+
+