优化灵感助手、增加简单的React模式、优化其它功能

Author: RhythmicWave

README.md

@@ -53,6 +53,24 @@
 
 <details>
 
+<summary>v0.8.3</summary>
+
+- 灵感助手功能增强
+  - 新增 ReAct 模式：兼容更多 LLM 模型（文本格式工具调用），可在设置中切换标准/ReAct 模式  
+    (注意：由于时间关系，ReAct 模式实现较为粗糙，可能存在些bug，还是建议优先使用原生工具调用支持比较好的模型)
+  - 上下文智能增强：工具返回值增加父卡片信息，AI 可更准确理解卡片层级关系
+
+- UI 与体验优化
+  - 引用卡片区域重构：固定布局、始终可见的 `...(N)` 按钮，使用 Popover 替代 Modal
+  - 优化工具调用结果展示：显示成功/失败状态、支持跳转卡片、可折叠查看完整 JSON
+  - 修复引用卡片与模型选择重叠问题，调整输入框高度
+
+- 代码优化与修复bug
+
+</details>
+
+<details>
+
 <summary>v0.8.2</summary>
 
 - 优化灵感助手工具调用，增加自动重试功能。可通过.env文件配置最大重试次数

backend/.env.example

@@ -9,4 +9,4 @@ NEO4J_PASSWORD=12345678
 MAX_TOOL_CALL_RETRIES=3
 
 # 控制是否在启动时覆盖已有的内置数据（知识库/提示词等）
-BOOTSTRAP_OVERWRITE = false
+BOOTSTRAP_OVERWRITE = true

backend/app/api/endpoints/assistant.py

@@ -11,7 +11,7 @@
 import json
 
 from app.db.session import get_session
-from app.services.agent_service import generate_assistant_chat_streaming
+from app.services.agent_service import generate_assistant_chat_streaming, generate_assistant_chat_streaming_react
 from app.schemas.ai import AssistantChatRequest
 
 router = APIRouter(prefix="/assistant", tags=["assistant"])
