@simoonfish/df-cli 1.0.6 → 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/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/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.6",
+  "version": "1.0.7",
   "description": "DevForge CLI — 将平台工作区、Skill 和知识库同步到本地开发工程",
   "bin": {
     "devforge": "./dist/index.js"