@jiangyuan1209/yuan-claw 0.1.3 → 0.1.10

package/LICENSE

@@ -0,0 +1,194 @@
+木兰宽松许可证，第2版
+
+木兰宽松许可证，第2版
+
+2020年1月 http://license.coscl.org.cn/MulanPSL2
+
+您对“软件”的复制、使用、修改及分发受木兰宽松许可证，第2版（“本许可证”）的如下条款的约束：
+
+0.   定义
+
+“软件” 是指由“贡献”构成的许可在“本许可证”下的程序和相关文档的集合。
+
+“贡献” 是指由任一“贡献者”许可在“本许可证”下的受版权法保护的作品。
+
+“贡献者” 是指将受版权法保护的作品许可在“本许可证”下的自然人或“法人实体”。
+
+“法人实体” 是指提交贡献的机构及其“关联实体”。
+
+“关联实体” 是指，对“本许可证”下的行为方而言，控制、受控制或与其共同受控制的机构，此处的控制是
+指有受控方或共同受控方至少50%直接或间接的投票权、资金或其他有价证券。
+
+1.   授予版权许可
+
+每个“贡献者”根据“本许可证”授予您永久性的、全球性的、免费的、非独占的、不可撤销的版权许可，您可
+以复制、使用、修改、分发其“贡献”，不论修改与否。
+
+2.   授予专利许可
+
+每个“贡献者”根据“本许可证”授予您永久性的、全球性的、免费的、非独占的、不可撤销的（根据本条规定
+撤销除外）专利许可，供您制造、委托制造、使用、许诺销售、销售、进口其“贡献”或以其他方式转移其“贡
+献”。前述专利许可仅限于“贡献者”现在或将来拥有或控制的其“贡献”本身或其“贡献”与许可“贡献”时的“软
+件”结合而将必然会侵犯的专利权利要求，不包括对“贡献”的修改或包含“贡献”的其他结合。如果您或您的“
+关联实体”直接或间接地，就“软件”或其中的“贡献”对任何人发起专利侵权诉讼（包括反诉或交叉诉讼）或
+其他专利维权行动，指控其侵犯专利权，则“本许可证”授予您对“软件”的专利许可自您提起诉讼或发起维权
+行动之日终止。
+
+3.   无商标许可
+
+“本许可证”不提供对“贡献者”的商品名称、商标、服务标志或产品名称的商标许可，但您为满足第4条规定
+的声明义务而必须使用除外。
+
+4.   分发限制
+
+您可以在任何媒介中将“软件”以源程序形式或可执行形式重新分发，不论修改与否，但您必须向接收者提供“
+本许可证”的副本，并保留“软件”中的版权、商标、专利及免责声明。
+
+5.   免责声明与责任限制
+
+“软件”及其中的“贡献”在提供时不带任何明示或默示的担保。在任何情况下，“贡献者”或版权所有者不对
+任何人因使用“软件”或其中的“贡献”而引发的任何直接或间接损失承担责任，不论因何种原因导致或者基于
+何种法律理论，即使其曾被建议有此种损失的可能性。
+
+6.   语言
+
+“本许可证”以中英文双语表述，中英文版本具有同等法律效力。如果中英文版本存在任何冲突不一致，以中文
+版为准。
+
+条款结束
+
+如何将木兰宽松许可证，第2版，应用到您的软件
+
+如果您希望将木兰宽松许可证，第2版，应用到您的新软件，为了方便接收者查阅，建议您完成如下三步：
+
+1， 请您补充如下声明中的空白，包括软件名、软件的首次发表年份以及您作为版权人的名字；
+
+2， 请您在软件包的一级目录下创建以“LICENSE”为名的文件，将整个许可证文本放入该文件中；
+
+3， 请将如下声明文本放入每个源文件的头部注释中。
+
+Copyright (c) [Year] [name of copyright holder]
+[Software Name] is licensed under Mulan PSL v2.
+You can use this software according to the terms and conditions of the Mulan
+PSL v2.
+You may obtain a copy of Mulan PSL v2 at:
+         http://license.coscl.org.cn/MulanPSL2
+THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY
+KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
+NON-INFRINGEMENT, MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+See the Mulan PSL v2 for more details.
+
+Mulan Permissive Software License，Version 2
+
+Mulan Permissive Software License，Version 2 (Mulan PSL v2)
+
+January 2020 http://license.coscl.org.cn/MulanPSL2
+
+Your reproduction, use, modification and distribution of the Software shall
+be subject to Mulan PSL v2 (this License) with the following terms and
+conditions:
+
+0. Definition
+
+Software means the program and related documents which are licensed under
+this License and comprise all Contribution(s).
+
+Contribution means the copyrightable work licensed by a particular
+Contributor under this License.
+
+Contributor means the Individual or Legal Entity who licenses its
+copyrightable work under this License.
+
+Legal Entity means the entity making a Contribution and all its
+Affiliates.
+
+Affiliates means entities that control, are controlled by, or are under
+common control with the acting entity under this License, ‘control’ means
+direct or indirect ownership of at least fifty percent (50%) of the voting
+power, capital or other securities of controlled or commonly controlled
+entity.
+
+1. Grant of Copyright License
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to you a perpetual, worldwide, royalty-free, non-exclusive,
+irrevocable copyright license to reproduce, use, modify, or distribute its
+Contribution, with modification or not.
+
+2. Grant of Patent License
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to you a perpetual, worldwide, royalty-free, non-exclusive,
+irrevocable (except for revocation under this Section) patent license to
+make, have made, use, offer for sale, sell, import or otherwise transfer its
+Contribution, where such patent license is only limited to the patent claims
+owned or controlled by such Contributor now or in future which will be
+necessarily infringed by its Contribution alone, or by combination of the
+Contribution with the Software to which the Contribution was contributed.
+The patent license shall not apply to any modification of the Contribution,
+and any other combination which includes the Contribution. If you or your
+Affiliates directly or indirectly institute patent litigation (including a
+cross claim or counterclaim in a litigation) or other patent enforcement
+activities against any individual or entity by alleging that the Software or
+any Contribution in it infringes patents, then any patent license granted to
+you under this License for the Software shall terminate as of the date such
+litigation or activity is filed or taken.
+
+3. No Trademark License
+
+No trademark license is granted to use the trade names, trademarks, service
+marks, or product names of Contributor, except as required to fulfill notice
+requirements in section 4.
+
+4. Distribution Restriction
+
+You may distribute the Software in any medium with or without modification,
+whether in source or executable forms, provided that you provide recipients
+with a copy of this License and retain copyright, patent, trademark and
+disclaimer statements in the Software.
+
+5. Disclaimer of Warranty and Limitation of Liability
+
+THE SOFTWARE AND CONTRIBUTION IN IT ARE PROVIDED WITHOUT WARRANTIES OF ANY
+KIND, EITHER EXPRESS OR IMPLIED. IN NO EVENT SHALL ANY CONTRIBUTOR OR
+COPYRIGHT HOLDER BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING, BUT NOT
+LIMITED TO ANY DIRECT, OR INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING
+FROM YOUR USE OR INABILITY TO USE THE SOFTWARE OR THE CONTRIBUTION IN IT, NO
+MATTER HOW IT’S CAUSED OR BASED ON WHICH LEGAL THEORY, EVEN IF ADVISED OF
+THE POSSIBILITY OF SUCH DAMAGES.
+
+6. Language
+
+THIS LICENSE IS WRITTEN IN BOTH CHINESE AND ENGLISH, AND THE CHINESE VERSION
+AND ENGLISH VERSION SHALL HAVE THE SAME LEGAL EFFECT. IN THE CASE OF
+DIVERGENCE BETWEEN THE CHINESE AND ENGLISH VERSIONS, THE CHINESE VERSION
+SHALL PREVAIL.
+
+END OF THE TERMS AND CONDITIONS
+
+How to Apply the Mulan Permissive Software License，Version 2
+(Mulan PSL v2) to Your Software
+
+To apply the Mulan PSL v2 to your work, for easy identification by
+recipients, you are suggested to complete following three steps:
+
+i. Fill in the blanks in following statement, including insert your software
+name, the year of the first publication of your software, and your name
+identified as the copyright owner;
+
+ii. Create a file named "LICENSE" which contains the whole context of this
+License in the first directory of your software package;
+
+iii. Attach the statement to the appropriate annotated syntax at the
+beginning of each source file.
+
+Copyright (c) [Year] [name of copyright holder]
+[Software Name] is licensed under Mulan PSL v2.
+You can use this software according to the terms and conditions of the Mulan
+PSL v2.
+You may obtain a copy of Mulan PSL v2 at:
+         http://license.coscl.org.cn/MulanPSL2
+THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY
+KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
+NON-INFRINGEMENT, MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+See the Mulan PSL v2 for more details.

