create-windy 0.8.3 → 0.9.1

package/template/apps/web/server.ts

@@ -1,14 +1,35 @@
 import { join } from "node:path";
 import { createWebFetchHandler } from "./runtime-server";
 
+// @windy-module system.agent begin
+import {
+  createDshWebProxy,
+  isDshWorkbenchPath,
+  type DshWebSocketState,
+} from "./dsh-workbench-proxy";
+// @windy-module system.agent end
+
 const port = process.env.PORT ? Number(process.env.PORT) : 9_746;
-const server = Bun.serve({
-  port,
-  fetch: createWebFetchHandler({
-    distDir: join(process.cwd(), "dist"),
-    apiUpstream: process.env.API_UPSTREAM?.trim(),
-  }),
+const serve = createWebFetchHandler({
+  distDir: join(process.cwd(), "dist"),
+  apiUpstream: process.env.API_UPSTREAM?.trim(),
 });
+let startServer: () => { readonly port: number } = () =>
+  Bun.serve({ port, fetch: serve });
+// @windy-module system.agent begin
+const native = createDshWebProxy(process.env.API_UPSTREAM?.trim());
+startServer = () =>
+  Bun.serve<DshWebSocketState>({
+    port,
+    fetch(request, server) {
+      return isDshWorkbenchPath(request.url)
+        ? native.fetch(request, server)
+        : serve(request);
+    },
+    websocket: native.websocket,
+  });
+// @windy-module system.agent end
+const server = startServer();
 
 console.info(
   JSON.stringify({

package/template/apps/web/src/composables/useLoginFlow.ts

@@ -25,7 +25,19 @@ export function useLoginFlow() {
       resetLicenseRuntime();
       // @windy-module system.license end
       resetSessionContext();
-      await router.replace(safeReturnTo(route.query.returnTo));
+      const returnTo = safeReturnTo(route.query.returnTo);
+      // @windy-module system.agent begin
+      if (
+        new URL(returnTo, window.location.origin).pathname.replace(
+          /\/$/,
+          "",
+        ) === "/agent"
+      ) {
+        window.location.assign(returnTo);
+        return;
+      }
+      // @windy-module system.agent end
+      await router.replace(returnTo);
     } catch {
       submitError.value = auth.error.value || "登录失败，请稍后重试";
     }

package/template/apps/web/src/pages/errors/PlatformErrorPage.vue

@@ -90,6 +90,12 @@ const primaryTarget = computed(() =>
               <dt>原请求地址</dt>
               <dd class="break-all font-mono text-foreground">{{ from }}</dd>
             </div>
+            <div v-if="diagnosticId" class="flex flex-wrap gap-2">
+              <dt>诊断编号</dt>
+              <dd class="break-all font-mono text-foreground">
+                {{ diagnosticId }}
+              </dd>
+            </div>
             <div v-if="requestId" class="flex flex-wrap gap-2">
               <dt>Request ID</dt>
               <dd class="break-all font-mono text-foreground">

package/template/apps/web/src/pages/errors/PlatformErrorPage.webtest.ts

@@ -3,12 +3,17 @@ import { describe, expect, test } from "vitest";
 import PlatformErrorPage from "./PlatformErrorPage.vue";
 import type { ErrorPageKind } from "./error-page-extension";
 
-function render(kind: ErrorPageKind, requestId?: string) {
+function render(
+  kind: ErrorPageKind,
+  requestId?: string,
+  diagnosticId?: string,
+) {
   return mount(PlatformErrorPage, {
     props: {
       kind,
       from: "/records/42",
       requestId,
+      diagnosticId,
     },
     global: {
       stubs: {
@@ -41,4 +46,12 @@ describe("平台统一错误页", () => {
     expect(wrapper.text()).toContain("Request ID");
     expect(wrapper.text()).toContain("req-error-page-1");
   });
+
+  test("错误页展示可用于后台查询的完整诊断编号，保留独立 Request ID", () => {
+    const diagnosticId = "diag-019a1234-5678-7000-8000-000000000001";
+    const wrapper = render("maintenance", "req-independent", diagnosticId);
+    expect(wrapper.text()).toContain("诊断编号");
+    expect(wrapper.text()).toContain(diagnosticId);
+    expect(wrapper.text()).toContain("req-independent");
+  });
 });

package/template/apps/web/src/pages/errors/error-page-extension.ts

@@ -10,6 +10,7 @@ export interface ErrorPageProps {
   kind: ErrorPageKind;
   from: string;
   requestId?: string;
+  diagnosticId?: string;
 }
 
 export interface ErrorPageComponents {

package/template/apps/web/src/pages/system/AgentNativePage.vue

@@ -0,0 +1,44 @@
+<script setup lang="ts">
+import { onMounted, shallowRef } from "vue";
+import { Button } from "@/components/ui/button";
+import { apiRequest } from "@/services/http";
+const loading = shallowRef(false);
+const error = shallowRef("");
+async function open() {
+  if (loading.value) return;
+  loading.value = true;
+  error.value = "";
+  try {
+    const state = await apiRequest<{ status: string; reason?: string }>(
+      "/agent/workbench",
+    );
+    if (state.status === "available") window.location.assign("/agent");
+    else
+      error.value =
+        state.reason === "capacity-reserved"
+          ? "当前模型容量已为业务调用预留，请联系管理员配置工作台容量。"
+          : state.reason === "model-unconfigured"
+            ? "尚未配置可用模型。"
+            : "Agent 工作台暂不可用，请稍后手动重试。";
+  } catch (cause) {
+    error.value = cause instanceof Error ? cause.message : "工作台暂不可用";
+  } finally {
+    loading.value = false;
+  }
+}
+onMounted(open);
+</script>
+<template>
+  <section class="max-w-2xl space-y-4">
+    <h1 class="text-2xl font-semibold">Agent 原生工作台</h1>
+    <p class="text-sm text-muted-foreground">
+      在独立工作区中使用会话、文件与技能。当前登录与业务权限持续生效。
+    </p>
+    <p v-if="error" role="alert" class="text-sm text-destructive">
+      {{ error }}
+    </p>
+    <Button :disabled="loading" @click="open">{{
+      loading ? "正在连接…" : "打开工作台"
+    }}</Button>
+  </section>
+</template>

package/template/apps/web/src/pages/system/AgentWorkflowPage.vue

@@ -5,15 +5,25 @@ import { RefreshCwIcon } from "@lucide/vue";
 import { Button } from "@/components/ui/button";
 import WorkflowRunDetail from "./components/agent-workflow/WorkflowRunDetail.vue";
 import WorkflowRunList from "./components/agent-workflow/WorkflowRunList.vue";
+import WorkflowPresetCatalog from "./components/agent-workflow/WorkflowPresetCatalog.vue";
 import { useAgentWorkflowRuns } from "./composables/useAgentWorkflowRuns";
+import { useAgentWorkflowPresets } from "./composables/useAgentWorkflowPresets";
 
 const route = useRoute();
 const preferredRunId = computed(() => routeRunId(route.query.runId));
 const workflowState = useAgentWorkflowRuns({ preferredRunId });
+const presetState = useAgentWorkflowPresets();
 const refreshing = computed(
-  () => workflowState.listLoading.value || workflowState.detailLoading.value,
+  () =>
+    workflowState.listLoading.value ||
+    workflowState.detailLoading.value ||
+    presetState.loading.value,
 );
 
+async function refresh() {
+  await Promise.allSettled([workflowState.refresh(), presetState.refresh()]);
+}
+
 function routeRunId(value: LocationQueryValue | LocationQueryValue[]) {
   const candidate = Array.isArray(value) ? value[0] : value;
   const runId = candidate?.trim() ?? "";
@@ -35,18 +45,21 @@ function routeRunId(value: LocationQueryValue | LocationQueryValue[]) {
           页面不展示原始推理链、Prompt、Tool 参数或大对象结果。
         </p>
       </div>
-      <Button
-        variant="outline"
-        :disabled="refreshing"
-        @click="workflowState.refresh"
-      >
+      <Button variant="outline" :disabled="refreshing" @click="refresh">
         <RefreshCwIcon data-icon="inline-start" />
         {{ refreshing ? "刷新中..." : "刷新" }}
       </Button>
     </header>
 
+    <WorkflowPresetCatalog
+      :presets="presetState.presets.value"
+      :loading="presetState.loading.value"
+      :error="presetState.error.value"
+      @refresh="presetState.refresh"
+    />
+
     <div
-      class="grid gap-4 lg:h-[calc(100vh-12rem)] lg:min-h-[32rem] lg:grid-cols-[20rem_minmax(0,1fr)] lg:overflow-hidden"
+      class="grid gap-4 lg:min-h-[32rem] lg:grid-cols-[20rem_minmax(0,1fr)] lg:overflow-hidden"
     >
       <WorkflowRunList
         class="lg:min-h-0"

package/template/apps/web/src/pages/system/DiagnosticLookupPage.vue

@@ -0,0 +1,56 @@
+<script setup lang="ts">
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import DiagnosticRecordDetails from "./components/DiagnosticRecordDetails.vue";
+import { useDiagnosticLookup } from "./composables/useDiagnosticLookup";
+
+const { input, record, error, loading, lookup } = useDiagnosticLookup();
+</script>
+
+<template>
+  <div class="space-y-5">
+    <header class="space-y-2">
+      <h1 class="text-2xl font-semibold text-foreground">错误诊断</h1>
+      <p class="text-sm text-muted-foreground">
+        粘贴错误页面的诊断编号，查询当前部署最近 30
+        天的失败索引。每次有效编号查询都会留下审计记录。
+      </p>
+    </header>
+    <section class="rounded-xl border bg-card p-4">
+      <form class="space-y-3" :aria-busy="loading" @submit.prevent="lookup">
+        <label for="diagnostic-id" class="text-sm font-medium">诊断编号</label>
+        <div class="flex flex-col gap-2 sm:flex-row">
+          <Input
+            id="diagnostic-id"
+            name="diagnosticId"
+            autocapitalize="off"
+            autocorrect="off"
+            :spellcheck="false"
+            enterkeyhint="search"
+            v-model="input"
+            class="min-w-0 flex-1 font-mono"
+            placeholder="diag-… 或 web-…"
+            autocomplete="off"
+            :maxlength="128"
+            :aria-invalid="Boolean(error)"
+            aria-describedby="diagnostic-help diagnostic-error"
+          />
+          <Button type="submit" :disabled="loading || !input.trim()">
+            {{ loading ? "查询中…" : "查询诊断" }}
+          </Button>
+        </div>
+        <p id="diagnostic-help" class="text-xs text-muted-foreground">
+          diag-… 可查询服务端索引；web-…
+          是浏览器本地编号，需结合发生时间检查浏览器控制台。
+        </p>
+        <p id="diagnostic-error" role="alert" class="text-sm text-destructive">
+          {{ error }}
+        </p>
+        <p v-if="loading" role="status" class="text-sm text-muted-foreground">
+          正在查询失败索引…
+        </p>
+      </form>
+    </section>
+    <DiagnosticRecordDetails v-if="record" :record="record" />
+  </div>
+</template>

package/template/apps/web/src/pages/system/DiagnosticLookupPage.webtest.ts

@@ -0,0 +1,99 @@
+import { flushPromises, mount } from "@vue/test-utils";
+import { beforeEach, expect, test, vi } from "vitest";
+import DiagnosticLookupPage from "./DiagnosticLookupPage.vue";
+import { ApiError } from "@/services/http";
+
+const mocks = vi.hoisted(() => ({ request: vi.fn() }));
+vi.mock("@/services/diagnostics-api", () => ({ getDiagnostic: mocks.request }));
+const id = "diag-0199e82a-abcd-7000-8000-000000000000";
+const record = {
+  diagnosticId: id,
+  requestId: "req-internal",
+  occurredAt: "2026-10-15T02:00:00Z",
+  expiresAt: "2026-11-14T02:00:00Z",
+  service: "server",
+  stage: "http",
+  method: "POST",
+  route: "/api/resources/:id",
+  statusCode: 500,
+  errorCode: "UNEXPECTED_FAILURE",
+};
+beforeEach(() => {
+  mocks.request.mockReset();
+});
+
+async function submit(wrapper: ReturnType<typeof mount>, value: string) {
+  await wrapper.get("input").setValue(value);
+  await wrapper.get("form").trigger("submit");
+  await flushPromises();
+}
+
+test("queries trimmed id and displays real failure details with uncertainty", async () => {
+  mocks.request.mockResolvedValue(record);
+  const wrapper = mount(DiagnosticLookupPage);
+  await submit(wrapper, ` ${id} `);
+  expect(mocks.request).toHaveBeenCalledWith(id, expect.any(AbortSignal));
+  for (const value of [
+    "req-internal",
+    "UNEXPECTED_FAILURE",
+    "/api/resources/:id",
+    "500",
+    "当前记录未确定具体原因",
+  ])
+    expect(wrapper.text()).toContain(value);
+  wrapper.unmount();
+});
+
+test.each([
+  ["web-00000000-0000-0000-0000-000000000000", "浏览器本地编号"],
+  ["invalid", "格式无效"],
+])("handles %s locally without a request", async (value, message) => {
+  const wrapper = mount(DiagnosticLookupPage);
+  await submit(wrapper, value);
+  expect(mocks.request).not.toHaveBeenCalled();
+  expect(wrapper.get('[role="alert"]').text()).toContain(message);
+  wrapper.unmount();
+});
+
+test.each([
+  [403, "无权查询"],
+  [404, "未找到"],
+  [410, "超过 30 天"],
+  [503, "暂不可用"],
+])(
+  "shows HTTP %s inline and clears the preceding result",
+  async (status, message) => {
+    mocks.request
+      .mockResolvedValueOnce(record)
+      .mockRejectedValueOnce(new ApiError("private error", status));
+    const wrapper = mount(DiagnosticLookupPage);
+    await submit(wrapper, id);
+    await wrapper.get("form").trigger("submit");
+    await flushPromises();
+    expect(wrapper.text()).toContain(message);
+    expect(wrapper.text()).not.toContain("req-internal");
+    expect(wrapper.text()).not.toContain("private error");
+    wrapper.unmount();
+  },
+);
+
+test("changing input aborts lookup and ignores an obsolete response", async () => {
+  let resolve!: (value: typeof record) => void;
+  mocks.request.mockImplementation(
+    () =>
+      new Promise((done) => {
+        resolve = done;
+      }),
+  );
+  const wrapper = mount(DiagnosticLookupPage);
+  await wrapper.get("input").setValue(id);
+  await wrapper.get("form").trigger("submit");
+  expect(wrapper.get("button").attributes("disabled")).toBeDefined();
+  const signal = mocks.request.mock.calls[0]![1] as AbortSignal;
+  await wrapper.get("input").setValue("another-id");
+  expect(signal.aborted).toBe(true);
+  resolve(record);
+  await flushPromises();
+  expect(wrapper.text()).not.toContain("req-internal");
+  wrapper.unmount();
+});

package/template/apps/web/src/pages/system/SystemAgentSkillsPage.vue

@@ -0,0 +1,88 @@
+<script setup lang="ts">
+import { computed, shallowRef } from "vue";
+import { RefreshCwIcon, SearchIcon } from "@lucide/vue";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { useAccessSnapshot } from "@/composables/useAccessSnapshot";
+import AgentSkillsTable from "./components/agent-skills/AgentSkillsTable.vue";
+import AgentSkillDetailDialog from "./components/agent-skills/AgentSkillDetailDialog.vue";
+import AgentSkillGovernanceActionDialog from "./components/agent-skills/AgentSkillGovernanceActionDialog.vue";
+import AgentSkillImportDialog from "./components/agent-skills/AgentSkillImportDialog.vue";
+import { useAgentSkillsGovernance } from "./composables/useAgentSkillsGovernance";
+const skills = useAgentSkillsGovernance(),
+  access = useAccessSnapshot(),
+  importing = shallowRef(false);
+const canManage = computed(() =>
+  Boolean(
+    access.snapshot.value?.actor.permissionKeys.includes(
+      "system.agent-skill.manage",
+    ) &&
+    access.snapshot.value.features.find(
+      (feature) => feature.key === "system.agent-skill",
+    )?.allowed,
+  ),
+);
+</script>
+<template>
+  <div class="space-y-5">
+    <header
+      class="flex flex-col gap-3 md:flex-row md:items-start md:justify-between"
+    >
+      <div class="max-w-3xl space-y-2">
+        <h1 class="text-2xl font-semibold tracking-normal">Agent 技能治理</h1>
+        <p class="text-sm leading-6 text-muted-foreground">
+          管理内置与共享 DSH
+          技能的版本、范围和依赖。个人技能在工作台中管理；共享发布、停用和回滚都会留下审计记录。
+        </p>
+      </div>
+      <div class="flex gap-2">
+        <Button
+          variant="outline"
+          :disabled="skills.loading.value"
+          @click="skills.reload"
+          ><RefreshCwIcon data-icon="inline-start" />刷新</Button
+        ><Button v-if="canManage" @click="importing = true">导入发布</Button>
+      </div>
+    </header>
+    <label class="relative block max-w-md"
+      ><SearchIcon
+        class="absolute top-2.5 left-3 size-4 text-muted-foreground" /><Input
+        v-model="skills.query.value"
+        class="pl-9"
+        placeholder="搜索技能名称、标识或用途"
+        aria-label="搜索 Agent 技能"
+    /></label>
+    <p
+      v-if="skills.error.value"
+      role="alert"
+      class="rounded-md border border-destructive/30 bg-destructive/5 p-4 text-sm text-destructive"
+    >
+      {{ skills.error.value }}
+    </p>
+    <AgentSkillsTable
+      :items="skills.filtered.value"
+      :loading="skills.loading.value"
+      @select="skills.selected.value = $event"
+    />
+    <AgentSkillDetailDialog
+      :open="Boolean(skills.selected.value)"
+      :item="skills.selected.value"
+      @update:open="!$event && (skills.selected.value = undefined)"
+      @request-action="skills.requestAction"
+    />
+    <AgentSkillGovernanceActionDialog
+      :open="Boolean(skills.action.value)"
+      :action="skills.action.value"
+      :target-version="skills.targetVersion.value"
+      :loading="skills.actionLoading.value"
+      :error="skills.actionError.value"
+      @update:open="!$event && skills.closeAction()"
+      @confirm="skills.confirmAction"
+    />
+    <AgentSkillImportDialog
+      :open="importing"
+      @update:open="importing = $event"
+      @published="skills.reload"
+    />
+  </div>
+</template>

package/template/apps/web/src/pages/system/components/DiagnosticRecordDetails.vue

@@ -0,0 +1,52 @@
+<script setup lang="ts">
+import { computed } from "vue";
+import type { DiagnosticRecord } from "@/services/diagnostics-api";
+
+const props = defineProps<{ record: DiagnosticRecord }>();
+const fields = computed(() => [
+  ["诊断编号", props.record.diagnosticId],
+  ["错误码", props.record.errorCode],
+  ["HTTP 状态", props.record.statusCode],
+  ["发生时间", props.record.occurredAt],
+  ["保留截止", props.record.expiresAt],
+  ["服务", props.record.service],
+  ["失败阶段", props.record.stage],
+  ["请求方法", props.record.method],
+  ["路由模板", props.record.route],
+  ["内部请求编号（requestId）", props.record.requestId],
+]);
+</script>
+
+<template>
+  <section
+    class="space-y-4 rounded-xl border bg-card p-4"
+    aria-labelledby="diagnostic-result"
+  >
+    <h2 id="diagnostic-result" class="font-semibold">失败记录</h2>
+    <dl class="grid gap-4 sm:grid-cols-2">
+      <div
+        v-for="[label, value] in fields"
+        :key="label"
+        class="min-w-0 space-y-1"
+      >
+        <dt class="text-xs text-muted-foreground">{{ label }}</dt>
+        <dd class="font-mono text-sm break-all select-text">{{ value }}</dd>
+      </div>
+    </dl>
+    <div class="space-y-2 rounded-lg bg-muted p-3 text-sm">
+      <p v-if="record.errorCode === 'UNEXPECTED_FAILURE'">
+        当前记录未确定具体原因。UNEXPECTED_FAILURE
+        表示未分类异常，不能据此判断为数据库、权限或文件格式问题。
+      </p>
+      <p>
+        继续排查：按内部请求编号（requestId）和发生时间检索 Server
+        结构化日志，确认失败阶段与原因； 如日志关联后台任务或 Agent
+        Run，再到对应任务或 AI 运行时查看详情。
+      </p>
+      <p class="text-muted-foreground">
+        此处展示受控失败索引，不包含异常堆栈或业务正文。时间使用接口返回的 UTC
+        时间（Z）。
+      </p>
+    </div>
+  </section>
+</template>