@spaceflow/core 0.7.0 → 0.9.0

package/src/config/config-reader.service.ts

@@ -1,128 +0,0 @@
-/**
- * 系统配置（不包含插件配置）
- */
-export interface SystemConfig {
-  /** 已安装的技能包注册表 */
-  dependencies?: Record<string, string>;
-  /** 支持的编辑器列表 */
-  support?: string[];
-}
-
-/**
- * 插件配置注册信息
- */
-export interface PluginConfigRegistry {
-  /** 插件名称 */
-  name: string;
-  /** 配置 key */
-  configKey?: string;
-  /** 依赖的其他插件配置 */
-  configDependencies?: string[];
-  /** 配置 schema 工厂函数 */
-  configSchema?: () => unknown;
-}
-
-/** 全局插件配置注册表（使用 global 确保跨模块共享） */
-const PLUGIN_REGISTRY_KEY = Symbol.for("spaceflow.pluginRegistry");
-const globalAny = global as any;
-if (!globalAny[PLUGIN_REGISTRY_KEY]) {
-  globalAny[PLUGIN_REGISTRY_KEY] = new Map<string, PluginConfigRegistry>();
-}
-const pluginRegistry: Map<string, PluginConfigRegistry> = globalAny[PLUGIN_REGISTRY_KEY];
-
-/**
- * 注册插件配置（由插件加载器调用）
- */
-export function registerPluginConfig(registry: PluginConfigRegistry): void {
-  if (registry.configKey) {
-    pluginRegistry.set(registry.configKey, registry);
-  }
-}
-
-/**
- * 获取已注册的插件配置
- */
-export function getRegisteredPluginConfig(configKey: string): PluginConfigRegistry | undefined {
-  return pluginRegistry.get(configKey);
-}
-
-/**
- * 配置读取服务
- * 提供三种配置读取方式：
- * 1. getPluginConfig - 读取指定插件的配置
- * 2. getOtherPluginConfig - 读取其他插件的配置（需要在 metadata 中声明依赖）
- * 3. getSystemConfig - 读取系统配置
- */
-export class ConfigReaderService {
-  constructor() {}
-
-  /**
-   * 读取插件的配置
-   * 使用 schema 验证并合并默认值
-   * @param configKey 插件的配置 key
-   * @returns 验证后的插件配置
-   */
-  getPluginConfig<T>(configKey: string): T {
-    const rawConfig = (global as any).spaceflowConfig || {};
-    const userConfig = rawConfig[configKey] ?? {};
-
-    // 从注册表获取 schema 工厂函数
-    const registry = pluginRegistry.get(configKey);
-    const schemaFactory = registry?.configSchema;
-
-    if (!schemaFactory || typeof schemaFactory !== "function") {
-      return userConfig as T;
-    }
-
-    // 调用工厂函数获取 schema
-    const schema = schemaFactory();
-    if (!schema || typeof (schema as any).parse !== "function") {
-      return userConfig as T;
-    }
-
-    // 使用 schema.parse() 验证并填充默认值
-    try {
-      return (schema as any).parse(userConfig) as T;
-    } catch (error) {
-      console.warn(`⚠️ 配置 "${configKey}" 验证失败:`, error);
-      return userConfig as T;
-    }
-  }
-
-  /**
-   * 读取其他插件的配置
-   * 必须在插件的 metadata.configDependencies 中声明依赖
-   * @param fromConfigKey 当前插件的配置 key
-   * @param targetConfigKey 目标插件的配置 key
-   * @returns 合并后的插件配置
-   */
-  getOtherPluginConfig<T>(fromConfigKey: string, targetConfigKey: string): T {
-    const fromRegistry = pluginRegistry.get(fromConfigKey);
-    if (!fromRegistry) {
-      throw new Error(`插件 "${fromConfigKey}" 未注册`);
-    }
-
-    // 检查是否已声明依赖
-    const dependencies = fromRegistry.configDependencies ?? [];
-    if (!dependencies.includes(targetConfigKey)) {
-      throw new Error(
-        `插件 "${fromRegistry.name}" 未声明对 "${targetConfigKey}" 配置的依赖。` +
-          `请在插件 metadata 的 configDependencies 中添加 "${targetConfigKey}"`,
-      );
-    }
-
-    return this.getPluginConfig<T>(targetConfigKey);
-  }
-
-  /**
-   * 读取系统配置（不包含插件配置）
-   * @returns 系统配置
-   */
-  getSystemConfig(): SystemConfig {
-    const rawConfig = (global as any).spaceflowConfig || {};
-    return {
-      dependencies: rawConfig.dependencies,
-      support: rawConfig.support,
-    };
-  }
-}

