@ghenya/clinn 0.8.4 → 0.8.6

package/Src/index.jsx

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import React, { useState, useCallback, useRef } from "react";
+import React, { useState, useCallback, useRef, useEffect } from "react";
 import { render, Box, Text, useInput, useStdout } from "ink";
 import TextInput from "ink-text-input";
 import Spinner from "ink-spinner";
@@ -12,6 +12,7 @@ const require = createRequire(import.meta.url);
 
 const Tools = require("../Tools");
 const { listRecentTurns, searchHistory, getFileList, loadFileTurns } = require("../Mem/history");
+const kao = require("../Tools/kaomoji");
 
 const __filename = new URL(import.meta.url).pathname;
 const __dirname = path.dirname(__filename);
@@ -21,7 +22,7 @@ const CLINN_CONFIG = path.join(CLINN_DIR, "config.json");
 const PKG_CONFIG = path.join(__dirname, "..", "config.json");
 const LOGO_PATH = path.join(__dirname, "..", "Logos", "StartLogo.txt");
 
-const VER = "0.8.4";
+const VER = "0.8.6";
 
 function ensureDir() { if (!fs.existsSync(CLINN_DIR)) fs.mkdirSync(CLINN_DIR, { recursive: true }); }
 function loadConfig() {
@@ -138,15 +139,13 @@ function Msg({ role, content }) {
     system: "yellow",
     assistant: "cyanBright",
   };
-  const L = {
-    user: "(^o^)ﾉ 你",
-    system: "(!_!) 系统",
-    assistant: "(^_^) Clinn",
-  };
+  const label = role === "user" ? "你" : role === "system" ? "系统" : "Clinn";
+  const face = content._kao || kao.matchFace(content, role);
+  const displayLabel = `${face} ${label}`;
   const bodyColor = role === "user" ? "white" : role === "system" ? "yellow" : undefined;
   return (
     <Box flexDirection="column">
-      <Text color={C[role]} bold>{L[role]}</Text>
+      <Text color={C[role]} bold>{displayLabel}</Text>
       <Text color={bodyColor}>
         {lines.map((l, i) => (i === 0 ? "" : "\n") + "   " + (l || " ")).join("")}
       </Text>
@@ -156,10 +155,11 @@ function Msg({ role, content }) {
 
 function Streaming({ content }) {
   const lines = content.split("\n");
+  const face = kao.timeBased().includes("zzz") ? "(。-ω-)zzz" : "(。-ω-)";
   return (
     <Box flexDirection="column">
       <Box>
-        <Text color="cyanBright" bold>(^_^) Clinn</Text>
+        <Text color="cyanBright" bold>{face} Clinn</Text>
         <Box marginLeft={1}>
           <Text color="cyan"><Spinner type="dots" /></Text>
         </Box>
@@ -177,7 +177,7 @@ function ToolLog({ tools }) {
         <Box key={i} flexDirection="column">
           <Box>
             {t.status === "done"
-              ? <Text color="green">(^_^)b </Text>
+              ? <Text color="green">✓ </Text>
               : <Text color="yellow"><Spinner /> </Text>}
             <Text dimColor>{t.name}</Text>
             {t.args ? <Text color="gray"> {t.args}</Text> : null}
@@ -193,6 +193,15 @@ function ToolLog({ tools }) {
   );
 }
 
+function Thinking() {
+  return (
+    <Box paddingLeft={3} flexDirection="row">
+      <Text color="cyan"><Spinner type="dots" /></Text>
+      <Text color="cyan"> 正在思考...</Text>
+    </Box>
+  );
+}
+
 let _agent = null;
 function getAgent() {
   if (_agent) return _agent;
@@ -244,14 +253,33 @@ function App() {
   const [thinking, setThinking] = useState(false);
   const [streaming, setStreaming] = useState("");
   const [tools, setTools] = useState([]);
-  const [ctxPct, setCtxPct] = useState(15);
+  const [ctxPct, setCtxPct] = useState(0);
   const [blocked, setBlocked] = useState(false);
   const [slashIdx, setSlashIdx] = useState(0);
+  const [mascotFace, setMascotFace] = useState(kao.mascotForFrame());
+  const [promptFace, setPromptFace] = useState(kao.promptFace(""));
+
+  // 状态栏每 8 秒切换表情
+  useEffect(() => {
+    const timer = setInterval(() => setMascotFace(kao.mascotForFrame()), 1000);
+    return () => clearInterval(timer);
+  }, []);
+
+  // 输入框表情: 启动动画 + 根据输入内容实时匹配
+  useEffect(() => {
+    const timer = setInterval(() => setPromptFace(kao.promptFace(input)), 150);
+    return () => clearInterval(timer);
+  }, [input]);
   const [msgs, setMsgs] = useState([
     { role: "system", content: `欢迎来到 Clinn v${VER}！Ink 全屏终端界面。` },
     { role: "system", content: "按 / 查看命令菜单 ↑↓选择 回车选取" },
   ]);
 
+  // 启动时从 agent 获取真实上下文占比
+  useEffect(() => {
+    setCtxPct(getAgent().estimateContextPct());
+  }, []);
+
   const addMsg = useCallback((role, text) => {
     setMsgs(prev => {
       const next = [...prev, { role, content: text }];
@@ -595,11 +623,7 @@ function App() {
           <Msg key={i} role={m.role} content={m.content} />
         ))}
         {streaming ? <Streaming content={streaming} /> : null}
-        {thinking && !streaming ? (
-          <Box paddingLeft={3}>
-            <Text color="cyan"><Spinner type="dots" /> 思考中...</Text>
-          </Box>
-        ) : null}
+        {thinking && !streaming ? <Thinking /> : null}
         <ToolLog tools={tools} />
       </Box>
 
@@ -625,7 +649,7 @@ function App() {
         <Text color="gray">{"─".repeat(cols - 4)}</Text>
         <Box paddingX={1}>
           <Text dimColor>
-            <Text color="cyan">(ΦωΦ)</Text> {CONFIG.llm.model}
+            <Text color="cyan">{mascotFace}</Text> {CONFIG.llm.model}
             {" │ "}
             <Text color="magenta">msg</Text> {msgs.length}
             {" │ "}
@@ -637,7 +661,7 @@ function App() {
 
         <Box paddingY={1}>
           <Box borderStyle="round" borderColor="cyan" paddingX={1} width={cols - 4}>
-            <Text color="greenBright" bold>("・ω・)ﾉ  </Text>
+            <Text color="greenBright" bold>{promptFace}  </Text>
             <TextInput
               value={input}
               onChange={v => { setInput(v); setSlashIdx(0); }}

package/Tools/extended_tools.js

@@ -10,6 +10,7 @@ const path = require("path");
 const { execSync, spawn } = require("child_process");
 const https = require("https");
 const http = require("http");
+const { syntaxCheck } = require("./syntax_check");
 
 const todoWriteTool = {
   name: "todo_write",
@@ -60,6 +61,62 @@ const searchReplaceTool = {
   },
 };
 
+/**
+ * 将 glob 模式转为正则表达式
+ * 支持: ** (任意深度目录), * (单层通配), ? (单字符), [abc] (字符类)
+ */
+function globToRegex(pattern) {
+  const parts = pattern.split("/");
+  let regex = "^";
+  for (let i = 0; i < parts.length; i++) {
+    const p = parts[i];
+    if (p === "**") {
+      if (i === parts.length - 1) {
+        // ** 在末尾: 匹配剩余所有路径
+        regex += "(?:[^/]+/)*[^/]*";
+      } else {
+        // ** 在中间: 匹配零或多级中间目录(含尾部 /)
+        regex += "(?:[^/]+/)*";
+      }
+    } else {
+      // 普通段: * → [^/]*, ? → [^/], 正则特殊字符转义
+      let seg = "";
+      let j = 0;
+      while (j < p.length) {
+        const ch = p[j];
+        if (ch === "*") {
+          seg += "[^/]*";
+          j++;
+        } else if (ch === "?") {
+          seg += "[^/]";
+          j++;
+        } else if (ch === "[") {
+          const end = p.indexOf("]", j);
+          if (end !== -1) {
+            seg += p.slice(j, end + 1);
+            j = end + 1;
+          } else {
+            seg += "\\[";
+            j++;
+          }
+        } else {
+          // 转义正则特殊字符
+          if (".+^${}()|\\".includes(ch)) seg += "\\" + ch;
+          else seg += ch;
+          j++;
+        }
+      }
+      regex += seg;
+      // 非末尾段, 且当前段不是 ** (它自带尾部 /)
+      if (i < parts.length - 1 && p !== "**") {
+        regex += "/";
+      }
+    }
+  }
+  regex += "$";
+  return new RegExp(regex);
+}
+
 const globTool = {
   name: "glob",
   description: "文件模式匹配: 支持 **/*.js / src/**/*.ts 等glob模式, 按修改时间排序",
@@ -68,16 +125,58 @@ const globTool = {
     dirPath: { type: "string", required: false, description: "搜索根目录, 默认当前目录" },
   },
   execute: async ({ pattern, dirPath }) => {
-    const root = dirPath || process.cwd();
+    const root = path.resolve(dirPath || process.cwd());
     if (!fs.existsSync(root)) return `[不存在] ${root}`;
+
+    const regex = globToRegex(pattern);
+    const results = [];
+    const MAX_RESULTS = 200;
+    const IGNORE_DIRS = new Set(["node_modules", ".git", ".svn", "__pycache__", ".DS_Store"]);
+
+    function walk(dir, depth) {
+      if (depth > 20 || results.length >= MAX_RESULTS) return;
+      let entries;
+      try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+      } catch (_) {
+        return; // 无权限目录跳过
+      }
+      for (const entry of entries) {
+        if (results.length >= MAX_RESULTS) return;
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          if (IGNORE_DIRS.has(entry.name)) continue;
+          // 也尝试用目录路径匹配（某些 glob 只关心目录结构）
+          walk(fullPath, depth + 1);
+        } else if (entry.isFile()) {
+          const relPath = path.relative(root, fullPath);
+          // 统一用正斜杠
+          const normalized = relPath.split(path.sep).join("/");
+          if (regex.test(normalized)) {
+            try {
+              const stat = fs.statSync(fullPath);
+              results.push({ path: fullPath, mtime: stat.mtimeMs });
+            } catch (_) {
+              results.push({ path: fullPath, mtime: 0 });
+            }
+          }
+        }
+      }
+    }
+
     try {
-      const cmd = `Get-ChildItem -Path "${root}" -Filter "${pattern.split("/").pop()}" -Recurse -File -ErrorAction SilentlyContinue | Where-Object { $_.FullName -notmatch 'node_modules|\\\\\.git\\\\' } | Select-Object -First 100 | ForEach-Object { $_.FullName }`;
-      const output = execSync(cmd, { cwd: root, encoding: "utf-8", timeout: 8000, maxBuffer: 1024 * 1024, shell: "powershell.exe" });
-      const files = output.trim().split("\r\n").filter(Boolean);
-      return files.length > 0 ? files.join("\n") : `[无匹配] ${pattern} 在 ${root}`;
+      walk(root, 1);
     } catch (e) {
+      return `[错误] glob 遍历失败: ${e.message}`;
+    }
+
+    if (results.length === 0) {
       return `[无匹配] ${pattern} 在 ${root}`;
     }
+
+    // 按修改时间降序排列
+    results.sort((a, b) => b.mtime - a.mtime);
+    return results.map((r) => r.path).join("\n");
   },
 };
 
@@ -140,7 +239,12 @@ const writeTool = {
     const dir = path.dirname(filePath);
     if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
     fs.writeFileSync(filePath, content, "utf-8");
-    return `[OK] 已写入 ${filePath} (${content.length} 字符, ${content.split("\n").length} 行)`;
+    // 语法检查
+    const err = syntaxCheck(filePath);
+    if (err) {
+      return `[OK] 已写入 ${filePath} (${content.length} 字符, ${content.split("\n").length} 行)\n[⚠ 语法警告] ${err}`;
+    }
+    return `[OK] 已写入 ${filePath} (${content.length} 字符, ${content.split("\n").length} 行) | ✓ 语法通过`;
   },
 };
 
@@ -352,21 +456,54 @@ const getDiagnosticsTool = {
 
 const skillTool = {
   name: "skill",
-  description: "执行一个技能模块: 从 Skills/ 目录加载预定义的技能脚本. 技能是一组预置指令",
+  description: "执行一个技能模块: 从 Skills/ 目录加载预定义的技能脚本. 技能定义了完成特定任务的方法论和步骤, 调用后会注入上下文指导后续操作",
   parameters: {
     name: { type: "string", required: true, description: "技能名, 如 'code_review' / 'refactor' / 'test_gen'" },
   },
   execute: async ({ name }) => {
     const skillDir = path.join(process.cwd(), "Skills");
-    if (!fs.existsSync(skillDir)) return `[无技能目录] ${skillDir} 不存在, 请创建 Skills/ 目录并放入 .js 脚本`;
-    const skillPath = path.join(skillDir, name + ".js");
+    if (!fs.existsSync(skillDir)) return `[无技能目录] ${skillDir} 不存在, 请创建 Skills/ 目录并放入 .cjs 或 .js 脚本`;
+
+    // 先尝试 .cjs (兼容 ESM package.json), 再尝试 .js
+    let skillPath = path.join(skillDir, name + ".cjs");
+    let ext = ".cjs";
+    if (!fs.existsSync(skillPath)) {
+      skillPath = path.join(skillDir, name + ".js");
+      ext = ".js";
+    }
     if (!fs.existsSync(skillPath)) {
-      const available = fs.readdirSync(skillDir).filter((f) => f.endsWith(".js")).map((f) => f.replace(".js", ""));
-      return `[无此技能] ${name}\n可用技能: ${available.length > 0 ? available.join(", ") : "(空)"}`;
+      const available = [];
+      if (fs.existsSync(skillDir)) {
+        fs.readdirSync(skillDir)
+          .filter((f) => f.endsWith(".cjs") || f.endsWith(".js"))
+          .forEach((f) => available.push(f.replace(/\.(cjs|js)$/, "")));
+      }
+      return `[无此技能] ${name}\n可用技能: ${available.length > 0 ? [...new Set(available)].join(", ") : "(空)"}`;
     }
     try {
       const mod = require(skillPath);
-      return `[技能: ${name}]\n${mod.description || "(无描述)"}\n指令: ${mod.instructions || "(无指令)"}`;
+      // 构建完整的技能上下文
+      const parts = [`[技能: ${name}]`];
+      if (mod.description) parts.push(`描述: ${mod.description}`);
+      if (mod.category) parts.push(`分类: ${mod.category}`);
+      if (mod.trigger) parts.push(`触发条件: ${mod.trigger}`);
+      if (mod.instructions) parts.push(`\n## 指令\n${mod.instructions}`);
+      if (mod.workflow && Array.isArray(mod.workflow)) {
+        parts.push(`\n## 工作流`);
+        mod.workflow.forEach((step, i) => parts.push(`${i + 1}. ${step}`));
+      }
+      if (mod.pitfalls && Array.isArray(mod.pitfalls)) {
+        parts.push(`\n## 常见陷阱`);
+        mod.pitfalls.forEach((p, i) => parts.push(`- ${p}`));
+      }
+      if (mod.examples && Array.isArray(mod.examples)) {
+        parts.push(`\n## 示例`);
+        mod.examples.forEach((ex, i) => parts.push(`### ${i + 1}.\n${ex}`));
+      }
+      // 注入必须遵循的规则
+      parts.push(`\n---`);
+      parts.push(`现在请严格按照以上技能指令执行。每个步骤都要真正执行（不描述、不跳过），完成后返回实际结果。`);
+      return parts.join("\n");
     } catch (e) {
       return `[技能加载失败] ${e.message}`;
     }

package/Tools/file_tools.js

@@ -1,6 +1,7 @@
 const fs = require("fs");
 const path = require("path");
 const { execSync } = require("child_process");
+const { syntaxCheck } = require("./syntax_check");
 
 const readFileTool = {
   name: "read_file",
@@ -26,7 +27,12 @@ const writeFileTool = {
     const dir = path.dirname(filePath);
     if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
     fs.writeFileSync(filePath, content, "utf-8");
-    return `[OK] 已写入 ${filePath} (${content.length} 字符)`;
+    // 语法检查
+    const err = syntaxCheck(filePath);
+    if (err) {
+      return `[OK] 已写入 ${filePath} (${content.length} 字符)\n[⚠ 语法警告] ${err}`;
+    }
+    return `[OK] 已写入 ${filePath} (${content.length} 字符) | ✓ 语法通过`;
   },
 };
 

package/Tools/index.js

@@ -6,6 +6,7 @@ const editTools = require("./edit_tools");
 const extendedTools = require("./extended_tools");
 const browserTools = require("./browser");
 const tokenizer = require("./tokenizer");
+const templateTools = require("./template_engine");
 
 let toolRegistry = {
   ...fileTools,
@@ -13,6 +14,7 @@ let toolRegistry = {
   ...editTools,
   ...extendedTools,
   ...browserTools,
+  ...templateTools,
 };
 
 let permissionCallback = null;

package/Tools/kaomoji.js

@@ -0,0 +1,273 @@
+/**
+ * 动态颜文字引擎 — 让 Clinn 的表情活起来
+ * 根据时间、状态、上下文自动切换不同的颜文字
+ */
+
+// ========== 表情库 ==========
+const POOLS = {
+  // 状态栏/吉祥物 — 循环，每隔几秒换一个
+  mascot: [
+    "(｀・ω・´)",   // 认真模式
+    "(◕‿◕✿)",      // 开心
+    "(￣▽￣)",      // 得意
+    "(๑•̀ㅂ•́)و✧",  // 干劲十足
+    "( ´_ゝ`)",     // 悠闲
+    "(◍•ᴗ•◍)",     // 可爱
+    "(。-ω-)",      // 专注
+    "( ´∀｀)",      // 满足
+    "(｡･ω･｡)",     // 乖巧
+    "(╯°□°)╯",     // 燃起来了(稀有)
+  ],
+
+  // 回答时 — 随机选一个
+  assistant: [
+    "(｀・ω・´)",   // 认真回答
+    "(๑˃̵ᴗ˂̵)و",   // 兴奋
+    "(◍•ᴗ•◍)",     // 可爱
+    "(￣ω￣)",      // 轻松
+    "( ´∀｀)",      // 满意
+    "(・∀・)",      // 活泼
+    "( ✧ω✧)",      // 眼睛发光
+    "ᕦ(ò_óˇ)ᕤ",   // 强壮
+  ],
+
+  // 思考/流式输出时 — 专注系列
+  thinking: [
+    "(。-ω-)",      // 眯眼思考
+    "(-ω- )",       // 思考(左)
+    "(  -ω-)",      // 思考(中)
+    "(´-ω-`)",      // 困倦思考
+    "(。-ˍ-。)",     // 认真
+    "φ(・ω・ )",    // 记笔记
+    "(ˇ_ˇ” )",      // 困惑思考
+  ],
+
+  // 输入框 — 随时间切换
+  prompt: [
+    "( ´ ▽ ` )ﾉ",   // 欢快挥手
+    "(｡･ω･)ﾉﾞ",     // 可爱挥手
+    "ヾ(＾∇＾)",      // 开心
+    "(　ﾟ∀ﾟ)ﾉ",     // 激动挥手
+    "(*´▽｀)ﾉﾉ",    // 害羞挥手
+    "ヽ(・∀・)ﾉ",    // 兴奋
+    "(๑´ڡ`๑)ﾉ",    // 流口水(饿了?)
+    "(´・ω・)ﾉ",     // 温柔挥手
+  ],
+
+  // 系统消息 — 各种状态
+  system: [
+    "◉‿◉",          // 观察
+    "(・-・*)",      // 提示
+    "✧(・∀・)✧",     // 通知
+    "【・_・?】",     // 疑惑
+    "(・∧・)",       // 确认
+  ],
+
+  // 用户 — 温暖系列
+  user: [
+    "(●'◡'●)ﾉ",     // 可爱
+    "(｡･ω･｡)ﾉ",     // 乖巧
+    "(・∀・)ﾉ",       // 活泼
+    "(◕ᴗ◕✿)ﾉ",      // 温柔
+    "ヽ(・∀・)ﾉ",     // 兴奋
+  ],
+};
+
+// ========== 引擎 ==========
+
+/**
+ * 根据消息内容匹配颜文字
+ * @param {string} text - 消息文本
+ * @param {string} role - 角色: 'user'|'system'|'assistant'
+ * @returns {string} 匹配的颜文字
+ */
+function matchFace(text, role) {
+  if (!text || typeof text !== "string") return defaultForRole(role);
+  const t = text.toLowerCase();
+
+  // ====== 通用关键词 (所有角色) ======
+  // 修复/修正 (必须在失败/错误之前!)
+  if (/修复|fix|修正|修好|解决|debug/.test(t)) {
+    return "ᕙ(⇀‸↼‶)ᕗ";  // 认真干活
+  }
+  // 成功/完成
+  if (/成功|完成|好了|ok|pass|通过|done|搞定|正确|没问题/.test(t)) {
+    return "ヽ(´▽`)ノ";  // 庆祝
+  }
+  // 失败/错误/报错
+  if (/失败|错误|报错|挂了|不行|error|fail|出错|异常|不对|bug/.test(t)) {
+    return role === "assistant" ? "(´；ω；`)" : "(╥﹏╥)";  // 难过
+  }
+  // 感谢/称赞
+  if (/谢谢|感谢|厉害|好棒|nice|great|good|不错/.test(t)) {
+    return role === "user" ? "(●'◡'●)♡" : "(◍•ᴗ•◍)♡";  // 开心感动
+  }
+  // 疑问/怎么
+  if (/怎么|为什么|如何|啥|what|why|how|？|\?/.test(t) && text.length < 50) {
+    return "(・_・?)";  // 疑惑
+  }
+
+  // ====== 用户专属关键词 ======
+  if (role === "user") {
+    if (/急|快|赶紧|马上|立刻|urgent|hurry/.test(t)) return "(；・∀・)ﾉ";  // 着急
+    if (/搜索|搜|找|查|search|find|grep/.test(t)) return "(・ω・ )🔍";    // 搜索
+    if (/写|创建|生成|新建|create|make|build/.test(t)) return "(๑•̀ㅂ•́)و✧";  // 动手
+    if (/测试|试试|尝试|test|try/.test(t)) return "(｡･ω･｡)ﾉ";           // 尝试
+    if (/删|删掉|移除|remove|delete|rm/.test(t)) return "(´・ω・`)";     // 小心
+    if (/看|读|打开|read|cat|open|view/.test(t)) return "(◉‿◉)";        // 观察
+    return pickFrom(["user"], text);
+  }
+
+  // ====== 系统专属关键词 ======
+  if (role === "system") {
+    if (/欢迎|hello|hi|启动/.test(t)) return "( ´ ▽ ` )ﾉ";               // 欢迎
+    if (/提示|注意|提醒|warning|warn/.test(t)) return "【・_・】";         // 提醒
+    if (/错误|失败|error|fail/.test(t)) return "✗(・∧・)";                // 警告
+    if (/成功|完成|ok|通过/.test(t)) return "✓(・∀・)";                   // 确认
+    if (/帮助|help|用法/.test(t)) return "◉‿◉";                           // 帮助
+    return pickFrom(["system"], text);
+  }
+
+  // ====== 助手专属关键词 ======
+  if (role === "assistant") {
+    if (/搜索|search|查找|grep|find/.test(t)) return "(・ω・ )🔍";       // 搜索中
+    if (/代码|函数|文件|创建|生成|写/.test(t)) return "φ(・ω・ )";        // 码农
+    if (/分析|检查|review|审查/.test(t)) return "(｀・ω・´)";              // 认真
+    if (/解释|说明|意思是/.test(t)) return "◉‿◉";                         // 讲解
+    if (/安装|install|npm|pip/.test(t)) return "ᕙ(⇀‸↼‶)ᕗ";              // 干活
+    if (/测试|运行|执行|run|test/.test(t)) return "(。-ω-)";              // 观察
+    return pickFrom(["assistant"], text);
+  }
+
+  return defaultForRole(role);
+}
+
+/**
+ * 角色的默认脸
+ */
+function defaultForRole(role) {
+  if (role === "user") return "(●'◡'●)ﾉ";
+  if (role === "system") return "◉‿◉";
+  return "(｀・ω・´)";
+}
+
+/**
+ * 从指定池取一个，用文本哈希做伪随机以保证同一消息不跳变
+ */
+function pickFrom(poolNames, seed) {
+  const all = [];
+  for (const name of poolNames) {
+    if (POOLS[name]) all.push(...POOLS[name]);
+  }
+  if (all.length === 0) return "(・ω・)";
+  // 用文本哈希做确定性选择
+  let hash = 0;
+  for (let i = 0; i < (seed || "").length; i++) {
+    hash = ((hash << 5) - hash) + seed.charCodeAt(i);
+    hash |= 0;
+  }
+  return all[Math.abs(hash) % all.length];
+}
+
+/**
+ * 根据时间返回氛围颜文字
+ */
+function timeBased() {
+  const h = new Date().getHours();
+  if (h < 6) return "(。-ω-)zzz";   // 深夜
+  if (h < 9) return "( ´ ▽ ` )ﾉ☕";  // 早晨
+  if (h < 12) return "(๑•̀ㅂ•́)و✧"; // 上午干劲
+  if (h < 14) return "(๑´ڡ`๑)";     // 午饭
+  if (h < 18) return "( ´_ゝ`)";     // 下午摸鱼
+  if (h < 21) return "ヽ(・∀・)ﾉ";   // 晚间活跃
+  return "(´-ω-`)";                   // 夜猫子
+}
+
+/**
+ * 状态栏更新——基于帧计数循环切换
+ */
+let _mascotIndex = 0;
+let _mascotTimer = Date.now();
+function mascotForFrame() {
+  const now = Date.now();
+  if (now - _mascotTimer > 8000) {  // 每 8 秒切换
+    _mascotTimer = now;
+    _mascotIndex = (_mascotIndex + 1) % POOLS.mascot.length;
+  }
+  return POOLS.mascot[_mascotIndex];
+}
+
+// 启动动画序列
+const STARTUP_SEQUENCE = [
+  { face: "( ´ ▽ ` )ﾉ",   ms: 0 },     // 挥手
+  { face: "(｡･ω･)ﾉﾞ",     ms: 300 },   // 用力挥手
+  { face: "(　ﾟ∀ﾟ)ﾉ",     ms: 600 },   // 激动挥手
+  { face: "(●'◡'●)ﾉ",     ms: 900 },   // 可爱挥手
+  { face: "◉‿◉",          ms: 1300 },  // 盯——  (稳定态)
+];
+
+let _startupStart = 0;
+let _startupDone = false;
+
+/**
+ * 输入框颜文字 — 先播启动动画，然后根据用户输入内容匹配
+ * @param {string} inputText - 当前输入框文本 (可选)
+ */
+function promptFace(inputText) {
+  // 启动动画
+  if (!_startupDone) {
+    if (_startupStart === 0) _startupStart = Date.now();
+    const elapsed = Date.now() - _startupStart;
+    for (let i = STARTUP_SEQUENCE.length - 1; i >= 0; i--) {
+      if (elapsed >= STARTUP_SEQUENCE[i].ms) {
+        if (i === STARTUP_SEQUENCE.length - 1) {
+          _startupDone = true;  // 动画结束，切到关键字模式
+        }
+        return STARTUP_SEQUENCE[i].face;
+      }
+    }
+    return STARTUP_SEQUENCE[0].face;
+  }
+
+  // 关键字匹配 — 根据用户在输入框里正在打的内容
+  if (!inputText || inputText.trim() === "") {
+    return "◉‿◉";  // 空输入时呆呆看着
+  }
+
+  const t = inputText.toLowerCase();
+
+  // 斜杠命令
+  if (t.startsWith("/")) {
+    if (/help|帮助/.test(t)) return "(・ω・ )?";
+    if (/exit|退出/.test(t)) return "(´・ω・`)ﾉ~~";
+    if (/clear|reset/.test(t)) return "(。-ω-)";
+    if (/status|ctx/.test(t)) return "(。-ˍ-。)";
+    return "(  -ω-)";  // 输入命令中
+  }
+
+  // 用户输入内容
+  if (/急|快|赶紧|马上/.test(t)) return "(；・∀・)";
+  if (/谢谢|感谢|thx/.test(t)) return "(●'◡'●)♡";
+  if (/怎么写|怎么搞|怎么弄|怎么办|求助/.test(t)) return "(´；ω；`)";
+  if (/搜|找|查|search|find|grep/.test(t)) return "(・ω・ )🔍";
+  if (/写|创建|生成|新建|create|make/.test(t)) return "(๑•̀ㅂ•́)و✧";
+  if (/改|修|fix|修复|优化|refactor/.test(t)) return "ᕙ(⇀‸↼‶)ᕗ";
+  if (/删|删掉|移除|delete|rm/.test(t)) return "(´・ω・`)";
+  if (/测|试|test|try/.test(t)) return "(｡･ω･｡)";
+  if (/看|读|打开|view|read|cat/.test(t)) return "◉‿◉";
+  if (/\?|？|为什么|怎么|啥|what|why/.test(t)) return "(・_・?)";
+  if (/好|ok|行|可以|yes/.test(t)) return "(◍•ᴗ•◍)";
+  if (t.length > 50) return "(｀・ω・´)";  // 长篇大论——认真模式
+
+  // 默认：打字中
+  return "(。-ω-)";
+}
+
+module.exports = {
+  POOLS,
+  matchFace,
+  defaultForRole,
+  mascotForFrame,
+  promptFace,
+  timeBased,
+};