jinzd-ai-cli 0.4.81 → 0.4.82

package/README.zh-CN.md

@@ -20,7 +20,9 @@
 - **Unified Diff Patch 编辑**（v0.4.72+）— `edit_file` 支持标准 `@@ -a,b +c,d @@` hunk，大文件多处小改最省 token；容忍 ±200 行漂移与空白差异
 - **Anthropic Batches API**（v0.4.73+）— `aicli batch submit/list/status/results/cancel` 包 Message Batches（50% 折扣 + 24 小时窗口），适合离线分析和批量 eval
 - **Web UI 会话回放**（v0.4.71+）— 会话列表每项 🎬 按钮打开时间轴回放：消息、工具调用、推理内容、cache-aware token 用量一目了然
-- **对话分支**（v0.4.74+）— REPL 内 `/branch list/new/switch/delete/rename`，Web UI 回放面板每条消息旁 🌿 "fork here" 按钮，任意位置开辟新分支探索不同方向，原对话保持不变
+- **对话分支**（v0.4.74+）— REPL 内 `/branch list/new/switch/delete/rename/diff/cherry-pick`，Web UI 回放面板每条消息旁 🌿 "fork here" 按钮，任意位置开辟新分支探索不同方向，原对话保持不变；v0.4.81 起所有子命令支持 id / title / 唯一前缀
+- **符号索引**（v0.4.76+，C1）— tree-sitter 持久化索引（TS/JS/TSX/JSX/Python）+ 3 个只读 AI 工具（`find_symbol` / `get_outline` / `find_references`）+ `/index status/rebuild/clear`；启动后台增量刷新，`write_file` 后自动 upsert
+- **语义代码搜索**（v0.4.77+，C2）— `search_code` AI 工具 + 本地 sentence embedding（`paraphrase-multilingual-MiniLM-L12-v2`，117 MB 一次性下载，384 维，CPU 运行）；支持中英文自然语言查询代码；`/index semantic-rebuild/semantic-clear` 管理
 - **流式工具调用** — 实时流式展示 AI 推理过程和工具调用
 - **子代理系统** — 将复杂子任务委派给独立子代理执行
 - **深度推理** — Claude Extended Thinking，`/think` 一键切换
@@ -137,7 +139,7 @@ aicli
 
 ## 内置工具（Agentic 能力）
 
-AI 在对话中可自主调用 24 个工具：
+AI 在对话中可自主调用 28 个工具：
 
 | 工具 | 安全级别 | 说明 |
 |------|---------|------|
@@ -165,9 +167,20 @@ AI 在对话中可自主调用 24 个工具：
 | `git_log` | 安全 | 显示提交历史（单行/完整，按文件/作者过滤） |
 | `git_commit` | 写入 | 创建 git 提交（暂存文件、提交信息） |
 | `notebook_edit` | 写入 | 编辑 Jupyter notebook 单元格（增/改/删/移动） |
+| `find_symbol` | 安全 | 按名称精确查找函数/类/方法定义（C1，tree-sitter 索引） |
+| `get_outline` | 安全 | 获取文件的符号大纲（类 → 方法树）（C1） |
+| `find_references` | 安全 | 查找符号的所有引用（C1） |
+| `search_code` | 安全 | 语义代码搜索（C2，自然语言查询，中英文均可） |
 
 **安全级别**：`安全` = 自动执行，`写入` = diff 预览 + 确认，`破坏性` = 醒目警告 + 确认。
 
+### 文档深入阅读
+
+- [`docs/TUTORIAL.zh-CN.md`](docs/TUTORIAL.zh-CN.md) — **10 节动手教程**，1 小时从零到熟练
+- [`docs/USAGE.zh-CN.md`](docs/USAGE.zh-CN.md) — 完整参考手册（所有命令、工具、配置）
+- [`docs/ADVANCED.zh-CN.md`](docs/ADVANCED.zh-CN.md) — 架构与内部原理（开发者向）
+- [`docs/RECIPES.zh-CN.md`](docs/RECIPES.zh-CN.md) — 实战配方（按场景查）
+
 ## 主要 REPL 命令
 
 | 命令 | 说明 |

