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

package/paseo-plugin/client/inbox.tsx

@@ -0,0 +1,173 @@
+// "等你处理" (1.12): everything that is waiting for a person, at the top, each with what to do and
+// how long it has waited. Answers and plan confirmations can be given right here: an answer is
+// passed to the requirement's chat (req reply), the same as typing it there.
+import type { PluginHostProps } from "@getpaseo/plugin/client";
+import { TextInput, useToast } from "@getpaseo/plugin/client/react-native";
+import { useState } from "react";
+import { Text, View } from "react-native";
+import type { Attention, Requirement } from "../shared/contracts";
+import { useAction, usePreferences } from "./data";
+import { facts } from "./format";
+import { Badge, Button, useStyles } from "./ui";
+
+type Theme = PluginHostProps["theme"];
+type Layout = PluginHostProps["layout"];
+
+const KIND: Record<Exclude<Attention, null>, { label: string; tone: "warning" | "danger" | "muted"; todo: string }> = {
+  approval: { label: "确认方案", tone: "warning", todo: "方案已通过审核。看一下“做完后会看到什么”，没问题就确认，开始写代码；要改就写下来。" },
+  business: { label: "回答问题", tone: "warning", todo: "方案审核有问题只有你能决定，回答后开发会接着进行。" },
+  interrupted: { label: "已中断", tone: "danger", todo: "开发中断了，自动处理没能解决。看一下原因，能继续就继续。" },
+  not_completed: { label: "没有完成", tone: "muted", todo: "流水线结束了，但有部分没有做完。完成报告里写了原因和建议。" },
+};
+
+/** Plain waiting time: "等了 3 小时". */
+export function waited(since: string, now = Date.now()): string {
+  const m = (now - Date.parse(since)) / 60_000;
+  if (!Number.isFinite(m) || m < 1) return "刚刚";
+  if (m < 60) return `等了 ${Math.round(m)} 分钟`;
+  if (m < 48 * 60) return `等了 ${Math.round(m / 60)} 小时`;
+  return `等了 ${Math.round(m / 60 / 24)} 天`;
+}
+
+/** Longest-waiting first: the oldest decision is the one holding things up most. */
+export function inboxItems(items: Requirement[]): Requirement[] {
+  return items
+    .filter((r) => r.attention)
+    .sort((a, b) => (a.waiting?.since ?? a.updatedAt).localeCompare(b.waiting?.since ?? b.updatedAt));
+}
+
+function InboxCard({ theme, layout, item, open, readOnly }: { theme: Theme; layout: Layout; item: Requirement; open(): void; readOnly: boolean }) {
+  const s = useStyles(theme, layout.compact);
+  const run = useAction();
+  const toast = useToast();
+  const [writing, setWriting] = useState(item.attention === "business");
+  const [text, setText] = useState("");
+  const kind = KIND[item.attention!];
+  const w = item.waiting;
+  const repo = item.sourceRepo ?? item.repo;
+
+  const act = async (action: "approve" | "resume" | "reply") => {
+    try {
+      const result = await run.mutateAsync({ action, repo, featureDir: item.featureDir, ...(action === "reply" ? { text } : {}) });
+      const first = result.message.split("\n").find((l) => l.trim()) ?? "";
+      if (result.ok) {
+        toast.show(first || "已完成", { variant: "success", durationMs: 4000 });
+        setText("");
+      } else toast.error(first || "没有完成");
+    } catch (error) {
+      toast.error((error as Error).message);
+    }
+  };
+
+  return (
+    <View style={[s.card, { gap: 10, borderLeftWidth: 3, borderLeftColor: kind.tone === "danger" ? theme.colors.statusDanger : kind.tone === "warning" ? theme.colors.statusWarning : theme.colors.border }]}>
+      <View style={[s.row, { justifyContent: "space-between" }]}>
+        <View style={[s.row, { flexShrink: 1 }]}>
+          <Badge theme={theme} tone={kind.tone}>
+            {kind.label}
+          </Badge>
+          <Text style={[s.text, { fontWeight: "600", flexShrink: 1 }]}>{item.title}</Text>
+        </View>
+        <Text style={s.muted}>{waited(w?.since ?? item.updatedAt)}</Text>
+      </View>
+      <Text style={s.muted}>
+        {facts(item)}
+        {w?.card ? ` · 卡片 ${w.card.system} ${w.card.id}${w.card.requester ? `（${w.card.requester}）` : ""}` : ""}
+      </Text>
+      <Text style={s.text}>{kind.todo}</Text>
+
+      {item.attention === "business" && w && w.questions.length > 0 ? (
+        <View style={{ gap: 4 }}>
+          {w.questions.map((q, i) => (
+            <Text key={i} style={s.text}>
+              {i + 1}. {q}
+            </Text>
+          ))}
+        </View>
+      ) : null}
+      {item.attention === "interrupted" && w?.reason ? (
+        <Text style={s.danger} numberOfLines={4}>
+          {w.reason}
+        </Text>
+      ) : null}
+
+      {readOnly ? (
+        <View style={s.row}>
+          <Button theme={theme} label="查看详情" onPress={open} />
+          <Text style={s.muted}>插件设置为只读，请在对话中处理</Text>
+        </View>
+      ) : (
+        <>
+          {writing && w?.canReply ? (
+            <View style={{ gap: 8 }}>
+              <TextInput
+                value={text}
+                onChangeText={setText}
+                multiline
+                placeholder={item.attention === "approval" ? "写下要改的地方，例如：按钮放在右上角" : w.questions.length > 1 ? "按编号回答，例如：1. 只有新订单显示  2. 不需要" : "写下你的回答"}
+                placeholderTextColor={theme.colors.foregroundMuted}
+                style={{
+                  minHeight: 72,
+                  padding: 10,
+                  borderRadius: 8,
+                  borderWidth: 1,
+                  borderColor: theme.colors.border,
+                  backgroundColor: theme.colors.surface0,
+                  color: theme.colors.foreground,
+                  fontSize: 14,
+                  textAlignVertical: "top",
+                }}
+              />
+              {w.card ? <Text style={s.muted}>也可以在卡片的“需求方回复”区回答，效果一样。</Text> : null}
+            </View>
+          ) : null}
+          <View style={s.row}>
+            {item.attention === "approval" ? (
+              <>
+                <Button theme={theme} primary label={run.isPending ? "正在执行…" : "确认方案"} disabled={run.isPending} onPress={() => void act("approve")} />
+                {w?.canReply ? (
+                  writing ? (
+                    <Button theme={theme} label="发送修改意见" disabled={run.isPending || !text.trim()} onPress={() => void act("reply")} />
+                  ) : (
+                    <Button theme={theme} label="提修改意见" onPress={() => setWriting(true)} />
+                  )
+                ) : null}
+              </>
+            ) : null}
+            {item.attention === "business" && w?.canReply ? (
+              <Button theme={theme} primary label={run.isPending ? "正在发送…" : "发送回答"} disabled={run.isPending || !text.trim()} onPress={() => void act("reply")} />
+            ) : null}
+            {item.attention === "interrupted" ? (
+              <Button theme={theme} primary label={run.isPending ? "正在执行…" : "继续"} disabled={run.isPending} onPress={() => void act("resume")} />
+            ) : null}
+            <Button theme={theme} label={item.attention === "approval" ? "看方案和确认预览" : item.attention === "not_completed" ? "看完成报告" : "查看详情"} onPress={open} />
+          </View>
+        </>
+      )}
+    </View>
+  );
+}
+
+export function Inbox({ theme, layout, items, open }: { theme: Theme; layout: Layout; items: Requirement[]; open(item: Requirement): void }) {
+  const s = useStyles(theme, layout.compact);
+  const { readOnly } = usePreferences();
+  const waiting = inboxItems(items);
+  return (
+    <View style={{ gap: 10 }}>
+      <View style={[s.row, { justifyContent: "space-between" }]}>
+        <Text style={[s.title, { fontSize: 16 }]}>等你处理{waiting.length > 0 ? `（${waiting.length}）` : ""}</Text>
+        {waiting.length > 0 ? <Text style={s.muted}>等得最久的在前</Text> : null}
+      </View>
+      {waiting.length === 0 ? (
+        <View style={[s.card, { flexDirection: "row", alignItems: "center", gap: 8 }]}>
+          <Badge theme={theme} tone="success">
+            没有
+          </Badge>
+          <Text style={s.muted}>现在没有需要你处理的事。需要你确认或回答时，会出现在这里。</Text>
+        </View>
+      ) : (
+        waiting.map((item) => <InboxCard key={item.key} theme={theme} layout={layout} item={item} open={() => open(item)} readOnly={readOnly} />)
+      )}
+    </View>
+  );
+}

