create-windy 0.8.3 → 0.9.1

package/template/apps/web/src/pages/system/components/agent-skills/AgentSkillsTable.vue

@@ -0,0 +1,69 @@
+<script setup lang="ts">
+import type { AgentSkillGovernanceItem } from "@southwind-ai/shared";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/table";
+defineProps<{ items: readonly AgentSkillGovernanceItem[]; loading: boolean }>();
+defineEmits<{ select: [item: AgentSkillGovernanceItem] }>();
+const scopeLabels = { personal: "个人", department: "部门", tenant: "全租户" };
+</script>
+<template>
+  <div class="rounded-xl border" :aria-busy="loading">
+    <Table>
+      <TableHeader
+        ><TableRow
+          ><TableHead>技能</TableHead><TableHead>版本 / 来源</TableHead
+          ><TableHead>共享范围</TableHead><TableHead>状态</TableHead
+          ><TableHead class="text-right">操作</TableHead></TableRow
+        ></TableHeader
+      >
+      <TableBody>
+        <TableRow v-for="item in items" :key="item.skill.key">
+          <TableCell
+            ><div class="font-medium">{{ item.skill.name }}</div>
+            <p class="mt-1 max-w-xl text-xs text-muted-foreground">
+              {{ item.skill.description }}
+            </p></TableCell
+          >
+          <TableCell
+            >v{{ item.skill.version }} ·
+            {{ item.skill.origin === "builtin" ? "内置" : "共享" }}</TableCell
+          >
+          <TableCell>{{ scopeLabels[item.skill.scope] }}</TableCell>
+          <TableCell
+            ><Badge :variant="item.available ? 'secondary' : 'outline'">{{
+              item.skill.status === "disabled"
+                ? "已停用"
+                : item.available
+                  ? "可使用"
+                  : "依赖不可用"
+            }}</Badge></TableCell
+          >
+          <TableCell class="text-right"
+            ><Button
+              type="button"
+              variant="outline"
+              size="sm"
+              @click="$emit('select', item)"
+              >查看详情</Button
+            ></TableCell
+          >
+        </TableRow>
+        <TableRow v-if="!items.length"
+          ><TableCell
+            :colspan="5"
+            class="py-10 text-center text-muted-foreground"
+            >{{ loading ? "正在读取技能…" : "没有符合条件的技能" }}</TableCell
+          ></TableRow
+        >
+      </TableBody>
+    </Table>
+  </div>
+</template>

package/template/apps/web/src/pages/system/components/agent-workflow/WorkflowPresetCatalog.vue

@@ -0,0 +1,82 @@
+<script setup lang="ts">
+import { RouterLink } from "vue-router";
+import type { AgentWorkflowPresetSummary } from "@/services/agent-workflow-api";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+
+defineProps<{
+  presets: readonly AgentWorkflowPresetSummary[];
+  loading: boolean;
+  error: string;
+}>();
+defineEmits<{ refresh: [] }>();
+</script>
+
+<template>
+  <section
+    aria-labelledby="workflow-preset-title"
+    class="space-y-3"
+    :aria-busy="loading"
+  >
+    <div class="space-y-1">
+      <h2 id="workflow-preset-title" class="text-base font-semibold">
+        业务预设
+      </h2>
+      <p class="text-sm text-muted-foreground">
+        查看已安装模块注册的固定工作流；进入业务页面后按当前材料和权限启动。
+      </p>
+    </div>
+    <p v-if="loading" role="status" class="text-sm text-muted-foreground">
+      正在读取预设…
+    </p>
+    <div
+      v-else-if="error"
+      role="alert"
+      class="rounded-lg border p-4 text-sm text-destructive"
+    >
+      <p>{{ error }}</p>
+      <Button class="mt-2" variant="outline" size="sm" @click="$emit('refresh')"
+        >重试</Button
+      >
+    </div>
+    <p
+      v-else-if="!presets.length"
+      class="rounded-lg border p-4 text-sm text-muted-foreground"
+    >
+      当前没有可访问的业务预设。
+    </p>
+    <ul v-else class="grid gap-3 xl:grid-cols-2">
+      <li
+        v-for="preset in presets"
+        :key="preset.key"
+        class="space-y-3 rounded-lg border bg-card p-4"
+      >
+        <div class="flex flex-wrap items-center justify-between gap-2">
+          <h3 class="font-medium">{{ preset.label }}</h3>
+          <Badge
+            :variant="
+              preset.availability === 'available' ? 'secondary' : 'outline'
+            "
+            >{{
+              preset.availability === "available"
+                ? `v${preset.version}`
+                : "条件未就绪"
+            }}</Badge
+          >
+        </div>
+        <p class="text-sm text-muted-foreground">{{ preset.description }}</p>
+        <p class="text-xs leading-5 text-muted-foreground">
+          {{ preset.nodes.map((node) => node.label).join(" → ") }}
+        </p>
+        <p v-if="preset.blockedReason" class="rounded-md bg-muted p-3 text-xs">
+          {{ preset.blockedReason }}（{{ preset.safeCode }}）
+        </p>
+        <Button v-if="preset.entry" as-child variant="outline" size="sm"
+          ><RouterLink :to="preset.entry.path">{{
+            preset.entry.label
+          }}</RouterLink></Button
+        >
+      </li>
+    </ul>
+  </section>
+</template>

