yizhiyanhua-ai/fireworks-open-eli5

Fireworks Open ELI5

어려운 시스템을 사실 기반의 시각적 스토리로 바꿉니다. 먼저 이식 가능한 JSON 스펙을 작성한 후, 결정론적이고 자체 포함된 HTML 설명자를 생성합니다.

불가침 경계

• 근거는 시각적 완성도보다 우선합니다. 모든 근거 항목에 verified(확인됨), inferred(추론됨), analogy(비유) 레이블을 붙이십시오.
• 비유를 구현 사실처럼 제시하지 마십시오.
• 생성된 로컬 HTML 파일은 오직 generated(생성됨) 상태입니다. published(게시됨), 업로드, 전송, 대상 검증 완료 상태가 아닙니다.
• 사용자의 명시적 요청과 대상 워크플로우 자체의 검증 없이는 게시, 업로드, 전송, 또는 접근을 변경하지 마십시오.
• 렌더링은 네트워크 호출을 수행하지 않습니다. 인용된 URL은 독자용 링크이며, 런타임 종속성이 아닙니다. 선택적 네이티브 Pages 액션은 127.0.0.1에서 동일 출처로 번들된 헬퍼만 호출할 수 있으며, 원격 서비스에 절대 연락해서는 안 됩니다.
• 브라우저 로컬 히스토리, 즐겨찾기, 주석은 독자가 동의하기 전까지 비활성화됩니다. 이들은 편의 상태이며, 근거가 아니며, 원본 스펙이나 생성된 아티팩트를 절대 수정하지 않습니다.
• 히스토리는 이전에 해당 브라우저에서 연 동일 출처의 설명자로만 정확히 설명하십시오. 생성된 모든 파일을 열거한다고 주장하지 마십시오.
• PDF 내보내기는 브라우저 인쇄 대화상자를 호출합니다. PNG는 한 장면을 내보내고, PPTX와 Pages 호환 DOCX는 슬라이드나 페이지당 한 장면을 내보냅니다. 네이티브 .pages 출력은 설치된 Pages 앱이 실제로 저장한 후에만 허용됩니다. DOCX를 .pages로 이름을 바꾸지 마십시오. 생성된 다운로드는 로컬 아티팩트일 뿐입니다.

워크플로우

1. 대상 독자, 질문, 언어, 그리고 스토리를 통해 전달되어야 할 한 가지(요청, 패킷, 결정, 이벤트, 사용자 액션)를 식별합니다.

2. 정확히 하나의 스토리 문법을 선택합니다:

   • concept(개념): 직관 → 메커니즘 → 경계.
   • module(모듈): 진입점 → 변환 → 출력/종속성.
   • tradeoff(트레이드오프): 공유 목표 → 경쟁 옵션 → 결과/결정 규칙.
   • incident(인시던트): 정상 경로 → 고장 및 전파 → 탐지/복구.

3. 근거를 수집합니다. 저장소 작업의 경우 실제 파일을 검사하고 로컬 경로를 사용합니다. 외부 주장의 경우 가능하면 권위 있는 출처를 사용합니다. 불확실성을 명시적으로 기록합니다.

4. references/spec-contract.md를 따라 버전 1 JSON 스펙을 생성합니다. 3–7개의 장면, 장면당 2–6개의 노드, 완전한 진실 사다리, 추적, 용어집, teach-back, 근거 맵, 필요한 모드별 modeData를 포함합니다. 결과에 영향을 미치는 노드에는 실패 정보를 추가합니다.

5. 렌더링 전에 검증합니다:

   node scripts/validate.mjs path/to/spec.json
   

6. 새 로컬 파일로 렌더링합니다:

   node scripts/render.mjs path/to/spec.json path/to/explainer.html
   

   렌더러는 기존 경로를 거부합니다. 사용자가 알려진 일반 파일을 교체하기를 명시적으로 원하는 경우에만 --force를 추가합니다. 강제 렌더링은 원자적 교체를 사용하며 여전히 심볼릭 링크와 파일이 아닌 경로를 거부합니다.

7. 스펙과 아티팩트를 함께 검증합니다:

   node scripts/validate.mjs path/to/spec.json path/to/explainer.html
   

8. 브라우저 접근이 가능할 때, 데스크톱 너비와 390px에서 로컬 아티팩트를 검사합니다. 하나의 h1, 읽을 수 있는 레이블, 가로 오버플로우 없음, 키보드 포커스, 독립적인 탭리스트, 전역 및 장면별 재생, 뷰포트 추적, 활성 실시간 에지와 근거 카드 동기화, 진입/유지/종료 애니메이션 단계, 실패 렌즈, 답변 공개, 원격 리소스 요청 없음을 확인합니다. 모든 장면 근거 카드는 자신의 상태, 간결한 핵심 근거, 지원 범위, URL 또는 명시적 위치 없음 경계를 노출해야 합니다.

9. 독자 워크스페이스를 테스트합니다: 마우스와 키보드로 모달 드로어를 열고 닫고, 포커스 반환을 확인하고, 라이브러리를 의도적으로 활성화하고, 다시 로드하여 즐겨찾기와 일반 텍스트 주석을 확인하고, 히스토리에 실제로 열린 동일 출처 설명자만 포함되어 있는지 확인합니다. 마크업 형태의 주석을 사용하여 텍스트로 남아 있음을 확인합니다.

