用户引导

This commit is contained in:
董宏凯 committed 2026-08-26 09:41:53 +08:00
1 parent 62a3faa7c8
commit c6fcf51e0c
12 files changed
+785 -77

No files matched your search

+62 -19
View File
@@ -1,6 +1,6 @@
"use client";
import { BotIcon, PlusSquare } from "lucide-react";
import { BotIcon, Compass, PlusSquare } from "lucide-react";
import { useParams, useRouter } from "next/navigation";
import { useLocation } from "react-router-dom";
import { useRouteBase } from "@/core/route-base";
@@ -11,6 +11,11 @@ import { Button } from "@/components/ui/button";
import { AgentChatSidebar } from "@/components/workspace/agents/agent-chat-sidebar";
import { AgentDetailPanel } from "@/components/workspace/agents/agent-detail-panel";
import { AgentQuestionChips } from "@/components/workspace/agents/agent-question-chips";
import {
AgentGuide,
isAgentGuideEnvironment,
startAgentGuide,
} from "@/components/workspace/agents/agent-guide";
import { AgentWelcome } from "@/components/workspace/agent-welcome";
import { ArtifactTrigger } from "@/components/workspace/artifacts";
import { ChatBox, useThreadChat } from "@/components/workspace/chats";
@@ -559,6 +564,10 @@ export default function AgentChatPage({
// 3qfx/xdfx(taskBind)不展示闸门,新建对话进问答页后由右上角「开始回答」按钮手动发出开场信息。
const showTaskGate = !!taskGate && !!taskId && isNewThread && !hasStartedConversation;
const isDemoMode = env.NEXT_PUBLIC_STATIC_WEBSITE_ONLY === "true";
// 智能体使用引导(chat 阶段):仅普通智能体对话页 —— 排除通用问答原地嵌入
// (embeddedAgentId)、任务深链工作区(taskGate/taskBind)等复用本页的场景。
const agentGuideEligible =
!!showAgentList && !isEmbedded && !taskCtxOn && isAgentGuideEnvironment();
const status = thread.error
? "error"
@@ -575,7 +584,14 @@ export default function AgentChatPage({
panel stays rightmost. */}
<div className="flex size-full min-h-0 overflow-hidden workspace-chat-bg">
{/* 最左:智能体列表栏(仅独立整页问答开启)。顶部下拉切换 我的/广场。 */}
{showAgentList && <AgentChatSidebar activeAgentId={agent_id} />}
{showAgentList && (
<div
data-agent-guide="chat-sidebar"
className="flex h-full shrink-0"
>
<AgentChatSidebar activeAgentId={agent_id} />
</div>
)}
<div className="min-h-0 min-w-0 flex-1">
<ChatBox threadId={threadId}>
{/* Main conversation column. `relative` hosts the floating
@@ -598,6 +614,20 @@ export default function AgentChatPage({
</div>
<div className="flex items-center">
{/* 智能体使用引导(chat 阶段)手动重放入口。 */}
{agentGuideEligible && (
<Tooltip content="重新播放智能体使用引导">
<Button
size="sm"
variant="ghost"
className="text-muted-foreground hover:text-foreground mr-1"
onClick={() => startAgentGuide("chat")}
>
<Compass className="size-4" />
使用引导
</Button>
</Tooltip>
)}
{/* 「模板数据转换器」专属:选页面模板 + 渲染预览(调试该智能体效果)。 */}
{isTemplateBuilder && (
<div className="mr-2 flex items-center gap-1.5">
@@ -688,13 +718,17 @@ export default function AgentChatPage({
className="mb-7"
/>
<div className="w-full max-w-(--container-width-md)">
<AgentQuestionChips
className="mb-3"
questions={commonQuestions}
disabled={isDemoMode}
onAsk={(text) => handleSubmit({ text, files: [] })}
/>
<div className="min-w-0 flex-1">
<div data-agent-guide="chat-questions" className="mb-3">
<AgentQuestionChips
questions={commonQuestions}
disabled={isDemoMode}
onAsk={(text) => handleSubmit({ text, files: [] })}
/>
</div>
<div
className="min-w-0 flex-1"
data-agent-guide="chat-input"
>
<InputBox
className="w-full"
isNewThread
@@ -756,7 +790,10 @@ export default function AgentChatPage({
/>
<div className="from-background pointer-events-none shrink-0 bg-gradient-to-t to-transparent px-4 pb-4 pt-2">
<div className="pointer-events-auto mx-auto w-full max-w-(--container-width-lg)">
<div
className="pointer-events-auto mx-auto w-full max-w-(--container-width-lg)"
data-agent-guide="chat-input"
>
<TodoList
className="bg-background/5 mb-2"
todos={thread.values.todos ?? []}
@@ -805,16 +842,22 @@ export default function AgentChatPage({
</div>
{/* Right: agent detail panel — always the rightmost column. */}
<AgentDetailPanel
agent={agent}
agentName={agentDisplayName}
disabled={thread.isLoading || isDemoMode}
onAskQuestion={(text) => handleSubmit({ text, files: [] })}
defaultCollapsed={taskCtxOn}
showRecentChats={!taskCtxOn}
compactAppearanceActions={compactAppearanceActions}
/>
<div
data-agent-guide="chat-detail"
className="flex h-full shrink-0"
>
<AgentDetailPanel
agent={agent}
agentName={agentDisplayName}
disabled={thread.isLoading || isDemoMode}
onAskQuestion={(text) => handleSubmit({ text, files: [] })}
defaultCollapsed={taskCtxOn}
showRecentChats={!taskCtxOn}
compactAppearanceActions={compactAppearanceActions}
/>
</div>
</div>
<AgentGuide stage="chat" eligible={agentGuideEligible} />
{/* 「模板数据转换器」调试预览弹窗(仅此 agent)。 */}
{isTemplateBuilder && (