package/src/config/config-reader.ts

@@ -1,75 +0,0 @@
-import type { ZodSchema } from "zod";
-import { readConfigSync } from "./spaceflow.config";
-import type { IConfigReader } from "../extension-system/types";
-
-/**
- * 配置读取器
- * 不依赖 NestJS，直接读取配置文件
- */
-export class ConfigReader implements IConfigReader {
-  private config: Record<string, unknown>;
-  private schemas = new Map<string, ZodSchema>();
-
-  constructor(cwd?: string) {
-    this.config = readConfigSync(cwd) as Record<string, unknown>;
-  }
-
-  /**
-   * 获取配置值
-   * @param key 配置路径（支持点分隔，如 "gitProvider.token"）
-   */
-  get<T>(key: string): T | undefined {
-    const parts = key.split(".");
-    let current: unknown = this.config;
-    for (const part of parts) {
-      if (current === null || current === undefined) {
-        return undefined;
-      }
-      current = (current as Record<string, unknown>)[part];
-    }
-    return current as T | undefined;
-  }
-
-  /**
-   * 获取插件配置
-   * 使用已注册的 schema 验证并填充默认值
-   * @param key 插件配置 key
-   */
-  getPluginConfig<T>(key: string): T | undefined {
-    const rawConfig = this.config[key] ?? {};
-    const schema = this.schemas.get(key);
-    if (!schema) {
-      return rawConfig as T;
-    }
-    try {
-      return schema.parse(rawConfig) as T;
-    } catch (error) {
-      console.warn(`⚠️ 配置 "${key}" 验证失败:`, error);
-      return rawConfig as T;
-    }
-  }
-
-  /**
-   * 注册配置 schema
-   * @param key 配置 key
-   * @param schema Zod schema
-   */
-  registerSchema(key: string, schema: ZodSchema): void {
-    this.schemas.set(key, schema);
-  }
-
-  /**
-   * 重新加载配置
-   * @param cwd 工作目录
-   */
-  reload(cwd?: string): void {
-    this.config = readConfigSync(cwd) as Record<string, unknown>;
-  }
-
-  /**
-   * 获取原始配置对象
-   */
-  getRawConfig(): Record<string, unknown> {
-    return this.config;
-  }
-}

package/src/config/feishu.config.ts

@@ -1,35 +0,0 @@
-import { z } from "zod";
-import { createConfigLoader } from "./config-loader";
-
-const schemaFactory = () =>
-  z.object({
-    /** 飞书应用 ID */
-    appId: z
-      .string()
-      .default(process.env.FEISHU_APP_ID || "")
-      .describe("飞书应用 ID"),
-    /** 飞书应用密钥 */
-    appSecret: z
-      .string()
-      .default(process.env.FEISHU_APP_SECRET || "")
-      .describe("飞书应用密钥"),
-    /** 应用类型：自建应用或商店应用 */
-    appType: z
-      .enum(["self_build", "store"])
-      .default((process.env.FEISHU_APP_TYPE as "self_build" | "store") || "self_build")
-      .describe("应用类型"),
-    /** 域名：飞书或 Lark */
-    domain: z
-      .enum(["feishu", "lark"])
-      .default((process.env.FEISHU_DOMAIN as "feishu" | "lark") || "feishu")
-      .describe("域名"),
-  });
-
-/** 飞书配置类型 */
-export type FeishuConfig = z.infer<ReturnType<typeof schemaFactory>>;
-
-export const feishuConfig = createConfigLoader({
-  configKey: "feishu",
-  schemaFactory,
-  description: "飞书 SDK 配置",
-});

