دستخط شدہ پیکیج محدود hardware، MAVLink، telemetry، mission اور network صلاحیتیں پاتا، الگ عمل میں چلتا اور قابلِ جانچ IPC سے میزبان سے بات کرتا ہے۔ ایکسٹینشن کی خرابی پرواز کی اہم خدمات بند نہیں کرے۔
ایکسٹینشن ماڈل اور CLI مجوزہ معاہدہ ہیں؛ KairOS registry، signing root اور عوامی SDK ابھی جاری نہیں ہوئے۔
KairOS ریپوزٹری ↗اس صفحے پر +
حفاظت کی پانچ حدود
پیکیج
ایکسٹینشن .kairosplug میں manifest، version، entry point، مطلوبہ صلاحیتوں اور دستخط کے ساتھ پیک ہوتی ہے۔
اعتماد
کھولنے سے پہلے Ed25519 دستخط جانچے جاتے ہیں؛ آغاز پر منسوخی کی فہرست نافذ ہوتی ہے۔ بغیر دستخط صرف developer mode میں اجازت ہے۔
آپریٹر کی اجازت
تنصیب سے پہلے انسان کو اجازتیں دکھائی جاتی ہیں؛ حساس اجازتوں کے لیے الگ دوبارہ تصدیق ضروری ہے۔
عمل کی حد
ہر پلگ اِن اپنے subprocess/cgroup میں CPU، میموری اور PID حدود کے ساتھ چلتا ہے۔
صلاحیت پر مبنی IPC
Unix socket پر msgpack RPC ہر host API کال پر capability token جانچتا ہے۔
اجازتیں حقیقی وسائل کے مطابق گروہ بند ہیں
| گروہ | صلاحیتوں کی مثالیں |
|---|---|
| ہارڈ ویئر | UART, I²C, SPI, GPIO, USB serial/UVC, CSI |
| MAVLink | اپنے component کو پڑھنا، لکھنا اور رجسٹر کرنا |
| ٹیلی میٹری | سبسکرائب کرنا، توسیع اور واقعہ شائع کرنا |
| سینسر / پے لوڈ | سینسر یا payload انٹرفیس کا اندراج |
| مشن | مشن ڈیٹا پڑھنا، لکھنا اور ریکارڈ کرنا |
| نیٹ ورک | HTTPS egress صرف manifest allowlist تک |
اجازت پورے نظام تک براہِ راست رسائی نہیں۔ مثلاً UART اجازت مخصوص device یا brokered handle دے، اور network egress صرف پہلے بتائے گئے domains تک ہو۔ آپریٹر Mission Control سے اجازت منسوخ کر سکتا ہے۔
Manifest اور کم سے کم پلگ اِن سیاق
name: cell-balance-monitor
version: 0.1.0
agent:
entry: cell_balance:run
capabilities:
- telemetry.read
- event.publishfrom kairos_sdk import PluginContext
async def run(ctx: PluginContext):
async for battery in ctx.telemetry.subscribe("telemetry.battery"):
cells = battery.get("cells", [])
if cells and max(cells) - min(cells) > 0.15:
await ctx.events.publish(
"alert.cell_imbalance",
{"spread_v": max(cells) - min(cells)},
)تنصیب، اجازتیں، لاگ اور ٹیسٹ
kairos plugin install ./thermal-cam.kairosplug
kairos plugin enable thermal-cam
kairos plugin list
kairos plugin disable <name>
kairos plugin remove <name>
kairos plugin info <name>
kairos plugin perms <name>
kairos plugin logs <name>
kairos plugin test <path>install پیکیج اور دستخط جانچ کر مطلوبہ اجازتیں دکھاتا ہے۔ enable صرف اجازت کے بعد عمل چلاتا ہے۔ info اور perms آڈٹ، logs تشخیص اور test مقامی تخلیقی عمل کے لیے ہیں۔ ہٹانے پر عمل بند اور اس کی محدود حالت صاف ہو، دوسرے ایکسٹینشن متاثر نہ ہوں۔
تین بنیادی پلگ اِن اور آلات کے ایکسٹینشن
geofence
مجاز زون کے لحاظ سے مقام جانچ کر قابلِ مشاہدہ واقعہ شائع کرتا ہے۔
telemetry-logger
حجم کی حد اور واضح حیاتی دور کے ساتھ منتخب ٹیلی میٹری بہاؤ ریکارڈ کرتا ہے۔
mavlink-inspector
ابتدائی طور پر فلائٹ حالت بدلے بغیر تشخیص کے لیے فریم دکھاتا ہے۔
حرارتی کیمرا
FLIR Lepton USB UVC، radiometric Y16، Celsius، palette/isotherm اور MAVLink کیمرا انٹرفیس۔
MAVLink Gimbal v2
بیرونی کنٹرولر کا پل، زاویائی کمانڈ/حالت اور component 154۔
پہلے ریلیز اور بعد کے مراحل الگ ہیں
| پہلا مجوزہ ریلیز | اگلا مرحلہ |
|---|---|
| مقامی دستخط شدہ تنصیب | میزبانی شدہ قابلِ تلاش رجسٹری |
| ہر IPC پر صلاحیت کی جانچ | عوامی الگ kairos_sdk پیکیج |
| اندرونی پلگ اِن اور CLI | Scaffolder اور سانچے |
| اجازتوں کا جائزہ اور منسوخی | Git URL سے تنصیب |
| ٹیسٹ رنر | مشترکہ ڈرائیور تہہ اور مکمل تخلیقی دستاویزات |