v0.1.7: legacy XLS evidence and on-demand OCR

Add legacy XLS cell-level provenance using xlrd and the shared faithful grid renderer: coordinates, values/types, formats, merged references, dates, hidden content and available notes/links. Formula results are cached values only; XLS images/charts remain explicitly outside extraction coverage.

Initialize the OCR SDK only on the first real image request. Pure native text spreadsheets require no model/key even with OCR enabled. Missing credentials for real OCR become explicit file errors.

Add Agent ingestion documentation explaining Markdown/JSON roles, hash verification, merge semantics and business-audit boundaries. Validation: 34 tests with both supported OCR interfaces; real XLS sample matches 249 nonempty cells across 33 records with zero model requests.

v0.1.6: spreadsheet fidelity and evidence records

Preserve XLSX row/column coordinates, merged references, native values, formulas, formats, hidden state and annotations. Preserve stored values covered by merged cells separately and flag differences. Escape Markdown pipes and render cell line breaks. Recognize embedded raster images without resizing.

Add optional evidence=True / --evidence provenance JSON with hashes, converter/dependency versions and explicit coverage limits. Evidence mode distinguishes same-stem inputs and rejects changed sources. Staged publication prevents mismatched Markdown and manifests after write failures.

Validation: 31 tests pass with both supported OCR interfaces; a real workbook retains all 627 stored values and 69 merged ranges, including 24 values hidden by merges. These are conversion checks, not business audit or OCR accuracy certification. PDF table geometry and image entity counting remain outside this release.

Ming ToMarkdown v0.1.5

兼容新版 MarkItDown / OCR 插件的 Word 图片接口，确保 DOCX 图片并发在实际安装环境中生效。

• 保留 PDF、文件夹和 DOCX 的及时补位、有序输出及全局请求上限。
• 兼容 MarkItDown 0.1.5 / OCR插件0.1.0 和 MarkItDown 0.1.8 / OCR插件0.1.1 两套接口；沿用各自的原生格式化逻辑。
• 发布流程新增新版依赖接口测试，两套依赖环境均通过21项回归。
• 保持原图及完整提取提示词，不自动切换模型。

0.1.4 在旧版插件上有效，但新版插件更换了DOCX图片hook，导致单份Word内的并发未生效；本版本补齐该兼容性。

uv pip install --upgrade ming-tomarkdown

uv项目还需更新锁文件：uv lock --upgrade-package ming-tomarkdown。Notebook升级后请重启内核。

Ming ToMarkdown v0.1.4

修复慢请求阻塞空闲并发名额的问题，并增加单个 DOCX 内图片的并发 OCR。保持原图、完整提取提示词、全局请求上限及原文输出顺序。

• PDF 任意请求完成后及时补位，不再等排在前面的慢请求。
• 文件夹和 DOCX 使用有界重排缓冲，完成顺序不影响输出顺序。
• DOCX 图片识别失败明确报错，避免降级后显示成功。
• 新增慢首项、DOCX内容/原始请求一致性、重排缓冲上限回归测试。

验证：全部21项测试通过；实际5文件/28图片样本用相同依赖及固定100ms假服务回放，五份输出逐字节一致，耗时3.036秒降至1.589秒。该数据只验证本地调度，不代表模型服务倍速。

并发无法解决模型单次请求长时间不返回的问题；模型配置不会自动更换。详情见补充诊断报告。

uv pip install --upgrade ming-tomarkdown

uv项目还需更新锁文件：uv lock --upgrade-package ming-tomarkdown。Notebook升级后请重启内核。

Ming ToMarkdown v0.1.3

默认最多并发执行 4 个 OCR 请求，加速多页 PDF 和文件夹转换。保留原尺寸图片与完整提取提示词，不缩图、不截短输出、不自动切换模型。

• PDF 只打开一次，识别结果仍按页序及图文位置合并。
• 同次转换中的相同请求共享结果，减少重复识别。
• 新增 --workers、--timeout、--max-retries，并显示请求次数、复用次数和总耗时。
• 修复 OCR 失败被当作成功、明确拒答或输出截断未被报告，以及并发冷启动时插件可能漏加载的问题。
• 保持文件按名称排序写入和原有同名覆盖规则。

验证：16 项回归测试通过，安装包构建及实际转换检查通过。原图小样本实测两张图片从串行 12.69 秒降至并发 6.59 秒；具体收益取决于服务容量，单张首次识别不承诺提速。

升级：

uv pip install --upgrade ming-tomarkdown
# 或
python -m pip install --upgrade ming-tomarkdown

使用 tomarkdown --workers 1 可以退回串行。图片按原信息发送不等于模型识别准确率100%，复杂内容仍需核对原文。

Ming ToMarkdown v0.1.2

现已正式发布到 PyPI，可直接安装：

uv pip install ming-tomarkdown

需要 Python 3.12+。安装后使用 tomarkdown 命令，或 from tomarkdown import convert。

此补丁更新 PyPI 安装文档，转换功能不变。

Ming ToMarkdown v0.1.1

安装包名称改为 ming-tomarkdown，终端命令与导入名保持 tomarkdown。

安装（Python 3.12+，已有虚拟环境）：

uv pip install "https://github.com/MingWangD/ToMarkdown/releases/download/v0.1.1/ming_tomarkdown-0.1.1-py3-none-any.whl"

升级旧版 GitHub 包前，先在对应环境卸载 tomarkdown，避免共享模块冲突。

使用：

tomarkdown "/路径/资料"

Python 调用：

from tomarkdown import convert
result = convert("/路径/资料")

已验证新包独立安装、Python 导入、普通文件转换及命令入口。本次仅通过 GitHub 分发，尚未发布到 PyPI。

ToMarkdown v0.1.0

首个可安装的 ToMarkdown Python 包。

• 支持 tomarkdown 命令、python -m tomarkdown 和 from tomarkdown import convert。
• 默认开启图片 OCR，支持单文件和 PDF/Word 等混合格式文件夹。
• 单文件输出到当前目录的 results/，批量输出到 results/输入文件夹名/。
• 保留原有 uv run python to_md.py 用法。

安装（需要 Python 3.12+，无需 Git）：

python -m pip install "https://github.com/MingWangD/ToMarkdown/releases/download/v0.1.0/tomarkdown-0.1.0-py3-none-any.whl"

使用：

tomarkdown "/路径/文档.pdf" --no-ocr

开启默认 OCR 前，请按 README 配置 API Key、视觉模型和 OpenAI 兼容接口地址。

已在项目目录之外安装 wheel，验证 Python API、命令行、模块入口以及 PDF/DOCX 混合批量转换。本次验证未调用真实模型服务。