@bgicli/bgicli 2.5.0 → 2.6.0

package/data/skills/web-search/SKILL.md

@@ -0,0 +1,73 @@
+---
+id: web-search
+name: Web Search (网络搜索)
+category: utility
+short-description: Search the internet using DuckDuckGo API and curl/Python for any query.
+---
+
+# Web Search 网络搜索
+
+当用户需要搜索互联网、查找最新信息、核实事实、或查询非文献数据库内容时，使用以下方法通过 bash 工具执行网络搜索。
+
+## 规则
+- 直接搜索，不要事先询问"是否需要搜索"
+- 搜索到内容后，整合总结后再回复，不要直接粘贴原始 JSON
+- 如果首次搜索结果不理想，换关键词重试一次
+- 中文问题优先用中文关键词；专业术语用英文效果更好
+
+## 方法一：DuckDuckGo Instant Answer（无需 API Key，适合快速摘要）
+
+```bash
+python3 - <<'EOF'
+import urllib.request, urllib.parse, json, sys
+
+query = "YOUR_QUERY_HERE"
+url = "https://api.duckduckgo.com/?q=" + urllib.parse.quote(query) + "&format=json&no_html=1&skip_disambig=1"
+try:
+    with urllib.request.urlopen(url, timeout=10) as r:
+        d = json.loads(r.read())
+    if d.get("AbstractText"):
+        print("摘要:", d["AbstractText"])
+        print("来源:", d.get("AbstractURL", ""))
+    topics = [t for t in d.get("RelatedTopics", []) if isinstance(t, dict) and t.get("Text")]
+    for t in topics[:6]:
+        print("•", t["Text"])
+        if t.get("FirstURL"):
+            print(" ", t["FirstURL"])
+except Exception as e:
+    print("搜索失败:", e, file=sys.stderr)
+EOF
+```
+
+## 方法二：获取并解析具体网页内容
+
+```bash
+python3 - <<'EOF'
+import urllib.request, re, sys
+
+url = "https://TARGET_URL_HERE"
+try:
+    req = urllib.request.Request(url, headers={"User-Agent": "Mozilla/5.0"})
+    with urllib.request.urlopen(req, timeout=15) as r:
+        html = r.read().decode("utf-8", errors="ignore")
+    text = re.sub(r"<script[^>]*>[\s\S]*?</script>", "", html, flags=re.I)
+    text = re.sub(r"<style[^>]*>[\s\S]*?</style>", "", text, flags=re.I)
+    text = re.sub(r"<[^>]+>", " ", text)
+    text = re.sub(r"\s{3,}", "\n\n", text)
+    print(text[:4000])
+except Exception as e:
+    print("获取失败:", e, file=sys.stderr)
+EOF
+```
+
+## 方法三：curl 快速搜索
+
+```bash
+curl -sA "Mozilla/5.0" "https://api.duckduckgo.com/?q=QUERY&format=json&no_html=1" \
+  | python3 -c "
+import json,sys
+d=json.load(sys.stdin)
+print(d.get('AbstractText',''))
+[print('•',t['Text']) for t in d.get('RelatedTopics',[])[:5] if isinstance(t,dict) and t.get('Text')]
+"
+```

package/dist/bgi.js

@@ -13605,11 +13605,12 @@ var BGI_DIR = (0, import_path2.join)((0, import_os.homedir)(), ".bgicli");
 var TOOLS_DIR = (0, import_path2.join)(BGI_DIR, "tools");
 var SKILLS_DIR = (0, import_path2.join)(BGI_DIR, "skills");
 var USER_SKILLS_DIR = (0, import_path2.join)(BGI_DIR, "user-skills");