package/src/config/git-provider.config.ts

@@ -1,29 +0,0 @@
-import { z } from "zod";
-import { createConfigLoader } from "./config-loader";
-import { detectProvider } from "../shared/git-provider/detect-provider";
-
-/** 从环境自动检测的默认值 */
-const detected = detectProvider();
-
-/** Git Provider 配置 Schema */
-const schemaFactory = () =>
-  z.object({
-    /** Git Provider 类型（自动检测或手动指定） */
-    provider: z
-      .enum(["gitea", "github", "gitlab"])
-      .default(detected.provider)
-      .describe("Git Provider 类型 (github | gitea | gitlab)，未指定时自动检测"),
-    /** Git Provider 服务器 URL */
-    serverUrl: z.string().default(detected.serverUrl).describe("Git Provider 服务器 URL"),
-    /** Git Provider API Token */
-    token: z.string().default(detected.token).describe("Git Provider API Token"),
-  });
-
-/** Git Provider 配置类型 */
-export type GitProviderConfig = z.infer<ReturnType<typeof schemaFactory>>;
-
-export const gitProviderConfig = createConfigLoader({
-  configKey: "gitProvider",
-  schemaFactory,
-  description: "Git Provider 服务配置",
-});

package/src/config/llm.config.ts

@@ -1,110 +0,0 @@
-import { z } from "zod";
-import { createConfigLoader } from "./config-loader";
-
-const schemaFactory = () => {
-  /** Claude Code 适配器配置 Schema */
-  const ClaudeCodeConfigSchema = z.object({
-    baseUrl: z
-      .string()
-      .default(process.env.CLAUDE_CODE_BASE_URL || "")
-      .describe("API 基础 URL"),
-    authToken: z
-      .string()
-      .default(process.env.CLAUDE_CODE_AUTH_TOKEN || "")
-      .describe("认证令牌"),
-    model: z
-      .string()
-      .default(process.env.CLAUDE_CODE_MODEL || "claude-sonnet-4-5")
-      .describe("模型名称"),
-    hasCompletedOnboarding: z.boolean().optional().describe("是否已完成 Claude Code 引导流程"),
-  });
-
-  /** OpenAI 适配器配置 Schema */
-  const OpenAIConfigSchema = z.object({
-    baseUrl: z
-      .string()
-      .default(process.env.OPENAI_BASE_URL || "")
-      .describe("API 基础 URL"),
-    apiKey: z
-      .string()
-      .default(process.env.OPENAI_API_KEY || "")
-      .describe("API Key"),
-    model: z
-      .string()
-      .default(process.env.OPENAI_MODEL || "gpt-4o")
-      .describe("模型名称"),
-  });
-
-  /** OpenCode 适配器配置 Schema */
-  const OpenCodeConfigSchema = z.object({
-    serverUrl: z
-      .string()
-      .default(process.env.OPENCODE_SERVER_URL || "http://localhost:4096")
-      .describe("服务器 URL"),
-    baseUrl: z
-      .string()
-      .default(process.env.OPENCODE_BASE_URL || "")
-      .describe("API 基础 URL"),
-    apiKey: z
-      .string()
-      .default(process.env.OPENCODE_API_KEY || "")
-      .describe("API Key"),
-    providerID: z
-      .string()
-      .default(process.env.OPENCODE_PROVIDER_ID || "openai")
-      .describe("Provider ID"),
-    model: z
-      .string()
-      .default(process.env.OPENCODE_MODEL || "")
-      .describe("模型名称"),
-  });
-
-  /** Gemini 适配器配置 Schema */
-  const GeminiConfigSchema = z.object({
-    baseUrl: z
-      .string()
-      .default(process.env.GEMINI_BASE_URL || "")
-      .describe("API 基础 URL"),
-    apiKey: z
-      .string()
-      .default(process.env.GEMINI_API_KEY || "")
-      .describe("API Key"),
-    model: z
-      .string()
-      .default(process.env.GEMINI_MODEL || "")
-      .describe("模型名称"),
-  });
-
-  /** LLM 配置 Schema */
-  const LlmConfigSchema = z.object({
-    claudeCode: z
-      .preprocess((v) => v ?? {}, ClaudeCodeConfigSchema)
-      .describe("Claude Code 适配器配置"),
-    openai: z.preprocess((v) => v ?? {}, OpenAIConfigSchema).describe("OpenAI 适配器配置"),
-    openCode: z.preprocess((v) => v ?? {}, OpenCodeConfigSchema).describe("OpenCode 适配器配置"),
-    gemini: z.preprocess((v) => v ?? {}, GeminiConfigSchema).describe("Gemini 适配器配置"),
-  });
-
-  return LlmConfigSchema;
-};
-
-/** LLM 系统配置类型 */
-export type LlmConfig = z.infer<ReturnType<typeof schemaFactory>>;
-
-/** Claude Code 适配器配置类型 */
-export type ClaudeCodeConfig = z.infer<LlmConfig["claudeCode"]>;
-
-/** OpenAI 适配器配置类型 */
-export type OpenAIConfig = z.infer<LlmConfig["openai"]>;
-
-/** OpenCode 适配器配置类型 */
-export type OpenCodeConfig = z.infer<LlmConfig["openCode"]>;
-
-/** Gemini 适配器配置类型 */
-export type GeminiConfig = z.infer<LlmConfig["gemini"]>;
-
-export const llmConfig = createConfigLoader({
-  configKey: "llm",
-  schemaFactory,
-  description: "LLM 服务配置",
-});