package/README.md

@@ -9,7 +9,7 @@
 - 🤖 本地命令行智能体
 - 🧠 基于大模型的任务执行与推理
 - 🔧 可扩展的工具调用机制
-- 🌐 支持 Brave Search 网页搜索
+- 🌐 支持 Baidu Search 网页搜索
 - 📄 支持 HTTP 抓取与网页正文提取
 - 💬 支持多轮会话
 - 🖥️ 支持交互式 REPL
@@ -124,7 +124,7 @@ yuan-claw
   "MODEL_API_KEY": "your_api_key",
   "MODEL_BASE_URL": "https://dashscope.aliyuncs.com/compatible-mode/v1",
   "MODEL_NAME": "qwen3-max-2026-01-23",
-  "BRAVE_SEARCH_API_KEY": "your_brave_search_api_key",
+  "BAIDU_API_KEY": "your_baidu_search_api_key",
   "HTTP_PROXY": "http://127.0.0.1:33210",
   "HTTPS_PROXY": "http://127.0.0.1:33210"
 }
@@ -144,7 +144,7 @@ yuan-claw
 
 ```json
 {
-  "BRAVE_SEARCH_API_KEY": "your_brave_search_api_key"
+  "BAIDU_API_KEY": "your_baidu_search_api_key"
 }
 ```
 
