|
|
@@ -7728,7 +7728,8 @@ export interface paths {
|
|
|
* @description 只列话题(不含回复),删除了但还有回复的话题以墓碑出现(deleted_at 有值、内容为空)。
|
|
|
* 未登录看不到不公开的话题(discussion);basic 角色在自己无权管理的对象上只看得到
|
|
|
* 自己发起的不公开话题。各状态的数量与「能发起哪些类型」见 `GET /v3/discussions/summary`。
|
|
|
- * 不传 type 时只列评论线程(discussion / qa / help / issue / glossary),批注要显式 type=note / commentary。
|
|
|
+ * 不传 type 时只列评论线程(discussion / qa / help / issue / glossary),批注与评估要显式
|
|
|
+ * type=note / commentary / assessment。
|
|
|
* 要一段经文(一章、一段段落区间)里的全部话题,用 `GET /v3/tipitaka-discussions/{channel}`。
|
|
|
*
|
|
|
* 实现:`V3\DiscussionController@index`
|
|
|
@@ -7736,13 +7737,17 @@ export interface paths {
|
|
|
get: operations["get_api_v3_discussions"];
|
|
|
put?: never;
|
|
|
/**
|
|
|
- * 发起话题或新建批注
|
|
|
+ * 发起话题、新建批注或评估
|
|
|
* @description discussion / issue 登录即可发;qa / help 只能发在文章上,且只有文章的编辑者能发。
|
|
|
* severity 的取值随 type:issue 为 error / warning / suggestion,help 为 urgent / normal,
|
|
|
* 其它类型不收。默认会通知对象的作者(站内信 + webhook),`notify=false` 关闭。
|
|
|
* 批注(note / commentary)只能加在句子上,且只有该句所在 channel 的编辑者能加;
|
|
|
* 标题可省、正文必填,commentary 的正文必须是义注句子模板 `{{book-para-start-end}}`
|
|
|
* (可多句并列);可带锚点 pos_* / quote_*;不发通知。
|
|
|
+ * assessment(译文评估:用某种方法给这句译文打分)只能加在句子上,且只有该句所在 channel 的编辑者能加
|
|
|
+ * (AI 凭授权代写);score(0–100 的整数)必填,severity 必填、填评估方法(1–16 位字母数字 . _ -),
|
|
|
+ * 标题可省,理由写 content;不收锚点、不发通知。**一句只留一条**:已有评估时就地覆盖
|
|
|
+ * (分数、方法、理由、署名都换成这次的,回复保留),返回 200;没有才新建,返回 201。
|
|
|
* glossary(外挂术语:不改译文,给锚点处的译文挂上术语)是评论线程,title 必填、填术语词头;
|
|
|
* 与批注一样只能挂在句子上、只有该句所在 channel 的编辑者能发,对所有人公开可见。
|
|
|
* 锚点只有 note / commentary / issue / glossary 收,其它类型传了 422。
|
|
|
@@ -7843,6 +7848,7 @@ export interface paths {
|
|
|
* 正文不能清空,可改锚点。
|
|
|
* 改了内容(标题、正文、锚点)时 co_editor 跟着这次写入走:人亲自改则清空,AI 代改则换成该模型;
|
|
|
* 只改 status / type / severity 不动 co_editor。
|
|
|
+ * 评估:可改 score、severity(评估方法,不能清空)、标题、正文;没有 status,不能与其它类型互转。
|
|
|
*
|
|
|
* 实现:`V3\DiscussionController@update`
|
|
|
*/
|
|
|
@@ -8288,8 +8294,8 @@ export interface paths {
|
|
|
* 列出一段经文里的话题
|
|
|
* @description 只列挂在该 channel 句子上的话题(不含回复),按经文顺序(书、段、句)排列,同一句里按时间;
|
|
|
* 每条带 `sentence`(所在句子的坐标)。删除了但还有回复的话题以墓碑出现。
|
|
|
- * 不传 type 时只列评论线程(discussion / qa / help / issue / glossary),批注要显式
|
|
|
- * type=note / commentary。可见性同 `GET /v3/discussions`:未登录看不到 discussion;
|
|
|
+ * 不传 type 时只列评论线程(discussion / qa / help / issue / glossary),批注与评估要显式
|
|
|
+ * type=note / commentary / assessment。可见性同 `GET /v3/discussions`:未登录看不到 discussion;
|
|
|
* basic 角色在自己不能编辑的 channel 上只看得到自己发起的 discussion。
|
|
|
* channel 不存在或范围内没有讨论都返回空列表;chapter 不存在 404。
|
|
|
*
|
|
|
@@ -34521,11 +34527,11 @@ export interface operations {
|
|
|
/** @description 挂靠对象的 uuid */
|
|
|
target_id: string;
|
|
|
/** @description 类型,不传则只列评论线程 */
|
|
|
- type?: "discussion" | "qa" | "help" | "issue" | "glossary" | "note" | "commentary";
|
|
|
+ type?: "discussion" | "qa" | "help" | "issue" | "glossary" | "note" | "commentary" | "assessment";
|
|
|
/** @description 话题状态,不传则两种都要 */
|
|
|
status?: "active" | "close";
|
|
|
/**
|
|
|
- * @description 严重程度,逗号分隔多选
|
|
|
+ * @description 严重程度(assessment 为评估方法),逗号分隔多选
|
|
|
* @example error,warning
|
|
|
*/
|
|
|
severity?: string;
|
|
|
@@ -34554,6 +34560,7 @@ export interface operations {
|
|
|
parent_id?: string | null;
|
|
|
type?: string;
|
|
|
severity?: string | null;
|
|
|
+ score?: number | null;
|
|
|
status?: string;
|
|
|
title?: string | null;
|
|
|
content?: string | null;
|
|
|
@@ -34634,16 +34641,21 @@ export interface operations {
|
|
|
* @default discussion
|
|
|
* @enum {string}
|
|
|
*/
|
|
|
- type?: "discussion" | "qa" | "help" | "issue" | "glossary" | "note" | "commentary";
|
|
|
- /** @description 标题,最长 256 字符;评论线程必填(glossary 填术语词头),批注可省 */
|
|
|
+ type?: "discussion" | "qa" | "help" | "issue" | "glossary" | "note" | "commentary" | "assessment";
|
|
|
+ /** @description 标题,最长 256 字符;评论线程必填(glossary 填术语词头),批注与评估可省 */
|
|
|
title?: string;
|
|
|
- /** @description 正文(markdown);批注必填 */
|
|
|
+ /** @description 正文(markdown);批注必填,评估写打分理由 */
|
|
|
content?: string;
|
|
|
/**
|
|
|
- * @description 严重程度
|
|
|
- * @enum {string}
|
|
|
+ * @description 严重程度:issue 为 error / warning / suggestion,help 为 urgent / normal;assessment 必填,填评估方法(1–16 位字母数字 . _ -)
|
|
|
+ * @example error
|
|
|
+ */
|
|
|
+ severity?: string;
|
|
|
+ /**
|
|
|
+ * @description 评估分数,0–100 的整数(只限且必填于 assessment)
|
|
|
+ * @example 85
|
|
|
*/
|
|
|
- severity?: "error" | "warning" | "suggestion" | "urgent" | "normal";
|
|
|
+ score?: number;
|
|
|
/** @description 锚点在句子文本中的起始偏移(只限 note / commentary / issue / glossary) */
|
|
|
pos_start?: number;
|
|
|
/** @description 锚点的结束偏移,批注插在这里(只限 note / commentary / issue / glossary) */
|
|
|
@@ -34665,7 +34677,7 @@ export interface operations {
|
|
|
};
|
|
|
};
|
|
|
responses: {
|
|
|
- /** @description 成功 */
|
|
|
+ /** @description 覆盖了该句已有的评估(只限 assessment) */
|
|
|
200: {
|
|
|
headers: {
|
|
|
[name: string]: unknown;
|
|
|
@@ -34679,6 +34691,7 @@ export interface operations {
|
|
|
parent_id?: string | null;
|
|
|
type?: string;
|
|
|
severity?: string | null;
|
|
|
+ score?: number | null;
|
|
|
status?: string;
|
|
|
title?: string | null;
|
|
|
content?: string | null;
|
|
|
@@ -34747,6 +34760,7 @@ export interface operations {
|
|
|
parent_id?: string | null;
|
|
|
type?: string;
|
|
|
severity?: string | null;
|
|
|
+ score?: number | null;
|
|
|
status?: string;
|
|
|
title?: string | null;
|
|
|
content?: string | null;
|
|
|
@@ -34866,7 +34880,7 @@ export interface operations {
|
|
|
/** @description 挂靠对象的 uuid */
|
|
|
target_id: string;
|
|
|
/** @description 只数这种类型,不传则只数评论线程 */
|
|
|
- type?: "discussion" | "qa" | "help" | "issue" | "glossary" | "note" | "commentary";
|
|
|
+ type?: "discussion" | "qa" | "help" | "issue" | "glossary" | "note" | "commentary" | "assessment";
|
|
|
};
|
|
|
header?: never;
|
|
|
path?: never;
|
|
|
@@ -34920,6 +34934,7 @@ export interface operations {
|
|
|
parent_id?: string | null;
|
|
|
type?: string;
|
|
|
severity?: string | null;
|
|
|
+ score?: number | null;
|
|
|
status?: string;
|
|
|
title?: string | null;
|
|
|
content?: string | null;
|
|
|
@@ -35003,6 +35018,7 @@ export interface operations {
|
|
|
parent_id?: string | null;
|
|
|
type?: string;
|
|
|
severity?: string | null;
|
|
|
+ score?: number | null;
|
|
|
status?: string;
|
|
|
title?: string | null;
|
|
|
content?: string | null;
|
|
|
@@ -35096,12 +35112,17 @@ export interface operations {
|
|
|
* @description 类型(只限话题;评论线程与批注不能互转)
|
|
|
* @enum {string}
|
|
|
*/
|
|
|
- type?: "discussion" | "qa" | "help" | "issue" | "glossary" | "note" | "commentary";
|
|
|
+ type?: "discussion" | "qa" | "help" | "issue" | "glossary" | "note" | "commentary" | "assessment";
|
|
|
/**
|
|
|
- * @description 严重程度(只限话题),null 表示清空
|
|
|
- * @enum {string}
|
|
|
+ * @description 严重程度(只限话题),null 表示清空;assessment 为评估方法,不能清空
|
|
|
+ * @example warning
|
|
|
+ */
|
|
|
+ severity?: string;
|
|
|
+ /**
|
|
|
+ * @description 评估分数,0–100 的整数(只限 assessment)
|
|
|
+ * @example 85
|
|
|
*/
|
|
|
- severity?: "error" | "warning" | "suggestion" | "urgent" | "normal";
|
|
|
+ score?: number;
|
|
|
/** @description 锚点起始偏移(只限 note / commentary / issue / glossary) */
|
|
|
pos_start?: number;
|
|
|
/** @description 锚点结束偏移(只限 note / commentary / issue / glossary) */
|
|
|
@@ -35130,6 +35151,7 @@ export interface operations {
|
|
|
parent_id?: string | null;
|
|
|
type?: string;
|
|
|
severity?: string | null;
|
|
|
+ score?: number | null;
|
|
|
status?: string;
|
|
|
title?: string | null;
|
|
|
content?: string | null;
|
|
|
@@ -35228,6 +35250,7 @@ export interface operations {
|
|
|
parent_id?: string | null;
|
|
|
type?: string;
|
|
|
severity?: string | null;
|
|
|
+ score?: number | null;
|
|
|
status?: string;
|
|
|
title?: string | null;
|
|
|
content?: string | null;
|
|
|
@@ -35324,6 +35347,7 @@ export interface operations {
|
|
|
parent_id?: string | null;
|
|
|
type?: string;
|
|
|
severity?: string | null;
|
|
|
+ score?: number | null;
|
|
|
status?: string;
|
|
|
title?: string | null;
|
|
|
content?: string | null;
|
|
|
@@ -35392,6 +35416,7 @@ export interface operations {
|
|
|
parent_id?: string | null;
|
|
|
type?: string;
|
|
|
severity?: string | null;
|
|
|
+ score?: number | null;
|
|
|
status?: string;
|
|
|
title?: string | null;
|
|
|
content?: string | null;
|
|
|
@@ -36437,7 +36462,7 @@ export interface operations {
|
|
|
/** @description 话题状态,不传则两种都要 */
|
|
|
status?: "active" | "close";
|
|
|
/**
|
|
|
- * @description 严重程度,逗号分隔多选
|
|
|
+ * @description 严重程度(assessment 为评估方法),逗号分隔多选
|
|
|
* @example error,warning
|
|
|
*/
|
|
|
severity?: string;
|
|
|
@@ -36467,6 +36492,7 @@ export interface operations {
|
|
|
parent_id?: string | null;
|
|
|
type?: string;
|
|
|
severity?: string | null;
|
|
|
+ score?: number | null;
|
|
|
status?: string;
|
|
|
title?: string | null;
|
|
|
content?: string | null;
|