sdpy-kit 0.4.2__tar.gz → 0.4.4__tar.gz

{sdpy_kit-0.4.2 → sdpy_kit-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sdpy-kit
-Version: 0.4.2
+Version: 0.4.4
 Summary: SDPY Kit——统一数据库访问层（PG/MySQL/SQLite）与 AI/Redis/文件/文档/向量工具集
 Author-email: Clark <changhongyuan@126.com>
 License-Expression: MIT
@@ -91,11 +91,11 @@ SDPY 统一工具集（Kit 体系），供 Python 项目开箱即用：
 | `kit.redis_kit` | `RedisKit` | Redis string / hash / list / set / zset | `redis` |
 | `kit.file_kit` | `FileKit` | 文件与目录读写、移动、遍历 | 无 |
 | `kit.common_kit` | `CommonKit` | 雪花 ID、时间戳 ID、时间格式化 | 无 |
-| `kit.anydoc_kit` | `AnyDocKit` | docx / pdf / xlsx 等 → Markdown | `anydoc` |
-| `kit.docx_kit` | `DocxKit` | Word 模板动态填充（章节 / 列表 / 表格） | `docx` |
-| `kit.md2doc_kit` | `Md2DocKit` | Markdown → Word / PDF / HTML | `md2doc` |
-| `kit.mineru_kit` | `MinerUKit` | MinerU 文档解析（精准 + Agent 轻量） | `mineru` |
-| `kit.marker_kit` | `MarkerKit` | 本地文档解析（PDF / 图片 / Office → Markdown + Images） | `marker` |
+| `kit.docs.anydoc_kit` | `AnyDocKit` | docx / pdf / xlsx 等 → Markdown | `anydoc` |
+| `kit.docs.docx_kit` | `DocxKit` | Word 模板动态填充（章节 / 列表 / 表格） | `docx` |
+| `kit.docs.md2doc_kit` | `Md2DocKit` | Markdown → Word / PDF / HTML | `md2doc` |
+| `kit.docs.mineru_kit` | `MinerUKit` | MinerU 文档解析（精准 + Agent 轻量） | `mineru` |
+| `kit.docs.marker_kit` | `MarkerKit` | 本地文档解析（PDF / 图片 / Office → Markdown + Images） | `marker` |
 | `kit.laya_kit` | `LayaKit` | 类型化决策：choice / score / noul，返回判断结果 + 置信度 | `laya` |
 | `kit.crawl.article_models` | `ArticleInfo` / `ArticleResult` / `SavedOutput` 等 | 文章抓取通用模型（两 `*ArticleKit` 共用，含 `reason` 分类与非致命 `warnings`） | 无 |
 | `kit.crawl.wx_article_kit` | `WxArticleKit` | 微信公众号文章 → Markdown + 图片转存 | 无 |
@@ -180,7 +180,7 @@ SQLITE_DB_PATH=./data/sqlite.db
 
 ### 环境变量 ↔ 能力对照表
 
-> 表中未出现的模块（`kit.crawl.article_models`、`kit.common_kit`、`kit.docx_kit`、`kit.md2doc_kit`、`kit.crawl.wx_article_kit`、`kit.crawl.web_article_kit`）不读取任何环境变量。
+> 表中未出现的模块（`kit.crawl.article_models`、`kit.common_kit`、`kit.docs.docx_kit`、`kit.docs.md2doc_kit`、`kit.crawl.wx_article_kit`、`kit.crawl.web_article_kit`）不读取任何环境变量。
 
 **基础与日志**（影响 `kit.config` 及所有模块的日志输出）
 
@@ -231,7 +231,7 @@ SQLITE_DB_PATH=./data/sqlite.db
 | `KIT_AI_CHAIN_TIMEOUT` | 未设置 | 全局整链预算（秒）= 门面同步等待上限。⚠ **不是 `Settings` 字段**，由代码直读 `os.environ`，无类型/范围校验，非法值仅告警后回退 |
 | *（密钥，变量名由档案决定）* | 无 | 名字写在 `ai_models.json` 各档案的 `api_key` 字段（如 `SILICONFLOW_API_KEY`），值放 `.env` 或系统环境变量。未配置的档案会被剔除出候选链；该类型全部未配置则调用失败 |
 
-**MinerU** → `kit.mineru_kit`
+**MinerU** → `kit.docs.mineru_kit`
 
 | 环境变量 | 默认值 | 作用 |
 |----------|--------|------|
@@ -242,7 +242,7 @@ SQLITE_DB_PATH=./data/sqlite.db
 | `MINERU_POLL_INTERVAL` | `2.0`（≥0.5） | 任务轮询间隔 |
 | `MINERU_MAX_WAIT` | `600`（≥10） | 轮询总超时，超时抛 `MinerUError` |
 
-**Marker** → `kit.marker_kit`
+**Marker** → `kit.docs.marker_kit`
 
 | 环境变量 | 默认值 | 作用 |
 |----------|--------|------|
@@ -265,7 +265,7 @@ SQLITE_DB_PATH=./data/sqlite.db
 > `LAYA_HF_*` 同样由 kit 在**导入 laya 之前**经 `os.environ.setdefault` 应用，不覆盖显式配置；
 > `LAYA_MODEL` / `LAYA_DEVICE` 由 `Settings` 读取（进程内缓存，改后需重启进程）。
 
-**云 OCR**（任何 `ocr="hosted"` 的转换）→ `kit.anydoc_kit`
+**云 OCR**（任何 `ocr="hosted"` 的转换）→ `kit.docs.anydoc_kit`
 
 | 环境变量 | 默认值 | 作用 |
 |----------|--------|------|
@@ -295,7 +295,7 @@ SQLITE_DB_PATH=./data/sqlite.db
 | 改动内容 | 生效时机 |
 |----------|----------|
 | `LOG_*`、`DB_*`、`MYSQL_*`、`REDIS_*`、`FILE_STORAGE_ROOT`、`MINERU_*`、`MARKER_MODE` | `get_settings()` 带 `lru_cache`，进程内首次读取后固定 → **重启进程**（或调用 `AI.reload_config()`，它会顺带清空该缓存） |
-| `MARKER_HF_ENDPOINT` / `MARKER_HF_DISABLE_XET` / `MARKER_LLAMA_CPP_BINARY` | 仅在 `import kit.marker_kit` 时经 `os.environ.setdefault` 应用 → 改动需**重启进程**重新导入模块 |
+| `MARKER_HF_ENDPOINT` / `MARKER_HF_DISABLE_XET` / `MARKER_LLAMA_CPP_BINARY` | 仅在 `import kit.docs.marker_kit` 时经 `os.environ.setdefault` 应用 → 改动需**重启进程**重新导入模块 |
 | `LAYA_HF_ENDPOINT` / `LAYA_HF_DISABLE_XET` | 仅在 `import kit.laya_kit` 时经 `os.environ.setdefault` 应用 → 改动需**重启进程**重新导入模块 |
 | AI 密钥写在 `.env` 里 | `.env` 只在加载档案时注入一次 → 重启，或 `AI.reload_config(reload_file=True)` |
 | AI 密钥由自己写入 `os.environ` | `AI.reload_config()`（默认 `reload_file=False`，只重读 `os.environ`） |
@@ -849,12 +849,12 @@ CommonKit.format_current_time("yyyy-MM-dd")
 
 ---
 
-## kit.anydoc_kit —— 文档转 Markdown
+## kit.docs.anydoc_kit —— 文档转 Markdown
 
 安装：`pip install "sdpy-kit[anydoc]"`（支持 `.doc .docx .ppt .pptx .xls .xlsx .csv .pdf`）
 
 ```python
-from kit.anydoc_kit import AnyDocKit
+from kit.docs.anydoc_kit import AnyDocKit
 
 markdown = AnyDocKit.convert_to_md("report.docx")     # 直接转换，失败抛异常
 result = AnyDocKit.convert("report.pdf")              # 安全转换，异常封装为结果对象
@@ -878,12 +878,12 @@ md = AnyDocKit.convert_to_md("scan.pdf", ocr="hosted")  # 需 FIRECRAWL_API_KEY
 
 ---
 
-## kit.docx_kit —— Word 模板动态填充
+## kit.docs.docx_kit —— Word 模板动态填充
 
 安装：`pip install "sdpy-kit[docx]"`
 
 ```python
-from kit.docx_kit import DocxKit, DocxReport, DocxSection, DocxParagraph, DocxTable
+from kit.docs.docx_kit import DocxKit, DocxReport, DocxSection, DocxParagraph, DocxTable
 
 DocxKit.create_template("templates/report.docx", title="{{ title }}")   # 生成模板骨架
 DocxKit.unify_font("templates/report.docx", font_name="宋体")
@@ -917,12 +917,12 @@ DocxKit.render("templates/report.docx", "out/report.docx", report)
 
 ---
 
-## kit.md2doc_kit —— Markdown 转 Word / PDF / HTML
+## kit.docs.md2doc_kit —— Markdown 转 Word / PDF / HTML
 
 安装：`pip install "sdpy-kit[md2doc]"`（PDF 需系统已安装 `mainfont` 指定字体，默认 `SimSun`）
 
 ```python
-from kit.md2doc_kit import Md2DocKit
+from kit.docs.md2doc_kit import Md2DocKit
 
 Md2DocKit.convert_md_to_docx("report.md", "out.docx", generate_toc=True)
 Md2DocKit.convert_md_to_html("report.md", title="项目报告")
@@ -939,12 +939,12 @@ Md2DocKit.convert_md_to_pdf("report.md", mainfont="KaiTi")
 
 ---
 
-## kit.mineru_kit —— MinerU 文档解析
+## kit.docs.mineru_kit —— MinerU 文档解析
 
 安装：`pip install "sdpy-kit[mineru]"`（精准解析需 `MINERU_API_KEY`，Agent 轻量解析免登录）
 
 ```python
-from kit.mineru_kit import MinerUKit
+from kit.docs.mineru_kit import MinerUKit
 
 # 精准解析：公网 URL / 本地文件
 result = MinerUKit.parse_url("https://cdn-mineru.openxlab.org.cn/demo/example.pdf", model_version="vlm")
@@ -971,12 +971,12 @@ if r.state == "done":
 
 ---
 
-## kit.marker_kit —— 本地文档解析（Markdown + Images）
+## kit.docs.marker_kit —— 本地文档解析（Markdown + Images）
 
 安装：`pip install "sdpy-kit[marker]"`（依赖 `marker-pdf[full]`，含 torch 等 80+ 包，体积较大）
 
 ```python
-from kit.marker_kit import MarkerKit
+from kit.docs.marker_kit import MarkerKit
 
 # 落盘 md + images（推荐）：源文件同目录下建同名子目录
 md_path = MarkerKit.convert_to_dir("report.pdf")              # -> report/report.md + 图片

{sdpy_kit-0.4.2 → sdpy_kit-0.4.4}/README.md

@@ -18,11 +18,11 @@ SDPY 统一工具集（Kit 体系），供 Python 项目开箱即用：
 | `kit.redis_kit` | `RedisKit` | Redis string / hash / list / set / zset | `redis` |
 | `kit.file_kit` | `FileKit` | 文件与目录读写、移动、遍历 | 无 |
 | `kit.common_kit` | `CommonKit` | 雪花 ID、时间戳 ID、时间格式化 | 无 |
-| `kit.anydoc_kit` | `AnyDocKit` | docx / pdf / xlsx 等 → Markdown | `anydoc` |
-| `kit.docx_kit` | `DocxKit` | Word 模板动态填充（章节 / 列表 / 表格） | `docx` |
-| `kit.md2doc_kit` | `Md2DocKit` | Markdown → Word / PDF / HTML | `md2doc` |
-| `kit.mineru_kit` | `MinerUKit` | MinerU 文档解析（精准 + Agent 轻量） | `mineru` |
-| `kit.marker_kit` | `MarkerKit` | 本地文档解析（PDF / 图片 / Office → Markdown + Images） | `marker` |
+| `kit.docs.anydoc_kit` | `AnyDocKit` | docx / pdf / xlsx 等 → Markdown | `anydoc` |
+| `kit.docs.docx_kit` | `DocxKit` | Word 模板动态填充（章节 / 列表 / 表格） | `docx` |
+| `kit.docs.md2doc_kit` | `Md2DocKit` | Markdown → Word / PDF / HTML | `md2doc` |
+| `kit.docs.mineru_kit` | `MinerUKit` | MinerU 文档解析（精准 + Agent 轻量） | `mineru` |
+| `kit.docs.marker_kit` | `MarkerKit` | 本地文档解析（PDF / 图片 / Office → Markdown + Images） | `marker` |
 | `kit.laya_kit` | `LayaKit` | 类型化决策：choice / score / noul，返回判断结果 + 置信度 | `laya` |
 | `kit.crawl.article_models` | `ArticleInfo` / `ArticleResult` / `SavedOutput` 等 | 文章抓取通用模型（两 `*ArticleKit` 共用，含 `reason` 分类与非致命 `warnings`） | 无 |
 | `kit.crawl.wx_article_kit` | `WxArticleKit` | 微信公众号文章 → Markdown + 图片转存 | 无 |
@@ -107,7 +107,7 @@ SQLITE_DB_PATH=./data/sqlite.db
 
 ### 环境变量 ↔ 能力对照表
 
-> 表中未出现的模块（`kit.crawl.article_models`、`kit.common_kit`、`kit.docx_kit`、`kit.md2doc_kit`、`kit.crawl.wx_article_kit`、`kit.crawl.web_article_kit`）不读取任何环境变量。
+> 表中未出现的模块（`kit.crawl.article_models`、`kit.common_kit`、`kit.docs.docx_kit`、`kit.docs.md2doc_kit`、`kit.crawl.wx_article_kit`、`kit.crawl.web_article_kit`）不读取任何环境变量。
 
 **基础与日志**（影响 `kit.config` 及所有模块的日志输出）
 
@@ -158,7 +158,7 @@ SQLITE_DB_PATH=./data/sqlite.db
 | `KIT_AI_CHAIN_TIMEOUT` | 未设置 | 全局整链预算（秒）= 门面同步等待上限。⚠ **不是 `Settings` 字段**，由代码直读 `os.environ`，无类型/范围校验，非法值仅告警后回退 |
 | *（密钥，变量名由档案决定）* | 无 | 名字写在 `ai_models.json` 各档案的 `api_key` 字段（如 `SILICONFLOW_API_KEY`），值放 `.env` 或系统环境变量。未配置的档案会被剔除出候选链；该类型全部未配置则调用失败 |
 
-**MinerU** → `kit.mineru_kit`
+**MinerU** → `kit.docs.mineru_kit`
 
 | 环境变量 | 默认值 | 作用 |
 |----------|--------|------|
@@ -169,7 +169,7 @@ SQLITE_DB_PATH=./data/sqlite.db
 | `MINERU_POLL_INTERVAL` | `2.0`（≥0.5） | 任务轮询间隔 |
 | `MINERU_MAX_WAIT` | `600`（≥10） | 轮询总超时，超时抛 `MinerUError` |
 
-**Marker** → `kit.marker_kit`
+**Marker** → `kit.docs.marker_kit`
 
 | 环境变量 | 默认值 | 作用 |
 |----------|--------|------|
@@ -192,7 +192,7 @@ SQLITE_DB_PATH=./data/sqlite.db
 > `LAYA_HF_*` 同样由 kit 在**导入 laya 之前**经 `os.environ.setdefault` 应用，不覆盖显式配置；
 > `LAYA_MODEL` / `LAYA_DEVICE` 由 `Settings` 读取（进程内缓存，改后需重启进程）。
 
-**云 OCR**（任何 `ocr="hosted"` 的转换）→ `kit.anydoc_kit`
+**云 OCR**（任何 `ocr="hosted"` 的转换）→ `kit.docs.anydoc_kit`
 
 | 环境变量 | 默认值 | 作用 |
 |----------|--------|------|
@@ -222,7 +222,7 @@ SQLITE_DB_PATH=./data/sqlite.db
 | 改动内容 | 生效时机 |
 |----------|----------|
 | `LOG_*`、`DB_*`、`MYSQL_*`、`REDIS_*`、`FILE_STORAGE_ROOT`、`MINERU_*`、`MARKER_MODE` | `get_settings()` 带 `lru_cache`，进程内首次读取后固定 → **重启进程**（或调用 `AI.reload_config()`，它会顺带清空该缓存） |
-| `MARKER_HF_ENDPOINT` / `MARKER_HF_DISABLE_XET` / `MARKER_LLAMA_CPP_BINARY` | 仅在 `import kit.marker_kit` 时经 `os.environ.setdefault` 应用 → 改动需**重启进程**重新导入模块 |
+| `MARKER_HF_ENDPOINT` / `MARKER_HF_DISABLE_XET` / `MARKER_LLAMA_CPP_BINARY` | 仅在 `import kit.docs.marker_kit` 时经 `os.environ.setdefault` 应用 → 改动需**重启进程**重新导入模块 |
 | `LAYA_HF_ENDPOINT` / `LAYA_HF_DISABLE_XET` | 仅在 `import kit.laya_kit` 时经 `os.environ.setdefault` 应用 → 改动需**重启进程**重新导入模块 |
 | AI 密钥写在 `.env` 里 | `.env` 只在加载档案时注入一次 → 重启，或 `AI.reload_config(reload_file=True)` |
 | AI 密钥由自己写入 `os.environ` | `AI.reload_config()`（默认 `reload_file=False`，只重读 `os.environ`） |
@@ -776,12 +776,12 @@ CommonKit.format_current_time("yyyy-MM-dd")
 
 ---
 
-## kit.anydoc_kit —— 文档转 Markdown
+## kit.docs.anydoc_kit —— 文档转 Markdown
 
 安装：`pip install "sdpy-kit[anydoc]"`（支持 `.doc .docx .ppt .pptx .xls .xlsx .csv .pdf`）
 
 ```python
-from kit.anydoc_kit import AnyDocKit
+from kit.docs.anydoc_kit import AnyDocKit
 
 markdown = AnyDocKit.convert_to_md("report.docx")     # 直接转换，失败抛异常
 result = AnyDocKit.convert("report.pdf")              # 安全转换，异常封装为结果对象
@@ -805,12 +805,12 @@ md = AnyDocKit.convert_to_md("scan.pdf", ocr="hosted")  # 需 FIRECRAWL_API_KEY
 
 ---
 
-## kit.docx_kit —— Word 模板动态填充
+## kit.docs.docx_kit —— Word 模板动态填充
 
 安装：`pip install "sdpy-kit[docx]"`
 
 ```python
-from kit.docx_kit import DocxKit, DocxReport, DocxSection, DocxParagraph, DocxTable
+from kit.docs.docx_kit import DocxKit, DocxReport, DocxSection, DocxParagraph, DocxTable
 
 DocxKit.create_template("templates/report.docx", title="{{ title }}")   # 生成模板骨架
 DocxKit.unify_font("templates/report.docx", font_name="宋体")
@@ -844,12 +844,12 @@ DocxKit.render("templates/report.docx", "out/report.docx", report)
 
 ---
 
-## kit.md2doc_kit —— Markdown 转 Word / PDF / HTML
+## kit.docs.md2doc_kit —— Markdown 转 Word / PDF / HTML
 
 安装：`pip install "sdpy-kit[md2doc]"`（PDF 需系统已安装 `mainfont` 指定字体，默认 `SimSun`）
 
 ```python
-from kit.md2doc_kit import Md2DocKit
+from kit.docs.md2doc_kit import Md2DocKit
 
 Md2DocKit.convert_md_to_docx("report.md", "out.docx", generate_toc=True)
 Md2DocKit.convert_md_to_html("report.md", title="项目报告")
@@ -866,12 +866,12 @@ Md2DocKit.convert_md_to_pdf("report.md", mainfont="KaiTi")
 
 ---
 
-## kit.mineru_kit —— MinerU 文档解析
+## kit.docs.mineru_kit —— MinerU 文档解析
 
 安装：`pip install "sdpy-kit[mineru]"`（精准解析需 `MINERU_API_KEY`，Agent 轻量解析免登录）
 
 ```python
-from kit.mineru_kit import MinerUKit
+from kit.docs.mineru_kit import MinerUKit
 
 # 精准解析：公网 URL / 本地文件
 result = MinerUKit.parse_url("https://cdn-mineru.openxlab.org.cn/demo/example.pdf", model_version="vlm")
@@ -898,12 +898,12 @@ if r.state == "done":
 
 ---
 
-## kit.marker_kit —— 本地文档解析（Markdown + Images）
+## kit.docs.marker_kit —— 本地文档解析（Markdown + Images）
 
 安装：`pip install "sdpy-kit[marker]"`（依赖 `marker-pdf[full]`，含 torch 等 80+ 包，体积较大）
 
 ```python
-from kit.marker_kit import MarkerKit
+from kit.docs.marker_kit import MarkerKit
 
 # 落盘 md + images（推荐）：源文件同目录下建同名子目录
 md_path = MarkerKit.convert_to_dir("report.pdf")              # -> report/report.md + 图片

{sdpy_kit-0.4.2 → sdpy_kit-0.4.4}/kit/__init__.py

@@ -23,7 +23,7 @@ Author: Clark Chang
 数据库访问通过 kit.db 子包提供（基于 SQLModel）。
 """
 
-__version__ = "0.4.2"
+__version__ = "0.4.4"
 
 from kit.db import (
     MYSQL,

sdpy_kit-0.4.4/kit/docs/__init__.py

@@ -0,0 +1,32 @@
+"""
+Copyright (c) 2021-2026 Clark Chang. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+Project: sdpy
+Author: Clark Chang
+"""
+
+# date: 2026-10-16
+"""文档格式转换子包——文档解析 / 渲染 / 模板填充工具集
+
+成员（均按需 import，各自绑定独立 extras，缺依赖时模块顶层报错并提示安装命令）：
+- anydoc_kit:  AnyDocKit   文档转 Markdown（firecrawl-anydoc，extra: anydoc）
+- md2doc_kit:  Md2DocKit   Markdown 转 Word/PDF/HTML（pimd，extra: md2doc）
+- docx_kit:    DocxKit     Word 模板动态填充（docxtpl，extra: docx）
+- mineru_kit:  MinerUKit   MinerU 文档解析 API（requests，extra: mineru）
+- marker_kit:  MarkerKit   Marker 本地文档解析（marker-pdf，extra: marker）
+
+本 __init__ 不导入任何成员：五个模块均携带重型可选依赖，保持
+`import kit.docs` 在基础安装下零成本可用（对齐 kit.crawl 先例）。
+"""

{sdpy_kit-0.4.2/kit → sdpy_kit-0.4.4/kit/docs}/anydoc_kit.py

@@ -22,7 +22,7 @@ Author: Clark Chang
 
 本模块封装 firecrawl-anydoc（pip 安装名 firecrawl-anydoc，import 名 anydoc），
 将 Word、PowerPoint、Excel、CSV、PDF 格式统一转为 GitHub-Flavored Markdown；
-Markdown → Word/HTML/PDF 的反向转换见 kit.md2doc_kit（Md2DocKit）。
+Markdown → Word/HTML/PDF 的反向转换见 kit.docs.md2doc_kit（Md2DocKit）。
 
 设计要点：
 - 全部使用静态方法提供服务，无内部状态。
@@ -183,7 +183,7 @@ class AnyDocKit:
         # 5. 字节内容转换（无需落盘）
         md = AnyDocKit.convert_bytes_to_md(file_bytes, "csv")
 
-    Markdown → Word/PDF/HTML 的反向转换见 kit.md2doc_kit（Md2DocKit）。
+    Markdown → Word/PDF/HTML 的反向转换见 kit.docs.md2doc_kit（Md2DocKit）。
 
     可与 FileKit 组合使用以访问 FILE_STORAGE_ROOT 下的相对路径文件：
         full_path = FileKit.get_full_path("docs/report.docx")

{sdpy_kit-0.4.2/kit → sdpy_kit-0.4.4/kit/docs}/marker_kit.py

@@ -22,9 +22,9 @@ Author: Clark Chang
 
 本模块基于 marker-pdf（Marker v2.x，https://github.com/datalab-to/marker），
 在本地解析 PDF / 图片 / Office / HTML / EPUB，输出 GitHub-Flavored Markdown
-并提取图片，产物形态对齐 kit.mineru_kit 的「md + images」。
+并提取图片，产物形态对齐 kit.docs.mineru_kit 的「md + images」。
 
-与 kit.anydoc_kit 的分工：
+与 kit.docs.anydoc_kit 的分工：
 - AnyDocKit：轻量文本转换（firecrawl-anydoc），只产出 Markdown 文本；
 - MarkerKit：本地模型解析，产出 md + 图片，质量更高但依赖重（torch 等）。
 
@@ -144,7 +144,7 @@ class MarkerKit:
     """Marker 本地文档解析工具类，将文档转为 Markdown + Images
 
     支持 PDF、图片、Office（docx/pptx/xlsx）、HTML、EPUB，产物形态对齐
-    kit.mineru_kit（md + 图片落盘于同一目录，md 以相对路径引用图片）。
+    kit.docs.mineru_kit（md + 图片落盘于同一目录，md 以相对路径引用图片）。
 
     使用前安装可选依赖::
 

{sdpy_kit-0.4.2/kit → sdpy_kit-0.4.4/kit/docs}/md2doc_kit.py

@@ -22,7 +22,7 @@ Author: Clark Chang
 
 本模块基于 PiMD（pimd >= 2.2.5）将 Markdown 转换为 Word（.docx）与独立
 HTML；PDF 由本模块内嵌的 fpdf2 渲染器直接生成，保证中文与表格完整。
-各类文档（Office/PDF）→ Markdown 的正向解析见 kit.anydoc_kit（AnyDocKit）。
+各类文档（Office/PDF）→ Markdown 的正向解析见 kit.docs.anydoc_kit（AnyDocKit）。
 
 设计要点：
 - 全部使用静态方法提供服务，无内部状态；PiMD 转换引擎为模块级单例，按进程
@@ -1056,7 +1056,7 @@ class Md2DocKit:
     convert_md_to_pdf 方法说明）；需要 PDF 时优先用 convert_md_to_html
     后在浏览器中打印/另存 PDF，或 convert_md_to_docx 后在 Word 中另存 PDF。
 
-    各类文档（Office/PDF）→ Markdown 的正向解析见 kit.anydoc_kit（AnyDocKit）。
+    各类文档（Office/PDF）→ Markdown 的正向解析见 kit.docs.anydoc_kit（AnyDocKit）。
     可与 FileKit 组合使用以访问 FILE_STORAGE_ROOT 下的相对路径文件：
         full_path = FileKit.get_full_path("docs/report.md")
         Md2DocKit.convert_md_to_html(full_path)

{sdpy_kit-0.4.2 → sdpy_kit-0.4.4}/kit/license_kit.py

@@ -23,9 +23,9 @@ Author: Clark Chang
 面向单机分发场景的轻量授权体系（防君子定位）：应用以打包 exe 形式离线分发，
 无远端授权服务。工作流：
 
-1. 客户机 `export_fingerprint_file()` 导出 `.fp` 指纹文件；
-2. 签发方 `parse_fingerprint_file()` 解析，填入 `LicensePayload` 后
-   `sign()` 生成 `.lic` 授权文件回签；
+1. 客户机 `LicenseKit.export_fingerprint_file()` 导出 `.fp` 指纹文件；
+2. 签发方 `LicenseKit.parse_fingerprint_file()` 解析，填入 `LicensePayload`
+   后 `LicenseKit.sign()` 生成 `.lic` 授权文件回签；
 3. 客户机 `LicenseVerifier.verify()` 验签 + 绑定校验（product / 机器码 / 有效期）。
 
 安全边界（务必知悉）：
@@ -41,19 +41,20 @@ Author: Clark Chang
 规范化 JSON 序列化后签名，杜绝字段顺序 / 空白差异导致验签漂移。
 
 用法：
-    from kit.license_kit import (
-        LicensePayload, LicenseVerifier, export_fingerprint_file,
-        generate_keypair, parse_fingerprint_file, sign,
-    )
+    from kit.license_kit import LicenseKit, LicensePayload, LicenseVerifier
 
-    private_pem, public_pem = generate_keypair()
+    private_pem, public_pem = LicenseKit.generate_keypair()
     payload = LicensePayload(product="myapp", machine_code="0123456789abcdef",
                              issued_at=datetime.now(timezone.utc),
                              expires_at=None)
-    lic_text = sign(payload, private_pem)
+    lic_text = LicenseKit.sign(payload, private_pem)
 
     verifier = LicenseVerifier(public_pem, Path("license.lic"))
     info = verifier.verify(product="myapp", machine_code="0123456789abcdef")
+
+形态说明：0.4.2 为模块级函数，0.4.3 起收进静态工具类 `LicenseKit`
+（与 FileKit / LayaKit 等其它 kit 形态一致）；`LicenseVerifier` 因持有
+公钥缓存与验签上下文实例状态，保持独立类。
 """
 
 import base64
@@ -125,7 +126,7 @@ class LicenseExpiredError(LicenseError):
 
 
 # ---------------------------------------------------------------------------
-# 机器指纹（Windows 专属；winreg/ctypes 延迟导入保证模块可在任意平台 import）
+# 机器指纹私有实现（Windows 专属；winreg/ctypes 延迟导入保证模块任意平台可 import）
 # ---------------------------------------------------------------------------
 
 
@@ -175,118 +176,14 @@ def _collect_components() -> tuple[str, str]:
     return _read_machine_guid(), _read_volume_serial()
 
 
-def get_machine_code() -> str:
-    """计算本机机器码：组合指纹 SHA256 短码（16 hex 小写）
-
-    Returns:
-        str: 16 位十六进制机器码
-
-    Raises:
-        LicenseUnsupportedPlatformError: 非 Windows 平台
-        LicenseFormatError: 指纹组件读取失败
-    """
-    machine_guid, volume_serial = _collect_components()
+def _machine_code_of(machine_guid: str, volume_serial: str) -> str:
+    """由原始组件计算机器码短码（签发与导出共用，避免两处公式漂移）"""
     digest = hashlib.sha256(f"{machine_guid}|{volume_serial}".encode("utf-8"))
     return digest.hexdigest()[:MACHINE_CODE_LENGTH]
 
 
-def export_fingerprint_file(path: Path) -> Path:
-    """导出指纹文件（.fp）：机器码 + 原始组件 + 导出时间
-
-    原始组件仅用于报障诊断（作者侧可看出哪个组件不匹配），验签只比短码。
-
-    Args:
-        path: 指纹文件输出路径
-
-    Returns:
-        Path: 实际写入的文件路径
-
-    Raises:
-        LicenseUnsupportedPlatformError: 非 Windows 平台
-        LicenseFormatError: 指纹组件读取失败
-    """
-    machine_guid, volume_serial = _collect_components()
-    machine_code = hashlib.sha256(
-        f"{machine_guid}|{volume_serial}".encode("utf-8")
-    ).hexdigest()[:MACHINE_CODE_LENGTH]
-    document = {
-        "kind": _FINGERPRINT_KIND,
-        "format_version": FINGERPRINT_FORMAT_VERSION,
-        "machine_code": machine_code,
-        "components": {
-            "machine_guid": machine_guid,
-            "volume_serial": volume_serial,
-        },
-        "exported_at": datetime.now(timezone.utc).isoformat(),
-    }
-    target = Path(path)
-    target.parent.mkdir(parents=True, exist_ok=True)
-    target.write_text(
-        json.dumps(document, ensure_ascii=False, indent=2), encoding="utf-8"
-    )
-    logger.info("指纹文件已导出：%s（机器码 %s）", target, machine_code)
-    return target
-
-
-def parse_fingerprint_file(path: Path) -> str:
-    """解析指纹文件，返回机器码（签发侧使用；跨机器无法重算原文，只校验结构）
-
-    Args:
-        path: 指纹文件路径
-
-    Returns:
-        str: 16 位十六进制机器码
-
-    Raises:
-        LicenseFormatError: 文件缺失 / JSON 损坏 / 标识或版本不符 / 机器码格式非法
-    """
-    source = Path(path)
-    if not source.is_file():
-        raise LicenseFormatError(f"指纹文件不存在：{source}")
-    try:
-        document = json.loads(source.read_text(encoding="utf-8"))
-    except (OSError, json.JSONDecodeError) as exc:
-        raise LicenseFormatError(f"指纹文件读取或解析失败：{exc}") from exc
-    if not isinstance(document, dict):
-        raise LicenseFormatError("指纹文件结构不合法（顶层应为 JSON 对象）")
-    if document.get("kind") != _FINGERPRINT_KIND:
-        raise LicenseFormatError("指纹文件标识不符（kind）")
-    version = document.get("format_version")
-    if not isinstance(version, int) or version > FINGERPRINT_FORMAT_VERSION:
-        raise LicenseFormatError(f"指纹文件格式版本不识别：{version!r}")
-    machine_code = document.get("machine_code")
-    if not isinstance(machine_code, str) or not _HEX16_RE.fullmatch(machine_code):
-        raise LicenseFormatError("指纹文件缺少合法机器码（16 hex）")
-    return machine_code
-
-
-# ---------------------------------------------------------------------------
-# 密钥
-# ---------------------------------------------------------------------------
-
-
-def generate_keypair() -> tuple[str, str]:
-    """生成 Ed25519 密钥对（一次性初始化用）
-
-    Returns:
-        tuple[str, str]: (private_pem, public_pem)，均为 PEM 文本；
-            私钥务必本机妥善保管（丢失 = 已发授权全部作废）
-    """
-    private_key = Ed25519PrivateKey.generate()
-    private_pem = private_key.private_bytes(
-        encoding=serialization.Encoding.PEM,
-        format=serialization.PrivateFormat.PKCS8,
-        encryption_algorithm=serialization.NoEncryption(),
-    ).decode("utf-8")
-    public_pem = private_key.public_key().public_bytes(
-        encoding=serialization.Encoding.PEM,
-        format=serialization.PublicFormat.SubjectPublicKeyInfo,
-    ).decode("utf-8")
-    return private_pem, public_pem
-
-
 # ---------------------------------------------------------------------------
-# 载荷与签名（格式唯一事实源——签发与验签共用本模块实现）
+# 载荷（签发与验签共用）
 # ---------------------------------------------------------------------------
 
 
@@ -340,39 +237,149 @@ def _canonical_bytes(payload: dict) -> bytes:
     ).encode("utf-8")
 
 
-def sign(payload: LicensePayload, private_key_pem: str) -> str:
-    """对载荷签名，返回 license 文件内容（JSON 文本，即 .lic）
+# ---------------------------------------------------------------------------
+# 静态工具类（与其它 kit 形态一致；格式唯一事实源——签发与验签共用本模块实现）
+# ---------------------------------------------------------------------------
 
-    Args:
-        payload: 授权载荷
-        private_key_pem: Ed25519 私钥 PEM（PKCS8）
 
-    Returns:
-        str: license 文件内容 `{"payload": {...}, "signature": "<b64>"}`
+class LicenseKit:
+    """license 授权静态工具类：指纹、密钥、签发"""
 
-    Raises:
-        LicenseFormatError: 私钥解析失败或类型不是 Ed25519
-    """
-    try:
-        private_key = serialization.load_pem_private_key(
-            private_key_pem.encode("utf-8"), password=None
+    @staticmethod
+    def get_machine_code() -> str:
+        """计算本机机器码：组合指纹 SHA256 短码（16 hex 小写）
+
+        Returns:
+            str: 16 位十六进制机器码
+
+        Raises:
+            LicenseUnsupportedPlatformError: 非 Windows 平台
+            LicenseFormatError: 指纹组件读取失败
+        """
+        machine_guid, volume_serial = _collect_components()
+        return _machine_code_of(machine_guid, volume_serial)
+
+    @staticmethod
+    def export_fingerprint_file(path: Path) -> Path:
+        """导出指纹文件（.fp）：机器码 + 原始组件 + 导出时间
+
+        原始组件仅用于报障诊断（作者侧可看出哪个组件不匹配），验签只比短码。
+
+        Args:
+            path: 指纹文件输出路径
+
+        Returns:
+            Path: 实际写入的文件路径
+
+        Raises:
+            LicenseUnsupportedPlatformError: 非 Windows 平台
+            LicenseFormatError: 指纹组件读取失败
+        """
+        machine_guid, volume_serial = _collect_components()
+        document = {
+            "kind": _FINGERPRINT_KIND,
+            "format_version": FINGERPRINT_FORMAT_VERSION,
+            "machine_code": _machine_code_of(machine_guid, volume_serial),
+            "components": {
+                "machine_guid": machine_guid,
+                "volume_serial": volume_serial,
+            },
+            "exported_at": datetime.now(timezone.utc).isoformat(),
+        }
+        target = Path(path)
+        target.parent.mkdir(parents=True, exist_ok=True)
+        target.write_text(
+            json.dumps(document, ensure_ascii=False, indent=2), encoding="utf-8"
         )
-    except (ValueError, TypeError) as exc:
-        raise LicenseFormatError(f"私钥 PEM 解析失败：{exc}") from exc
-    if not isinstance(private_key, Ed25519PrivateKey):
-        raise LicenseFormatError("私钥类型不是 Ed25519")
-    payload_dict = payload.model_dump(mode="json")
-    signature = private_key.sign(_canonical_bytes(payload_dict))
-    document = {
-        "payload": payload_dict,
-        "signature": base64.b64encode(signature).decode("ascii"),
-    }
-    logger.info(
-        "license 已签发：product=%s machine_code=%s",
-        payload.product,
-        payload.machine_code,
-    )
-    return json.dumps(document, ensure_ascii=False, indent=2)
+        logger.info("指纹文件已导出：%s（机器码 %s）", target, document["machine_code"])
+        return target
+
+    @staticmethod
+    def parse_fingerprint_file(path: Path) -> str:
+        """解析指纹文件，返回机器码（签发侧使用；跨机器无法重算原文，只校验结构）
+
+        Args:
+            path: 指纹文件路径
+
+        Returns:
+            str: 16 位十六进制机器码
+
+        Raises:
+            LicenseFormatError: 文件缺失 / JSON 损坏 / 标识或版本不符 / 机器码格式非法
+        """
+        source = Path(path)
+        if not source.is_file():
+            raise LicenseFormatError(f"指纹文件不存在：{source}")
+        try:
+            document = json.loads(source.read_text(encoding="utf-8"))
+        except (OSError, json.JSONDecodeError) as exc:
+            raise LicenseFormatError(f"指纹文件读取或解析失败：{exc}") from exc
+        if not isinstance(document, dict):
+            raise LicenseFormatError("指纹文件结构不合法（顶层应为 JSON 对象）")
+        if document.get("kind") != _FINGERPRINT_KIND:
+            raise LicenseFormatError("指纹文件标识不符（kind）")
+        version = document.get("format_version")
+        if not isinstance(version, int) or version > FINGERPRINT_FORMAT_VERSION:
+            raise LicenseFormatError(f"指纹文件格式版本不识别：{version!r}")
+        machine_code = document.get("machine_code")
+        if not isinstance(machine_code, str) or not _HEX16_RE.fullmatch(machine_code):
+            raise LicenseFormatError("指纹文件缺少合法机器码（16 hex）")
+        return machine_code
+
+    @staticmethod
+    def generate_keypair() -> tuple[str, str]:
+        """生成 Ed25519 密钥对（一次性初始化用）
+
+        Returns:
+            tuple[str, str]: (private_pem, public_pem)，均为 PEM 文本；
+                私钥务必本机妥善保管（丢失 = 已发授权全部作废）
+        """
+        private_key = Ed25519PrivateKey.generate()
+        private_pem = private_key.private_bytes(
+            encoding=serialization.Encoding.PEM,
+            format=serialization.PrivateFormat.PKCS8,
+            encryption_algorithm=serialization.NoEncryption(),
+        ).decode("utf-8")
+        public_pem = private_key.public_key().public_bytes(
+            encoding=serialization.Encoding.PEM,
+            format=serialization.PublicFormat.SubjectPublicKeyInfo,
+        ).decode("utf-8")
+        return private_pem, public_pem
+
+    @staticmethod
+    def sign(payload: LicensePayload, private_key_pem: str) -> str:
+        """对载荷签名，返回 license 文件内容（JSON 文本，即 .lic）
+
+        Args:
+            payload: 授权载荷
+            private_key_pem: Ed25519 私钥 PEM（PKCS8）
+
+        Returns:
+            str: license 文件内容 `{"payload": {...}, "signature": "<b64>"}`
+
+        Raises:
+            LicenseFormatError: 私钥解析失败或类型不是 Ed25519
+        """
+        try:
+            private_key = serialization.load_pem_private_key(
+                private_key_pem.encode("utf-8"), password=None
+            )
+        except (ValueError, TypeError) as exc:
+            raise LicenseFormatError(f"私钥 PEM 解析失败：{exc}") from exc
+        if not isinstance(private_key, Ed25519PrivateKey):
+            raise LicenseFormatError("私钥类型不是 Ed25519")
+        payload_dict = payload.model_dump(mode="json")
+        signature = private_key.sign(_canonical_bytes(payload_dict))
+        document = {
+            "payload": payload_dict,
+            "signature": base64.b64encode(signature).decode("ascii"),
+        }
+        logger.info(
+            "license 已签发：product=%s machine_code=%s",
+            payload.product,
+            payload.machine_code,
+        )
+        return json.dumps(document, ensure_ascii=False, indent=2)
 
 
 # ---------------------------------------------------------------------------
@@ -445,7 +452,7 @@ class LicenseVerifier:
 
         Args:
             product: 期望的应用标识
-            machine_code: 期望的机器码（本机 `get_machine_code()` 结果）
+            machine_code: 期望的机器码（本机 `LicenseKit.get_machine_code()` 结果）
             now: 判定"当前时间"；None 取 aware UTC 当前时刻；naive 按 UTC 处理
 
         Returns:

{sdpy_kit-0.4.2 → sdpy_kit-0.4.4}/pyproject.toml

@@ -47,11 +47,11 @@ dynamic = ["version"]
 #   sqliteai → sqlite_kit 向量方法（numpy/sqliteai-vector，向量扩展）
 #   redis  → redis_kit
 #   ai     → kit/ai 服务池（httpx；dotenv 由 kit.ai 直接 import，故显式声明）
-#   md2doc → md2doc_kit（pimd/markdown-it-py，fpdf2；extra 名与模块名一致）
-#   anydoc → anydoc_kit（firecrawl-anydoc + pikepdf，显式声明）
-#   docx   → docx_kit（docxtpl + python-docx，模板动态填充）
-#   mineru → mineru_kit（requests）
-#   marker → marker_kit（marker-pdf[full]，本地模型解析 PDF→Markdown+Images）
+#   md2doc → kit.docs.md2doc_kit（pimd/markdown-it-py，fpdf2；extra 名沿用模块族名）
+#   anydoc → kit.docs.anydoc_kit（firecrawl-anydoc + pikepdf，显式声明）
+#   docx   → kit.docs.docx_kit（docxtpl + python-docx，模板动态填充）
+#   mineru → kit.docs.mineru_kit（requests）
+#   marker → kit.docs.marker_kit（marker-pdf[full]，本地模型解析 PDF→Markdown+Images）
 #   laya   → laya_kit（laya + torch，本地类型化决策引擎 choice/score/noul）
 #   web-article → crawl/web_article_kit（trafilatura，通用网页文章抓取转存）
 # 基础版 = config/log + kit.db 核心，SQLite 常规操作用标准库 sqlite3，零额外依赖。