+var CUSTOM_SKILLS_DIR = (0, import_path2.join)(BGI_DIR, "custom-skills");
 var DATABASES_FILE = (0, import_path2.join)(BGI_DIR, "databases.json");
 var DATA_VERSION_FILE = (0, import_path2.join)(BGI_DIR, ".data-version");
 var CONFIG_FILE = (0, import_path2.join)(BGI_DIR, "config.json");
 function ensureDirs() {
-  for (const dir of [BGI_DIR, TOOLS_DIR, SKILLS_DIR, USER_SKILLS_DIR]) {
+  for (const dir of [BGI_DIR, TOOLS_DIR, SKILLS_DIR, USER_SKILLS_DIR, CUSTOM_SKILLS_DIR]) {
     if (!(0, import_fs2.existsSync)(dir)) (0, import_fs2.mkdirSync)(dir, { recursive: true });
   }
 }
@@ -13619,12 +13620,18 @@ function loadConfig() {
     const def = {
       provider: DEFAULT_PROVIDER,
       model: PROVIDERS[DEFAULT_PROVIDER].defaultModel,
-      apiKeys: {}
+      apiKeys: {},
+      permanentSkills: ["web-search"]
     };
     saveConfig(def);
     return def;
   }
-  return JSON.parse((0, import_fs2.readFileSync)(CONFIG_FILE, "utf8"));
+  const cfg = JSON.parse((0, import_fs2.readFileSync)(CONFIG_FILE, "utf8"));
+  if (!cfg.permanentSkills) {
+    cfg.permanentSkills = ["web-search"];
+    saveConfig(cfg);
+  }
+  return cfg;
 }
 function saveConfig(cfg) {
   ensureDirs();
@@ -17193,7 +17200,7 @@ function clearCheckpoints(sessionId) {
 
 // src/index.ts
 var import_fs7 = require("fs");
-var VERSION2 = "2.5.0";
+var VERSION2 = "2.6.0";
 var BRAND2 = "bgi".toLowerCase();
 var SKILLHUB_HUBS = {
   bgi: { label: "BGI\u5185\u7F51", apiBase: "https://clawhub.ai", backend: "clawhub" },
@@ -17337,6 +17344,10 @@ var SESSION_CTX = {
 };
 var dbRegistry = { version: 1, lastScan: null, databases: {} };
 var systemPrompt = "";
+var debugMode = false;
+var debugFilePath = "";
+var debugRound = 0;
+var permanentSkillIds = /* @__PURE__ */ new Set();
 function installBundledData() {
   const bundledData = (0, import_path6.join)(__dirname, "..", "data");
   if (!(0, import_fs6.existsSync)(bundledData)) return;
@@ -17579,8 +17590,9 @@ function collectAllSkills() {
       }
     });
   };
-  addFrom(SKILLS_DIR, "skill");
-  addFrom(USER_SKILLS_DIR, "user");
+  addFrom(SKILLS_DIR, "bio");
+  addFrom(USER_SKILLS_DIR, "downloaded");
+  addFrom(CUSTOM_SKILLS_DIR, "custom");
   return entries;
 }
 function listSkills(keyword) {
@@ -17668,6 +17680,14 @@ function parseSkillMeta(content) {
   };
 }
 async function injectSkill(id, history, injectedSkills, rl, skipConfirm = false) {
+  if (injectedSkills.has(id)) {
+    if (permanentSkillIds.has(id)) {
+      console.log(source_default.dim(`  [${id}] \u662F\u5E38\u9A7B\u6280\u80FD\uFF0C\u5DF2\u81EA\u52A8\u52A0\u8F7D\u5230\u7CFB\u7EDF\u63D0\u793A\u4E2D\uFF0C\u65E0\u9700\u624B\u52A8\u6FC0\u6D3B`));
+    } else {
+      console.log(source_default.dim(`  [${id}] \u5DF2\u5728\u5F53\u524D\u4F1A\u8BDD\u4E2D\u52A0\u8F7D`));
+    }
+    return false;
+  }
   const all = collectAllSkills();
   const match = all.find((e2) => e2.id === id) || all.find((e2) => e2.id.startsWith(id)) || all.find((e2) => e2.id.includes(id));
   if (!match) {
@@ -18572,7 +18592,7 @@ ${paramSummary}
           const label = parts.slice(3).join(" ") || `${type} (${genome})`;
           const entry = addDbEntry(dbRegistry, { label, type, genome, path: dbPath, source: "manual" });
           saveDbRegistry(dbRegistry);
-          systemPrompt = buildSystemPrompt(buildDbPromptSection(dbRegistry));
+          rebuildSystemPrompt();
           console.log(source_default.green(`\u2713 \u5DF2\u6DFB\u52A0\u6570\u636E\u5E93: ${entry.label}`));
           console.log(`  id: ${source_default.cyan(entry.id)}`);
           console.log(`  \u8DEF\u5F84: ${source_default.dim(entry.path)}`);
@@ -18588,7 +18608,7 @@ ${paramSummary}
           const removed = removeDbEntry(dbRegistry, dbArg.trim());
           if (removed) {
             saveDbRegistry(dbRegistry);
-            systemPrompt = buildSystemPrompt(buildDbPromptSection(dbRegistry));
+            rebuildSystemPrompt();
             console.log(source_default.green(`\u2713 \u5DF2\u79FB\u9664\u6570\u636E\u5E93: ${dbArg}`));
           } else {
             console.log(source_default.red(`\u672A\u627E\u5230\u6570\u636E\u5E93 id: ${dbArg}\uFF0C\u4F7F\u7528 /db list \u67E5\u770B\u5DF2\u6CE8\u518C\u5217\u8868`));
@@ -18623,7 +18643,7 @@ ${paramSummary}
           if (addedCount > 0) {
             dbRegistry.lastScan = (/* @__PURE__ */ new Date()).toISOString();
             saveDbRegistry(dbRegistry);
-            systemPrompt = buildSystemPrompt(buildDbPromptSection(dbRegistry));
+            rebuildSystemPrompt();
             console.log(source_default.green(`
   \u2713 \u65B0\u589E ${addedCount} \u4E2A\u6570\u636E\u5E93\u5230\u6CE8\u518C\u8868`));
           } else {
@@ -18705,11 +18725,18 @@ ${summary}` },
 \u5F53\u524D\u5DF2\u52A0\u8F7D\u7684 Skills (${injectedSkills.size} \u4E2A):
 `));
         for (const [id, name] of injectedSkills) {
-          console.log(`  ${source_default.green("\u25CF")} ${source_default.cyan(id)}  ${source_default.dim("\u2014 " + name)}`);
-          console.log(source_default.dim(`       /unload ${id}  \u53EF\u5378\u8F7D\u6B64 Skill`));
+          const isPerm = permanentSkillIds.has(id);
+          const icon = isPerm ? source_default.yellow("\u26A1") : source_default.green("\u25CF");
+          const tag = isPerm ? source_default.yellow(" [\u5E38\u9A7B]") : "";
+          console.log(`  ${icon} ${source_default.cyan(id)}${tag}  ${source_default.dim("\u2014 " + name)}`);
+          if (isPerm) {
+            console.log(source_default.dim(`       /unpin ${id}  \u53EF\u53D6\u6D88\u5E38\u9A7B`));
+          } else {
+            console.log(source_default.dim(`       /unload ${id}  \u53EF\u5378\u8F7D\u6B64 Skill`));
+          }
         }
         console.log();
-        console.log(source_default.dim("\u63D0\u793A: /clear \u6E05\u7A7A\u5168\u90E8\u5BF9\u8BDD\u548C Skills | /unload <id> \u5378\u8F7D\u5355\u4E2A"));
+        console.log(source_default.dim("\u63D0\u793A: /clear \u6E05\u7A7A\u5168\u90E8\u5BF9\u8BDD\u548C Skills | /unload <id> \u5378\u8F7D | /unpin <id> \u53D6\u6D88\u5E38\u9A7B"));
       }
       break;
     }