package/paseo-plugin/client/models.tsx

@@ -0,0 +1,117 @@
+// Settings → Plugins → req-kit → 模型 (1.12): pick builder, reviewer and the fallback model from what
+// this daemon offers, and write them to req-kit's machine config — the same as `req configure`.
+import type { PluginSurfaceProps } from "@getpaseo/plugin/client";
+import { SettingsAction, SettingsCard, SettingsRow, SettingsSection, SettingsSelect } from "@getpaseo/plugin/client/ui";
+import { useEffect, useState } from "react";
+import { Text } from "react-native";
+import type { AgentChoiceData, AgentProfileData } from "../shared/contracts";
+import { useModels, useSetAgents } from "./data";
+
+const NONE = "none";
+
+/** The choice a saved profile corresponds to; a profile Paseo no longer offers keeps its own entry. */
+function idOf(profile: AgentProfileData | null | undefined, choices: AgentChoiceData[]): string {
+  if (!profile) return NONE;
+  if (profile.paseoProfile) return `paseo:${profile.paseoProfile}`;
+  const found = choices.find((c) => !c.profile.paseoProfile && c.profile.provider === profile.provider);
+  return found ? found.id : `saved:${profile.provider ?? ""}`;
+}
+
+type Role = "builder" | "reviewer" | "fallback";
+
+const ROLES: Array<{ role: Role; label: string; hint: string }> = [
+  { role: "builder", label: "builder", hint: "方案设计、写代码、修复、写报告" },
+  { role: "reviewer", label: "reviewer", hint: "方案审核、代码评审、功能验证。和 builder 用不同厂商的模型，更容易发现问题" },
+  { role: "fallback", label: "备用模型", hint: "主模型一直限流、额度用完或报错时，换它把这一步做完，而不是停下等人" },
+];
+
+export function ModelSettings({ theme, readOnly }: { theme: PluginSurfaceProps["theme"]; readOnly: boolean }) {
+  const models = useModels();
+  const save = useSetAgents();
+  const data = models.data;
+  const choices = data?.choices ?? [];
+  const [picked, setPicked] = useState<Record<Role, string>>({ builder: NONE, reviewer: NONE, fallback: NONE });
+  const [message, setMessage] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (!data) return;
+    setPicked({
+      builder: idOf(data.current?.builder, choices),
+      reviewer: idOf(data.current?.reviewer, choices),
+      fallback: idOf(data.current?.fallback ?? null, choices),
+    });
+  }, [data]);
+
+  if (!data) {
+    return (
+      <SettingsSection title="模型">
+        <SettingsCard>
+          <SettingsRow label="可用的 agent" error={models.error?.message ?? undefined} hint={models.isPending ? "正在向 Paseo 读取已登录的 agent 和模型…" : undefined} />
+        </SettingsCard>
+      </SettingsSection>
+    );
+  }
+
+  const saved = (role: Role): AgentProfileData | null => (role === "fallback" ? (data.current?.fallback ?? null) : (data.current?.[role] ?? null));
+  const profileOf = (role: Role, id: string): AgentProfileData | null => {
+    if (id === NONE) return null;
+    if (id.startsWith("saved:")) return saved(role);
+    return choices.find((c) => c.id === id)?.profile ?? null;
+  };
+  const optionsFor = (role: Role) => {
+    const list = choices.map((c) => ({ label: c.label, value: c.id }));
+    const current = picked[role];
+    if (current.startsWith("saved:")) list.unshift({ label: `现在的设置：${current.slice(6)}（Paseo 中没有找到）`, value: current });
+    if (role === "fallback" || current === NONE) list.unshift({ label: role === "fallback" ? "不用备用模型" : "（未设置）", value: NONE });
+    return list;
+  };
+  const builder = profileOf("builder", picked.builder);
+  const reviewer = profileOf("reviewer", picked.reviewer);
+  const changed = ROLES.some(({ role }) => picked[role] !== idOf(role === "fallback" ? (data.current?.fallback ?? null) : data.current?.[role], choices));
+
+  const useRecommended = () => {
+    const r = data.recommended;
+    if (!r) return;
+    setPicked({ builder: idOf(r.builder, choices), reviewer: idOf(r.reviewer, choices), fallback: idOf(r.fallback ?? null, choices) });
+  };
+
+  return (
+    <SettingsSection title="模型">
+      <SettingsCard>
+        {choices.length === 0 ? (
+          <SettingsRow label="可用的 agent" hint="Paseo 中还没有登录任何能无人值守运行的 agent。在 Paseo 中登录 Claude Code、Codex 等之后再打开这一页。" />
+        ) : null}
+        {ROLES.map(({ role, label, hint }) => (
+          <SettingsSelect
+            key={role}
+            label={label}
+            hint={hint}
+            value={picked[role]}
+            options={optionsFor(role)}
+            disabled={readOnly || save.isPending}
+            onValueChange={(v) => {
+              setMessage(null);
+              setPicked({ ...picked, [role]: v });
+            }}
+          />
+        ))}
+        {data.recommended ? (
+          <SettingsAction label="按推荐选择" hint="不同厂商的模型分别做 builder 和 reviewer，再选一个做备用" actionLabel="填入推荐" disabled={readOnly || save.isPending} onPress={useRecommended} />
+        ) : null}
+        <SettingsAction
+          label="保存到本机配置"
+          hint={readOnly ? "插件设置为只读，不能在这里修改" : "写入 req-kit 的本机配置（原文件会备份）；之后开始的需求使用新的设置，进行中的不变"}
+          actionLabel={save.isPending ? "保存中…" : "保存"}
+          disabled={readOnly || save.isPending || !changed || !builder || !reviewer}
+          onPress={() =>
+            void save.mutateAsync({ builder: builder!, reviewer: reviewer!, fallback: profileOf("fallback", picked.fallback) }).then(
+              (r) => setMessage(r.message),
+              (e: Error) => setMessage(e.message),
+            )
+          }
+        />
+        {message ? <Text style={{ color: theme.colors.foregroundMuted }}>{message}</Text> : null}
+      </SettingsCard>
+    </SettingsSection>
+  );
+}