package/dist/{batch-JOYUXWBK.js → batch-2NLB5ZUL.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   ConfigManager
-} from "./chunk-JWE53S2U.js";
+} from "./chunk-CUIALV3O.js";
 import "./chunk-2ZD3YTVM.js";
-import "./chunk-BPIKBXGZ.js";
+import "./chunk-KBVJGOD6.js";
 
 // src/cli/batch.ts
 import Anthropic from "@anthropic-ai/sdk";

package/dist/{chunk-VEWRTIMX.js → chunk-3A6FQYJZ.js}

@@ -6,7 +6,7 @@ import { platform } from "os";
 import chalk from "chalk";
 
 // src/core/constants.ts
-var VERSION = "0.4.81";
+var VERSION = "0.4.82";
 var APP_NAME = "ai-cli";
 var CONFIG_DIR_NAME = ".aicli";
 var CONFIG_FILE_NAME = "config.json";

package/dist/{chunk-44MKM6OO.js → chunk-6GVBLOS3.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   TEST_TIMEOUT
-} from "./chunk-BPIKBXGZ.js";
+} from "./chunk-KBVJGOD6.js";
 
 // src/tools/builtin/run-tests.ts
 import { execSync } from "child_process";

package/dist/{chunk-JWE53S2U.js → chunk-CUIALV3O.js}

@@ -8,7 +8,7 @@ import {
   CONFIG_FILE_NAME,
   HISTORY_DIR_NAME,
   PLUGINS_DIR_NAME
-} from "./chunk-BPIKBXGZ.js";
+} from "./chunk-KBVJGOD6.js";
 
 // src/config/config-manager.ts
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";

package/dist/{chunk-HFSSDFQN.js → chunk-JHQMDIV4.js}

@@ -19,7 +19,7 @@ import {
 } from "./chunk-6VRJGH25.js";
 import {
   runTestsTool
-} from "./chunk-44MKM6OO.js";
+} from "./chunk-6GVBLOS3.js";
 import {
   CONFIG_DIR_NAME,
   DEFAULT_MAX_TOOL_OUTPUT_CHARS_CAP,
@@ -27,7 +27,7 @@ import {
   SUBAGENT_ALLOWED_TOOLS,
   SUBAGENT_DEFAULT_MAX_ROUNDS,
   SUBAGENT_MAX_ROUNDS_LIMIT
-} from "./chunk-BPIKBXGZ.js";
+} from "./chunk-KBVJGOD6.js";
 
 // src/tools/builtin/bash.ts
 import { execSync } from "child_process";

package/dist/{chunk-BPIKBXGZ.js → chunk-KBVJGOD6.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/core/constants.ts
-var VERSION = "0.4.81";
+var VERSION = "0.4.82";
 var APP_NAME = "ai-cli";
 var CONFIG_DIR_NAME = ".aicli";
 var CONFIG_FILE_NAME = "config.json";

package/dist/{chunk-U7ZSIOKV.js → chunk-PS7IEXHQ.js}

@@ -2,7 +2,7 @@
 import {
   schemaToJsonSchema,
   truncateForPersist
-} from "./chunk-HFSSDFQN.js";
+} from "./chunk-JHQMDIV4.js";
 import {
   AuthError,
   ProviderError,
@@ -18,7 +18,7 @@ import {
   MCP_PROTOCOL_VERSION,
   MCP_TOOL_PREFIX,
   VERSION
-} from "./chunk-BPIKBXGZ.js";
+} from "./chunk-KBVJGOD6.js";
 
 // src/providers/claude.ts
 import Anthropic from "@anthropic-ai/sdk";

package/dist/electron-server.js

