为什么值得关注

它提供了一个结构化的知识框架，明确证据、验证条件和关系类型（事实、假设、反驳），特别适合研究或事实核查系统的信息完整性维护。

适合谁使用

构建基于证据的知识图谱或本体工具的开发者
处理复杂、可验证信息的研究人员和分析师
数据记者和事实核查团队
在无服务器平台上部署自托管语义控制台的工程师

典型使用场景

追踪研究项目的证据链和验证状态
构建可验证的知识库，清晰区分事实与假设
在公开发布前自动检查源完整性和凭据泄露
在 Cloudflare Workers 上部署轻量级本体控制台

项目优势

通过明确的证据、反驳条件和验证状态区分假设与事实
运行或构建前自动从 Markdown 同步语义数据，无需手动导出
提供验证脚本（source:check、release:check）确保构建完整性和部署就绪
专为无服务器部署（Cloudflare Workers）设计，公开仓库仅含演示数据

使用前须知

公开仓库仅含虚构演示数据；实际数据需要单独的权利和许可证验证
需要 Node.js 22.13+，其他环境可能需要兼容性调整
部署文档和许可证选择是 README 未详述的外部前提

README 快速开始

Self Ontology

근거, 시간 맥락, 검증 상태를 함께 읽는 증거 기반 온톨로지 콘솔의 공개 참조 구현입니다.

그래프의 관계는 사실, 원문 직접 확인, 시간순, 상관관계, 가설, 반증·정정, 별개 구분, 기여 요인으로 분리됩니다. 가설은 근거·반증 조건·검증 상태를 갖춰 사실처럼 표시되지 않도록 설계했습니다.

실행

Node.js 22.13 이상이 필요합니다.

npm ci
npm run dev

콘솔의 생성 데이터는 실행·빌드 전에 자동 동기화됩니다. 따라서 원천 Markdown과 의미론 데이터가 갱신된 뒤에는 별도의 수동 데이터 내보내기가 필요하지 않습니다.

GitHub 소스 공개

GitHub는 이 프로젝트의 소스 배포처로만 사용합니다. GitHub Pages에 사이트를 올리는 용도는 아니며, 운영 사이트는 별도의 Cloudflare Workers 호환 환경에서 실행합니다. 공개 브랜치에는 실제 연구 데이터 대신 demo-data/의 가상 참조 데이터가 포함됩니다.

공개 저장소로 내보내기 전에는 다음 명령을 실행합니다.

npm run source:check

이 명령은 가상 참조 데이터로 빌드·렌더링을 검증하고, 빌드 산출물, 로컬 환경 파일, 명백한 자격 증명이 추적 대상에 없는지 점검합니다. 공개 전에는 코드 라이선스를 선택하고, 원천 문서·추출 데이터·인용문을 함께 공개할 권리가 있는지 별도로 확인해야 합니다.

검증과 배포 준비

npm run release:check

이 명령은 다음을 순서대로 확인합니다.

의미론 데이터를 다시 생성합니다.
프로덕션 빌드를 만듭니다.
렌더링된 콘솔, 그래프의 기본 위치, 가설 참조를 테스트합니다.
서버 번들, 정적 자산, 호스팅 메타데이터, 프로덕션 제목이 배포 가능한지 확인합니다.

상세한 운영 절차와 호스팅 조건은 DEPLOYMENT.md를 참고하세요.

self-ontology