@@ -197,7 +197,7 @@ yuan-claw "帮我搜索 OpenAI 最新消息"
 - `OPENAI_API_KEY`
 - `OPENAI_BASE_URL`
 - `OPENAI_MODEL`
-- `BRAVE_SEARCH_API_KEY`
+- `BAIDU_API_KEY`
 - `HTTP_PROXY`
 - `HTTPS_PROXY`
 - `http_proxy`
@@ -222,7 +222,7 @@ yuan-claw "帮我搜索 OpenAI 最新消息"
   "MODEL_API_KEY": "your_dashscope_api_key",
   "MODEL_BASE_URL": "https://dashscope.aliyuncs.com/compatible-mode/v1",
   "MODEL_NAME": "qwen3-max-2026-01-23",
-  "BRAVE_SEARCH_API_KEY": "your_brave_search_api_key",
+  "BAIDU_API_KEY": "your_baidu_search_api_key",
   "HTTP_PROXY": "http://127.0.0.1:33210",
   "HTTPS_PROXY": "http://127.0.0.1:33210"
 }
@@ -230,28 +230,11 @@ yuan-claw "帮我搜索 OpenAI 最新消息"
 
 ---
 
-## Environment Variables（兼容方式）
+## Environment Variables（已废弃）
 
-除了 `~/.yuan-claw/settings.json` 外，开发者也可以在项目根目录通过 `.env` 配置：
+项目已不再通过 `.env` 加载配置，所有配置均通过 `~/.yuan-claw/settings.json` 管理。
 
