kordoc watch无人值守流水线文件夹监控Webhook通知自动文档转换【免费下载链接】kordoc모두 파싱해버리겠다 — HWP·HWPX·PDF·Office 문서를 Markdown으로. 양식 자동 채우기와 신구대조를 갖춘 CLI·MCP 서버 | Convert Korean documents (HWP, HWPX, PDF, Office) to Markdown — CLI and MCP server with form filling and diff项目地址: https://gitcode.com/gh_mirrors/ko/kordockordoc watch是 kordoc 内置的文件夹监控命令把 HWP、HWPX、PDF、Office 文档丢进一个监控文件夹它会自动完成文档转换并通过 Webhook 通知把结果推送给你的系统——一条命令搭建无人值守的自动文档转换流水线。 kordoc watch 是什么kordoc 的核心能力是把韩文文档HWP·HWPX·PDF·DOCX·XLS·PPTX解析成 Markdown而 src/watch.ts 实现的 watch 模式在此基础上加了两件事文件夹监控递归监视指定目录新文件落盘即触发转换支持.hwp.hwpx.hml.pdf.xls.xlsx.docx.pptx共 8 种格式Webhook 通知转换成功或失败都会向指定 URL 发送 JSON 事件方便对接消息平台或下游系统配合输出目录参数输出文件会按子目录结构原样落盘适合搭建“收件箱 → 转换 → 归档”的自动化链路。 最快上手一条命令启动监控先获取项目git clone https://gitcode.com/gh_mirrors/ko/kordoc cd kordoc启动文件夹监控最小配置只需一个目录npx kordoc watch ./incoming推荐配置输出到目录 Webhook 通知npx kordoc watch ./incoming -d ./output --webhook https://api.example.com/docs完整命令速查可参考 docs/usage.md 的“模型 · 감시”小节。主要参数速览参数作用dir要监控的文件夹递归监视-d, --out-dir转换结果输出目录保留子目录结构--webhook url转换事件推送的 Webhook 地址-p, --pages range指定页面/节范围如1-3--format type输出格式markdown默认或json--silent隐藏进行中的日志输出CLI 参数注册见 src/cli/commands-docs.ts。 Webhook 通知推送什么、怎么对接每个文件处理结束后watch 会向 Webhook 地址发送一次POST请求Content-Type为application/json并自动附带 ISO 时间戳timestamp成功事件{ file: 보고서.hwpx, format: hwpx, success: true, markdown: 正文前 1000 字符预览, timestamp: 2026-10-04T01:00:00.000Z }失败事件{ file: 비밀.hwp, format: hwp, success: false, error: 암호화된 문서입니다, timestamp: 2026-10-04T01:00:00.000Z }在接收端按success字段分流即可成功时展示文件名与预览失败时把error信息转成告警这就是最简的“转换结果自动播报”方案。️ 内置的 SSRF 安全防护Webhook 目标会经过严格校验src/watch.ts只允许http/https协议屏蔽localhost、127.x、10.x、192.168.x、172.16-31.x、169.254.x、.local等内网地址拦截十六进制/八进制/十进制编码的 IP 绕过、云元数据端点以及带内嵌 IPv4 的 IPv6 变体DNS 解析后对真实 IP再次复检防止域名指向内网发送逻辑见 sendWebhook相关测试在 tests/watch.test.ts。⚡ 可靠性设计为什么文件不会“丢”watch 模式针对真实场景的几类坑做了专门处理源码都在 src/watch.ts机制说明1 秒防抖文件连续触发的事件合并为一次转换避免“半截文件”写入完成判定间隔 300ms 连续两次文件大小相同才读取防止读到写了一半的文件并发上限 等待队列最多同时处理 3 个文件超出的进入队列按序处理而不是被丢弃createTaskQueue大小保护空文件与超过 500MB 的文件直接跳过符号链接拦截解析真实路径后阻止监控目录外的文件被处理监视器自身容错文件描述符耗尽等错误只记日志、不退出守护进程持续存活子目录结构保持行为有专门的端到端测试tests/watch-output.test.ts输入alpha/report.hwpx→ 输出output/alpha/report.md。️ 环境与部署注意Node 版本Windows / macOS 需 Node 18Linux 需 Node 19.1递归监视特性建议直接上 Node 20不满足时会给出明确报错而不是难以排查的底层错误assertRecursiveWatchSupport离线/封闭网络设置KORDOC_OFFLINE1后 webhook 发送会被拦截——封闭网环境建议改用--output结果文件 内部作业轮询的替代方案详见 docs/offline-deployment.md日志watch 的运行日志走 stderr[kordoc watch] 감시 시작: …/변환 중: …/완료: …--silent可静音方便接入日志采集停止CtrlC即可终止监控进程 关键文件索引文件说明src/watch.tswatch 模式核心文件夹监控、任务队列、Webhook 发送与 SSRF 防护src/cli/commands-docs.tskordoc watch命令与参数定义docs/usage.md完整命令参考含 watch 用法示例docs/offline-deployment.md离线部署与 webhook 边界条件tests/watch.test.tsWebhook DNS 固定pinning行为测试tests/watch-output.test.ts子目录结构保持的端到端测试小结kordoc watch用一条命令就能把“文档转换”从手动操作变成无人值守流水线监控一个收件箱文件夹支持 8 种韩国文档格式文件写稳后自动防抖、限流、转换输出 Markdown 或 JSON每次转换无论成败通过经安全校验的 Webhook 推送结构化事件如果你需要“文档一进来就自动变成 Markdown 并通知到人”这就是完整闭环。【免费下载链接】kordoc모두 파싱해버리겠다 — HWP·HWPX·PDF·Office 문서를 Markdown으로. 양식 자동 채우기와 신구대조를 갖춘 CLI·MCP 서버 | Convert Korean documents (HWP, HWPX, PDF, Office) to Markdown — CLI and MCP server with form filling and diff项目地址: https://gitcode.com/gh_mirrors/ko/kordoc创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
