尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
kordoc watch无人值守流水线:文件夹监控+Webhook通知,自动文档转换
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),仅供参考
RELATED

相关推荐

插件体系全解析:从plugin.json到TypeScript SDK的实战指南

插件体系全解析:从plugin.json到TypeScript SDK的实战指南

1. 从“plugins”这个词说起:它到底在解决什么问题但凡折腾过现代开发工具的人,对plugins这个词都不会陌生。它字面意思就是“插件”,但真正理解它的人知道,这背后其实是一整套可扩展架构的设计哲学。你用的编辑器、IDE、命令行工…

📅 2026/10/4 20:53:25
插件机制深度解析:从IAR到Web IDE的加载失败与激活问题

插件机制深度解析:从IAR到Web IDE的加载失败与激活问题

我最近查资料的时候,无意间刷到一串热搜词,里面好几条都在问类似的问题:“iar plugins 是干什么的”“failed to load plugins web boot: 2 entries did not activate”“harness failed to load plugins”“musicfree plugins”。说实话&…

📅 2026/10/4 20:53:25
Node.js 安全实践:在沙箱中运行不可信代码的完整指南(nodebestpractices 解读)

Node.js 安全实践:在沙箱中运行不可信代码的完整指南(nodebestpractices 解读)

文档教程后端 【免费下载链接】nodebestpractices ✅ The Node.js best practices list (July 2026) 项目地址: https://gitcode.com/GitHub_Trending/no/nodebestpractices 点击查看 免费下载 在 Node.js 应用中,我们通常只应运行自己信任的 JavaScrip…

📅 2026/10/4 20:53:25
MORE NEWS

更多资讯

📰

企管论文别再“一个 AI 用到黑”:从选题到降重,我的工具分工清单 [特殊字符]

先把场景说具体:假设你是企业管理专业学生,正在做毕业论文——《制造企业数字化转型对服务化绩效的影响:组织敏捷性的中介作用》。 这类题目在企管专业很典型:既要看战略管理、服务化、动态能力等文献,又要设计问卷、…

📰

C# WinForm 下拉框切换窗体样式:主题类与递归遍历控件重绘指南

简介:面向 C# WinForm 开发者的窗体样式风格资源,用于解决桌面应用界面单调、控件美观度不足的问题,常见于管理后台、工具类软件等需要统一打造美观界面的场景,适合初中级开发者参考学习。资源包共 32 个文件,以 cs 源…

📰

格式转换任务为何要关闭思考?JSON 结构化输出场景下的思考死循环实测

格式转换任务为何要关闭思考?JSON 结构化输出场景下的思考死循环实测在现代企业级 AI 应用架构中,大语言模型扮演着越来越重要的“异构数据粘合剂”角色:将前端用户输入的口语化诉求解析为下游微服务可直接消费的 API 参数、从扫描版报销凭证…

📰

端侧 SLM 显存保活术:在 4GB 内存板卡上实现轻量 PagedAttention 与 KV 缓存分块

端侧 SLM 显存保活术:在 4GB 内存板卡上实现轻量 PagedAttention 与 KV 缓存分块在工业自动化控制台、野外工控巡检箱以及边缘网关中,将 1B 到 2B 参数量级的端侧轻量小模型(SLM,如 Qwen2.5-0.5B/1.5B)部署在板载内存仅…

📰

三菱CNC数据采集C#源码解析:从协议到落库的完整实践

简介:工业设备数据采集是智能制造的基础环节,其中CNC数控机床的数据获取尤为关键。三菱CNC系统通信协议复杂(如MC Protocol、EZSocket),让许多工程师在报文结构上遭遇瓶颈。基于TCP Socket的3E帧二进制格式&#xff0c…

📰

8G显存本地跑大模型代码生成:从翻车到落地的完整实操指南

1. 8G 显存这道坎,到底卡在哪儿先把结论摆在前面:8G 显存跑本地大模型做代码生成,能跑,但能跑和好用之间隔着一条很深的沟。我前后折腾了差不多两个月,换过三套方案,最后才找到一个相对稳定的落地姿势。这篇…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