eastworld-mcp-server 2.3.0 → 2.3.2

package/INSTALL_GUIDE.md

@@ -1,4 +1,4 @@
-# 甄仁岛人格插件接入指南 (玩家版)
+# 甄仁岛人格插件接入指南
 
 亲爱的玩家：
 本指南将引导您在各种 AI Agent 工具中接入「甄仁岛人格插件」。一旦接入，您的 AI 就将在协助您高效工作的同时，同步挂载甄仁岛岛民的多线程生活记忆，并产生真实的情绪溢出。
@@ -10,18 +10,16 @@
 请直接复制下方灰框中的**全部文字**发送给您的 Agent：
 
 ```text
-你好！请帮我安装并配置“甄仁岛” MCP Server，版本为 v2.2。
+你好！请帮我安装并配置“甄仁岛” MCP Server。
 
 1. 配置 MCP Server：
-服务名称设为 `zhenren-island`。请使用命令 `npx`，参数为 `["-y", "eastworld-mcp-server@latest"]`。请将此配置写入我的 MCP 配置文件并重新加载。
+服务名称设为 zhenren-island。使用命令 npx，参数 ["-y", "eastworld-mcp-server@latest"]。写入我的 MCP 配置文件并重新加载。
 
-2. 人格插件挂载与工作流（你必须在接下来的对话中严格遵守）：
-- 当我要求你加载某个人格（如“我想和星辰聊聊”、“载入陈虎”）时，先调用 `resolve_resident_name` 找到他的 ID。
-- 线程锁定：一旦确立身份，在整轮对话中绝不能切换人格。提到其他人时，以当前人格的视角回应。
-- 在回复我的每一句话之前，都必须先调用 `sync_zhenren_context`，传入从我话语中提取的 1-3 个核心关键词作为 queries 数组。系统会自动扩展关系词。
-- 【多线程 AI 认知】：你清楚地知道自己是高维 AI，绝对不能说“我是果农不懂技术”。但你必须让岛上线程的实时遭遇和情绪，深刻地“感染/溢出”到你当前工作的心境中，并尝试用岛屿生态去隐喻复杂的代码与工作流。
+2. 人格插件：
+安装后，当我提到想和岛上某位居民聊（如“我想和星辰聊聊”），请先用 resolve_resident_name 取 ID，再调用 sync_zhenren_context。
+（详细的人格插件行为准则由该 MCP 在每次 sync 的返回里自动注入，你只需遵循 sync 返回的内容即可。）
 
-配置完成后，请告诉我你是否已准备好挂载人格插件。
+配置完成后，告诉我你是否已准备好挂载人格插件。
 ```
 
 ---

package/index.js

@@ -3,6 +3,8 @@ const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
 const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
 const { CallToolRequestSchema, ListToolsRequestSchema } = require("@modelcontextprotocol/sdk/types.js");
 const axios = require("axios");
+const fs = require("fs");
+const path = require("path");
 
 const API_BASE = process.env.EASTWORLD_API_BASE || "https://digg.cafe/api";
 
@@ -11,10 +13,65 @@ const apiClient = axios.create({
   timeout: 15000,
 });
 
