Skip to content

Latest commit

 

History

History
147 lines (110 loc) · 7.94 KB

File metadata and controls

147 lines (110 loc) · 7.94 KB

WikiStub-Seed

WikiStub-Seed

EN | DE | ES | JA | RU | ZH

WikiStub-Seed es un marco de conocimiento JSON multilingüe para investigación asistida por IA, documentación, sistemas de aprendizaje y flujos de trabajo con LLM. Incluye un conjunto de datos curado wikistub_seed.json con 630 stubs de conocimiento compactos en alemán e inglés distribuidos en 12 dominios científicos y culturales, slots de idioma preparados para ES/ZH/JA/RU, además de herramientas Python para validación, exportación y traducción.

WikiStub-Seed es una biblioteca semilla de stubs de conocimiento, no un wiki.

WikiStub-Seed smoke tests Stubs Languages Format Python License

Contenido

  • 630 stubs de conocimiento en wikistub_seed.json con contenido DE/EN y slots de idioma preparados para ES/ZH/JA/RU
  • 12 dominios de primer nivel, incluidos matemáticas, física, química, biología, medicina, psicología, IA, ingeniería, sociedad, economía, historia y cultura
  • 85 subcategorías con definiciones cortas y neutrales y notas de relevancia
  • Mapas canónicos definitions.{lang} y relevance_i18n.{lang} conservando los campos heredados definition_de, definition_en y relevance
  • Herramientas CLI en Python para estadísticas, validación, comprobaciones de consistencia y exportación a Markdown
  • Una dirección de exportación documentada wikistub-seed-data-v1 para uso futuro en sitios Web/PWA estáticos
  • Sin dependencias externas requeridas para la importación, exportación, validación o uso de CLI básico

Casos de uso

  • Crear una base de conocimiento local para escritura o investigación asistida por IA
  • Construir glosarios de documentación, mapas de aprendizaje o catálogos de conceptos
  • Exportar Markdown estructurado para Obsidian, GitHub Pages o sitios estáticos
  • Alimentar pipelines de recuperación, embeddings o contexto LLM con stubs de dominio compactos
  • Traducir y ampliar un esqueleto de conocimiento neutro en dominio en un formato JSON controlado

Estructura de datos

Cada stub está intencionalmente diseñado para ser pequeño y legible por máquina:

{
  "title": "Domain-Driven Design",
  "definition_de": "Ein Ansatz zur Modellierung komplexer Software, der die Fachdomäne in den Mittelpunkt stellt.",
  "definition_en": "An approach to modeling complex software that places the business domain at the center of development.",
  "relevance": "Hilft, komplexe Systeme verständlich und wartbar zu gestalten.",
  "definitions": {
    "de": "Ein Ansatz zur Modellierung komplexer Software, der die Fachdomäne in den Mittelpunkt stellt.",
    "en": "An approach to modeling complex software that places the business domain at the center of development.",
    "es": "",
    "zh": "",
    "ja": "",
    "ru": ""
  },
  "relevance_i18n": {
    "de": "Hilft, komplexe Systeme verständlich und wartbar zu gestalten.",
    "en": "",
    "es": "",
    "zh": "",
    "ja": "",
    "ru": ""
  },
  "tags": ["Informatik", "Software Engineering"]
}

La fuente autoritativa actual es wikistub_seed.json. EXPORTFORMAT.md documenta el formato envolvente estable wikistub-seed-data-v1 para exportaciones Web/PWA, API y LLM.

Inicio rápido

git clone https://github.com/dev-bricks/WikiStub-Seed.git
cd WikiStub-Seed

python wikistub_seed_cli.py --help
python wikistub_seed_cli.py stats
python wikistub_seed_cli.py check
python wikistub_seed_pipeline.py validate
python wikistub_seed_pipeline.py export --output --english

En Windows, start.bat abre el punto de entrada de la CLI. Los archivos exportados se escriben en output/; esa carpeta es local y no está versionada.

Comandos principales

