yakultpdf 0.7.5__tar.gz

yakultpdf-0.7.5/.agent/rules/general.md

@@ -0,0 +1,6 @@
+---
+trigger: always_on
+---
+
+- this is a python project using "uv". always use uv.
+- when asked to write a plan or do research, just plan in ./_logs and DON'T implement.

yakultpdf-0.7.5/.agent/rules/typst.md

@@ -0,0 +1,6 @@
+---
+trigger: model_decision
+description: rules about typst
+---
+
+always check typst reference first: https://typst.app/docs/reference/

yakultpdf-0.7.5/.env

@@ -0,0 +1 @@
+UV_PUBLISH_TOKEN=pypi-AgEIcHlwaS5vcmcCJDRiOTg1MmM4LTk2YmEtNGRmZS05ZTcxLTY0N2MyNmEzN2I3OAACKlszLCI5ODBjZWQzYS0xYTA3LTQ1ZDMtYWVkNS02ZmFkMjA0ZTJmNjAiXQAABiAIWgPMRzPuBYV8I0jETznnA3h1wMJS0nUGq4UxZzv2ig

yakultpdf-0.7.5/.gitignore

@@ -0,0 +1,28 @@
+# Python-generated files
+__pycache__/
+.ruff_cache
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+.pytest_cache
+.DS_Store
+# Virtual environments
+.venv
+.vscode
+.coverage
+
+.pandoctemp
+
+_working
+
+*.pdf
+
+.claude
+
+# Temporarily ignore uv.lock during frequent updates to avoid noise.
+# This should be removed from .gitignore and tracked again once the project stabilizes.
+#uv.lock
+
+moonspace

yakultpdf-0.7.5/AGENTS.md

@@ -0,0 +1,11 @@
+python project with uv, using pandoc + typst to convert markdown to pdf
+
+Directory Structure
+
+- src
+- scripts
+- templates
+- _logs
+
+Rules: 
+always run with `uv`

yakultpdf-0.7.5/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## [0.7.0] - 2026-01-03
+
+### Changed
+- Refactored project structure and for `mark2pdf` package publishing.

yakultpdf-0.7.5/Dockerfile

@@ -0,0 +1,73 @@
+FROM python:3.11-slim
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    wget \
+    fontconfig \
+    fonts-arphic-ukai \
+    fonts-arphic-uming \
+    fonts-dejavu-core \
+    fonts-freefont-ttf \
+    fonts-ipafont-gothic \
+    fonts-ipafont-mincho \
+    fonts-liberation \
+    fonts-noto-cjk \
+    fonts-noto-color-emoji \
+    fonts-noto-core \
+    fonts-noto-extra \
+    fonts-urw-base35 \
+    fonts-wqy-microhei \
+    fonts-wqy-zenhei \
+    ca-certificates \
+    xz-utils \
+    build-essential \
+    cmake \
+    pkg-config \
+    libopencc-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN set -eux; \
+    arch="$(dpkg --print-architecture)"; \
+    case "$arch" in \
+      amd64) pandoc_arch="amd64" ;; \
+      arm64) pandoc_arch="arm64" ;; \
+      *) echo "Unsupported architecture: $arch" >&2; exit 1 ;; \
+    esac; \
+    pandoc_tag="$(python -c "import json,urllib.request; print(json.load(urllib.request.urlopen('https://api.github.com/repos/jgm/pandoc/releases/latest'))['tag_name'])")"; \
+    wget -qO- "https://github.com/jgm/pandoc/releases/download/${pandoc_tag}/pandoc-${pandoc_tag}-linux-${pandoc_arch}.tar.gz" \
+      | tar xz --strip-components=1 -C /usr/local
+
+RUN set -eux; \
+    arch="$(dpkg --print-architecture)"; \
+    case "$arch" in \
+      amd64) typst_arch="x86_64-unknown-linux-musl" ;; \
+      arm64) typst_arch="aarch64-unknown-linux-musl" ;; \
+      *) echo "Unsupported architecture: $arch" >&2; exit 1 ;; \
+    esac; \
+    wget -qO- "https://github.com/typst/typst/releases/latest/download/typst-${typst_arch}.tar.xz" \
+      | tar xJ --strip-components=1 -C /usr/local/bin
+
+RUN pip install --no-cache-dir uv
+
+WORKDIR /app
+
+COPY pyproject.toml uv.lock ./
+RUN uv sync --frozen --no-dev --extra web --no-install-project
+
+COPY . .
+RUN uv sync --frozen --no-dev --extra web
+
+# Manual custom fonts (e.g. YouSheBiaoTiHei)
+COPY web_ui/fonts/ /usr/share/fonts/mark2pdf/
+
+# Auto-install supported fonts
+RUN uv run mark2pdf fonts install lxgw-wenkai --dir /usr/share/fonts/mark2pdf/
+RUN uv run mark2pdf fonts install source-han-sans --dir /usr/share/fonts/mark2pdf/
+# RUN uv run mark2pdf fonts install yozai --dir /usr/share/fonts/mark2pdf/
+
+RUN fc-cache -fv
+
+ENV TYPST_FONT_PATHS=/usr/share/fonts/mark2pdf
+
+EXPOSE 8000
+
+CMD ["uv", "run", "uvicorn", "web_ui.web_server:app", "--host", "0.0.0.0", "--port", "8000"]

