sycommon-python-lib 0.2.1a51__tar.gz → 0.2.1a52__tar.gz

{sycommon_python_lib-0.2.1a51 → sycommon_python_lib-0.2.1a52}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.1a51
+Version: 0.2.1a52
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{sycommon_python_lib-0.2.1a51 → sycommon_python_lib-0.2.1a52}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sycommon-python-lib"
-version = "0.2.1a51"
+version = "0.2.1a52"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.11"

{sycommon_python_lib-0.2.1a51 → sycommon_python_lib-0.2.1a52}/src/sycli/agents/factory.py

@@ -1,4 +1,4 @@
-"""Agent factory - builds all agents for sycli."""
+"""Agent 工厂——构建 sycli 的所有 agent。"""
 
 from __future__ import annotations
 
@@ -10,24 +10,12 @@ from deepagents.backends.local_shell import LocalShellBackend
 from deepagents.middleware.memory import MemoryMiddleware
 from langchain_core.language_models import BaseChatModel
 
-from sycli.agents.prompts import (
-    ANALYST_PROMPT,
-    ARCHITECT_PROMPT,
-    CODER_PROMPT,
-    CRITIC_PROMPT,
-    DATA_ANALYST_PROMPT,
-    ORCHESTRATOR_PROMPT,
-    PROMPT_ENGINEER_PROMPT,
-    RESEARCHER_PROMPT,
-    RUNTIME_OBSERVER_PROMPT,
-    SERVICE_MANAGER_PROMPT,
-)
 from sycli.models.config_models import SkillSettings, SycliConfig
 
-# Builtin skills directory (shipped with sycli package)
+# 内置技能目录（随 sycli 包发布）
 _BUILTIN_SKILLS_DIR = Path(__file__).parent.parent / "skills" / "builtin"
 