package/src/config/load-env.ts

@@ -1,15 +0,0 @@
-import { config } from "dotenv";
-import { existsSync } from "fs";
-
-/**
- * 加载 .env 文件
- * 按优先级从高到低加载，先加载的变量不会被后加载的覆盖
- * @param paths .env 文件路径列表（按优先级从高到低排列）
- */
-export function loadEnvFiles(paths: string[]): void {
-  for (const envPath of paths) {
-    if (existsSync(envPath)) {
-      config({ path: envPath, override: false });
-    }
-  }
-}

package/src/config/storage.config.ts

@@ -1,33 +0,0 @@
-import { z } from "zod";
-import { createConfigLoader } from "./config-loader";
-
-/** Storage 配置 Schema */
-const schemaFactory = () =>
-  z.object({
-    /** 适配器类型：memory 或 file */
-    adapter: z
-      .enum(["memory", "file"])
-      .default((process.env.STORAGE_ADAPTER as "memory" | "file") || "memory")
-      .describe("适配器类型"),
-    /** 文件适配器的存储路径（仅 file 适配器需要） */
-    filePath: z.string().optional().describe("文件存储路径"),
-    /** 默认过期时间（毫秒），0 表示永不过期 */
-    defaultTtl: z
-      .number()
-      .default(process.env.STORAGE_DEFAULT_TTL ? parseInt(process.env.STORAGE_DEFAULT_TTL, 10) : 0)
-      .describe("默认过期时间（毫秒）"),
-    /** 最大 key 数量，0 表示不限制 */
-    maxKeys: z
-      .number()
-      .default(process.env.STORAGE_MAX_KEYS ? parseInt(process.env.STORAGE_MAX_KEYS, 10) : 0)
-      .describe("最大 key 数量"),
-  });
-
-/** Storage 配置类型 */
-export type StorageConfig = z.infer<ReturnType<typeof schemaFactory>>;
-
-export const storageConfig = createConfigLoader({
-  configKey: "storage",
-  schemaFactory,
-  description: "存储服务配置",
-});

package/src/shared/i18n/i18n.ts

