@simoonfish/df-cli 1.0.5 → 1.0.7

package/dist/api/client.d.ts

@@ -13,6 +13,8 @@ declare class ApiClient {
     private url;
     get<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T>;
     post<T>(path: string, body?: unknown): Promise<T>;
+    put<T>(path: string, body?: unknown): Promise<T>;
+    del<T>(path: string): Promise<T>;
     verifyKey(): Promise<{
         valid: boolean;
         user_id: number | null;
@@ -48,6 +50,42 @@ declare class ApiClient {
         action: string;
         detail?: string;
     }): Promise<unknown>;
+    createKnowledgeBase(data: {
+        name: string;
+        path_in_repo?: string;
+        description?: string;
+    }): Promise<{
+        code: number;
+        data: any;
+    }>;
+    searchKnowledgeBases(keyword: string): Promise<{
+        code: number;
+        data: any[];
+    }>;
+    bindWorkspaceKnowledgeBase(wsId: number, kbIds: number[]): Promise<any>;
+    createKnowledgeNode(data: {
+        base_id: number;
+        parent_id?: number | null;
+        title: string;
+        type: string;
+        content?: string;
+        sort_order?: number;
+        path?: string;
+    }): Promise<{
+        code: number;
+        data: any;
+    }>;
+    updateKnowledgeNode(nodeId: number, data: {
+        title?: string;
+        content?: string;
+        parent_id?: number | null;
+        sort_order?: number;
+        path?: string;
+    }): Promise<{
+        code: number;
+        data: any;
+    }>;
+    deleteKnowledgeNode(nodeId: number): Promise<any>;
 }
 export declare const api: ApiClient;
 export {};

package/dist/api/client.js

@@ -53,6 +53,27 @@ class ApiClient {
         const json = await res.json();
         return json;
     }
