markitdown-skill

MarkItDown Skill

中文主体补充：AI_Projects / SKILL.md

本文件属于公开技能 AI_Projects。本节为中文主体补充说明，目标是让中文读者在不依赖英文背景的情况下，理解本文件的作用、阅读路径、关键约束和验收标准。 本文件的相对路径是 markitdown-skill/SKILL.md，属于 AI_Projects 的参考/工作流/模板/脚本/资产之一。 使用方法：先看本中文主体补充；再按需进入下方原始英文细则、表格、清单、JSON、代码或命令；最后按验收要点核对产物。 中文部分只做解释，不替换、不重写、不翻译任何原始字段名、参数名、命令名、文件名、URL、环境变量、JSON/YAML 键、表格技术列头、模板占位或代码块。 公开共享要求：不得写入本机绝对路径、个人目录、账号标识、真实密钥、临时下载目录或过细来源索引；如出现必须替换为 [REDACTED] 或抽象描述。 安全边界：所有脚本执行前必须确认运行环境、依赖、当前工作目录和输出路径；执行后用 ls/cat/grep/校验脚本核对。 若与同技能下 SKILL.md 冲突，以 SKILL.md 的目标、约束和验收标准为准；若与子工作流、子模板冲突，按本节约定的约束优先级处理。 涉及任何投资、法律、医疗等专业建议时，必须保留“不构成专业建议”声明，并以最新公告、最新法规为依据。

适用范围与读者

本文件的目标读者包括：通用 AI 助手、内容创作者、设计师、研发人员，以及需要把研究材料、规则说明或工程数据转成可复现产物的使用者。 若用户只是要快速回答问题而不是真正执行工具，可只阅读本中文主体补充；不要为了显得专业而翻译原始字段、参数或命令。 若用户提供了额外的输入材料（截图、URL、表格、PDF、CSV、JSON），请把材料当作当前任务上下文，不要写入本文件以免污染其他使用者的环境。 若用户要求长期保存某些配置或脚手架，建议放到个人或团队的私有 skill；本公开文件不应承载私有配置。

阅读顺序与执行节奏

1. 阅读本中文主体补充，确认任务类型、阅读路径、关键约束、关键风险。
2. 浏览下方 H2/H3 英文标题，挑出与当前任务相关的章节。
3. 阅读这些章节时保留所有命令、参数、字段、模板、代码块。
4. 执行前确认依赖、输入、输出；执行后用对应校验脚本核对。
5. 出现失败时优先回到日志、错误码、原始字段名定位，不要盲目修改。
6. 任何只在本机内存、剪贴板、临时终端存在的中间产物都不算交付。
7. 涉及多步骤流程时，每一步都要记录实际命令、实际输出、实际产物。
8. 跨任务复用时，复制整段命令而不是心算重组，避免字段遗漏或顺序错乱。

验收要点

• 文档结构完整、章节顺序合理、未被无意义切割。
• 涉及脚本、命令、字段的部分可读、可搜索、可复制。
• 涉及安全、隐私、合规的内容写入公开共享要求小节。
• 中文主体补充覆盖了关键使用场景、关键风险、关键验收步骤。
• 所有外部链接、API、命令、文件路径均能复现，且与本机当前环境兼容。
• 任何示例输出都能在干净环境重跑，不依赖不可见的本地状态。

公开共享与脱敏要求

• 不要写入本机绝对路径、个人目录、账号标识、真实密钥、临时下载目录或过细来源索引。
• 引用本地材料时使用抽象描述或环境变量占位；示例可使用 /tmp、~/workspace、<PROJECT_ROOT> 等通用占位。
• 含具体 BV/AV 号、UID、本地路径、截图目录的素材在共享前必须脱敏或抽象化。
• 任何 token/密钥/连接串在公开版中必须替换为 [REDACTED]；如出现真实凭据，立即撤回。
• 涉及账号、订单、聊天记录的截图在共享前必须打码或裁剪。
• 引用第三方资料时优先使用摘要与公开口径，不要大段照抄受版权保护的内容。
• 任何对个体、公司、产品的负面评价必须基于公开可核验证据，不要发表主观定性。

常见问题与排错

• 中文主体补充与原始英文细则冲突时，以不破坏工具执行、不破坏模板可读性为前提。
• 脚本失败先看环境、依赖、当前目录和输入文件，不要盲目复制输出。
• 数据陈旧或与官方公告冲突时，重新联网核验并标注日期与数据源。
• 用户只要快速回答时只读本节，不要翻译原始字段。
• 多个工作流交叉时，按本节给出的优先级处理：SKILL.md > 本节 > 子工作流 > 模板细节。
• 不要因为本节是中文就认为它会覆盖原字段；本节是补充，不是覆盖。
• 若本节与新版上游冲突，优先采用新版上游，并在本节末尾追加差异说明。
• 在幻灯片/模板/图表/配图/动画/脚本场景下，请把本节当作中文入口；它与下方英文细则共同构成完整文档。
• 所有视觉规格、版式、颜色、字号、间距、字体、动画、节奏，都以原始英文细则为机器可读规范。
• 中文部分负责告诉读者：什么时候用、怎么用、什么时候不用、失败怎么办、怎么验收。
• 中文部分不替代文档的英文细则；二者协同：英文是规范，中文是导读。
• 如果你只读中文部分，务必同时查看本节末尾的“常见问题与排错”小节。
• 如果你要执行真实脚本/命令/模板，务必再回到英文细则，确认参数顺序、参数取值、依赖版本。
• 中文部分对参数类型、数值范围、版本号、API 名称保持沉默——这些都在英文细则里。
• 中文部分会指出哪些字段不能改、哪些参数不能省、哪些命令顺序不能颠倒。
• 在脚本化场景下，请确保所有路径占位（如 <PROJECT_ROOT>、$OUTPUT_DIR）替换为实际路径后再执行。
• 若脚本需要调用网络或第三方 API，请先在草稿环境跑通最小可复现闭环，再扩展到生产环境。
• 若脚本涉及大量图片、视频或音频，请预留充足磁盘与带宽，并设置超时与重试策略。
• 若脚本对错误敏感，请在每一步加入断言、日志和回滚点；不要假设中间状态可恢复。
• 若脚本用于线上或共享环境，请在执行前做权限核对，避免越权或误改。
• 若本文件与其他技能（如 通用 AI 助手、GenericAgent、hermes）交叉，请优先采用本文件的约束。
• 若你修改了本节内容，请在 commit message 中说明改动原因，方便后续审计。
• 在幻灯片/模板/图表/配图/动画/脚本场景下，请把本节当作中文入口；它与下方英文细则共同构成完整文档。
• 所有视觉规格、版式、颜色、字号、间距、字体、动画、节奏，都以原始英文细则为机器可读规范。
• 中文部分负责告诉读者：什么时候用、怎么用、什么时候不用、失败怎么办、怎么验收。
• 中文部分不替代文档的英文细则；二者协同：英文是规范，中文是导读。
• 如果你只读中文部分，务必同时查看本节末尾的“常见问题与排错”小节。