paseo-req-kit 1.11.0 → 1.12.0-beta.3

package/engine/src/stats.ts

@@ -109,6 +109,35 @@ function waitKind(status: string): WaitKind {
   return "other";
 }
 
+/** Why runs stopped for a person (1.12, state.stopKind). */
+export const STOP_LABELS: Record<string, string> = {
+  approval: "确认方案",
+  phase_gate: "研发完成，等待测试",
+  business: "方案审核的问题等需求方决定",
+  reproduce: "缺陷复现不了，等需求方补充",
+  timeout: "步骤超时",
+  agent_error: "agent 报错",
+  invalid_result: "结果文件无效",
+  transient: "限流、网络等临时错误（自动重试用完）",
+  stopped: "被手动停止",
+  process_exit: "后台进程意外退出",
+  other: "其他中断",
+};
+
+/** Stops that are the decisions people are meant to make; the rest are what 1.12 works to remove. */
+export const NECESSARY_STOPS = ["approval", "phase_gate"];
+
+/** The stop code of a run; older records (before 1.12) are inferred from the status. */
+export function stopKindOf(r: RunRecord): string | null {
+  if (r.run.stopKind !== undefined) return r.run.stopKind;
+  if (r.run.status === "waiting_for_approval") return "approval";
+  if (r.run.status === "waiting_for_business") return "business";
+  if (r.run.status === "phase_done") return "phase_gate";
+  if (r.run.status === "failed") return /手动停止|被 SIG/.test(r.run.stopReason ?? "") ? "stopped" : "other";
+  if (r.run.status === "running") return "process_exit";
+  return null;
+}
+
 /** Records of the same run seen twice (merged exports) count once. */
 export function dedupe(runs: RunRecord[]): RunRecord[] {
   const seen = new Map<string, RunRecord>();
@@ -208,6 +237,19 @@ export interface StatsSummary {
   waits: Array<{ kind: WaitKind; label: string; requirements: number; averageMinutes: number }>;
   usage: { agentMinutes: number; inputTokens: number | null; outputTokens: number | null; costUsd: number | null };
   byBuilder: Array<{ builder: string; requirements: number; averageReviewRounds: number | null; averageCostUsd: number | null }>;
+  /** 1.12: why the period's runs stopped for a person, most frequent first. */
+  stops: Array<{ kind: string; label: string; necessary: boolean; runs: number }>;
+  /** 1.12: how much went without a person. */
+  automation: {
+    /** Of the requirements that reached testing (or completion) in the period, the share with no stop other than the necessary ones. */
+    unattendedShare: number | null;
+    /** Problems the pipeline handled by itself in the period's runs, by kind. */
+    recovered: Record<string, number>;
+    /** Runs that ended in an interruption (not a necessary decision). */
+    interrupted: number;
+    /** recovered / (recovered + interrupted). */
+    autoRecoveryShare: number | null;
+  };
   /** Requirements that started from cards, by who asked for them (1.10); empty when there are none. */
   byRequester: Array<{ requester: string; requirements: number; completed: number; medianCycleHours: number | null }>;
   requirements: RequirementStats[];
@@ -257,6 +299,24 @@ export function summarizeRuns(all: RunRecord[], period: Period): StatsSummary {
   const requesters = new Map<string, RequirementStats[]>();
   for (const q of active) if (q.card) requesters.set(q.requester ?? "（未记录）", [...(requesters.get(q.requester ?? "（未记录）") ?? []), q]);
 
+  const stopCounts = count(periodRuns.flatMap((r) => (stopKindOf(r) ? [stopKindOf(r)!] : [])));
+  const recovered: Record<string, number> = {};
+  for (const r of periodRuns) for (const [k, v] of Object.entries(r.run.recoveries ?? {})) recovered[k] = (recovered[k] ?? 0) + v;
+  const recoveredTotal = Object.values(recovered).reduce((a, b) => a + b, 0);
+  const interrupted = periodRuns.filter((r) => {
+    const k = stopKindOf(r);
+    return k !== null && !NECESSARY_STOPS.includes(k) && k !== "business" && k !== "reproduce";
+  }).length;
+  const reachedTesting = active.filter((q) => q.status === "completed" || q.status === "phase_done");
+  const unattended = reachedTesting.filter((q) =>
+    runs
+      .filter((r) => r.requirement.key === q.key && r.requirement.project === q.project)
+      .every((r) => {
+        const k = stopKindOf(r);
+        return k === null || NECESSARY_STOPS.includes(k);
+      }),
+  );
+
   return {
     schema: 1,
     period: { from: period.from?.toISOString() ?? null, to: period.to?.toISOString() ?? null, label: period.label },
@@ -287,6 +347,15 @@ export function summarizeRuns(all: RunRecord[], period: Period): StatsSummary {
       averageReviewRounds: avg(qs.map((q) => q.reviewRounds)),
       averageCostUsd: avg(qs.flatMap((q) => (q.costUsd === null ? [] : [q.costUsd]))),
     })),
+    stops: Object.entries(stopCounts)
+      .map(([kind, n]) => ({ kind, label: STOP_LABELS[kind] ?? kind, necessary: NECESSARY_STOPS.includes(kind), runs: n }))
+      .sort((a, b) => b.runs - a.runs || a.kind.localeCompare(b.kind)),
+    automation: {
+      unattendedShare: reachedTesting.length === 0 ? null : Math.round((unattended.length / reachedTesting.length) * 100) / 100,
+      recovered,
+      interrupted,
+      autoRecoveryShare: recoveredTotal + interrupted === 0 ? null : Math.round((recoveredTotal / (recoveredTotal + interrupted)) * 100) / 100,
+    },
     byRequester: [...requesters.entries()]
       .map(([requester, qs]) => {
         const finished = qs.filter((q) => done.includes(q));
@@ -349,6 +418,27 @@ export function describeStats(s: StatsSummary): string {
     `- 需要缺陷修复的需求占比：${s.rework.withDefectRounds === null ? "无数据" : `${Math.round(s.rework.withDefectRounds * 100)}%`}`,
     `- 质量门：运行 ${s.rework.gateRuns} 次，其中发现新失败 ${s.rework.gateFailed} 次`,
   );
+  const RECOVERY_LABELS: Record<string, string> = {
+    retry: "临时错误重试",
+    reattach: "接着等还在做的 agent",
+    reuse_result: "沿用旧 agent 的结果",
+    extend_timeout: "超时后多等一轮",
+    redo: "新开 agent 重做",
+    fallback: "换备用模型",
+    auto_resume: "自动继续",
+    quota_wait: "等额度恢复后继续",
+  };
+  lines.push(
+    "",
+    "## 人工介入",
+    "",
+    `- 到达提测（或完成）的需求中，除了确认方案外没有停下等人的：${s.automation.unattendedShare === null ? "无数据" : `${Math.round(s.automation.unattendedShare * 100)}%`}`,
+    `- 自动处理的问题 ${Object.values(s.automation.recovered).reduce((a, b) => a + b, 0)} 次（${list(s.automation.recovered, RECOVERY_LABELS)}），中断等人 ${s.automation.interrupted} 次${s.automation.autoRecoveryShare === null ? "" : `，自动处理的比例 ${Math.round(s.automation.autoRecoveryShare * 100)}%`}`,
+  );
+  if (s.stops.length > 0) {
+    lines.push("", "| 停下等人的原因 | 次数 | 必要的决定 |", "| --- | --- | --- |");
+    for (const st of s.stops) lines.push(`| ${st.label} | ${st.runs} | ${st.necessary ? "是" : "否"} |`);
+  }
   if (s.waits.length > 0) {
     lines.push("", "## 等待", "", "| 等待 | 需求数 | 平均 |", "| --- | --- | --- |");
     for (const w of s.waits) lines.push(`| ${w.label} | ${w.requirements} | ${hours(w.averageMinutes)} |`);

package/engine/src/steps.ts

@@ -132,7 +132,10 @@ export const STEPS: Record<StepId, StepDef> = {
     title: "方案修订",
     role: "builder",
     promptFile: "04b-design-revise.md",
-    result: { required: done.required, optional: { slices: { kind: "string[]" }, files: { kind: "string[]" }, ui_change: { kind: "boolean" } } },
+    result: {
+      required: done.required,
+      optional: { slices: { kind: "string[]" }, files: { kind: "string[]" }, ui_change: { kind: "boolean" }, business_questions: { kind: "string[]" } },
+    },
   },
   implement: {
     id: "implement",

package/install.mjs

@@ -9,6 +9,7 @@
 //   node install.mjs --prune                 list old version directories that can be deleted
 //   node install.mjs --uninstall             remove the skills req-kit installed (keeps ~/.req-kit)
 //   node install.mjs --configure             configuration wizard: pick the agents from what Paseo offers
+//   node install.mjs --configure --auto      the same without questions: the recommended agents (1.12)
 //   node install.mjs --upgrade [version]     download a version (default: the newest) next to this one,
 //                                            install its dependencies and switch to it
 //   node install.mjs --latest                print the newest published version
@@ -47,6 +48,9 @@ const { values, positionals } = parseArgs({
   allowPositionals: true,
   options: {
     configure: { type: "boolean", default: false },
+    auto: { type: "boolean", default: false },
+    "catalog-json": { type: "boolean", default: false },
+    set: { type: "string" },
     upgrade: { type: "boolean", default: false },
     latest: { type: "boolean", default: false },
     from: { type: "string" },
@@ -844,7 +848,7 @@ function configureCommand() {
     console.error(`依赖未安装：在 ${KIT_ROOT} 中执行 npm install 后再运行配置向导。`);
     return 1;
   }
-  const result = spawnSync(process.execPath, [tsx, path.join(KIT_ROOT, "engine", "src", "configure.ts"), "--config", CONFIG], {
+  const result = spawnSync(process.execPath, [tsx, path.join(KIT_ROOT, "engine", "src", "configure.ts"), "--config", CONFIG, ...(values.auto ? ["--auto"] : []), ...(values["catalog-json"] ? ["--catalog-json"] : []), ...(values.set !== undefined ? ["--set", values.set] : [])], {
     stdio: "inherit",
     windowsHide: true,
   });

package/notifiers/im-template.mjs

@@ -9,7 +9,9 @@
 //            "options": { "webhook": "https://im.example.internal/hook/xxxx" } }
 //        ]
 //      module 可以是绝对路径、"~/" 开头的路径，或相对配置文件所在目录的路径。
-//      events 不写时发送全部事件：milestone、blocked、permission、failed、completed、phase_done、approval、digest。
+//      events 不写时发送全部事件：milestone、blocked、permission、failed、completed、phase_done、approval、digest、alert。
+//      按人发送（1.12）：在本机或团队配置中写上姓名到账号的对应，event.people.recipients 中就会带上账号：
+//        "people": { "张广祥": { "um": "ZHANGGX001" } }
 //   3. 在终端运行 `req notify-test`（或 `req notify-test --type blocked`）发一条测试通知，不需要运行流水线。
 //
 // 约定（详见 contracts/notifier-event.md）：
@@ -32,19 +34,40 @@ export default async function notify(event, options) {
     digest: "需求总览",
     phase_done: "研发完成，可以提测",
     approval: "请确认方案",
+    alert: "接单器告警",
   }[event.type] ?? event.type;
 
   // 一条通用的纯文本消息，大多数 IM 机器人都能直接使用。
   // 需求总览（digest）的 text 已经是完整的多行文字。
-  const lines = event.type === "digest" ? [event.text] : [`【req-kit · ${title}】${event.feature.title}`, event.text];
+  const lines = event.type === "digest" || event.type === "alert" ? [event.type === "alert" ? `【req-kit · ${title}】${event.text}` : event.text] : [`【req-kit · ${title}】${event.feature.title}`, event.text];
   if (event.type === "completed" && event.details.summary) lines.push("", String(event.details.summary));
   if (event.type === "phase_done") lines.push("", `提测说明：${event.details.handoffPath}`);
   if (event.type === "approval") lines.push("", `要确认的内容：${event.details.previewPath}`);
   if (event.type === "blocked") lines.push("", ...event.details.questions.map((q, i) => `${i + 1}. ${q}`));
-  if (event.type !== "digest") lines.push("", `需求目录：${event.feature.dir}${event.branch ? `（分支 ${event.branch}）` : ""}`);
+  if (event.people?.card) lines.push("", `卡片：${event.people.card.system} ${event.people.card.id}${event.people.card.url ? ` ${event.people.card.url}` : ""}`);
+  if (event.type !== "digest" && event.type !== "alert") lines.push("", `需求目录：${event.feature.dir}${event.branch ? `（分支 ${event.branch}）` : ""}`);
   const text = lines.join("\n");
 
-  // TODO：按企业内部 IM 的接口实现发送。例如一个接收 JSON 的群机器人：
+  // 发给谁（1.12）：需要需求方处理的事和结果（blocked、approval、phase_done、completed），
+  // 在需求从卡片开始时 audience 为 "requester"，recipients 是需求方本人和他在 people 配置中的账号；
+  // 其余事件（进展、中断、接单器告警）audience 为 "team"，发到群里。
+  const people = event.people ?? { audience: "team", recipients: [] };
+  const toPerson = people.audience === "requester" && people.recipients.some((r) => Object.keys(r.accounts).length > 0);
+
+  // TODO：按企业内部 IM 的接口实现发送。例如按人发送：
+  //
+  // if (toPerson) {
+  //   for (const r of people.recipients) {
+  //     await fetch(String(options.personApi), {
+  //       method: "POST",
+  //       headers: { "Content-Type": "application/json", Authorization: `Bearer ${process.env.MY_IM_TOKEN}` },
+  //       body: JSON.stringify({ to: r.accounts.um, text }),
+  //     });
+  //   }
+  //   return;
+  // }
+  //
+  // 或者一个接收 JSON 的群机器人：
   //
   // const response = await fetch(String(options.webhook), {
   //   method: "POST",
@@ -55,6 +78,9 @@ export default async function notify(event, options) {
   //
   // 还没有实现时，先什么也不做（流水线日志中会记录"外部通知已发送"）。
   // 用 req notify-test 测试时，把将要发送的内容打印出来，方便核对排版。
-  if (process.env.REQ_KIT_NOTIFY_TEST === "1") console.log(`--- 将要发送的内容 ---\n${text}\n---------------------`);
+  if (process.env.REQ_KIT_NOTIFY_TEST === "1") {
+    const to = toPerson ? people.recipients.map((r) => `${r.name}（${Object.entries(r.accounts).map(([k, v]) => `${k} ${v}`).join("，")}）`).join("、") : people.audience === "requester" ? `${people.recipients.map((r) => r.name).join("、")}（people 配置中没有账号，改发到群）` : "群";
+    console.log(`--- 将要发送的内容（发给：${to}）---\n${text}\n---------------------`);
+  }
   void options;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paseo-req-kit",
-  "version": "1.11.0",
+  "version": "1.12.0-beta.3",
   "description": "req-kit: a requirement-development workflow for Paseo. /req aligns a requirement in chat; the engine runs design, implementation, review and verification as Paseo agents.",
   "type": "module",
   "license": "MIT",
@@ -31,7 +31,7 @@
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "test": "node --import tsx --import ./engine/test/isolate.ts --test --test-concurrency=1 engine/test/*.test.ts test/*.test.ts",
+    "test": "node --import tsx --import ./engine/test/isolate.ts --test --test-concurrency=1 --test-timeout=300000 engine/test/*.test.ts test/*.test.ts",
     "smoke": "tsx engine/src/smoke-test.ts",
     "doctor": "node bin/req-doctor.mjs",
     "eval": "tsx engine/src/eval.ts",

package/paseo-plugin/OVERVIEW.md

@@ -2,6 +2,8 @@ req-kit 的需求在 Paseo 里的样子：本机所有项目的需求一页看
 
 需要人处理的时候，可以直接在这里确认方案、停止、继续或开始测试验证。这些操作和在终端运行 `req approve`、`req stop`、`req resume`、`req verify` 完全一样，流水线本身不受插件影响；不想让人在网页上操作时，在插件设置中打开"只读"。
 
+在插件设置的"模型"一页，可以从 Paseo 中已登录的 agent 里选择 builder、reviewer 和备用模型，保存到 req-kit 的本机配置，和在终端运行 `req configure` 一样。
+
 还有：侧边栏的"需求"（带待处理数）、每个工作区头部的"需求"按钮和面板、步骤 agent 输入框旁的"需求"按钮，以及使用统计（交付周期、返工、等待、用量）。
 
 需要这台 daemon 上安装 req-kit 1.9 或更新的版本，插件通过本机的 `req api` 读取需求；它不连接任何外部服务。用 `req plugin install` 安装和更新。

package/paseo-plugin/client/config.tsx

@@ -0,0 +1,216 @@
+// "req-kit 配置" (1.12): every setting that applies, in plain words, with where each one comes
+// from (default, this machine, the team, the project) and how to change it. Read-only: changes
+// go through the files, req configure, /req-setup, or the model settings page.
+import type { PluginHostProps, PluginScreenProps } from "@getpaseo/plugin/client";
+import { ScrollView, TextInput } from "@getpaseo/plugin/client/react-native";
+import { useMemo, useState } from "react";
+import { Pressable, Text, View } from "react-native";
+import type { ConfigItemData, ConfigLayer, ConfigViewData } from "../shared/contracts";
+import { useConfigView, useRequirements } from "./data";
+import { Badge, Chip, Status, useStyles } from "./ui";
+
+type Theme = PluginHostProps["theme"];
+type Layout = PluginHostProps["layout"];
+
+const LAYER: Record<ConfigLayer, { label: string; tone: "accent" | "success" | "warning"; hint: string }> = {
+  machine: { label: "本机", tone: "accent", hint: "这台机器自己的设置" },
+  team: { label: "团队", tone: "warning", hint: "团队共用的配置，覆盖本机的同名设置" },
+  project: { label: "项目", tone: "success", hint: "项目仓库中的设置，覆盖本机和团队的" },
+};
+
+const SCOPE_NOTE: Record<ConfigItemData["scope"], string | null> = {
+  any: null,
+  machine: "只能在本机配置中设置",
+  machine_team: "只能在本机或团队配置中设置（会运行命令或发消息）",
+};
+
+/** Where an item's value comes from: the last file that set it to something other than the default. */
+function originOf(item: ConfigItemData): ConfigLayer | null {
+  return item.changed ? (item.setBy.at(-1) ?? null) : null;
+}
+
+function ItemRow({ theme, layout, item }: { theme: Theme; layout: Layout; item: ConfigItemData }) {
+  const s = useStyles(theme, layout.compact);
+  const [open, setOpen] = useState(false);
+  const origin = originOf(item);
+  const scope = SCOPE_NOTE[item.scope];
+  return (
+    <Pressable
+      accessibilityRole="button"
+      accessibilityLabel={`${item.label}：${item.display}`}
+      accessibilityState={{ selected: open }}
+      onPress={() => setOpen((v) => !v)}
+      style={{ paddingVertical: 10, gap: 4 }}
+    >
+      <View style={[s.row, { justifyContent: "space-between", flexWrap: "nowrap" }]}>
+        <Text style={[s.text, { fontWeight: "600", flexShrink: 1 }]}>{item.label}</Text>
+        {origin ? (
+          <Badge theme={theme} tone={LAYER[origin].tone}>
+            {LAYER[origin].label}
+          </Badge>
+        ) : (
+          <Badge theme={theme} tone="muted">
+            默认
+          </Badge>
+        )}
+      </View>
+      <Text style={s.text}>{item.display}</Text>
+      {item.description ? <Text style={s.muted}>{item.description}</Text> : null}
+      {open ? (
+        <View style={{ gap: 6, marginTop: 4 }}>
+          <Text style={s.muted}>
+            配置项 <Text style={{ fontFamily: "monospace", color: theme.colors.foreground }}>{item.key}</Text>
+            {item.setBy.length > 0 ? ` · 写在${item.setBy.map((l) => LAYER[l].label).join("、")}配置中` : " · 没有在任何配置文件中写，用的是默认值"}
+            {scope ? ` · ${scope}` : ""}
+          </Text>
+          <View style={{ backgroundColor: theme.colors.surface0, borderRadius: 8, borderWidth: 1, borderColor: theme.colors.border, padding: 10 }}>
+            <Text selectable style={{ fontFamily: "monospace", fontSize: 12, color: theme.colors.foreground }}>
+              {JSON.stringify(item.value, null, 2) ?? "null"}
+            </Text>
+          </View>
+        </View>
+      ) : null}
+    </Pressable>
+  );
+}
+
+function Sources({ theme, layout, view }: { theme: Theme; layout: Layout; view: ConfigViewData }) {
+  const s = useStyles(theme, layout.compact);
+  return (
+    <View style={[s.card, { gap: 8 }]}>
+      <Text style={s.heading}>配置从哪里来</Text>
+      <Text style={s.muted}>按下面的顺序叠加，后面的覆盖前面的；没有写的用 req-kit 的默认值。</Text>
+      {view.sources.length === 0 ? <Text style={s.text}>还没有本机配置文件。在终端运行 req setup 生成。</Text> : null}
+      {view.sources.map((src, i) => (
+        <View key={src.path} style={[s.row, { flexWrap: "nowrap", alignItems: "flex-start" }]}>
+          <Text style={[s.muted, { width: 18 }]}>{i + 1}.</Text>
+          <Badge theme={theme} tone={LAYER[src.layer].tone}>
+            {LAYER[src.layer].label}
+          </Badge>
+          <View style={{ flexShrink: 1, gap: 2 }}>
+            <Text selectable style={[s.text, { fontFamily: "monospace", fontSize: 12 }]}>
+              {src.path}
+            </Text>
+            <Text style={s.muted}>{LAYER[src.layer].hint}</Text>
+          </View>
+        </View>
+      ))}
+      {view.ignored.length > 0 ? <Text style={{ color: theme.colors.statusWarning, fontSize: 13 }}>没有生效：{view.ignored.join("、")}（这些设置不能写在团队或项目配置中）</Text> : null}
+    </View>
+  );
+}
+
+export function ConfigScreen({ theme, layout }: PluginScreenProps) {
+  const s = useStyles(theme, layout.compact);
+  const requirements = useRequirements();
+  // A project is any checkout requirements were started from.
+  const projects = useMemo(() => {
+    const map = new Map<string, string>();
+    for (const r of requirements.data ?? []) if (r.present) map.set(r.sourceRepo ?? r.repo, r.project);
+    return [...map.entries()].sort((a, b) => a[1].localeCompare(b[1]));
+  }, [requirements.data]);
+  const [repo, setRepo] = useState<string | null>(null);
+  const [query, setQuery] = useState("");
+  const [changedOnly, setChangedOnly] = useState(false);
+  const config = useConfigView(repo);
+  const view = config.data;
+
+  const groups = useMemo(() => {
+    if (!view) return [];
+    const q = query.trim().toLowerCase();
+    return view.groups
+      .map((g) => ({
+        ...g,
+        items: g.items.filter(
+          (i) => (!changedOnly || i.changed) && (!q || `${i.label} ${i.key} ${i.display} ${i.description}`.toLowerCase().includes(q)),
+        ),
+      }))
+      .filter((g) => g.items.length > 0);
+  }, [view, query, changedOnly]);
+  const changedCount = view ? view.groups.reduce((n, g) => n + g.items.filter((i) => i.changed).length, 0) : 0;
+
+  return (
+    <View style={s.screen}>
+      <ScrollView contentContainerStyle={s.body}>
+        <View style={{ gap: 4 }}>
+          <Text style={s.title}>req-kit 配置</Text>
+          <Text style={s.muted}>这台机器上生效的全部设置，用大白话写出每一项是什么、现在是什么、来自哪个文件。这一页只看不改，修改方法在最下面。</Text>
+        </View>
+
+        <View style={{ gap: 6 }}>
+          <Text style={s.heading}>看哪里的配置</Text>
+          <View style={s.row}>
+            <Chip theme={theme} label="本机（不含项目）" active={repo === null} onPress={() => setRepo(null)} />
+            {projects.map(([dir, name]) => (
+              <Chip key={dir} theme={theme} label={name} active={repo === dir} onPress={() => setRepo(dir)} />
+            ))}
+          </View>
+          {projects.length === 0 ? <Text style={s.muted}>开始过需求的项目会出现在这里，可以看到项目配置叠加后的结果。</Text> : null}
+        </View>
+
+        <Status theme={theme} loading={config.isPending} error={config.error} />
+        {view ? (
+          <>
+            {view.error ? (
+              <View style={[s.card, { borderColor: theme.colors.statusDanger }]}>
+                <Text style={[s.text, { color: theme.colors.statusDanger, fontWeight: "600" }]}>配置有错误，流水线现在无法启动</Text>
+                <Text style={s.text}>{view.error}</Text>
+                <Text style={s.muted}>下面显示的是各文件中写的值。修好后在终端运行 req doctor 检查。</Text>
+              </View>
+            ) : null}
+            <Sources theme={theme} layout={layout} view={view} />
+
+            <View style={{ gap: 8 }}>
+              <TextInput
+                value={query}
+                onChangeText={setQuery}
+                placeholder="搜索设置，例如：超时、备用模型、推送"
+                placeholderTextColor={theme.colors.foregroundMuted}
+                style={{
+                  paddingHorizontal: 12,
+                  paddingVertical: 8,
+                  borderRadius: 8,
+                  borderWidth: 1,
+                  borderColor: theme.colors.border,
+                  backgroundColor: theme.colors.surface1,
+                  color: theme.colors.foreground,
+                  fontSize: 14,
+                }}
+              />
+              <View style={s.row}>
+                <Chip theme={theme} label="全部" active={!changedOnly} onPress={() => setChangedOnly(false)} />
+                <Chip theme={theme} label={`只看改过的（${changedCount}）`} active={changedOnly} onPress={() => setChangedOnly(true)} />
+              </View>
+            </View>
+
+            {groups.length === 0 ? <Text style={s.muted}>{changedOnly && !query ? "所有设置都是默认值。" : "没有符合的设置。"}</Text> : null}
+            {groups.map((g) => (
+              <View key={g.id} style={{ gap: 6 }}>
+                <View style={{ gap: 2 }}>
+                  <Text style={[s.text, { fontSize: 15, fontWeight: "600" }]}>{g.title}</Text>
+                  <Text style={s.muted}>{g.description}</Text>
+                </View>
+                <View style={[s.card, { paddingVertical: 2 }]}>
+                  {g.items.map((item, i) => (
+                    <View key={item.key}>
+                      {i > 0 ? <View style={s.divider} /> : null}
+                      <ItemRow theme={theme} layout={layout} item={item} />
+                    </View>
+                  ))}
+                </View>
+              </View>
+            ))}
+
+            <View style={[s.card, { gap: 6 }]}>
+              <Text style={s.heading}>怎么修改</Text>
+              <Text style={s.text}>· 模型（builder、reviewer、备用模型）：设置 → 插件 → req-kit → 模型，或在终端运行 req configure。</Text>
+              <Text style={s.text}>· 项目的检查命令、服务启动方式、接哪些卡片：在项目的对话中运行 /req-setup。</Text>
+              <Text style={s.text}>· 其他设置：编辑上面"配置从哪里来"中的文件，写法见 req-kit 文档的《项目定制与运行规则》。改完运行 req doctor 检查。</Text>
+              <Text style={s.muted}>密码、令牌等看起来像密钥的值和个人账号不会在这里显示。</Text>
+            </View>
+          </>
+        ) : null}
+      </ScrollView>
+    </View>
+  );
+}

package/paseo-plugin/client/data.ts

@@ -1,7 +1,7 @@
 // Data hooks: every read is an RPC to the daemon side (req api), cached by React Query.
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { useRpc, useSettings } from "@getpaseo/plugin/client";
-import { fileRpc, listRpc, preferences, runRpc, statsRpc, statusRpc, versionRpc, type Action } from "../shared/contracts";
+import { configRpc, fileRpc, listRpc, modelsRpc, preferences, runRpc, setAgentsRpc, statsRpc, statusRpc, versionRpc, type Action, type AgentProfileData } from "../shared/contracts";
 
 export function usePreferences(): { readOnly: boolean; refreshMs: number } {
   const settings = useSettings(preferences);
@@ -49,7 +49,26 @@ export function useAction() {
   const run = useRpc(runRpc);
   const queries = useQueryClient();
   return useMutation({
-    mutationFn: (input: { action: Action; repo: string; featureDir: string; verifyEnv?: "local" | "deployed" }) => run(input),
+    mutationFn: (input: { action: Action; repo: string; featureDir: string; verifyEnv?: "local" | "deployed"; text?: string }) => run(input),
     onSettled: () => queries.invalidateQueries({ queryKey: ["req"] }),
   });
 }
+
+export function useModels() {
+  const models = useRpc(modelsRpc);
+  return useQuery({ queryKey: ["req", "models"], queryFn: () => models({}), retry: false });
+}
+
+export function useSetAgents() {
+  const set = useRpc(setAgentsRpc);
+  const queries = useQueryClient();
+  return useMutation({
+    mutationFn: (input: { builder: AgentProfileData; reviewer: AgentProfileData; fallback: AgentProfileData | null }) => set(input),
+    onSettled: () => queries.invalidateQueries({ queryKey: ["req", "models"] }),
+  });
+}
+
+export function useConfigView(repo: string | null) {
+  const config = useRpc(configRpc);
+  return useQuery({ queryKey: ["req", "config", repo ?? ""], queryFn: () => config(repo ? { repo } : {}), retry: false });
+}

package/paseo-plugin/client/format.ts

@@ -108,4 +108,5 @@ export const ACTION_TEXT = {
   resume: { label: "继续", confirm: "从中断处继续？需求说明改过的话，只处理变化的部分。" },
   verify: { label: "开始测试验证", confirm: "开始测试验证？选择在哪里验证。" },
   sync: { label: "同步到外部系统", confirm: "把这个需求同步到对接的外部系统：补发没有成功的调用、补建卡片、更新状态。" },
+  reply: { label: "发送回复", confirm: "把回复转给这个需求的对话，由它更新需求说明并继续开发。" },
 } as const;