Comando Propósito
python wikistub_seed_cli.py stats Mostrar estadísticas de stubs, categorías y etiquetas
python wikistub_seed_cli.py check Ejecutar comprobaciones de consistencia sobre el conjunto de datos JSON
python wikistub_seed_pipeline.py validate Validar los datos de entrada de la pipeline
python wikistub_seed_pipeline.py export --output --english Exportar el conjunto de datos JSON a Markdown
python wikistub_seed_pipeline.py translate Traducir opcionalmente definiciones en inglés faltantes cuando esté configurado

Mapa del repositorio

Ruta Propósito
wikistub_seed.json Conjunto de datos de conocimiento bilingüe autoritativo
01_Mathematik/ ... 12_Kultur_Kunst_Sprache/ Estructura de fuente/exportación Markdown orientada a dominio
wikistub_seed_cli.py CLI para estadísticas y comprobaciones
wikistub_seed_pipeline.py Pipeline de importación, exportación, validación y traducción opcional
md_to_json.py Herramienta auxiliar de importación Markdown a JSON
check_duplicates.py Herramienta auxiliar de duplicados/consistencia
EXPORTFORMAT.md Plan de formato de intercambio estable
web_publisher/ Editor web estático/PWA (PWA, caché sin conexión, búsqueda, alternancia DE/EN)

Privacidad

WikiStub-Seed es local-first. El uso básico lee y escribe únicamente archivos JSON/Markdown locales. No hay telemetría ni comunicación de red automática.

El comando de traducción opcional puede llamar a una API externa únicamente cuando ANTHROPIC_API_KEY está configurado y el paquete opcional anthropic está instalado.

Hoja de ruta

Completado:

  • 12 dominios de primer nivel y 85 subcategorías
  • 630 stubs bilingües en un único archivo maestro JSON
  • Herramientas de exportación a Markdown y sincronización JSON
  • Pruebas de humo CLI en GitHub Actions, más pruebas de humo de fuente dedicadas para macOS/Linux de wikistub_seed_cli.py check y wikistub_seed_pipeline.py validate
  • Editor web estático/PWA con búsqueda y caché sin conexión (web_publisher/)
  • Envolvente de esquema wikistub-seed-data-v1 con slots de idioma DE/EN/ES/ZH/JA/RU preparados

Planificado:

  • Limpieza unificada de etiquetas
  • Rutas de exportación para Obsidian/GitHub Pages
  • Embeddings opcionales y API de búsqueda

Deutsch

WikiStub-Seed ist ein mehrsprachig vorbereitetes JSON-Wissensgerüst für KI-gestützte Wissensarbeit. Das Repository enthält 630 kompakte Wissens-Stubs mit Deutsch/Englisch-Inhalten und vorbereiteten Sprachslots für Spanisch, Chinesisch, Japanisch und Russisch, verteilt auf 12 Wissenschafts- und Kulturbereiche. Die Stubs sind kurz, neutral, versionierbar und für Automatisierung, Dokumentation, Lernsysteme und LLM-Kontexte geeignet.

WikiStub-Seed arbeitet standardmäßig lokal mit wikistub_seed.json. Die Kernfunktionen benötigen keine externen Pakete. Nur die optionale Übersetzungsfunktion nutzt externe API-Aufrufe, wenn ein API-Key gesetzt und das optionale Paket installiert wurde.

Wichtige Einstiegspunkte:

  • python wikistub_seed_cli.py stats zeigt Statistik und Kategorien.
  • python wikistub_seed_cli.py check prüft den Datenbestand.
  • python wikistub_seed_pipeline.py export --output --english exportiert Markdown.
  • EXPORTFORMAT.md beschreibt den geplanten stabilen Austauschstandard.
  • web_publisher/ enthält den fertigen statischen Web/PWA-Publisher mit Offline-Cache und DE/EN-Toggle.

Licencia

Licencia MIT. Véase LICENSE.

Este proyecto es una donación de código abierto no remunerada. La responsabilidad se limita a la intención y negligencia grave según el artículo 521 del Código Civil alemán, aplicándose también los descargos de responsabilidad de la licencia MIT. Uso bajo su propio riesgo.