ADR-0013 切片 3 第 13 + 12 项：跑完的任务里，追问可以直接变成一轮修改，终态不再是死路。modeling-workspace-api 新增 postRunRevision(runId, text) 与回执类型 RunRevisionReceipt（run_id/round/approval_id/suggested_stage/note_id），并导出 RUN_REVISION_TEXT_LIMIT=2000 与服务端 RunRevisionInput.text 的 max_length 对齐。openmathmodel-ui：postRunNote 撞 409 RUN_FINISHED 时那条 info 行不再是死路——原文案「运行已到终态……请基于此任务再发起一次新任务」在切片 2 落地后已经是错话，改为如实说明「若这次运行是正常完成的，可以按这条要求发起一轮修改」，并由新函数 offerRevisionCta 在该行下挂一个真按钮「按这条要求继续修改」。四处取舍：一、按钮只调 /revisions，它只做重开运行、落 global 备注、挂审批门三件事，真正的重跑与花费要等用户在审批门里再确认一次，所以这个按钮不会偷偷扣钱——CSS 上也刻意用次级按钮而非主行动色，不让它看起来像「点了就开跑」；二、落盘的轨迹行不带按钮，按钮是活的 DOM、刷新后点不了，历史里只留一句刷新后仍然成立的说明，成功后只改活的 DOM、不回改已推进 traceLog 的记录；三、正文超过 2000 字直接不给按钮并当场说清「这条有 N 字、上限 2000、请精简后重发」，而不是让用户点一下换回一个 422；四、成功文案不重复报服务端建议的起点，起点以审批门里的选项为准（第 15 项刚把那句话写全），两处各说一遍容易打架，审批门本身经 SSE 的 approval.requested 自己会出现，前端不手动刷新。三种 409 分别给话：RUN_NOT_COMPLETED（失败或已取消的运行没有修订入口）、REVISION_LIMIT_REACHED（三轮用尽请另起新任务）、其余错误恢复按钮并弹 toast 让用户重试。workflow-refresh.css 新增 .stream-cta（复用 .stream-detail 卡片底座，按钮走次级样式，含深色主题）；en-US 补一条 toast 词条。验证：npm run check（app+node 两套 tsc + eslint）过、node --test 62/62、四个改动文件 lint 干净。如实备案：web 包没有 DOM 测试栈，这条 CTA 的点击路径（按钮→/revisions→三种 409 分支）本批未经真实浏览器验收，目前只有类型与静态核对作门槛；服务端那一侧由 test_run_revisions.py 覆盖

Author: IvanCodesDev

apps/web/src/i18n/en-US.ts

@@ -384,6 +384,7 @@ const TASK_RUNNING: Record<string, string> = {
   "回复生成中断": "Reply interrupted",
   "回复仍在生成中…": "Reply still generating…",
   "回复生成中断，请重新发送。": "Reply generation was interrupted; please send it again.",
+  "发起修改失败，请稍后重试": "Could not start the revision; please try again",
   "暂停生成": "Stop generating",
   "已暂停生成": "Generation stopped",
   "已暂停生成。": "Generation stopped.",

apps/web/src/integration/modeling-workspace-api.ts

@@ -89,6 +89,21 @@ export interface TaskIntakeResult {
   source: "heuristic" | "judge" | "fallback";
 }
 
+/** POST /task-runs/{id}/revisions 的受理回执（ADR-0013）。
+ *  `suggested_stage` 是服务端建议的重做起点，已作为审批门里唯一的 recommended 项；
+ *  最终起点由用户在审批门拍板，本回执只负责把人带到那道门前。 */
+export interface RunRevisionReceipt {
+  run_id: string;
+  round: number;
+  approval_id: string;
+  suggested_stage: string;
+  note_id: string;
+}
+
+/** 修改要求正文上限，与服务端 RunRevisionInput.text 的 max_length 对齐；
+ *  超长在前端就拦下来，别等服务端回 422 才告诉用户白写了。 */
+export const RUN_REVISION_TEXT_LIMIT = 2000;
+
 /** GET /task-runs/{id}/stage-outputs：五类页面正文（未产出的阶段为 null）。 */
 export interface StageOutputsPayload {
   run_id: string;
@@ -253,6 +268,26 @@ export const modelingWorkspaceApi = {
     });
   },
 