package/paseo-plugin/client/overview.tsx

@@ -6,6 +6,7 @@ import { Text, View } from "react-native";
 import type { Requirement } from "../shared/contracts";
 import { useRequirements } from "./data";
 import { type Group, GROUP_LABELS, groupOf } from "./format";
+import { Inbox } from "./inbox";
 import { RequirementRow } from "./row";
 import { Button, Chip, Status, useStyles } from "./ui";
 
@@ -19,7 +20,8 @@ export function RequirementGroups({
   layout,
   items,
   open,
-}: Pick<PluginScreenProps, "theme" | "layout"> & { items: Requirement[]; open: OpenRequirement }) {
+  skip = [],
+}: Pick<PluginScreenProps, "theme" | "layout"> & { items: Requirement[]; open: OpenRequirement; skip?: Group[] }) {
   const s = useStyles(theme, layout.compact);
   const [showOther, setShowOther] = useState(false);
   const groups = useMemo(() => {
@@ -29,7 +31,7 @@ export function RequirementGroups({
   }, [items]);
   return (
     <View style={{ gap: 20 }}>
-      {ORDER.filter((g) => groups.has(g)).map((g) => (
+      {ORDER.filter((g) => groups.has(g) && !skip.includes(g)).map((g) => (
         <View key={g} style={{ gap: 8 }}>
           <View style={s.row}>
             <Text style={s.heading}>
@@ -67,6 +69,7 @@ export function OverviewScreen(props: PluginScreenProps & { openScreen: ScreenOp
       <ScrollView contentContainerStyle={s.body}>
         <View style={s.row}>
           <Button theme={theme} label="使用统计" onPress={() => props.openScreen({ screenId: "stats" })} />
+          <Button theme={theme} label="配置" onPress={() => props.openScreen({ screenId: "config" })} />
         </View>
         {projects.length > 1 ? (
           <View style={s.row}>
@@ -82,7 +85,8 @@ export function OverviewScreen(props: PluginScreenProps & { openScreen: ScreenOp
           error={query.error}
           empty={query.data && items.length === 0 ? "这台机器上还没有记录任何需求。在 Paseo 对话中用 /req 开始一个；1.9 之前运行过的需求，在项目目录运行 req index --rebuild。" : null}
         />
-        <RequirementGroups theme={theme} layout={layout} items={shown} open={open} />
+        {query.data && items.length > 0 ? <Inbox theme={theme} layout={layout} items={shown} open={open} /> : null}
+        <RequirementGroups theme={theme} layout={layout} items={shown} open={open} skip={["attention"]} />
       </ScrollView>
     </View>
   );

package/paseo-plugin/client/settings.tsx

@@ -1,10 +1,11 @@
-// Settings → Plugins → req-kit: what the plugin found, read-only mode, refresh interval.
+// Settings → Plugins → req-kit: what the plugin found, the models (1.12), read-only mode, refresh interval.
 import { type PluginSurfaceProps, type SettingsState, useSettings } from "@getpaseo/plugin/client";
 import { SettingsAction, SettingsCard, SettingsInput, SettingsRow, SettingsSection, SettingsSelect, SettingsSwitch } from "@getpaseo/plugin/client/ui";
 import { useState } from "react";
 import { Text } from "react-native";
 import { preferences } from "../shared/contracts";
 import { useKitInfo } from "./data";
+import { ModelSettings } from "./models";
 
 type Ready = Extract<SettingsState<typeof preferences.schema>, { status: "ready" }>;
 
@@ -51,6 +52,7 @@ function Controls({ settings, theme }: { settings: Ready; theme: PluginSurfacePr
           />
         </SettingsCard>
       </SettingsSection>
+      <ModelSettings theme={theme} readOnly={settings.values.readOnly} />
       <SettingsSection title="显示与操作">
         <SettingsCard>
           <SettingsSwitch

package/paseo-plugin/index.client.tsx

@@ -1,4 +1,5 @@
 import type { PluginClientContext, PluginScreenProps } from "@getpaseo/plugin/client";
+import { ConfigScreen } from "./client/config";
 import { RequirementScreen } from "./client/detail";
 import { contributeLive } from "./client/live";
 import { OverviewScreen } from "./client/overview";
@@ -14,6 +15,7 @@ export default function contribute(client: PluginClientContext) {
   client.addScreen({ id: "overview", title: "需求", Component: Overview });
   client.addScreen({ id: "requirement", title: (params) => params.title || params.name || "需求", Component: RequirementScreen });
   client.addScreen({ id: "stats", title: "需求统计", Component: StatsScreen });
+  client.addScreen({ id: "config", title: "req-kit 配置", Component: ConfigScreen });
   client.addSidebarHeaderItem({ id: "requirements", title: "需求（req-kit）", Component: RequirementsItem });
   client.addWorkspacePanel({
     id: "requirements",
@@ -40,6 +42,14 @@ export default function contribute(client: PluginClientContext) {
     context: "global",
     onSelect: ({ openScreen: open }) => open({ screenId: "stats" }),
   });
+  client.addCommandCenterItem({
+    id: "open-config",
+    title: "req-kit 配置",
+    icon: "Settings",
+    keywords: ["req", "config", "配置", "设置"],
+    context: "global",
+    onSelect: ({ openScreen: open }) => open({ screenId: "config" }),
+  });
   client.addCommandCenterItem({
     id: "open-panel",
     title: "这个工作区的需求（req-kit）",

package/paseo-plugin/index.server.ts

@@ -1,5 +1,5 @@
 import type { PluginServerContext } from "@getpaseo/plugin/server";
-import { fileRpc, listRpc, preferences, runRpc, statsRpc, statusRpc, versionRpc } from "./shared/contracts";
+import { configRpc, fileRpc, listRpc, modelsRpc, preferences, runRpc, setAgentsRpc, statsRpc, statusRpc, versionRpc } from "./shared/contracts";
 import { createHandlers } from "./server/handlers";
 import { kitHomeOf, reqApi } from "./server/req";
 
@@ -35,6 +35,9 @@ export default function contribute(server: PluginServerContext) {
   server.handle(fileRpc, (input) => handlers.file(input));
   server.handle(statsRpc, (input) => handlers.stats(input));
   server.handle(runRpc, (input) => handlers.run(input));
+  server.handle(modelsRpc, () => handlers.models());
+  server.handle(configRpc, (input) => handlers.config(input));
+  server.handle(setAgentsRpc, (input) => handlers.setAgents(input));
   return () => {
     unsubscribe();
   };

package/paseo-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "req-kit-paseo-plugin",
-  "version": "1.11.0",
+  "version": "1.12.0-beta.3",
   "private": true,
   "description": "The req-kit plugin for Paseo. Ships inside the paseo-req-kit package; installed with req plugin install.",
   "type": "module",

package/paseo-plugin/server/handlers.ts

@@ -1,7 +1,7 @@
 // The daemon side: each RPC is one `req api` call. Management actions are refused here too
 // when the plugin is set to read-only, not only hidden in the app.
 import type { RpcInput } from "@getpaseo/plugin";
-import type { fileRpc, KitInfo, Requirement, RequirementDetail, runRpc, statsRpc, StatsSummary, statusRpc } from "../shared/contracts";
+import type { configRpc, ConfigViewData, fileRpc, KitInfo, ModelsData, Requirement, RequirementDetail, runRpc, setAgentsRpc, statsRpc, StatsSummary, statusRpc } from "../shared/contracts";
 import { coalesce, type ReqRunner } from "./req";
 
 export interface Handlers {
@@ -11,6 +11,9 @@ export interface Handlers {
   file(input: RpcInput<typeof fileRpc>): Promise<{ file: string; size: number; truncated: boolean; content: string }>;
   stats(input: RpcInput<typeof statsRpc>): Promise<StatsSummary>;
   run(input: RpcInput<typeof runRpc>): Promise<{ ok: boolean; message: string }>;
+  models(): Promise<ModelsData>;
+  config(input: RpcInput<typeof configRpc>): Promise<ConfigViewData>;
+  setAgents(input: RpcInput<typeof setAgentsRpc>): Promise<{ ok: boolean; message: string }>;
 }
 
 export function createHandlers(input: { req: ReqRunner; kitHome: () => string; readOnly: () => Promise<boolean> }): Handlers {
@@ -35,11 +38,26 @@ export function createHandlers(input: { req: ReqRunner; kitHome: () => string; r
       else if (since) args.push("--since", since);
       return (await req(args)) as StatsSummary;
     },
-    async run({ action, repo, featureDir, verifyEnv }) {
+    async run({ action, repo, featureDir, verifyEnv, text }) {
       if (await input.readOnly()) return { ok: false, message: "插件设置为只读：不能在这里操作需求。可以在插件设置中关闭只读，或在终端用 req 命令。" };
-      const extra = action === "verify" && verifyEnv ? ["--verify-env", verifyEnv] : [];
+      if (action === "reply" && !text?.trim()) return { ok: false, message: "回复是空的" };
+      const extra = action === "verify" && verifyEnv ? ["--verify-env", verifyEnv] : action === "reply" ? [text!.trim()] : [];
       const result = (await req(["run", action, featureDir, "--repo", repo, ...extra], { timeoutMs: 200_000 })) as { ok: boolean; message: string };
       return { ok: result.ok, message: result.message };
     },
+    async config({ repo }) {
+      return (await req(repo ? ["config", "--repo", repo] : ["config", "--machine"])) as ConfigViewData;
+    },
+    async models() {
+      return (await req(["models"], { timeoutMs: 120_000 })) as ModelsData;
+    },
+    async setAgents(agents) {
+      if (await input.readOnly()) return { ok: false, message: "插件设置为只读：不能在这里修改。可以关闭只读，或在终端运行 req configure。" };
+      try {
+        return (await req(["set-agents", "--json", JSON.stringify(agents)])) as { ok: boolean; message: string };
+      } catch (error) {
+        return { ok: false, message: (error as Error).message };
+      }
+    },
   };
 }

package/paseo-plugin/shared/contracts.ts

@@ -34,6 +34,14 @@ export interface Requirement {
   updatedAt: string;
   usage: Usage | null;
   present: boolean;
+  /** req-kit 1.12+: what a requirement that needs a person is waiting for; absent before. */
+  waiting?: {
+    since: string;
+    questions: string[];
+    reason: string | null;
+    card: { system: string; id: string; url: string | null; requester: string | null } | null;
+    canReply: boolean;
+  } | null;
 }
 
 export interface Step {
@@ -139,7 +147,7 @@ export const statsRpc = defineRpc({
   output: z.custom<StatsSummary>(),
 });
 
-export const ACTIONS = ["approve", "stop", "resume", "verify", "sync"] as const;
+export const ACTIONS = ["approve", "stop", "resume", "verify", "sync", "reply"] as const;
 export type Action = (typeof ACTIONS)[number];
 
 export const runRpc = defineRpc({
@@ -148,10 +156,78 @@ export const runRpc = defineRpc({
     action: z.enum(ACTIONS),
     /** For verify: local | deployed. */
     verifyEnv: z.enum(["local", "deployed"]).optional(),
+    /** For reply (1.12): the answer, passed to the requirement's chat. */
+    text: z.string().max(8000).optional(),
   }),
   output: z.object({ ok: z.boolean(), message: z.string() }),
 });
 
+/** req api config (1.12): every setting, its value in words and which file set it. */
+export type ConfigLayer = "machine" | "team" | "project";
+
+export interface ConfigItemData {
+  key: string;
+  label: string;
+  description: string;
+  display: string;
+  value: unknown;
+  setBy: ConfigLayer[];
+  scope: "any" | "machine" | "machine_team";
+  changed: boolean;
+}
+
+export interface ConfigViewData {
+  sources: Array<{ layer: ConfigLayer; path: string }>;
+  ignored: string[];
+  error: string | null;
+  repo: string | null;
+  groups: Array<{ id: string; title: string; description: string; items: ConfigItemData[] }>;
+}
+
+/** The configuration in a project (repo), or this machine's without a project. */
+export const configRpc = defineRpc({
+  name: "req.config",
+  input: z.object({ repo: z.string().optional() }),
+  output: z.custom<ConfigViewData>(),
+});
+
+/** Agent settings, as req-kit writes them (1.12). */
+export interface AgentProfileData {
+  provider?: string;
+  paseoProfile?: string;
+  modeId?: string;
+  [key: string]: unknown;
+}
+
+export interface AgentChoiceData {
+  id: string;
+  label: string;
+  provider: string;
+  profile: AgentProfileData;
+}
+
+export interface ModelsData {
+  current: { builder?: AgentProfileData; reviewer?: AgentProfileData; fallback?: AgentProfileData | null } | null;
+  choices: AgentChoiceData[];
+  recommended: { builder?: AgentProfileData; reviewer?: AgentProfileData; fallback?: AgentProfileData | null } | null;
+}
+
+/** What Paseo offers for builder, reviewer and the fallback model, and what is set now. */
+export const modelsRpc = defineRpc({
+  name: "req.models",
+  input: z.object({}),
+  output: z.custom<ModelsData>(),
+});
+
+const profile = z.record(z.string(), z.unknown());
+
+/** Writes the agents to this machine's req-kit config (refused when the plugin is read-only). */
+export const setAgentsRpc = defineRpc({
+  name: "req.setAgents",
+  input: z.object({ builder: profile, reviewer: profile, fallback: profile.nullable() }),
+  output: z.object({ ok: z.boolean(), message: z.string() }),
+});
+
 export const preferences = defineSettings({
   id: "preferences",
   scope: "host",

package/skills/req/playbooks/new.md

@@ -18,10 +18,9 @@
 
 运行 `git rev-parse --git-dir --git-common-dir` 和 `git branch --show-current`：
 
-- **两个路径相同（项目主目录）**：说明上面的好处，用一个选择题请用户选：
-  1. **开发时自动新建工作区**（推荐，不熟悉 worktree 也没关系）：就在这个对话里谈需求，需求说明先写在这里、不提交；启动开发时流水线会为这个需求新建一个 worktree 工作区，把需求说明移过去提交，在那里开发。这个对话不用动，之后的进度、暂停、继续、验收都在这里说。记下这个选择，第 9 步用"启动（自动新建工作区）"命令。
-  2. **自己新建工作区**：在 Paseo 中 **New workspace** → 选择这个项目 → **Isolation** 选 **New worktree** → 起点选主分支（如 `origin/main`），然后在新工作区的对话里重新输入 `/req`。
-  3. **就在这里开发**：到第 3 步之后新建功能分支（见下）。开发期间这个目录会被占用几个小时。
+- **两个路径相同（项目主目录）**：不用问，默认**开发时自动新建工作区**：就在这个对话里谈需求，需求说明先写在这里、不提交；启动开发时流水线为这个需求新建一个 worktree 工作区，把需求说明移过去提交，在那里开发。这个对话不用动，之后的进度、暂停、继续、验收都在这里说。第 8 步的确认摘要里写一句"将在新的工作区中开发"，第 9 步用"启动（自动新建工作区）"命令。
+  - 用户主动说要"就在这里开发"时：到第 3 步之后新建功能分支（见下），开发期间这个目录会被占用几个小时；第 9 步用普通的"启动"命令。
+  - 用户想自己建工作区时：在 Paseo 中 **New workspace** → 选择这个项目 → **Isolation** 选 **New worktree** → 起点选主分支（如 `origin/main`），然后在新工作区的对话里重新输入 `/req`。
 - **两个路径不同（已在 worktree 中）**：直接继续，使用当前分支，不要再新建分支。
 - **不是 git 仓库**：直接继续，跳过所有分支相关的操作。
 
@@ -35,7 +34,7 @@
 
 然后确定功能目录：`docs/features/<YYYYMMDD>-<英文短名>/`，例如 `docs/features/20261012-sms-login/`，英文短名用小写字母和连字符。创建该目录。
 
-只有用户在第 1 步选了"就在这里开发"、且当前在默认分支（如 `main`、`master`）上时，才新建并切换到分支 `feature/<功能目录名>`。选了"自动新建工作区"的，不建分支、不提交，留在当前分支上即可。不要动工作区里已有的、与本需求无关的改动。流水线不会在默认分支上提交代码。
+只有用户在第 1 步说了要"就在这里开发"、且当前在默认分支（如 `main`、`master`）上时，才新建并切换到分支 `feature/<功能目录名>`。自动新建工作区的，不建分支、不提交，留在当前分支上即可。不要动工作区里已有的、与本需求无关的改动。流水线不会在默认分支上提交代码。
 
 ## 4. 判断类型和规模，确定档位和执行方式
 
@@ -46,20 +45,19 @@
 - **重构**：使用者看到的行为不变，只改进代码（整理结构、升级依赖、提高可维护性）。流水线会先用测试锁住现有行为再小步改动。访谈重点问清**改进目标**（怎么检查达成了）和**哪些行为必须保持不变**。
 - **评估**：只想知道能不能做、怎么做、影响多大、大概要多少工作量，先不写代码。流水线只调研、写评估报告，由另一个模型审阅。访谈重点问清**要回答的问题**和评估结论用来做什么决定。评估用标准档、连续执行，下面关于档位和执行方式的问题不用问。
 
-再判断**规模**，向用户推荐一个档位，说明理由，请用户确认：
+再判断**规模**，选定一个档位，不用单独问：在第 8 步的确认摘要里写明档位和一句理由，用户想改再改。
 
 - **快速档**：小改动，影响面窄，不涉及数据结构、权限、计费或对外接口。例如改文案或样式、加一个配置项、调整一个字段的显示。之后按 `small.md` 手册继续（从它的"访谈"一步开始）。
 - **标准档**：其他情况，继续本手册。
 
 拿不准时选标准档。访谈中发现需求比预想的复杂（涉及数据、权限、多个角色或流程），改为标准档并告诉用户。
 
-标准档再确定**执行方式**。项目根目录的 `.requirement-pipeline.json` 中已经写了 `phases.mode` 的，按它来，不问。否则用一个选择题请用户选：
+标准档再确定**执行方式**，同样不单独问：项目根目录的 `.requirement-pipeline.json` 中写了 `phases.mode` 的按它来，否则用**连续**（研发完成后流水线接着做测试验证，一次跑完）。确认摘要里写明执行方式。用户在谈需求时说了要先提测、由测试同事测，或者只要研发的，改用：
 
-- **连续**（推荐，默认）：研发完成后流水线接着做测试验证，一次跑完。适合本地就能验证的项目。
-- **分阶段**：研发完成、写好提测说明后停下来通知你，由你或测试同事决定什么时候开始测试验证（可以先部署到测试环境、准备测试数据，也可以预约时间）。适合有专门测试、需要测试环境的项目。
+- **分阶段**：研发完成、写好提测说明后停下来通知，由用户或测试同事决定什么时候开始测试验证（可以先部署到测试环境、准备测试数据，也可以预约时间）。
 - **只做研发**：只做到提测说明和研发报告，测试由人完成。
 
-选了"分阶段"或"只做研发"的，第 6 步在需求说明头部写上 `- 执行方式：分阶段` 或 `- 执行方式：只做研发`。快速档一律连续，不问。
+用了"分阶段"或"只做研发"的，第 6 步在需求说明头部写上 `- 执行方式：分阶段` 或 `- 执行方式：只做研发`。快速档一律连续。
 
 ## 5. 访谈
 
@@ -85,12 +83,14 @@
 
 先执行"卡片字段"命令。输出"跳过"时不用管；列出了字段时（团队对接了需求管理等外部系统），按输出的说明从需求说明中填出这些字段，判断不了的问需求方，放进摘要里一起确认，确认后写入功能目录的 `card.json`。流水线开始时会用它在外部系统中建卡。
 
-按 `spec-writing` 中"确认"一节：给出 10 行以内的摘要，确认后把状态改为"已确认"并提交（有 `card.json` 的一起提交）。选了"自动新建工作区"的，只改状态、不提交（不在默认分支上提交），启动时流水线会在新工作区中提交。
+按 `spec-writing` 中"确认"一节：给出 10 行以内的摘要。摘要最后一行写明怎么开发，例如"确认后立即开始：新的工作区、标准档（涉及订单数据）、连续执行"，并说明想改其中哪一项直接说。确认后把状态改为"已确认"并提交（有 `card.json` 的一起提交）。自动新建工作区的，只改状态、不提交（不在默认分支上提交），启动时流水线会在新工作区中提交。
 
 ## 9. 启动开发
 
-告诉用户需求说明保存在哪里，然后问是现在开始开发，还是预约一个时间开始（例如晚上或明天早上，机器空闲、额度充足的时候）。说明三点：开发在后台进行，通常需要几个小时；过程中不需要盯着；有进展、需要他们决定或完成时，会在这个对话里通知。
+用户确认需求说明就是同意开始，不再另外问"现在开始还是预约"：立即执行 `/req` 中的"启动"命令（自动新建工作区的执行"启动（自动新建工作区）"命令），把输出中的新工作区位置告诉用户（在 Paseo 侧边栏中可以看到它）。然后告诉用户需求说明保存在哪里，并说明三点：开发在后台进行，通常需要几个小时；过程中不需要盯着；有进展、需要他们决定或完成时，会在这个对话里通知。
 
-执行方式是"分阶段"的，顺便问用户是否要在研发完成后的某个时间自动开始测试验证；要的话在启动命令后加 `--verify-at <时间>`。
+例外：
 
-用户想预约时，执行"预约启动"命令（选了"自动新建工作区"的加上 `--worktree`），把预约的时间告诉用户，并说明到时会在这个对话里自动开始、想取消就说"先停一下"。用户同意现在开始后，执行 `/req` 中的"启动"命令；第 1 步选了"自动新建工作区"的，执行"启动（自动新建工作区）"命令，并把输出中的新工作区位置告诉用户（在 Paseo 侧边栏中可以看到它）。用户没有同意时，告诉他们之后随时说"开始开发"即可。
+- 用户在确认时说了要晚一点开始（"今晚再跑""明天早上开始"）：执行"预约启动"命令（自动新建工作区的加上 `--worktree`），把预约的时间告诉用户，并说明到时会在这个对话里自动开始、想取消就说"先停一下"。
+- 流水线开始后发来额度提醒、并给出了恢复时间时：转告用户，问是否暂停、在恢复时间预约继续；用户没回答也不影响，流水线遇到限流会自己等到额度恢复后继续。
+- 执行方式是"分阶段"、用户说了希望研发完成后在某个时间自动开始测试验证的：在启动命令后加 `--verify-at <时间>`。