feat: world map visualization + demo data + UI polish

- pyvis interactive force-directed graph (dark fantasy theme)
- Color-coded nodes: locations(blue), NPCs(green), quests(gold)
- Auto-refresh map and history after dream submission
- Pre-seeded 3 example dreams for demo
- Gradio 6.0 API compatibility
- History tab with grouped dream display

app.py

@@ -1,8 +1,16 @@
 """DreamLand - AI Dream RPG Engine. HF Spaces entry point."""
 
+import gradio as gr
 from ui.main import create_app
+import config
 
 app = create_app()
 
 if __name__ == "__main__":
-    app.launch(server_name="0.0.0.0", server_port=7860)
+    css = config.STYLE_CSS.read_text(encoding="utf-8") if config.STYLE_CSS.exists() else ""
+    app.launch(
+        server_name="0.0.0.0",
+        server_port=7860,
+        theme=gr.themes.Soft(),
+        css=css,
+    )

seed_demo.py

@@ -0,0 +1,95 @@
+"""Pre-populate the world with example dreams for demo purposes."""
+
+from pathlib import Path
+from core.models import Entity, DreamEntry
+from core.world import WorldGraph
+
+
+def seed_demo_data():
+    """Seed the world graph with 3 example dreams for demonstration."""
+    world = WorldGraph()
+
+    # Only seed if world is empty
+    if world.get_all_entities():
+        return
+
+    # Dream 1: Crystal City
+    dream1 = DreamEntry(
+        raw_text="梦见自己在一座漂浮的水晶城市中飞翔，遇到一位银发的精灵守望者。",
+        emotions=["惊奇", "自由"],
+        summary="在漂浮水晶城市中飞翔",
+    )
+    world.add_dream_node(dream1)
+
+    loc1 = Entity(id="loc_crystal", name="幽光水晶城", entity_type="location",
+                  description="悬浮在云层之上的透明城市，建筑由纯净水晶折射星光而成。城中央矗立一座巨大的棱镜塔，将阳光分解为七色彩虹洒满街道。",
+                  dream_id=dream1.id, metadata={"emotions": ["惊奇", "自由"]})
+    npc1 = Entity(id="npc_guardian", name="银发精灵守望者", entity_type="npc",
+                  description="银白色长发随风飘舞的精灵，蓝色眼睛如星辰般闪烁。她守护水晶城已有千年。",
+                  dialog="旅人，你终于来了。水晶之心的碎片散落在世界各地，你是被选中的人。",
+                  dream_id=dream1.id, location_id="loc_crystal")
+    quest1 = Entity(id="quest_crystal", name="寻找水晶碎片", entity_type="quest",
+                    description="收集散落在世界各处的三块水晶碎片，修复水晶之心，让城市重现光芒。奖励：获得飞行能力。",
+                    dream_id=dream1.id, giver_id="npc_guardian", location_id="loc_crystal",
+                    quest_status="active")
+    world.add_location(loc1)
+    world.add_npc(npc1)
+    world.add_quest(quest1)
+
+    # Dream 2: Deep Sea Library
+    dream2 = DreamEntry(
+        raw_text="梦见潜入深海，发现一座被珊瑚覆盖的古老图书馆，一位神秘老人在翻阅发光的书页。",
+        emotions=["神秘", "敬畏"],
+        summary="探索深海中的古老图书馆",
+    )
+    world.add_dream_node(dream2)
+
+    loc2 = Entity(id="loc_library", name="深海遗忘图书馆", entity_type="location",
+                  description="沉没在海底深渊的宏伟图书馆，珊瑚和贝壳覆盖了大理石柱。书架上陈列着用海水文字书写的古籍，每一页都在幽幽发光。",
+                  dream_id=dream2.id, metadata={"emotions": ["神秘", "敬畏"]})
+    npc2 = Entity(id="npc_librarian", name="失落馆长", entity_type="npc",
+                  description="身披海藻长袍的老者，胡须中缠绕着发光的水母。他的眼睛深邃如海沟，似乎知晓世间一切秘密。",
+                  dialog="知识如潮水，来去无踪。你想找的那本书，在第三层的贝壳书架上。",
+                  dream_id=dream2.id, location_id="loc_library")
+    quest2 = Entity(id="quest_book", name="寻找命运之书", entity_type="quest",
+                    description="在图书馆深处找到记载你命运的那本书。但要小心——每翻一页，记忆就会消失一段。奖励：获得深海呼吸能力。",
+                    dream_id=dream2.id, giver_id="npc_librarian", location_id="loc_library",
+                    quest_status="active")
+    world.add_location(loc2)
+    world.add_npc(npc2)
+    world.add_quest(quest2)
+
+    # Add connections between dreams
+    world.add_relation("loc_crystal", "loc_library", "connects_to")
+
+    # Dream 3: Dragon Mountain
+    dream3 = DreamEntry(
+        raw_text="梦见攀爬一座被火焰环绕的山峰，山顶盘踞着一条沉睡的金色巨龙。",
+        emotions=["紧张", "兴奋"],
+        summary="攀爬龙焰山面对沉睡巨龙",
+    )
+    world.add_dream_node(dream3)
+
+    loc3 = Entity(id="loc_dragon", name="龙焰山", entity_type="location",
+                  description="高耸入云的火山，山体表面流淌着岩浆纹路。空气中弥漫着硫磺与古老的气息，每一步都能感受到大地的脉动。",
+                  dream_id=dream3.id, metadata={"emotions": ["紧张", "兴奋"]})
+    npc3 = Entity(id="npc_dragon", name="金鳞巨龙·炎阳", entity_type="creature",
+                  description="沉睡千年的金色巨龙，鳞片如黄金般闪耀。它的呼吸化为温暖的气流，梦境中它微微睁开了一只眼睛。",
+                  dialog="渺小的梦境旅者...你身上有水晶的气息。去吧，碎片就在我的翅膀之下。",
+                  dream_id=dream3.id, location_id="loc_dragon")
+    quest3 = Entity(id="quest_scale", name="获取龙鳞", entity_type="quest",
+                    description="在不惊醒巨龙的情况下，从它的翅膀下取得一块脱落的金色龙鳞。这是修复水晶之心的最后一件材料。奖励：获得火焰抗性。",
+                    dream_id=dream3.id, giver_id="npc_dragon", location_id="loc_dragon",
+                    quest_status="active")
+    world.add_location(loc3)
+    world.add_npc(npc3)
+    world.add_quest(quest3)
+
+    # Connect locations
+    world.add_relation("loc_library", "loc_dragon", "connects_to")
+
+    print(f"Demo data seeded: {world.stats()}")
+
+
+if __name__ == "__main__":
+    seed_demo_data()

