Procházet zdrojové kódy

chore(dashboard-v6): 同步 API 类型(discussions 新增 assessment 与 score)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
visuddhinanda před 21 hodinami
rodič
revize
04149e0417
1 změnil soubory, kde provedl 45 přidání a 19 odebrání
  1. 45 19
      dashboard-v6/src/api/schema.d.ts

+ 45 - 19
dashboard-v6/src/api/schema.d.ts

@@ -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;