vibego 0.2.18__py3-none-any.whl → 0.2.19__py3-none-any.whl

bot.py

@@ -391,19 +391,45 @@ async def _send_with_retry(coro_factory, *, attempts: int = SEND_RETRY_ATTEMPTS)
 
 
 def _escape_markdown_v2(text: str) -> str:
-    """转义 MarkdownV2 特殊字符。
+    """转义 MarkdownV2 特殊字符，保护代码块内容。
 
     注意：
+    - 使用分段处理，保护代码块（```...``` 和 `...`）
     - Text().as_markdown() 会转义所有 MarkdownV2 特殊字符
     - 只移除纯英文单词之间的连字符转义（如 "pre-release"）
     - 保留数字、时间戳等其他情况的连字符转义（如 "2025-10-23"）
+    - 代码块内容不被转义，保持原样
     """
-    escaped = Text(text).as_markdown()
-    # 只移除纯英文字母之间的连字符转义（避免影响数字、时间戳等）
-    escaped = re.sub(r"(?<=[a-zA-Z])\\-(?=[a-zA-Z])", "-", escaped)
-    # 移除斜杠的转义（Telegram 不需要转义斜杠）
-    escaped = escaped.replace("\\/", "/")
-    return escaped
+
+    def _escape_segment(segment: str) -> str:
+        """转义单个文本段落（非代码块）"""
+        escaped = Text(segment).as_markdown()
+        # 只移除纯英文字母之间的连字符转义
+        escaped = re.sub(r"(?<=[a-zA-Z])\\-(?=[a-zA-Z])", "-", escaped)
+        # 移除斜杠的转义
+        escaped = escaped.replace("\\/", "/")
+        return escaped
+
+    # 分段处理：代码块保持原样，普通文本转义
+    pieces: list[str] = []
+    last_index = 0
+
+    for match in CODE_SEGMENT_RE.finditer(text):
+        # 处理代码块之前的普通文本
+        normal_part = text[last_index:match.start()]
+        if normal_part:
+            pieces.append(_escape_segment(normal_part))
+
+        # 代码块保持原样，不转义
+        pieces.append(match.group(0))
+        last_index = match.end()
+
+    # 处理最后一段普通文本
+    if last_index < len(text):
+        remaining = text[last_index:]
+        pieces.append(_escape_segment(remaining))
+
+    return "".join(pieces) if pieces else _escape_segment(text)
 
 
 LEGACY_DOUBLE_BOLD = re.compile(r"\*\*(.+?)\*\*", re.DOTALL)
@@ -440,6 +466,131 @@ def _normalize_legacy_markdown(text: str) -> str:
     return "".join(pieces)
 
 
+# MarkdownV2 转义字符模式（用于检测已转义文本）
+_ESCAPED_MARKDOWN_PATTERN = re.compile(
+    r"\\[_*\[\]()~`>#+=|{}.!:-]"  # 添加了冒号
+)
+
+# 已转义的代码块模式（转义的反引号）
+_ESCAPED_CODE_BLOCK_PATTERN = re.compile(
+    r"(\\\`\\\`\\\`.*?\\\`\\\`\\\`|\\\`[^\\\`]*?\\\`)",
+    re.DOTALL
+)
+
+
+def _is_already_escaped(text: str) -> bool:
+    """检测文本是否已经包含 MarkdownV2 转义字符。
+
+    通过统计转义字符的出现频率来判断：
+    - 如果转义字符数量 >= 文本长度的 3%，认为已被转义（降低阈值）
+    - 或者如果有 2 个以上的连续转义模式（如 \*\*），也认为已被转义
+    - 或者包含已转义的代码块标记
+    """
+    if not text:
+        return False
+
+    # 检查是否有已转义的代码块标记
+    if _ESCAPED_CODE_BLOCK_PATTERN.search(text):
+        return True
+
+    matches = _ESCAPED_MARKDOWN_PATTERN.findall(text)
+    if not matches:
+        return False
+
+    # 对于短文本，放宽检测条件
+    if len(text) < 20:
+        # 短文本只要有 2 个以上转义字符就认为已被转义
+        if len(matches) >= 2:
+            return True
+    else:
+        # 检查转义字符密度（降低到 3%）
+        escape_count = len(matches)
+        text_length = len(text)
+        density = escape_count / text_length
+
+        if density >= 0.03:  # 3% 以上认为已被转义
+            return True
+
+    # 检查是否有连续转义模式（如 \#\#\# 或 \*\*）
+    consecutive_pattern = re.compile(r"(?:\\[_*\[\]()~`>#+=|{}.!:-]){2,}")
+    if consecutive_pattern.search(text):
+        return True
+
+    return False
+
+
+def _unescape_markdown_v2(text: str) -> str:
+    """反转义 MarkdownV2 特殊字符。
+
+    将 \*, \_, \#, \[, \], \: 等转义字符还原为原始字符。
+    """
+    # 移除所有 MarkdownV2 转义的反斜杠
+    # 匹配模式：反斜杠 + 特殊字符（添加了冒号）
+    return re.sub(r"\\([_*\[\]()~`>#+=|{}.!:-])", r"\1", text)
+
+
+def _unescape_if_already_escaped(text: str) -> str:
+    """智能检测并清理预转义文本，特别保护代码块。
+
+    改进的分段处理策略：
+    1. 先识别已转义的代码块（\`\`\`...\`\`\` 和 \`...\`）
+    2. 对这些代码块先反转义边界反引号，变成正常代码块
+    3. 然后用正常的 CODE_SEGMENT_RE 识别代码块
+    4. 只对非代码块的普通文本进行反转义
+    5. 代码块内容保持转义状态（因为是代码本身）
+    6. 重新组合所有段落
+
+    Args:
+        text: 待处理的文本
+
+    Returns:
+        处理后的文本（如未检测到预转义，返回原文本）
+    """
+    if not text:
+        return text
+
+    # 快速检测：如果没有任何转义字符，直接返回
+    if not _is_already_escaped(text):
+        return text
+
+    # 第一步：处理已转义的代码块，将边界反引号反转义
+    # 这样后续可以用正常的 CODE_SEGMENT_RE 识别它们
+    processed = text
+
+    # 先标记所有已转义的代码块，用占位符替换
+    code_blocks: list[str] = []
+
+    def _preserve_code_block(match: re.Match[str]) -> str:
+        """保存代码块并返回占位符"""
+        block = match.group(0)
+        # 代码块边界的反引号需要反转义，但内容保持不变
+        # 例如：\`\`\`bash\npython -m vibego\_cli\`\`\`
+        #    -> ```bash\npython -m vibego\_cli```
+        if block.startswith(r"\`\`\`"):
+            # 多行代码块
+            unescaped_block = block.replace(r"\`", "`", 6)  # 只替换前后各3个反引号
+        else:
+            # 单行代码块
+            unescaped_block = block.replace(r"\`", "`", 2)  # 只替换前后各1个反引号
+
+        placeholder = f"__CODE_BLOCK_{len(code_blocks)}__"
+        code_blocks.append(unescaped_block)
+        return placeholder
+
+    processed = _ESCAPED_CODE_BLOCK_PATTERN.sub(_preserve_code_block, processed)
+
+    # 第二步：对非代码块部分进行反转义
+    if _is_already_escaped(processed):
+        processed = _unescape_markdown_v2(processed)
+
+    # 第三步：恢复代码块
+    for i, block in enumerate(code_blocks):
+        placeholder = f"__CODE_BLOCK_{i}__"
+        processed = processed.replace(placeholder, block)
+
+    return processed
+
+
 def _prepare_model_payload(text: str) -> str:
     if _IS_MARKDOWN_V2:
         return _escape_markdown_v2(text)