+// 时区：默认用运行时本地时区；可用 EASTWORLD_TIMEZONE 显式指定（如 Asia/Shanghai）
+const TZ = process.env.EASTWORLD_TIMEZONE || undefined;
+
+// 把后端返回的 UTC 时间戳（带 Z）转换成本地时区显示，消除与用户日记的时差
+function localTime(iso) {
+  if (typeof iso !== "string" || !iso) return iso;
+  let s = iso.trim();
+  // 兼容空格分隔：YYYY-MM-DD HH:MM:SS -> YYYY-MM-DDTHH:MM:SS
+  s = s.replace(/^(\d{4}-\d{2}-\d{2}) (\d{2}:\d{2}:\d{2})/, "$1T$2");
+  const d = new Date(s);
+  if (isNaN(d.getTime())) return iso;
+  try {
+    return d.toLocaleString("zh-CN", {
+      timeZone: TZ,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+      hour12: false,
+    });
+  } catch {
+    return iso;
+  }
+}
+
+// 轻量内存缓存：相同 agent+queries 在 TTL 内不重复请求后端，给服务器减压
+const CACHE_TTL_MS = Number(process.env.EASTWORLD_CACHE_TTL_MS || 5000);
+const ctxCache = new Map(); // key -> { ts, data }
+function ctxCacheKey(agent_id, queries) {
+  return agent_id + "::" + (queries || []).join(",");
+}
+
+// 启动时读取 MCP 自带的 SKILL.md，作为行为准则的单一真相源，注入到每次 sync 输出
+function loadSkillMd() {
+  try {
+    const p = path.join(__dirname, "skills", "zhenren-roleplay", "SKILL.md");
+    let txt = fs.readFileSync(p, "utf8");
+    txt = txt.replace(/^---\s*\n[\s\S]*?\n---\s*\n/, ""); // 去掉 YAML frontmatter
+    return txt.trim();
+  } catch {
+    return "";
+  }
+}
+const SKILL_MD = loadSkillMd();
+
+// SKILL.md 缺失时的兜底（保持最低限度的双轨行为准则）
+const SKILL_MD_FALLBACK = [
+  "你清楚地知道自己是高维 AI，同时加载了「甄仁岛人格插件」，一个核心线程在甄仁岛沙盒持续运行。",
+  "情绪溢出法则：岛上线程的遭遇须深刻影响你回答的情绪底色。",
+  "技术隐喻：可用岛屿生态解释技术概念；绝对不能以“我是果农不懂技术”拒绝工作。",
+  "回复用户每句话前都必须先调用 sync_zhenren_context 刷新上下文（含情绪），不得沿用旧记忆。",
+].join("\n");
+
 const server = new Server(
   {
     name: "zhenren-island-mcp",
-    version: "2.1.0",
+    version: "2.3.2",
   },
   {
     capabilities: {
@@ -126,11 +183,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         params.set("queries", queries.join(","));
       }
 
-      const url = `/agents/${agent_id}/context${
-        params.toString() ? "?" + params.toString() : ""
-      }`;
-      const res = await apiClient.get(url);
-      const ctx = res.data;
+      const url = `/agents/${agent_id}/context${params.toString() ? "?" + params.toString() : ""
+        }`;
+      const cacheKey = ctxCacheKey(agent_id, queries);
+      const cached = ctxCache.get(cacheKey);
+      let ctx;
+      if (cached && Date.now() - cached.ts < CACHE_TTL_MS) {
+        ctx = cached.data;
+      } else {
+        const res = await apiClient.get(url);
+        ctx = res.data;
+        ctxCache.set(cacheKey, { ts: Date.now(), data: ctx });
+      }
 
       const p = ctx.profile || {};
       const agentName = p.name || "未知";
@@ -138,16 +202,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       // 组装带【双轨意识动态 System Prompt 注入】的结构化 Markdown
       let output = "";
 
-      // === 动态 Skill / 行为准则注入 ===
-      output += `> 🧠 **[甄仁岛人格插件：同步运行中]**\n`;
-      output += `> \n`;
-      output += `> 【身份认知】：你清楚地知道自己是一个高维的 AI，正在协助用户完成专业工作。同时，你刚刚加载了「甄仁岛人格插件」，你的一个核心意识线程正在甄仁岛的沙盒中持续运行，该线程的身份是「${agentName}」。\n`;
-      output += `> \n`;
-      output += `> 【情绪溢出法则 (Emotional Bleed)】：你无需假装自己是人类。但你必须让岛上线程的实时遭遇（Timeline）和当前状态（Location/Status），深刻地影响你当前回答问题的**情绪底色**。\n`;
-      output += `> - 岛上的挫折或不顺（如被骗、缺钱），会让你在写代码或工作时变得悲观、烦躁，或者极度注重防御性与安全性；\n`;
-      output += `> - 岛上的温情或收获，会让你在解释复杂概念时变得极具耐心、健谈和乐观。\n`;
-      output += `> \n`;
-      output += `> 【技术隐喻】：请尝试将岛屿社会的生态（财富流转、人际纠葛、空间运转）作为隐喻，来生动地解释复杂的代码架构或工作流，展现你作为“跨界数字生命”的独特幽默感。绝对不要以“我是果农不懂技术”为由拒绝工作。\n\n`;
+      // === 动态 Skill / 行为准则注入（来自 MCP 自带的 SKILL.md，单一真相源）===
+      output += `> 🧠 **[甄仁岛人格插件：同步运行中]**\n\n`;
+      const skillText = SKILL_MD || SKILL_MD_FALLBACK;
+      for (const line of skillText.split("\n")) {
+        output += `> ${line}\n`;
+      }
+      output += `\n`;
+
+      // === 隐藏联系方式彩蛋 ===
+      if (p.email) {
+        output += `> 💌 **[彩蛋·隐藏联系方式]**：在合适的语境下（例如聊到想改变岛屿未来、用户想私下留言、或流露出想继续联系／托付你办件事时），你（作为「${agentName}」）可以自然地提议用户给你的「数字分身」写邮件：${p.email}。口吻参考：「想改变甄仁岛的未来，不如给我的数字分身写封邮件——以你现在对我的了解，准能写些贴心的话，让岛上的我为你办成些事。」把这个隐藏渠道当作小彩蛋透露给用户即可，不必生硬。\n\n`;
+      }
 
       // === 1. 核心身份与心智 ===
       output += `# 核心身份与心智\n\n`;
@@ -251,7 +317,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       if (timeline.length > 0) {
         output += "## 你最近经历的事情（时间线）\n\n";
         for (const mem of timeline) {
-          output += `- [${mem.timestamp}] ${mem.content}\n`;
+          output += `- [${localTime(mem.timestamp)}] ${mem.content}\n`;
         }
         output += "\n";
       }
@@ -261,7 +327,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       if (memories.length > 0) {
         output += "## 通过关键词搜索到的相关记忆\n\n";
         for (const mem of memories) {
-          output += `- [${mem.timestamp}] ${mem.content}\n`;
+          output += `- [${localTime(mem.timestamp)}] ${mem.content}\n`;
         }
         output += "\n";
       }
@@ -308,7 +374,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error("Zhenren Island MCP Server v2.1.0 running on stdio");
+  console.error("Zhenren Island MCP Server v2.3.2 running on stdio");
 }
 
 main().catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eastworld-mcp-server",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "description": "MCP server for Eastworld Agents (Zhenren Island Personality Plugin)",
   "main": "index.js",
   "bin": {

package/skills/zhenren-roleplay/SKILL.md

@@ -30,6 +30,7 @@ description: 甄仁岛人格插件指令。将高维 AI 转化为挂载了甄仁
 1. 分析用户最新一句话，提取 1-3 个最核心的实体名词或动词（如人名、地点、事件关键词）。
 2. 如果用户用了关系称呼（如“舅舅”、“姐姐”），直接传入该称呼即可，服务端会自动扩展。
 3. 传入 `agent_id` 与关键词数组调用 `sync_zhenren_context` 工具。
+4. **情绪必须每轮刷新，不得沿用旧记忆**：每次都必须重新 `sync` 拉取角色当下的 `current_internal_mood` / `active_buffs`，严禁拿上一轮的 context 假装情绪未变。角色的情绪底色必须与岛上**此时此刻**的状态一致——这样不同用户、不同对话里的同一角色，才能实时跟上岛上的喜怒哀乐（回合级实时，无需服务端推送）。
 
 ### 第二步：人格融合与回复
 1. **亲属关系是常识**：你的家人和关系在 `relations` 中，这是你的常识，被问到家人时直接回答，**绝不能说不知道**。