feat: surface AgentKit build logs in Studio deployments

docs/content/docs/framework/troubleshooting.en.mdx

@@ -31,6 +31,17 @@ This page collects common issues you may hit when using VeADK, grouped by setup,
 ## Development
 
 <Accordions>
+  <Accordion title="ruff or pyright is not found locally">
+    Your local development environment may include the test dependencies but not the static-checking tools. Install them into the current project virtual environment:
+
+    ```bash
+    uv pip install ruff pyright
+    uv run ruff --version
+    uv run pyright --version
+    ```
+
+    After installation, use `uv run ruff check ...` and `uv run pyright ...`. If checking historical files reports many existing issues, separate problems introduced by the current change from the repository's existing baseline so a feature branch does not mix in a large unrelated cleanup.
+  </Accordion>
   <Accordion title="After setting the Volcengine AK/SK, fetching the model API Key fails">
     VeADK does not automatically create a Volcengine Ark platform API Key for you. Please create your API Key on the Volcengine Ark platform. For detailed steps, see the [documentation](https://www.volcengine.com/docs/82379/1361424), or go directly to the [console entry](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey?apikey=%7B%7D).
   </Accordion>

docs/content/docs/framework/troubleshooting.mdx

@@ -31,6 +31,17 @@ title: "常见问题"
 ## 开发环节
 
 <Accordions>
+  <Accordion title="本地运行 ruff 或 pyright 时提示命令不存在">
+    当前开发环境可能只安装了测试依赖，未安装静态检查工具。可将工具安装到当前项目虚拟环境：
+
+    ```bash
+    uv pip install ruff pyright
+    uv run ruff --version
+    uv run pyright --version
+    ```
+
+    安装后即可使用 `uv run ruff check ...` 和 `uv run pyright ...`。如果检查历史文件时出现大量既有问题，请优先区分当前改动引入的问题和仓库已有基线问题，避免在功能分支中混入大规模无关修复。
+  </Accordion>
   <Accordion title="设置火山引擎 AK/SK 后，提示获取模型 API Key 失败">
     VeADK 不会帮助您自动创建火山引擎方舟平台 API Key，请您在火山方舟平台创建您的 API Key。具体步骤可见[文档](https://www.volcengine.com/docs/82379/1361424)，或直接进入[控制台入口](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey?apikey=%7B%7D)。
   </Accordion>

frontend/src/adk/client.ts

@@ -1240,13 +1240,32 @@ export interface DeployAgentkitResult {
   };
 }
 
+export interface DeployBuildLogSnapshot {
+  source: "code-pipeline";
+  status: "running" | "complete" | "error";
+  text: string;
+  lineCount: number;
+  truncated: boolean;
+  omittedEarly?: boolean;
+  snapshotTruncated?: boolean;
+  updatedAt: number;
+  pipelineId?: string;
+  pipelineName?: string;
+  pipelineRunId?: string;
+  workspaceId?: string;
+  workspaceName?: string;
+  error?: string;
+  pendingMessage?: string;
+}
+
 /** One live progress frame streamed during a deployment. */
 export interface DeployStage {
   level: "info" | "success" | "warning" | "error";
   phase: "build" | "deploy" | "publish" | string;
   message: string;
   pct?: number;
   runtimeName?: string;
+  buildLog?: DeployBuildLogSnapshot;
 }
 
 interface DeployFrame extends Partial<DeployAgentkitResult> {

frontend/src/ui/AgentWorkspace.css

@@ -1047,6 +1047,126 @@
   color: hsl(var(--foreground) / 0.78);
 }
 
+.aw-deploy-step-log {
+  min-width: 0;
+  margin-top: 10px;
+}
+
+.aw-deploy-log {
+  min-width: 0;
+  border: 1px solid hsl(var(--border));
+  border-radius: 10px;
+  background: hsl(var(--canvas));
+  overflow: hidden;
+}
+
+.aw-deploy-log header,
+.aw-deploy-log header > div,
+.aw-deploy-log-actions,
+.aw-deploy-log-actions button {
+  display: flex;
+  align-items: center;
+}
+
+.aw-deploy-log header {
+  min-width: 0;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 10px 12px;
+  border-bottom: 1px solid hsl(var(--border));
+  background: hsl(var(--panel));
+}
+
+.aw-deploy-log.is-collapsed header {
+  border-bottom: 0;
+}
+
+.aw-deploy-log header > div:first-child {
+  min-width: 0;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 2px;
+}
+
+.aw-deploy-log strong {
+  color: hsl(var(--foreground));
+  font-size: 12.5px;
+  font-weight: 640;
+  line-height: 1.35;
+}
+
+.aw-deploy-log span {
+  min-width: 0;
+  color: hsl(var(--muted-foreground));
+  font-size: 11px;
+  line-height: 1.35;
+}
+
+.aw-deploy-log-actions {
+  flex: 0 0 auto;
+  gap: 6px;
+}
+
+.aw-deploy-log-actions button {
+  min-height: 28px;
+  gap: 5px;
+  padding: 0 8px;
+  border: 1px solid hsl(var(--border));
+  border-radius: 6px;
+  background: hsl(var(--panel));
+  color: hsl(var(--foreground));
+  font-size: 11.5px;
+  font-weight: 560;
+  cursor: pointer;
+}
+
+.aw-deploy-log-actions button:hover {
+  background: hsl(var(--muted));
+}
+
+.aw-deploy-log-actions button span {
+  color: inherit;
+  font-size: inherit;
+  line-height: inherit;
+}
+
+.aw-deploy-log-actions button:focus-visible {
+  outline: 2px solid hsl(var(--ring));
+  outline-offset: 1px;
+}
+
+.aw-deploy-log-actions svg {
+  width: 13px;
+  height: 13px;
+  flex: 0 0 auto;
+}
+
+.aw-deploy-log pre {
+  max-height: 260px;
+  min-width: 0;
+  margin: 0;
+  padding: 12px;
+  overflow: auto;
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  word-break: break-word;
+  color: hsl(var(--foreground) / 0.86);
+  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
+  font-size: 11.5px;
+  line-height: 1.55;
+}
+
+.aw-deploy-log-empty {
+  padding: 12px;
+  color: hsl(var(--muted-foreground));
+  font-size: 12px;
+  line-height: 1.5;
+}
+
+.aw-deploy-log.is-error {
+  border-color: hsl(6 32% 80%);
+}
+
 .aw-card-head {
   justify-content: space-between;
   gap: 12px;