@oscloudlab/vgen-agent-assistant 0.0.16 → 0.0.17

package/dist/types/src/api/index.d.ts

@@ -1,7 +1,7 @@
 import { SSEChatEvents } from '../../utils/sseForChat';
 import { addTaskProps } from '../components/VgenAgent/type';
 
-export declare const getUserInfo: () => Promise<import('axios').AxiosResponse<any, any, {}>>;
+export declare const getUserInfo: () => Promise<import('axios').AxiosResponse<any, any, {}, any>>;
 export declare const createSession: (params: {
     btype: number;
     dataType?: number;

package/dist/types/src/components/BottomChatDock/ResultCard.d.ts

@@ -0,0 +1,13 @@
+import { DiffCardPayload, DockResultData } from '../VgenAgent/type';
+
+export interface ResultCardProps {
+    data: DockResultData;
+    /** diffViewer 组件透传注入，未提供时隐藏差异区 */
+    customDiffViewer?: (payload: DiffCardPayload, opts?: {
+        mode?: 'inline' | 'modal';
+    }) => React.ReactNode;
+    onAccept: () => void;
+    onReject: () => void;
+}
+declare const ResultCard: React.FC<ResultCardProps>;
+export default ResultCard;

package/dist/types/src/components/BottomChatDock/dockVM.d.ts

@@ -0,0 +1,30 @@
+import { AdjustmentKind, MessageProps, QuickChip } from '../VgenAgent/type';
+
+/** 剥离思考流包裹标签，保留内容文本（思考中=思考文本，正文流=正文） */
+export declare const stripThinkWrap: (content: string) => string;
+/** 饼干 IP 形象头像 */
+export declare const COOKIE_AVATAR = "https://mdn.alipayobjects.com/huamei_1aoktl/afts/img/W3rjTYQLpoEAAAAAUEAAAAgADieFAQJr/df.webp?hm_biz=muse_style";
+/** 底部常驻框提示词随卡片状态变化 */
+export declare const dockHint: (state: "fresh" | "adjusted" | "expanded") => string;
+/** 有引用（选中段落）时的建议：只保留学习提问与轻量调整 */
+export declare const QUOTE_CHIPS: QuickChip[];
+/** 无引用（直接展开）时的建议：整体学习 + 调整能力 */
+export declare const GENERAL_CHIPS: QuickChip[];
+/** 饼干意图识别 */
+export declare const detectIntent: (text: string) => AdjustmentKind | null;
+export declare const INTENT_REPLY: Record<AdjustmentKind, {
+    text: string;
+    cta: string;
+    label: string;
+}>;
+/**
+ * MessageProps[]（头插，最新在前）→ dock 消息列表过滤视图（保持头插序，渲染层内部反转）
+ * 规则：
+ * - 仅保留 user/ai 角色的 TEXT 与本地 dock 消息（extraInfo.dockAction/dockResult），
+ *   跳过 INVISIBLE_TEXT / NODE / 表单与资源锚点类
+ *   （dock 定位轻量问答与调整，其余资源卡 v1 仍在弹窗查看）
+ * - 资源编辑差异锚点（rel_resource_edit）例外放行：
+ *   dock 内可完整交互（查看差异弹窗 + 确认「确认保存」/取消「暂不变更」）
+ * - 不做任何文本转换：引用 <<<>>> 分段、思考流等均由 MessageContent 统一承载渲染
+ */
+export declare const toDockChatMessages: (messages: MessageProps[]) => MessageProps[];

package/dist/types/src/components/BottomChatDock/index.d.ts

@@ -0,0 +1,4 @@
+import { BottomChatDockProps } from '../VgenAgent/type';
+
+declare const BottomChatDock: React.FC<BottomChatDockProps>;
+export default BottomChatDock;

package/dist/types/src/components/BottomChatPanel/index.d.ts

@@ -0,0 +1,4 @@
+import { BottomChatPanelProps } from '../VgenAgent/type';
+
+declare const BottomChatPanel: React.FC<BottomChatPanelProps>;
+export default BottomChatPanel;

package/dist/types/src/components/MyReactMarldown/index.d.ts

@@ -1,5 +1,5 @@
 
 declare const MyReactMarkdown: import('react').MemoExoticComponent<({ children }: {
     children: string;
-}) => import("react/jsx-runtime").JSX.Element>;
+}) => import("react").JSX.Element>;
 export default MyReactMarkdown;

