ultra-memory 3.0.2 → 3.0.3

package/SKILL.md

@@ -205,8 +205,14 @@ python3 <skill_dir>/scripts/mcp-server.js  # 通过 MCP 调用 memory_profile
 - 发现了某个工具/库的使用技巧
 - 完成了一个可复用的代码模式
 
-**执行方式：**
-追加写入 `~/.ultra-memory/semantic/knowledge_base.jsonl`，每行一条 JSON。
+**执行方式 — 方式 A（MCP 工具，推荐）：**
+```bash
+# 通过 memory_knowledge_add MCP 工具写入
+# 参数：title（必填，100字内）、content（必填，200字内）、project（可选）、tags（可选）
+```
+
+**执行方式 — 方式 B（直接追加）：**
+直接追加写入 `~/.ultra-memory/semantic/knowledge_base.jsonl`，每行一条 JSON。
 
 **knowledge_base.jsonl 格式：**
 ```json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultra-memory",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "超长会话记忆系统 — 5层记忆架构，零外部依赖，支持所有LLM平台（Claude/GPT/Gemini/Qwen等）",
   "keywords": [
     "ai",
@@ -45,7 +45,8 @@
     "ultra-memory-log": "scripts/log_op.py",
     "ultra-memory-recall": "scripts/recall.py",
     "ultra-memory-summarize": "scripts/summarize.py",
-    "ultra-memory-restore": "scripts/restore.py"
+    "ultra-memory-restore": "scripts/restore.py",
+    "ultra-memory-knowledge": "scripts/log_knowledge.py"
   },
   "scripts": {
     "test": "python3 test_e2e.py",

package/platform/server.py

@@ -263,6 +263,19 @@ def tool_memory_extract_entities(body: dict) -> tuple[bool, str]:
     return _run_script("extract_entities.py", ["--session", session_id, "--all"])
 
 
+def tool_memory_knowledge_add(body: dict) -> tuple[bool, str]:
+    title = body.get("title", "")
+    content = body.get("content", "")
+    if not title or not content:
+        return False, "缺少 title 或 content 参数"
+    project = body.get("project", "default")
+    tags = body.get("tags", [])
+    args = ["--title", title, "--content", content, "--project", project]
+    if tags:
+        args.extend(["--tags", ",".join(tags)])
+    return _run_script("log_knowledge.py", args)
+
+
 # ── 工具注册表 ────────────────────────────────────────────────────────────
 
 TOOL_HANDLERS = {
@@ -275,6 +288,7 @@ TOOL_HANDLERS = {
     "memory_profile":          tool_memory_profile,
     "memory_entities":         tool_memory_entities,
     "memory_extract_entities": tool_memory_extract_entities,
+    "memory_knowledge_add":    tool_memory_knowledge_add,
 }
 
 TOOL_DESCRIPTIONS = {
@@ -287,6 +301,7 @@ TOOL_DESCRIPTIONS = {
     "memory_profile":          "读写用户画像（技术栈、偏好）",
     "memory_entities":         "查询结构化实体索引（函数/文件/依赖/决策/错误）",
     "memory_extract_entities": "对整个 ops.jsonl 全量重提取实体",
+    "memory_knowledge_add":    "追加知识库条目（bug解决方案、技术选型、工具技巧、可复用代码模式）",
 }
 
 

package/platform/tools_gemini.json

@@ -171,6 +171,33 @@
         },
         "required": ["session_id"]
       }
+    },
+    {
+      "name": "memory_knowledge_add",
+      "description": "Append important information to the knowledge base for future retrieval. Use when: solving a tricky bug, making a key tech decision, discovering a tool usage tip, or completing a reusable code pattern.",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "title": {
+            "type": "STRING",
+            "description": "Knowledge title (max 100 chars)"
+          },
+          "content": {
+            "type": "STRING",
+            "description": "Knowledge content (max 200 chars)"
+          },
+          "project": {
+            "type": "STRING",
+            "description": "Associated project name (default: 'default')"
+          },
+          "tags": {
+            "type": "ARRAY",
+            "items": { "type": "STRING" },
+            "description": "Tag list (optional)"
+          }
+        },
+        "required": ["title", "content"]
+      }
     }
   ]
 }

package/platform/tools_openai.json

@@ -203,5 +203,35 @@
         "required": ["session_id"]
       }
     }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "memory_knowledge_add",
+      "description": "Append important information to the knowledge base (knowledge_base.jsonl) for future retrieval. Use when: solving a tricky bug (record problem + solution), making a key tech decision (record what was chosen and why), discovering a tool usage tip, or completing a reusable code pattern.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "title": {
+            "type": "string",
+            "description": "Knowledge title (max 100 chars)"
+          },
+          "content": {
+            "type": "string",
+            "description": "Knowledge content (max 200 chars)"
+          },
+          "project": {
+            "type": "string",
+            "description": "Associated project name (default: 'default')"
+          },
+          "tags": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Tag list (optional)"
+          }
+        },
+        "required": ["title", "content"]
+      }
+    }
   }
 ]

package/scripts/log_knowledge.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+"""
+ultra-memory: 知识库写入脚本
+将重要信息追加写入 semantic/knowledge_base.jsonl，供未来相似任务检索。
+"""
+
+import os
+import sys
+import json
+import argparse
+from datetime import datetime, timezone
+from pathlib import Path
+
+if sys.stdout.encoding != "utf-8":
+    sys.stdout.reconfigure(encoding="utf-8")
+
+ULTRA_MEMORY_HOME = Path(os.environ.get("ULTRA_MEMORY_HOME", Path.home() / ".ultra-memory"))
+
+
+def log_knowledge(
+    title: str,
+    content: str,
+    project: str = "default",
+    tags: list = None,
+):
+    """追加一条知识库条目"""
+    semantic_dir = ULTRA_MEMORY_HOME / "semantic"
+    semantic_dir.mkdir(parents=True, exist_ok=True)
+    kb_file = semantic_dir / "knowledge_base.jsonl"
+
+    entry = {
+        "ts": datetime.now(timezone.utc).isoformat().replace("+00:00", "Z"),
+        "project": project,
+        "title": title[:100],
+        "content": content[:200],
+        "tags": tags or [],
+    }
+
+    with open(kb_file, "a", encoding="utf-8") as f:
+        f.write(json.dumps(entry, ensure_ascii=False) + "\n")
+
+    print(f"[ultra-memory] 知识库已写入: {title}")
+    return entry
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="追加知识库条目")
+    parser.add_argument("--title", required=True, help="知识标题（100字内）")
+    parser.add_argument("--content", required=True, help="知识内容（200字内）")
+    parser.add_argument("--project", default="default", help="关联项目名")
+    parser.add_argument("--tags", default="", help="逗号分隔的标签")
+    args = parser.parse_args()
+
+    tags = [t.strip() for t in args.tags.split(",") if t.strip()]
+    log_knowledge(args.title, args.content, args.project, tags)

package/scripts/mcp-server.js

@@ -164,6 +164,20 @@ const TOOLS = [
       },
       required: ["session_id"]
     }
+  },
+  {
+    name: "memory_knowledge_add",
+    description: "将重要信息追加到知识库（knowledge_base.jsonl），供未来相似任务检索。适用场景：解决了一个棘手的 bug、做出了重要技术选型决策、发现了工具使用技巧、完成了一个可复用的代码模式",
+    inputSchema: {
+      type: "object",
+      properties: {
+        title: { type: "string", description: "知识标题（100字内）", maxLength: 100 },
+        content: { type: "string", description: "知识内容（200字内）", maxLength: 200 },
+        project: { type: "string", description: "关联项目名", default: "default" },
+        tags: { type: "array", items: { type: "string" }, description: "标签列表", default: [] }
+      },
+      required: ["title", "content"]
+    }
   }
 ];
 
@@ -291,6 +305,15 @@ function executeTool(name, input) {
     case "memory_extract_entities": {
       return runScript("extract_entities.py", ["--session", input.session_id, "--all"]);
     }
+    case "memory_knowledge_add": {
+      const args = [
+        "--title", input.title,
+        "--content", input.content,
+        "--project", input.project || "default",
+        "--tags", (input.tags || []).join(",")
+      ];
+      return runScript("log_knowledge.py", args);
+    }
     default:
       return { success: false, output: `未知工具: ${name}` };
   }