@zhin.js/core 1.1.0 → 1.1.2

package/src/built/schema-feature.ts

@@ -1,190 +0,0 @@
-/**
- * SchemaFeature — 插件配置 Schema 注册表
- *
- * 插件通过 declareConfig(key, schema) 声明配置项及其 Schema，
- * SchemaFeature 全局收集后供 Web 控制台渲染配置编辑表单。
- *
- * 与 ConfigFeature 协作：
- *   - declareConfig 内部调用 addConfig(key, defaults) 写入默认值
- *   - Schema.toJSON() 传给前端驱动 PluginConfigForm
- *   - reloadable 标记决定保存后是否自动重载插件
- */
-
-import { Feature, FeatureJSON } from '../feature.js';
-import { Schema } from '@zhin.js/schema';
-import { Plugin, getPlugin } from '../plugin.js';
-
-// ============================================================================
-// 类型
-// ============================================================================
-
-export interface SchemaRecord {
-  /** 配置 key（对应 zhin.config.yml 中的顶级字段） */
-  key: string;
-  /** Schema 实例 */
-  schema: Schema;
-  /** 保存后是否支持热重载（http/database 等底层服务应为 false） */
-  reloadable: boolean;
-}
-
-export interface SchemaContextExtensions {
-  /**
-   * 声明插件配置 Schema
-   * @param key 配置 key，如 "rss"
-   * @param schema Schema.object({...}) 定义
-   * @param options.reloadable 保存后是否自动重载，默认 true
-   * @returns 当前配置值（已合并默认值）
-   */
-  declareConfig<T extends Record<string, any>>(
-    key: string,
-    schema: Schema<T>,
-    options?: { reloadable?: boolean },
-  ): Required<T>;
-}
-
-declare module '../plugin.js' {
-  namespace Plugin {
-    interface Extensions extends SchemaContextExtensions {}
-    interface Contexts {
-      schema: SchemaFeature;
-    }
-  }
-}
-
-// ============================================================================
-// SchemaFeature
-// ============================================================================
-
-export class SchemaFeature extends Feature<SchemaRecord> {
-  readonly name = 'schema' as const;
-  readonly icon = 'FileCode';
-  readonly desc = '配置模型';
-
-  /**
-   * 按配置 key 查找 Schema
-   */
-  getByKey(key: string): SchemaRecord | null {
-    return this.items.find(r => r.key === key) ?? null;
-  }
-
-  /**
-   * 获取指定插件名注册的 Schema
-   */
-  getByPluginName(pluginName: string): SchemaRecord | null {
-    const list = this.getByPlugin(pluginName);
-    return list.length > 0 ? list[0] : null;
-  }
-
-  /**
-   * 获取某个 key 的 Schema 实例（WebSocket handler 使用）
-   */
-  get(keyOrPlugin: string): Schema | null {
-    const byKey = this.getByKey(keyOrPlugin);
-    if (byKey) return byKey.schema;
-    const byPlugin = this.getByPluginName(keyOrPlugin);
-    return byPlugin?.schema ?? null;
-  }
-
-  /**
-   * 判断某个 key 对应的插件是否支持热重载
-   */
-  isReloadable(keyOrPlugin: string): boolean {
-    const byKey = this.getByKey(keyOrPlugin);
-    if (byKey) return byKey.reloadable;
-    const byPlugin = this.getByPluginName(keyOrPlugin);
-    return byPlugin?.reloadable ?? true;
-  }
-
-  /**
-   * 通过 pluginName 获取对应的 config key
-   */
-  resolveConfigKey(pluginName: string): string | null {
-    const byKey = this.getByKey(pluginName);
-    if (byKey) return byKey.key;
-    const byPlugin = this.getByPluginName(pluginName);
-    return byPlugin?.key ?? null;
-  }
-
-  /**
-   * 返回 pluginName → configKey 的映射
-   */
-  getPluginKeyMap(): Map<string, string> {
-    const map = new Map<string, string>();
-    for (const [pluginName, records] of this.pluginItems) {
-      if (records.length > 0) {
-        map.set(pluginName, records[0].key);
-      }
-    }
-    return map;
-  }
-
-  toJSON(pluginName?: string): FeatureJSON {
-    const list = pluginName ? this.getByPlugin(pluginName) : this.items;
-    return {
-      name: this.name,
-      icon: this.icon,
-      desc: this.desc,
-      count: list.length,
-      items: list.map(r => ({
-        name: r.key,
-        reloadable: r.reloadable,
-        schema: r.schema.toJSON(),
-      })),
-    };
-  }
-
-  get extensions() {
-    const feature = this;
-    return {
-      declareConfig<T extends Record<string, any>>(
-        key: string,
-        schema: Schema<T>,
-        options?: { reloadable?: boolean },
-      ): Required<T> {
-        const plugin = getPlugin() as Plugin;
-        const reloadable = options?.reloadable ?? true;
-
-        // 从 Schema 提取默认值
-        const defaults = extractDefaults(schema);
-
-        // 注册到 ConfigFeature（写入 config.yml 的默认值）
-        if (typeof plugin.addConfig === 'function') {
-          plugin.addConfig(key, defaults);
-        }
-
-        // 注册到 SchemaFeature
-        const record: SchemaRecord = { key, schema, reloadable };
-        const dispose = feature.add(record, plugin.name);
-        plugin.recordFeatureContribution(feature.name, key);
-        plugin.onDispose(dispose);
-
-        // 读取当前配置并与默认值合并
-        const root = plugin.root ?? plugin;
-        const configService = root.inject('config') as any;
-        const appConfig = configService?.get?.('zhin.config.yml') ?? {};
-        const current = appConfig[key] ?? {};
-
-        return { ...defaults, ...current } as Required<T>;
-      },
-    };
-  }
-}
-
-// ============================================================================
-// 辅助：从 Schema 提取默认值
-// ============================================================================
-
-function extractDefaults(schema: Schema): Record<string, any> {
-  const json = schema.toJSON();
-  const result: Record<string, any> = {};
-
-  const fields = json.object || json.properties || json.dict || {};
-  for (const [fieldKey, fieldSchema] of Object.entries(fields)) {
-    const field = fieldSchema as Record<string, any>;
-    if (field.default !== undefined) {
-      result[fieldKey] = field.default;
-    }
-  }
-
-  return result;
-}