package/template/apps/web/src/pages/system/components/agent-workflow/WorkflowPresetCatalog.webtest.ts

@@ -0,0 +1,57 @@
+import { mount } from "@vue/test-utils";
+import { describe, expect, test } from "vitest";
+import type { AgentWorkflowPresetSummary } from "@/services/agent-workflow-api";
+import WorkflowPresetCatalog from "./WorkflowPresetCatalog.vue";
+
+const preset: AgentWorkflowPresetSummary = {
+  key: "example.work-order",
+  moduleKey: "example",
+  label: "工单办理",
+  description: "办理授权工单",
+  workflowKey: "example.work-order",
+  version: "1.0.0",
+  budget: {
+    maxDurationSeconds: 60,
+    maxModelAttempts: 1,
+    maxToolCalls: 1,
+    maxSubagents: 0,
+    maxParallelism: 1,
+    maxInputTokens: 100,
+    maxOutputTokens: 100,
+    maxCostMicros: 0,
+  },
+  nodes: [{ id: "final", type: "final", label: "确认完成" }],
+  availability: "unavailable",
+  safeCode: "BUSINESS_BINDING_REQUIRED",
+  blockedReason: "尚未登记业务绑定",
+  entry: { path: "/work-orders", label: "进入工单" },
+};
+
+describe("Workflow 预设目录", () => {
+  test("按实际注册投影展示条件与业务入口，不提供发布或启动按钮", () => {
+    const wrapper = mount(WorkflowPresetCatalog, {
+      props: { presets: [preset], loading: false, error: "" },
+      global: {
+        stubs: {
+          RouterLink: { props: ["to"], template: '<a :href="to"><slot /></a>' },
+        },
+      },
+    });
+    expect(wrapper.text()).toContain("工单办理");
+    expect(wrapper.text()).toContain("尚未登记业务绑定");
+    expect(wrapper.get("a").attributes("href")).toBe("/work-orders");
+    expect(wrapper.text()).not.toContain("发布预设");
+    expect(wrapper.text()).not.toContain("立即启动");
+  });
+
+  test("读取失败允许重试，空目录说明当前授权边界", async () => {
+    const wrapper = mount(WorkflowPresetCatalog, {
+      props: { presets: [], loading: false, error: "目录暂不可用" },
+    });
+    expect(wrapper.get('[role="alert"]').text()).toContain("目录暂不可用");
+    await wrapper.get("button").trigger("click");
+    expect(wrapper.emitted("refresh")).toHaveLength(1);
+    await wrapper.setProps({ error: "" });
+    expect(wrapper.text()).toContain("当前没有可访问的业务预设");
+  });
+});

