@spaceflow/core 0.23.0 → 0.25.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaceflow/core",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "Spaceflow 核心能力库",
   "license": "MIT",
   "author": "Lydanne",
@@ -99,7 +99,7 @@
     "zod-to-json-schema": "^3.25.1",
     "commander": "^12.1.0",
     "i18next": "^25.8.4",
-    "@spaceflow/shared": "0.6.0"
+    "@spaceflow/shared": "0.7.0"
   },
   "devDependencies": {
     "@swc/core": "1.15.3",

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

@@ -16,6 +16,7 @@ import {
   getPackageManager,
   detectPackageManager,
   getSpaceflowDir,
+  getSpaceflowCoreVersion,
   ensureSpaceflowPackageJson,
   ensureEditorGitignore,
   SchemaGeneratorService,
@@ -664,10 +665,32 @@ export class InstallService {
     if (shouldLog(verbose, 1))
       console.log(t("install:foundDeps", { count: Object.keys(dependencies).length }));
 
-    // 1. 先更新 .spaceflow/package.json 中的所有依赖
+    // 1. 记录更新前的 @spaceflow/core 版本
+    const spaceflowPkgPath = join(spaceflowDir, "package.json");
+    let prevCoreVersion: string | undefined;
+    if (existsSync(spaceflowPkgPath)) {
+      try {
+        const prevPkg = JSON.parse(await readFile(spaceflowPkgPath, "utf-8"));
+        prevCoreVersion = prevPkg.dependencies?.["@spaceflow/core"];
+      } catch {
+        // ignore
+      }
+    }
+
+    // 2. 更新 .spaceflow/package.json 中的所有依赖
     await this.updateSpaceflowPackageJson(dependencies, spaceflowDir, verbose);
 
-    // 2. 一次性安装所有依赖
+    // 3. 版本变更提示
+    const currentCoreVersion = getSpaceflowCoreVersion();
+    if (prevCoreVersion && prevCoreVersion !== currentCoreVersion) {
+      if (shouldLog(verbose, 1)) {
+        console.log(
+          t("install:coreVersionChanged", { prev: prevCoreVersion, current: currentCoreVersion }),
+        );
+      }
+    }
+
+    // 4. 安装所有依赖
     if (shouldLog(verbose, 1)) console.log(t("install:installingDeps"));
     const pm = detectPackageManager(spaceflowDir);
     try {
@@ -676,7 +699,7 @@ export class InstallService {
       console.warn(t("install:pmInstallFailed", { pm }));
     }
 
-    // 3. 处理每个依赖的 skills/commands 关联
+    // 5. 处理每个依赖的 skills/commands 关联
     for (const [name, config] of Object.entries(dependencies)) {
       const { source } = this.parseExtensionConfig(config);
       const sourceType = getSourceType(source);

package/src/locales/en/install.json

@@ -36,6 +36,7 @@
   "updatingAll": "🔄 Updating all dependencies...",
   "noDeps": "   No dependencies in config file",
   "foundDeps": "   Found {{count}} dependencies",
+  "coreVersionChanged": "📦 @spaceflow/core version changed: {{prev}} → {{current}}",
   "installingDeps": "\n📦 Installing dependencies...",
   "pmInstallFailed": "   Warning: {{pm}} install failed",
   "depNotInstalled": "   ⚠️ {{name}} not installed successfully, skipping",

package/src/locales/zh-cn/install.json

@@ -36,6 +36,7 @@
   "updatingAll": "🔄 更新所有依赖...",
   "noDeps": "   配置文件中没有 dependencies",
   "foundDeps": "   找到 {{count}} 个依赖",
+  "coreVersionChanged": "📦 @spaceflow/core 版本变更: {{prev}} → {{current}}",
   "installingDeps": "\n📦 安装依赖...",
   "pmInstallFailed": "   警告: {{pm}} install 失败",
   "depNotInstalled": "   ⚠️ {{name}} 未安装成功，跳过",

package/src/shared/git-sdk/git-sdk.service.ts

@@ -1,7 +1,12 @@
 import { spawn, execSync } from "child_process";
+import * as fs from "fs";
+import * as path from "path";
 import type { GitCommit, GitChangedFile, GitDiffFile, GitRunOptions } from "./git-sdk.types";
 import { mapGitStatus, parseDiffText } from "./git-sdk-diff.utils";
 
+/** 本地代码审查模式 */
+export type LocalReviewMode = "uncommitted" | "staged" | false;
+
 export class GitSdkService {
   protected readonly defaultOptions: GitRunOptions = {
     cwd: process.cwd(),
@@ -183,6 +188,17 @@ export class GitSdkService {
     return this.runCommand(["show", `${ref}:${filename}`], options);
   }
 
+  /**
+   * 获取工作区文件的当前内容（包含未提交的修改）
+   * 直接读取文件系统，而不是从 git 获取
+   * @throws 如果文件不存在或无法读取
+   */
+  getWorkingFileContent(filename: string, options?: GitRunOptions): string {
+    const cwd = options?.cwd || process.cwd();
+    const filepath = path.join(cwd, filename);
+    return fs.readFileSync(filepath, "utf-8");
+  }
+
   getCommitDiff(sha: string, options?: GitRunOptions): GitDiffFile[] {
     try {
       const output = this.runCommandSync(["show", "--format=", "--patch", sha], options);
@@ -193,6 +209,147 @@ export class GitSdkService {
     }
   }
 
+  /**
+   * 获取暂存区的变更文件列表
+   */
+  getStagedFiles(options?: GitRunOptions): GitChangedFile[] {
+    try {
+      const output = this.runCommandSync(["diff", "--cached", "--name-status"], options);
+      return this.parseNameStatusOutput(output);
+    } catch {
+      return [];
+    }
+  }
+
+  /**
+   * 获取暂存区的 diff（包含 patch 信息）
+   */
+  getStagedDiff(options?: GitRunOptions): GitDiffFile[] {
+    try {
+      const output = this.runCommandSync(["diff", "--cached"], options);
+      return parseDiffText(output);
+    } catch {
+      return [];
+    }
+  }
+
+  /**
+   * 获取工作区未暂存的变更文件列表
+   */
+  getUnstagedFiles(options?: GitRunOptions): GitChangedFile[] {
+    try {
+      const output = this.runCommandSync(["diff", "--name-status"], options);
+      return this.parseNameStatusOutput(output);
+    } catch {
+      return [];
+    }
+  }
+
+  /**
+   * 获取工作区未暂存的 diff（包含 patch 信息）
+   */
+  getUnstagedDiff(options?: GitRunOptions): GitDiffFile[] {
+    try {
+      const output = this.runCommandSync(["diff"], options);
+      return parseDiffText(output);
+    } catch {
+      return [];
+    }
+  }
+
+  /**
+   * 获取所有未提交的变更文件（暂存区 + 工作区 + untracked）
+   * 注意：staged 状态优先于 unstaged（因为 staged 反映了文件的原始变更类型）
+   */
+  getUncommittedFiles(options?: GitRunOptions): GitChangedFile[] {
+    const staged = this.getStagedFiles(options);
+    const unstaged = this.getUnstagedFiles(options);
+    const untracked = this.getUntrackedFiles(options);
+
+    // staged 优先：如果文件在 staged 中是 added，即使 unstaged 中是 modified，也应该保持 added
+    const fileMap = new Map<string, GitChangedFile>();
+    for (const file of [...unstaged, ...staged]) {
+      fileMap.set(file.filename, file);
+    }
+    // 添加 untracked 文件
+    for (const filename of untracked) {
+      if (!fileMap.has(filename)) {
+        fileMap.set(filename, { filename, status: "added" });
+      }
+    }
+    return Array.from(fileMap.values());
+  }
+
+  /**
+   * 获取未跟踪的文件列表
+   */
+  getUntrackedFiles(options?: GitRunOptions): string[] {
+    try {
+      const output = this.runCommandSync(["ls-files", "--others", "--exclude-standard"], options);
+      return output.trim().split("\n").filter(Boolean);
+    } catch {
+      return [];
+    }
+  }
+
+  /**
+   * 获取所有未提交的 diff（暂存区 + 工作区 + untracked）
+   * 使用 HEAD 作为基准比较，untracked 文件生成伪 patch
+   */
+  getUncommittedDiff(options?: GitRunOptions): GitDiffFile[] {
+    const diffs: GitDiffFile[] = [];
+
+    // 1. 获取已跟踪文件的 diff（staged + unstaged）
+    try {
+      const output = this.runCommandSync(["diff", "HEAD"], options);
+      diffs.push(...parseDiffText(output));
+    } catch {
+      // ignore
+    }
+
+    // 2. 为 untracked 文件生成伪 patch
+    const untrackedFiles = this.getUntrackedFiles(options);
+    for (const filename of untrackedFiles) {
+      try {
+        const content = this.getWorkingFileContent(filename, options);
+        const patch = this.generateAddedFilePatch(content);
+        diffs.push({ filename, patch });
+      } catch {
+        // 文件读取失败，跳过
+      }
+    }
+
+    return diffs;
+  }
+
+  /**
+   * 为新增文件生成伪 patch（所有行都是新增）
+   */
+  protected generateAddedFilePatch(content: string): string {
+    const lines = content.split("\n");
+    const lineCount = lines.length;
+    const patchLines = lines.map((line) => `+${line}`);
+    return `@@ -0,0 +1,${lineCount} @@\n${patchLines.join("\n")}`;
+  }
+
+  /**
+   * 解析 git diff --name-status 输出
+   */
+  protected parseNameStatusOutput(output: string): GitChangedFile[] {
+    const files: GitChangedFile[] = [];
+    const lines = output.trim().split("\n").filter(Boolean);
+    for (const line of lines) {
+      const [status, filename] = line.split("\t");
+      if (filename) {
+        files.push({
+          filename,
+          status: mapGitStatus(status),
+        });
+      }
+    }
+    return files;
+  }
+
   /**
    * 解析 ref，支持本地分支、远程分支、commit SHA
    * 优先级：commit SHA > 本地分支 > origin/分支 > fetch后重试 > 原始值

package/src/shared/git-sdk/index.ts

@@ -1,3 +1,4 @@
 export * from "./git-sdk.types";
 export * from "./git-sdk-diff.utils";
 export { GitSdkService } from "./git-sdk.service";
+export type { LocalReviewMode } from "./git-sdk.service";