@@ -18726,6 +18753,11 @@ ${summary}` },
         console.log(source_default.dim("\u4F7F\u7528 /skills \u67E5\u770B\u5F53\u524D\u5DF2\u52A0\u8F7D\u7684 Skills"));
         break;
       }
+      if (permanentSkillIds.has(targetId)) {
+        console.log(source_default.yellow(`"${targetId}" \u662F\u5E38\u9A7B\u6280\u80FD\uFF0C\u65E0\u6CD5\u901A\u8FC7 /unload \u5378\u8F7D`));
+        console.log(source_default.dim(`  \u4F7F\u7528 /unpin ${targetId}  \u53EF\u5C06\u5176\u4ECE\u5E38\u9A7B\u5217\u8868\u4E2D\u79FB\u9664\uFF08\u4E0B\u6B21\u4F1A\u8BDD\u751F\u6548\uFF09`));
+        break;
+      }
       const SKILL_MARKER = `[Skill \u5DF2\u52A0\u8F7D: ${targetId}]`;
       let removed = 0;
       for (let i2 = history.length - 1; i2 >= 0; i2--) {
@@ -18806,29 +18838,118 @@ ${summary}` },
     }
     case "cat": {
       console.log(source_default.bold.cyan("\n\u2500\u2500\u2500 Skill \u5206\u7C7B\u76EE\u5F55 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-      console.log(source_default.dim("  \u4F7F\u7528 /sk <id> \u6FC0\u6D3B\u6280\u80FD  \xB7  \u4F7F\u7528 /sk <\u5173\u952E\u8BCD> \u641C\u7D22\n"));
+      console.log(source_default.dim("  \u4F7F\u7528 /sk <id> \u6FC0\u6D3B  \xB7  /sk <\u5173\u952E\u8BCD> \u641C\u7D22  \xB7  /pin <id> \u8BBE\u4E3A\u5E38\u9A7B\n"));
+      const allInstalled = collectAllSkills();
+      const permIds = Array.from(permanentSkillIds);
+      console.log(`  \u26A1  ${source_default.bold.yellow("\u5E38\u9A7B Skills")}  ${source_default.dim("(\u6BCF\u8F6E\u5BF9\u8BDD\u81EA\u52A8\u52A0\u5165\u4E0A\u4E0B\u6587)")}`);
+      if (permIds.length === 0) {
+        console.log(source_default.dim("     \u6682\u65E0\u5E38\u9A7B\u6280\u80FD\uFF0C\u4F7F\u7528 /pin <id> \u6DFB\u52A0"));
+      } else {
+        for (const id of permIds) {
+          const entry = allInstalled.find((e2) => e2.id === id);
+          const skillPath = entry ? (0, import_path6.join)(entry.dir, id, "SKILL.md") : "";
+          const name = skillPath && (0, import_fs6.existsSync)(skillPath) ? parseSkillMeta((0, import_fs6.readFileSync)(skillPath, "utf8")).name || id : id;
+          console.log(`     ${source_default.yellow(id)}  ${source_default.dim("\u2014 " + name)}`);
+        }
+        console.log(source_default.dim("     /unpin <id> \u53D6\u6D88\u5E38\u9A7B"));
+      }
+      console.log();
+      const routedIds = new Set(SKILL_ROUTES.map((r2) => r2.id));
       const byCategory = {};
       for (const route of SKILL_ROUTES) {
-        (byCategory[route.category] ??= []).push({ id: route.id, dir: "", tag: route.tag });
+        (byCategory[route.category] ??= []).push(route);
       }
+      console.log(`  \u{1F9EC}  ${source_default.bold.cyan("\u751F\u7269\u4FE1\u606F Skills")}  ${source_default.dim("(\u9700\u6FC0\u6D3B  /sk <id>)")}`);
       for (const [catKey, meta] of Object.entries(SKILL_CATEGORIES)) {
-        const items = byCategory[catKey];
-        if (!items || items.length === 0) continue;
-        console.log(`  ${meta.icon}  ${source_default.bold(meta.label)}`);
-        for (const item of items) {
-          const route = SKILL_ROUTES.find((r2) => r2.id === item.id);
-          console.log(`     ${source_default.cyan(item.id)}  ${source_default.dim("\u2014 " + route.name)}`);
+        const routes = byCategory[catKey];
+        if (!routes || routes.length === 0) continue;
+        console.log(`     ${source_default.bold(meta.icon + " " + meta.label)}`);
+        for (const route of routes) {
+          console.log(`       ${source_default.cyan(route.id)}  ${source_default.dim("\u2014 " + route.name)}`);
         }
-        console.log();
       }
-      const routedIds = new Set(SKILL_ROUTES.map((r2) => r2.id));
-      const allInstalled = collectAllSkills();
-      const unrouted = allInstalled.filter((e2) => !routedIds.has(e2.id));
-      if (unrouted.length > 0) {
-        console.log(`  \u{1F4E6}  ${source_default.bold("\u66F4\u591A Skills")}  ${source_default.dim(`(${unrouted.length} \u4E2A\uFF0C\u4F7F\u7528\u5173\u952E\u8BCD\u641C\u7D22)`)}`);
-        console.log(source_default.dim("     /sk <\u5173\u952E\u8BCD>\uFF0C\u4F8B: /sk ehr  /sk clinical  /sk imaging"));
-        console.log();
+      const bioUnrouted = allInstalled.filter(
+        (e2) => e2.tag === "bio" && !routedIds.has(e2.id) && !permanentSkillIds.has(e2.id)
+      );
+      if (bioUnrouted.length > 0) {
+        console.log(source_default.dim(`     \u2026 \u8FD8\u6709 ${bioUnrouted.length} \u4E2A\uFF0C\u4F7F\u7528 /sk <\u5173\u952E\u8BCD> \u641C\u7D22`));
+      }
+      console.log();
+      const downloaded = allInstalled.filter((e2) => e2.tag === "downloaded");
+      console.log(`  \u{1F4E6}  ${source_default.bold.green("\u5DF2\u5B89\u88C5 Skills")}  ${source_default.dim(`(${downloaded.length} \u4E2A\uFF0C/install \u4E0B\u8F7D  \u9700\u6FC0\u6D3B)`)}`);
+      if (downloaded.length === 0) {
+        console.log(source_default.dim("     \u6682\u65E0\uFF0C\u4F7F\u7528 /install <slug> \u4ECE clawhub \u5B89\u88C5"));
+      } else {
+        for (const e2 of downloaded.slice(0, 10)) {
+          const skillPath = (0, import_path6.join)(e2.dir, e2.id, "SKILL.md");
+          const name = (0, import_fs6.existsSync)(skillPath) ? parseSkillMeta((0, import_fs6.readFileSync)(skillPath, "utf8")).name || e2.id : e2.id;
+          console.log(`     ${source_default.green(e2.id)}  ${source_default.dim("\u2014 " + name)}`);
+        }
+        if (downloaded.length > 10)
+          console.log(source_default.dim(`     \u2026 \u8FD8\u6709 ${downloaded.length - 10} \u4E2A\uFF0C\u4F7F\u7528 /sk <\u5173\u952E\u8BCD> \u641C\u7D22`));
+      }
+      console.log();
+      const custom = allInstalled.filter((e2) => e2.tag === "custom");
+      console.log(`  \u270F\uFE0F   ${source_default.bold("\u81EA\u5B9A\u4E49 Skills")}  ${source_default.dim(`(${custom.length} \u4E2A\uFF0C\u653E\u5165 ${CUSTOM_SKILLS_DIR}  \u9700\u6FC0\u6D3B)`)}`);
+      if (custom.length === 0) {
+        console.log(source_default.dim(`     \u6682\u65E0\uFF0C\u5728 ${CUSTOM_SKILLS_DIR}/<skill-id>/SKILL.md \u521B\u5EFA`));
+      } else {
+        for (const e2 of custom) {
+          const skillPath = (0, import_path6.join)(e2.dir, e2.id, "SKILL.md");
+          const name = (0, import_fs6.existsSync)(skillPath) ? parseSkillMeta((0, import_fs6.readFileSync)(skillPath, "utf8")).name || e2.id : e2.id;
+          console.log(`     ${source_default.white(e2.id)}  ${source_default.dim("\u2014 " + name)}`);
+        }
+      }
+      console.log();
+      break;
+    }
+    case "pin": {
+      if (!arg) {
+        console.log("\u7528\u6CD5: /pin <skill-id>");
+        console.log(source_default.dim("\u5C06\u6307\u5B9A Skill \u8BBE\u4E3A\u5E38\u9A7B\uFF0C\u6BCF\u6B21\u5BF9\u8BDD\u81EA\u52A8\u52A0\u5165\u4E0A\u4E0B\u6587"));
+        break;
+      }
+      const allForPin = collectAllSkills();
+      const pinEntry = allForPin.find((e2) => e2.id === arg) || allForPin.find((e2) => e2.id.startsWith(arg)) || allForPin.find((e2) => e2.id.includes(arg));
+      if (!pinEntry) {
+        console.log(source_default.red(`\u627E\u4E0D\u5230 Skill: ${arg}\u3002\u4F7F\u7528 /sk <\u5173\u952E\u8BCD> \u641C\u7D22`));
+        break;
+      }
+      const pinCfg = loadConfig();
+      const perms = pinCfg.permanentSkills ?? [];
+      if (perms.includes(pinEntry.id)) {
+        console.log(source_default.yellow(`"${pinEntry.id}" \u5DF2\u662F\u5E38\u9A7B\u6280\u80FD`));
+        break;
+      }
+      pinCfg.permanentSkills = [...perms, pinEntry.id];
+      saveConfig(pinCfg);
+      rebuildSystemPrompt();
+      const pinPath = (0, import_path6.join)(pinEntry.dir, pinEntry.id, "SKILL.md");
+      if ((0, import_fs6.existsSync)(pinPath)) {
+        const { name } = parseSkillMeta((0, import_fs6.readFileSync)(pinPath, "utf8"));
+        injectedSkills.set(pinEntry.id, name || pinEntry.id);
+      } else {
+        injectedSkills.set(pinEntry.id, pinEntry.id);
+      }
+      console.log(source_default.green(`\u2713 "${pinEntry.id}" \u5DF2\u8BBE\u4E3A\u5E38\u9A7B\u6280\u80FD\uFF0C\u7CFB\u7EDF\u63D0\u793A\u5DF2\u66F4\u65B0`));
+      break;
+    }
+    case "unpin": {
+      if (!arg) {
+        console.log("\u7528\u6CD5: /unpin <skill-id>");
+        console.log(source_default.dim("\u5C06\u6307\u5B9A Skill \u4ECE\u5E38\u9A7B\u5217\u8868\u79FB\u9664\uFF08\u5F53\u524D\u4F1A\u8BDD\u4ECD\u6709\u6548\uFF0C\u4E0B\u6B21\u4F1A\u8BDD\u8D77\u751F\u6548\uFF09"));
+        break;
+      }
+      const unpinCfg = loadConfig();
+      const unpinPerms = unpinCfg.permanentSkills ?? [];
+      if (!unpinPerms.includes(arg)) {
+        console.log(source_default.yellow(`"${arg}" \u4E0D\u5728\u5E38\u9A7B\u5217\u8868\u4E2D`));
+        break;
       }
+      unpinCfg.permanentSkills = unpinPerms.filter((id) => id !== arg);
+      saveConfig(unpinCfg);
+      rebuildSystemPrompt();
+      console.log(source_default.green(`\u2713 "${arg}" \u5DF2\u4ECE\u5E38\u9A7B\u5217\u8868\u79FB\u9664\uFF08\u5F53\u524D\u4F1A\u8BDD\u4ECD\u6709\u6548\uFF0C\u4E0B\u6B21\u4F1A\u8BDD\u8D77\u751F\u6548\uFF09`));
       break;
     }
     case "cd": {
@@ -18867,7 +18988,73 @@ ${summary}` },
   }
   return {};
 }
+function rebuildSystemPrompt() {
+  systemPrompt = buildSystemPrompt(buildDbPromptSection(dbRegistry));
+  const cfg = loadConfig();
+  const ids = cfg.permanentSkills ?? [];
+  permanentSkillIds = new Set(ids);
+  if (ids.length === 0) return;
+  const all = collectAllSkills();
+  const parts = [];
+  for (const id of ids) {
+    const entry = all.find((e2) => e2.id === id);
+    if (!entry) continue;
+    const skillPath = (0, import_path6.join)(entry.dir, entry.id, "SKILL.md");
+    if (!(0, import_fs6.existsSync)(skillPath)) continue;
+    const content = (0, import_fs6.readFileSync)(skillPath, "utf8");
+    parts.push(`
+### \u5E38\u9A7B\u6280\u80FD: ${id}
+
+${content}`);
+  }
+  if (parts.length > 0) {
+    systemPrompt += "\n\n---\n\n# \u5E38\u9A7B\u6280\u80FD (Permanent Skills \u2014 \u5DF2\u81EA\u52A8\u6FC0\u6D3B\uFF0C\u6BCF\u8F6E\u5BF9\u8BDD\u5747\u6709\u6548)\n" + parts.join("\n");
+  }
+}
+function appendDebugRound(sysPrompt, msgs, response, elapsedMs, tokensIn, tokensOut) {
+  if (!debugFilePath) return;
+  debugRound++;
+  const ts = (/* @__PURE__ */ new Date()).toLocaleString("zh-CN");
+  const lines = [];
+  lines.push(`## \u7B2C ${debugRound} \u8F6E  (${ts})`);
+  lines.push("");
+  lines.push("### \u7CFB\u7EDF\u63D0\u793A (System Prompt)");
+  lines.push("");
+  lines.push("```text");
+  lines.push(sysPrompt);
+  lines.push("```");
+  lines.push("");
+  lines.push(`### \u5BF9\u8BDD\u8F93\u5165 (${msgs.length} \u6761\u6D88\u606F)`);
+  lines.push("");
+  msgs.forEach((m2, i2) => {
+    const isLast = i2 === msgs.length - 1;
+    const label = isLast ? `[${i2 + 1}] ${m2.role}\uFF08\u5F53\u524D\u8F93\u5165\uFF09` : `[${i2 + 1}] ${m2.role}`;
+    lines.push(`#### ${label}`);
+    lines.push("");
+    const content = typeof m2.content === "string" ? m2.content : JSON.stringify(m2.content, null, 2);
+    lines.push("```");
+    lines.push(content);
+    lines.push("```");
+    lines.push("");
+  });
+  lines.push("### \u6A21\u578B\u8F93\u51FA");
+  lines.push("");
+  lines.push(response);
+  lines.push("");
+  lines.push("### \u7EDF\u8BA1");
+  lines.push("");
+  lines.push(`| \u6307\u6807 | \u503C |`);
+  lines.push(`|------|-----|`);
+  lines.push(`| \u8017\u65F6 | ${(elapsedMs / 1e3).toFixed(2)}s |`);
+  lines.push(`| \u8F93\u5165 tokens | ${tokensIn} |`);
+  lines.push(`| \u8F93\u51FA tokens | ${tokensOut} |`);
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  (0, import_fs6.appendFileSync)(debugFilePath, lines.join("\n"), "utf8");
+}
 async function main() {
+  debugMode = process.argv.includes("--debug");
   installBundledData();
   printBanner();
   await checkAndAutoUpdate().catch(() => {
@@ -18893,8 +19080,15 @@ async function main() {
   console.log(`  ${source_default.bold("\u670D\u52A1\u5546:")}  ${prov?.name ?? cfg.provider}`);
   console.log(`  ${source_default.bold("\u6A21\u578B:")}    ${source_default.green(cfg.model)}`);
   console.log(`  ${source_default.bold("Skills:")}  ${skillsLabel}  ${source_default.dim("(/sk \u641C\u7D22  /cat \u5206\u7C7B\u76EE\u5F55)")}`);
+  if (permanentSkillIds.size > 0) {
+    const permList = Array.from(permanentSkillIds).join(", ");
+    console.log(`  ${source_default.bold("\u5E38\u9A7B:")}    ${source_default.yellow("\u26A1 " + permList)}  ${source_default.dim("(/pin \u6DFB\u52A0  /unpin \u79FB\u9664)")}`);
+  }
   console.log(`  ${source_default.bold("\u5DE5\u5177:")}    bash \xB7 read_file \xB7 write_file \xB7 list_dir \xB7 search_files`);
   console.log(`  ${source_default.bold("\u65B0\u529F\u80FD:")}  /sessions /resume /checkpoint /run /check-env /install /diff`);
+  if (debugMode) {
+    console.log(source_default.bold.yellow("  [DEBUG \u6A21\u5F0F]  \u6BCF\u8F6E\u5C06\u6253\u5370\u5B8C\u6574 Prompt \u53CA Token \u7EDF\u8BA1"));
+  }
   console.log(source_default.bold.cyan("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   const lastSess = getLastSession();
   if (lastSess) {
@@ -18923,10 +19117,43 @@ async function main() {
     }
     console.log();
   }
-  systemPrompt = buildSystemPrompt(buildDbPromptSection(dbRegistry));
+  rebuildSystemPrompt();
+  if (debugMode) {
+    const debugDir = (0, import_path6.join)(BGI_DIR, "debug");
+    (0, import_fs6.mkdirSync)(debugDir, { recursive: true });
+    const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
+    debugFilePath = (0, import_path6.join)(debugDir, `debug-${ts}.md`);
+    (0, import_fs6.writeFileSync)(
+      debugFilePath,
+      [
+        "# BGI CLI Debug Log",
+        "",
+        `- \u4F1A\u8BDD\u5F00\u59CB: ${(/* @__PURE__ */ new Date()).toLocaleString("zh-CN")}`,
+        `- \u6A21\u578B: ${cfg.model}`,
+        `- \u670D\u52A1\u5546: ${prov?.name ?? cfg.provider}`,
+        "",
+        "---",
+        ""
+      ].join("\n"),
+      "utf8"
+    );
+    console.log(source_default.bold.yellow(`  [DEBUG] \u8BB0\u5F55\u6587\u4EF6: ${debugFilePath}`));
+    console.log();
+  }
   let history = [];
   let thinkMode = false;
   const injectedSkills = /* @__PURE__ */ new Map();
+  {
+    const allForSeed = collectAllSkills();
+    for (const id of Array.from(permanentSkillIds)) {
+      const entry = allForSeed.find((e2) => e2.id === id);
+      if (entry) {
+        const sp = (0, import_path6.join)(entry.dir, entry.id, "SKILL.md");
+        const { name } = (0, import_fs6.existsSync)(sp) ? parseSkillMeta((0, import_fs6.readFileSync)(sp, "utf8")) : { name: "" };
+        injectedSkills.set(id, name || id);
+      }
+    }
+  }
   const sessionId = newSessionId();
   const sessionCreatedAt = (/* @__PURE__ */ new Date()).toISOString();
   SESSION_CTX.id = sessionId;
@@ -18998,32 +19225,48 @@ async function main() {
     console.log(`  \u6267\u884C\u547D\u4EE4:   ${source_default.green("\u2713 " + sessionStats.successCmds + " \u6210\u529F")}  ${sessionStats.failCmds > 0 ? source_default.yellow("\u2717 " + sessionStats.failCmds + " \u5931\u8D25") : source_default.dim("\u2717 0 \u5931\u8D25")}`);
     console.log(source_default.bold.cyan("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550"));
     rl.close();
-    let ans = "n";
-    try {
-      const exitRl = (0, import_readline.createInterface)({ input: process.stdin, output: process.stdout });
-      exitRl.on("SIGINT", () => {
-        exitRl.close();
-        process.exit(0);
-      });
-      process.once("SIGINT", () => {
-        exitRl.close();
-        process.exit(0);
-      });
-      ans = await Promise.race([
-        new Promise((res) => {
-          exitRl.question(source_default.cyan("\n  \u662F\u5426\u4FDD\u5B58\u672C\u6B21\u4F1A\u8BDD\u8BB0\u5FC6\uFF1F[y/N] "), (a2) => {
-            exitRl.close();
-            res(a2.trim().toLowerCase());
-          });
-        }),
-        new Promise((res) => setTimeout(() => {
-          exitRl.close();
-          res("n");
-        }, 15e3))
-      ]);
-    } catch {
+    async function askExitQuestion(prompt) {
+      let answer = "n";
+      try {
+        const eRl = (0, import_readline.createInterface)({ input: process.stdin, output: process.stdout });
+        eRl.on("SIGINT", () => {
+          eRl.close();
+          process.exit(0);
+        });
+        process.once("SIGINT", () => {
+          eRl.close();
+          process.exit(0);
+        });
+        answer = await Promise.race([
+          new Promise((res) => {
+            eRl.question(prompt, (a2) => {
+              eRl.close();
+              res(a2.trim().toLowerCase());
+            });
+          }),
+          new Promise((res) => setTimeout(() => {
+            eRl.close();
+            res("n");
+          }, 15e3))
+        ]);
+      } catch {
+      }
+      return answer;
+    }
+    const memAns = await askExitQuestion(source_default.cyan("\n  \u662F\u5426\u4FDD\u5B58\u672C\u6B21\u4F1A\u8BDD\u8BB0\u5FC6\uFF1F[y/N] "));
+    if (memAns === "y") saveSessionMemory();
+    if (debugMode && debugFilePath && (0, import_fs6.existsSync)(debugFilePath)) {
+      console.log(source_default.dim(`
+  Debug \u6587\u4EF6: ${debugFilePath}`));
+      const delAns = await askExitQuestion(source_default.yellow("  \u662F\u5426\u5220\u9664 debug \u8BB0\u5F55\u6587\u4EF6\uFF1F[y/N] "));
+      if (delAns === "y") {
+        try {
+          (0, import_fs6.rmSync)(debugFilePath);
+          console.log(source_default.dim("  \u5DF2\u5220\u9664"));
+        } catch {
+        }
+      }
     }
-    if (ans === "y") saveSessionMemory();
     console.log(source_default.dim("\n\u518D\u89C1\uFF01"));
     process.exit(0);
   }
@@ -19133,8 +19376,21 @@ ${expanded}` : expanded;
     try {
       const currentCfg = loadConfig();
       currentAbortController = new AbortController();
+      const debugT0 = debugMode ? Date.now() : 0;
+      const debugTokensBefore = debugMode ? { in: sessionStats.inputTokens, out: sessionStats.outputTokens } : null;
       const reply = await chat(history, currentCfg, systemPrompt, sessionStats, currentAbortController.signal);
       currentAbortController = null;
+      if (debugMode && debugTokensBefore && reply) {
+        const elapsedMs = Date.now() - debugT0;
+        const dIn = sessionStats.inputTokens - debugTokensBefore.in;
+        const dOut = sessionStats.outputTokens - debugTokensBefore.out;
+        try {
+          appendDebugRound(systemPrompt, history, reply, elapsedMs, dIn, dOut);
+        } catch {
+        }
+        console.log(source_default.bold.yellow(`
+  [DEBUG] \u5DF2\u8BB0\u5F55 \u2192 ${debugFilePath}`));
+      }
       if (!reply && history[history.length - 1]?.role === "user") {
         history.pop();
         console.log();