@simoonfish/df-cli 1.0.5 → 1.0.6

package/dist/commands/install.js

@@ -3,7 +3,7 @@ import chalk from "chalk";
 import ora from "ora";
 import { writeFileSync, mkdirSync } from "node:fs";
 import { join } from "node:path";
-import { readConfig, findBinding, getPlatform, getSkillInstallDir, getKnowledgeInstallDir, SUPPORTED_PLATFORMS } from "../config.js";
+import { readConfig, findBinding, resolvePlatform, getSkillInstallDir, getKnowledgeInstallDir, SUPPORTED_PLATFORMS } from "../config.js";
 import { api } from "../api/client.js";
 export const installCommand = new Command("install")
     .description("安装指定 Skill 或知识库到工作区")
@@ -53,7 +53,7 @@ async function installSkill(config, binding, name, opts) {
         process.exit(1);
     }
     // Platform compatibility check
-    const currentPlatform = getPlatform(opts.platform);
+    const currentPlatform = resolvePlatform(opts.platform, binding);
     const skillPlatform = skill.platform || "claude_code";
     if (skillPlatform !== currentPlatform && !opts.force) {
         spinner.warn(`Skill "${skill.name}" 的目标平台是 ${chalk.cyan(skillPlatform)}，` +

package/dist/commands/sync.js

@@ -3,13 +3,14 @@ import chalk from "chalk";
 import ora from "ora";
 import { writeFileSync, mkdirSync } from "node:fs";
 import { join } from "node:path";
-import { readConfig, writeConfig, findBinding, getSkillInstallDir, getKnowledgeInstallDir, getDevForgeDir, getRuleFileName, getRulesCacheDir } from "../config.js";
+import { readConfig, writeConfig, findBinding, getSkillInstallDir, getKnowledgeInstallDir, getDevForgeDir, getRuleFileName, getRulesCacheDir, resolvePlatform, cleanupBindingArtifacts } from "../config.js";
 import { api } from "../api/client.js";
 export const syncCommand = new Command("sync")
     .description("绑定工作区并同步 Skill + 知识库到本地")
     .option("--local-dir <path>", "指定本地工程目录（默认当前目录）")
-    .option("--workspace-id <id>", "工作区 ID（首次绑定时必填）")
-    .option("--workspace <name>", "工作区名称（首次绑定时按名称搜索）")
+    .option("--workspace-id <id>", "工作区 ID（首次绑定时必填，重新绑定时更新）")
+    .option("--workspace <name>", "工作区名称（按名称搜索）")
+    .option("--platform <name>", "目标 AI 编码平台 (claude_code | codex)，覆盖绑定上的平台")
     .option("--skills", "仅同步 Skill")
     .option("--knowledge", "仅同步知识库")
     .action(async (opts) => {
@@ -21,41 +22,75 @@ export const syncCommand = new Command("sync")
             process.exit(1);
         }
         const localDir = opts.localDir || process.cwd();
+        const platformOverride = opts.platform;
         let binding = findBinding(config, localDir);
-        // ── 首次绑定 ─────────────────────────────────────────────
-        if (!binding) {
-            let wsId;
-            let wsName;
-            const workspaceId = opts.workspaceId ? Number(opts.workspaceId) : undefined;
-            const workspaceName = opts.workspace;
-            if (workspaceId) {
-                spinner.text = "查询工作区...";
-                const ws = await api.getWorkspace(workspaceId);
-                wsName = ws.data?.name || `工作区 #${workspaceId}`;
-                wsId = workspaceId;
-            }
-            else if (workspaceName) {
-                spinner.text = `搜索工作区 "${workspaceName}"...`;
-                const res = await api.get(`/workspaces?keyword=${encodeURIComponent(workspaceName)}&pageSize=5`);
-                if (!res.data?.length) {
-                    spinner.fail(`未找到名为 "${workspaceName}" 的工作区`);
-                    process.exit(1);
-                }
-                wsId = res.data[0].id;
-                wsName = res.data[0].name;
+        // ── 解析目标工作区（如果命令行指定了 --workspace-id / --workspace）────────
+        let targetWsId;
+        let targetWsName;
+        if (opts.workspaceId) {
+            targetWsId = Number(opts.workspaceId);
+            spinner.text = "查询工作区...";
+            const ws = await api.getWorkspace(targetWsId);
+            targetWsName = ws.data?.name || `工作区 #${targetWsId}`;
+        }
+        else if (opts.workspace) {
+            spinner.text = `搜索工作区 "${opts.workspace}"...`;
+            const res = await api.get(`/workspaces?keyword=${encodeURIComponent(opts.workspace)}&pageSize=5`);
+            if (!res.data?.length) {
+                spinner.fail(`未找到名为 "${opts.workspace}" 的工作区`);
+                process.exit(1);
             }
-            else {
+            targetWsId = res.data[0].id;
+            targetWsName = res.data[0].name;
+        }
+        // ── 检测变更 & 执行清理 ──────────────────────────────────────
+        const workspaceChanged = binding && targetWsId && binding.workspace_id !== targetWsId;
+        const platformChanged = binding && platformOverride && resolvePlatform(undefined, binding) !== platformOverride;
+        let needsCleanup = workspaceChanged || platformChanged;
+        if (!binding) {
+            // ── 首次绑定 ─────────────────────────────────────────────
+            if (!targetWsId) {
                 spinner.fail("当前目录未绑定工作区，请通过 --workspace-id 或 --workspace 指定");
                 process.exit(1);
             }
-            binding = { local_dir: localDir, workspace_id: wsId, workspace_name: wsName };
+            binding = {
+                local_dir: localDir,
+                workspace_id: targetWsId,
+                workspace_name: targetWsName,
+                platform: platformOverride,
+            };
             config.bindings.push(binding);
-            writeConfig(config);
-            spinner.succeed(`已绑定工作区: ${wsName} (ID: ${wsId})`);
+            spinner.succeed(`已绑定工作区: ${targetWsName} (ID: ${targetWsId})`);
+        }
+        else if (needsCleanup) {
+            // ── 重新绑定（清理旧产物 → 更新绑定）────────────────────────
+            const oldPlatform = platformChanged ? resolvePlatform(undefined, binding) : undefined;
+            const oldWsLabel = workspaceChanged
+                ? `${binding.workspace_name} (ID: ${binding.workspace_id})`
+                : "";
+            spinner.start("清理旧的同步数据...");
+            cleanupBindingArtifacts(localDir, workspaceChanged ? undefined : oldPlatform);
+            spinner.succeed("旧的同步数据已清理");
+            if (workspaceChanged) {
+                console.log(chalk.yellow(`  工作区变更: ${oldWsLabel} → ${targetWsName} (ID: ${targetWsId})`));
+                binding.workspace_id = targetWsId;
+                binding.workspace_name = targetWsName;
+                binding.last_synced = undefined;
+            }
+            if (platformOverride) {
+                binding.platform = platformOverride;
+            }
+            spinner.succeed(`已重新绑定工作区: ${binding.workspace_name} (ID: ${binding.workspace_id})`);
         }
         else {
+            // 无变更 — 仅更新 platform 空值（若未设置且命令行传入）
+            if (platformOverride && !binding.platform) {
+                binding.platform = platformOverride;
+            }
             spinner.succeed(`已定位工作区: ${binding.workspace_name} (ID: ${binding.workspace_id})`);
         }
+        // ── 确定生效平台（供写入规则文件时使用）─────────────────────────
+        const effectivePlatform = resolvePlatform(undefined, binding);
         // ── 同步到 local-dir/.devforge ────────────────────────────
         mkdirSync(getDevForgeDir(binding.local_dir), { recursive: true });
         const syncAll = !opts.skills && !opts.knowledge;
@@ -127,15 +162,14 @@ export const syncCommand = new Command("sync")
             spinner.succeed(`知识库同步完成 (${kbCount} 个)`);
         }
         let ruleCount = 0;
-        // Sync Rule — 写入工程根目录的 CLAUDE.md / .cursorrules
+        // Sync Rule — 写入工程根目录的 CLAUDE.md / .cursorrules / AGENTS.md
         if (syncAll || opts.rules) {
             spinner.start(`同步 AI 编码规则...`);
             try {
                 const res = await api.getWorkspaceRule(binding.workspace_id);
                 const rule = res.data;
                 if (rule?.content) {
-                    const platform = config.platform || "claude_code";
-                    const fileName = getRuleFileName(platform);
+                    const fileName = getRuleFileName(effectivePlatform);
                     const rulePath = join(localDir, fileName);
                     writeFileSync(rulePath, rule.content, "utf-8");
                     ruleCount = 1;
@@ -170,6 +204,7 @@ export const syncCommand = new Command("sync")
             detail: JSON.stringify({ skills: skillCount, knowledge: kbCount, rules: ruleCount }),
         });
         console.log(chalk.gray(`  工作区: ${binding.workspace_name} (ID: ${binding.workspace_id})`));
+        console.log(chalk.gray(`  平台: ${chalk.cyan(effectivePlatform)}`));
         console.log(chalk.green(`  同步完成 — Skill ${skillCount}, 知识库 ${kbCount}`));
     }
     catch (e) {

package/dist/config.d.ts

@@ -2,6 +2,8 @@ export interface Binding {
     local_dir: string;
     workspace_id: number;
     workspace_name: string;
+    /** 绑定到当前目录时的目标 AI 编码平台，留空则使用全局配置/环境变量/默认值 */
+    platform?: string;
     last_synced?: string;
 }
 export interface DevForgeConfig {
@@ -16,8 +18,14 @@ export type SupportedPlatform = (typeof SUPPORTED_PLATFORMS)[number];
 export declare function ensureConfigDir(): void;
 export declare function readConfig(): DevForgeConfig | null;
 export declare function writeConfig(config: DevForgeConfig): void;
-/** 确定当前运行的 AI 编码平台。优先级: 显式传入 > 配置文件 > 环境变量 > 默认 claude_code */
-export declare function getPlatform(override?: string): string;
+/** 确定目标 AI 编码平台。优先级: 显示传入 > 绑定上的平台 > 全局配置 > 环境变量 > 默认 claude_code */
+export declare function resolvePlatform(override?: string, binding?: Binding): string;
+/**
+ * 清理绑定残留的同步产物。
+ * 工作区间切换时: 删除所有可能遗留的内容（知识库、规则缓存、规则文件、项目级 skill）。
+ * 平台切换时: 仅清理特定平台的文件。
+ */
+export declare function cleanupBindingArtifacts(localDir: string, oldPlatform?: string): void;
 export declare function findBinding(config: DevForgeConfig, localDir?: string): Binding | null;
 export declare function getWorkspaceDir(workspaceId: number): string;
 export declare function ensureWorkspaceDir(workspaceId: number): string;

package/dist/config.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 const CONFIG_DIR = join(homedir(), ".devforge");
@@ -23,11 +23,14 @@ export function writeConfig(config) {
     ensureConfigDir();
     writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
 }
-/** 确定当前运行的 AI 编码平台。优先级: 显式传入 > 配置文件 > 环境变量 > 默认 claude_code */
-export function getPlatform(override) {
+/** 确定目标 AI 编码平台。优先级: 显示传入 > 绑定上的平台 > 全局配置 > 环境变量 > 默认 claude_code */
+export function resolvePlatform(override, binding) {
     if (override && SUPPORTED_PLATFORMS.includes(override)) {
         return override;
     }
+    if (binding?.platform && SUPPORTED_PLATFORMS.includes(binding.platform)) {
+        return binding.platform;
+    }
     const config = readConfig();
     if (config?.platform && SUPPORTED_PLATFORMS.includes(config.platform)) {
         return config.platform;
@@ -38,6 +41,45 @@ export function getPlatform(override) {
     }
     return "claude_code";
 }
+/**
+ * 清理绑定残留的同步产物。
+ * 工作区间切换时: 删除所有可能遗留的内容（知识库、规则缓存、规则文件、项目级 skill）。
+ * 平台切换时: 仅清理特定平台的文件。
+ */
+export function cleanupBindingArtifacts(localDir, oldPlatform) {
+    // 知识库目录（按工作区隔离，始终清理）
+    const kbDir = getKnowledgeInstallDir(localDir);
+    if (existsSync(kbDir))
+        rmSync(kbDir, { recursive: true, force: true });
+    // 规则元数据缓存（始终清理）
+    const rulesDir = getRulesCacheDir(localDir);
+    if (existsSync(rulesDir))
+        rmSync(rulesDir, { recursive: true, force: true });
+    if (oldPlatform) {
+        // 已知旧平台 → 只删除该平台的规则文件
+        const rulePath = join(localDir, getRuleFileName(oldPlatform));
+        if (existsSync(rulePath))
+            rmSync(rulePath, { force: true });
+        // 只删除该平台的项目级技能
+        const skillDir = getSkillInstallDir(localDir, "project", oldPlatform);
+        if (existsSync(skillDir))
+            rmSync(skillDir, { recursive: true, force: true });
+    }
+    else {
+        // 不知道旧平台 → 扫一遍所有已知的规则文件名
+        for (const fileName of Object.values(RULE_FILE_NAMES)) {
+            const rulePath = join(localDir, fileName);
+            if (existsSync(rulePath))
+                rmSync(rulePath, { force: true });
+        }
+        // 与规则文件名列表同源遍历所有平台的项目级技能目录
+        for (const plat of Object.keys(RULE_FILE_NAMES)) {
+            const skillDir = getSkillInstallDir(localDir, "project", plat);
+            if (existsSync(skillDir))
+                rmSync(skillDir, { recursive: true, force: true });
+        }
+    }
+}
 export function findBinding(config, localDir) {
     const dir = localDir || process.cwd();
     return config.bindings.find((b) => b.local_dir === dir) || null;

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "DevForge CLI — 将平台工作区、Skill 和知识库同步到本地开发工程",
   "bin": {
     "devforge": "./dist/index.js"