Open Knowledge Format · v0.2 · من Google Cloud

معرفة يعرف وكلاؤك مصدرها

OKF مواصفة مفتوحة من Google Cloud للمعرفة التي يكتبها الوكلاء ويعتمد عليها الناس. هي مجلد من ملفات markdown، وكل ملف يخبرك من أين جاءت معلوماته، ومن راجعها، ومتى تنتهي صلاحيتها. وعليها بُني Knowtarium.

اقرأ المواصفة على GitHub ابدأ مجانًا

الحزمة

مجلد من ملفات markdown. لا أكثر.

حزمة OKF مجلد من ملفات markdown مع frontmatter بصيغة YAML. لا قاعدة بيانات، ولا سجل مخططات، ولا أداة إلزامية: يكفي أن تفتح ملفًا نصيًا لتقرأها، وأن تنسخ مجلدًا أو تستنسخ مستودعًا لتشاركها.

كل ملف مفهوم واحد: مقياس، أو سياسة، أو مقابلة مع عميل، أو دليل تشغيل. الحقل الإلزامي الوحيد هو type. وتجمع المجلدات المفاهيم بالطريقة التي تناسب الفريق، وهناك اسما ملفين محجوزان: index.md يسرد ما يحتويه المجلد، وlog.md يسجّل ما تغيّر.

bundle

~/kb/
  index.md                  # what's in this folder (optional)
  log.md                    # what changed, newest first (optional)
  company/
    mission.md
    glossary.md
  metrics/
    revenue.md              # one concept per file
    churn.md
    computations/
      quarterly-revenue.md  # an attested computation
  customers/
    segments.md
    interviews/
      northwind-traders.md

داخل المستند

أربعة أسئلة، وأجوبتها في الـfrontmatter.

حين يكتب الوكلاء معظم قاعدة المعرفة، يحتاج القارئ إلى أكثر من النص. تضيف OKF v0.2 بضع مجموعات اختيارية من الحقول تجعل كل مستند يجيب عن الأسئلة نفسها. وكلها اختيارية: المستند الذي ليس فيه إلا type يبقى صالحًا، وغياب مجموعة منها يعني ببساطة أن الجواب غير معروف.

تذكر المعلومات في متن المستند مصادرها بحواشٍ مرتبطة بمعرّف، مثل [^billing-export]، فيبقى الرابط سليمًا حين يعيد الوكيل ترتيب القائمة.

metrics/revenue.md

---
type: Metric
title: Quarterly revenue
tags: [finance, revenue]
status: stable
generated: { by: claude-code/2.1, at: 2026-09-26T07:42:00Z }
verified:
  - { by: human:maya, at: 2026-09-26T10:05:00Z }
stale_after: 2026-12-31T00:00:00Z
sources:
  - id: billing-export
    resource: exports/billing/2026-09.csv
    author: process:billing-sync
owner: human:maya          # your own keys are kept as written
---
 
Q3 revenue was €112,400, up 12% on Q2.[^billing-export]

provenance

من أين جاء هذا؟

كل معلومة تذكر مصدرها بمعرّفه. ويحمل كل مصدر اسم كاتبه، وكم مرة يُستخدم، ومتى تغيّر.

sources · usage_window

trust

من راجعه؟

من كتب المستند، وكل شخص أو عملية أكّدته بعد ذلك، ومتى.

generated · verified

lifecycle

هل ما زال صالحًا؟

حالة المستند (مسودة أو مستقر أو مُهمَل)، واللحظة التي لا يعود بعدها الاستشهاد به آمنًا.

status · stale_after

attestation

هل حُسب هذا الرقم بالطريقة المعتمدة؟

لكل عملية حسابية مستندها المستقل. يملأ الوكلاء المعاملات، ويتأكد فحص حتمي من أن الاستعلام المعتمد هو ما نُفّذ فعلًا.

runtime · parameters · executor · attester

مستويات الثقة

تُستنتج، ولا تُعلَن.

لا يحق لأي مستند أن يصف نفسه بأنه موثوق. يستنتج القارئ المستوى ممن هو مذكور تحت verified، والتقادم من stale_after. ومع تفعيل المراجعة، يلوّن Knowtarium كل ملاحظة وفق هذه القواعد وحدها.

unverifiedلا توجد أي إدخالات في verified.

machine-confirmedلم يؤكده إلا وكلاء أو عمليات، مثل process:ci.

human-reviewedأكّده شخص واحد على الأقل، مثل human:maya.

staleتجاوز الوقت الحالي قيمة stale_after، أيًا كان المستوى.

من فعل ذلك

كل حقل by يسمّي فاعلًا بإحدى ثلاث صيغ. والبادئة human: هي ما يجعل التأكيد يُحتسب مراجعةً من شخص.

claude-code/2.1: وكيل أو أداة، مع إصداره
human:maya: شخص
process:finance-nightly: عملية آلية

Knowtarium وOKF

ما يقرؤه التطبيق وما يكتبه.

يخزّن Knowtarium كل ملاحظة بصيغة OKF، مشفّرة على جهازك. ويلتزم بالمواصفة بدقة، فما تستورده يخرج منه حزمةً تعمل مع أي أداة OKF أخرى.

يستورد أي حزمة

استورد حزمة OKF أو خزنة Obsidian إلى مساحة عمل. ولن تمنعك الحقول الناقصة، ولا الأنواع والمفاتيح غير المعروفة، ولا الروابط المعطوبة، من قراءة أي ملاحظة.

التصدير بصيغة OKF عادية

صدّر كل مساحة عمل حزمةَ OKF في ملف zip واحد، يُفك تشفيرها في متصفحك، جاهزةً لأي أداة OKF أخرى.

حقولك تبقى كما كتبتها

مفاتيح الـfrontmatter المخصصة والتعليقات والتنسيق تبقى تمامًا كما كُتبت، كما تطلب المواصفة.

لا يُحتسب اسم شخص بلا توقيعه

لا يُحتسب إدخال human: إلا حين يؤكده تغيير موقّع من ذلك الشخص نفسه، فلا يستطيع الوكيل أن ينسب عمله إليك.

المراجعة اختيارية، وتكتب إدخالًا واحدًا

فعّل المراجعة لمساحة عمل أو مجلد، وحين توافق على تغيير، يُضاف اسمك إلى verified مع الوقت. ولا تكتب المراجعة أي حقل غيره.

السجل يبقى خارج ملاحظاتك

نخزّن النسخ والتعليقات والتواقيع مشفّرةً بجانب كل ملاحظة، فتبقى الملاحظات نفسها بصيغة OKF نظيفة.

الانتقال من Obsidian

خزنتك قطعت معظم الطريق.

خزنة Obsidian هي أصلًا مجلد من ملفات markdown مع frontmatter. استوردها إلى مساحة عمل، أو حوّل نسخة منها دون اتصال باستخدام : تُضاف حقول OKF، وتتحول روابط wikilinks إلى روابط markdown، ويُكتب فهرس، دون أن يُمس شيء مما كتبته.

OKF صيغة مفتوحة نشرتها Google Cloud في مستودع open-knowledge-format على GitHub. وKnowtarium تطبيق مستقل، لا يتبع Google ولا يحظى باعتمادها.