sqlseed 0.1.16__tar.gz → 0.1.17__tar.gz

{sqlseed-0.1.16 → sqlseed-0.1.17}/CHANGELOG.md

@@ -7,6 +7,27 @@ All notable changes to this project will be documented in this file.
 Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [v0.1.17]
+
+### Added
+
+- `RichProgressBackend` now accepts `ascii_only` parameter: when `True`, uses `"line"` spinner (`|/-\`) and omits `BarColumn`, avoiding `UnicodeEncodeError` on GBK/Big5/CP936 console encodings
+- `_can_render_unicode()` cached helper probes whether stdout can encode Rich's Braille/block-element characters (U+280B, U+2588, U+2591)
+- `create_progress()` auto-falls back to `ascii_only=True` when `_can_render_unicode()` returns `False`, with a debug log message
+- `DataOrchestrator` adds SQL operation methods: `execute(sql, params)`, `query(sql, params)`, `fetch_one(sql, params)`, `fetch_all(sql, params)` for direct database interaction
+- `BaseSQLiteAdapter._execute(sql, params)` method for parameterized SQL execution
+- `DatabaseAdapter` protocol updated with `_execute` method signature
+
+### Changed
+
+- `RichProgressBackend` refresh rate set to 1 Hz (was default 10 Hz) to reduce terminal flicker
+- Test suite: `TestRichProgressBackend` and `TestRichProgressBackendAsciiOnly` merged via `pytest.mark.parametrize` to eliminate code duplication
+
+### Fixed
+
+- Windows compatibility: GBK/GB2312/Big5/CP936 encoded terminals no longer crash with `UnicodeEncodeError` when displaying Rich progress bars
+- `.gitignore`: removed `*汇总.md` pattern (no longer needed)
+
 ## [v0.1.16]
 
 ### Added

{sqlseed-0.1.16 → sqlseed-0.1.17}/CHANGELOG.zh-CN.md

@@ -7,6 +7,27 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)，
 本项目遵循[语义化版本](https://semver.org/spec/v2.0.0.html)。
 
+## [v0.1.17]
+
+### 新增
+
+- `RichProgressBackend` 新增 `ascii_only` 参数：启用时使用 `"line"` 旋转符（`|/-\`）并省略 `BarColumn`，避免 GBK/Big5/CP936 编码终端的 `UnicodeEncodeError`
+- `_can_render_unicode()` 缓存辅助函数，检测 stdout 是否能编码 Rich 的盲文/方块字符（U+280B, U+2588, U+2591）
+- `create_progress()` 在 `_can_render_unicode()` 返回 `False` 时自动回退到 `ascii_only=True`，并输出 debug 日志
+- `DataOrchestrator` 新增 SQL 操作方法：`execute(sql, params)`、`query(sql, params)`、`fetch_one(sql, params)`、`fetch_all(sql, params)` 用于直接数据库交互
+- `BaseSQLiteAdapter._execute(sql, params)` 参数化 SQL 执行方法
+- `DatabaseAdapter` 协议新增 `_execute` 方法签名
+
+### 变更
+
+- `RichProgressBackend` 刷新频率设为 1 Hz（原默认 10 Hz），减少终端闪烁
+- 测试套件：`TestRichProgressBackend` 和 `TestRichProgressBackendAsciiOnly` 通过 `pytest.mark.parametrize` 合并，消除代码重复
+
+### 修复
+
+- Windows 兼容性：GBK/GB2312/Big5/CP936 编码终端不再因 Rich 进度条的 Unicode 字符而崩溃
+- `.gitignore`：移除 `*汇总.md` 规则（不再需要）
+
 ## [v0.1.16]
 
 ### 新增

{sqlseed-0.1.16 → sqlseed-0.1.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlseed
-Version: 0.1.16
+Version: 0.1.17
 Summary: Declarative SQLite test data generation toolkit
 Project-URL: Homepage, https://github.com/sunbos/sqlseed
 Project-URL: Documentation, https://github.com/sunbos/sqlseed#readme

{sqlseed-0.1.16 → sqlseed-0.1.17}/src/sqlseed/_utils/progress.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import sys
 from abc import ABC, abstractmethod
 from functools import lru_cache
 from importlib.util import find_spec
@@ -64,6 +65,24 @@ def _detect_environment() -> RuntimeEnv:
     return "terminal"
 
 
+@lru_cache(maxsize=1)
+def _can_render_unicode() -> bool:
+    """Check whether stdout can encode characters used by Rich progress bars.
+
+    Rich's default ``SpinnerColumn`` uses Braille patterns (e.g. ``⠋`` U+280B)
+    and ``BarColumn`` uses block elements (``█`` U+2588, ``░`` U+2591).  On
+    Windows consoles with GBK / GB2312 / Big5 encodings these characters cause
+    ``UnicodeEncodeError``.  This helper probes the actual encoding so that
+    ``create_progress()`` can fall back to an ASCII-safe layout.
+    """
+    try:
+        encoding = getattr(sys.stdout, "encoding", None) or "utf-8"
+        "\u280b\u2588\u2591".encode(encoding)
+        return True
+    except (UnicodeEncodeError, LookupError, TypeError):
+        return False
+
+
 # ---------------------------------------------------------------------------
 # Abstract backend
 # ---------------------------------------------------------------------------
@@ -130,18 +149,37 @@ class RichProgressBackend(ProgressBackend):
     """Rich Progress backend for terminal environments.
 
     Renders spinner, progress bar, percentage, speed, and ETA.
+
+    When *ascii_only* is ``True`` the layout avoids Unicode characters
+    (Braille spinners, block-element bars) that cannot be encoded by
+    limited console encodings such as GBK or Big5.  The spinner falls back
+    to the ``"line"`` style (``|/-\\``) and the graphical bar is omitted.
     """
 
-    def __init__(self) -> None:
+    def __init__(self, *, ascii_only: bool = False) -> None:
+        if ascii_only:
+            columns: list[Any] = [
+                SpinnerColumn("line"),
+                TextColumn("[progress.description]{task.description}"),
+                TextColumn("[progress.percentage]{task.percentage:>3.0f}%"),
+                TextColumn("{task.completed}/{task.total}"),
+                TransferSpeedColumn(),
+                TimeRemainingColumn(),
+            ]
+        else:
+            columns = [
+                SpinnerColumn(),
+                TextColumn("[progress.description]{task.description}"),
+                BarColumn(),
+                TextColumn("[progress.percentage]{task.percentage:>3.0f}%"),
+                TextColumn("{task.completed}/{task.total}"),
+                TransferSpeedColumn(),
+                TimeRemainingColumn(),
+            ]
         self._progress = Progress(
-            SpinnerColumn(),
-            TextColumn("[progress.description]{task.description}"),
-            BarColumn(),
-            TextColumn("[progress.percentage]{task.percentage:>3.0f}%"),
-            TextColumn("{task.completed}/{task.total}"),
-            TransferSpeedColumn(),
-            TimeRemainingColumn(),
+            *columns,
             transient=False,
+            refresh_per_second=1,
         )
 
     def __enter__(self) -> RichProgressBackend:
@@ -258,11 +296,17 @@ def create_progress(*, disable: bool = False) -> ProgressBackend:
         disable=True  → NullProgressBackend     (zero-cost no-op)
         Jupyter+tqdm  → TqdmNotebookBackend     (native notebook widget)
         Jupyter-tqdm  → NullProgressBackend      (graceful degradation)
-        Terminal      → RichProgressBackend      (rich spinner + bar)
+        Terminal+UTF8 → RichProgressBackend      (rich spinner + bar)
+        Terminal+GBK  → RichProgressBackend(ascii_only=True)  (ASCII spinner, no bar)
 
     The Jupyter-without-tqdm path logs a one-time warning instead of raising
     ImportError, because progress display is a UX nicety, not a correctness
     requirement.
+
+    When the console encoding cannot represent the Unicode characters used by
+    Rich's default spinner (Braille patterns) and bar (block elements), the
+    factory automatically switches to an ASCII-safe layout so that Windows
+    consoles with GBK / Big5 encodings do not crash with ``UnicodeEncodeError``.
     """
     if disable:
         return NullProgressBackend()
@@ -277,4 +321,7 @@ def create_progress(*, disable: bool = False) -> ProgressBackend:
         )
         return NullProgressBackend()
 
-    return RichProgressBackend()
+    ascii_only = not _can_render_unicode()
+    if ascii_only:
+        logger.debug("Console encoding does not support Unicode progress characters — using ASCII-safe layout")
+    return RichProgressBackend(ascii_only=ascii_only)

{sqlseed-0.1.16 → sqlseed-0.1.17}/src/sqlseed/core/orchestrator.py

@@ -387,8 +387,6 @@ class DataOrchestrator:
 
             except (ValueError, RuntimeError, OSError, sqlite3.OperationalError, sqlite3.IntegrityError) as e:
                 if isinstance(e, sqlite3.IntegrityError) and enrich:
-                    # enrich mode: UNIQUE conflicts are expected when merging
-                    # into tables that already contain data
                     logger.warning("Integrity constraint during enrich", table_name=table_name, error=e)
                 else:
                     logger.error("Failed to fill table", table_name=table_name, error=e)
@@ -550,6 +548,68 @@ class DataOrchestrator:
 
     fill = fill_table
 
+    def execute(self, sql: str, params: tuple[Any, ...] | None = None) -> Any:
+        """Execute a SQL statement.
+
+        Args:
+            sql: The SQL statement to execute.
+            params: Optional tuple of parameters for parameterized queries.
+
+        Returns:
+            A cursor object with the result.
+        """
+        self._ensure_connected()
+        if params is None:
+            params = ()
+        return self._db._execute(sql, params)
+
+    def query(self, sql: str, params: tuple[Any, ...] | None = None) -> list[dict[str, Any]]:
+        """Execute a SELECT query and return results as a list of dictionaries.
+
+        Args:
+            sql: The SQL SELECT query to execute.
+            params: Optional tuple of parameters for parameterized queries.
+
+        Returns:
+            A list of dictionaries, where each dictionary represents a row.
+        """
+        self._ensure_connected()
+        cursor = self.execute(sql, params)
+        columns = [desc[0] for desc in cursor.description]
+        return [dict(zip(columns, row, strict=True)) for row in cursor.fetchall()]
+
+    def fetch_one(self, sql: str, params: tuple[Any, ...] | None = None) -> dict[str, Any] | None:
+        """Execute a SELECT query and return a single row as a dictionary.
+
+        Args:
+            sql: The SQL SELECT query to execute.
+            params: Optional tuple of parameters for parameterized queries.
+
+        Returns:
+            A dictionary representing the first row, or None if no rows found.
+        """
+        self._ensure_connected()
+        cursor = self.execute(sql, params)
+        row = cursor.fetchone()
+        if row is None:
+            return None
+        columns = [desc[0] for desc in cursor.description]
+        return dict(zip(columns, row, strict=True))
+
+    def fetch_all(self, sql: str, params: tuple[Any, ...] | None = None) -> list[Any]:
+        """Execute a SELECT query and return results as a list of lists.
+
+        Args:
+            sql: The SQL SELECT query to execute.
+            params: Optional tuple of parameters for parameterized queries.
+
+        Returns:
+            A list of rows, where each row is a list of values.
+        """
+        self._ensure_connected()
+        cursor = self.execute(sql, params)
+        return cursor.fetchall()  # type: ignore[no-any-return]
+
     def close(self) -> None:
         if self._connected:
             self._db.close()

{sqlseed-0.1.16 → sqlseed-0.1.17}/src/sqlseed/database/_base_adapter.py

@@ -31,6 +31,18 @@ class BaseSQLiteAdapter:
     def _get_execute_fn(self) -> Callable[..., Any]:
         raise NotImplementedError
 
+    def _execute(self, sql: str, params: tuple[Any, ...] = ()) -> Any:
+        """Execute a SQL statement with parameters.
+
+        Args:
+            sql: The SQL statement to execute.
+            params: Tuple of parameters for parameterized queries.
+
+        Returns:
+            The cursor object.
+        """
+        return self._get_execute_fn()(sql, params)
+
     def get_column_info(self, table_name: str) -> list[ColumnInfo]:
         raise NotImplementedError
 

{sqlseed-0.1.16 → sqlseed-0.1.17}/src/sqlseed/database/_protocol.py

@@ -67,6 +67,8 @@ class DatabaseAdapter(Protocol):
 
     def restore_settings(self) -> None: ...
 
+    def _execute(self, sql: str, params: tuple[Any, ...] = ()) -> Any: ...
+
     def __enter__(self) -> DatabaseAdapter: ...
 
     def __exit__(self, exc_type: type[BaseException] | None, exc_val: BaseException | None, exc_tb: Any) -> None: ...

sqlseed-0.1.16/sqlseed-/344/273/243/347/240/201/350/264/250/351/207/217/351/227/256/351/242/230/346/261/207/346/200/273.md

@@ -1,204 +0,0 @@
-# sqlseed 项目代码质量问题汇总
-
-> **项目**：`sunbos/sqlseed`
-> **生成日期**：2026-05-07
-> **Commit 链**：`91a30c2b` → `b2a367e0` → `eaab405a`
-
----
-
-## 一、SonarCloud 安全漏洞汇总（Commit 91a30c2b 之前）
-
-**来源**：[SonarCloud Issues](https://sonarcloud.io/project/issues?severities=BLOCKER%2CCRITICAL%2CMAJOR%2CMINOR&sinceLeakPeriod=true&issueStatuses=OPEN%2CCONFIRMED&types=VULNERABILITY&id=sunbos_sqlseed)
-
-**统计**：共 **3 个** Vulnerability，全部为 Major 级别
-
-| # | 文件 | 规则 | 严重级别 | 安全影响 | 状态 |
-|---|------|------|---------|---------|------|
-| 1 | `plugins/mcp-server-sqlseed/pyproject.toml` | S8565 | Major | Security - Medium | ✅ 已修复 |
-| 2 | `plugins/sqlseed-ai/pyproject.toml` | S8565 | Major | Security - Medium | ✅ 已修复 |
-| 3 | `pyproject.toml`（根目录） | S8565 | Major | Security - Medium | ✅ 已修复 |
-
-> **修复方式**：Commit `b2a367e0` 中已为所有 3 个 `pyproject.toml` 生成了 `uv.lock` 文件。
-
----
-
-## 二、SonarCloud 代码质量问题汇总（最新状态）
-
-**来源**：[SonarCloud Issues](https://sonarcloud.io/project/issues?issueStatuses=OPEN%2CCONFIRMED&sinceLeakPeriod=true&id=sunbos_sqlseed)
-
-**统计**：共 **11 个问题**（4 高级 + 7 中级），分布在 2 个维度
-
-### 2.1 按维度和严重级别分布
-
-| 维度 | 严重级别 | 数量 | 类型 |
-|------|---------|------|------|
-| Reliability | High (Medium impact) | 7 | **Bug** |
-| Maintainability | High (High impact) | 4 | Code Smell |
-
-### 2.2 按文件分布
-
-| 文件 | Bug | Code Smell | 合计 |
-|------|-----|------------|------|
-| `examples/notebooks/01-quickstart.ipynb` | 5 | 0 | 5 |
-| `examples/notebooks/05-dag-and-constraints.ipynb` | 0 | 1 | 1 |
-| `examples/notebooks/06-config-deep-dive.ipynb` | 0 | 2 | 2 |
-| `examples/notebooks/07-ai-plugin.ipynb` | 0 | 1 | 1 |
-| `examples/notebooks/09-plugin-hooks.ipynb` | 2 | 0 | 2 |
-
-### 2.3 详细问题列表
-
-#### 高级问题（Maintainability High）— 共 4 个 Code Smell
-
-| # | 文件 | 行号 | 描述 | 修复工作量 |
-|---|------|------|------|-----------|
-| 1 | `05-dag-and-constraints.ipynb` | L293 | 字符串字面量 `"PRJ-\\d{6}"` 重复 3 次，应定义为常量 | 6min |
-| 2 | `06-config-deep-dive.ipynb` | L755 | 字符串字面量 `"ORG-\\d{4}"` 重复 4 次，应定义为常量 | 8min |
-| 3 | `06-config-deep-dive.ipynb` | L756 | 字符串字面量 `"ORG-\\d{4}"` 重复 3 次，应定义为常量 | 6min |
-| 4 | `07-ai-plugin.ipynb` | L330 | 字符串字面量 `"ORG-\\d{4}"` 重复 3 次，应定义为常量 | 6min |
-
-#### 中级问题（Reliability Medium）— 共 7 个 Bug
-
-| # | 文件 | 行号 | 描述 | 修复工作量 |
-|---|------|------|------|-----------|
-| 1 | `01-quickstart.ipynb` | L428 | 无效的自我赋值 `PRJ_PATTERN = PRJ_PATTERN` | 3min |
-| 2 | `01-quickstart.ipynb` | L571 | 无效的自我赋值 `ORG_PATTERN = ORG_PATTERN` | 3min |
-| 3 | `01-quickstart.ipynb` | L858 | 无效的自我赋值 `ORG_PATTERN = ORG_PATTERN` | 3min |
-| 4 | `01-quickstart.ipynb` | L864 | 无效的自我赋值 `ORG_PATTERN = ORG_PATTERN` | 3min |
-| 5 | `01-quickstart.ipynb` | L1095 | 无效的自我赋值 `COUNT_ORG_SQL = COUNT_ORG_SQL` | 3min |
-| 6 | `09-plugin-hooks.ipynb` | L386 | 无效的自我赋值 `ORG_PATTERN = ORG_PATTERN` | 3min |
-| 7 | `09-plugin-hooks.ipynb` | L467 | 无效的自我赋值 `ORG_PATTERN = ORG_PATTERN` | 3min |
-
-> **根因分析**：这 7 个 Bug 是 Commit `eaab405a` 中引入的。在将重复字符串提取为常量时，notebook 的单元格中出现了 `PRJ_PATTERN = PRJ_PATTERN` 这样的自我赋值（notebook 中常量定义在之前的单元格，当前单元格重新赋值是冗余的）。**应删除这些冗余的赋值语句**。
-
----
-
-## 三、CodeFlow 分析汇总 — Commit eaab405a（最新）
-
-**来源**：[CodeFlow - Commit eaab405a](https://app.getcodeflow.com/github/sunbos/sqlseed/commits/eaab405a1f7bf74e6e7aac9b74a1b7092fa5eedf)
-
-**Commit**：`chore: additional code quality and documentation improvements`
-
-**统计**：共 **9 个警示**（0 个错误）
-
-### 3.1 按文件分布
-
-| 文件 | 错误 | 警示 | 合计 |
-|------|------|------|------|
-| `src/sqlseed/_utils/progress.py` | 0 | 6 | 6 |
-| `tests/test_utils/test_progress.py` | 0 | 3 | 3 |
-
-### 3.2 按问题类型分布
-
-| 问题类型 | 数量 | 说明 |
-|---------|------|------|
-| `unnecessary-pass` | 3 | 方法体中不必要的 `pass` 语句 |
-| `wrong-import-position` | 3 | import 语句位置不符合 PEP 8 |
-| `import-outside-toplevel` | 2 | import 不在模块顶层 |
-| `global-statement` | 1 | 使用了 global 语句 |
-
-### 3.3 详细问题列表
-
-#### 文件 1：`src/sqlseed/_utils/progress.py`（0 错误 / 6 警示）
-
-| # | 行号 | 规则 | 描述 | 代码 |
-|---|------|------|------|------|
-| 1 | 105 | `unnecessary-pass` | 方法体中不必要的 `pass` | `def __enter__(self) -> TqdmNotebookBackend: ... pass` |
-| 2 | 113 | `unnecessary-pass` | 方法体中不必要的 `pass` | `def __exit__(self, *args: Any) -> None: ... pass` |
-| 3 | 117 | `unnecessary-pass` | 方法体中不必要的 `pass` | `def add_task(...): ... pass` |
-| 4 | 201 | `import-outside-toplevel` | import 不在模块顶层 | `from tqdm.auto import tqdm` |
-| 5 | 246 | `global-statement` | 使用了 global 语句 | `global _HAS_TQDM` |
-| 6 | — | `import-outside-toplevel` | import 不在模块顶层 | 延迟导入相关 |
-
-> **说明**：Commit `eaab405a` 为 `NullProgressBackend` 的空方法添加了 docstring（如 `"""Enter the progress context."""`），但方法体仍包含 `pass` 语句。由于已有 docstring，`pass` 是多余的。
-
-#### 文件 2：`tests/test_utils/test_progress.py`（0 错误 / 3 警示）
-
-| # | 行号 | 规则 | 描述 | 代码 |
-|---|------|------|------|------|
-| 1 | 11 | `wrong-import-position` | `import pytest` 应放在模块顶部 | `import pytest` |
-| 2 | 13 | `wrong-import-position` | `import sqlseed._utils.progress` 应放在模块顶部 | `import sqlseed._utils.progress as progress_mod` |
-| 3 | 14 | `wrong-import-position` | `from sqlseed._utils.progress import (...)` 应放在模块顶部 | `from sqlseed._utils.progress import NullProgressBackend, ...` |
-
-> **说明**：这些 import 被放在 `if TYPE_CHECKING:` 块之后，违反了 PEP 8 的 import 排序规范。应将它们移到 `TYPE_CHECKING` 块之前。
-
-### 3.4 修复建议
-
-| 优先级 | 问题 | 建议 |
-|--------|------|------|
-| **P1** | `unnecessary-pass` × 3 | 删除 `progress.py` 中行 105、113、117 的 `pass` 语句（已有 docstring，pass 多余） |
-| **P1** | `wrong-import-position` × 3 | 将 `test_progress.py` 中行 11、13-22 的 import 移到 `if TYPE_CHECKING:` 块之前 |
-| **P3** | `import-outside-toplevel` × 2 | 延迟加载是有意设计，已有 `# noqa` 注释，建议配置忽略 |
-| **P3** | `global-statement` × 1 | 缓存模式的有意使用，建议配置忽略 |
-
----
-
-## 四、历史问题修复记录
-
-### Commit b2a367e0 修复的问题
-
-| # | 来源 | 文件 | 问题 | 修复方式 |
-|---|------|------|------|---------|
-| 1 | SonarCloud | 3× `pyproject.toml` | S8565 缺少锁文件 | 生成 `uv.lock` |
-| 2 | CodeFlow | `models.py:75` | `no-member` 错误 | `cls.model_fields.keys()` → `cls.model_fields` |
-| 3 | CodeFlow | `_model_selector.py:28` | `broad-exception-caught` | 缩窄为具体异常类型 |
-| 4 | CodeFlow | `progress.py` | 4× `disallowed-name` "bar" | 改为 `pbar` |
-| 5 | CodeFlow | `stream.py` | 2× `try-except-raise` | 移除冗余 except 块 |
-| 6 | CodeFlow | `stream.py:91` | `unused-variable` | `_retry_i` → `_` |
-| 7 | CodeFlow | `test_cli.py` | 2× `CodeDuplication` | 提取公共 fixture |
-
-### Commit eaab405a 修复的问题
-
-| # | 来源 | 文件 | 问题 | 修复方式 |
-|---|------|------|------|---------|
-| 8 | SonarCloud | `01-quickstart.ipynb` | 字符串 `"SELECT COUNT(*) FROM organizations"` 重复 | 提取为 `COUNT_ORG_SQL` 常量 |
-| 9 | SonarCloud | `01-quickstart.ipynb` | 字符串 `"SELECT org_code FROM organizations"` 重复 | 复用 `COUNT_ORG_SQL` |
-| 10 | SonarCloud | `progress.py:103,109` | 2× 空方法体 | 添加 docstring |
-| 11 | SonarCloud | `cli/main.py:263` | 认知复杂度过高 | 提取外键打印逻辑 |
-| 12 | SonarCloud | `test_progress.py:265` | yield 缺少 Generator 类型标注 | 添加类型标注 |
-| 13 | SonarCloud | `models.py:79` | 不必要的 `list()` 调用 | 简化字典迭代 |
-| 14 | SonarCloud | `_model_selector.py:29` | 冗余 Exception 子类 | 移除 `OSError` |
-| 15 | SonarCloud | `04-database-advanced.ipynb` | 2× set 构造优化 | 改为集合推导式 |
-| 16 | CodeFlow | `_model_selector.py:29` | `overlapping-except` | 移除 `OSError` |
-
-### Commit eaab405a 新引入的问题
-
-| # | 来源 | 文件 | 问题 | 原因 |
-|---|------|------|------|------|
-| 1 | SonarCloud | `01-quickstart.ipynb` | 5× useless self-assignment | 常量定义在 notebook 前一个单元格，当前单元格冗余赋值 |
-| 2 | SonarCloud | `09-plugin-hooks.ipynb` | 2× useless self-assignment | 同上 |
-| 3 | CodeFlow | `progress.py` | 3× `unnecessary-pass` | 添加 docstring 后未删除多余的 `pass` |
-| 4 | CodeFlow | `test_progress.py` | 3× `wrong-import-position` | import 排在 `TYPE_CHECKING` 块之后 |
-
----
-
-## 五、综合修复优先级建议
-
-### P0 — 必须修复（Bug / 影响正确性）
-
-| # | 文件 | 问题 | 数量 | 预计工作量 |
-|---|------|------|------|-----------|
-| 1 | `01-quickstart.ipynb` | useless self-assignment | 5 | 15min |
-| 2 | `09-plugin-hooks.ipynb` | useless self-assignment | 2 | 6min |
-
-> **修复方式**：删除 notebook 单元格中冗余的 `PRJ_PATTERN = PRJ_PATTERN`、`ORG_PATTERN = ORG_PATTERN`、`COUNT_ORG_SQL = COUNT_ORG_SQL` 等自我赋值语句。
-
-### P1 — 建议尽快修复（代码规范）
-
-| # | 文件 | 问题 | 数量 | 预计工作量 |
-|---|------|------|------|-----------|
-| 3 | `progress.py` | `unnecessary-pass` | 3 | 3min |
-| 4 | `test_progress.py` | `wrong-import-position` | 3 | 5min |
-| 5 | 4× notebooks | 字符串字面量重复 | 4 | 26min |
-
-### P2 — 建议修复（可维护性）
-
-| # | 文件 | 问题 | 数量 |
-|---|------|------|------|
-| 6 | `progress.py` | `import-outside-toplevel` + `global-statement` | 3 |
-
-### P3 — 可选（有意设计，建议配置忽略）
-
-| # | 文件 | 问题 | 说明 |
-|---|------|------|------|
-| 7 | `progress.py` | `import-outside-toplevel` | tqdm 延迟加载 |
-| 8 | `progress.py` | `global-statement` | `_HAS_TQDM` 缓存标记 |