hfVisualizer 원격 제어 History
history
hfVisualizer --remote [--target <id>] history <History|PostHistory> <name> (--content <text> | --content-file <file>)
*History또는*PostHistory정의 하나를 생성하거나 갱신합니다.--content와--content-file중 정확히 하나가 필요합니다.<type>은History또는PostHistory여야 합니다.<name>은 비어 있으면 안 됩니다.- IPC 계층이 계산된
*History또는*PostHistorykeyword line을 앞에 붙인 뒤 내용을readHistoryModification(..., true)에 전달합니다. --content안에서는 줄바꿈을\n으로 씁니다.\\n은 문자 그대로 유지됩니다.- 빈 내용은 허용되지 않습니다.
- 기존 history 항목은 현재 list 위치를 유지한 채 제자리 갱신됩니다.
- preprocessing mode에서는 성공 시 render pipeline을 refresh하고 DB modified 상태를 올립니다.
- postprocessing mode에서는
<type>=PostHistory만 허용됩니다. 이는 postprocessing mode에서도 유지되는 드문 GUI 예외 definition 경로 중 하나입니다. - postprocessing mode에서는 성공 시 추가로
runLastPostHistory()를 실행하고 DB file을 즉시 갱신합니다. 이는 GUIHistory위젯과 동일한 동작입니다. - reader 규칙 요약:
- 첫 데이터 줄은 대상 step 목록
- 둘째 줄 이후는 history request
- keyword line 이후 최소 2개의 데이터 줄이 필요함
예시:
hfVisualizer --remote history History H1 --content "STEP1, STEP2\nD.X@10, FK.X@10\nA.X@center_line"
hfVisualizer --remote history PostHistory HPOST --content-file D:\Work\post-history.txt
history-rename
hfVisualizer --remote [--target <id>] history-rename <old-name> <new-name>
- preprocessing mode에서만 사용할 수 있습니다.
- 두 이름 모두 비어 있으면 안 되며 GUI 편집과 같은 single-token 정규화를 적용합니다.
- 기존 이름이 실제로 존재해야 합니다.
- 새 이름이 다른 history와 충돌하면 실패하며, 정규화 후 같은 이름이면 no-op으로 성공합니다.
- 성공하면
script-save에 canonicalhistory-rename ...tail이 기록됩니다.
예시:
hfVisualizer --remote history-rename H1 H_MAIN
history-delete
hfVisualizer --remote [--target <id>] history-delete <name>
- preprocessing mode에서만 사용할 수 있습니다.
name은 비어 있으면 안 되며 기존 history를 가리켜야 합니다.- ModelTree delete와 같은 삭제 경로를 사용합니다. remote delete는 postprocessing 확인창 경로를 타지 않도록 preprocessing 전용으로 유지됩니다.
- 성공하면
script-save에 canonicalhistory-delete ...tail이 기록됩니다.
예시:
hfVisualizer --remote history-delete H_MAIN