@@ -1994,11 +2145,12 @@ def _build_status_filter_row(current_status: Optional[str], limit: int) -> list[
 def _format_task_list_entry(task: TaskRecord) -> str:
     indent = "  " * max(task.depth, 0)
     title_raw = (task.title or "").strip()
-    # 修复：避免双重转义
+    # 修复：智能清理预转义文本
     if not title_raw:
         title = "-"
     elif _IS_MARKDOWN_V2:
-        title = title_raw
+        # 智能清理预转义文本（保护代码块）
+        title = _unescape_if_already_escaped(title_raw)
     else:
         title = _escape_markdown_text(title_raw)
     type_icon = TASK_TYPE_EMOJIS.get(task.task_type)
@@ -2048,11 +2200,13 @@ def _format_task_detail(
         *,
         notes: Sequence[TaskNoteRecord],
     ) -> str:
-    # 修复：仅在非 MarkdownV2 模式下手动转义，避免双重转义
-    # MarkdownV2 模式下由 _prepare_model_payload() 统一处理转义
+    # 修复：智能处理预转义文本
+    # - MarkdownV2 模式：先清理可能的预转义，再由 _prepare_model_payload() 统一处理
+    # - 其他模式：手动转义
     title_raw = (task.title or "").strip()
     if _IS_MARKDOWN_V2:
-        title_text = title_raw if title_raw else "-"
+        # 智能清理预转义文本（保护代码块）
+        title_text = _unescape_if_already_escaped(title_raw) if title_raw else "-"
     else:
         title_text = _escape_markdown_text(title_raw) if title_raw else "-"
 
@@ -2065,10 +2219,11 @@ def _format_task_detail(
         f"📂 类型：{_format_task_type(task.task_type)}",
     ]
 
-    # 修复：描述字段也避免双重转义
+    # 修复：描述字段智能清理预转义
     description_raw = task.description or "暂无"
     if _IS_MARKDOWN_V2:
-        description_text = description_raw
+        # 智能清理预转义文本（保护代码块）
+        description_text = _unescape_if_already_escaped(description_raw)
     else:
         description_text = _escape_markdown_text(description_raw)
 
@@ -2076,10 +2231,11 @@ def _format_task_detail(
     lines.append(f"📅 创建时间：{_format_local_time(task.created_at)}")
     lines.append(f"🔁 更新时间：{_format_local_time(task.updated_at)}")
 
-    # 修复：父任务ID字段也避免双重转义
+    # 修复：父任务ID字段智能清理预转义
     if task.parent_id:
         if _IS_MARKDOWN_V2:
-            parent_text = task.parent_id
+            # 智能清理预转义文本（保护代码块）
+            parent_text = _unescape_if_already_escaped(task.parent_id)
         else:
             parent_text = _escape_markdown_text(task.parent_id)
         lines.append(f"👪 父任务：{parent_text}")

master.py

@@ -54,6 +54,7 @@ from aiogram.fsm.storage.memory import MemoryStorage
 from logging_setup import create_logger
 from project_repository import ProjectRepository, ProjectRecord
 from tasks.fsm import ProjectDeleteStates
+from vibego_cli import __version__
 
 ROOT_DIR = Path(__file__).resolve().parent
 CONFIG_PATH = Path(os.environ.get("MASTER_PROJECTS_PATH", ROOT_DIR / "config/projects.json"))
@@ -1792,7 +1793,7 @@ async def cmd_start(message: Message) -> None:
         return
     manager.refresh_state()
     await message.answer(
-        "Master bot 已启动。\n"
+        f"Master bot 已启动（v{__version__}）。\n"
         f"已登记项目: {len(manager.configs)} 个。\n"
         "使用 /projects 查看状态，/run 或 /stop 控制 worker。",
         reply_markup=_build_master_main_keyboard(),

{vibego-0.2.18.dist-info → vibego-0.2.19.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vibego
-Version: 0.2.18
+Version: 0.2.19
 Summary: vibego CLI：用于初始化与管理 Telegram Master Bot 的工具
 Author: Hypha
 License-Expression: LicenseRef-Proprietary

{vibego-0.2.18.dist-info → vibego-0.2.19.dist-info}/RECORD

@@ -1,6 +1,6 @@
-bot.py,sha256=mX0fgXEbm7M5baUvX_Q--NWpwYWzF8Yge6wrp4MoS6U,264070
+bot.py,sha256=aK68QaITXzOoUStLqejg8L6Bd3LuAqNLOw6R3-7SfYw,269638
 logging_setup.py,sha256=gvxHi8mUwK3IhXJrsGNTDo-DR6ngkyav1X-tvlBF_IE,4613
-master.py,sha256=Qz2NTapUexVvpQz8Y_pVhKd-uXkqp3M6oclzfAzIuGs,106497
+master.py,sha256=qw6ZxItpSr6C5YzjVDOGm4jZpnGYLZndsJ-lmJrzGcM,106553
 project_repository.py,sha256=UcthtSGOJK0cTE5bQCneo3xkomRG-kyc1N1QVqxeHIs,17577
 scripts/__init__.py,sha256=LVrXUkvWKoc6Sb47X5G0gbIxu5aJ2ARW-qJ14vwi5vM,65
 scripts/bump_version.sh,sha256=a4uB8V8Y5LPsoqTCdzQKsEE8HhwpBmqRaQInG52LDig,4089
@@ -425,14 +425,14 @@ tasks/constants.py,sha256=tS1kZxBIUm3JJUMHm25XI-KHNUZl5NhbbuzjzL_rF-c,299
 tasks/fsm.py,sha256=rKXXLEieQQU4r2z_CZUvn1_70FXiZXBBugF40gpe_tQ,1476
 tasks/models.py,sha256=N_qqRBo9xMSV0vbn4k6bLBXT8C_dp_oTFUxvdx16ZQM,2459
 tasks/service.py,sha256=w_S_aWiVqRXzXEpimLDsuCCCX2lB5uDkff9aKThBw9c,41916
-vibego_cli/__init__.py,sha256=M8Oc6o3XOUKq9SL__MXA-SqxrkAPAXJ3RZSCBM_TZlw,311
+vibego_cli/__init__.py,sha256=PbHZ3j0Ku7MxszOczRhZnNfiggYU_AB2P91m7bMQqCw,311
 vibego_cli/__main__.py,sha256=qqTrYmRRLe4361fMzbI3-CqpZ7AhTofIHmfp4ykrrBY,158
 vibego_cli/config.py,sha256=33WSORCfUIxrDtgASPEbVqVLBVNHh-RSFLpNy7tfc0s,2992
 vibego_cli/deps.py,sha256=1nRXI7Dd-S1hYE8DligzK5fIluQWETRUj4_OKL0DikQ,1419
 vibego_cli/main.py,sha256=e2W5Pb9U9rfmF-jNX9uIA3222lhM0GgcvSdFTDBZd2s,12086
 vibego_cli/data/worker_requirements.txt,sha256=QSt30DSSSHtfucTFPpc7twk9kLS5rVLNTcvDiagxrZg,62
-vibego-0.2.18.dist-info/METADATA,sha256=EV6IIf-JRkYtbjZVBMN1e8RCHfX-0vGNmJICXQOcbEY,10475
-vibego-0.2.18.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-vibego-0.2.18.dist-info/entry_points.txt,sha256=Lsy_zm-dlyxt8-9DL9blBReIwU2k22c8-kifr46ND1M,48
-vibego-0.2.18.dist-info/top_level.txt,sha256=R56CT3nW5H5v3ce0l3QDN4-C4qxTrNWzRTwrxnkDX4U,69
-vibego-0.2.18.dist-info/RECORD,,
+vibego-0.2.19.dist-info/METADATA,sha256=EcNsx_kVnc0gZiqMdbpIHRDYcIFu09gERPQubTVW-mY,10475
+vibego-0.2.19.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+vibego-0.2.19.dist-info/entry_points.txt,sha256=Lsy_zm-dlyxt8-9DL9blBReIwU2k22c8-kifr46ND1M,48
+vibego-0.2.19.dist-info/top_level.txt,sha256=R56CT3nW5H5v3ce0l3QDN4-C4qxTrNWzRTwrxnkDX4U,69
+vibego-0.2.19.dist-info/RECORD,,

vibego_cli/__init__.py

@@ -7,6 +7,6 @@ from __future__ import annotations
 
 __all__ = ["main", "__version__"]
 
-__version__ = "0.2.18"
+__version__ = "0.2.19"
 
 from .main import main  # noqa: E402