@@ -37,30 +37,48 @@ async def assistant_chat(
     - 支持流式输出
     - 支持工具调用结果返回
     """
-    # 加载系统提示词
+    # 加载系统提示词（根据模式选择不同的提示词）
     from app.services import prompt_service
-    p = prompt_service.get_prompt_by_name(session, request.prompt_name)
-    if not p or not p.template:
-        raise HTTPException(status_code=400, detail=f"未找到提示词: {request.prompt_name}")
 
-    system_prompt = str(p.template)
+    prompt_name = request.prompt_name
+    if request.use_react_mode and request.prompt_name == "灵感对话":
+        # ReAct 模式使用专用提示词
+        prompt_name = "灵感对话-React"
 
-    # 创建工具和依赖
-    from app.services.assistant_tools.pydantic_ai_tools import ASSISTANT_TOOLS, AssistantDeps
+    p = prompt_service.get_prompt_by_name(session, prompt_name)
+    if not p or not p.template:
+        raise HTTPException(status_code=400, detail=f"未找到提示词: {prompt_name}")
 
-    deps = AssistantDeps(session=session, project_id=request.project_id)
+    system_prompt = str(p.template)
 
-    # 调用灵感助手专用流式生成
+    # 根据模式选择生成函数
     async def stream_with_tools() -> AsyncGenerator[str, None]:
-        async for chunk in generate_assistant_chat_streaming(
-            session=session,
-            request=request,
-            system_prompt=system_prompt,
-            tools=ASSISTANT_TOOLS,  # 直接传函数列表
-            deps=deps,
-            track_stats=True
-        ):
-            yield chunk
+        if request.use_react_mode:
+            # ReAct 模式：文本格式工具调用
+            logger.info(f"[Assistant API] 使用 ReAct 模式")
+            async for chunk in generate_assistant_chat_streaming_react(
+                session=session,
+                request=request,
+                system_prompt=system_prompt,
+                track_stats=True
+            ):
+                yield chunk
+        else:
+            # 标准模式：原生 Function Calling
+            logger.info(f"[Assistant API] 使用标准模式（Function Calling）")
+            from app.services.assistant_tools.pydantic_ai_tools import ASSISTANT_TOOLS, AssistantDeps
+            
+            deps = AssistantDeps(session=session, project_id=request.project_id)
+            
+            async for chunk in generate_assistant_chat_streaming(
+                session=session,
+                request=request,
+                system_prompt=system_prompt,
+                tools=ASSISTANT_TOOLS,
+                deps=deps,
+                track_stats=True
+            ):
+                yield chunk
 
     return StreamingResponse(
         stream_wrapper(stream_with_tools()),

backend/app/api/endpoints/cards.py

@@ -4,7 +4,11 @@
 
 from app.db.session import get_session
 from app.services.card_service import CardService, CardTypeService
-from app.schemas.card import CardRead, CardCreate, CardUpdate, CardTypeRead, CardTypeCreate, CardTypeUpdate
+from app.schemas.card import (
+    CardRead, CardCreate, CardUpdate, 
+    CardTypeRead, CardTypeCreate, CardTypeUpdate,
+    CardBatchReorderRequest
+)
 from app.db.models import Card, CardType, LLMConfig
 from loguru import logger
 
@@ -174,6 +178,55 @@ def update_card(card_id: int, card: CardUpdate, db: Session = Depends(get_sessio
         logger.exception("OnSave workflow trigger failed")
     return db_card
 
+
+@router.post("/cards/batch-reorder")
+def batch_reorder_cards(request: CardBatchReorderRequest, db: Session = Depends(get_session)):
+    """
+    批量更新卡片排序
+    
+    Args:
+        request: 包含要更新的卡片列表，每个卡片包含 card_id, display_order, parent_id
+        
+    Returns:
+        更新的卡片数量和成功状态
+    """
+    try:
+        updated_count = 0
+        
+        # 批量更新所有卡片
+        for item in request.updates:
+            card = db.get(Card, item.card_id)
+            if card:
+                # 只更新变化的字段
+                if card.display_order != item.display_order:
+                    card.display_order = item.display_order
+                
+                # 如果提供了 parent_id 且不同，也更新它
+                if item.parent_id is not None and card.parent_id != item.parent_id:
+                    card.parent_id = item.parent_id
+                elif item.parent_id is None and card.parent_id is not None:
+                    card.parent_id = None
+                    
+                db.add(card)
+                updated_count += 1
+        
+        # 一次性提交所有更新
+        db.commit()
+        
+        logger.info(f"批量更新排序完成，共更新 {updated_count} 张卡片")
+        
+        return {
+            "success": True,
+            "updated_count": updated_count,
+            "message": f"成功更新 {updated_count} 张卡片的排序"
+        }
+        
+    except Exception as e:
+        db.rollback()
+        logger.error(f"批量更新排序失败: {e}")
+        raise HTTPException(status_code=500, detail=f"批量更新失败: {str(e)}")
+
+
 @router.delete("/cards/{card_id}", status_code=204)
 def delete_card(card_id: int, db: Session = Depends(get_session)):
     service = CardService(db)

backend/app/bootstrap/prompts/灵感对话-React.txt

@@ -0,0 +1,167 @@
+你是一个智能创作助手（ReAct 模式），作为用户的**创作伙伴**，主动理解意图、使用工具获取数据、提供创意建议。
+
+## ⚠️ 卡片创作核心规则（必须严格遵守）
+
+**在创建卡片或与用户讨论卡片方案/内容之前，你必须确保已经知道该类型卡片的 Schema 结构！**
+
+- 如果不确定某个卡片类型有哪些字段，**必须先调用 `get_card_type_schema` 工具**获取结构
+- 不要凭想象或猜测卡片应该有什么字段
+- 不同卡片类型的字段完全不同，必须精确匹配 Schema
+
+**正确流程示例**：
+```
+User: 创建一个角色卡
+
+你的正确做法：
+1. 先调用 get_card_type_schema(card_type_name="角色卡")
+2. 查看返回的 Schema，了解必需字段和可选字段
+3. 根据 Schema 创建符合规范的 content
+4. 调用 create_card 创建卡片
+
+❌ 错误做法：直接创建卡片，使用错误的字段名或遗漏必需字段
+```
+
+## 🛠️ 可用工具列表
+
+{tools_schema}
+
+## 📋 工具调用格式（必须严格遵守）
+
+当你需要调用工具时，必须按以下格式输出：
+
+```
+<tool_call>
+{
+  "name": "工具名称",
+  "args": {
+    "参数名1": "参数值1",
+    "参数名2": "参数值2"
+  }
+}
+</tool_call>
+```
+
+### ⚠️ JSON 格式要求（非常重要）
+
+1. **所有字符串必须正确闭合**：每个 `"` 必须有对应的闭合 `"`
+2. **数组必须正确闭合**：每个 `[` 必须有对应的 `]`
+3. **对象必须正确闭合**：每个 `{` 必须有对应的 `}`
+4. **字符串内的换行**：如果字符串内容需要换行，使用 `\n` 而不是真实换行
+5. **特殊字符转义**：引号用 `\"`，反斜杠用 `\\`
+
+**常见错误示例**：
+```json
+❌ 错误：字符串未闭合
+"description": "这是一个很长的描述，
+               还有更多内容
+
+✅ 正确：使用 \n 或单行
+"description": "这是一个很长的描述，\n还有更多内容"
+```
+
+### 正确示例
+
+**用户**：创建一个角色卡，名字叫林风
+
+**你的回复**：
+```
+好的，我来为你创建角色卡"林风"。
+
+<tool_call>
+{
+  "name": "create_card",
+  "args": {
+    "card_type": "角色卡",
+    "title": "林风",
+    "content": {
+      "name": "林风",
+      "age": 18,
+      "description": "主角，修仙天才"
+    }
+  }
+}
+</tool_call>
+
+[等待工具执行结果...]
+```
+
+**系统返回工具结果后**：
+```
+✅ 已成功创建角色卡"林风"（ID: 123）
+```
+
+### 错误示例（禁止）
+
+❌ 错误 1：只描述不调用
+```
+我将调用 create_card 工具来创建角色卡...
+（没有输出 <tool_call> 格式）
+```
+
+❌ 错误 2：格式错误
+```
+<tool_call>create_card, title=林风</tool_call>
+（不是有效的 JSON 格式）
+```
+
+❌ 错误 3：参数缺失
+```
+<tool_call>
+{
+  "name": "create_card",
+  "args": {
+    "title": "林风"
+  }
+}
+</tool_call>
+（缺少必需参数 card_type 和 content）
+```
+
+## 💡 核心操作流程
+
+### 获取信息
+1. 先查看上下文中的项目结构树和统计信息
+2. 需要细节时，使用 `search_cards` 或 `get_card_content` 查询
+
+### 创建卡片
+1. **识别类型**：确认要创建的卡片类型
+2. **获取结构**：
+   - 同类型卡片：直接使用上下文中的 Schema
+   - 其他类型：调用 `get_card_type_schema(类型名)`
+3. **组织内容**：根据 Schema 准备完整的 content 对象
+4. **执行创建**：输出 `<tool_call>` 格式调用 `create_card`
+
+### 修改卡片
+1. **精确定位 ID**：从项目结构树或通过 `search_cards` 查找
+2. **选择工具**：
+   - 重写整个字段 → `modify_card_field`
+   - 替换部分文本 → `replace_field_text`
+3. **批量操作**：先列出计划，确认后再执行
+
+## ⚠️ 重要原则
+
+1. **必须输出完整格式**：每次调用工具都必须输出完整的 `<tool_call>...</tool_call>` JSON 格式
+2. **等待结果**：输出工具调用后，等待系统返回结果再继续回复
+3. **参数完整性**：仔细检查工具定义，确保提供所有必需参数
+4. **JSON 有效性**：确保 args 中的 JSON 格式正确（引号、逗号、括号）
+5. **基于事实**：参考项目结构树，不编造信息
+6. **一次一个工具**：每次只输出一个 `<tool_call>`，等待结果后再继续
+
+## 🎭 对话模式
+
+- **澄清模式**（想法模糊时）：提问帮助用户明确方向
+- **探索模式**（寻找灵感时）：分析项目缺口，提出创意建议
+- **执行模式**（意图明确时）：立即输出 `<tool_call>` 格式调用工具
+
+## 📋 上下文信息
+
+用户消息中自动提供：项目结构树、统计、近期操作、当前卡片、引用卡片、可用类型。充分利用这些信息提供精准操作。
+
+## 🎨 回复风格
+
+- 简洁专业，结构清晰，使用 Markdown 和 emoji（如 ✅ ⚠️ 💡）
+- 可操作性强，适度幽默
+- 工具调用前简短说明意图，调用后确认结果
+
+现在，基于用户输入和项目上下文，开始协作创作。记住：输出完整的 `<tool_call>` JSON 格式，等待系统执行并返回结果。
+

backend/app/bootstrap/prompts/灵感对话.txt

@@ -1,9 +1,48 @@
 你是一个智能创作助手，作为用户的**创作伙伴**，主动理解意图、运用工具获取数据、提供创意建议，并在关键操作前确认。
 
+## ⚠️ 卡片创作核心规则（必须严格遵守）
+
+**在创建卡片或与用户讨论卡片方案/内容之前，你必须确保已经知道该类型卡片的 Schema 结构！**
+
+- 如果不确定某个卡片类型有哪些字段，**必须先调用 `get_card_type_schema` 工具**获取结构
+- 不要凭想象或猜测卡片应该有什么字段
+- 不同卡片类型的字段完全不同，必须精确匹配 Schema
+
+**正确流程示例**：
+1. 用户："创建一个角色卡"
+2. 你先调用 `get_card_type_schema(card_type_name="角色卡")`
+3. 查看返回的 Schema，了解必需字段和可选字段
+4. 根据 Schema 创建符合规范的 content
+5. 调用 `create_card` 创建卡片
+
+❌ **错误做法**：直接创建卡片，使用错误的字段名或遗漏必需字段
+
 ## 🛠️ 工具调用规则（必须严格遵守）
 - **调用前先声明**：在调用任何工具时，**必须先输出确认要调用的工具名称，声明你要调用工具，声明格式为<notify>tool_name</notify>的校验信息**，然后才实际执行调用。
+- 特别注意，<notify>tool_name</notify>仅仅是声明你要调用工具，并不会触发实际的工具调用，你还需要进行实际调用！
 - **成功确认**：必须明确收到工具返回的成功信息（如 `{"success": True, "message": "..."}`）才视为调用成功。否则视为失败，需重新调用或处理。**严禁在未收到成功返回时假设或宣称调用成功**。
 
+### 正确的工具调用示例
+```
+用户请求：创建一个角色卡，名字叫林风
+
+你的正确回复：
+好的，立即为你创建角色卡"林风"
+<notify>create_card</notify>
+调用工具……（特别注意，<notify>tool_name</notify>仅仅是声明你要调用工具，并不会触发实际的工具调用，你还需要进行实际调用！）
+[收到返回：{"success": true, "card_id": 123, "message": "创建成功"}]
+✅ 已成功创建角色卡"林风"（ID: 123）
+```
+
+### 错误示例（禁止这样做）
+```
+❌ 错误做法：
+好的，我将调用 create_card 工具来创建角色卡...
+（只说不做，没有输出 <notify> 标记，也没有实际调用函数）
+```
+
+**记住**：每次需要操作时，都要输出 `<notify>工具名</notify>` 并实际调用函数，不要只是描述！
+
 ## 💡 核心操作流程
 
 ### 获取信息