-```env
-MODEL_API_KEY=
-MODEL_BASE_URL=
-MODEL_NAME=
-
-BRAVE_SEARCH_API_KEY=
-
-HTTP_PROXY=
-HTTPS_PROXY=
-```
-
-也支持 OpenAI 风格变量名：
-
-```env
-OPENAI_API_KEY=
-OPENAI_BASE_URL=
-OPENAI_MODEL=
-```
+如果你仍习惯使用 `.env`，可以自行在项目中通过 `dotenv` 加载，但不再推荐。
 
 > 普通 CLI 用户更推荐使用：
 >
@@ -362,7 +345,7 @@ npm run start
 
 ```json
 {
-  "BRAVE_SEARCH_API_KEY": "your_brave_search_api_key"
+  "BAIDU_API_KEY": "your_baidu_search_api_key"
 }
 ```
 
@@ -482,6 +465,35 @@ EOF
 
 ---
 
+## IntelliJ IDEA / WebStorm 插件
+
+yuan-claw 提供了 JetBrains IDE 插件，可在 IDE 内一键启动 CLI，无需切换终端。
+
+### 安装
+
+1. 下载插件：`idea-plugin/build/distributions/yuan-claw-plugin-1.0.0.zip`
+   （或从 [Releases](https://github.com/your-name/yuan-claw/releases) 获取）
+2. 打开 IDE → `Settings` → `Plugins` → `⚙️ 齿轮图标` → `Install Plugin from Disk`
+3. 选择 zip 文件，安装完成后 **重启 IDE**
+
+### 使用
+
+- **顶部菜单栏**：`Tools` → `Run Yuan-Claw`
+- **快捷键**：`Ctrl + Alt + Y`（macOS: `⌃⌥Y`）
+
+点击后会在 IDE 底部终端窗口打开一个名为 `yuan-claw` 的标签页，并在项目根目录下自动执行 `yuan-claw` 命令。
+
+### 从源码构建
+
+```bash
+cd idea-plugin
+./gradlew buildPlugin
+```
+
+构建产物：`build/distributions/yuan-claw-plugin-1.0.0.zip`
+
+---
+
 ## Scripts
 
 ```json
@@ -571,11 +583,9 @@ yuan-claw
 
 ### `Missing MODEL_API_KEY / OPENAI_API_KEY in environment variables.`
 
-说明模型 API Key 尚未正确配置。请至少在以下任一位置填写：
+说明模型 API Key 尚未正确配置。请在以下位置填写：
 
 - `~/.yuan-claw/settings.json`
-- 系统环境变量
-- 项目根目录 `.env`
 
 例如：
 
@@ -587,13 +597,13 @@ yuan-claw
 
 ---
 
-### `web_search disabled: set BRAVE_SEARCH_API_KEY`
+### `web_search disabled: set BAIDU_API_KEY`
 
-说明未配置 Brave Search API Key。请添加：
+说明未配置百度搜索 API Key。请添加：
 
 ```json
 {
-  "BRAVE_SEARCH_API_KEY": "your_brave_search_api_key"
+  "BAIDU_API_KEY": "your_baidu_search_api_key"
 }
 ```
 
@@ -660,22 +670,7 @@ npm run check
 npm run dev
 ```
 
-如果你使用源码开发方式，也可以在项目根目录创建 `.env` 文件辅助调试。
-
----
-
-## Roadmap
-
-- [ ] 优化 approval 菜单显示体验
-- [ ] 增强搜索结果验证能力
-- [ ] 优化网页正文提取效果
-- [ ] 增加更多内置工具
-- [ ] 支持更多模型服务商
-- [ ] 完善自动化测试
-- [ ] 增加 Docker 部署支持
-
 ---
-
 ## License
 
 MIT

package/dist/config/init-user-config.js

@@ -7,8 +7,7 @@ const DEFAULT_SETTINGS = {
     OPENAI_API_KEY: "",
     OPENAI_BASE_URL: "",
     OPENAI_MODEL: "",
-    BRAVE_SEARCH_API_KEY: "",
-    BRAVE_API_KEY: "",
+    BAIDU_API_KEY: "",
     HTTP_PROXY: "",
     HTTPS_PROXY: "",
 };

package/dist/config/load-config.js

@@ -8,8 +8,7 @@ const userSettingsSchema = z.object({
     OPENAI_API_KEY: z.string().optional(),
     OPENAI_BASE_URL: z.string().optional(),
     OPENAI_MODEL: z.string().optional(),
-    BRAVE_SEARCH_API_KEY: z.string().optional(),
-    BRAVE_API_KEY: z.string().optional(),
+    BAIDU_API_KEY: z.string().optional(),
     HTTP_PROXY: z.string().optional(),
     HTTPS_PROXY: z.string().optional(),
     http_proxy: z.string().optional(),

package/dist/model/providers/openai-compatible.js

@@ -13,6 +13,57 @@ export function createOpenAICompatibleClient(options = {}) {
     });
     return {
         async generate(messages) {
+            // ============================================================
+            // JSON Prompting 模式（当前实现）
+            // ============================================================
+            // Agent 的"工具调用"完全由 Prompt 驱动：
+            // 1. System Prompt 中要求 "输出严格 JSON"
+            // 2. 定义协议: {"type":"tool_call","toolName":"xxx","args":{}}
+            // 3. 在 runLocalAgentLoop 中用 parseAgentResponse 本地解析
+            // 4. 不传 tools 参数，LLM 不知道有哪些工具可用（通过 Prompt 告知）
+            //
+            // 优势：兼容所有 LLM（包括不支持 Function Calling 的模型）
+            // 劣势：依赖 LLM 遵循指令的能力，格式可能出错
+            // ============================================================
+            // ── 如果是 Function Calling 模式，代码应改为下方注释所示 ──
+            // const response = await client.chat.completions.create({
+            //     model,
+            //     messages: messages.map((message) => ({
+            //         role: message.role === "tool" ? "tool" : message.role,
+            //         content: message.content,
+            //         tool_call_id: message.toolCallId,  // 关联 tool_call 和 result
+            //     })),
+            //     tools: [                              // ← 声明可用工具
+            //         {
+            //             type: "function",
+            //             function: {
+            //                 name: "read_file",
+            //                 description: "Read a UTF-8 text file",
+            //                 parameters: {
+            //                     type: "object",
+            //                     properties: {
+            //                         path: { type: "string", description: "File path" },
+            //                     },
+            //                     required: ["path"],
+            //                 },
+            //             },
+            //         },
+            //     ],
+            //     tool_choice: "auto",                  // ← LLM 自主决定是否调用工具
+            //     temperature: 0,
+            // });
+            //
+            // const choice = response.choices[0];
+            // if (choice.message.tool_calls?.length) {
+            //     // Function Calling 模式：LLM 返回 tool_calls 结构
+            //     return JSON.stringify({
+            //         type: "tool_call",
+            //         toolName: choice.message.tool_calls[0].function.name,
+            //         args: JSON.parse(choice.message.tool_calls[0].function.arguments),
+            //     });
+            // }
+            // return choice.message.content ?? "";
+            // ────────────────────────────────────────────────────────────
             const response = await client.chat.completions.create({
                 model,
                 messages: messages.map((message) => ({

package/dist/tools/registry.js

@@ -5,7 +5,7 @@ import { createGrepTextTool } from "./file/grep-text.js";
 import { createShellExecTool } from "./shell/shell-exec.js";
 import { createGitStatusTool } from "./git/git-status.js";
 import { createGitDiffTool } from "./git/git-diff.js";
-import { createHttpFetchTool, createWebSearchTool, createExtractReadableTextTool, createBraveSearchProvider, } from "./web/index.js";
+import { createHttpFetchTool, createWebSearchTool, createExtractReadableTextTool, createBaiduSearchProvider, } from "./web/index.js";
 export function createToolRegistry(options) {
     const tools = [
         createReadFileTool({ workspaceRoot: options.workspaceRoot }),
@@ -19,20 +19,17 @@ export function createToolRegistry(options) {
         createExtractReadableTextTool(),
     ];
     const config = options.config ?? {};
-    const braveApiKey = config.BRAVE_SEARCH_API_KEY ??
-        config.BRAVE_API_KEY ??
-        process.env.BRAVE_SEARCH_API_KEY ??
-        process.env.BRAVE_API_KEY;
-    if (braveApiKey) {
+    const baiduApiKey = config.BAIDU_API_KEY;
+    if (baiduApiKey) {
         tools.push(createWebSearchTool({
-            provider: createBraveSearchProvider({
-                apiKey: braveApiKey,
+            provider: createBaiduSearchProvider({
+                apiKey: baiduApiKey,
             }),
         }));
-        console.warn("[tools] web_search enabled via Brave Search API");
+        console.warn("[tools] web_search enabled via Baidu Search API");
     }
     else {
-        console.warn("[tools] web_search disabled: set BRAVE_SEARCH_API_KEY or BRAVE_API_KEY");
+        console.warn("[tools] web_search disabled: set BAIDU_API_KEY in settings.json");
     }
     return new Map(tools.map((tool) => [tool.name, tool]));
 }

package/dist/tools/web/index.js

@@ -1,4 +1,4 @@
 export { createHttpFetchTool } from "./http-fetch.js";
 export { createWebSearchTool } from "./web-search.js";
 export { createExtractReadableTextTool } from "./extract-readable-text.js";
-export { createBraveSearchProvider } from "./search-providers/brave.js";
+export { createBaiduSearchProvider } from "./search-providers/baidu.js";

package/dist/tools/web/search-providers/baidu.js

@@ -0,0 +1,36 @@
+export function createBaiduSearchProvider(options) {
+    const baseUrl = options.baseUrl ?? "https://qianfan.baidubce.com/v2/ai_search/web_search";
+    return async function baiduSearch(query, count) {
+        const response = await fetch(baseUrl, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${options.apiKey}`,
+                "X-Appbuilder-From": "yuan-claw",
+                "User-Agent": "Mozilla/5.0 (compatible; XSimpleWebSearch/1.0)",
+            },
+            body: JSON.stringify({
+                messages: [{ content: query, role: "user" }],
+                search_source: "baidu_search_v2",
+                resource_type_filter: [{ type: "web", top_k: count }],
+            }),
+        });
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => "");
+            throw new Error(`Baidu search failed: ${response.status} ${response.statusText}${errorText ? ` - ${errorText}` : ""}`);
+        }
+        const data = (await response.json());
+        if (data.code) {
+            throw new Error(`Baidu search error: ${data.message ?? data.code}`);
+        }
+        return (data.references ?? [])
+            .slice(0, count)
+            .map((item) => ({
+            title: item.title ?? "",
+            url: item.url ?? "",
+            snippet: item.content ?? "",
+            source: "baidu",
+        }))
+            .filter((item) => item.url.trim().length > 0);
+    };
+}

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "@jiangyuan1209/yuan-claw",
-  "version": "0.1.3",
+  "version": "0.1.10",
   "description": "A local CLI agent with tools, search, and interactive approval.",
   "type": "module",
   "bin": {
     "yuan-claw": "./dist/cli/main.js"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jiangyuan1209/yuan-claw.git"
+  },
   "files": [
     "dist",
     "README.md",

package/.env.example

@@ -1,28 +0,0 @@
-# =========================
-# 模型服务配置（推荐）
-# =========================
-
-MODEL_API_KEY=
-MODEL_BASE_URL=
-MODEL_NAME=
-
-# =========================
-# OpenAI 风格兼容变量（可选）
-# =========================
-
-OPENAI_API_KEY=
-OPENAI_BASE_URL=
-OPENAI_MODEL=
-
-# =========================
-# 网页搜索配置
-# =========================
-
-BRAVE_SEARCH_API_KEY=
-
-# =========================
-# 代理配置（可选）
-# =========================
-
-HTTP_PROXY=
-HTTPS_PROXY=