新的主控
- 作者仓库星标 0
- 作者仓库 Labs
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @zasfe · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- Python
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# HWPX 공문/기안문 자동 채우기 스킬
## 1단계: HWPX 파일 해제
```bash
mkdir -p hwpx_work && cd hwpx_work
cp 원본.hwpx 원본.zip
unzip -o 원본.zip -d original
```
해제 후 핵심 파일:
- Contents/section0.xml: 본문 (수정 대상)
- Contents/header.xml: 서식 정의
- mimetype, META-INF/, BinData/, Preview/: 수정하지 않음
## 2단계: section XML 분석
Contents/section0.xml을 파싱하여 공문 필드를 식별한다.
## 3단계: XML 수정
### ★★★ 가장 중요한 규칙: linesegarray 삭제 ★★★
텍스트를 수정한 <hp:p> 에서 반드시 <linesegarray> 자식 요소를 삭제해야 한다.
linesegarray는 원본 편집기가 저장한 "줄 배치 캐시"이다.
텍스트를 변경하면 이 캐시가 무효화되어 글자가 겹쳐 보이는 현상이 발생한다.
삭제하면 한컴오피스가 파일을 열 때 자동으로 줄 배치를 재계산한다.
```python
from lxml import etree
import copy
with open('original/Contents/section0.xml', 'rb') as f:
tree = etree.parse(f)
root = tree.getroot()
# 텍스트를 수정한 모든 <hp:p>에서 linesegarray를 반드시 삭제
def remove_linesegarray(p_element):
"""수정된 문단에서 linesegarray를 삭제한다. 필수!"""
for child in list(p_element):
if etree.QName(child.tag).localname == 'linesegarray':
p_element.remove(child)
# 텍스트 교체 예시
for elem in root.iter():
local = etree.QName(elem.tag).localname
if local == 't' and elem.text:
if elem.text.strip() == '기존텍스트':
elem.text = '새 텍스트'
# ★ 반드시 해당 <hp:p>의 linesegarray를 삭제
p = elem.getparent().getparent()
remove_linesegarray(p)
```
### 안전하게 모든 수정된 문단 처리하는 방법
```python
# 수정 대상 <hp:p>를 추적
modified_paragraphs = set()
# 텍스트 수정 시마다 기록
def safe_set_text(t_element, new_text):
"""텍스트를 안전하게 변경하는 함수"""
t_element.text = new_text
# run -> p 순서로 올라가서 <hp:p> 찾기
run = t_element.getparent()
p = run.getparent()
modified_paragraphs.add(id(p))
# 즉시 linesegarray 삭제
remove_linesegarray(p)
# 모든 수정이 끝난 후 최종 확인 (안전장치)
for elem in root.iter():
local = etree.QName(elem.tag).localname
if local == 'p':
if id(elem) in modified_paragraphs:
remove_linesegarray(elem) # 이중 확인
```
### 절대 금지 사항
- 절대로 XML을 문자열(f-string, concat, replace)로 조합하지 않는다.
- 절대로 XML 선언(<?xml ...?>)을 수동으로 추가하지 않는다.
- 절대로 section0.xml 전체를 새로 작성하지 않는다.
- 절대로 .replace()나 re.sub()로 XML을 조작하지 않는다.
### 긴 텍스트 삽입 시 문단 분할
```python
def insert_multiline(parent, ref_p, texts):
"""ref_p를 복제하여 여러 문단으로 삽입. 각 문단의 linesegarray도 삭제."""
p_index = list(parent).index(ref_p)
# 첫 번째 텍스트: 원본 <hp:p>에 넣기
for t in ref_p.iter():
if etree.QName(t.tag).localname == 't':
t.text = texts[0]
break
remove_linesegarray(ref_p) # ★ 필수
# 나머지: <hp:p> 복제 후 삽입
for i, txt in enumerate(texts[1:], 1):
new_p = copy.deepcopy(ref_p)
for t in new_p.iter():
if etree.QName(t.tag).localname == 't':
t.text = txt
break
remove_linesegarray(new_p) # ★ 필수
parent.insert(p_index + i, new_p)
```
### XML 저장
```python
tree.write('original/Contents/section0.xml',
xml_declaration=True,
encoding=tree.docinfo.encoding or 'UTF-8',
standalone=tree.docinfo.standalone)
```
## 4단계: HWPX 재패키징
```python
import zipfile, os
output_path = '결과물.hwpx'
with zipfile.ZipFile(output_path, 'w') as zf:
# mimetype은 반드시 첫 번째, 비압축으로
mimetype_path = os.path.join('original', 'mimetype')
if os.path.exists(mimetype_path):
zf.write(mimetype_path, 'mimetype', compress_type=zipfile.ZIP_STORED)
for dirpath, dirnames, filenames in os.walk('original'):
for filename in filenames:
filepath = os.path.join(dirpath, filename)
arcname = os.path.relpath(filepath, 'original')
if arcname == 'mimetype':
continue
zf.write(filepath, arcname, compress_type=zipfile.ZIP_DEFLATED)
```
## 5단계: 검증
```python
from lxml import etree
import zipfile
with zipfile.ZipFile(output_path, 'r') as zf:
assert zf.testzip() is None, "ZIP 손상"
with zf.open('Contents/section0.xml') as f:
tree = etree.parse(f)
print("검증 완료")
```
## 6단계: 공문 작성 원칙
- 경어체 (합니다/습니다체)
- 두괄식 서술 (결론 → 배경 → 세부내용)
- 본문 순서: 목적/배경 → 세부 내용 → 요청/협조 사항 → 붙임
- 관용 표현: "~와 관련하여", "아래와 같이", "~하여 주시기 바랍니다"
章节与文件索引
按说明文件中的顺序排列。
步骤1:释放HWPX文件
★★★ 最重要的规则:删除linesegarray ★★★
绝对禁止
第六步:官方文件的撰写原则
文件/命令 -> Contents/section0.xml · Contents/header.xml · original/Contents/section0.xml · section0.xml
内容校验值 -> a9f58991a9ca
当前原文的自动摘译,尚未人工审校。
步骤1:释放HWPX文件
发布后核心文件: Contents/section0.xml:Body(修改目标) Contents/header.xml:格式定义 mimetype、META-INF/、BinData/、Preview/:请勿修改
★★★ 最重要的规则:删除linesegarray ★★★
您必须从已修改文本的 hp:p 中删除 <linesegarray> 子元素。 linesegarray 是原始编辑器存储的“行放置缓存”。当您更改文本时,此缓存将失效,导致字母出现重叠。如果删除,Hancom Office 在打开文件时会自动重新计算行位置。
绝对禁止
切勿将 XML 组合成字符串(f 字符串、连接、替换)。切勿手动添加 XML 声明 (<?xml ...?>)。切勿重写整个section0.xml。切勿使用 .replace() 或 re.sub() 操作 XML。
第六步:官方文件的撰写原则
敬语(应该/dae)括号内的描述(结论→背景→详细信息) 正文顺序:目的/背景→详细信息→请求/合作→附件 惯用语:“与……有关”、“如下”、“请~”