@@ -36,7 +36,7 @@ import {
   VERSION,
   buildUserIdentityPrompt,
   runTestsTool
-} from "./chunk-VEWRTIMX.js";
+} from "./chunk-3A6FQYJZ.js";
 import {
   hasSemanticIndex,
   semanticSearch
@@ -11070,7 +11070,7 @@ ${undoResults.map((r) => `  \u2022 ${r}`).join("\n")}` });
       case "test": {
         this.send({ type: "info", message: "\u{1F9EA} Running tests..." });
         try {
-          const { executeTests } = await import("./run-tests-Q2GGLRK6.js");
+          const { executeTests } = await import("./run-tests-QJDIKKPF.js");
           const argStr = args.join(" ").trim();
           let testArgs = {};
           if (argStr) {

package/dist/{hub-WLBLPBT2.js → hub-6UHFVBNR.js}

@@ -385,7 +385,7 @@ ${content}`);
   }
 }
 async function runTaskMode(config, providers, configManager, topic) {
-  const { TaskOrchestrator } = await import("./task-orchestrator-2GGIA6EG.js");
+  const { TaskOrchestrator } = await import("./task-orchestrator-2QGCYWCI.js");
   const orchestrator = new TaskOrchestrator(config, providers, configManager);
   let interrupted = false;
   const onSigint = () => {

package/dist/index.js

@@ -30,10 +30,10 @@ import {
   saveDevState,
   sessionHasMeaningfulContent,
   setupProxy
-} from "./chunk-U7ZSIOKV.js";
+} from "./chunk-PS7IEXHQ.js";
 import {
   ConfigManager
-} from "./chunk-JWE53S2U.js";
+} from "./chunk-CUIALV3O.js";
 import {
   ToolExecutor,
   ToolRegistry,
@@ -49,7 +49,7 @@ import {
   spawnAgentContext,
   theme,
   undoStack
-} from "./chunk-HFSSDFQN.js";
+} from "./chunk-JHQMDIV4.js";
 import "./chunk-2ZD3YTVM.js";
 import {
   fileCheckpoints
@@ -58,7 +58,7 @@ import "./chunk-NHNWUBXB.js";
 import "./chunk-CQQQFNND.js";
 import "./chunk-6VRJGH25.js";
 import "./chunk-PFYAAX2S.js";
-import "./chunk-44MKM6OO.js";
+import "./chunk-6GVBLOS3.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   AUTHOR,
@@ -80,7 +80,7 @@ import {
   SKILLS_DIR_NAME,
   VERSION,
   buildUserIdentityPrompt
-} from "./chunk-BPIKBXGZ.js";
+} from "./chunk-KBVJGOD6.js";
 
 // src/index.ts
 import { program } from "commander";