@@ -1,112 +0,0 @@
-import * as i18nextModule from "i18next";
-import type { TOptions, i18n } from "i18next";
-
-// 兼容 CJS/ESM 混合环境
-const i18next: i18n =
-  (i18nextModule as unknown as { default: i18n }).default || (i18nextModule as unknown as i18n);
-import { detectLocale } from "./locale-detect";
-import zhCN from "../../locales/zh-cn/translation.json";
-import en from "../../locales/en/translation.json";
-
-/** 默认命名空间 */
-const DEFAULT_NS = "translation";
-
-/** globalThis 上的 key，确保多份 core 实例共享同一个 i18n 状态 */
-const GLOBAL_I18N_KEY = "__spaceflow_i18n__";
-
-interface GlobalI18nState {
-  instance: i18n;
-  initialized: boolean;
-}
-
-/**
- * 获取全局 i18n 状态（单例）
- * 无论有几份 @spaceflow/core 实例，都共享同一个 i18next 实例
- */
-function getGlobalState(): GlobalI18nState {
-  const g = globalThis as Record<string, unknown>;
-  if (!g[GLOBAL_I18N_KEY]) {
-    g[GLOBAL_I18N_KEY] = {
-      instance: i18next,
-      initialized: false,
-    } satisfies GlobalI18nState;
-  }
-  return g[GLOBAL_I18N_KEY] as GlobalI18nState;
-}
-
-/**
- * 初始化 i18n
- * 当提供 resources 且无后端加载器时，i18next.init() 同步完成
- * @param lang 指定语言，不传则自动检测
- */
-export function initI18n(lang?: string): void {
-  const state = getGlobalState();
-  if (state.initialized) return;
-  const lng = lang || detectLocale();
-  // i18next v25+ 移除了 initSync，但提供内联 resources 时 init() 同步完成
-  void state.instance.init({
-    lng,
-    fallbackLng: "zh-CN",
-    defaultNS: DEFAULT_NS,
-    ns: [DEFAULT_NS],
-    resources: {
-      "zh-CN": { [DEFAULT_NS]: zhCN },
-      en: { [DEFAULT_NS]: en },
-    },
-    interpolation: {
-      escapeValue: false,
-    },
-    returnNull: false,
-    returnEmptyString: false,
-    // 确保 init 同步完成（默认 initImmediate: true 会将加载推到 setTimeout）
-    initImmediate: false,
-    // i18next v25.8+ 会在 init 时输出 locize.com 推广日志
-    showSupportNotice: false,
-  });
-  state.initialized = true;
-}
-
-/**
- * 重置 i18n 状态（仅用于测试）
- */
-export function resetI18n(): void {
-  const state = getGlobalState();
-  state.initialized = false;
-}
-
-/**
- * 翻译函数
- * 通过 globalThis 共享 i18next 实例，确保多份 core 实例下翻译一致
- * @param key 翻译 key
- * @param options 插值参数
- */
-export function t(key: string, options?: TOptions): string {
-  const state = getGlobalState();
-  if (!state.initialized) {
-    initI18n();
-  }
-  return state.instance.t(key, options) as string;
-}
-
-/**
- * 为外部 Extension 注册语言资源
- * @param ns 命名空间（通常为 Extension name）
- * @param resources 语言资源，key 为语言代码，值为翻译对象
- */
-export function addLocaleResources(
-  ns: string,
-  resources: Record<string, Record<string, unknown>>,
-): void {
-  const state = getGlobalState();
-  if (!state.initialized) {
-    initI18n();
-  }
-  for (const [lng, translations] of Object.entries(resources)) {
-    state.instance.addResourceBundle(lng, ns, translations, true, true);
-  }
-  if (!state.instance.options.ns) {
-    state.instance.options.ns = [DEFAULT_NS, ns];
-  } else if (Array.isArray(state.instance.options.ns) && !state.instance.options.ns.includes(ns)) {
-    state.instance.options.ns.push(ns);
-  }
-}

package/src/shared/i18n/index.ts

@@ -1 +0,0 @@
-export { initI18n, t, addLocaleResources } from "./i18n";