auto-coder 3.0.69__tar.gz → 3.0.70__tar.gz

{auto_coder-3.0.69/src/auto_coder.egg-info → auto_coder-3.0.70}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: auto-coder
-Version: 3.0.69
+Version: 3.0.70
 Summary: AutoCoder: AutoCoder
 Author: allwefantasy
 Author-email: allwefantasy <allwefantasy@gmail.com>
@@ -231,6 +231,9 @@ Requires-Dist: patch-ng
 Requires-Dist: firecrawl
 Requires-Dist: aiohttp
 Requires-Dist: httpx[socks]
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-python
 
 <p align="center">
   <picture>    

{auto_coder-3.0.69 → auto_coder-3.0.70}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "auto-coder"
-version = "3.0.69"
+version = "3.0.70"
 description = "AutoCoder: AutoCoder"
 authors = [
     {name = "allwefantasy", email = "allwefantasy@gmail.com"}

{auto_coder-3.0.69 → auto_coder-3.0.70/src/auto_coder.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: auto-coder
-Version: 3.0.69
+Version: 3.0.70
 Summary: AutoCoder: AutoCoder
 Author: allwefantasy
 Author-email: allwefantasy <allwefantasy@gmail.com>
@@ -231,6 +231,9 @@ Requires-Dist: patch-ng
 Requires-Dist: firecrawl
 Requires-Dist: aiohttp
 Requires-Dist: httpx[socks]
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-python
 
 <p align="center">
   <picture>    

{auto_coder-3.0.69 → auto_coder-3.0.70}/src/auto_coder.egg-info/SOURCES.txt

@@ -1165,6 +1165,7 @@ tests/test_sdk_core_bridge.py
 tests/test_sdk_exceptions.py
 tests/test_sdk_formatters.py
 tests/test_sdk_io_utils.py
+tests/test_sdk_lazy_imports.py
 tests/test_sdk_model_options.py
 tests/test_sdk_package_exports.py
 tests/test_sdk_response_models.py

{auto_coder-3.0.69 → auto_coder-3.0.70}/src/autocoder/auto_coder_runner.py

@@ -10,6 +10,7 @@ import io
 import time
 import byzerllm
 import subprocess
+import threading
 from contextlib import contextmanager
 from typing import List, Dict, Any, Optional
 from autocoder.common import AutoCoderArgs
@@ -106,9 +107,6 @@ if platform.system() == "Windows":
 # Initialize memory and project root
 project_root = os.getcwd()
 
-# Initialize memory manager with project root
-_memory_manager = get_memory_manager(project_root)
-
 # Wrapper functions to sync global memory variable
 
 
@@ -131,8 +129,11 @@ def get_memory():
     return load_memory()
 
 
-# Compatibility: base_persist_dir is now managed by memory manager
-base_persist_dir = _memory_manager.base_persist_dir
+# Compatibility path. Do not instantiate MemoryManager during module import:
+# loading memory here can block unrelated commands such as `--help` on its file lock.
+base_persist_dir = os.path.join(
+    project_root, ".auto-coder", "plugins", "chat-auto-coder"
+)
 
 defaut_exclude_dirs = [
     ".git",
@@ -415,14 +416,33 @@ get_all_dir_names_in_project = scanner_funcs["get_all_dir_names_in_project"]
 find_files_in_project = scanner_funcs["find_files_in_project"]
 get_symbol_list = scanner_funcs["get_symbol_list"]
 
-# 直接创建 CommandCompleterV2，它内部会使用 project_scanner
-completer = CommandCompleterV2(
-    commands,
-    memory_model=CCMemoryModel(
-        get_memory_func=get_memory, save_memory_func=save_memory
-    ),
-    project_root=project_root,
-)
+_completer_lock = threading.RLock()
+
+
+def _get_completer() -> CommandCompleterV2:
+    """Create the shared completer only when an interactive caller needs it."""
+    existing = globals().get("completer")
+    if existing is not None:
+        return existing
+
+    with _completer_lock:
+        existing = globals().get("completer")
+        if existing is None:
+            existing = CommandCompleterV2(
+                commands,
+                memory_model=CCMemoryModel(
+                    get_memory_func=get_memory, save_memory_func=save_memory
+                ),
+                project_root=project_root,
+            )
+            globals()["completer"] = existing
+        return existing
+
+
+def __getattr__(name: str):
+    if name == "completer":
+        return _get_completer()
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
 
 
 def revert():
@@ -955,7 +975,7 @@ def rules(query: str):
     # 只有当结果不为空时才打印，避免重复输出
     if result and result.strip():
         print(result)
-    completer.refresh_files()
+    _get_completer().refresh_files()
 
 
 @byzerllm.prompt()
@@ -1081,7 +1101,7 @@ def exclude_dirs(dir_names: List[str]):
         exclude_files(",".join([f"regex://.*/{d}/*." for d in new_dirs]))
     else:
         print("All specified dirs are already in the exclude list.")
-    completer.refresh_files()
+    _get_completer().refresh_files()
 
 
 def exclude_files(query: str):
@@ -1108,7 +1128,7 @@ def exclude_files(query: str):
     if "/drop" in query:
         query = query.replace("/drop", "", 1).strip()
         removed_patterns = memory_manager.remove_exclude_files([query.strip()])
-        completer.refresh_files()
+        _get_completer().refresh_files()
         result_manager.add_result(
             content=f"Dropped exclude files: {removed_patterns}",
             meta={"action": "exclude_files", "input": {"query": query}},
@@ -1152,7 +1172,7 @@ def exclude_files(query: str):
 def index_build():
     args = get_final_config()
     auto_coder_main(["index"], runtime_args=args)
-    completer.refresh_files()
+    _get_completer().refresh_files()
 
 
 def get_final_config() -> AutoCoderArgs:
@@ -1605,7 +1625,7 @@ def auto_command(query: str, extra_args: Dict[str, Any] = {}):
                 )
                 runner.run(AgenticEditRequest(user_input=task_query))
 
-        completer.refresh_files()
+        _get_completer().refresh_files()
         return conversation_config.conversation_id
 
     args = build_runtime_args(query)
@@ -1675,7 +1695,7 @@ def auto_command(query: str, extra_args: Dict[str, Any] = {}):
             padding=(1, 2),
         )
     )
-    completer.refresh_files()
+    _get_completer().refresh_files()
     return None
 
 

{auto_coder-3.0.69 → auto_coder-3.0.70}/src/autocoder/auto_coder_terminal_v3.py

@@ -20,8 +20,8 @@ from pathlib import Path
 # V3 is a full-screen interactive TUI. Keep startup and typing responsive in
 # large repositories by defaulting to Codex-style async file completion and
 # avoiding full recursive watchers/scans on the UI hot path. These defaults
-# must be set before importing auto_coder_runner because it creates the shared
-# completer at import time.
+# must be set before importing the shared completer from auto_coder_runner,
+# because that first access creates it.
 os.environ.setdefault("AUTOCODER_FILE_COMPLETION_MODE", "async")
 os.environ.setdefault("AUTOCODER_PROJECT_SCANNER_INITIAL_SCAN", "async")
 os.environ.setdefault("AUTOCODER_FILE_MONITOR_MODE", "selective")

{auto_coder-3.0.69 → auto_coder-3.0.70}/src/autocoder/command_skills.py

@@ -4,7 +4,6 @@ from __future__ import annotations
 
 from textwrap import dedent
 
-
 _HELP_EPILOGS = {
     "auto-coder.run": """
 Agent usage guide:
@@ -54,6 +53,7 @@ Common scenarios:
   Inside the TUI: /bg parser (parallel title/summary/conversations match)
   Inside the TUI: /bg /time 12:09 (today's nearest session creation time)
   Inside the TUI: /bg /clear (drop idle/terminal; preserve running/recovering)
+  Inside the TUI: type a plain prompt while running (interrupt and continue)
   Inside the TUI: /push Run the tests after this task
   Inside the TUI: /push /list
   Inside the TUI: /push /remove #1
@@ -237,6 +237,9 @@ Common scenarios:
   auto-coder.dream start --backend devin --model gpt-5.6-sol --concurrency 8
   auto-coder.dream status
   auto-coder.dream jobs
+  auto-coder.dream agenda run --wait
+  auto-coder.dream agenda list --status pending_review
+  auto-coder.dream agenda approve OPPORTUNITY_ID
   auto-coder.dream scheduled-agent create --template email-service-router --project /path/to/project
   auto-coder.dream scheduled-agent list
   auto-coder.dream scheduled-agent edit sat_ID --prompt-file /path/to/prompt.md --every-minutes 10
@@ -249,6 +252,14 @@ Common scenarios:
   auto-coder.dream agent-service run svc_ID --note '{"source":"gmail","event_id":"message-id","summary":"New reply"}'
   auto-coder.dream agent-service run svc_ID --note-file /path/to/email-event.json
 
+Proactive worklist lifecycle:
+  agenda run queues the research agent that reconciles pending_review candidates.
+  Use focus add to save Recent Focus notes for the next run, list/show to inspect
+  candidates, edit to change goal/project/backend/model, approve to queue a
+  run_agent action, adopt to endorse without Dream execution, and dismiss to
+  reject. Failed cards are retried with the same approve command. Prefer
+  DreamClient for in-process integrations.
+
 Scheduled Agent lifecycle:
   scheduled-agent create accepts inline prompt text, --prompt-file, or the
   built-in email-service-router template. The template polls Gmail through
@@ -311,6 +322,8 @@ Common scenarios:
   auto-coder.tools prompt
 
 Safety:
+  Discovery is static and side-effect-free. dirs, list, info, and prompt never
+  execute discovered tools or probe help, -h, or --help.
   Never read .key files directly. Use auto-coder.tools run or the agent
   execute_external_tool tool so sensitive values are injected and masked.
 
@@ -971,13 +984,18 @@ time. Equal-distance matches keep the lower global `#N`.
 continuity-`recovering` (`idle`, `done`, `cancelled`, or `error`) in one
 operation to free background slots. It preserves both resumable states.
 
-`/push <prompt>` appends a follow-up to the active conversation's private FIFO
-queue. If that conversation is idle, its oldest queued prompt starts
-immediately; otherwise one prompt is popped after each task reaches a terminal
-state, including completion, cancellation, or error. Switching with `/bg` does
-not move the queue: background conversations continue draining their own
-queues. `/push /list` shows only prompts still waiting for the active
-conversation. `/push /remove #N` removes a waiting prompt and
+While a conversation is running, submitting plain text steers that conversation:
+the native Auto-Coder backend injects it at a safe turn boundary, while external
+CLI backends interrupt the current process and resume the same bound
+conversation with the new input. Plain input never enters the `/push` FIFO.
+
+`/push <prompt>` deliberately does not interrupt. It appends a follow-up to the
+active conversation's private FIFO queue. If that conversation is idle, its
+oldest queued prompt starts immediately; otherwise one prompt is popped after
+each task reaches a terminal state, including completion, cancellation, or
+error. Switching with `/bg` does not move the queue: background conversations
+continue draining their own queues. `/push /list` shows only prompts still
+waiting for the active conversation. `/push /remove #N` removes a waiting prompt and
 `/push /edit #N "<prompt>"` replaces it in place; `#N` uses the current
 one-based `/list` position and never targets the prompt already running.
 Pending prompts are included in the TUI's project-scoped session state, and
@@ -1486,9 +1504,25 @@ An explicit `--concurrency` value takes precedence, followed by
 
 ## Proactive worklist
 
+The CLI and Python client mirror the Dream HTTP agenda APIs. Start the daemon
+first (`auto-coder.dream start`); most commands fall back to the local store only
+when the daemon is unreachable.
+
 ```bash
 auto-coder.dream agenda run --wait
+auto-coder.dream agenda run --project /path/to/project --backend cursor --model cursor-grok-4.5-high-fast --max-items 6
+auto-coder.dream agenda focus add "Shipping computer-index RAG query UX"
+auto-coder.dream agenda focus list --limit 20
 auto-coder.dream agenda list --status pending_review
+auto-coder.dream agenda list --project /path/to/project --run-id RUN_ID --limit 50
+auto-coder.dream agenda show OPPORTUNITY_ID
+auto-coder.dream agenda edit OPPORTUNITY_ID --proposed-goal "..." --project /path/to/project
+auto-coder.dream agenda edit OPPORTUNITY_ID --backend cursor --model composer-2.5-fast
+auto-coder.dream agenda edit OPPORTUNITY_ID --clear-backend --clear-model
+auto-coder.dream agenda approve OPPORTUNITY_ID
+auto-coder.dream agenda approve OPPORTUNITY_ID --backend cursor --model composer-2.5-fast
+auto-coder.dream agenda adopt OPPORTUNITY_ID
+auto-coder.dream agenda dismiss OPPORTUNITY_ID --reason "Not relevant now"
 ```
 
 Agenda conversations are interest signals, not a task queue. The read-only
@@ -1498,6 +1532,12 @@ when it records an interest theme, a new independent finding, its user value,
 and why it is not merely finishing or verifying a conversation request. The
 default run returns at most six review candidates and may safely return none.
 
+`agenda focus add` only appends Recent Focus history; it does not start an
+agent. Saved notes are considered on the next `agenda run`. `agenda edit` and
+optional `--backend`/`--model` on `approve` use the same CAS fingerprint +
+revision contract as the Dream UI. `adopt` records endorsement without creating
+a Dream job; `approve` (including failed-card retry) queues execution.
+
 After approval, a `run_agent` action becomes a durable `agenda_action` job.
 Dream runs the approved prompt as one tracked `auto-coder.run` Agent task,
 records its PID and conversation ID, and marks the worklist item complete when
@@ -1505,6 +1545,56 @@ that process exits successfully. It does not create, resume, or wait for a
 Goal. Every worklist action uses `run_agent`; multiple approved actions may use
 separate executor slots even when they target the same project.
 
+### Trigger the worklist from Python
+
+Agents on the same machine should use `DreamClient` so daemon discovery and
+authentication come from the existing local server configuration:
+
+```python
+from autocoder.dream.client import DreamClient
+from autocoder.dream.store import agenda_review_revision
+
+client = DreamClient()
+queued = client.run_agenda(max_items=6)
+job = client.wait_job(queued["job"]["id"], timeout=600)
+listing = client.list_agenda(status="pending_review", limit=50)
+opportunity_id = listing["opportunities"][0]["id"]
+opportunity = client.get_agenda_opportunity(opportunity_id)["opportunity"]
+client.append_agenda_focus("Shipping computer-index RAG query UX", source="api")
+client.edit_agenda_opportunity(
+    opportunity_id,
+    backend="cursor",
+    model="composer-2.5-fast",
+    expected_fingerprint=opportunity["fingerprint"],
+    expected_revision=agenda_review_revision(opportunity),
+)
+# Reload after edit: fingerprint/revision change.
+opportunity = client.get_agenda_opportunity(opportunity_id)["opportunity"]
+client.approve_agenda_opportunity(
+    opportunity_id,
+    approved_by="api",
+    expected_fingerprint=opportunity["fingerprint"],
+    expected_revision=agenda_review_revision(opportunity),
+)
+# Or endorse without execution:
+# client.adopt_agenda_opportunity(opportunity_id, ...)
+# client.dismiss_agenda_opportunity(opportunity_id, reason="...", ...)
+```
+
+Equivalent HTTP surface:
+
+```http
+POST /dream/agenda
+GET  /agenda?status=pending_review&limit=50
+GET  /agenda/{id}
+PATCH /agenda/{id}
+POST /agenda/{id}/approve
+POST /agenda/{id}/adopt
+POST /agenda/{id}/dismiss
+GET  /agenda/focus
+POST /agenda/focus
+```
+
 ## Scheduled Agent commands
 
 The CLI mirrors the existing `/scheduled-agents` API and always prints JSON.
@@ -1780,6 +1870,18 @@ Use `execute_external_tool` inside an agent run when the tool should be part of
 the agent's reasoning loop. Use `auto-coder.tools run` when a script or human
 operator wants the same `.key` injection and masking without starting a model.
 
+## Discovery safety
+
+Discovery is strictly static and side-effect-free. `dirs`, `list`, `info`, and
+`prompt` inspect directory entries, executable state, key-file markers, and
+leading source comments only. They never launch a discovered tool and never
+probe `help`, `-h`, or `--help`. Binary tools and scripts without recognized
+leading comments therefore receive a generic help description.
+
+Only an explicit `run <tool>` request executes the selected tool. Request help
+or an agent-facing skill explicitly through `run` when that execution is
+intended.
+
 ## Main syntax
 
 ```bash
@@ -1873,7 +1975,7 @@ discovery directory.
 |---------|-----|
 | `dirs` | Show configured discovery directories and which are active |
 | `list` | List discovered tool names and paths |
-| `info <tool>` | Show path, source directory, executable state, `.key` marker, and help |
+| `info <tool>` | Show path, source directory, executable state, `.key` marker, and statically extracted help |
 | `prompt` | Print the external-tools prompt block used inside agent context |
 | `run <tool>` | Execute a discovered tool using the existing external-tool runner |
 | `sessions path <backend> <session_id>` | Print an Auto-Coder canonical JSON or stable native JSONL path without reading or normalizing the transcript |

{auto_coder-3.0.69 → auto_coder-3.0.70}/src/autocoder/common/tools_manager/test_tools_manager.py

@@ -8,16 +8,16 @@ import os
 import tempfile
 import unittest
 from pathlib import Path
-from unittest.mock import patch, MagicMock
+from unittest.mock import patch
 
 import pytest
 
-from autocoder.common.tools_manager import ToolsManager, ToolCommand, ToolsLoadResult
+from autocoder.common.tools_manager import ToolsManager
 from autocoder.common.tools_manager.utils import (
-    is_tool_command_file,
+    _extract_help_from_file_comments,
     extract_tool_help,
     get_project_name,
-    _extract_help_from_file_comments,
+    is_tool_command_file,
 )
 
 
@@ -148,7 +148,7 @@ echo "deploying..."
         published_tool = self.tools_dir / "grow_tool"
 
         source_tool.write_text(
-            "#!/bin/sh\nif [ \"$1\" = \"--help\" ]; then echo 'grow tool v1'; fi\n",
+            "#!/bin/sh\n# 描述: grow tool v1\nexit 0\n",
             encoding="utf-8",
         )
         published_tool.write_text(
@@ -164,7 +164,7 @@ echo "deploying..."
         self.assertIn("grow tool v1", result_v1.tools[0].help_text)
 
         source_tool.write_text(
-            "#!/bin/sh\nif [ \"$1\" = \"--help\" ]; then echo 'grow tool v2'; fi\n",
+            "#!/bin/sh\n# 描述: grow tool v2\nexit 0\n",
             encoding="utf-8",
         )
         published_tool.write_text(
@@ -178,6 +178,25 @@ echo "deploying..."
         self.assertEqual([tool.name for tool in result_v2.tools], ["grow_tool"])
         self.assertIn("grow tool v2", result_v2.tools[0].help_text)
 
+    def test_load_tools_never_executes_discovered_commands(self):
+        """工具发现只能静态读取，不能启动被发现的可执行文件"""
+        marker_path = Path(self.temp_dir) / "tool-was-executed"
+        self.create_test_tool(
+            "side_effect_tool",
+            f"""#!/bin/sh
+# 描述: 扫描安全测试工具
+printf invoked > "{marker_path}"
+""",
+        )
+
+        manager = ToolsManager(tools_dirs=[str(self.tools_dir)])
+        result = manager.load_tools(force_reload=True)
+
+        self.assertTrue(result.success)
+        self.assertEqual([tool.name for tool in result.tools], ["side_effect_tool"])
+        self.assertIn("扫描安全测试工具", result.tools[0].help_text)
+        self.assertFalse(marker_path.exists())
+
     def test_deduplicate_tools(self):
         """测试工具去重"""
         # 创建两个目录，都有同名工具
@@ -349,40 +368,19 @@ echo "deploying..."
             name = get_project_name()
             self.assertEqual(name, "my_project")
 
-    @patch("subprocess.run")
-    def test_extract_tool_help_with_help_command(self, mock_run):
-        """测试通过help命令提取帮助信息"""
-        # 模拟成功的help命令输出
-        mock_result = MagicMock()
-        mock_result.returncode = 0
-        mock_result.stdout = (
-            "工具使用说明：\n  tool help - 显示帮助\n  tool run - 运行工具"
-        )
-        mock_result.stderr = ""
-        mock_run.return_value = mock_result
-
-        file_path = self.create_temp_file(
-            "tool.py", "#!/usr/bin/env python3", executable=True
-        )
-        help_text = extract_tool_help(str(file_path))
-
-        self.assertIn("工具使用说明", help_text)
-        self.assertIn("tool help", help_text)
-
-    @patch("subprocess.run")
-    def test_extract_tool_help_fallback_to_comments(self, mock_run):
-        """测试当help命令失败时回退到注释提取"""
-        # 模拟help命令失败
-        mock_run.side_effect = Exception("Command failed")
-
-        content = """#!/usr/bin/env python3
+    def test_extract_tool_help_uses_comments_without_execution(self):
+        """帮助提取只读取注释，不执行工具"""
+        marker_path = Path(self.temp_dir) / "help-tool-was-executed"
+        content = f"""#!/bin/sh
 # 用法: tool.py [选项]
 # 这是一个测试工具
+printf invoked > "{marker_path}"
 """
-        file_path = self.create_temp_file("tool.py", content, executable=True)
+        file_path = self.create_temp_file("tool.sh", content, executable=True)
         help_text = extract_tool_help(str(file_path))
 
         self.assertIn("用法: tool.py [选项]", help_text)
+        self.assertFalse(marker_path.exists())
 
 
 if __name__ == "__main__":

{auto_coder-3.0.69 → auto_coder-3.0.70}/src/autocoder/common/tools_manager/utils.py

@@ -5,37 +5,9 @@ Tools Manager Utility Functions
 """
 
 import os
-import locale
-import subprocess
 from pathlib import Path
-from typing import Optional, List
-from loguru import logger
-
-
-def _safe_decode_output(data: object) -> str:
-    """
-    Safely decode subprocess output to string.
 
-    - Prefer UTF-8 when possible.
-    - Fallback to system preferred encoding.
-    - Never raise UnicodeDecodeError.
-    """
-    if data is None:
-        return ""
-    if isinstance(data, str):
-        return data
-    if isinstance(data, memoryview):
-        data = data.tobytes()
-    if not isinstance(data, (bytes, bytearray)):
-        return str(data)
-
-    preferred = locale.getpreferredencoding(False) or "utf-8"
-    for enc in ("utf-8", preferred):
-        try:
-            return bytes(data).decode(enc)
-        except UnicodeDecodeError:
-            continue
-    return bytes(data).decode(preferred, errors="replace")
+from loguru import logger
 
 
 def is_tool_command_file(file_path: str) -> bool:
@@ -77,7 +49,11 @@ def is_tool_command_file(file_path: str) -> bool:
 
 def extract_tool_help(file_path: str) -> str:
     """
-    提取工具命令的帮助信息
+    从工具文件中静态提取帮助信息。
+
+    工具发现必须是无副作用的：这里绝不执行工具文件，也不会尝试 ``help``、
+    ``-h`` 或 ``--help``。二进制文件或没有可识别注释的脚本只返回默认描述；
+    需要完整帮助时由调用方显式执行目标工具。
 
     Args:
         file_path: 工具命令文件路径
@@ -86,53 +62,12 @@ def extract_tool_help(file_path: str) -> str:
         str: 帮助信息，如果获取失败返回默认信息
     """
     try:
-        # 尝试命令行帮助
-        help_text = _try_command_line_help(file_path)
-        if help_text:
-            return help_text
-            
-        # 回退到文件注释
         return _extract_help_from_file_comments(file_path)
-        
     except Exception as e:
         logger.debug(f"帮助信息提取失败 {file_path}: {e}")
         return f"工具命令: {Path(file_path).name}"
 
 
-def _try_command_line_help(file_path: str) -> Optional[str]:
-    """
-    尝试通过命令行获取帮助信息
-    
-    Args:
-        file_path: 工具文件路径
-        
-    Returns:
-        Optional[str]: 帮助信息，如果获取失败返回None
-    """
-    help_commands = [
-        [file_path, 'help'],
-        [file_path, '-h'], 
-        [file_path, '--help']
-    ]
-    
-    for cmd in help_commands:
-        try:
-            result = subprocess.run(
-                cmd, 
-                capture_output=True, 
-                text=False,  # Avoid Windows locale decode crashes (gbk/cp936 strict)
-                timeout=5, 
-                cwd=Path(file_path).parent
-            )
-            stdout = _safe_decode_output(result.stdout).strip()
-            stderr = _safe_decode_output(result.stderr).strip()
-            if result.returncode == 0 and (stdout or stderr):
-                return stdout or stderr
-        except Exception:
-            continue
-    return None
-
-
 def _extract_help_from_file_comments(file_path: str) -> str:
     """
     从文件注释中提取帮助信息
@@ -161,7 +96,7 @@ def _extract_help_from_file_comments(file_path: str) -> str:
 
         comment_char = comment_patterns.get(path.suffix.lower(), '#')
 
-        with open(file_path, 'r', encoding='utf-8') as f:
+        with open(file_path, encoding='utf-8') as f:
             lines = f.readlines()
 
         help_lines = []