-# Mapping: agent name -> list of builtin skill directory names
+# 映射：agent 名称 -> 内置技能目录名称列表
 _SKILL_AGENT_MAP: dict[str, list[str]] = {
     "coder": ["test-driven-development", "systematic-debugging"],
     "analyst": ["systematic-debugging"],
@@ -38,14 +26,14 @@ _SKILL_AGENT_MAP: dict[str, list[str]] = {
 def _get_skills_for_agent(
     agent_name: str, config_skills: SkillSettings
 ) -> list[str] | None:
-    """Return skill source paths for a given agent, filtered by enabled config.
+    """返回指定 agent 的技能源路径，根据启用的配置进行过滤。
 
-    Returns None (no skills key) if no skills apply to this agent.
+    如果没有技能适用于此 agent，则返回 None（不设置 skills 键）。
     """
     skill_names = _SKILL_AGENT_MAP.get(agent_name, [])
     if not skill_names:
         return None
-    # Filter by config.enabled (empty list = all disabled; only include enabled ones)
+    # 根据 config.enabled 过滤（空列表 = 全部禁用；仅包含已启用的）
     if config_skills.enabled is not None and len(config_skills.enabled) >= 0:
         if not config_skills.enabled:
             return None
@@ -57,7 +45,7 @@ def _get_skills_for_agent(
 
 
 def _inject_project_root(prompt: str, project_root: str) -> str:
-    """Replace __PROJECT_ROOT__ placeholder with actual project root path."""
+    """将 __PROJECT_ROOT__ 占位符替换为实际的项目根目录路径。"""
     return prompt.replace("__PROJECT_ROOT__", project_root)
 
 
@@ -66,13 +54,13 @@ def _memory_middleware(
     project_name: str,
     agent_role: str,
 ) -> MemoryMiddleware:
-    """Create MemoryMiddleware with per-agent source paths.
+    """创建带有按 agent 源路径的 MemoryMiddleware。
 
-    Sources loaded in order (concatenated):
-    1. hot/context.md          - Layer 0+1: working memory
-    2. warm/agents/{role}.md   - Layer 2: agent-specific compressed
-    3. warm/strategies.md      - Layer 2: shared strategies
-    4. warm/anti_patterns.md   - Layer 2: shared anti-patterns
+    按顺序加载的源（拼接）：
+    1. hot/context.md          - 第 0+1 层：工作记忆
+    2. warm/agents/{role}.md   - 第 2 层：agent 特定压缩
+    3. warm/strategies.md      - 第 2 层：共享策略
+    4. warm/anti_patterns.md   - 第 2 层：共享反模式
     """
     return MemoryMiddleware(
         backend=backend,
@@ -85,6 +73,30 @@ def _memory_middleware(
     )
 
 
+def _get_prompt(
+    builtin_attr: str,
+    harness: Any | None = None,
+    agent_name: str = "",
+    project_root: str = "",
+) -> str:
+    """从 harness（基于文件）获取提示词，或回退到内置默认值。
+
+    对任一来源应用 __PROJECT_ROOT__ 注入。
+    """
+    prompt = ""
+    if harness is not None:
+        prompt = harness.get_prompt(agent_name)
+    if not prompt:
+        prompt = getattr(
+            __import__("sycli.agents.prompts", fromlist=[builtin_attr]),
+            builtin_attr,
+            "",
+        )
+    if project_root:
+        prompt = _inject_project_root(prompt, project_root)
+    return prompt
+
+
 def build_subagents(
     config: SycliConfig,
     llm: BaseChatModel,
@@ -92,24 +104,26 @@ def build_subagents(
     project_name: str,
     mode: str = "optimize",
     project_root: str | None = None,
+    harness: Any | None = None,
 ) -> list[SubAgent]:
-    """Build SubAgent specs for all agents based on mode.
+    """根据模式构建所有 agent 的 SubAgent 规格。
 
     Args:
-        config: sycli configuration.
-        llm: LLM instance shared by all agents.
-        backend: LocalShellBackend shared by all agents.
-        project_name: Project name for memory paths.
-        mode: "optimize" or "create".
-        project_root: Absolute project root path to inject into prompts.
+        config: sycli 配置。
+        llm: 所有 agent 共享的 LLM 实例。
+        backend: 所有 agent 共享的 LocalShellBackend。
+        project_name: 用于记忆路径的项目名称。
+        mode: "optimize" 或 "create"。
+        project_root: 要注入提示词的绝对项目根目录路径。
+        harness: 可选的 HarnessPromptManager，用于基于文件的提示词。
 
     Returns:
-        List of SubAgent specs to pass to the orchestrator.
+        要传递给编排器的 SubAgent 规格列表。
     """
     agents: list[SubAgent] = []
     root = project_root or str(backend.cwd)
 
-    # --- Core agents (always available) ---
+    # --- 核心 agent（始终可用） ---
 
     agents.append({
         "name": "researcher",
@@ -117,7 +131,7 @@ def build_subagents(
             "Explores the codebase to understand structure, find relevant files, "
             "analyze dependencies and patterns. Use FIRST before coding."
         ),
-        "system_prompt": _inject_project_root(RESEARCHER_PROMPT, root),
+        "system_prompt": _get_prompt("RESEARCHER_PROMPT", harness, "researcher", root),
         "model": llm,
         "middleware": [_memory_middleware(backend, project_name, "researcher")],
     })
@@ -129,7 +143,7 @@ def build_subagents(
             "The ONLY agent with write/edit capabilities. "
             "Auto-fixes compilation errors before reporting."
         ),
-        "system_prompt": _inject_project_root(CODER_PROMPT, root),
+        "system_prompt": _get_prompt("CODER_PROMPT", harness, "coder", root),
         "model": llm,
         "middleware": [_memory_middleware(backend, project_name, "coder")],
         "skills": _get_skills_for_agent("coder", config.skills),
@@ -142,13 +156,13 @@ def build_subagents(
             "Read + execute access, no write. "
             "Produces a structured evaluation report."
         ),
-        "system_prompt": _inject_project_root(CRITIC_PROMPT, root),
+        "system_prompt": _get_prompt("CRITIC_PROMPT", harness, "critic", root),
         "model": llm,
         "middleware": [_memory_middleware(backend, project_name, "critic")],
         "skills": _get_skills_for_agent("critic", config.skills),
     })
 
-    # --- Deep analysis agent (always available) ---
+    # --- 深度分析 agent（始终可用） ---
 
     agents.append({
         "name": "analyst",
@@ -157,13 +171,13 @@ def build_subagents(
             "analyzes data flow and root causes. Read-only. "
             "Use after researcher to provide deeper context for the coder."
         ),
-        "system_prompt": _inject_project_root(ANALYST_PROMPT, root),
+        "system_prompt": _get_prompt("ANALYST_PROMPT", harness, "analyst", root),
         "model": llm,
         "middleware": [_memory_middleware(backend, project_name, "analyst")],
         "skills": _get_skills_for_agent("analyst", config.skills),
     })
 
-    # --- Service manager agent (always available) ---
+    # --- 服务管理器 agent（始终可用） ---
 
     agents.append({
         "name": "service_manager",
@@ -172,7 +186,7 @@ def build_subagents(
             "fresh, health-checks. Read + execute, no write. "
             "Use after coder to restart the service before API evaluation."
         ),
-        "system_prompt": _inject_project_root(SERVICE_MANAGER_PROMPT, root),
+        "system_prompt": _get_prompt("SERVICE_MANAGER_PROMPT", harness, "service_manager", root),
         "model": llm,
         "middleware": [_memory_middleware(backend, project_name, "service_manager")],
     })
@@ -184,7 +198,7 @@ def build_subagents(
             "Read + execute access, no write. "
             "Produces a runtime validation report."
         ),
-        "system_prompt": _inject_project_root(RUNTIME_OBSERVER_PROMPT, root),
+        "system_prompt": _get_prompt("RUNTIME_OBSERVER_PROMPT", harness, "runtime_observer", root),
         "model": llm,
         "middleware": [_memory_middleware(backend, project_name, "runtime_observer")],
     })
@@ -196,12 +210,12 @@ def build_subagents(
             "Read-only. Only called when a round scores below threshold. "
             "Produces actionable optimization suggestions."
         ),
-        "system_prompt": PROMPT_ENGINEER_PROMPT,
+        "system_prompt": _get_prompt("PROMPT_ENGINEER_PROMPT", harness, "prompt_engineer"),
         "model": llm,
         "middleware": [_memory_middleware(backend, project_name, "prompt_engineer")],
     })
 
-    # --- CREATE mode only ---
+    # --- 仅 CREATE 模式 ---
 
     if mode == "create":
         agents.append({
@@ -211,7 +225,7 @@ def build_subagents(
                 "CREATE mode only. Read-only. "
                 "Produces a complete architecture blueprint."
             ),
-            "system_prompt": _inject_project_root(ARCHITECT_PROMPT, root),
+            "system_prompt": _get_prompt("ARCHITECT_PROMPT", harness, "architect", root),
             "model": llm,
             "middleware": [_memory_middleware(backend, project_name, "architect")],
         })
@@ -223,7 +237,7 @@ def build_subagents(
                 "CREATE mode only. Read + execute. "
                 "Produces a data analysis report with seed data."
             ),
-            "system_prompt": _inject_project_root(DATA_ANALYST_PROMPT, root),
+            "system_prompt": _get_prompt("DATA_ANALYST_PROMPT", harness, "data_analyst", root),
             "model": llm,
             "middleware": [_memory_middleware(backend, project_name, "data_analyst")],
         })

{sycommon_python_lib-0.2.1a51 → sycommon_python_lib-0.2.1a52}/src/sycli/core/__init__.py

@@ -1,4 +1,4 @@
-"""Core __init__.py - re-exports for backward compatibility."""
+"""核心模块 __init__.py - 为向后兼容性重新导出。"""
 
 from sycli.core.backend import create_backend
 from sycli.core.display import Colors, error, header, info, success, warning

{sycommon_python_lib-0.2.1a51 → sycommon_python_lib-0.2.1a52}/src/sycli/core/backend.py

@@ -1,4 +1,4 @@
-"""LocalShellBackend factory for sycli agents."""
+"""sycli agent 的 LocalShellBackend 工厂。"""
 
 from __future__ import annotations
 
@@ -14,18 +14,18 @@ def create_backend(
     max_output_bytes: int = 100_000,
     inherit_env: bool = True,
 ) -> LocalShellBackend:
-    """Create a LocalShellBackend for sycli agents.
+    """为 sycli agent 创建 LocalShellBackend。
 
-    All agents share a single backend instance operating on the project root.
+    所有 agent 共享一个在项目根目录上运行的后端实例。
 
     Args:
-        project_root: The project directory.
-        timeout: Default shell command timeout in seconds.
-        max_output_bytes: Max captured output before truncation.
-        inherit_env: Whether to inherit system environment variables.
+        project_root: 项目目录。
+        timeout: 默认 shell 命令超时（秒）。
+        max_output_bytes: 截断前的最大捕获输出字节数。
+        inherit_env: 是否继承系统环境变量。
 
     Returns:
-        A configured LocalShellBackend.
+        已配置的 LocalShellBackend。
     """
     return LocalShellBackend(
         root_dir=str(project_root),

sycommon_python_lib-0.2.1a52/src/sycli/core/config.py

@@ -0,0 +1,4 @@
+"""sycli.json 配置加载器。"""
+
+# 注意：load_config() 已被移除——调用方现在直接使用
+# SycliConfig.load(config_path)（参见 run_cmd.py、create_cmd.py 等）。

{sycommon_python_lib-0.2.1a51 → sycommon_python_lib-0.2.1a52}/src/sycli/core/display.py

@@ -1,4 +1,4 @@
-"""Terminal display utilities with color support."""
+"""带颜色支持的终端显示工具。"""
 
 import sys
 import threading
@@ -38,8 +38,8 @@ def header(msg: str) -> None:
 
 
 def round_header(round_num: int, max_rounds: int, score: float | None = None) -> None:
-    score_str = f"  |  score: {score:.3f}" if score is not None else ""
-    print(f"\n{Colors.BOLD}{'─' * 10} Round {round_num}/{max_rounds}{score_str} {'─' * 10}{Colors.RESET}")
+    score_str = f"  |  得分: {score:.3f}" if score is not None else ""
+    print(f"\n{Colors.BOLD}{'─' * 10} 第 {round_num}/{max_rounds} 轮{score_str} {'─' * 10}{Colors.RESET}")
 
 
 def agent_result(agent_name: str, reward: float, summary: str) -> None:
@@ -57,27 +57,27 @@ def final_report(
     strategy: str,
 ) -> None:
     print(f"\n{Colors.BOLD}{Colors.GREEN}{'═' * 50}{Colors.RESET}")
-    print(f"{Colors.BOLD}{Colors.GREEN}  Optimization Complete{Colors.RESET}")
+    print(f"{Colors.BOLD}{Colors.GREEN}  优化完成{Colors.RESET}")
     print(f"{Colors.BOLD}{Colors.GREEN}{'═' * 50}{Colors.RESET}")
-    print(f"  Total rounds:   {total_rounds}")
-    print(f"  Score change:   {initial_score:.3f} → {final_score:.3f} ({final_score - initial_score:+.3f})")
-    print(f"  Best round:     {best_round} (score: {best_score:.3f})")
-    print(f"  Best strategy:  {strategy}")
+    print(f"  总轮次:       {total_rounds}")
+    print(f"  得分变化:     {initial_score:.3f} → {final_score:.3f} ({final_score - initial_score:+.3f})")
+    print(f"  最佳轮次:     {best_round} (得分: {best_score:.3f})")
+    print(f"  最佳策略:     {strategy}")
     print(f"{Colors.BOLD}{Colors.GREEN}{'═' * 50}{Colors.RESET}\n")
 
 
 def agent_thinking(agent_name: str) -> None:
-    """Print a thinking indicator for an agent."""
-    print(f"{Colors.DIM}  ⋯ {agent_name} is thinking...{Colors.RESET}", end="", flush=True)
+    """打印 agent 的思考指示器。"""
+    print(f"{Colors.DIM}  ⋯ {agent_name} 思考中...{Colors.RESET}", end="", flush=True)
 
 
 def agent_done(agent_name: str) -> None:
-    """Clear the thinking indicator and print done."""
-    print(f"\r{Colors.GREEN}  ✔ {agent_name} done.        {Colors.RESET}")
+    """清除思考指示器并打印完成。"""
+    print(f"\r{Colors.GREEN}  ✔ {agent_name} 完成。        {Colors.RESET}")
 
 
 def user_prompt() -> str:
-    """Display the interactive prompt and get user input."""
+    """显示交互式提示并获取用户输入。"""
     print(f"\n{Colors.MAGENTA}{Colors.BOLD}sycli > {Colors.RESET}", end="", flush=True)
     try:
         return input().strip()
@@ -86,11 +86,11 @@ def user_prompt() -> str:
 
 
 def chat_banner() -> None:
-    """Print the chat mode banner."""
-    print(f"\n{Colors.BOLD}{Colors.CYAN}── Interactive Mode ──{Colors.RESET}")
-    print(f"  Commands: {Colors.BOLD}continue{Colors.RESET} | {Colors.BOLD}stop{Colors.RESET} | {Colors.BOLD}hint <text>{Colors.RESET} | {Colors.BOLD}skip{Colors.RESET} | {Colors.BOLD}status{Colors.RESET}")
-    print(f"  Press Enter to continue to next round\n")
+    """打印聊天模式横幅。"""
+    print(f"\n{Colors.BOLD}{Colors.CYAN}── 交互模式 ──{Colors.RESET}")
+    print(f"  命令: {Colors.BOLD}continue{Colors.RESET} | {Colors.BOLD}stop{Colors.RESET} | {Colors.BOLD}hint <文本>{Colors.RESET} | {Colors.BOLD}skip{Colors.RESET} | {Colors.BOLD}status{Colors.RESET}")
+    print(f"  按 Enter 继续下一轮\n")
 
 
-# Lock for thread-safe printing
+# 线程安全打印锁
 _print_lock = threading.Lock()

{sycommon_python_lib-0.2.1a51 → sycommon_python_lib-0.2.1a52}/src/sycli/core/git_integration.py

@@ -1,4 +1,4 @@
-"""Git integration for sycli checkpoints and rollback."""
+"""sycli 的 Git 检查点与回滚集成。"""
 
 from __future__ import annotations
 
@@ -9,17 +9,17 @@ from sycli.core.display import error, info, success, warning
 
 
 def git_checkpoint(project_root: Path, message: str) -> bool:
-    """Stage all changes and create a git commit as checkpoint.
+    """暂存所有更改并创建 git 提交作为检查点。
 
     Args:
-        project_root: Project root directory.
-        message: Commit message.
+        project_root: 项目根目录。
+        message: 提交消息。
 
     Returns:
-        True if checkpoint was created, False otherwise.
+        如果成功创建检查点返回 True，否则返回 False。
     """
     try:
-        # Check if inside a git repo
+        # 检查是否在 git 仓库内
         result = subprocess.run(
             ["git", "rev-parse", "--is-inside-work-tree"],
             cwd=str(project_root),
@@ -30,7 +30,7 @@ def git_checkpoint(project_root: Path, message: str) -> bool:
         if result.returncode != 0:
             return False
 
-        # Stage all changes (respect .gitignore)
+        # 暂存所有更改（遵循 .gitignore）
         subprocess.run(
             ["git", "add", "-A"],
             cwd=str(project_root),
@@ -38,7 +38,7 @@ def git_checkpoint(project_root: Path, message: str) -> bool:
             timeout=10,
         )
 
-        # Check if there are changes to commit
+        # 检查是否有可提交的更改
         result = subprocess.run(
             ["git", "diff", "--cached", "--quiet"],
             cwd=str(project_root),
@@ -46,10 +46,10 @@ def git_checkpoint(project_root: Path, message: str) -> bool:
             timeout=10,
         )
         if result.returncode == 0:
-            # No changes to commit
+            # 没有可提交的更改
             return False
 
-        # Commit
+        # 提交
         result = subprocess.run(
             ["git", "commit", "-m", message],
             cwd=str(project_root),
@@ -64,20 +64,20 @@ def git_checkpoint(project_root: Path, message: str) -> bool:
 
 
 def git_rollback(project_root: Path, round_num: int) -> bool:
-    """Rollback to a previous round's checkpoint.
+    """回滚到之前轮次的检查点。
 
-    Uses `git revert` to undo all commits AFTER the target round,
-    creating a new commit on top. This preserves history.
+    使用 `git revert` 撤销目标轮次之后的所有提交，
+    在当前基础上创建新的提交。此操作会保留历史记录。
 
     Args:
-        project_root: Project root directory.
-        round_num: Target round number to rollback to.
+        project_root: 项目根目录。
+        round_num: 要回滚到的目标轮次编号。
 
     Returns:
-        True if rollback succeeded, False otherwise.
+        如果回滚成功返回 True，否则返回 False。
     """
     try:
-        # Find all round commits in order
+        # 按顺序查找所有轮次提交
         result = subprocess.run(
             ["git", "log", "--oneline", "--all"],
             cwd=str(project_root),
@@ -87,7 +87,7 @@ def git_rollback(project_root: Path, round_num: int) -> bool:
         )
         lines = result.stdout.strip().split("\n")
 
-        # Build a mapping of round -> commit hash
+        # 建立轮次 -> 提交哈希的映射
         round_commits: dict[int, str] = {}
         for line in lines:
             import re
@@ -97,22 +97,22 @@ def git_rollback(project_root: Path, round_num: int) -> bool:
 
         target_commit = round_commits.get(round_num)
         if not target_commit:
-            error(f"No git checkpoint found for round {round_num}")
+            error(f"未找到第 {round_num} 轮的 git 检查点")
             return False
 
-        info(f"Found checkpoint: {target_commit} for round {round_num}")
+        info(f"找到检查点: {target_commit}（第 {round_num} 轮）")
 
-        # Find commits to revert: all round commits after the target
+        # 查找需要回退的提交：目标轮次之后的所有轮次提交
         commits_to_revert = []
         for rn in sorted(round_commits.keys()):
             if rn > round_num:
                 commits_to_revert.append(round_commits[rn])
 
         if not commits_to_revert:
-            info(f"Round {round_num} is already the latest checkpoint, nothing to revert.")
+            info(f"第 {round_num} 轮已是最新检查点，无需回退。")
             return True
 
-        # Revert commits in reverse order (newest first) to avoid conflicts
+        # 按逆序回退提交（最新的先）以避免冲突
         for commit_hash in reversed(commits_to_revert):
             result = subprocess.run(
                 ["git", "revert", "--no-commit", commit_hash],
@@ -122,17 +122,17 @@ def git_rollback(project_root: Path, round_num: int) -> bool:
                 timeout=15,
             )
             if result.returncode != 0:
-                # Abort the revert on conflict
+                # 冲突时中止回退
                 subprocess.run(
                     ["git", "revert", "--abort"],
                     cwd=str(project_root),
                     capture_output=True,
                     timeout=5,
                 )
-                error(f"Revert of {commit_hash} failed (conflict): {result.stderr}")
+                error(f"回退 {commit_hash} 失败（冲突）: {result.stderr}")
                 return False
 
-        # Commit the accumulated reverts
+        # 提交累积的回退
         result = subprocess.run(
             ["git", "commit", "-m", f"sycli: rollback to round {round_num}"],
             cwd=str(project_root),
@@ -142,19 +142,19 @@ def git_rollback(project_root: Path, round_num: int) -> bool:
         )
 
         if result.returncode == 0:
-            success(f"Rolled back to round {round_num} (reverted {len(commits_to_revert)} commits)")
+            success(f"已回退到第 {round_num} 轮（回退了 {len(commits_to_revert)} 个提交）")
             return True
         else:
-            error(f"Rollback commit failed: {result.stderr}")
+            error(f"回退提交失败: {result.stderr}")
             return False
 
     except (subprocess.TimeoutExpired, FileNotFoundError) as e:
-        error(f"Git rollback failed: {e}")
+        error(f"Git 回退失败: {e}")
         return False
 
 
 def git_is_repo(project_root: Path) -> bool:
-    """Check if the directory is inside a git repository."""
+    """检查目录是否在 git 仓库内。"""
     try:
         result = subprocess.run(
             ["git", "rev-parse", "--is-inside-work-tree"],
@@ -169,7 +169,7 @@ def git_is_repo(project_root: Path) -> bool:
 
 
 def git_current_branch(project_root: Path) -> str | None:
-    """Get the current git branch name."""
+    """获取当前 git 分支名称。"""
     try:
         result = subprocess.run(
             ["git", "rev-parse", "--abbrev-ref", "HEAD"],
@@ -184,7 +184,7 @@ def git_current_branch(project_root: Path) -> str | None:
 
 
 def git_has_changes(project_root: Path) -> bool:
-    """Check if there are uncommitted changes."""
+    """检查是否有未提交的更改。"""
     try:
         result = subprocess.run(
             ["git", "status", "--porcelain"],

{sycommon_python_lib-0.2.1a51 → sycommon_python_lib-0.2.1a52}/src/sycli/core/llm.py

@@ -1,6 +1,6 @@
-"""Independent LLM initialization for sycli.
+"""sycli 的独立 LLM 初始化。
 
-Uses langchain's init_chat_model directly, bypassing sycommon.config.Config.
+直接使用 langchain 的 init_chat_model，绕过 sycommon.config.Config。
 """
 
 from __future__ import annotations
@@ -18,24 +18,24 @@ def create_llm(
     temperature: float | None = None,
     thinking: bool | None = None,
 ) -> BaseChatModel:
-    """Create LLM instance from sycli.json settings.
+    """从 sycli.json 配置创建 LLM 实例。
 
     Args:
-        settings: LLM configuration from sycli.json.
-        streaming: Whether to enable streaming.
-        temperature: Override temperature if provided.
-        thinking: Enable thinking/reasoning mode.
+        settings: 来自 sycli.json 的 LLM 配置。
+        streaming: 是否启用流式输出。
+        temperature: 如果提供，覆盖默认温度。
+        thinking: 启用思考/推理模式。
 
     Returns:
-        A BaseChatModel instance.
+        BaseChatModel 实例。
     """
     base_url = settings.resolved_base_url()
     api_key = settings.resolved_api_key()
 
     if not base_url:
         raise ValueError(
-            f"LLM base_url is empty. Set {settings.base_url_env} env var "
-            f"or set base_url in sycli.json"
+            f"LLM base_url 为空。请设置 {settings.base_url_env} 环境变量 "
+            f"或在 sycli.json 中设置 base_url"
         )
 
     effective_temp = temperature if temperature is not None else settings.temperature

{sycommon_python_lib-0.2.1a51 → sycommon_python_lib-0.2.1a52}/src/sycli/core/state.py

@@ -1,6 +1,6 @@
-"""Shared RL state persistence — single source of truth for save/load.
+"""共享 RL 状态持久化——保存/加载的单一数据源。
 
-Used by both engine.py (OPTIMIZE) and create.py (CREATE).
+被 engine.py（OPTIMIZE）和 create.py（CREATE）共同使用。
 """
 
 from __future__ import annotations
@@ -11,17 +11,17 @@ from pathlib import Path
 
 
 def save_state(sycli_dir: Path, state: dict) -> None:
-    """Save RL state to disk atomically."""
+    """原子性地将 RL 状态保存到磁盘。"""
     state_file = sycli_dir / "rl_state.json"
     state_file.parent.mkdir(parents=True, exist_ok=True)
-    # Write to temp file first, then rename for atomicity
+    # 先写入临时文件，然后重命名以确保原子性
     fd, tmp_path = tempfile.mkstemp(
         dir=str(state_file.parent), suffix=".tmp", prefix="rl_state_"
     )
     try:
         with open(fd, "w") as f:
             json.dump(state, f, indent=2, ensure_ascii=False)
-        # Atomic rename (POSIX)
+        # 原子重命名（POSIX）
         Path(tmp_path).replace(state_file)
     except Exception:
         Path(tmp_path).unlink(missing_ok=True)
@@ -29,7 +29,7 @@ def save_state(sycli_dir: Path, state: dict) -> None:
 
 
 def load_state(sycli_dir: Path) -> dict:
-    """Load RL state from disk."""
+    """从磁盘加载 RL 状态。"""
     state_file = sycli_dir / "rl_state.json"
     if state_file.exists():
         try:

sycommon_python_lib-0.2.1a52/src/sycli/memory/__init__.py

@@ -0,0 +1 @@
+"""sycli 内存管理包。"""