package/dist/types/src/components/VgenAgent/components/MessageContent.d.ts

@@ -1,6 +1,6 @@
 import { default as React } from 'react';
 import { agentScene } from '../../../../utils/consts';
-import { MessageProps, recommendVideosProps, saveMsgProps } from '../type';
+import { CustomDiffViewerOpts, DiffCardPayload, MessageProps, recommendVideosProps, saveMsgProps } from '../type';
 
 interface MessageContentProps {
     messages: MessageProps[];
@@ -29,6 +29,8 @@ interface MessageContentProps {
     cookieConsume?: number;
     progress?: number;
     saveMsg?: (msg: saveMsgProps) => void;
+    /** diffViewer 组件透传注入：资源编辑差异锚点（rel_resource_edit）「查看差异」弹窗渲染，未注入时点击降级提示 */
+    customDiffViewer?: (payload: DiffCardPayload, opts?: CustomDiffViewerOpts) => React.ReactNode;
 }
 declare const _default: React.NamedExoticComponent<MessageContentProps>;
 export default _default;

package/dist/types/src/components/VgenAgent/messageTypeContainer/ResourceEditMsg.d.ts

@@ -0,0 +1,17 @@
+import { CustomDiffViewerOpts, DiffCardPayload } from '../type';
+
+export interface ResourceEditMsgProps {
+    /** rel_resource_edit 消息 extraInfo 解析对象（diff/title/action/dataId/status/traceId/dataType/originalContent） */
+    extraInfo: any;
+    /** diffViewer 组件透传注入（与 VgenAgentProps.customDiffViewer 同签名），未注入时点击「查看差异」给出提示 */
+    customDiffViewer?: (payload: DiffCardPayload, opts?: CustomDiffViewerOpts) => React.ReactNode;
+    /** 发送消息：确认/取消变更时向当前会话发送指令文案 */
+    handleSend?: (props: {
+        input: string;
+        isInitial?: boolean;
+        scene?: string;
+        chatId?: number;
+    }) => void;
+}
+declare const ResourceEditMsg: React.FC<ResourceEditMsgProps>;
+export default ResourceEditMsg;

package/dist/types/src/components/VgenAgent/type.d.ts

@@ -1,4 +1,4 @@
-import { CSSProperties, ReactNode } from 'react';
+import { ComponentType, CSSProperties, ReactNode } from 'react';
 
 export interface VgenAgentProps {
     containerRef: any;
@@ -12,6 +12,37 @@ export interface VgenAgentProps {
     hoverTip?: string;
     isDev?: boolean;
     chatId?: number;
+    /** 是否同时渲染底部悬浮对话框（与浮球/弹窗并存，共享同一会话状态），默认 false */
+    showDock?: boolean;
+    /** 是否渲染右下角悬浮 AI 学伴浮球（含其点击展开的弹窗形态），默认 true；
+     *  置 false 隐藏浮球，聊天交互完全由 BottomChatDock 承载（配合 showDock 使用） */
+    showFloatingBall?: boolean;
+    /** dock 初始是否展开 */
+    dockInitOpen?: boolean;
+    /**
+     * BottomChatDock 布局形态（追加，不动原行为）：
+     * - float（缺省）：底部悬浮浮窗，fixed 定位悬浮在内容之上，原行为不变
+     * - inline：左侧固定面板，参与宿主布局流、在宿主布局左侧占据固定宽度的一列并与卡片同高（内容区相应缩窄）
+     */
+    dockLayout?: 'float' | 'inline';
+    /** inline 固定面板展开态列宽（number 时按 px），缺省 320 */
+    dockPanelWidth?: number | string;
+    /** 外部 ref 转调（setQuotedText/sendMsg）的默认目标形态，弹窗保持旧行为不受影响 */
+    quoteTarget?: 'modal' | 'dock' | 'both';
+    /** diffViewer 组件透传注入：结果卡差异区渲染（未注入时隐藏差异区）；
+     *  资源编辑差异锚点（rel_resource_edit）以 modal 形态调用，opts 携带确认/取消回调 */
+    customDiffViewer?: (payload: DiffCardPayload, opts?: CustomDiffViewerOpts) => ReactNode;
+    /** dock 快捷 chips（send 模式）点击回调，未提供时默认按 label 直接发送 */
+    onDockQuickAction?: (label: string) => void;
+    /** dock 意图 CTA 点击回调（未提供时 dock 不渲染 CTA 按钮） */
+    onDockCta?: (kind: AdjustmentKind, ctx: {
+        userText: string;
+        quote?: string;
+    }) => void;
+    /** dock 结果卡：采纳 */
+    onDockResultAccept?: (kind: AdjustmentKind, payload: DiffCardPayload) => void;
+    /** dock 结果卡：不采纳 */
+    onDockResultReject?: (kind: AdjustmentKind) => void;
 }
 export type viewModeType = 'video' | 'course' | 'knowledgeCard' | 'default';
 export interface videoInfoProps {
@@ -48,6 +79,7 @@ export declare enum msgType {
     INVISIBLE_TEXT = "invisible_text",// 不可见文本消息
     REL_PLAN_TASK = "rel_plan_task",// 计划任务锚点
     REL_EVALUATION = "rel_evaluation",// 评测记录锚点
+    REL_RESOURCE_EDIT = "rel_resource_edit",// 关联资源内容编辑差异锚点
     TASK_TIP = "task_tip",// 任务提醒
     TASK_EDIT = "task_edit"
 }
@@ -234,10 +266,126 @@ export interface sessionProps {
 }
 /** VgenAgent 组件 Ref 类型定义 */
 export interface VgenAgentRefProps {
-    /** 设置引用文本并打开输入面板 */
-    setQuotedText: (val: string) => void;
-    /** 发送消息 */
-    sendMsg: (val: string) => void;
+    /** 设置引用文本并打开输入面板（opts.target 可指定进入弹窗 / dock / 两者；缺省走 quoteTarget 属性默认弹窗，行为与旧版一致） */
+    setQuotedText: (val: string, opts?: {
+        target?: 'modal' | 'dock' | 'both';
+        open?: boolean;
+    }) => void;
+    /** 发送消息（opts.target 可指定弹窗 / dock；缺省走 quoteTarget 属性，行为与旧版一致） */
+    sendMsg: (val: string, opts?: {
+        target?: 'modal' | 'dock' | 'both';
+    }) => void;
+    /** 打开底部悬浮对话框（showDock 启用时生效） */
+    openDock?: () => void;
+    /** 关闭底部悬浮对话框 */
+    closeDock?: () => void;
+}
+/** 意图调整类型 */
+export type AdjustmentKind = 'polish' | 'edit' | 'anim-regen' | 'anim-optimize' | 'quiz';
+/** diffViewer 透传 payload(与主项目 components/DiffViewer 的 DiffCardPayload 结构一致) */
+export interface DiffCardPayload {
+    original: string;
+    new: string;
+    diff?: string;
+    title?: string;
+}
+/** diffViewer 透传调用参数（与主项目 components/DiffViewer 的 customDiffViewer opts 结构保持一致）
+ *  onConfirmChange / onCancelChange 传入时，宿主 diff 组件应渲染「确认变更 / 取消变更」按钮并触发回调 */
+export interface CustomDiffViewerOpts {
+    /** inline：内嵌形态（dock 结果卡差异区）；modal：弹窗形态（资源编辑差异锚点「查看差异」） */
+    mode?: 'inline' | 'modal';
+    onConfirmChange?: () => void;
+    onCancelChange?: () => void;
+}
+/** dock 快捷 chip */
+export interface QuickChip {
+    icon: ComponentType<{
+        className?: string;
+    }>;
+    label: string;
+    /** 点击后的行为：prefill 表示只填入输入框等用户补充，否则直接发送 */
+    mode?: 'send' | 'prefill';
+    /** prefill 时填入输入框的文字 */
+    fill?: string;
+}
+/** dock 结果卡数据（结果卡内差异区由 customDiffViewer 渲染） */
+export interface DockResultData {
+    kind: AdjustmentKind;
+    title?: string;
+    /** 结果摘要文本 */
+    summary?: string;
+    payload: DiffCardPayload;
+}
+/** dock 展示层消息（遗留视图模型：dock 消息渲染已统一由 MessageContent 承载，类型保留供宿主回调签名使用） */
+export interface DockMessage {
+    id: string | number;
+    role: 'user' | 'cookie';
+    text: string;
+    /** 引用原文（用户从正文选中后带入） */
+    quote?: string;
+    /** 饼干正在打字生成 */
+    typing?: boolean;
+    /** 生成中断，提供继续 / 重新开始 */
+    interrupted?: boolean;
+    action?: {
+        kind: AdjustmentKind;
+        label: string;
+        cta: string;
+        /** 触发该意图的原始用户输入 */
+        userText?: string;
+    };
+    /** 结果卡片（差异区由 customDiffViewer 渲染 + 采纳/不采纳） */
+    result?: DockResultData;
+}
+export interface BottomChatDockProps {
+    /** 卡片状态 → 收起态把手提示词（dockHint 三态文案），缺省 'fresh' */
+    state?: 'fresh' | 'adjusted' | 'expanded';
+    /**
+     * dock 消息列表（MessageProps[] 头插序，宿主用 toDockChatMessages 从 controller.messages
+     * 纯过滤派生）；渲染与主聊天统一，全部由 MessageContent 组件承载
+     */
+    messages: MessageProps[];
+    /** 宿主用户信息（MessageContent 渲染用户头像） */
+    userInfo?: any;
+    /** 是否开发环境（与主聊天一致，控制消息内链接域名） */
+    isDev?: boolean;
+    /** 外部控制展开（引用/润色等流程会自动展开对话框） */
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onSend: (text: string) => void;
+    /** 当前回答是否已完成；false 表示正在流式回答，输入区按钮将切换为"停止回答" */
+    answerIsDone?: boolean;
+    /** 停止正在进行的回答（中断 SSE 流式输出） */
+    onStopAnswer?: () => void;
+    onQuickAction: (label: string) => void;
+    onCta: (m: DockMessage) => void;
+    /** 是否渲染意图 CTA 按钮（宿主提供 onDockCta 时为 true） */
+    ctaEnabled?: boolean;
+    /** 结果卡片：采纳 */
+    onAccept: (m: DockMessage) => void;
+    /** 结果卡片：不采纳 */
+    onReject: (m: DockMessage) => void;
+    /** 生成中断后继续（v1 = 携带上文重新发送） */
+    onResume: (m: DockMessage) => void;
+    /** 已引用到输入框的原文 */
+    quote: string | null;
+    onClearQuote: () => void;
+    /** diffViewer 组件透传注入（结果卡差异区渲染，未注入时结果卡隐藏差异区）；
+     *  资源编辑差异锚点以 modal 形态调用，opts 含确认/取消变更回调 */
+    customDiffViewer?: (payload: DiffCardPayload, opts?: CustomDiffViewerOpts) => ReactNode;
+}
+/**
+ * 左侧固定形态面板（追加形态，不影响 BottomChatDock 浮窗）：
+ * 与 BottomChatDock 共享同一套聊天 controller 与会话数据（props 完全兼容），
+ * 差异仅在定位 —— 非悬浮fixed，而是参与宿主布局流的常驻块，
+ * 在宿主布局左侧占据固定宽度的一列并与卡片同高
+ * （宿主提供挂载槽位，见 KnowledgeCard bottomDockLayout='inline' 布局）
+ */
+export interface BottomChatPanelProps extends BottomChatDockProps {
+    /** 展开态面板列宽（number 按 px 处理），缺省 320；收起态固定为左侧窄竖条，仍在布局内占位 */
+    width?: number | string;
+    /** 是否支持收起为左侧窄竖条（不提供时缺省 true，收起后仍在布局中占位） */
+    collapsible?: boolean;
 }
 export interface addTaskProps {
     id?: number;

package/dist/types/src/hooks/useVgenChat.d.ts

@@ -0,0 +1,73 @@
+import { agentScene, courseInfoProps, knowledgeInfoProps, MessageProps, resourceType, saveMsgProps, sessionProps, videoInfoProps, viewModeType } from '../components/VgenAgent/type';
+
+export interface UseVgenChatProps {
+    token: string;
+    viewMode: viewModeType;
+    isDev?: boolean;
+    chatId?: number;
+    videoInfo?: videoInfoProps;
+    courseInfo?: courseInfoProps;
+    knowledgeInfo?: knowledgeInfoProps;
+}
+export interface VgenChatController {
+    isLogin: boolean;
+    userInfo: any;
+    messages: MessageProps[];
+    saveMsg: (props: saveMsgProps) => Promise<void>;
+    insertLocalMsg: (content: string, extraInfo?: any) => number;
+    toUpdateMsgs: () => Promise<void>;
+    toGetHistoryList: (sessionId: number) => Promise<void>;
+    loadMoreHistory: () => Promise<void>;
+    handleSend: (props: {
+        input: string;
+        isInitial?: boolean;
+        scene?: string;
+        chatId?: number;
+        quotedText?: string;
+    }) => Promise<void>;
+    /** dock 通道发送（引用文本显式入参，复用 handleSend 同一链路） */
+    sendDockMessage: (text: string, quote?: string | null) => void;
+    stopAnswer: () => void;
+    answerIsDone: boolean;
+    inputValue: string;
+    setInputValue: (v: string) => void;
+    sceneNow: string;
+    setSceneNow: (s: string) => void;
+    inputPlaceholder: string;
+    setInputPlaceholder: (s: string) => void;
+    enableGlobalSearch: boolean;
+    setEnableGlobalSearch: (b: boolean) => void;
+    quotedText: string;
+    setQuotedTextData: (text: string) => void;
+    dockQuotedText: string | null;
+    setDockQuotedText: (t: string | null) => void;
+    dockOpen: boolean;
+    setDockOpen: (open: boolean) => void;
+    dockHintState: 'fresh' | 'adjusted' | 'expanded';
+    setDockHintState: (s: 'fresh' | 'adjusted' | 'expanded') => void;
+    interruptedMsgIds: Set<string | number>;
+    chatId: number;
+    setChatId: (id: number | ((prev: number) => number)) => void;
+    sessionList: sessionProps[];
+    generatedResources: resourceType[];
+    recommendScene: agentScene;
+    recommendSceneData: any;
+    cookieConsume: number;
+    progress: number;
+    hasMoreBefore: boolean;
+    chatVideoUrl: string;
+    analyzeUrlNow: string;
+    setAnalyzeUrlNow: (s: string) => void;
+    confirmAnalyzeModalVisible: boolean;
+    setConfirmAnalyzeModalVisible: (b: boolean) => void;
+    analyzeMsgShouldSave: boolean;
+    setAnalyzeMsgShouldSave: (b: boolean) => void;
+    confirmAnalyze: (url: string, showSend?: boolean) => void;
+    analyzeVideo: (url: string) => void;
+    videoAnalyzeCallback: (analyzeRes: any) => void;
+    /** 视图打开时调用（幂等）：满足登录态后仅初始化一次会话 */
+    activate: () => void;
+    addNewSession: () => void;
+    toDeleteSession: (id: number) => void;
+}
+export declare const useVgenChat: (props: UseVgenChatProps) => VgenChatController;

package/dist/types/src/index.d.ts

@@ -1,3 +1,11 @@
 import { default as VgenAgent } from './components/VgenAgent';
+import { default as BottomChatDock } from './components/BottomChatDock';
+import { default as BottomChatPanel } from './components/BottomChatPanel';
+import { useVgenChat } from './hooks/useVgenChat';
+import { COOKIE_AVATAR, detectIntent, GENERAL_CHIPS, INTENT_REPLY, QUOTE_CHIPS, dockHint } from './components/BottomChatDock/dockVM';
 
 export default VgenAgent;
+export { BottomChatDock, BottomChatPanel, useVgenChat, COOKIE_AVATAR, detectIntent, GENERAL_CHIPS, INTENT_REPLY, QUOTE_CHIPS, dockHint, };
+export { msgType, agentScene } from './components/VgenAgent/type';
+export type { VgenAgentProps, VgenAgentRefProps, viewModeType, videoInfoProps, knowledgeInfoProps, courseInfoProps, MessageProps, resourceType, recommendVideosProps, chatMsgResProps, saveMsgProps, sessionProps, AdjustmentKind, DiffCardPayload, QuickChip, DockResultData, DockMessage, BottomChatDockProps, BottomChatPanelProps, } from './components/VgenAgent/type';
+export type { VgenChatController, UseVgenChatProps } from './hooks/useVgenChat';