@downcity/city 1.1.4 → 1.1.6

package/src/cli/shared/Update.ts

@@ -0,0 +1,183 @@
+/**
+ * `city update`：更新全局 downcity CLI。
+ *
+ * 关键点（中文）
+ * - 优先根据当前 CLI 所在的全局模块目录，自动判断是 npm 还是 pnpm 安装。
+ * - 允许用户通过 `--manager` 显式覆盖包管理器选择。
+ * - 实际更新只负责全局包升级，不自动重启已有 runtime/Console 进程。
+ */
+
+import fs from "fs";
+import path from "path";
+import { execFileSync, spawn } from "node:child_process";
+import { fileURLToPath } from "url";
+import { emitCliBlock } from "./CliReporter.js";
+import { CliError } from "./CliError.js";
+import { runWithSpinner } from "@/utils/cli/Spinner.js";
+
+export type UpdateManager = "npm" | "pnpm";
+
+export interface UpdateCommandOptions {
+  /**
+   * 包管理器选择。
+   *
+   * - `auto`：按当前 CLI 所在的全局目录自动判断。
+   * - `npm` / `pnpm`：强制使用指定包管理器。
+   */
+  manager?: UpdateManager | "auto";
+}
+
+const GLOBAL_PACKAGE_NAME = "downcity";
+
+/**
+ * 构造全局更新命令。
+ */
+export function buildGlobalUpdateInvocation(manager: UpdateManager): {
+  command: string;
+  args: string[];
+} {
+  if (manager === "pnpm") {
+    return {
+      command: "pnpm",
+      args: ["add", "-g", `${GLOBAL_PACKAGE_NAME}@latest`],
+    };
+  }
+
+  return {
+    command: "npm",
+    args: ["install", "-g", `${GLOBAL_PACKAGE_NAME}@latest`],
+  };
+}
+
+/**
+ * 根据全局模块根目录判断当前 CLI 来源。
+ */
+export function resolveUpdateManagerFromGlobalRoots(params: {
+  packageRoot: string;
+  npmRoot?: string;
+  pnpmRoot?: string;
+}): UpdateManager | null {
+  const packageRoot = normalizeRealPath(params.packageRoot) || path.resolve(params.packageRoot);
+  const pnpmRoot = normalizeRealPath(params.pnpmRoot);
+  const npmRoot = normalizeRealPath(params.npmRoot);
+
+  if (pnpmRoot && isSubPath(packageRoot, pnpmRoot)) return "pnpm";
+  if (npmRoot && isSubPath(packageRoot, npmRoot)) return "npm";
+  return null;
+}
+
+function normalizeRealPath(target?: string): string | null {
+  const raw = String(target || "").trim();
+  if (!raw) return null;
+  try {
+    return fs.realpathSync(raw);
+  } catch {
+    return path.resolve(raw);
+  }
+}
+
+function isSubPath(targetPath: string, rootPath: string): boolean {
+  const relative = path.relative(rootPath, targetPath);
+  return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+
+function readGlobalRoot(manager: UpdateManager): string | null {
+  try {
+    const output = execFileSync(manager, ["root", "-g"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+    });
+    const trimmed = String(output || "").trim();
+    return trimmed || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 自动判断当前全局安装使用的包管理器。
+ */
+export function detectInstalledUpdateManager(): UpdateManager {
+  const __filename = fileURLToPath(import.meta.url);
+  const __dirname = path.dirname(__filename);
+  const packageRoot = path.resolve(__dirname, "../..");
+  const detected = resolveUpdateManagerFromGlobalRoots({
+    packageRoot,
+    npmRoot: readGlobalRoot("npm") || undefined,
+    pnpmRoot: readGlobalRoot("pnpm") || undefined,
+  });
+  return detected || "npm";
+}
+
+async function runCommand(command: string, args: string[]): Promise<void> {
+  await new Promise<void>((resolve, reject) => {
+    const child = spawn(command, args, {
+      stdio: "inherit",
+      env: process.env,
+    });
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+      reject(new Error(`${command} exited with code ${String(code)}`));
+    });
+  });
+}
+
+/**
+ * update 命令入口。
+ */
+export async function updateCommand(
+  options: UpdateCommandOptions = {},
+): Promise<void> {
+  const manager =
+    options.manager && options.manager !== "auto"
+      ? options.manager
+      : detectInstalledUpdateManager();
+  const invocation = buildGlobalUpdateInvocation(manager);
+
+  emitCliBlock({
+    tone: "accent",
+    title: "Updating downcity",
+    facts: [
+      {
+        label: "Manager",
+        value: manager,
+      },
+      {
+        label: "Command",
+        value: `${invocation.command} ${invocation.args.join(" ")}`,
+      },
+    ],
+  });
+
+  try {
+    await runWithSpinner(
+      () => runCommand(invocation.command, invocation.args),
+      { text: `Installing ${GLOBAL_PACKAGE_NAME}@latest via ${manager}...` },
+    );
+  } catch (error) {
+    throw new CliError({
+      title: "Failed to update downcity",
+      note: error instanceof Error ? error.message : String(error),
+    });
+  }
+
+  emitCliBlock({
+    tone: "success",
+    title: "Downcity updated",
+    facts: [
+      {
+        label: "Package",
+        value: `${GLOBAL_PACKAGE_NAME}@latest`,
+      },
+      {
+        label: "Manager",
+        value: manager,
+      },
+    ],
+    note: "如果当前已有 city runtime / Console 在运行，建议执行 `city restart` 载入最新版本。",
+  });
+}

package/src/config/DowncitySchema.ts

@@ -0,0 +1,377 @@
+import type { JsonObject } from "@downcity/agent";
+
+export const DOWNCITY_JSON_SCHEMA: JsonObject = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  $id: "https://downcity.ai/schemas/downcity.schema.json",
+  title: "Downcity downcity.json",
+  type: "object",
+  additionalProperties: true,
+  properties: {
+    $schema: {
+      type: "string",
+      description:
+        "JSON Schema reference for editor/IDE validation (e.g. ./.downcity/schema/downcity.schema.json).",
+    },
+    name: { type: "string" },
+    version: { type: "string" },
+    description: { type: "string" },
+    start: {
+      type: "object",
+      additionalProperties: true,
+      properties: {
+        port: { type: "integer", minimum: 1, maximum: 65535 },
+        host: { type: "string" },
+      },
+    },
+    execution: {
+      type: "object",
+      additionalProperties: true,
+      properties: {
+        type: {
+          type: "string",
+          enum: ["api", "acp", "local"],
+        },
+        modelId: {
+          type: "string",
+          description:
+            "API 执行模式下绑定的平台全局模型 ID。",
+        },
+        agent: {
+          type: "object",
+          additionalProperties: true,
+          properties: {
+            type: {
+              type: "string",
+              enum: ["codex", "claude", "kimi"],
+            },
+            command: { type: "string" },
+            args: {
+              type: "array",
+              items: { type: "string" },
+            },
+            env: {
+              type: "object",
+              additionalProperties: { type: "string" },
+            },
+          },
+          required: ["type"],
+        },
+        local: {
+          type: "null",
+          description:
+            "本地执行模式不再从 execution.local 读取配置；请改为使用 plugins.lmp。",
+        },
+      },
+      required: ["type"],
+      allOf: [
+        {
+          if: {
+            properties: {
+              type: { const: "api" },
+            },
+          },
+          then: {
+            required: ["modelId"],
+          },
+        },
+        {
+          if: {
+            properties: {
+              type: { const: "acp" },
+            },
+          },
+          then: {
+            required: ["agent"],
+          },
+        },
+        {
+          if: {
+            properties: {
+              type: { const: "local" },
+            },
+          },
+          then: true,
+        },
+      ],
+    },
+    sandbox: {
+      type: "object",
+      additionalProperties: true,
+      description:
+        "Shell / CLI sandbox boundary configuration for local command execution. Sandbox is always required for shell execution.",
+      properties: {
+        envAllowlist: {
+          type: "array",
+          description:
+            "Environment variable names that may be exported into the sandbox.",
+          items: { type: "string" },
+        },
+        writablePaths: {
+          type: "array",
+          description:
+            "Writable paths, absolute or relative to the project root.",
+          items: { type: "string" },
+        },
+        networkMode: {
+          type: "string",
+          enum: ["off", "restricted", "full"],
+          description:
+            "Network boundary for sandboxed shell execution.",
+        },
+      },
+    },
+    services: {
+      type: "object",
+      additionalProperties: true,
+      properties: {
+        skills: {
+          type: "object",
+          additionalProperties: true,
+          properties: {
+            paths: { type: "array", items: { type: "string" } },
+            allowExternalPaths: { type: "boolean" },
+          },
+        },
+        chat: {
+          type: "object",
+          additionalProperties: true,
+          properties: {
+            queue: {
+              type: "object",
+              additionalProperties: true,
+              properties: {
+                maxConcurrency: { type: "integer", minimum: 1, maximum: 32 },
+                mergeDebounceMs: { type: "integer", minimum: 0, maximum: 60000 },
+                mergeMaxWaitMs: { type: "integer", minimum: 0, maximum: 120000 },
+              },
+            },
+            egress: {
+              type: "object",
+              additionalProperties: true,
+              properties: {
+                chatSendMaxCallsPerRun: { type: "integer", minimum: 1, maximum: 500 },
+                chatSendIdempotency: { type: "boolean" },
+              },
+            },
+            channels: {
+              type: "object",
+              additionalProperties: true,
+              description:
+                "Chat platform channels (Telegram / Feishu / QQ...).",
+              properties: {
+                telegram: {
+                  type: "object",
+                  additionalProperties: true,
+                  properties: {
+                    enabled: { type: "boolean" },
+                    channelAccountId: { type: "string" },
+                  },
+                },
+                feishu: {
+                  type: "object",
+                  additionalProperties: true,
+                  properties: {
+                    enabled: { type: "boolean" },
+                    channelAccountId: { type: "string" },
+                  },
+                },
+                qq: {
+                  type: "object",
+                  additionalProperties: true,
+                  properties: {
+                    enabled: { type: "boolean" },
+                    channelAccountId: { type: "string" },
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+    plugins: {
+      type: "object",
+      additionalProperties: true,
+      properties: {
+        asr: {
+          type: "object",
+          additionalProperties: true,
+          properties: {
+            injectPrompt: { type: "boolean" },
+            augmentMessage: { type: "boolean" },
+            provider: { type: "string", enum: ["local", "command"] },
+            modelId: {
+              type: "string",
+              enum: [
+                "SenseVoiceSmall",
+                "paraformer-zh-streaming",
+                "whisper-large-v3-turbo",
+              ],
+            },
+            modelsDir: { type: "string" },
+            pythonBin: { type: "string" },
+            command: { type: "string" },
+            language: { type: "string" },
+            timeoutMs: { type: "integer", minimum: 1000, maximum: 600000 },
+            strategy: {
+              type: "string",
+              enum: ["auto", "funasr", "transformers-whisper", "command"],
+            },
+            installedModels: {
+              type: "array",
+              items: {
+                type: "string",
+                enum: [
+                  "SenseVoiceSmall",
+                  "paraformer-zh-streaming",
+                  "whisper-large-v3-turbo",
+                ],
+              },
+            },
+          },
+        },
+        tts: {
+          type: "object",
+          additionalProperties: true,
+          properties: {
+            provider: {
+              type: "string",
+              enum: ["local"],
+            },
+            modelId: {
+              type: "string",
+              enum: ["qwen3-tts-0.6b", "kokoro-82m", "qwen3-tts-1.7b"],
+            },
+            modelsDir: { type: "string" },
+            pythonBin: { type: "string" },
+            language: { type: "string" },
+            voice: { type: "string" },
+            format: {
+              type: "string",
+              enum: ["wav", "flac"],
+            },
+            speed: { type: "number", minimum: 0.5, maximum: 2 },
+            outputDir: { type: "string" },
+            timeoutMs: { type: "integer", minimum: 5000, maximum: 900000 },
+            installedModels: {
+              type: "array",
+              items: {
+                type: "string",
+                enum: ["qwen3-tts-0.6b", "kokoro-82m", "qwen3-tts-1.7b"],
+              },
+            },
+          },
+        },
+        lmp: {
+          type: "object",
+          additionalProperties: true,
+          properties: {
+            provider: {
+              type: "string",
+              enum: ["llama"],
+            },
+            model: {
+              type: "string",
+              description:
+                "当前激活的本地模型文件名或绝对路径；相对路径默认相对 plugins.lmp.modelsDir。",
+            },
+            modelsDir: {
+              type: "string",
+              description: "本地模型目录，默认 ~/.models。",
+            },
+            command: {
+              type: "string",
+              description: "llama-server 可执行命令，默认 llama-server。",
+            },
+            args: {
+              type: "array",
+              items: { type: "string" },
+            },
+            host: { type: "string" },
+            port: { type: "integer", minimum: 1, maximum: 65535 },
+            contextSize: { type: "integer", minimum: 512, maximum: 1048576 },
+            gpuLayers: { type: "integer", minimum: -1, maximum: 65535 },
+            autoStart: { type: "boolean" },
+            installedModels: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+            },
+          },
+        },
+      },
+    },
+    llm: {
+      type: "object",
+      additionalProperties: true,
+      properties: {
+        providers: {
+          type: "object",
+          additionalProperties: {
+            type: "object",
+            additionalProperties: true,
+            properties: {
+              type: {
+                type: "string",
+                enum: [
+                  "anthropic",
+                  "openai",
+                  "deepseek",
+                  "gemini",
+                  "open-compatible",
+                  "open-responses",
+                  "moonshot-cn",
+                  "moonshot-ai",
+                  "kimi-code",
+                  "xai",
+                  "huggingface",
+                  "openrouter",
+                ],
+              },
+              baseUrl: { type: "string" },
+              apiKey: { type: "string" },
+            },
+            required: ["type"],
+          },
+        },
+        models: {
+          type: "object",
+          additionalProperties: {
+            type: "object",
+            additionalProperties: true,
+            properties: {
+              provider: { type: "string" },
+              name: { type: "string" },
+              temperature: { type: "number" },
+              maxTokens: { type: "number" },
+              topP: { type: "number" },
+              frequencyPenalty: { type: "number" },
+              presencePenalty: { type: "number" },
+              anthropicVersion: { type: "string" },
+            },
+            required: ["provider", "name"],
+          },
+        },
+        logMessages: { type: "boolean" },
+      },
+      required: ["providers", "models"],
+    },
+    context: {
+      type: "object",
+      additionalProperties: true,
+      properties: {
+        messages: {
+          type: "object",
+          additionalProperties: true,
+          properties: {
+            keepLastMessages: { type: "integer", minimum: 6, maximum: 5000 },
+            maxInputTokensApprox: { type: "integer", minimum: 2000, maximum: 200000 },
+            archiveOnCompact: { type: "boolean" },
+            compactRatio: { type: "number", minimum: 0.1, maximum: 0.9 },
+          },
+        },
+      },
+    },
+  },
+};