package/template/apps/web/src/pages/system/composables/useAgentSkillsGovernance.ts

@@ -0,0 +1,105 @@
+import { computed, onBeforeUnmount, onMounted, shallowRef } from "vue";
+import {
+  governAgentSkill,
+  listGovernedAgentSkills,
+  type AgentSkillGovernanceItem,
+} from "@/services/agent-skills-api";
+export function useAgentSkillsGovernance() {
+  const items = shallowRef<readonly AgentSkillGovernanceItem[]>([]),
+    loading = shallowRef(false),
+    error = shallowRef(""),
+    query = shallowRef("");
+  const selected = shallowRef<AgentSkillGovernanceItem>(),
+    action = shallowRef<"disable" | "rollback">(),
+    targetVersion = shallowRef<number>();
+  const actionLoading = shallowRef(false),
+    actionError = shallowRef("");
+  let controller: AbortController | undefined,
+    revision = 0,
+    mutationKey = "";
+  const filtered = computed(() => {
+    const needle = query.value.trim().toLocaleLowerCase("zh-CN");
+    return items.value.filter(
+      ({ skill }) =>
+        !needle ||
+        [skill.key, skill.name, skill.description]
+          .join(" ")
+          .toLocaleLowerCase("zh-CN")
+          .includes(needle),
+    );
+  });
+  async function reload() {
+    const current = ++revision;
+    controller?.abort();
+    controller = new AbortController();
+    loading.value = true;
+    error.value = "";
+    try {
+      const result = await listGovernedAgentSkills(controller.signal);
+      if (current === revision) items.value = result;
+    } catch (cause) {
+      if (current === revision && !controller.signal.aborted)
+        error.value =
+          cause instanceof Error ? cause.message : "技能目录读取失败";
+    } finally {
+      if (current === revision) loading.value = false;
+    }
+  }
+  function requestAction(value: "disable" | "rollback", version?: number) {
+    action.value = value;
+    targetVersion.value = version;
+    actionError.value = "";
+    mutationKey = crypto.randomUUID();
+  }
+  function closeAction() {
+    if (actionLoading.value) return;
+    action.value = undefined;
+    actionError.value = "";
+    mutationKey = "";
+  }
+  async function confirmAction() {
+    if (actionLoading.value || !selected.value || !action.value) return;
+    actionLoading.value = true;
+    actionError.value = "";
+    try {
+      await governAgentSkill(
+        selected.value.skill.key,
+        action.value,
+        {
+          expectedVersion: selected.value.skill.version,
+          ...(targetVersion.value ? { version: targetVersion.value } : {}),
+        },
+        mutationKey,
+      );
+      action.value = undefined;
+      selected.value = undefined;
+      await reload();
+    } catch (cause) {
+      actionError.value =
+        cause instanceof Error ? cause.message : "技能变更失败";
+    } finally {
+      actionLoading.value = false;
+    }
+  }
+  onMounted(reload);
+  onBeforeUnmount(() => {
+    revision++;
+    controller?.abort();
+  });
+  return {
+    items,
+    loading,
+    error,
+    query,
+    filtered,
+    selected,
+    action,
+    actionError,
+    actionLoading,
+    targetVersion,
+    reload,
+    requestAction,
+    closeAction,
+    confirmAction,
+  };
+}

package/template/apps/web/src/pages/system/composables/useAgentWorkflowPresets.ts

