feat(types): 添加 IKernel 和 RuntimePlugin 接口定义以支持插件架构

Author: hotlong

content/docs/references/types/IKernel.mdx

@@ -0,0 +1,30 @@
+---
+title: IKernel (Interface)
+description: Kernel 接口契约
+---
+
+`IKernel` 是插件与宿主系统交互的核心接口。为了保持插件的独立性和可测试性，插件不应直接依赖 Kernel 的具体实现类，而应依赖此接口。
+
+## 接口定义
+
+```typescript
+export interface IKernel {
+    /**
+     * 启动内核
+     * 初始化所有已注册的插件和驱动
+     */
+    start(): Promise<void>;
+
+    /**
+     * 获取 ObjectQL 引擎实例
+     */
+    getEngine(): ObjectQL;
+
+    /**
+     * 获取上下文对象
+     */
+    getContext(): RuntimeContext;
+    
+    // ... 更多生命周期方法
+}
+```

content/docs/references/types/RuntimePlugin.mdx

@@ -0,0 +1,45 @@
+---
+title: RuntimePlugin (Interface)
+description: 运行时插件接口
+---
+
+所有扩展 ObjectStack 功能的模块必须实现此接口。
+
+## 接口定义
+
+```typescript
+export interface RuntimePlugin {
+    /**
+     * 插件唯一标识符
+     * 推荐格式: com.organization.plugin-name
+     */
+    name: string;
+
+    /**
+     * 安装阶段
+     * 在 Kernel 初始化时调用，用于注册 Hook 或扩展 Schema
+     */
+    install?: (ctx: RuntimeContext) => void | Promise<void>;
+
+    /**
+     * 启动阶段
+     * 在 Kernel 启动时调用，用于初始化服务（如启动 HTTP Server）
+     */
+    onStart?: (ctx: RuntimeContext) => void | Promise<void>;
+}
+```
+
+## 依赖关系
+
+插件应声明它依赖于 `@objectstack/types` 而不是具体运行时。
+
+```json
+{
+  "dependencies": {
+    "@objectstack/types": "*"
+  },
+  "peerDependencies": {
+    "@objectstack/runtime": "*"
+  }
+}
+```

content/docs/specifications/server/kernel-architecture.cn.mdx

@@ -9,28 +9,21 @@ import { Cpu, ShieldCheck, RefreshCw, Zap } from 'lucide-react';
 
 它充当位于 API 和数据库驱动程序之间的中间件内核，确保每次数据访问都经过身份验证、授权并符合业务规则。
 
-## 内核层
-
-### 1. 身份层（谁？）
-在任何逻辑运行之前，内核解析行为者。
-*   **身份验证：** OIDC、SAML 或 LDAP。
-*   **会话管理：** 无状态 JWT 或会话存储。
-*   **上下文注入：** 将 `userId`、`role` 和 `organization` 加载到请求上下文中。
-
-### 2. 策略层（他们可以吗？）
-内核强制执行**"纵深防御"**安全模型。
-*   **配置文件检查：** 此用户是否有使用此应用的许可证？
-*   **对象权限：** 他们可以 `READ` `Contract` 对象吗？
-*   **字段级安全（FLS）：** 他们可以看到 `contract_value` 吗？
-*   **共享规则：** 他们可以访问*此特定记录*吗？
-
-### 3. 逻辑层（会发生什么？）
-这是"业务逻辑"容器。
-*   **触发器：** 同步逻辑（`beforeInsert`）。
-*   **流程：** 可视化编排（`审批流程`）。
-*   **作业：** 异步任务（`发送电子邮件`）。
-
-### 4. 同步层（它在哪里？）
-ObjectOS 设计为**本地优先**操作。
-*   **变更数据捕获（CDC）：** 跟踪每个事务的"增量"。
-*   **复制：** 将这些增量同步到边缘设备（SQLite）或数据仓库（Snowflake）。
+## 架构组件
+
+```mermaid
+graph TD
+    A[外部 API 请求] --> B(Host / Adapter Layer);
+    B --> C{ObjectStack Kernel};
+    C --> D[Plugin: Identity Provider];
+    C --> E[Plugin: Authorization Engine];
+    C --> F[ObjectQL Engine];
+    F --> G[Schema Registry];
+    F --> H[Driver Layer];
+```
+
+*   **Host (Adapter)**: 适配不同的运行环境（Hono/Node, Next.js/Edge, Electron）。
+*   **Kernel**: 核心控制器，负责加载插件、管理上下文。
+*   **Plugins**: 可插拔的能力模块（如 Auth, Audit, Workflow）。
+*   **ObjectQL**: 纯逻辑引擎，负责数据查询解析与验证。
+*   **Driver**: 实际的 I/O 执行者。

examples/host/debug-registry.ts

@@ -0,0 +1,34 @@
+
+import { ObjectStackKernel } from '@objectstack/runtime';
+import { SchemaRegistry, ObjectQL } from '@objectstack/objectql';
+import { InMemoryDriver } from '@objectstack/driver-memory';
+
+import TodoApp from '@objectstack/example-todo/objectstack.config';
+
+(async () => {
+    console.log('--- Debug Registry ---');
+    console.log('Apps:', [TodoApp.name]);
+    console.log('Objects inside App:', TodoApp.objects?.map((o: any) => o.name));
+
+    const kernel = new ObjectStackKernel([
+        TodoApp,
+        new InMemoryDriver()
+    ]);
+    
+    await kernel.start();
+    
+    console.log('--- Post Start ---');
+    
+    // Check Registry directly
+    const obj = SchemaRegistry.getObject('todo_task');
+    console.log('Registry "todo_task":', obj ? 'FOUND' : 'MISSING');
+    
+    // Check Registry via Engine
+    try {
+        // Access private engine map if possible or simulate query
+        // The engine doesn't expose a 'hasObject' method easily, but we can inspect internal logic
+        // Actually SchemaRegistry is static, so if it's there, it's there.
+    } catch (e) {
+        console.error(e);
+    }
+})();

examples/host/package.json

@@ -7,12 +7,13 @@
     "clean": "rm -rf dist node_modules"
   },
   "dependencies": {
-    "@objectstack/runtime": "workspace:*",
     "@objectstack/driver-memory": "workspace:*",
-    "@objectstack/plugin-hono-server": "workspace:*",
     "@objectstack/example-crm": "workspace:*",
     "@objectstack/example-todo": "workspace:*",
-    "@objectstack/plugin-bi": "workspace:*"
+    "@objectstack/objectql": "workspace:*",
+    "@objectstack/plugin-bi": "workspace:*",
+    "@objectstack/plugin-hono-server": "workspace:*",
+    "@objectstack/runtime": "workspace:*"
   },
   "devDependencies": {
     "ts-node": "^10.9.1",