+  /** 对已完成的运行提出修改要求（ADR-0013）：重开运行并挂审批门等用户确认重做起点。
+   *  本接口只受理不推进——真正重跑要等用户在审批门里选定起点。
+   *  409 分三种：RUN_NOT_COMPLETED（运行还没跑完）、REVISION_LIMIT_REACHED（三轮已满）、
+   *  以及 /notes 那边的 RUN_FINISHED（终态但不是 COMPLETED，如失败/取消），调用方分别给话。 */
+  postRunRevision(
+    runId: string,
+    text: string,
+    signal?: AbortSignal,
+  ): Promise<RunRevisionReceipt> {
+    return request<RunRevisionReceipt>(
+      `/api/v1/task-runs/${encodeURIComponent(runId)}/revisions`,
+      {
+        method: "POST",
+        signal,
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ text }),
+      },
+    );
+  },
+
   act(runId: string, input: TaskRunActionInput, signal?: AbortSignal): Promise<unknown> {
     const idempotencyKey = input.client_token ?? crypto.randomUUID().replaceAll("-", "");
     return request(`/api/v1/task-runs/${encodeURIComponent(runId)}/actions`, {

apps/web/src/legacy/openmathmodel-ui.ts

@@ -69,7 +69,7 @@ import {
   syncPrivacyGatesOnce,
 } from "../preferences/privacy-preferences";
 import { mountModelingWorkspace } from "../integration/modeling-workspace-controller";
-import { WorkspaceApiError, modelingWorkspaceApi } from "../integration/modeling-workspace-api";
+import { RUN_REVISION_TEXT_LIMIT, WorkspaceApiError, modelingWorkspaceApi } from "../integration/modeling-workspace-api";
 import { mountSidebarSearch } from "../integration/sidebar-search";
 import { hydrateRecentTasks } from "../integration/recent-tasks";
 import { hydrateProjectsPage } from "../integration/projects-page";
@@ -3447,6 +3447,58 @@ import { mountTaskAutosave } from "../tasks/task-autosave";
     };
   }
 
+  /** 已完成的运行撞上 409 时挂一个「按这条要求继续修改」的按钮（ADR-0013 第 12 项）。
+   *
+   *  点它只是**受理**：服务端重开运行、落一条 global 备注、挂起审批门等用户选定重做
+   *  起点——真正的重跑与花费要等审批门里那一下，所以这个按钮本身不会偷偷扣钱。
+   *  三种 409 分别给话：非正常完成的运行（失败/取消）没有修订入口，三轮用尽要另起新任务。
+   */
+  function offerRevisionCta(handle, runId, text) {
+    if (!handle?.element) return;
+    const host = document.createElement("div");
+    host.className = "stream-detail stream-cta";
+    handle.element.append(host);
+
+    const settleAs = message => {
+      host.replaceChildren(Object.assign(document.createElement("span"), { textContent: message }));
+    };
+
+    // 服务端 RunRevisionInput.text 卡 2000 字。超长就不给按钮：与其让用户点一下
+    // 换回一个 422，不如当场说清为什么点不了、要怎么办。
+    if (text.length > RUN_REVISION_TEXT_LIMIT) {
+      settleAs(`这条消息有 ${text.length} 字，超过修改要求的 ${RUN_REVISION_TEXT_LIMIT} 字上限；请精简成一条明确的修改要求后重新发送。`);
+      return;
+    }
+
+    const button = document.createElement("button");
+    button.type = "button";
+    button.textContent = "按这条要求继续修改";
+    host.append(button);
+
+    button.addEventListener("click", async () => {
+      if (button.disabled) return;
+      button.disabled = true;
+      button.textContent = "正在受理…";
+      try {
+        const receipt = await modelingWorkspaceApi.postRunRevision(runId, text);
+        // 重做起点由审批门里的选项说了算，这里不重复报建议值（免得两处措辞打架）；
+        // 审批门本身会经 SSE 的 approval.requested 自己出现，无需前端手动刷新。
+        settleAs(`已受理第 ${receipt.round} 轮修改：请在待确认事项中选定重做起点后生效。`);
+      } catch (error) {
+        const code = error instanceof WorkspaceApiError ? error.code : "";
+        if (code === "RUN_NOT_COMPLETED") {
+          settleAs("这次运行不是正常完成的（失败或已取消），没有修改入口；请基于当前结果新建任务。");
+        } else if (code === "REVISION_LIMIT_REACHED") {
+          settleAs("本次运行的修改轮数已用完（上限 3 轮）；如仍需调整，请基于当前结果新建任务。");
+        } else {
+          button.disabled = false;
+          button.textContent = "按这条要求继续修改";
+          toast(t("发起修改失败，请稍后重试"));
+        }
+      }
+    });
+  }
+
   /** 回复右下角操作区：复制原始回复文本（Markdown 源码，便于粘贴到论文与笔记）。 */
   function appendReplyActions(replyBlock, replyText) {
     const actions = document.createElement("div");
@@ -3624,13 +3676,17 @@ import { mountTaskAutosave } from "../tasks/task-autosave";
           await modelingWorkspaceApi.postRunNote(noteScope.runId, text);
         } catch (error) {
           if (error instanceof WorkspaceApiError && error.code === "RUN_FINISHED") {
+            // 终态不再是死路（ADR-0013）：已完成的运行可以按这条要求真正返工。
+            // 落盘的这行只写「本轮发生了什么」——按钮是活的 DOM，重开页面点不了，
+            // 所以历史里不留会骗人的按钮，只留一句仍然成立的说明。
             const row = {
               icon: "info",
               title: "任务已结束，本条按问答处理",
-              detail: "运行已到终态，消息不再影响执行与成果；如需按新要求修改，请基于此任务再发起一次新任务。",
+              detail: "运行已到终态，这条消息不再影响执行与成果；若这次运行是正常完成的，可以按这条要求发起一轮修改——重开运行后需要你选定从哪个阶段重做。",
             };
-            appendReplyTraceRow(replyBlock, row);
+            const handle = appendReplyTraceRow(replyBlock, row);
             traceLog.push(row);
+            offerRevisionCta(handle, noteScope.runId, text);
           }
           // 网络抖动等其它失败不打断对话本身，也不渲染误导性的成功行
         }

apps/web/src/workflow-refresh.css

@@ -3757,8 +3757,35 @@ html[data-reduce-motion="on"] .assistant-block-reveal { animation: none; }
 }
 html[data-theme="dark"] .stream-narration { color: #d0d0ca; }
 html[data-theme="dark"] .stream-row { color: #b9b9b2; }
+/* 终态运行的「按这条要求继续修改」入口（ADR-0013 第 12 项）：过程行下挂一个真按钮。
+   点它只是受理修订、真正重跑与花费仍要在审批门里再确认一次，所以用低调的次级按钮，
+   不给主行动色——避免看起来像「点了就开跑」。 */
+.stream-cta {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  color: #6d6d67;
+  font-size: 13px;
+  line-height: 1.75;
+}
+.stream-cta button {
+  height: 30px;
+  padding: 0 14px;
+  flex: 0 0 auto;
+  border: 1px solid #dcdcd8;
+  border-radius: 8px;
+  color: #22221f;
+  background: #fff;
+  font-size: 13px;
+  cursor: pointer;
+}
+.stream-cta button:hover:not(:disabled) { border-color: #bcbcb6; background: #f4f4f1; }
+.stream-cta button:disabled { color: #9a9a95; cursor: default; }
 html[data-theme="dark"] .stream-detail { border-color: #3a3a37; background: #262624; }
 html[data-theme="dark"] .stream-detail pre { color: #a8a8a1; }
+html[data-theme="dark"] .stream-cta { color: #a8a8a1; }
+html[data-theme="dark"] .stream-cta button { border-color: #45453f; color: #d8d8d2; background: #2e2e2c; }
+html[data-theme="dark"] .stream-cta button:hover:not(:disabled) { border-color: #56564f; background: #383835; }
 html[data-reduce-motion="on"] .stream-in,
 html[data-reduce-motion="on"] .stream-item.is-waiting .stream-row > i { animation: none; }
 html[data-reduce-motion="on"] .stream-title.title-shine-once {