@@ -0,0 +1,44 @@
+import { onBeforeUnmount, onMounted, readonly, shallowRef } from "vue";
+import {
+  listAgentWorkflowPresets,
+  type AgentWorkflowPresetSummary,
+} from "@/services/agent-workflow-api";
+
+export function useAgentWorkflowPresets() {
+  const presets = shallowRef<readonly AgentWorkflowPresetSummary[]>([]);
+  const loading = shallowRef(false);
+  const error = shallowRef("");
+  let controller: AbortController | undefined;
+  let revision = 0;
+  onMounted(() => void refresh());
+  onBeforeUnmount(() => {
+    revision++;
+    controller?.abort();
+  });
+
+  async function refresh() {
+    const current = ++revision;
+    controller?.abort();
+    const request = new AbortController();
+    controller = request;
+    loading.value = true;
+    error.value = "";
+    try {
+      const response = await listAgentWorkflowPresets(request.signal);
+      if (current === revision && !request.signal.aborted)
+        presets.value = response.items;
+    } catch (cause) {
+      if (current === revision && !request.signal.aborted)
+        error.value =
+          cause instanceof Error ? cause.message : "Workflow 预设目录读取失败";
+    } finally {
+      if (current === revision) loading.value = false;
+    }
+  }
+  return {
+    presets: readonly(presets),
+    loading: readonly(loading),
+    error: readonly(error),
+    refresh,
+  };
+}

package/template/apps/web/src/pages/system/composables/useDiagnosticLookup.ts

@@ -0,0 +1,64 @@
+import { onBeforeUnmount, shallowRef, watch } from "vue";
+import {
+  getDiagnostic,
+  type DiagnosticRecord,
+} from "@/services/diagnostics-api";
+import { ApiError, diagnosticIdFrom } from "@/services/http";
+const messages: Record<number, string> = {
+  400: "诊断编号格式无效，请复制完整的 diag-… 编号。",
+  401: "登录已失效，请重新登录后查询。",
+  403: "当前身份无权查询，请确认错误诊断读取权限及功能是否可用。",
+  404: "未找到该诊断编号。请确认编号来自当前部署且对应失败请求；索引也可能未成功保存。",
+  410: "该诊断编号已超过 30 天保留期，请结合发生时间查询已留存的服务日志。",
+  422: "这是浏览器本地编号，服务端没有对应索引，请结合发生时间检查浏览器控制台。",
+  503: "诊断索引暂不可用，请稍后重试或检查服务端日志。",
+};
+
+export function useDiagnosticLookup() {
+  const input = shallowRef("");
+  const record = shallowRef<DiagnosticRecord>();
+  const error = shallowRef("");
+  const loading = shallowRef(false);
+  let controller: AbortController | undefined;
+  let generation = 0;
+
+  function clear() {
+    generation++;
+    controller?.abort();
+    record.value = undefined;
+    error.value = "";
+    loading.value = false;
+  }
+  watch(input, clear, { flush: "sync" });
+  onBeforeUnmount(clear);
+
+  async function lookup() {
+    clear();
+    const id = input.value.trim();
+    if (id.startsWith("web-")) {
+      error.value = messages[422]!;
+      return;
+    }
+    if (!diagnosticIdFrom(id)) {
+      error.value = messages[400]!;
+      return;
+    }
+    const current = generation;
+    controller = new AbortController();
+    loading.value = true;
+    try {
+      const result = await getDiagnostic(id, controller.signal);
+      if (current === generation) record.value = result;
+    } catch (failure) {
+      if (current !== generation) return;
+      error.value =
+        failure instanceof ApiError
+          ? (messages[failure.status] ??
+            "诊断查询失败，请稍后重试或联系维护人员检查服务日志。")
+          : "无法连接诊断服务，请检查网络及服务状态后重试。";
+    } finally {
+      if (current === generation) loading.value = false;
+    }
+  }
+  return { input, record, error, loading, lookup };
+}

package/template/apps/web/src/router/error-navigation.ts

@@ -1,5 +1,5 @@
 import type { Router } from "vue-router";
