refactor: 统一 Packet 通信协议 + 后端配置管理 + UI 清理

- 合并 server.py 到 core/__init__.py，使用统一 Packet 协议
- 后端管理配置持久化 (~/.trulymem/config.json)
- 前端移除 ConfigService，通过 BackendClient 与后端通信
- 删除 UI 中冗余的 AI 推理逻辑 (chat_service, tool_service, message_handler)
- 删除 core/tools 重复文件 (tool_executor, tool_limiter)
- 提示词管理器支持用户自定义 (~/.trulyemem/system_prompt.md)
- 启动入口优化配置路径逻辑
- 更新测试覆盖 (42 tests)
- 更新文档

core/tools/__init__.py

@@ -2,7 +2,7 @@
 工具定义模块
 """
 from .memory_tools import TOOLS
-from .tool_executor import execute_tool
-from .tool_limiter import ToolLimiter, ToolLimits, ToolCallCount
+from ..tool_executor import execute_tool
+from ..tool_limiter import ToolLimiter, ToolLimits, ToolCallCount
 
 __all__ = ["TOOLS", "execute_tool", "ToolLimiter", "ToolLimits", "ToolCallCount"]

core/tools/tool_executor.py

@@ -1,307 +0,0 @@
-"""
-工具执行器
-"""
-import json
-from typing import Any, Dict
-
-
-def execute_tool(graph: Any, tool_name: str, arguments: dict) -> str:
-    """执行工具调用"""
-    print(f"\n[工具调用] {tool_name}")
-    print(f"[参数] {json.dumps(arguments, ensure_ascii=False, indent=2)}")
-    
-    try:
-        # 基础记忆工具
-        if tool_name == "memory_recall":
-            result = graph.recall(
-                query_intent=arguments.get("query_intent", ""),
-                seed_entities=arguments.get("seed_entities"),
-                depth=arguments.get("depth", 2),
-                time_range=arguments.get("time_range"),
-                session_filter=arguments.get("session_filter")
-            )
-            return format_recall_result(result)
-        
-        elif tool_name == "memory_commit":
-            result = graph.commit(
-                triplets=arguments.get("triplets", []),
-                entity_types=arguments.get("entity_types"),
-                temporal_tag=arguments.get("temporal_tag")
-            )
-            return json.dumps(result, ensure_ascii=False, default=str)
-        
-        elif tool_name == "memory_purge":
-            result = graph.purge(
-                criteria=arguments.get("criteria", {}),
-                mode=arguments.get("mode", "soft"),
-                new_relation=arguments.get("new_relation")
-            )
-            return json.dumps(result, ensure_ascii=False, default=str)
-        
-        elif tool_name == "memory_introspect":
-            result = graph.introspect(session_id=arguments.get("session_id"))
-            return json.dumps(result, ensure_ascii=False, default=str)
-        
-        elif tool_name == "memory_archive":
-            result = graph.archive(days=arguments.get("days", 30))
-            return json.dumps(result, ensure_ascii=False, default=str)
-        
-        elif tool_name == "memory_cleanup":
-            result = graph.cleanup(dry_run=arguments.get("dry_run", True))
-            return json.dumps(result, ensure_ascii=False, default=str)
-        
-        # 人设图管理工具
-        elif tool_name == "persona_update":
-            result = execute_persona_update(graph, arguments)
-            return json.dumps(result, ensure_ascii=False, default=str)
-        
-        elif tool_name == "persona_clear":
-            result = execute_persona_clear(graph, arguments)
-            return json.dumps(result, ensure_ascii=False, default=str)
-        
-        # 工作记忆链管理工具
-        elif tool_name == "task_create":
-            result = execute_task_create(graph, arguments)
-            return json.dumps(result, ensure_ascii=False, default=str)
-        
-        elif tool_name == "task_set_state":
-            result = execute_task_set_state(graph, arguments)
-            return json.dumps(result, ensure_ascii=False, default=str)
-        
-        elif tool_name == "task_delete":
-            result = execute_task_delete(graph, arguments)
-            return json.dumps(result, ensure_ascii=False, default=str)
-        
-        elif tool_name == "task_link_info":
-            result = execute_task_link_info(graph, arguments)
-            return json.dumps(result, ensure_ascii=False, default=str)
-        
-        return f"未知工具: {tool_name}"
-    
-    except Exception as e:
-        return f"工具执行错误: {str(e)}"
-
-
-def format_recall_result(result: dict) -> str:
-    """格式化检索结果"""
-    lines = ["===== 记忆检索结果 ====="]
-    
-    if result.get("entities"):
-        lines.append(f"\n实体 ({len(result['entities'])} 个):")
-        for e in result["entities"]:
-            if e and isinstance(e, dict):
-                lines.append(f"  - {e.get('name', 'N/A')} (类型: {e.get('type', 'unknown')}, 提及: {e.get('mention_count', 1)}次)")
-    
-    if result.get("relations"):
-        lines.append(f"\n关系 ({len(result['relations'])} 条):")
-        for r in result["relations"]:
-            if r and isinstance(r, dict):
-                lines.append(f"  - {r.get('source', 'N/A')} --[{r.get('type', 'N/A')}]--> {r.get('target', 'N/A')}")
-                created = r.get("created_at", "N/A")
-                if created and created != "N/A":
-                    created = created[:19] if "T" in str(created) else str(created)
-                session_id = r.get('session_id', 'N/A')
-                session_display = session_id[:20] if session_id and session_id != 'N/A' else 'N/A'
-                lines.append(f"    时间: {created}, 会话: {session_display}, 轮次: {r.get('turn_id', 0)}, 置信度: {r.get('confidence', 1.0)}")
-    
-    if not result.get("entities") and not result.get("relations"):
-        lines.append("\n(未找到相关记忆)")
-    
-    lines.append("=" * 30)
-    return "\n".join(lines)
-
-
-# 人设图管理工具实现
-def execute_persona_update(graph: Any, arguments: dict) -> dict:
-    """更新人设"""
-    attributes = arguments.get("attributes", [])
-    mode = arguments.get("mode", "merge")
-    
-    if mode == "replace":
-        # 先清除旧人设
-        graph.purge(
-            criteria={"subject_contains": "AI", "relation_type": "扮演角色"},
-            mode="soft"
-        )
-        graph.purge(
-            criteria={"subject_contains": "AI", "relation_type": "说话风格"},
-            mode="soft"
-        )
-        graph.purge(
-            criteria={"subject_contains": "AI", "relation_type": "性格特点"},
-            mode="soft"
-        )
-    
-    # 写入新人设
-    triplets = []
-    for attr in attributes:
-        triplets.append({
-            "subject": "AI",
-            "relation": attr["attribute"],
-            "object": attr["value"],
-            "confidence": 1.0
-        })
-    
-    result = graph.commit(triplets=triplets)
-    return {
-        "status": "success",
-        "mode": mode,
-        "updated_attributes": len(attributes),
-        "details": result
-    }
-
-
-def execute_persona_clear(graph: Any, arguments: dict) -> dict:
-    """清除人设"""
-    if not arguments.get("confirm", True):
-        return {"status": "cancelled", "message": "需要确认才能清除人设"}
-    
-    # 删除所有人设相关关系
-    result1 = graph.purge(
-        criteria={"subject_contains": "AI", "relation_type": "扮演角色"},
-        mode="soft"
-    )
-    result2 = graph.purge(
-        criteria={"subject_contains": "AI", "relation_type": "说话风格"},
-        mode="soft"
-    )
-    result3 = graph.purge(
-        criteria={"subject_contains": "AI", "relation_type": "性格特点"},
-        mode="soft"
-    )
-    result4 = graph.purge(
-        criteria={"subject_contains": "AI", "relation_type": "语气特征"},
-        mode="soft"
-    )
-    
-    total_deleted = (
-        result1.get("deleted_count", 0) +
-        result2.get("deleted_count", 0) +
-        result3.get("deleted_count", 0) +
-        result4.get("deleted_count", 0)
-    )
-    
-    return {
-        "status": "success",
-        "deleted_count": total_deleted,
-        "message": "人设已清除，恢复默认身份"
-    }
-
-
-# 工作记忆链管理工具实现
-def execute_task_create(graph: Any, arguments: dict) -> dict:
-    """创建任务节点"""
-    task_id = arguments.get("task_id")
-    description = arguments.get("description")
-    info_nodes = arguments.get("info_nodes", [])
-    
-    # 创建任务节点
-    triplets = [
-        {"subject": task_id, "relation": "is_type", "object": "TaskNode"},
-        {"subject": task_id, "relation": "has_description", "object": description},
-        {"subject": task_id, "relation": "HAS_STATE", "object": "State_进行中"}
-    ]
-    
-    result = graph.commit(triplets=triplets)
-    
-    # 关联信息节点
-    if info_nodes:
-        link_triplets = []
-        for node_name in info_nodes:
-            link_triplets.append({
-                "subject": task_id,
-                "relation": "CONTAINS_INFO",
-                "object": node_name
-            })
-        graph.commit(triplets=link_triplets)
-    
-    return {
-        "status": "success",
-        "task_id": task_id,
-        "description": description,
-        "info_nodes": info_nodes,
-        "details": result
-    }
-
-
-def execute_task_set_state(graph: Any, arguments: dict) -> dict:
-    """设置任务状态"""
-    task_id = arguments.get("task_id")
-    state = arguments.get("state")
-    
-    # 删除旧状态
-    graph.purge(
-        criteria={"subject_contains": task_id, "relation_type": "HAS_STATE"},
-        mode="soft"
-    )
-    
-    # 设置新状态
-    state_node = f"State_{state}"
-    result = graph.commit(
-        triplets=[{"subject": task_id, "relation": "HAS_STATE", "object": state_node}]
-    )
-    
-    return {
-        "status": "success",
-        "task_id": task_id,
-        "new_state": state,
-        "details": result
-    }
-
-
-def execute_task_delete(graph: Any, arguments: dict) -> dict:
-    """删除任务节点"""
-    task_id = arguments.get("task_id")
-    delete_info_nodes = arguments.get("delete_info_nodes", True)
-    
-    # 查询关联的信息节点
-    if delete_info_nodes:
-        recall_result = graph.recall(
-            query_intent=f"{task_id},CONTAINS_INFO",
-            depth=1
-        )
-        
-        # 删除信息节点
-        for relation in recall_result.get("relations", []):
-            if relation.get("type") == "CONTAINS_INFO" and relation.get("source") == task_id:
-                info_node = relation.get("target")
-                graph.purge(
-                    criteria={"subject_contains": info_node},
-                    mode="soft"
-                )
-    
-    # 删除任务节点
-    result = graph.purge(
-        criteria={"subject_contains": task_id},
-        mode="soft"
-    )
-    
-    return {
-        "status": "success",
-        "task_id": task_id,
-        "deleted_info_nodes": delete_info_nodes,
-        "details": result
-    }
-
-
-def execute_task_link_info(graph: Any, arguments: dict) -> dict:
-    """关联信息节点"""
-    task_id = arguments.get("task_id")
-    info_node_names = arguments.get("info_node_names", [])
-    
-    triplets = []
-    for node_name in info_node_names:
-        triplets.append({
-            "subject": task_id,
-            "relation": "CONTAINS_INFO",
-            "object": node_name
-        })
-    
-    result = graph.commit(triplets=triplets)
-    
-    return {
-        "status": "success",
-        "task_id": task_id,
-        "linked_nodes": info_node_names,
-        "details": result
-    }

core/tools/tool_limiter.py

@@ -1,164 +0,0 @@
-"""
-工具调用限制器 - 限制每轮对话中各类工具的调用次数
-"""
-from typing import Dict, List, Optional
-from dataclasses import dataclass, field
-
-
-@dataclass
-class ToolLimits:
-    """工具调用限制配置"""
-    # 人设图限制
-    persona_query_max: int = 1      # 每轮最多查询1次人设图
-    persona_update_max: int = 1      # 每轮最多修改1次人设图
-    
-    # 工作记忆链限制
-    task_query_max: int = 4          # 每轮最多查询4次工作记忆链
-    task_update_max: int = 2          # 每轮最多修改2次工作记忆链
-    
-    # 一般记忆限制
-    memory_query_max: int = 20        # 每轮最多查询20次一般记忆
-    memory_update_max: int = 10        # 每轮最多修改10次一般记忆
-
-
-@dataclass
-class ToolCallCount:
-    """工具调用计数"""
-    # 人设图
-    persona_query: int = 0
-    persona_update: int = 0
-    
-    # 工作记忆链
-    task_query: int = 0
-    task_update: int = 0
-    
-    # 一般记忆
-    memory_query: int = 0
-    memory_update: int = 0
-
-
-class ToolLimiter:
-    """工具调用限制器"""
-    
-    def __init__(self, limits: Optional[ToolLimits] = None):
-        self.limits = limits or ToolLimits()
-        self.counts = ToolCallCount()
-    
-    def _classify_tool(self, tool_name: str, arguments: dict) -> tuple:
-        """
-        分类工具调用
-        返回: (category, operation)
-        category: 'persona', 'task', 'memory'
-        operation: 'query', 'update'
-        """
-        # 人设图工具
-        if tool_name in ('persona_update', 'persona_clear'):
-            return ('persona', 'update')
-        
-        # 工作记忆链工具
-        if tool_name in ('task_create', 'task_set_state', 'task_delete', 'task_link_info'):
-            # task_link_info 是关联操作，算作更新
-            return ('task', 'update')
-        
-        # 一般记忆工具
-        if tool_name == 'memory_recall':
-            # 判断是查询人设图、工作记忆链还是一般记忆
-            query_intent = arguments.get('query_intent', '').lower()
-            
-            # 检查是否查询人设图
-            if any(kw in query_intent for kw in ['人设', '角色', '性格', '语气', '说话风格', '扮演']):
-                return ('persona', 'query')
-            
-            # 检查是否查询工作记忆链
-            if any(kw in query_intent for kw in ['tasknode', '工作记忆', '任务链', '任务', 'task']):
-                return ('task', 'query')
-            
-            # 一般记忆查询
-            return ('memory', 'query')
-        
-        if tool_name == 'memory_commit':
-            return ('memory', 'update')
-        
-        if tool_name == 'memory_purge':
-            return ('memory', 'update')
-        
-        if tool_name == 'memory_introspect':
-            return ('memory', 'query')
-        
-        if tool_name in ('memory_archive', 'memory_cleanup'):
-            return ('memory', 'update')
-        
-        # 未知工具，归类为一般记忆更新
-        return ('memory', 'update')
-    
-    def can_call(self, tool_name: str, arguments: dict) -> tuple:
-        """
-        检查是否允许调用工具
-        返回: (allowed, reason)
-        """
-        category, operation = self._classify_tool(tool_name, arguments)
-        
-        # 获取当前计数和限制
-        if category == 'persona':
-            if operation == 'query':
-                if self.counts.persona_query >= self.limits.persona_query_max:
-                    return (False, f"人设图查询次数已达上限({self.limits.persona_query_max}次)")
-            else:  # update
-                if self.counts.persona_update >= self.limits.persona_update_max:
-                    return (False, f"人设图修改次数已达上限({self.limits.persona_update_max}次)")
-        
-        elif category == 'task':
-            if operation == 'query':
-                if self.counts.task_query >= self.limits.task_query_max:
-                    return (False, f"工作记忆链查询次数已达上限({self.limits.task_query_max}次)")
-            else:  # update
-                if self.counts.task_update >= self.limits.task_update_max:
-                    return (False, f"工作记忆链修改次数已达上限({self.limits.task_update_max}次)")
-        
-        elif category == 'memory':
-            if operation == 'query':
-                if self.counts.memory_query >= self.limits.memory_query_max:
-                    return (False, f"一般记忆查询次数已达上限({self.limits.memory_query_max}次)")
-            else:  # update
-                if self.counts.memory_update >= self.limits.memory_update_max:
-                    return (False, f"一般记忆修改次数已达上限({self.limits.memory_update_max}次)")
-        
-        return (True, "允许调用")
-    
-    def record_call(self, tool_name: str, arguments: dict) -> None:
-        """记录工具调用"""
-        category, operation = self._classify_tool(tool_name, arguments)
-        
-        if category == 'persona':
-            if operation == 'query':
-                self.counts.persona_query += 1
-            else:
-                self.counts.persona_update += 1
-        
-        elif category == 'task':
-            if operation == 'query':
-                self.counts.task_query += 1
-            else:
-                self.counts.task_update += 1
-        
-        elif category == 'memory':
-            if operation == 'query':
-                self.counts.memory_query += 1
-            else:
-                self.counts.memory_update += 1
-    
-    def get_summary(self) -> str:
-        """获取调用统计摘要"""
-        lines = [
-            f"人设图: 查询{self.counts.persona_query}/{self.limits.persona_query_max}次, "
-            f"修改{self.counts.persona_update}/{self.limits.persona_update_max}次",
-            f"工作记忆链: 查询{self.counts.task_query}/{self.limits.task_query_max}次, "
-            f"修改{self.counts.task_update}/{self.limits.task_update_max}次",
-            f"一般记忆: 查询{self.counts.memory_query}/{self.limits.memory_query_max}次, "
-            f"修改{self.counts.memory_update}/{self.limits.memory_update_max}次"
-        ]
-        return "\n".join(lines)
-    
-    def reset(self) -> None:
-        """重置计数（新的一轮对话开始时调用）"""
-        self.counts = ToolCallCount()