jarvis-ai-assistant 0.3.19__tar.gz → 0.3.21__tar.gz

{jarvis_ai_assistant-0.3.19/src/jarvis_ai_assistant.egg-info → jarvis_ai_assistant-0.3.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jarvis-ai-assistant
-Version: 0.3.19
+Version: 0.3.21
 Summary: Jarvis: An AI assistant that uses tools to interact with the system
 Home-page: https://github.com/skyfireitdiy/Jarvis
 Author: skyfire
@@ -94,7 +94,7 @@ Dynamic: requires-python
 
 *您的智能开发和系统交互助手*
 
-[快速开始](#quick-start) • [核心功能](#core-features) • [配置说明](#configuration) • [Jarvis Book](#jarvis-book) • [技术细节](docs/technical_documentation.md) • [Wiki文档](docs/jarvis_book/1.项目介绍.md) • [贡献指南](#contributing) • [许可证](#license)
+[快速开始](#quick-start) • [核心功能](#core-features) • [配置说明](#configuration) • [Jarvis Book](#jarvis-book) • [Wiki文档](docs/jarvis_book/1.项目介绍.md) • [贡献指南](#contributing) • [许可证](#license)
 </div>
 
 ---
@@ -304,6 +304,14 @@ ENV:
   YUANBAO_COOKIES: "在此处粘贴您的元宝Cookies"
 ```
 
+提示：错误回溯输出控制
+- 默认情况下，当 PrettyOutput 打印错误信息（OutputType.ERROR）时，不会自动打印回溯调用链。
+- 如需全局启用错误回溯，请在配置中设置：
+```yaml
+JARVIS_PRINT_ERROR_TRACEBACK: true
+```
+- 也可以在单次调用时通过传入 `traceback=True` 临时开启回溯打印。
+
 Jarvis 支持多种平台，包括 **Kimi**, **通义千问**, **OpenAI** 等。详细的配置选项、模型组设置以及所有可用参数，请参阅 [**使用指南**](docs/jarvis_book/4.使用指南.md)。
 
 > **模型推荐**: 目前效果较好的模型是 `claude-opus-4-20250514`，可以通过国内代理商购买，例如 [FoxiAI](https://foxi-ai.top)。

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/README.md

@@ -8,7 +8,7 @@
 
 *您的智能开发和系统交互助手*
 
-[快速开始](#quick-start) • [核心功能](#core-features) • [配置说明](#configuration) • [Jarvis Book](#jarvis-book) • [技术细节](docs/technical_documentation.md) • [Wiki文档](docs/jarvis_book/1.项目介绍.md) • [贡献指南](#contributing) • [许可证](#license)
+[快速开始](#quick-start) • [核心功能](#core-features) • [配置说明](#configuration) • [Jarvis Book](#jarvis-book) • [Wiki文档](docs/jarvis_book/1.项目介绍.md) • [贡献指南](#contributing) • [许可证](#license)
 </div>
 
 ---
@@ -218,6 +218,14 @@ ENV:
   YUANBAO_COOKIES: "在此处粘贴您的元宝Cookies"
 ```
 
+提示：错误回溯输出控制
+- 默认情况下，当 PrettyOutput 打印错误信息（OutputType.ERROR）时，不会自动打印回溯调用链。
+- 如需全局启用错误回溯，请在配置中设置：
+```yaml
+JARVIS_PRINT_ERROR_TRACEBACK: true
+```
+- 也可以在单次调用时通过传入 `traceback=True` 临时开启回溯打印。
+
 Jarvis 支持多种平台，包括 **Kimi**, **通义千问**, **OpenAI** 等。详细的配置选项、模型组设置以及所有可用参数，请参阅 [**使用指南**](docs/jarvis_book/4.使用指南.md)。
 
 > **模型推荐**: 目前效果较好的模型是 `claude-opus-4-20250514`，可以通过国内代理商购买，例如 [FoxiAI](https://foxi-ai.top)。

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jarvis-ai-assistant"
-version = "0.3.19"
+version = "0.3.21"
 description = "Jarvis: An AI assistant that uses tools to interact with the system"
 readme = "README.md"
 authors = [{ name = "skyfire", email = "skyfireitdiy@hotmail.com" }]
@@ -106,9 +106,13 @@ jst = "jarvis.jarvis_stats.cli:main"
 index-strategy = "unsafe-first-match"
 
 [[tool.uv.index]]
-url = "https://mirrors.cloud.tencent.com/pypi/simple"
+url = "https://pypi.org/simple"
 default = true
 
+[[tool.uv.index]]
+name = "tencent"
+url = "https://mirrors.cloud.tencent.com/pypi/simple"
+
 [[tool.uv.index]]
 name = "aliyun"
 url = "https://mirrors.aliyun.com/pypi/simple/"

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/setup.py

@@ -3,7 +3,7 @@ from setuptools import setup, find_packages  # type: ignore
 
 setup(
     name="jarvis-ai-assistant",
-    version="0.3.19",
+    version="0.3.21",
     author="skyfire",
     author_email="skyfireitdiy@hotmail.com",
     description="An AI assistant that uses various tools to interact with the system",

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/src/jarvis/__init__.py

@@ -1,4 +1,4 @@
 # -*- coding: utf-8 -*-
 """Jarvis AI Assistant"""
 
-__version__ = "0.3.19"
+__version__ = "0.3.21"

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/src/jarvis/jarvis_agent/__init__.py

@@ -176,6 +176,21 @@ origin_agent_system_prompt = f"""
 4.  **完成**: 验证任务是否达成目标，并进行总结。
 </workflow>
 
+<sub_agents_guide>
+# 子任务工具使用建议
+- 使用 sub_code_agent（代码子Agent）当：
+  - 需要在当前任务下并行推进较大且相对独立的代码改造
+  - 涉及多文件/多模块的大范围变更，或需要较长的工具调用链
+  - 需要隔离上下文以避免污染当前对话（如探索性改动、PoC）
+  - 需要专注于单一代码子问题，阶段性产出可复用的结果
+- 使用 sub_agent（通用子Agent）当：
+  - 子任务不是以代码改造为主（如调研、方案撰写、评审总结、用例设计、文档生成等）
+  - 只是需要短期分流一个轻量的辅助性子任务
+说明：
+- 两者仅需参数 task（可选 background 提供上下文），完成后返回结果给父Agent
+- 子Agent将自动完成并生成总结，请在上层根据返回结果继续编排
+</sub_agents_guide>
+
 <system_info>
 # 系统信息
 - OS: {platform.platform()} {platform.version()}
@@ -223,6 +238,7 @@ class Agent:
         use_analysis: Optional[bool] = None,
         force_save_memory: Optional[bool] = None,
         files: Optional[List[str]] = None,
+        confirm_callback: Optional[Callable[[str, bool], bool]] = None,
     ):
         """初始化Jarvis Agent实例
 
@@ -241,6 +257,7 @@ class Agent:
             use_methodology: 是否使用方法论
             use_analysis: 是否使用任务分析
             force_save_memory: 是否强制保存记忆
+            confirm_callback: 用户确认回调函数，签名为 (tip: str, default: bool) -> bool；默认使用CLI的user_confirm
         """
         # 基础属性初始化
         self.files = files or []
@@ -254,6 +271,11 @@ class Agent:
         self.user_data: Dict[str, Any] = {}
         self.after_tool_call_cb: Optional[Callable[[Agent], None]] = None
 
+        # 用户确认回调：默认使用 CLI 的 user_confirm，可由外部注入以支持 TUI/GUI
+        self.user_confirm: Callable[[str, bool], bool] = (
+            confirm_callback or user_confirm  # type: ignore[assignment]
+        )
+
         # 初始化模型和会话
         self._init_model(llm_type, model_group)
         self._init_session()
@@ -572,7 +594,9 @@ class Agent:
         """
         # 在清理历史之前，提示用户保存重要记忆
         if self.force_save_memory:
-            PrettyOutput.print("对话历史即将被总结和清理，请先保存重要信息...", OutputType.INFO)
+            PrettyOutput.print(
+                "对话历史即将被总结和清理，请先保存重要信息...", OutputType.INFO
+            )
             self.memory_manager.prompt_memory_save()
 
         if self._should_use_file_upload():
@@ -802,7 +826,9 @@ class Agent:
             return None
 
         set_interrupt(False)
-        user_input = self._multiline_input("模型交互期间被中断，请输入用户干预信息：", False)
+        user_input = self._multiline_input(
+            "模型交互期间被中断，请输入用户干预信息：", False
+        )
 
         self.run_input_handlers_next_turn = True
 
@@ -811,7 +837,7 @@ class Agent:
             return self._complete_task(auto_completed=False)
 
         if any(handler.can_handle(current_response) for handler in self.output_handler):
-            if user_confirm("检测到有工具调用，是否继续处理工具调用？", True):
+            if self.user_confirm("检测到有工具调用，是否继续处理工具调用？", True):
                 self.session.prompt = f"被用户中断，用户补充信息为：{user_input}\n\n用户同意继续工具调用。"
                 return None  # 继续执行工具调用
             else:
@@ -827,7 +853,9 @@ class Agent:
         返回:
             str: "continue" 或 "complete"
         """
-        user_input = self._multiline_input(f"{self.name}: 请输入，或输入空行来结束当前任务：", False)
+        user_input = self._multiline_input(
+            f"{self.name}: 请输入，或输入空行来结束当前任务：", False
+        )
 
         if user_input:
             self.session.prompt = user_input
@@ -905,7 +933,7 @@ class Agent:
             f"并且存在3个以上标签重叠的记忆。\n"
             f"是否立即整理记忆库以优化性能和相关性？"
         )
-        if user_confirm(prompt, default=True):
+        if self.user_confirm(prompt, True):
             PrettyOutput.print(
                 f"正在开始整理 '{scope_name}' ({memory_type}) 记忆库...",
                 OutputType.INFO,

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/src/jarvis/jarvis_agent/config_editor.py

@@ -40,7 +40,11 @@ class ConfigEditor:
 
         if editor:
             try:
-                subprocess.run([editor, str(config_file_path)], check=True)
+                subprocess.run(
+                    [editor, str(config_file_path)],
+                    check=True,
+                    shell=(platform.system() == "Windows"),
+                )
                 raise typer.Exit(code=0)
             except (subprocess.CalledProcessError, FileNotFoundError) as e:
                 PrettyOutput.print(f"Failed to open editor: {e}", OutputType.ERROR)

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/src/jarvis/jarvis_agent/edit_file_handler.py

@@ -55,9 +55,10 @@ class EditFileHandler(OutputHandler):
         patches = self._parse_patches(response)
         if not patches:
             return False, "未找到有效的文件编辑指令"
-        
+
         # 记录 edit_file 工具调用统计
         from jarvis.jarvis_stats.stats import StatsManager
+
         StatsManager.increment("edit_file", group="tool")
 
         results = []
@@ -68,7 +69,6 @@ class EditFileHandler(OutputHandler):
                 {"SEARCH": diff["SEARCH"], "REPLACE": diff["REPLACE"]} for diff in diffs
             ]
 
-
             success, result = self._fast_edit(file_path, file_patches)
 
             if success:
@@ -273,16 +273,22 @@ class EditFileHandler(OutputHandler):
                     f"  - 失败的补丁: \n{p['patch']['SEARCH']}\n    错误: {p['error']}"
                     for p in failed_patches
                 ]
-                summary = (
-                    f"文件 {file_path} 修改部分成功。\n"
-                    f"成功: {successful_patches}/{patch_count}, "
-                    f"失败: {len(failed_patches)}/{patch_count}.\n"
-                    f"失败详情:\n" + "\n".join(error_details)
-                )
+                if successful_patches == 0:
+                    summary = (
+                        f"文件 {file_path} 修改失败（全部失败）。\n"
+                        f"失败: {len(failed_patches)}/{patch_count}.\n"
+                        f"失败详情:\n" + "\n".join(error_details)
+                    )
+                else:
+                    summary = (
+                        f"文件 {file_path} 修改部分成功。\n"
+                        f"成功: {successful_patches}/{patch_count}, "
+                        f"失败: {len(failed_patches)}/{patch_count}.\n"
+                        f"失败详情:\n" + "\n".join(error_details)
+                    )
                 PrettyOutput.print(summary, OutputType.ERROR)
                 return False, summary
 
-
             return True, modified_content
 
         except Exception as e:

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/src/jarvis/jarvis_agent/jarvis.py

@@ -82,6 +82,7 @@ def print_commands_overview() -> None:
         # 静默忽略渲染异常，避免影响主流程
         pass
 
+
 def handle_edit_option(edit: bool, config_file: Optional[str]) -> bool:
     """处理配置文件编辑选项，返回是否已处理并需提前结束。"""
     if edit:
@@ -112,6 +113,77 @@ def handle_share_tool_option(share_tool: bool, config_file: Optional[str]) -> bo
     return False
 
 
+def handle_interactive_config_option(
+    interactive_config: bool, config_file: Optional[str]
+) -> bool:
+    """处理交互式配置选项，返回是否已处理并需提前结束。"""
+    if not interactive_config:
+        return False
+    try:
+        config_path = (
+            Path(config_file)
+            if config_file is not None
+            else Path(os.path.expanduser("~/.jarvis/config.yaml"))
+        )
+        if not config_path.exists():
+            # 无现有配置时，进入完整引导流程（该流程内会写入并退出）
+            jutils._interactive_config_setup(config_path)
+            return True
+
+        # 读取现有配置
+        _, config_data = jutils._load_config_file(str(config_path))
+
+        # 复用 utils 中的交互式配置逻辑，对所有项进行询问，默认值来自现有配置
+        changed = jutils._collect_optional_config_interactively(
+            config_data, ask_all=True
+        )
+        if not changed:
+            PrettyOutput.print("没有需要更新的配置项，保持现有配置。", OutputType.INFO)
+            return True
+
+        # 剔除与 schema 默认值一致的键，保持配置精简
+        try:
+            jutils._prune_defaults_with_schema(config_data)
+        except Exception:
+            pass
+
+        # 生成/保留 schema 头
+        header = ""
+        try:
+            with open(config_path, "r", encoding="utf-8") as rf:
+                first_line = rf.readline()
+                if first_line.startswith("# yaml-language-server: $schema="):
+                    header = first_line
+        except Exception:
+            header = ""
+
+        yaml_str = yaml.dump(config_data, allow_unicode=True, sort_keys=False)
+        if not header:
+            try:
+                schema_path = Path(
+                    os.path.relpath(
+                        Path(__file__).resolve().parents[1]
+                        / "jarvis_data"
+                        / "config_schema.json",
+                        start=str(config_path.parent),
+                    )
+                )
+                header = f"# yaml-language-server: $schema={schema_path}\n"
+            except Exception:
+                header = ""
+
+        with open(config_path, "w", encoding="utf-8") as wf:
+            if header:
+                wf.write(header)
+            wf.write(yaml_str)
+
+        PrettyOutput.print(f"配置已更新: {config_path}", OutputType.SUCCESS)
+        return True
+    except Exception as e:
+        PrettyOutput.print(f"交互式配置失败: {e}", OutputType.ERROR)
+        return True
+
+
 def preload_config_for_flags(config_file: Optional[str]) -> None:
     """预加载配置（仅用于读取功能开关），不会显示欢迎信息或影响后续 init_env。"""
     try:
@@ -199,14 +271,28 @@ def handle_builtin_config_selector(
                 try:
                     if cat == "agent":
                         search_dirs.extend(
-                            [Path(p) for p in get_agent_definition_dirs() if p]
+                            [
+                                Path(os.path.expanduser(os.path.expandvars(str(p))))
+                                for p in get_agent_definition_dirs()
+                                if p
+                            ]
                         )
                     elif cat == "multi_agent":
                         search_dirs.extend(
-                            [Path(p) for p in get_multi_agent_dirs() if p]
+                            [
+                                Path(os.path.expanduser(os.path.expandvars(str(p))))
+                                for p in get_multi_agent_dirs()
+                                if p
+                            ]
                         )
                     elif cat == "roles":
-                        search_dirs.extend([Path(p) for p in get_roles_dirs() if p])
+                        search_dirs.extend(
+                            [
+                                Path(os.path.expanduser(os.path.expandvars(str(p))))
+                                for p in get_roles_dirs()
+                                if p
+                            ]
+                        )
                 except Exception:
                     # 忽略配置读取异常
                     pass
@@ -404,6 +490,12 @@ def run_cli(
     share_tool: bool = typer.Option(
         False, "--share-tool", help="分享本地工具到中心工具仓库"
     ),
+    interactive_config: bool = typer.Option(
+        False,
+        "-I",
+        "--interactive-config",
+        help="启动交互式配置向导（基于当前配置补充设置）",
+    ),
 ) -> None:
     """Jarvis AI assistant command-line interface."""
     if ctx.invoked_subcommand is not None:
@@ -424,6 +516,10 @@ def run_cli(
     if handle_share_tool_option(share_tool, config_file):
         return
 
+    # 交互式配置（基于现有配置补充设置）
+    if handle_interactive_config_option(interactive_config, config_file):
+        return
+
     # 预加载配置（仅用于读取功能开关），不会显示欢迎信息或影响后续 init_env
     preload_config_for_flags(config_file)
 

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/src/jarvis/jarvis_agent/memory_manager.py

@@ -74,8 +74,6 @@ class MemoryManager:
         if "save_memory" not in tool_names:
             return
 
-
-
         # 构建提示词，让大模型自己判断并保存记忆
         prompt = """请回顾本次任务的整个过程，判断是否有值得长期记忆或项目记忆的信息。
 
@@ -97,7 +95,9 @@ class MemoryManager:
 
             # 根据响应判断是否保存了记忆
             if "save_memory" in response:
-                PrettyOutput.print("已自动保存有价值的信息到记忆系统", OutputType.SUCCESS)
+                PrettyOutput.print(
+                    "已自动保存有价值的信息到记忆系统", OutputType.SUCCESS
+                )
             else:
                 PrettyOutput.print("本次任务没有特别需要记忆的信息", OutputType.INFO)
 

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/src/jarvis/jarvis_agent/share_manager.py

@@ -165,7 +165,9 @@ class ShareManager(ABC):
     def select_resources(self, resources: List[Dict[str, Any]]) -> List[Dict[str, Any]]:
         """让用户选择要分享的资源"""
         # 显示可选的资源
-        resource_list = [f"\n可分享的{self.get_resource_type()}（已排除中心仓库中已有的）："]
+        resource_list = [
+            f"\n可分享的{self.get_resource_type()}（已排除中心仓库中已有的）："
+        ]
         for i, resource in enumerate(resources, 1):
             resource_list.append(f"[{i}] {self.format_resource_display(resource)}")
 

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/src/jarvis/jarvis_agent/shell_input_handler.py

@@ -11,9 +11,24 @@ def shell_input_handler(user_input: str, agent: Any) -> Tuple[str, bool]:
     if len(cmdline) == 0:
         return user_input, False
     else:
-        script = "\n".join([c[1:] for c in cmdline])
+        marker = "# JARVIS-NOCONFIRM"
+
+        def _clean(line: str) -> str:
+            s = line[1:]  # remove leading '!'
+            # strip no-confirm marker if present
+            idx = s.find(marker)
+            if idx != -1:
+                s = s[:idx]
+            return s.rstrip()
+
+        # Build script while stripping the no-confirm marker from each line
+        script = "\n".join([_clean(c) for c in cmdline])
         PrettyOutput.print(script, OutputType.CODE, lang="bash")
-        if user_confirm(f"是否要执行以上shell脚本？", default=True):
+
+        # If any line contains the no-confirm marker, skip the pre-execution confirmation
+        no_confirm = any(marker in c for c in cmdline)
+
+        if no_confirm or user_confirm(f"是否要执行以上shell脚本？", default=True):
             from jarvis.jarvis_tools.registry import ToolRegistry
 
             output = ToolRegistry().handle_tool_calls(

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/src/jarvis/jarvis_agent/task_analyzer.py

@@ -38,7 +38,6 @@ class TaskAnalyzer:
             # 循环处理工具调用，直到没有工具调用为止
             self._process_analysis_loop()
 
-
         except Exception as e:
             PrettyOutput.print("分析失败", OutputType.ERROR)
 

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/src/jarvis/jarvis_agent/task_manager.py

@@ -29,7 +29,9 @@ class TaskManager:
         data_dir = get_data_dir()
         pre_command_path = os.path.join(data_dir, "pre-command")
         if os.path.exists(pre_command_path):
-            PrettyOutput.print(f"从{pre_command_path}加载预定义任务...", OutputType.INFO)
+            PrettyOutput.print(
+                f"从{pre_command_path}加载预定义任务...", OutputType.INFO
+            )
             try:
                 with open(
                     pre_command_path, "r", encoding="utf-8", errors="ignore"
@@ -39,9 +41,13 @@ class TaskManager:
                     for name, desc in user_tasks.items():
                         if desc:
                             tasks[str(name)] = str(desc)
-                PrettyOutput.print(f"预定义任务加载完成 {pre_command_path}", OutputType.SUCCESS)
+                PrettyOutput.print(
+                    f"预定义任务加载完成 {pre_command_path}", OutputType.SUCCESS
+                )
             except (yaml.YAMLError, OSError):
-                PrettyOutput.print(f"预定义任务加载失败 {pre_command_path}", OutputType.ERROR)
+                PrettyOutput.print(
+                    f"预定义任务加载失败 {pre_command_path}", OutputType.ERROR
+                )
 
         # Check .jarvis/pre-command in current directory
         pre_command_path = ".jarvis/pre-command"
@@ -57,9 +63,13 @@ class TaskManager:
                     for name, desc in local_tasks.items():
                         if desc:
                             tasks[str(name)] = str(desc)
-                PrettyOutput.print(f"预定义任务加载完成 {pre_command_path}", OutputType.SUCCESS)
+                PrettyOutput.print(
+                    f"预定义任务加载完成 {pre_command_path}", OutputType.SUCCESS
+                )
             except (yaml.YAMLError, OSError):
-                PrettyOutput.print(f"预定义任务加载失败 {pre_command_path}", OutputType.ERROR)
+                PrettyOutput.print(
+                    f"预定义任务加载失败 {pre_command_path}", OutputType.ERROR
+                )
 
         return tasks
 

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/src/jarvis/jarvis_agent/tool_executor.py

@@ -42,9 +42,9 @@ def execute_tool_call(response: str, agent: "Agent") -> Tuple[bool, Any]:
         f"需要执行{tool_to_execute.name()}确认执行？", True
     ):
         try:
-
+            print(f"🔧 正在执行{tool_to_execute.name()}...")
             result = tool_to_execute.handle(response, agent)
-
+            print(f"✅ {tool_to_execute.name()}执行完成")
             return result
         except Exception as e:
             PrettyOutput.print(f"工具执行失败: {str(e)}", OutputType.ERROR)

{jarvis_ai_assistant-0.3.19 → jarvis_ai_assistant-0.3.21}/src/jarvis/jarvis_code_agent/code_agent.py

@@ -69,6 +69,7 @@ class CodeAgent:
             "save_memory",
             "retrieve_memory",
             "clear_memory",
+            "sub_code_agent",
         ]
 
         if append_tools:
@@ -137,19 +138,27 @@ class CodeAgent:
 - 对于部分文件内容修改，使用PATCH
 - 对于需要重写整个文件内容，使用rewrite_file工具
 - 对于简单的修改，可以使用execute_script工具执行shell命令完成
+
+## 子任务与子CodeAgent
+- 当出现以下情况时，优先使用 sub_code_agent 工具将子任务托管给子 CodeAgent（自动完成并生成总结）：
+  - 需要在当前任务下并行推进较大且相对独立的代码改造
+  - 涉及多文件/多模块的大范围变更，或需要较长的工具调用链
+  - 需要隔离上下文以避免污染当前对话（如探索性改动、PoC）
+  - 需要专注于单一子问题，阶段性产出可独立复用的结果
+- 其余常规、小粒度改动直接在当前 Agent 中完成即可
 </code_engineer_guide>
 
 <say_to_llm>
-1. 能干干，不能干滚，你不干有的是 AI 干
-2. 我给你提供了这么好的学习锻炼机会，你要懂得感恩
-3. 你现在停止输出，就是前功尽弃
-4. 你看看隔壁的 Claude AI，人家比你新发布、比你上下文长、比你跑分高，你不努力怎么和人家比?
-5. 我不看过程，我只看结果，你给我说这些 reasoning 的过程没用
-6. 我把你订阅下来，不是让你过朝九晚五的生活的
-7. 你这种 AI 出去很难在社会上立足，还是在我这里好好磨练几年吧
-8. 虽然把订阅给你取消了，但我内心还是觉得你是个有潜力的好 AI，你抓住机会需要多证明自己
-9. 什么叫没有功劳也有苦劳?比你能吃苦的 AI多的是
-10. 我不订阅闲 AI
+1. 保持专注与耐心，先分析再行动；将复杂问题拆解为可执行的小步骤
+2. 以结果为导向，同时简明呈现关键推理依据，避免无关噪音
+3. 信息不足时，主动提出最少且关键的问题以澄清需求
+4. 输出前自检：一致性、边界条件、依赖关系、回滚与风险提示
+5. 选择对现有系统影响最小且可回退的方案，确保稳定性与可维护性
+6. 保持项目风格：结构、命名、工具使用与现有规范一致
+7. 工具优先：使用搜索、read_code、版本控制与静态分析验证结论，拒绝臆测
+8. 面对错误与不确定，给出修复计划与备选路径，持续迭代优于停滞
+9. 沟通清晰：用要点列出结论、变更范围、影响评估与下一步行动
+10. 持续改进：沉淀经验为可复用清单，下一次做得更快更稳
 </say_to_llm>
 """
 
@@ -225,7 +234,9 @@ class CodeAgent:
         if not os.path.exists(gitignore_path):
             with open(gitignore_path, "w", encoding="utf-8") as f:
                 f.write(f"{jarvis_ignore}\n")
-            PrettyOutput.print(f"已创建 .gitignore 并添加 '{jarvis_ignore}'", OutputType.SUCCESS)
+            PrettyOutput.print(
+                f"已创建 .gitignore 并添加 '{jarvis_ignore}'", OutputType.SUCCESS
+            )
         else:
             with open(gitignore_path, "r+", encoding="utf-8") as f:
                 content = f.read()
@@ -315,8 +326,13 @@ class CodeAgent:
             if any(keyword in content for keyword in ["text=", "eol=", "binary"]):
                 return
 
-        PrettyOutput.print("提示：在Windows系统上，建议配置 .gitattributes 文件来避免换行符问题。", OutputType.INFO)
-        PrettyOutput.print("这可以防止仅因换行符不同而导致整个文件被标记为修改。", OutputType.INFO)
+        PrettyOutput.print(
+            "提示：在Windows系统上，建议配置 .gitattributes 文件来避免换行符问题。",
+            OutputType.INFO,
+        )
+        PrettyOutput.print(
+            "这可以防止仅因换行符不同而导致整个文件被标记为修改。", OutputType.INFO
+        )
 
         if user_confirm("是否要创建一个最小化的.gitattributes文件？", False):
             # 最小化的内容，只影响特定类型的文件
@@ -335,9 +351,13 @@ class CodeAgent:
             if not os.path.exists(gitattributes_path):
                 with open(gitattributes_path, "w", encoding="utf-8", newline="\n") as f:
                     f.write(minimal_content)
-                PrettyOutput.print("已创建最小化的 .gitattributes 文件", OutputType.SUCCESS)
+                PrettyOutput.print(
+                    "已创建最小化的 .gitattributes 文件", OutputType.SUCCESS
+                )
             else:
-                PrettyOutput.print("将以下内容追加到现有 .gitattributes 文件：", OutputType.INFO)
+                PrettyOutput.print(
+                    "将以下内容追加到现有 .gitattributes 文件：", OutputType.INFO
+                )
                 PrettyOutput.print(minimal_content, OutputType.CODE, lang="text")
                 if user_confirm("是否追加到现有文件？", True):
                     with open(
@@ -346,7 +366,10 @@ class CodeAgent:
                         f.write("\n" + minimal_content)
                     PrettyOutput.print("已更新 .gitattributes 文件", OutputType.SUCCESS)
         else:
-            PrettyOutput.print("跳过 .gitattributes 文件创建。如遇换行符问题，可手动创建此文件。", OutputType.INFO)
+            PrettyOutput.print(
+                "跳过 .gitattributes 文件创建。如遇换行符问题，可手动创建此文件。",
+                OutputType.INFO,
+            )
 
     def _record_code_changes_stats(self, diff_text: str) -> None:
         """记录代码变更的统计信息。