-import type { ApiFailure } from "@/services/http";
+import { diagnosticIdFrom, type ApiFailure } from "@/services/http";
 import { safeReturnTo } from "./auth-navigation";
 
 const errorRouteNames = {
@@ -15,6 +15,8 @@ export function installApiFailureNavigation(router: Router) {
       from: safeErrorReturnTo(router.currentRoute.value.fullPath),
     };
     if (failure.requestId) query.requestId = failure.requestId;
+    const diagnosticId = diagnosticIdFrom(failure.diagnosticId);
+    if (diagnosticId) query.diagnosticId = diagnosticId;
     scheduleErrorNavigation(router, {
       name: errorRouteNames[failure.kind],
       query,

package/template/apps/web/src/router/error-navigation.webtest.ts

@@ -37,13 +37,14 @@ function testRouter() {
 }
 
 describe("统一错误导航", () => {
-  test("HTTP 失败类型映射到对应页面并保留 Request ID", async () => {
+  test("HTTP 失败页面分别保留诊断编号与 Request ID", async () => {
     const router = testRouter();
     await router.push("/records");
 
     installApiFailureNavigation(router)({
       kind: "maintenance",
       requestId: "req-maintenance-1",
+      diagnosticId: "diag-019a1234-5678-7000-8000-000000000001",
     });
     await vi.waitFor(() => {
       expect(router.currentRoute.value.name).toBe("maintenance");
@@ -52,6 +53,7 @@ describe("统一错误导航", () => {
     expect(router.currentRoute.value.query).toEqual({
       from: "/records",
       requestId: "req-maintenance-1",
+      diagnosticId: "diag-019a1234-5678-7000-8000-000000000001",
     });
   });
 
@@ -83,7 +85,13 @@ describe("统一错误导航", () => {
       fetcher: async () =>
         Response.json(
           { error: "MAINTENANCE" },
-          { status: 503, headers: { "x-request-id": "req-guard-1" } },
+          {
+            status: 503,
+            headers: {
+              "x-request-id": "req-guard-1",
+              "x-diagnostic-id": "diag-019a1234-5678-7000-8000-000000000001",
+            },
+          },
         ),
     });
     client.setFailureHandler(installApiFailureNavigation(router));
@@ -102,5 +110,9 @@ describe("统一错误导航", () => {
     await vi.waitFor(() => {
       expect(router.currentRoute.value.name).toBe("maintenance");
     });
+    expect(router.currentRoute.value.query.diagnosticId).toBe(
+      "diag-019a1234-5678-7000-8000-000000000001",
+    );
+    expect(router.currentRoute.value.query.requestId).toBe("req-guard-1");
   });
 });

package/template/apps/web/src/router/index.ts

@@ -1,10 +1,12 @@
+import { platformAdminPageComponents } from "./platform-admin-pages";
 import {
   createRouter,
   createWebHistory,
   type RouterHistory,
   type RouteRecordRaw,
 } from "vue-router";
-import type { Component } from "vue";
+// @windy-module system.audit begin
+// @windy-module system.audit end
 import DashboardPage from "@/pages/dashboard/DashboardPage.vue";
 import HomePage from "@/app/home/HomePage.vue";
 import { loginPageComponent } from "@/app/auth/login-page";
@@ -13,29 +15,16 @@ import AccessDeniedPage from "@/pages/AccessDeniedPage.vue";
 import ServiceUnavailablePage from "@/pages/ServiceUnavailablePage.vue";
 import ChangePasswordPage from "@/pages/auth/ChangePasswordPage.vue";
 // @windy-module system.license begin
-import LicensePage from "@/pages/license/LicensePage.vue";
 // @windy-module system.license end
 // @windy-module system.operations begin
-import SystemOperationsPage from "@/pages/system/SystemOperationsPage.vue";
 // @windy-module system.operations end
 // @windy-module system.agent begin
-import AiRuntimePage from "@/pages/system/AiRuntimePage.vue";
-import AgentToolsPage from "@/pages/system/AgentToolsPage.vue";
-import AgentDebugPage from "@/pages/system/AgentDebugPage.vue";
-import AgentSessionPage from "@/pages/system/AgentSessionPage.vue";
-import AgentWorkflowPage from "@/pages/system/AgentWorkflowPage.vue";
 // @windy-module system.agent end
 // @windy-module system.notification begin
-import SystemNotificationsPage from "@/pages/system/SystemNotificationsPage.vue";
 // @windy-module system.notification end
-import SystemResourceRoutePage from "@/pages/system/SystemResourceRoutePage.vue";
 // @windy-module system.settings begin
-import GlobalSettingsPage from "@/pages/settings/GlobalSettingsPage.vue";
 // @windy-module system.settings end
-import PersonalSettingsPage from "@/pages/profile/PersonalSettingsPage.vue";
-import UiComponentPage from "@/pages/ui/UiComponentPage.vue";
 // @windy-module system.configuration begin
-import ModuleConfigurationPage from "@/pages/configuration/ModuleConfigurationPage.vue";
 // @windy-module system.configuration end
 import { useAccessSnapshot } from "@/composables/useAccessSnapshot";
 import {
@@ -46,7 +35,7 @@ import {
 import { useLicenseRuntime } from "@/composables/useLicenseRuntime";
 // @windy-module system.license end
 import { evaluateWebAccess, type WebAccessSnapshot } from "@/layout/navigation";
-import { isApiErrorStatus } from "@/services/http";
+import { diagnosticIdFrom, isApiErrorStatus } from "@/services/http";
 import { loginRoute, safeReturnTo } from "./auth-navigation";
 import {
   deniedRoute,
@@ -62,10 +51,7 @@ import {
   manifestAdminRoute,
   validateWebModuleComposition,
 } from "./manifest-routes";
-import {
-  platformAdminRouteBindings,
-  type PlatformAdminPageKey,
-} from "./platform-admin-route-bindings";
+import { platformAdminRouteBindings } from "./platform-admin-route-bindings";
 import { reservedWebRoutePaths } from "./reserved-route-paths";
 import { webAdminUiComposition } from "./web-composition-host";
 
@@ -84,36 +70,6 @@ export interface RouterAuthProvider {
   clear(): void;
 }
 
-const platformAdminPageComponents: Partial<
-  Record<PlatformAdminPageKey, Component>
-> = {
-  resource: SystemResourceRoutePage,
-  profile: PersonalSettingsPage,
-  "ui-components": UiComponentPage,
-  // @windy-module system.settings begin
-  settings: GlobalSettingsPage,
-  // @windy-module system.settings end
-  // @windy-module system.license begin
-  license: LicensePage,
-  // @windy-module system.license end
-  // @windy-module system.notification begin
-  notification: SystemNotificationsPage,
-  // @windy-module system.notification end
-  // @windy-module system.operations begin
-  operations: SystemOperationsPage,
-  // @windy-module system.operations end
-  // @windy-module system.agent begin
-  "agent-tools": AgentToolsPage,
-  "agent-debug": AgentDebugPage,
-  "agent-session": AgentSessionPage,
-  "agent-workflow": AgentWorkflowPage,
-  "ai-runtime": AiRuntimePage,
-  // @windy-module system.agent end
-  // @windy-module system.configuration begin
-  configuration: ModuleConfigurationPage,
-  // @windy-module system.configuration end
-};
-
 const platformAdminRoutes = platformAdminRouteBindings.map((binding) => {
   const component = platformAdminPageComponents[binding.page];
   if (!component) {
@@ -182,6 +138,7 @@ const declaredRoutes: RouteRecordRaw[] = [
       kind: "internal",
       from: safeErrorReturnTo(String(route.query.from || "/")),
       requestId: requestIdFrom(route.query.requestId),
+      diagnosticId: diagnosticIdFrom(route.query.diagnosticId),
     }),
     meta: {
       title: "页面运行异常",
@@ -198,6 +155,7 @@ const declaredRoutes: RouteRecordRaw[] = [
       kind: "maintenance",
       from: safeErrorReturnTo(String(route.query.from || "/")),
       requestId: requestIdFrom(route.query.requestId),
+      diagnosticId: diagnosticIdFrom(route.query.diagnosticId),
     }),
     meta: {
       title: "服务维护中",
@@ -214,6 +172,7 @@ const declaredRoutes: RouteRecordRaw[] = [
       kind: "network",
       from: safeErrorReturnTo(String(route.query.from || "/")),
       requestId: requestIdFrom(route.query.requestId),
+      diagnosticId: diagnosticIdFrom(route.query.diagnosticId),
     }),
     meta: {
       title: "网络异常",