文档转换 技术标准
C:/Users/xub/.workbuddy/skills/V1.0.0_lihengbian_DIY_文档转换/SKILL.md）重新组织，
不新增任何规范要求；每一层、每个节点均可回溯到源章节。原归档件（09-18 版）见文末对照。
前言
本文件为「文档转换」在现役版本 V1.0.0 下的技术标准载体，按《全域任务脑手架构宪法》第 17–23 条规定的六层主干组织， 效力层级为行政法规（skill 载体）。
本文件的上位法为《全域任务脑手架构宪法》与《全域文件体系基本法》；凡本文件出现的义务性表述，其唯一效力来源均为所标注的宪法条号与源章节，本文件不写宪法未规定者。
本文件替代 2026-09-18 归档版（无归档），差异根源是载体已由 V— 迭代至 V1.0.0。
1 范围
本文件规定了「文档转换」（V1.0.0）的术语和定义、工作流架构、技术要求、校验方法与交付要件。
利衡辨_DIY_文档转换 V1.0.0 — 通用文档转 Markdown 统一转换引擎（MarkItDown 风格）。把 PDF、DOCX/DOC、PPTX/PPT、XLSX/XLS/CSV、图片、音频、视频、网页 URL、EPUB、代码、压缩包、邮件、Notebook、SQLite、SVG、日志等任意格式，统一转为带 YAML frontmatter 与处理附录的 GFM；支持多文件与压缩包递归合并为单个 MD；内置 PII 脱敏与路径遍历/XXE/SSRF 硬拦截；DeepSeek 用于图片 OCR 与多模态描述（需 DEEPSEEK_API_KEY）。触发词：转成 Markdown、转 MD、提取 PDF/Word/Excel/PPT 内容、批量文档转 Markdown、MarkItDown、文档转换。
本文件适用于该载体的加载、执行、返工、验收与升级迭代全过程。
2 规范性引用文件
- 《全域任务脑手架构宪法》—— 管任务链路（上位法）
- 《全域文件体系基本法》—— 管文件（上位法）
- 《全域工作流行政法规》—— 管工作流（同级上位）
- GB/T 1.1-2020 标准化工作导则 第 1 部分：标准化文件的结构和起草规则
3 术语和定义
下列术语和定义适用于本文件。六层主干的定义由宪法第 17 条规定，本文件直接引用。
3.1 脑（K3）
负责定标、裁决、诊断与留痕，不施工。
3.2 手（DeepSeek）
按脑下发的标准施工、返工与落盘，不定标。
3.3 本地机械闸
零 Token 校验实体，退出码非零禁止交付，不自备标准。
3.4 人
负责确认、放行与宣布；闭环宣布权留人。
3.5 六层主干
宪法第 17 条规定的架构主干，由 A 入口层至 F 终结层六级构成。
3.6 一进一出
每个任务一次进入、一次交付，不并发多形态产出。
4 工作流架构
本章按宪法第 18–23 条逐层给出本载体的承载节点。共 4 个节点，层序与条号严格对齐；每层节点均标注源章节，可逐条回查。
- 本载体在本层无独立声明，随上下层执行。
- 出稿版式（母版升版 V1.2.0 · 2026-10-16 · 炳哥定标方案乙）（源 §出稿版式（母版升版 V1.2.0 ·）
- 隐私与安全（源 §隐私与安全）
- 工作流程（源 §工作流程）
- 输出硬规范（源 §输出硬规范）
- 本载体在本层无独立声明，随上下层执行。
5 技术要求
本章汇集载体的定标性要求（脑层节点），全部来自源章节，未作增补。
本载体未在源章节中声明独立的定标性要求，技术要求随脑层节点执行。
6 校验方法
本章给出载体自带的机械校验点（安全与权限层）。退出码非零即禁止交付。
隐私与安全
- PII 强制脱敏：身份证号、手机号、邮箱、银行卡/信用卡号（Luhn 校验降误判）、IPv4/IPv6 → [PII_REDACTED]；--no-redact 可关闭。
- 硬拦截：路径遍历（..）、XXE（<!ENTITY> / DOCTYPE / SYSTEM）、SSRF（10/172.16-31/192.168/127/169.254 等内网段）、zip-slip、非 HTTPS UR
- 临时文件在 finally 中清理；外部命令一律 shell=False 且默认不启用（仅显式配置 MARKITDOWN_ASR_CMD 时才调用 ASR）。
- 压缩包限制：递归深度 3、单包 50 文件、总体积 200MB。
7 交付要件
本章规定交付物形态、命名与落盘要求，逐条对应源章节。
输出硬规范
- 标题层级 #~######；表格必须有 |---|---| 分隔行；列表嵌套缩进统一 4 空格。
- 代码块自动标注语言（置信度 > 0.7 才标注）；章节分隔 --- 连续不超过 3 次。
- 支持 GitHub 警告块 > [!NOTE] / [!WARNING] / [!IMPORTANT] / [!CAUTION] / [!TIP]。
- 固定顺序：YAML frontmatter → 主体内容 → 处理附录。
- frontmatter 字段：source、format、converted_at、converter、degraded、pii_redacted，
- 处理附录：OCR（引擎与置信度说明）、耗时统计（秒）、跳过元素、抽取文件清单、已处理输入。
附录 A（规范性）六层主干与宪法条号对照
| 层 | 层名 | 宪法条号 | 承担角色 | 本载体节点数 |
|---|---|---|---|---|
| A | 入口层 | 第18条 | 人（确认放行） | 0 |
| B | 编排层_脑_K3 | 第19条 | 脑（K3） | 1 |
| C | 安全与权限层 | 第20条 | 本地机械闸 | 1 |
| D | 执行层_手 | 第21条 | 手（DeepSeek） | 1 |
| E | 交付与验收层 | 第22条 | 人 · 闸 · 混合 | 1 |
| F | 终结层 | 第23条 | 混合（跨角色） | 0 |
| 合计 | 4 | |||
附录 B（资料性）载体源清单
| 项目 | 内容 |
|---|---|
| 现役载体目录 | C:/Users/xub/.workbuddy/skills/V1.0.0_lihengbian_DIY_文档转换 |
| 现役版本 | V1.0.0 |
| 源说明文件 | C:/Users/xub/.workbuddy/skills/V1.0.0_lihengbian_DIY_文档转换/SKILL.md |
| 载体文件总数 | 19 |
| 标准数库归档批 | 2026-09-18 批（技能族 35 份 / 专家族 4 份，全域同批同日） |
| 归档案与现役的关系 | 归档件按现役版本之前的载体编制；本件为按现役载体重生版，二者不互相替代 |
| 原名对照 | 归档批以拼音缩写命名，与中文名不完全对应 |
附录 C（资料性）未纳入六层的源章节
下列章节不对应宪法第 18–23 条的任何一层，原文保留于载体，此处仅登记不归类。
- Overview
- 触发条件
- 前置条件
- 脚本用法
- 降级与失败反馈
- 各格式核心规则
- 可选依赖（缺失自动降级，非必需）
- Resources
- 体裁归属排除清单（G28 §10 · 2026-10-16 炳哥定案）
宪法 ＞ 基本法 ＞ 行政法规 ＞ 地方法规 ＞ 地方规章