ui/dream_tab.py

@@ -7,9 +7,11 @@ from core.parser import parse_dream
 from core.generator import generate_location, generate_npc, generate_quest
 from core.world import WorldGraph
 from core.model_manager import ModelManager
+from ui.map_tab import _generate_map_html
+from ui.history_tab import _get_history_md
 
 
-def process_dream(dream_text: str, image_path: str = None) -> tuple[str, str, str]:
+def process_dream(dream_text: str, image_path: str = None) -> tuple:
     """Main pipeline: dream text -> parse -> generate -> update world.
 
     Returns:
@@ -31,9 +33,9 @@ def process_dream(dream_text: str, image_path: str = None) -> tuple[str, str, st
 
     if not parse_result.entities:
         return (
-            "无法从梦境中提取足够的信息，请尝试输入更详细的描述。",
-            _get_map_html(world),
-            _get_history_md(world),
+            "❌ 无法从梦境中提取足够的信息，请尝试输入更详细的描述。",
+            _generate_map_html(),
+            _get_history_md(),
         )
 
     # Create dream entry
@@ -58,11 +60,9 @@ def process_dream(dream_text: str, image_path: str = None) -> tuple[str, str, st
             location = generate_location(entity, context, gen)
             world.add_location(location)
 
-            # Generate NPC for this location
             npc = generate_npc(entity, location, context, gen)
             world.add_npc(npc)
 
-            # Generate quest from this NPC
             quest = generate_quest(npc, location, context, gen)
             world.add_quest(quest)
 
@@ -70,7 +70,6 @@ def process_dream(dream_text: str, image_path: str = None) -> tuple[str, str, st
             dream.entities.extend([location, npc, quest])
 
         elif entity.entity_type in ("npc", "creature"):
-            # NPC entity — create a placeholder location first
             locations = world.get_entities_by_type("location")
             parent_location = locations[-1] if locations else Entity(
                 name="未知之地", entity_type="location", description="梦境的模糊边界"
@@ -88,15 +87,14 @@ def process_dream(dream_text: str, image_path: str = None) -> tuple[str, str, st
             dream.entities.extend([npc, quest])
 
         else:
-            # Items and other entities — add directly
             entity.dream_id = dream.id
             world.add_entity(entity)
             dream.entities.append(entity)
 
-    # Step 3: Format result markdown
+    # Step 3: Format and return all three outputs
     result_md = _format_results(parse_result.summary, parse_result.emotions, generated_results)
 
-    return result_md, _get_map_html(world), _get_history_md(world)
+    return result_md, _generate_map_html(), _get_history_md()
 
 
 def _format_results(summary: str, emotions: list[str], results: list) -> str:
@@ -105,7 +103,7 @@ def _format_results(summary: str, emotions: list[str], results: list) -> str:
     lines.append(f"**情绪基调:** {', '.join(emotions)}\n")
 
     for location, npc, quest in results:
-        lines.append(f"---\n")
+        lines.append("---")
         lines.append(f"### 📍 {location.name}")
         lines.append(f"{location.description}\n")
         lines.append(f"### 👤 {npc.name}")
@@ -118,76 +116,17 @@ def _format_results(summary: str, emotions: list[str], results: list) -> str:
     return "\n".join(lines)
 
 
-def _get_map_html(world: WorldGraph) -> str:
-    """Generate pyvis HTML for the world map."""
-    try:
-        from pyvis.network import Network
-
-        vis_data = world.to_vis_data()
-        if not vis_data["nodes"]:
-            return "<p>还没有世界数据。记录你的第一个梦境吧！</p>"
-
-        net = Network(
-            height="500px",
-            width="100%",
-            bgcolor="#1a1a2e",
-            font_color="white",
-            directed=True,
-        )
-        net.barnes_hut(gravity=-3000, central_gravity=0.3)
-
-        for node in vis_data["nodes"]:
-            net.add_node(
-                node["id"],
-                label=node["label"],
-                color=node["color"],
-                shape=node["shape"],
-                title=node.get("title", ""),
-            )
-
-        for edge in vis_data["edges"]:
-            net.add_edge(
-                edge["from"],
-                edge["to"],
-                label=edge.get("label", ""),
-                color="#555555",
-            )
-
-        return net.generate_html()
-
-    except ImportError:
-        # Fallback: simple text representation
-        stats = world.stats()
-        return f"<p>世界统计: {stats['total_nodes']} 节点, {stats['total_edges']} 连接</p>"
-
-
-def _get_history_md(world: WorldGraph) -> str:
-    """Generate history markdown from world state."""
-    entities = world.get_all_entities()
-    if not entities:
-        return "暂无梦境记录。"
-
-    lines = ["### 梦境世界概览\n"]
-    stats = world.stats()
-    lines.append(f"**总节点:** {stats['total_nodes']} | **总连接:** {stats['total_edges']}\n")
-
-    by_type = stats.get("by_type", {})
-    lines.append(f"📍 地点: {by_type.get('location', 0)} | 👤 NPC: {by_type.get('npc', 0)} | ⚔️ 任务: {by_type.get('quest', 0)}")
-
-    return "\n".join(lines)
-
-
 def create_dream_tab() -> tuple:
     """Create the dream input tab UI components."""
     with gr.Row():
         with gr.Column(scale=1):
             dream_input = gr.Textbox(
-                label="描述你的梦境",
+                label="🌙 描述你的梦境",
                 placeholder="昨晚我梦见自己在一座漂浮的水晶城市中飞翔...",
                 lines=6,
             )
             image_input = gr.Image(
-                label="梦境图片（可选）",
+                label="🎨 梦境图片（可选）",
                 type="filepath",
                 height=150,
             )
@@ -199,10 +138,4 @@ def create_dream_tab() -> tuple:
                 value="*等待你的第一个梦境...*",
             )
 
-    submit_btn.click(
-        fn=process_dream,
-        inputs=[dream_input, image_input],
-        outputs=[result_display],
-    )
-
-    return (result_display,)
+    return submit_btn, dream_input, image_input, result_display

ui/history_tab.py

@@ -5,7 +5,7 @@ import gradio as gr
 from core.world import WorldGraph
 
 
-def get_history_display() -> str:
+def _get_history_md() -> str:
     """Generate the dream history display as Markdown."""
     world = WorldGraph()
     entities = world.get_all_entities()
@@ -15,7 +15,18 @@ def get_history_display() -> str:
 
     lines = ["## 📖 梦境编年史\n"]
 
-    # Group by dream source
+    # Stats overview
+    stats = world.stats()
+    by_type = stats.get("by_type", {})
+    lines.append(
+        f"📍 地点: **{by_type.get('location', 0)}** | "
+        f"👤 NPC: **{by_type.get('npc', 0)}** | "
+        f"⚔️ 任务: **{by_type.get('quest', 0)}** | "
+        f"🔗 连接: **{stats['total_edges']}**\n"
+    )
+    lines.append("---\n")
+
+    # Group entities by dream source
     dream_groups: dict[str, list] = {}
     for e in entities:
         if e.entity_type == "dream":
@@ -23,39 +34,38 @@ def get_history_display() -> str:
         key = e.dream_id or "unlinked"
         dream_groups.setdefault(key, []).append(e)
 
-    stats = world.stats()
-    lines.append(f"**世界规模:** {stats['total_nodes']} 节点 · {stats['total_edges']} 连接\n")
-    lines.append("---\n")
-
-    # Display each dream's entities
+    # Display each dream's generated content
     for i, (dream_id, ents) in enumerate(reversed(list(dream_groups.items())), 1):
         locations = [e for e in ents if e.entity_type == "location"]
         npcs = [e for e in ents if e.entity_type == "npc"]
         quests = [e for e in ents if e.entity_type == "quest"]
+        items = [e for e in ents if e.entity_type == "item"]
 
         lines.append(f"### 🌙 梦境 #{i}\n")
 
-        if locations:
-            for loc in locations:
-                lines.append(f"**📍 {loc.name}** — {loc.description[:80]}...\n")
+        for loc in locations:
+            desc_preview = loc.description[:80].replace("\n", " ")
+            lines.append(f"**📍 {loc.name}** — {desc_preview}...\n")
+
+        for npc in npcs:
+            desc_preview = npc.description[:60].replace("\n", " ")
+            dialog = f' *"{npc.dialog}"*' if npc.dialog else ""
+            lines.append(f"**👤 {npc.name}** — {desc_preview}...{dialog}\n")
 
-        if npcs:
-            for npc in npcs:
-                dialog = f' *"{npc.dialog}"*' if npc.dialog else ""
-                lines.append(f"**👤 {npc.name}** — {npc.description[:60]}...{dialog}\n")
+        for q in quests:
+            desc_preview = q.description[:80].replace("\n", " ")
+            lines.append(f"**⚔️ {q.name}** — {desc_preview}...\n")
 
-        if quests:
-            for q in quests:
-                lines.append(f"**⚔️ {q.name}** — {q.description[:80]}...\n")
+        for item in items:
+            lines.append(f"**📦 {item.name}** — {item.description[:60]}\n")
 
         lines.append("---\n")
 
     return "\n".join(lines)
 
 
-def create_history_tab() -> gr.Markdown:
+def create_history_tab() -> tuple:
     """Create the dream history tab UI."""
-    display = gr.Markdown(value=get_history_display())
-    refresh_btn = gr.Button("🔄 刷新历史")
-    refresh_btn.click(fn=get_history_display, outputs=[display])
-    return display
+    display = gr.Markdown(value=_get_history_md())
+    refresh_btn = gr.Button("🔄 刷新历史", variant="secondary")
+    return display, refresh_btn

ui/main.py

@@ -3,9 +3,9 @@
 import gradio as gr
 
 import config
-from ui.dream_tab import create_dream_tab
-from ui.map_tab import create_map_tab
-from ui.history_tab import create_history_tab
+from ui.dream_tab import create_dream_tab, process_dream
+from ui.map_tab import create_map_tab, _generate_map_html
+from ui.history_tab import create_history_tab, _get_history_md
 
 
 def create_app() -> gr.Blocks:
@@ -14,19 +14,38 @@ def create_app() -> gr.Blocks:
     if config.STYLE_CSS.exists():
         css = config.STYLE_CSS.read_text(encoding="utf-8")
 
-    with gr.Blocks(
-        title=config.GRADIO_TITLE,
-        theme=gr.themes.Soft(),
-        css=css,
-    ) as app:
-        gr.Markdown(f"# {config.GRADIO_TITLE}\n{config.GRADIO_DESCRIPTION}")
+    with gr.Blocks(title=config.GRADIO_TITLE) as app:
+        gr.Markdown(f"# 🌙 {config.GRADIO_TITLE}\n{config.GRADIO_DESCRIPTION}")
 
         with gr.Tabs():
+            # Tab 1: Dream Input
             with gr.Tab("Dream Input"):
-                dream_outputs = create_dream_tab()
+                submit_btn, dream_input, image_input, result_display = create_dream_tab()
+
+            # Tab 2: World Map
             with gr.Tab("World Map"):
                 map_display = create_map_tab()
+
+            # Tab 3: Dream History
             with gr.Tab("Dream History"):
-                history_display = create_history_tab()
+                history_display, history_refresh = create_history_tab()
+
+        # Wire submit button to update ALL three tabs
+        submit_btn.click(
+            fn=process_dream,
+            inputs=[dream_input, image_input],
+            outputs=[result_display, map_display, history_display],
+        )
+
+        # Wire history refresh button
+        history_refresh.click(
+            fn=_get_history_md,
+            outputs=[history_display],
+        )
 
     return app
+
+
+if __name__ == "__main__":
+    app = create_app()
+    app.launch(server_name="0.0.0.0", server_port=7860)

ui/map_tab.py

@@ -1,20 +1,21 @@
-"""World map visualization tab."""
+"""World map visualization tab using pyvis for interactive graph rendering."""
 
 import gradio as gr
 
 from core.world import WorldGraph
 
 
-def get_map_html() -> str:
-    """Generate the current world map HTML."""
+def _generate_map_html() -> str:
+    """Generate the interactive world map HTML using pyvis."""
     world = WorldGraph()
     vis_data = world.to_vis_data()
 
     if not vis_data["nodes"]:
         return """