yakultpdf-0.7.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 mark2pdf contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

yakultpdf-0.7.5/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: yakultpdf
+Version: 0.7.5
+Summary: Markdown to PDF converter using Pandoc and Typst
+Author: mark2pdf contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: converter,markdown,pandoc,pdf,typst
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Requires-Dist: click>=8.0.0
+Requires-Dist: markdown-it-py
+Requires-Dist: mdit-py-plugins
+Requires-Dist: opencc
+Requires-Dist: pillow
+Requires-Dist: pyyaml
+Provides-Extra: web
+Requires-Dist: fastapi>=0.128.0; extra == 'web'
+Requires-Dist: uvicorn[standard]>=0.40.0; extra == 'web'
+Description-Content-Type: text/markdown
+
+# mark2pdf
+
+**基于 Pandoc 和 Typst 的 Markdown 转 PDF 工具**
+
+将 Markdown 文件转换为精美的 PDF。支持 Frontmatter 配置、自动化目录管理以及通过 Python 代码调用。
+
+## 安装
+
+```bash
+pip install mark2pdf
+```
+
+> **注意**：使用前请确保已安装 [Pandoc](https://pandoc.org/) 和 [Typst](https://typst.app/)。
+
+## CLI 使用
+
+**1. 初始化与配置**
+```bash
+# 初始化工作区（创建配置和目录结构）
+mark2pdf init
+
+# 安装常用中文字体（如 lxgw-wenkai）
+mark2pdf fonts install lxgw-wenkai
+```
+
+**2. 转换文档**
+```bash
+# 转换单个文件 (默认输出到 out/ 目录)
+mark2pdf convert document.md
+
+# 转换单个文件并指定输出文件名
+mark2pdf convert document.md --output my-report
+
+# 转换整个目录（自动合并目录内所有 md 文件）
+mark2pdf convert --dir docs/
+```
+
+**3. 更多功能**
+```bash
+# 复制内置模板到本地 template/ 目录
+mark2pdf template
+
+# 查看帮助
+mark2pdf --help
+mark2pdf convert --help
+```
+
+## Python API 使用
+
+```python
+from mark2pdf import convert_file, convert_directory
+
+# 1. 转换单个文件
+# 将 input.md 转换为 output.pdf，使用默认配置
+convert_file("input.md", output_file="output.pdf")
+
+# 2. 转换目录
+# 将 docs 目录下的所有 Markdown 合并转换为 merged_report.pdf
+convert_directory("docs", output_file="merged_report.pdf")
+```
+
+## 开发与全局安装
+
+如果你是开发者或希望从源码进行全系统安装，推荐使用 `uv tool`：
+
+```bash
+# 在项目根目录下运行
+uv tool install . --force
+```
+
+这会将 `mark2pdf` 安装到隔离环境中并添加到系统 PATH，使你可以在任何目录下直接运行 `mark2pdf` 命令。

yakultpdf-0.7.5/README.md

@@ -0,0 +1,71 @@
+# mark2pdf
+
+**基于 Pandoc 和 Typst 的 Markdown 转 PDF 工具**
+
+将 Markdown 文件转换为精美的 PDF。支持 Frontmatter 配置、自动化目录管理以及通过 Python 代码调用。
+
+## 安装
+
+```bash
+pip install mark2pdf
+```
+
+> **注意**：使用前请确保已安装 [Pandoc](https://pandoc.org/) 和 [Typst](https://typst.app/)。
+
+## CLI 使用
+
+**1. 初始化与配置**
+```bash
+# 初始化工作区（创建配置和目录结构）
+mark2pdf init
+
+# 安装常用中文字体（如 lxgw-wenkai）
+mark2pdf fonts install lxgw-wenkai
+```
+
+**2. 转换文档**
+```bash
+# 转换单个文件 (默认输出到 out/ 目录)
+mark2pdf convert document.md
+
+# 转换单个文件并指定输出文件名
+mark2pdf convert document.md --output my-report
+
+# 转换整个目录（自动合并目录内所有 md 文件）
+mark2pdf convert --dir docs/
+```
+
+**3. 更多功能**
+```bash
+# 复制内置模板到本地 template/ 目录
+mark2pdf template
+
+# 查看帮助
+mark2pdf --help
+mark2pdf convert --help
+```
+
+## Python API 使用
+
+```python
+from mark2pdf import convert_file, convert_directory
+
+# 1. 转换单个文件
+# 将 input.md 转换为 output.pdf，使用默认配置
+convert_file("input.md", output_file="output.pdf")
+
+# 2. 转换目录
+# 将 docs 目录下的所有 Markdown 合并转换为 merged_report.pdf
+convert_directory("docs", output_file="merged_report.pdf")
+```
+
+## 开发与全局安装
+
+如果你是开发者或希望从源码进行全系统安装，推荐使用 `uv tool`：
+
+```bash
+# 在项目根目录下运行
+uv tool install . --force
+```
+
+这会将 `mark2pdf` 安装到隔离环境中并添加到系统 PATH，使你可以在任何目录下直接运行 `mark2pdf` 命令。

yakultpdf-0.7.5/_logs/README.md

@@ -0,0 +1,27 @@
+# _logs 目录索引
+
+## 核心文档
+- [迭代日志](./迭代日志.md) - 版本演进与关键变更
+
+## 用户文档 (docs/)
+- [CLI 使用说明](./docs/CLI使用说明.md)
+- [工作区使用指南](./docs/工作区使用指南.md)
+- [项目说明文档](./docs/项目说明文档.md)
+
+## 审查报告 (reports/)
+(暂无，记录已清楚)
+
+## Typst 相关 (typst/)
+- 模板审查与改进建议、版式调研与实现说明
+
+## 调研资料 (research/)
+- 双语翻译调研、多封面研究、外部脚本调用方案
+
+## 历史归档 (archive/)
+- CLI 重构系列、功能实现记录、已完成方案、codex 调研、讨论方案、最终思考
+
+## 待办 (backlog/)
+- NextJS 集成分析
+
+## 待删除临时目录
+- `待删除临时目录/` 用于暂存拟删除文件与空目录

yakultpdf-0.7.5/_logs/archive/CLI/351/207/215/346/236/204/347/263/273/345/210/227/CLI/345/210/206/346/236/220/346/212/245/345/221/212_postprocess/344/270/216/345/220/210/345/271/266/345/273/272/350/256/256.md

@@ -0,0 +1,223 @@
+# mark2pdf CLI 统一方案 - 全面整合分析
+
+日期：2024-12-31
+**实施状态更新**: 2024-12-31
+
+---
+
+## 一、现状分析
+
+### 1.1 当前架构
+
+> ✅ **已变更**: `config_manager` 已重命名为 `mark2pdf`
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                          pyproject.toml                             │
+│  md2pdf = "markdown2pdf.cli:cli"     ← ✅ 已移除                     │
+│  mark2pdf = "mark2pdf.cli:main"         ← ✅ 已更新                    │
+└─────────────────────────────────────────────────────────────────────┘
+                              │
+       ┌──────────────────────┴──────────────────────┐
+       │                                              │
+       ▼                                              ▼
+┌──────────────────────┐                    ┌──────────────────────┐
+│  markdown2pdf/       │                    │  mark2pdf/            │
+│  (核心转换)          │                    │  (CLI + 工作区管理) │
+│  - core.py           │                    │  - cli.py            │
+│  - directory.py      │                    │  - conversion.py     │
+└──────────────────────┘                    └──────────────────────┘
+```
+
+### 1.2 两个 CLI 功能对比
+
+| 功能 | `md2pdf` | `mark2pdf` | 状态 |
+|------|----------|-----------|------|
+| 转换单文件 | ✅ | ✅ | ✅ 已实现 |
+| 目录合并转换 | ✅ | ✅ | ✅ 已实现 |
+| 工作区初始化 | ❌ | ✅ | ✅ 已有 |
+| 工作区更新 | ❌ | ✅ | ✅ 已有 |
+| 图片清理 | ❌ | ✅ | ✅ 已有 |
+| 配置文件读取 | ❌ | ✅ | ✅ 已实现 |
+
+### 1.3 createpdf.py 的角色
+
+> ✅ **已更新**: import 已从 `config_manager` 改为 `mark2pdf`
+
+---
+
+## 二、目标架构
+
+### 2.1 统一入口
+
+> ✅ **已实现**
+
+```
+mark2pdf (唯一 CLI)
+├── convert <file>            # ✅ 已实现
+│   ├── --dir <目录>          # ✅ 已实现
+│   ├── --batch <目录>        # ✅ 已实现
+│   ├── --postprocess <name>  # ✅ 参数已预留（功能待实现）
+│   └── 其他选项...           # ✅ 已实现
+├── init <目录>               # ✅ 已有
+├── update [目录]             # ✅ 已有
+├── version                   # ✅ 已新增
+└── imageclearing <file>      # ✅ 已有
+```
+
+### 2.2 createpdf.py 新定位
+
+> ✅ **已实现**
+
+---
+
+## 三、postprocess 插件机制（预留）
+
+### 3.1 当前实现范围
+
+| 项目 | 状态 | 实施状态 |
+|------|------|----------|
+| `--postprocess <name>` CLI 参数 | ✅ 预留 | ✅ 已实现 |
+| 插件加载器 | ❌ 暂不实现 | ✅ 基础框架已建立 |
+| 工作区插件查找 | ❌ 暂不实现 | ⏳ 待实现 |
+| 预定义插件库 | ❌ 暂不实现（仅 `abc-postprocess`）| ✅ abc_postprocess 已创建 |
+
+### 3.2 smoke test 用空处理器
+
+> ✅ **已实现**: `src/markdown2pdf/postprocessors/abc_postprocess.py`
+
+### 3.3 后续完整实现（规划）
+
+待需要时再实现：
+
+- **按名称查找** - 工作区 > 预定义 ⏳
+- **动态加载** - importlib 加载 .py 文件 ⏳
+- **预定义处理器** - tc_convert、remove_links 等 ⏳
+
+
+---
+
+## 四、工作区自动检测
+
+### 4.1 当前问题
+
+> ✅ **已解决**
+
+### 4.2 解决方案
+
+> ✅ **已实现**: `detect_workspace()` 函数在 `mark2pdf/cli.py`
+
+---
+
+## 五、实现计划
+
+### 5.1 文件变更
+
+#### 修改
+
+| 文件 | 变更 | 状态 |
+|------|------|------|
+| `pyproject.toml` | 移除 `md2pdf` 入口 | ✅ 已完成 |
+| `mark2pdf/cli.py` | 添加 `convert` 子命令 | ✅ 已完成 |
+| `mark2pdf/conversion.py` | 支持 postprocess 名称参数 | ⏳ 待实现（当前仅函数参数） |
+| `mark2pdf/resources/createpdf.py` | 精简，仅保留自定义逻辑用途 | ✅ 已完成 |
+
+#### 新增
+
+| 文件 | 用途 | 状态 |
+|------|------|------|
+| `markdown2pdf/postprocessors/__init__.py` | 插件加载器 | ✅ 已创建 |
+| `markdown2pdf/postprocessors/tc_convert.py` | 预定义：繁体转换 | ⏳ 待实现 |
+| `markdown2pdf/postprocessors/remove_links.py` | 预定义：移除链接 | ⏳ 待实现 |
+
+#### 可选移除
+
+| 文件 | 说明 | 状态 |
+|------|------|------|
+| `markdown2pdf/cli.py` | 保留备用 | ✅ 保留（但入口已移除）|
+| `markdown2pdf/defaults.py` | 合并到 mark2pdf | ✅ 保留（被 mark2pdf 调用）|
+
+### 5.2 内置后处理器清单
+
+| 处理器名称 | 对应的 CLI 参数 | 状态 |
+|------------|----------------|------|
+| `tc_convert` | `--tc` | ⏳ 待迁移为插件（当前内联实现）|
+| `remove_links` | `--removelink` | ⏳ 待迁移为插件（当前内联实现）|
+
+### 5.3 新 CLI 结构
+
+> ✅ **已实现**（但 `--removelink` 参数声明后未传递给底层函数）
+
+### 5.4 createpdf.py 精简版
+
+> ✅ **已实现**
+
+---
+
+## 六、使用场景对照
+
+> ✅ **全部已实现**
+
+| 场景 | 新方式 | 状态 |
+|------|--------|------|
+| 普通转换 | `mark2pdf convert sample.md` | ✅ |
+| 指定模板 | `mark2pdf convert -t custom.typ` | ✅ |
+| 繁体转换 | `mark2pdf convert --tc` | ✅ |
+| 使用后处理 | `mark2pdf convert -p xxx` | ⏳ 参数预留，功能待实现 |
+| 初始化工作区 | `mark2pdf init .` | ✅ |
+
+---
+
+## 七、功能增强建议
+
+### 7.1 新增命令
+
+- `mark2pdf version`: ✅ **已实现**
+
+### 7.2 `convert` 命令增强
+
+| 选项 | 状态 |
+|------|------|
+| `--dry-run` | ✅ 已实现 |
+| `--show-config` | ✅ 已实现 |
+| `--verbose` | ✅ 已实现（也会打印配置）|
+
+### 7.3 关键设计决策
+
+1. **createpdf.py 参数支持**: ✅ 已使用 `click` 接管
+2. **`postprocess` 传参**: ✅ 按计划暂不支持
+3. **工作区递归检测**: ✅ 按计划暂不支持
+
+### 7.4 技术规范与安全性修正
+
+1. **包名策略**: ⚠️ 偏离计划
+   - 计划：保持 `config_manager`
+   - 实际：已重命名为 `mark2pdf`（用户要求）
+
+2. **模板文件加载策略**: ✅ 保持现状
+
+3. **依赖安装安全**: ⏳ 待审查
+
+### 7.5 配置打印逻辑与时机
+
+> ✅ **已实现**: 按计划顺序执行
+
+---
+
+## 八、总结
+
+| 变更项 | 说明 | 状态 |
+|--------|------|------|
+| **移除 `md2pdf`** | 统一使用 `mark2pdf` | ✅ |
+| **新增 `mark2pdf convert`** | 主转换命令 | ✅ |
+| **postprocess 插件化** | 预定义 + 工作区自定义 | ⏳ 框架已建，待完善 |
+| **工作区自动检测** | 在工作区目录直接运行 | ✅ |
+| **精简 `createpdf.py`** | 仅保留复杂自定义场景 | ✅ |
+| **调试增强** | `show-config`, `dry-run` | ✅ |
+
+### 待办事项
+
+1. ⏳ `--removelink` 参数传递给底层函数
+2. ⏳ `tc_convert` 插件独立实现
+3. ⏳ `remove_links` 插件独立实现
+4. ⏳ 插件动态加载机制完善

yakultpdf-0.7.5/_logs/archive/CLI/351/207/215/346/236/204/347/263/273/345/210/227/mark2pdf_cli/351/207/215/346/236/204/350/256/241/345/210/222.md

@@ -0,0 +1,73 @@
+
+### mark2pdf CLI 重构方案（2025-12-31 执行结果）
+
+**核心目标**: 降低 `cli.py` 复杂度，实现关注点分离（UI、配置、逻辑构建、执行），并将配置管理职责明确化。
+
+#### 1. 模块拆分与职能重定义 (已实施)
+
+*   **`src/mark2pdf/cli.py` (指挥官)**
+    *   **职责**: 解析参数 -> 调用 `process_builder` 组装逻辑 -> 调用 `reporter` 显示配置 -> 调用 `conversion` 执行。
+    *   **保留**: `main`, `convert`, `version` 命令定义。
+    *   **变更**: `init`, `update`, `imageclearing` 命令已下沉至 `commands/` 子包。
+
+*   **`src/mark2pdf/config_loader.py` (配置加载)**
+    *   **来源**: 原 `manager.py` 的重命名与精简。
+    *   **职责**:
+        1.  `ConfigManager.load()`: 加载 `mark2pdf.config.toml`。
+        2.  `load_frontmatter_yaml`: 加载默认 frontmatter。
+        3.  `resolve_template`: 模板决策逻辑。
+    *   **状态**: 完成。并未实现单一的 `build_execution_context` 函数，而是保持了灵活的函数调用组合，以适应 Click 的参数处理方式。
+
+*   **`src/mark2pdf/workspace_manager.py` (工作区管理)**
+    *   **来源**: 从原 `manager.py` 拆分。
+    *   **职责**: `init_workspace`, `update_workspace`, `detect_workspace`。
+    *   **状态**: 完成。
+
+*   **`src/mark2pdf/process_builder.py` (逻辑组装)**
+    *   **职责**: 接收插件名称列表，动态组装后处理器链。
+    *   **API**: `build_postprocessor_chain`, `get_processor_names_from_flags`。
+    *   **状态**: 完成。
+
+*   **`src/mark2pdf/reporter.py` (UI展示)**
+    *   **职责**: 负责 `--show-config`, `--dry-run` 的终端输出。
+    *   **API**: `print_config_report`, `print_execution_plan`。
+    *   **状态**: 完成。
+
+*   **`src/mark2pdf/conversion.py` (执行)**
+    *   **改进**: 移除内部 `ConfigManager.load()` 调用，改为使用 `config_loader` 提供的工具函数获取配置。
+    *   **状态**: 完成。
+
+*   **`src/mark2pdf/commands/` (子命令包)**
+    *   **新增内容**:
+        *   `workspace.py`: 包含 `init`, `update` 命令。
+        *   `image.py`: 包含 `imageclearing` 命令。
+    *   **状态**: 完成。
+
+#### 2. 数据流向图
+
+```text
+CLI Args (cli.py / commands/*.py)
+   |
+   +---> [process_builder] (组装插件)
+   |
+   +---> [config_loader] (加载配置)
+   |
+   v
+[reporter] (显示配置/计划)
+   |
+   v
+[conversion] (执行转换) --> Output PDF
+```
+
+#### 3. 实施路径回顾
+
+1.  **拆分**: `manager.py` -> `config_loader.py` + `workspace_manager.py`。
+2.  **新建**: `process_builder.py`, `reporter.py`, `utils.py`。
+3.  **子命令下沉**: 建立 `commands/` 子包，迁移非核心命令。
+4.  **组装**: `cli.py` 负责串联，`__init__.py` 维护导出接口。
+5.  **验证**: 单元测试覆盖率 100% (34 passed)。
+
+#### 4. 优势
+*   **关注点分离**: 配置、业务、UI、命令定义彻底解耦。
+*   **可扩展性**: 新增命令只需在 `commands/` 下添加并注册。
+*   **可维护性**: 每个模块行数适中，职责单一。