10. 내보내기를 테스트합니다: 인쇄 스타일시트, PNG 시그니처와 치수, PPTX 및 DOCX ZIP 시그니처와 필수 OOXML 파트, 자동 다운로드가 차단되었을 때의 대체 다운로드 링크를 확인합니다. 장면 아트워크에 상태, 핵심 근거, 출처 위치자 또는 경계가 포함된 경계가 있는 근거 바닥글이 포함되어 있는지 시각적으로 확인합니다. 네이티브 Pages가 범위에 포함된 경우 scripts/serve.mjs를 실행하고, .pages 패키지에 Index/Document.iwa가 포함되어 있는지 확인한 후 Pages에서 다시 엽니다. 변경 후 스펙이나 템플릿을 수정하고 두 검증기를 다시 실행합니다.

보고서 언어

• 최종 QA, 상태, 핸드오프, 생성된 아티팩트 보고서는 기본적으로 사용자의 가장 최근 실질적 요청 언어로 작성합니다.
• 명시적인 보고서 언어 요청이 있으면 그 기본값을 덮어씁니다.
• spec.language는 생성된 설명자 인터페이스만 제어하며, 대화 보고서 언어를 강제하지 않습니다.
• 혼합 언어 대화에서 보고서 언어를 선택할 때는 짧은 수신 확인은 무시합니다. 번역 시 정밀도가 떨어질 수 있는 코드, 명령어, 경로, 식별자, 정확한 오류, 출처 제목은 보존합니다.

전체 언어 선택 및 전달 보고서 계약은 references/reporting.md를 읽으십시오.

스토리 구성 규칙

• 제목은 범주 레이블이 아닌 구체적인 약속으로 작성합니다.
• 요약은 한 문장으로, 각 노드는 하나의 책임으로 유지합니다.
• 3–5개의 장면을 선호합니다. 단계를 생략하면 인과 관계가 왜곡되는 경우에만 6–7개를 사용합니다.
• 엣지는 관계 또는 액션입니다. 레이블에는 짧은 동사를 사용합니다.
• 추적은 실제 노드 ID를 의미 있는 순서로 방문해야 합니다.
• 영향, 가시적 증상, 대체 수단을 알고 있는 경우에만 실패 데이터를 사용합니다.
• 단순 계층은 기술 계층을 견딜 수 있을 만큼 정확해야 합니다.
• 한계는 truthLadder.caveat에 넣고, 작은 면책 조항에 넣지 마십시오.
• 출처 ID는 지원하는 장면이나 노드에 사용합니다.
• 주장과 단순히 인접하다는 이유로 출처를 인용하지 마십시오.

모드 패턴은 references/story-grammars.md를, 주장 경계는 references/evidence-rules.md를, 렌더러의 시각적 언어를 변경하기 전에는 references/visual-system.md를 읽으십시오. 지속성, 탐색, 재생 또는 내보내기 동작을 변경하기 전에는 references/library-and-export.md를 읽으십시오.

품질 관문

작업은 다음 조건이 모두 충족될 때만 로컬 아티팩트로 준비됩니다:

• 검증기가 스펙과 렌더링된 HTML에 대해 ok: true를 반환합니다.
• 모든 ID와 참조가 확인됩니다.
• 모든 필수 대화형 섹션에 콘텐츠가 있습니다.
• 선택한 스토리 모드가 자체 의미론적 계약을 통과합니다.
• HTML이 결정론적이며 스펙 SHA-256 메타 태그를 포함합니다.
• 아티팩트가 제공된 스펙과 바이트 단위로 일치하며 신뢰할 수 있는 CSP 해시를 사용합니다.
• 아티팩트에 외부 리소스, 안전하지 않은 런타임 API, 원격 폰트가 없습니다.
• 유지된 독자 상태는 옵트인, 네임스페이스가 지정되고, 제한되며, 동일 출처이며, 결정론적 스펙 해시 외부에 유지됩니다.
• 주석은 텍스트로만 렌더링되며 실행 가능한 마크업을 생성할 수 없습니다.
• 전역 및 로컬 재생은 하나의 상태 머신을 공유하며 동시에 실행되지 않습니다.
• 각 추적 단계는 실제 나가는 관계 경로(또는 싱크의 들어오는 경로)를 활성화하고, 레이블과 화살표 상태를 일치시키며, 해당 단계를 지원하는 근거만 강조 표시합니다.
• 장면 근거 카드는 확인됨/추론됨/비유 경계를 유지하고 핵심 텍스트와 원격 미리보기를 가져오지 않는 실행 가능한 위치자를 노출합니다.
• 장면 PNG, PPTX, DOCX 패키지는 예상된 시그니처와 구조를 가지며 근거 바닥글을 포함합니다. 네이티브 Pages 내보내기가 있다고 주장하는 경우 Pages에서 다시 열렸습니다.
• 모바일은 데스크톱 SVG를 축소하는 대신 스택된 흐름을 사용합니다.
• 최종 보고서는 사용자의 현재 상호작용 언어를 따르고, 생성된 스펙과 HTML 경로를 명시하며, 데스크톱, 모바일, 지속성, 재생, 근거, 내보내기 브라우저 QA가 실행되었는지 여부를 말합니다.

근거가 불완전하면 근거 맵과 주의 사항이 그 차이를 명백히 할 때만 생성하십시오. 그렇지 않으면 중단하고 누락된 근거를 보고하십시오.