mcpField
H
hwp

hwp

github.com/pitzcarraldo文档处理094 次安装6 周前更新
代码仓库

关于 hwp

hwp 是读取韩文 Hangul Word Processor 文档的 Skill，面向需要根据 .hwp 或 .hwpx 文件内容作答的场景。它使用 pyhwp2md 提取文本，并规定了工具检测与大文件处理流程。

主要功能

  1. 01读取 HWP 与 HWPX 文件
  2. 02使用 pyhwp2md 提取内容
  3. 03自动选择 Python 包运行工具
  4. 04支持将较大输出写入临时文件
  5. 05说明图片、链接和格式限制

适用场景

  1. 01从 HWP 文件中查找信息
  2. 02根据 HWPX 文档内容回答问题
  3. 03处理超出上下文长度的提取结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/pitzcarraldo/skills --skill hwp

安装后在 Claude Code 中输入/hwp确认已加载。

附带文件scripts/html_extractor.pyscripts/hwp_reader.py

详细介绍

HWP/HWPX 文档阅读器

此技能可读取韩文 Hangul Word Processor 文件（.hwp、.hwpx），并使用 pyhwp2md 根据文件内容准备回复。

支持的格式

格式扩展名描述
HWP.hwp二进制格式（HWP 5.0+）
HWPX.hwpx基于 XML 的格式（Hangul 2014+）

工作流

CRITICAL：切勿直接运行 uvx、pipx 或 pip 命令。务必使用下方的完整 bash 脚本，它会自动检测并使用正确的工具。

1. 确认文件存在
ls -la "[file-path]"
2. 检测并提取内容

运行此 EXACT 脚本（不要修改或单独运行其中的命令）：

TOOL=$(command -v uvx >/dev/null 2>&1 && echo "uvx" || (command -v pipx >/dev/null 2>&1 && echo "pipx" || (command -v pip >/dev/null 2>&1 && echo "pip" || echo "none"))) && case $TOOL in uvx) uvx pyhwp2md "[file-path]" ;; pipx) pipx run pyhwp2md "[file-path]" ;; pip) pip install -q pyhwp2md && pyhwp2md "[file-path]" ;; *) echo "Error: No Python package runner found" ;; esac
3. 根据内容大小处理输出

如果内容可容纳在上下文中：直接使用标准输出内容回答用户的问题。

如果内容过大，无法容纳在上下文中：使用此脚本保存到临时文件：

TOOL=$(command -v uvx >/dev/null 2>&1 && echo "uvx" || (command -v pipx >/dev/null 2>&1 && echo "pipx" || (command -v pip >/dev/null 2>&1 && echo "pip" || echo "none"))) && case $TOOL in uvx) uvx pyhwp2md "[file-path]" -o /tmp/extracted_content.md ;; pipx) pipx run pyhwp2md "[file-path]" -o /tmp/extracted_content.md ;; pip) pyhwp2md "[file-path]" -o /tmp/extracted_content.md ;; esac

然后根据需要分块读取文件，以回答用户的问题。

技术要求

要求版本备注
Python3.10+必需
uv/pipx/pip最新版三者任选其一

限制

  • 图片：暂不支持
  • 链接：仅部分支持
  • 格式：不会保留样式、颜色和字体

参考资料

评论

支持 Markdown