+    async put(path, body) {
+        const res = await fetch(this.url(path), {
+            method: "PUT",
+            headers: this.headers(),
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok)
+            throw new Error(`API ${res.status}: ${res.statusText}`);
+        const json = await res.json();
+        return json;
+    }
+    async del(path) {
+        const res = await fetch(this.url(path), {
+            method: "DELETE",
+            headers: this.headers(),
+        });
+        if (!res.ok)
+            throw new Error(`API ${res.status}: ${res.statusText}`);
+        const json = await res.json();
+        return json;
+    }
     async verifyKey() {
         return this.post("/auth/api-keys/verify");
     }
@@ -77,5 +98,25 @@ class ApiClient {
     async syncReport(data) {
         return this.post("/clients/sync-report", data);
     }
+    // ── Knowledge Base CRUD (for upload) ─────────────────────────
+    async createKnowledgeBase(data) {
+        return this.post("/knowledge-bases", data);
+    }
+    async searchKnowledgeBases(keyword) {
+        return this.get("/knowledge-bases", { keyword, pageSize: 50 });
+    }
+    async bindWorkspaceKnowledgeBase(wsId, kbIds) {
+        return this.post(`/workspaces/${wsId}/knowledge-bases`, { knowledge_base_ids: kbIds });
+    }
+    // ── Knowledge Node CRUD (for upload) ─────────────────────────
+    async createKnowledgeNode(data) {
+        return this.post("/knowledge-nodes", data);
+    }
+    async updateKnowledgeNode(nodeId, data) {
+        return this.put(`/knowledge-nodes/${nodeId}`, data);
+    }
+    async deleteKnowledgeNode(nodeId) {
+        return this.del(`/knowledge-nodes/${nodeId}`);
+    }
 }
 export const api = new ApiClient();

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/commands/upload.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const uploadCommand: Command;

package/dist/commands/upload.js

@@ -0,0 +1,239 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { readFileSync, existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { readConfig, findBinding, getKnowledgeInstallDir } from "../config.js";
+import { api } from "../api/client.js";
+export const uploadCommand = new Command("upload")
+    .description("将本地数据上传到服务端（知识库等）")
+    .option("--kb", "上传知识库到服务端")
+    .option("--kb-name <name>", "指定上传的知识库名称（仅限当前工作区已绑定的）")
+    .option("--strategy <mode>", "覆盖策略: incremental（默认，只增改）| mirror（以本地为准，删除远程多余内容）", "incremental")
+    .option("--dry-run", "预览模式，只输出将要执行的操作，不实际写入")
+    .action(async (opts) => {
+    const spinner = ora("加载配置...").start();
+    try {
+        if (!opts.kb) {
+            spinner.fail("请指定上传内容类型，例如 --kb 上传知识库");
+            process.exit(1);
+        }
+        const config = readConfig();
+        if (!config) {
+            spinner.fail("未找到配置，请先运行 devforge init");
+            process.exit(1);
+        }
+        const binding = findBinding(config);
+        if (!binding) {
+            spinner.fail("当前目录未绑定工作区，请先运行 devforge sync");
+            process.exit(1);
+        }
+        const localDir = binding.local_dir;
+        const strategy = opts.strategy === "mirror" ? "mirror" : "incremental";
+        const dryRun = !!opts.dryRun;
+        if (opts.kb) {
+            await uploadKnowledgeBases(spinner, binding.workspace_id, localDir, opts.kbName, strategy, dryRun);
+        }
+    }
+    catch (e) {
+        spinner.fail(`上传失败: ${e.message}`);
+        process.exit(1);
+    }
+});
+async function uploadKnowledgeBases(spinner, wsId, localDir, kbNameFilter, strategy, dryRun) {
+    // 1. Get workspace's KBs from server
+    spinner.start("获取工作区绑定的知识库...");
+    const wsKbsRes = await api.getWorkspaceKnowledgeBases(wsId);
+    const serverKbs = wsKbsRes.data || [];
+    if (serverKbs.length === 0) {
+        spinner.info("当前工作区未绑定知识库，跳过");
+        return;
+    }
+    spinner.succeed(`工作区已绑定 ${serverKbs.length} 个知识库`);
+    // 2. Read local KB directories
+    const kbRootDir = getKnowledgeInstallDir(localDir);
+    if (!existsSync(kbRootDir)) {
+        spinner.fail(`本地未找到知识库目录: ${kbRootDir}，请先运行 devforge sync`);
+        process.exit(1);
+    }
+    const kbDirs = readdirSync(kbRootDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => d.name);
+    if (kbDirs.length === 0) {
+        spinner.info("本地无可上传的知识库");
+        return;
+    }
+    for (const kbName of kbDirs) {
+        // Apply kb-name filter
+        if (kbNameFilter && kbName !== kbNameFilter)
+            continue;
+        const kbDir = join(kbRootDir, kbName);
+        const manifestPath = join(kbDir, "manifest.json");
+        if (!existsSync(manifestPath)) {
+            spinner.warn(`跳过 ${kbName}: 缺少 manifest.json`);
+            continue;
+        }
+        const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+        // 3. Match server KB by name
+        let serverKb = serverKbs.find((k) => k.name === kbName);
+        if (!serverKb) {
+            spinner.warn(`服务端未找到同名知识库 "${kbName}"，将自动创建`);
+            if (!dryRun) {
+                const createRes = await api.createKnowledgeBase({ name: kbName });
+                serverKb = createRes.data;
+                // Bind to workspace
+                if (serverKb?.id) {
+                    await api.bindWorkspaceKnowledgeBase(wsId, [serverKb.id]);
+                    spinner.succeed(`已创建并绑定知识库: ${kbName} (ID: ${serverKb.id})`);
+                }
+            }
+            else {
+                console.log(chalk.yellow(`  [预览] 创建知识库: ${kbName}`));
+                console.log(chalk.yellow(`  [预览] 绑定到工作区: ${wsId}`));
+                continue;
+            }
+        }
+        else {
+            spinner.succeed(`已匹配知识库: ${kbName} (ID: ${serverKb.id})`);
+        }
+        if (!serverKb?.id)
+            continue;
+        // 4. Read index.json for local node tree
+        const indexPath = join(kbDir, "index.json");
+        if (!existsSync(indexPath)) {
+            spinner.warn(`跳过 ${kbName}: 缺少 index.json`);
+            continue;
+        }
+        const localNodes = JSON.parse(readFileSync(indexPath, "utf-8"));
+        // 5. Get server nodes
+        const serverNodesRes = await api.getKnowledgeNodes(serverKb.id);
+        const serverNodes = serverNodesRes.data || [];
+        // 6. Build path→node maps
+        const localByPath = new Map();
+        const serverByPath = new Map();
+        for (const n of localNodes) {
+            if (n.path)
+                localByPath.set(n.path, n);
+        }
+        for (const n of serverNodes) {
+            if (n.path)
+                serverByPath.set(n.path, n);
+        }
+        // Also index server nodes by title for pathless folders
+        const serverByTitle = new Map();
+        for (const n of serverNodes) {
+            if (n.type === "folder")
+                serverByTitle.set(n.title, n);
+        }
+        // 7. Execute diff sync
+        let created = 0, updated = 0, deleted = 0;
+        // 7a. Create/update local nodes
+        for (const localNode of localNodes) {
+            const serverNode = localNode.path ? serverByPath.get(localNode.path) : undefined;
+            if (serverNode) {
+                // Update existing node
+                const needsUpdate = localNode.title !== serverNode.title ||
+                    localNode.sort_order !== serverNode.sort_order ||
+                    localNode.parent_id !== serverNode.parent_id;
+                // For documents, also check content
+                let contentChanged = false;
+                if (localNode.type === "document") {
+                    const localContent = readLocalDocumentContent(kbDir, localNode);
+                    if (localContent !== (serverNode.content || "")) {
+                        contentChanged = true;
+                    }
+                }
+                if (needsUpdate || contentChanged) {
+                    const payload = { title: localNode.title, sort_order: localNode.sort_order };
+                    if (contentChanged && localNode.type === "document") {
+                        payload.content = readLocalDocumentContent(kbDir, localNode);
+                    }
+                    if (!dryRun) {
+                        await api.updateKnowledgeNode(serverNode.id, payload);
+                    }
+                    updated++;
+                    const action = contentChanged ? "内容更新" : "元信息更新";
+                    spinner.text = `  ~ ${localNode.path || localNode.title} (${action})`;
+                }
+                else {
+                    spinner.text = `    ${localNode.path || localNode.title} (相同，跳过)`;
+                }
+            }
+            else {
+                // Create new node — need to resolve parent_id
+                const parentId = resolveParentId(localNode, localNodes, serverNodes);
+                const payload = {
+                    base_id: serverKb.id,
+                    parent_id: parentId,
+                    title: localNode.title,
+                    type: localNode.type,
+                    sort_order: localNode.sort_order,
+                    path: localNode.path,
+                };
+                if (localNode.type === "document") {
+                    payload.content = readLocalDocumentContent(kbDir, localNode);
+                }
+                if (!dryRun) {
+                    await api.createKnowledgeNode(payload);
+                }
+                created++;
+                spinner.text = `  + ${localNode.path || localNode.title}`;
+            }
+        }
+        // 7b. Delete server nodes missing locally (mirror mode only)
+        if (strategy === "mirror") {
+            for (const serverNode of serverNodes) {
+                const localExists = serverNode.path
+                    ? localByPath.has(serverNode.path)
+                    : localNodes.some((n) => n.title === serverNode.title && n.type === serverNode.type);
+                if (!localExists) {
+                    if (!dryRun) {
+                        await api.deleteKnowledgeNode(serverNode.id);
+                    }
+                    deleted++;
+                    spinner.text = `  - ${serverNode.path || serverNode.title}`;
+                }
+            }
+        }
+        // 8. Report
+        const modeLabel = strategy === "mirror" ? "镜像" : "增量";
+        const dryLabel = dryRun ? " [预览]" : "";
+        spinner.succeed(`知识库 "${kbName}" 上传完成${dryLabel}（${modeLabel}） — +${created} ~${updated} -${deleted}`);
+    }
+}
+// ── Helpers ──────────────────────────────────────────────────
+/** 读取本地文档文件内容 */
+function readLocalDocumentContent(kbDir, node) {
+    if (node.type !== "document")
+        return "";
+    // Try path first, then title as filename
+    const relPath = node.path || `${node.title}.md`;
+    const filePath = join(kbDir, relPath);
+    try {
+        return readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * 为新建节点解析 parent_id。
+ * 优先用本地 index.json 中的 parent_id（指向本地 ID），映射为服务端节点 ID。
+ * 如果映射不到，尝试按 title 匹配服务端文件夹。
+ */
+function resolveParentId(localNode, allLocalNodes, serverNodes) {
+    if (localNode.parent_id == null)
+        return null;
+    const localParent = allLocalNodes.find((n) => n.id === localNode.parent_id);
+    if (!localParent)
+        return null;
+    // Match by path first
+    if (localParent.path) {
+        const match = serverNodes.find((sn) => sn.path === localParent.path);
+        if (match)
+            return match.id;
+    }
+    // Fallback: match by title (for folders)
+    const match = serverNodes.find((sn) => sn.type === "folder" && sn.title === localParent.title);
+    return match?.id ?? null;
+}

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/dist/index.js

@@ -10,6 +10,7 @@ import { installCommand } from "./commands/install.js";
 import { listCommand } from "./commands/list.js";
 import { statusCommand } from "./commands/status.js";
 import { unbindCommand } from "./commands/unbind.js";
+import { uploadCommand } from "./commands/upload.js";
 const program = new Command();
 program
     .name("devforge")
@@ -24,6 +25,7 @@ program
     .addCommand(listCommand)
     .addCommand(statusCommand)
     .addCommand(unbindCommand)
+    .addCommand(uploadCommand)
     .hook("preAction", (thisCommand) => {
     const opts = thisCommand.opts();
     // require api-key for most commands except version/help

package/package.json

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