@spaceflow/core 0.20.0 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaceflow/core",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "Spaceflow 核心能力库",
   "license": "MIT",
   "author": "Lydanne",

package/src/__mocks__/c12.ts

@@ -1,3 +1,5 @@
-export const loadConfig = jest.fn().mockResolvedValue({
+import { vi, type Mock } from "vitest";
+
+export const loadConfig: Mock = vi.fn().mockResolvedValue({
   config: {},
 });

package/src/cli-runtime/i18n/i18n.spec.ts

@@ -1,4 +1,5 @@
-import { initI18n, t, addLocaleResources, resetI18n } from "./i18n";
+import { t, addLocaleResources, resetI18n } from "./i18n";
+import { initCliI18n as initI18n } from "./init";
 import zhCN from "../../locales/zh-cn/translation.json";
 import en from "../../locales/en/translation.json";
 

package/src/commands/build/build.service.ts

@@ -117,7 +117,7 @@ export class BuildService {
   private discoverExtensionDirs(): string[] {
     const dependencies = getDependencies(this.projectRoot);
     const parentDirs = new Set<string>();
-    for (const source of Object.values(dependencies)) {
+    for (const source of Object.values(dependencies) as string[]) {
       if (!source.startsWith("link:")) continue;
       const linkPath = source.slice(5);
       const absolutePath = resolve(this.projectRoot, linkPath);

package/src/commands/install/install.service.ts

@@ -66,7 +66,7 @@ export interface McpExportItem {
  * 插件配置类型
  */
 export type PluginConfig = Record<
-  "flows" | "commands" | "extensions",
+  "flows" | "commands" | "skills",
   Array<{ name: string; entry: string }>
 > & {
   mcps: McpExportItem[];
@@ -97,10 +97,10 @@ export class InstallService {
 
   /**
    * 将插件关联到各个编辑器的目录
-   * pluginConfig 包含 flows/commands/extensions/mcps 四种类型
+   * pluginConfig 包含 flows/commands/skills/mcps 四种类型
    * - flows: CLI 子命令，不需要复制到编辑器目录
    * - commands: 编辑器命令，复制到 .claude/commands/ 等目录
-   * - extensions: 扩展包，复制到 .claude/skills/ 等目录
+   * - skills: 技能文件，复制到 .claude/skills/ 等目录
    * - mcps: MCP Server，注册到编辑器的 mcp.json 配置
    */
   protected async linkPluginToEditors(options: {
@@ -120,19 +120,19 @@ export class InstallService {
       const editorDirName = getEditorDirName(editor);
       const editorRoot = isGlobal ? join(home, editorDirName) : join(workingDir, editorDirName);
 
-      // 处理 extensions
-      if (pluginConfig.extensions.length > 0) {
-        const editorExtensionsDir = join(editorRoot, "skills");
-        await this.ensureDir(editorExtensionsDir, verbose);
+      // 处理 skills
+      if (pluginConfig.skills.length > 0) {
+        const editorSkillsDir = join(editorRoot, "skills");
+        await this.ensureDir(editorSkillsDir, verbose);
 
-        for (const ext of pluginConfig.extensions) {
-          const extPath = ext.entry === "." ? depPath : join(depPath, ext.entry);
-          const installName = ext.name || name;
-          const targetPath = join(editorExtensionsDir, installName);
+        for (const skill of pluginConfig.skills) {
+          const skillPath = skill.entry === "." ? depPath : join(depPath, skill.entry);
+          const installName = skill.name || name;
+          const targetPath = join(editorSkillsDir, installName);
 
-          await this.copyExtensionToTarget(extPath, targetPath, installName);
+          await this.copyExtensionToTarget(skillPath, targetPath, installName);
 
-          // 将生成的扩展加入编辑器目录的 .gitignore
+          // 将生成的技能文件加入编辑器目录的 .gitignore
           await ensureEditorGitignore(editorRoot, "skills", installName);
         }
       }
@@ -676,7 +676,7 @@ export class InstallService {
       console.warn(t("install:pmInstallFailed", { pm }));
     }
 
-    // 3. 处理每个依赖的 extensions/commands 关联
+    // 3. 处理每个依赖的 skills/commands 关联
     for (const [name, config] of Object.entries(dependencies)) {
       const { source } = this.parseExtensionConfig(config);
       const sourceType = getSourceType(source);
@@ -1030,19 +1030,19 @@ export class InstallService {
 
   /**
    * 从 package.json 读取插件配置
-   * 返回 { flows: [], commands: [], extensions: [], mcps: [] } 格式的导出映射
+   * 返回 { flows: [], commands: [], skills: [], mcps: [] } 格式的导出映射
    */
   protected async getPluginConfigFromPackageJson(extPath: string): Promise<PluginConfig> {
     const createEmptyConfig = (): PluginConfig => ({
       flows: [],
       commands: [],
-      extensions: [],
+      skills: [],
       mcps: [],
     });
-    const createDefaultExtension = (name = ""): PluginConfig => ({
+    const createDefaultSkill = (name = ""): PluginConfig => ({
       flows: [],
       commands: [],
-      extensions: [{ name, entry: "." }],
+      skills: [{ name, entry: "." }],
       mcps: [],
     });
 
@@ -1055,13 +1055,13 @@ export class InstallService {
     ) => {
       if (type === "flow") config.flows.push({ name, entry });
       else if (type === "command") config.commands.push({ name, entry });
-      else if (type === "extension") config.extensions.push({ name, entry });
+      else if (type === "skill") config.skills.push({ name, entry });
       else if (type === "mcp") config.mcps.push({ name, entry, mcp });
     };
 
     const pkgJsonPath = join(extPath, "package.json");
     if (!existsSync(pkgJsonPath)) {
-      return createDefaultExtension();
+      return createDefaultSkill();
     }
 
     try {
@@ -1070,7 +1070,7 @@ export class InstallService {
       const spaceflowConfig = pkg.spaceflow;
 
       if (!spaceflowConfig) {
-        return createDefaultExtension(pkg.name);
+        return createDefaultSkill(pkg.name);
       }
 
       const config = createEmptyConfig();
@@ -1100,9 +1100,9 @@ export class InstallService {
         return config;
       }
 
-      return createDefaultExtension(pkg.name);
+      return createDefaultSkill(pkg.name);
     } catch {
-      return createDefaultExtension();
+      return createDefaultSkill();
     }
   }
 

package/src/commands/list/list.service.ts

@@ -46,7 +46,7 @@ export class ListService {
     const editors = getSupportedEditors(cwd);
     // 收集所有外部扩展信息
     const extensionInfos: ExtensionListInfo[] = [];
-    for (const [name, source] of Object.entries(dependencies)) {
+    for (const [name, source] of Object.entries(dependencies) as [string, string][]) {
       const type = getSourceType(source);
       const installed = await this.checkInstalled(name, source, type, editors);
       extensionInfos.push({ name, source, type, installed, commands: [] });

package/src/commands/update/update.service.ts

@@ -312,7 +312,7 @@ export class UpdateService {
       return false;
     }
 
-    const { source } = this.parseExtensionConfig(dependencies[name]);
+    const { source } = this.parseExtensionConfig(dependencies[name] as ExtensionConfig);
     const sourceType = this.getSourceType(source);
 
     if (shouldLog(verbose, 1)) console.log(t("update:updating", { name }));
@@ -344,7 +344,7 @@ export class UpdateService {
     let successCount = 0;
     let failCount = 0;
 
-    for (const [name, config] of Object.entries(dependencies)) {
+    for (const [name, config] of Object.entries(dependencies) as [string, ExtensionConfig][]) {
       const { source } = this.parseExtensionConfig(config);
       const sourceType = this.getSourceType(source);
 

package/src/config/spaceflow.config.ts

@@ -41,15 +41,15 @@ const GitProviderConfigSchema = z.object({
 const CiConfigSchema = z.object({
   repository: z
     .string()
-    .default(process.env.GITHUB_REPOSITORY || "")
+    .default(process.env.GITHUB_REPOSITORY || process.env.GITEA_REPOSITORY || "")
     .describe("仓库名称 (owner/repo 格式)"),
   refName: z
     .string()
-    .default(process.env.GITHUB_REF_NAME || "")
+    .default(process.env.GITHUB_REF_NAME || process.env.GITEA_REF_NAME || "")
     .describe("当前分支名称"),
   actor: z
     .string()
-    .default(process.env.GITHUB_ACTOR || "")
+    .default(process.env.GITHUB_ACTOR || process.env.GITEA_ACTOR || "")
     .describe("当前操作者"),
 });
 

package/src/shared/git-provider/detect-provider.ts

@@ -65,7 +65,7 @@ function buildResult(
  * 解析服务器 URL
  * - 优先使用 GIT_PROVIDER_URL
  * - Gitea: GITEA_SERVER_URL > GITHUB_SERVER_URL
- * - GitHub: GITHUB_API_URL > 默认 https://api.github.com
+ * - GitHub: GITHUB_API_URL > GITEA_API_URL > 默认 https://api.github.com
  * - GitLab: CI_SERVER_URL > GITLAB_URL
  */
 function resolveServerUrl(
@@ -76,7 +76,7 @@ function resolveServerUrl(
     return env.GIT_PROVIDER_URL;
   }
   if (provider === "github") {
-    return env.GITHUB_API_URL || "https://api.github.com";
+    return env.GITHUB_API_URL || env.GITEA_API_URL || "https://api.github.com";
   }
   if (provider === "gitlab") {
     return env.CI_SERVER_URL || env.GITLAB_URL || "https://gitlab.com";
@@ -95,7 +95,7 @@ function resolveServerUrl(
  * 解析 API Token
  * - 优先使用 GIT_PROVIDER_TOKEN
  * - Gitea: GITEA_TOKEN > GITHUB_TOKEN
- * - GitHub: GITHUB_TOKEN
+ * - GitHub: GITHUB_TOKEN > GITEA_TOKEN
  * - GitLab: GITLAB_TOKEN > CI_JOB_TOKEN
  */
 function resolveToken(provider: GitProviderType, env: Record<string, string | undefined>): string {
@@ -103,7 +103,7 @@ function resolveToken(provider: GitProviderType, env: Record<string, string | un
     return env.GIT_PROVIDER_TOKEN;
   }
   if (provider === "github") {
-    return env.GITHUB_TOKEN || "";
+    return env.GITHUB_TOKEN || env.GITEA_TOKEN || "";
   }
   if (provider === "gitlab") {
     return env.GITLAB_TOKEN || env.CI_JOB_TOKEN || "";

package/src/shared/logger/logger.spec.ts

@@ -10,9 +10,9 @@ describe("Logger", () => {
 
   beforeEach(() => {
     consoleSpy = {
-      log: vi.spyOn(console, "log").mockImplementation(),
-      warn: vi.spyOn(console, "warn").mockImplementation(),
-      error: vi.spyOn(console, "error").mockImplementation(),
+      log: vi.spyOn(console, "log").mockImplementation(() => {}),
+      warn: vi.spyOn(console, "warn").mockImplementation(() => {}),
+      error: vi.spyOn(console, "error").mockImplementation(() => {}),
     };
   });