-        <div style="text-align:center; padding:60px; color:#888;">
-            <h2>🌍 世界尚未开始</h2>
-            <p>记录你的第一个梦境，世界地图将在这里展开...</p>
+        <div style="text-align:center; padding:80px 20px; color:#888; font-family:Georgia,serif;">
+            <div style="font-size:48px; margin-bottom:16px;">🌍</div>
+            <h2 style="color:#b8a9ff; margin-bottom:8px;">世界尚未开始</h2>
+            <p style="color:#666; font-size:14px;">记录你的第一个梦境，世界地图将在这里展开...</p>
         </div>
         """
 
@@ -24,39 +25,116 @@ def get_map_html() -> str:
         net = Network(
             height="600px",
             width="100%",
-            bgcolor="#1a1a2e",
-            font_color="white",
+            bgcolor="#0f0f1a",
+            font_color="#e0e0e0",
             directed=True,
         )
-        net.barnes_hut(gravity=-3000, central_gravity=0.3, spring_length=200)
+
+        # Physics settings for dreamy layout
+        net.barnes_hut(
+            gravity=-5000,
+            central_gravity=0.3,
+            spring_length=200,
+            spring_strength=0.05,
+            damping=0.09,
+        )
+
+        # Node styling by type
+        NODE_STYLES = {
+            "location": {"color": "#4a9eff", "shape": "dot", "size": 35, "border": "#2d7dd2"},
+            "npc":      {"color": "#50c878", "shape": "diamond", "size": 25, "border": "#3da35d"},
+            "quest":    {"color": "#ffd700", "shape": "star", "size": 25, "border": "#ccac00"},
+            "item":     {"color": "#ff6b6b", "shape": "triangle", "size": 20, "border": "#cc5555"},
+            "creature": {"color": "#ff9f43", "shape": "triangleDown", "size": 20, "border": "#cc7700"},
+            "dream":    {"color": "#9b59b6", "shape": "square", "size": 15, "border": "#7d3c98"},
+        }
 
         for node in vis_data["nodes"]:
+            style = NODE_STYLES.get(node["type"], NODE_STYLES["location"])
+            tooltip = f"<b>{node['label']}</b><br>{node.get('title', '')}"
             net.add_node(
                 node["id"],
                 label=node["label"],
-                color=node["color"],
-                shape=node["shape"],
-                title=node.get("title", ""),
-                size=25 if node["type"] == "location" else 15,
+                color={
+                    "background": style["color"],
+                    "border": style["border"],
+                    "highlight": {"background": "#ffffff", "border": style["color"]},
+                },
+                shape=style["shape"],
+                size=style["size"],
+                title=tooltip,
+                borderWidth=2,
+                shadow=True,
             )
 
+        # Edge styling
+        EDGE_COLORS = {
+            "resides_at": "#50c878",
+            "located_at": "#4a9eff",
+            "given_by": "#ffd700",
+            "from_dream": "#9b59b6",
+            "connects_to": "#666666",
+            "related_to": "#888888",
+        }
+
         for edge in vis_data["edges"]:
+            relation = edge.get("label", "")
+            color = EDGE_COLORS.get(relation, "#555555")
             net.add_edge(
                 edge["from"],
                 edge["to"],
-                label=edge.get("label", ""),
-                color="#555555",
+                label=relation,
+                color={"color": color, "highlight": "#ffffff"},
+                width=1.5,
+                arrows={"to": {"enabled": True, "scaleFactor": 0.5}},
+                smooth={"type": "curvedCW", "roundness": 0.2},
             )
 
-        return net.generate_html()
+        # Generate HTML with custom styling
+        html = net.generate_html()
+
+        # Inject custom CSS for dark theme
+        custom_css = """
+        <style>
+            body { background-color: #0f0f1a !important; margin: 0; }
+            #mynetwork {
+                border: 1px solid #333366;
+                border-radius: 12px;
+            }
+        </style>
+        """
+        html = html.replace("</head>", custom_css + "</head>")
+
+        # Add legend
+        legend = """
+        <div style="display:flex; gap:16px; padding:12px; justify-content:center;
+                    background:#16162a; border-radius:8px; margin-bottom:8px; font-size:13px;">
+            <span style="color:#4a9eff;">● 地点</span>
+            <span style="color:#50c878;">◆ NPC</span>
+            <span style="color:#ffd700;">★ 任务</span>
+            <span style="color:#ff6b6b;">▲ 物品</span>
+            <span style="color:#9b59b6;">■ 梦境</span>
+        </div>
+        """
+        stats = world.stats()
+        stats_html = f"""
+        <div style="text-align:center; padding:8px; color:#666; font-size:12px;">
+            {stats['total_nodes']} 个节点 · {stats['total_edges']} 条连接
+        </div>
+        """
+
+        return legend + html + stats_html
 
-    except ImportError:
-        # Simple fallback
+    except Exception as e:
+        # Fallback: simple text display
         stats = world.stats()
+        by_type = stats.get("by_type", {})
         return f"""
-        <div style="text-align:center; padding:40px;">
+        <div style="text-align:center; padding:40px; color:#888;">
             <h2>🗺️ 世界概览</h2>
-            <p>节点: {stats['total_nodes']} | 连接: {stats['total_edges']}</p>
+            <p>📍 地点: {by_type.get('location', 0)} | 👤 NPC: {by_type.get('npc', 0)}
+               | ⚔️ 任务: {by_type.get('quest', 0)}</p>
+            <p style="color:#ff6b6b;">地图渲染异常: {e}</p>
         </div>
         """
 
@@ -64,9 +142,9 @@ def get_map_html() -> str:
 def create_map_tab() -> gr.HTML:
     """Create the world map tab UI."""
     map_display = gr.HTML(
-        value=get_map_html(),
+        value=_generate_map_html(),
         label="World Map",
     )
-    refresh_btn = gr.Button("🔄 刷新地图")
-    refresh_btn.click(fn=get_map_html, outputs=[map_display])
+    refresh_btn = gr.Button("🔄 刷新地图", variant="secondary")
+    refresh_btn.click(fn=_generate_map_html, outputs=[map_display])
     return map_display