package/src/built/skill.ts

@@ -1,221 +0,0 @@
-/**
- * SkillFeature — AI 可见能力描述层
- *
- * 核心概念：
- *   Plugin = 运行时容器（生命周期、服务注册、中间件）
- *   Skill  = AI 可见的能力接口（名称、描述、工具列表）
- *
- * Skill 记录由运行时注入（如 Agent 从磁盘 SKILL.md 同步），供 Agent 粗筛与工具关联。
- *
- * SkillFeature 全局收集所有 Skill，供 Agent 进行两级过滤：
- *   1. 粗筛：根据用户消息选择相关 Skill
- *   2. 细筛：从选中 Skill 内选择具体 Tool
- */
-
-import { Feature, FeatureJSON } from '../feature.js';
-import type { Tool } from '../types.js';
-
-// ============================================================================
-// Skill 接口
-// ============================================================================
-
-/**
- * Skill — AI 可见的能力描述
- */
-export interface Skill {
-  /** 技能名称（通常与插件名一致） */
-  name: string;
-
-  /** 技能描述（AI 用来理解这个 Skill 的用途） */
-  description: string;
-
-  /** 该 Skill 提供的工具列表 */
-  tools: Tool[];
-
-  /**
-   * 触发关键词
-   * 当用户消息包含这些关键词时，优先选择此 Skill
-   */
-  keywords?: string[];
-
-  /**
-   * 分类标签
-   * 用于按领域分组（如 'news', 'weather', 'entertainment'）
-   */
-  tags?: string[];
-
-  /** 来源插件名 */
-  pluginName: string;
-
-  /**
-   * SKILL.md 文件的绝对路径
-   * 存在时 activate_skill 可按需加载完整指令内容
-   */
-  filePath?: string;
-
-  /**
-   * 是否常驻注入 system prompt
-   * 仅在 filePath 存在时有效
-   */
-  always?: boolean;
-}
-
-/**
- * SKILL.md frontmatter 常见字段（类型提示；运行时由 Agent 等同步到 SkillFeature）
- */
-export interface SkillMetadata {
-  /** 技能描述（必填） */
-  description: string;
-
-  /** 触发关键词（可选） */
-  keywords?: string[];
-
-  /** 分类标签（可选） */
-  tags?: string[];
-}
-
-declare module '../plugin.js' {
-  namespace Plugin {
-    interface Contexts {
-      skill: SkillFeature;
-    }
-  }
-}
-
-// ============================================================================
-// SkillFeature 实现
-// ============================================================================
-
-export class SkillFeature extends Feature<Skill> {
-  readonly name = 'skill' as const;
-  readonly icon = 'Brain';
-  readonly desc = '技能';
-
-  /** 按名称索引 */
-  readonly byName = new Map<string, Skill>();
-
-  /**
-   * 添加 Skill
-   */
-  add(skill: Skill, pluginName: string): () => void {
-    this.byName.set(skill.name, skill);
-    return super.add(skill, pluginName);
-  }
-
-  /**
-   * 移除 Skill
-   */
-  remove(skill: Skill): boolean {
-    this.byName.delete(skill.name);
-    return super.remove(skill);
-  }
-
-  /**
-   * 按名称获取 Skill
-   */
-  get(name: string): Skill | undefined {
-    return this.byName.get(name);
-  }
-
-  /**
-   * 获取所有已注册 Skill
-   */
-  getAll(): Skill[] {
-    return [...this.items];
-  }
-
-  /**
-   * 按关键词/标签搜索相关 Skill
-   * 返回按相关性排序的 Skill 列表
-   */
-  search(query: string, options?: { maxResults?: number }): Skill[] {
-    const maxResults = options?.maxResults ?? 5;
-    const scored = this.items
-      .map(skill => ({ skill, score: this.#scoreSkill(skill, query) }))
-      .filter(({ score }) => score > 0)
-      .sort((a, b) => b.score - a.score)
-      .slice(0, maxResults);
-
-    return scored.map(({ skill }) => skill);
-  }
-
-  /**
-   * 获取所有 Skill 的工具（扁平化）
-   */
-  collectAllTools(): Tool[] {
-    const tools: Tool[] = [];
-    for (const skill of this.items) {
-      tools.push(...skill.tools);
-    }
-    return tools;
-  }
-
-  /**
-   * 已注册 Skill 数量
-   */
-  get size(): number {
-    return this.items.length;
-  }
-
-  /**
-   * 简单的关键词匹配评分
-   */
-  #scoreSkill(skill: Skill, query: string): number {
-    const lowerQuery = query.toLowerCase();
-    let score = 0;
-
-    // 关键词精确匹配
-    if (skill.keywords) {
-      for (const kw of skill.keywords) {
-        if (lowerQuery.includes(kw.toLowerCase())) score += 1.0;
-      }
-    }
-
-    // 标签匹配
-    if (skill.tags) {
-      for (const tag of skill.tags) {
-        if (lowerQuery.includes(tag.toLowerCase())) score += 0.5;
-      }
-    }
-
-    // 名称匹配
-    if (lowerQuery.includes(skill.name.toLowerCase())) score += 0.3;
-
-    // 描述匹配（双向）
-    const lowerDesc = skill.description.toLowerCase();
-    if (lowerDesc.includes(lowerQuery)) score += 0.2;
-    if (lowerQuery.includes(lowerDesc)) score += 0.15;
-
-    // 工具名/描述匹配
-    for (const tool of skill.tools) {
-      if (lowerQuery.includes(tool.name.toLowerCase())) score += 0.4;
-      if (tool.description && lowerQuery.includes(tool.description.toLowerCase().slice(0, 10))) {
-        score += 0.1;
-      }
-    }
-
-    return score;
-  }
-
-  /**
-   * 序列化为 JSON
-   */
-  toJSON(pluginName?: string): FeatureJSON {
-    const list = pluginName ? this.getByPlugin(pluginName) : this.items;
-    return {
-      name: this.name,
-      icon: this.icon,
-      desc: this.desc,
-      count: list.length,
-      items: list.map(s => ({
-        name: s.name,
-        desc: s.description,
-        toolCount: s.tools.length,
-        keywords: s.keywords,
-        tags: s.tags,
-      })),
-    };
-  }
-}
-
-