@@ -2592,7 +2592,7 @@ ${hint}` : "")
       usage: "/test [command|filter]",
       async execute(args, ctx) {
         try {
-          const { executeTests } = await import("./run-tests-UX6KNA4R.js");
+          const { executeTests } = await import("./run-tests-KDJI6VFZ.js");
           const argStr = args.join(" ").trim();
           let testArgs = {};
           if (argStr) {
@@ -6485,7 +6485,7 @@ program.command("web").description("Start Web UI server with browser-based chat
     console.error("Error: Invalid port number. Must be between 1 and 65535.");
     process.exit(1);
   }
-  const { startWebServer } = await import("./server-LXE5HXOQ.js");
+  const { startWebServer } = await import("./server-VBR2F6YU.js");
   await startWebServer({ port, host: options.host });
 });
 program.command("user [action] [username]").description("Manage Web UI users (list | create <name> | delete <name> | reset-password <name> | migrate <name>)").action(async (action, username) => {
@@ -6608,7 +6608,7 @@ program.command("sessions").description("List recent conversation sessions").act
 });
 program.command("batch <action> [arg] [arg2]").description("Anthropic Message Batches: submit | list | status <id> | results <id> [out] | cancel <id>").option("--dry-run", "Parse and validate input without submitting (submit only)").action(async (action, arg, arg2, options) => {
   try {
-    const batch = await import("./batch-JOYUXWBK.js");
+    const batch = await import("./batch-2NLB5ZUL.js");
     switch (action) {
       case "submit":
         if (!arg) {
@@ -6768,7 +6768,7 @@ program.command("hub [topic]").description("Start multi-agent hub (discuss / bra
     }),
     config.get("customProviders")
   );
-  const { startHub } = await import("./hub-WLBLPBT2.js");
+  const { startHub } = await import("./hub-6UHFVBNR.js");
   await startHub(
     {
       topic: topic ?? "",

package/dist/{run-tests-UX6KNA4R.js → run-tests-KDJI6VFZ.js}

@@ -2,8 +2,8 @@
 import {
   executeTests,
   runTestsTool
-} from "./chunk-44MKM6OO.js";
-import "./chunk-BPIKBXGZ.js";
+} from "./chunk-6GVBLOS3.js";
+import "./chunk-KBVJGOD6.js";
 export {
   executeTests,
   runTestsTool

package/dist/{run-tests-Q2GGLRK6.js → run-tests-QJDIKKPF.js}

@@ -1,7 +1,7 @@
 import {
   executeTests,
   runTestsTool
-} from "./chunk-VEWRTIMX.js";
+} from "./chunk-3A6FQYJZ.js";
 export {
   executeTests,
   runTestsTool

package/dist/{server-LXE5HXOQ.js → server-VBR2F6YU.js}

@@ -20,10 +20,10 @@ import {
   persistToolRound,
   rebuildExtraMessages,
   setupProxy
-} from "./chunk-U7ZSIOKV.js";
+} from "./chunk-PS7IEXHQ.js";
 import {
   ConfigManager
-} from "./chunk-JWE53S2U.js";
+} from "./chunk-CUIALV3O.js";
 import {
   ToolExecutor,
   ToolRegistry,
@@ -41,14 +41,14 @@ import {
   spawnAgentContext,
   truncateOutput,
   undoStack
-} from "./chunk-HFSSDFQN.js";
+} from "./chunk-JHQMDIV4.js";
 import "./chunk-2ZD3YTVM.js";
 import "./chunk-4BKXL7SM.js";
 import "./chunk-NHNWUBXB.js";
 import "./chunk-CQQQFNND.js";
 import "./chunk-6VRJGH25.js";
 import "./chunk-PFYAAX2S.js";
-import "./chunk-44MKM6OO.js";
+import "./chunk-6GVBLOS3.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   AUTHOR,
@@ -67,7 +67,7 @@ import {
   SKILLS_DIR_NAME,
   VERSION,
   buildUserIdentityPrompt
-} from "./chunk-BPIKBXGZ.js";
+} from "./chunk-KBVJGOD6.js";
 import {
   AuthManager
 } from "./chunk-BYNY5JPB.js";
@@ -2229,7 +2229,7 @@ ${undoResults.map((r) => `  \u2022 ${r}`).join("\n")}` });
       case "test": {
         this.send({ type: "info", message: "\u{1F9EA} Running tests..." });
         try {
-          const { executeTests } = await import("./run-tests-UX6KNA4R.js");
+          const { executeTests } = await import("./run-tests-KDJI6VFZ.js");
           const argStr = args.join(" ").trim();
           let testArgs = {};
           if (argStr) {

package/dist/{task-orchestrator-2GGIA6EG.js → task-orchestrator-2QGCYWCI.js}

@@ -4,17 +4,17 @@ import {
   getDangerLevel,
   googleSearchContext,
   truncateOutput
-} from "./chunk-HFSSDFQN.js";
+} from "./chunk-JHQMDIV4.js";
 import "./chunk-2ZD3YTVM.js";
 import "./chunk-4BKXL7SM.js";
 import "./chunk-NHNWUBXB.js";
 import "./chunk-CQQQFNND.js";
 import "./chunk-6VRJGH25.js";
 import "./chunk-PFYAAX2S.js";
-import "./chunk-44MKM6OO.js";
+import "./chunk-6GVBLOS3.js";
 import {
   SUBAGENT_ALLOWED_TOOLS
-} from "./chunk-BPIKBXGZ.js";
+} from "./chunk-KBVJGOD6.js";
 
 // src/hub/task-orchestrator.ts
 import { createInterface } from "readline";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jinzd-ai-cli",
-  "version": "0.4.81",
+  "version": "0.4.82",
   "description": "Cross-platform REPL-style AI CLI with multi-provider support",
   "type": "module",
   "main": "./dist/index.js",