@downcity/agent 1.1.210 → 1.1.215

package/src/config/AgentInitializer.ts

@@ -3,7 +3,7 @@
  *
  * 职责说明（中文）
  * - CLI `downcity agent create` 与 Console 共用同一套初始化逻辑，避免模板与目录结构分叉。
- * - 负责创建项目骨架、静态 prompt、基础目录与 schema 文件。
+ * - 负责创建项目运行目录、项目 `.env` 与 Skills 目录。
  * - CLI 侧运行配置应写入宿主配置存储，不再由 SDK 初始化器写项目配置文件。
  *
  * 边界说明（中文）
@@ -17,8 +17,6 @@ import {
   getCacheDirPath,
   getDowncityAgentsRootDirPath,
   getLogsDirPath,
-  getProfileMdPath,
-  getDowncityConfigDirPath,
   getDowncityDataDirPath,
   getDowncityDebugDirPath,
   getDowncityDirPath,
@@ -28,16 +26,10 @@ import {
   getDowncityPublicDirPath,
   getDowncityResourcesDirPath,
   getDowncityTasksDirPath,
-  getSoulMdPath,
 } from "@/config/Paths.js";
-import {
-  DEFAULT_PROFILE_MD_TEMPLATE,
-  DEFAULT_SOUL_MD_TEMPLATE,
-} from "@executor/composer/system/default/InitPrompts.js";
 import type { EnvFileEntry } from "@/types/common/EnvFile.js";
 import { appendMissingEnvEntries } from "@/config/EnvFile.js";
 import { ensureGitignoreEntry } from "@/config/Gitignore.js";
-import { renderTemplateVariables } from "@/utils/Template.js";
 import { ensureDir } from "@/utils/storage/index.js";
 import type {
   AgentProjectChannel,
@@ -82,24 +74,11 @@ function normalizeChannels(input: AgentProjectChannel[] | undefined): AgentProje
   return [...seen];
 }
 
-/**
- * 判断项目是否已经具备最小初始化文件。
- *
- * 关键点（中文）
- * - 当前只检查 `PROFILE.md`，用于快速判断项目行为资产是否已初始化过。
- * - 不把 `.downcity/` 目录作为硬性条件，避免用户手动清理缓存后被误判为未初始化。
- */
-export async function isAgentProjectInitialized(projectRoot: string): Promise<boolean> {
-  const normalizedRoot = path.resolve(String(projectRoot || "").trim() || ".");
-  const profileReady = await fs.pathExists(getProfileMdPath(normalizedRoot));
-  return profileReady;
-}
-
 /**
  * 初始化 agent 项目骨架。
  *
  * 关键点（中文）
- * - 会创建 prompt 文件、`.downcity` 目录结构以及 schema 快照。
+ * - 会创建 `.downcity` 运行目录、项目 `.env` 与 `.agents/skills`。
  * - 对已存在文件采取“能跳过就跳过、明确冲突则报错”的策略，降低误覆盖风险。
  * - 返回结果只描述本次初始化写入摘要，方便 CLI 与控制台直接展示。
  */
@@ -114,7 +93,8 @@ export async function initializeAgentProject(
 
   const channels = normalizeChannels(input.channels);
   const dotEnvPath = path.join(projectRoot, ".env");
-  const dotEnvExamplePath = path.join(projectRoot, ".env.example");
+  const downcity_dir_path = getDowncityDirPath(projectRoot);
+  const skills_dir_path = path.join(projectRoot, ".agents", "skills");
   const createdFiles: string[] = [];
   const skippedFiles: string[] = [];
 
@@ -126,53 +106,29 @@ export async function initializeAgentProject(
 
   await ensureDir(projectRoot);
 
-  const profileMdPath = getProfileMdPath(projectRoot);
-  const soulMdPath = getSoulMdPath(projectRoot);
-  const initTemplateVariables = {
-    agent_id,
-  };
-  const staticPromptFiles = [
-    {
-      filename: "PROFILE.md",
-      filePath: profileMdPath,
-      content: renderTemplateVariables(DEFAULT_PROFILE_MD_TEMPLATE, initTemplateVariables),
-    },
-    {
-      filename: "SOUL.md",
-      filePath: soulMdPath,
-      content: renderTemplateVariables(DEFAULT_SOUL_MD_TEMPLATE, initTemplateVariables),
-    },
-  ] as const;
-
-  for (const file of staticPromptFiles) {
-    if (await fs.pathExists(file.filePath)) {
-      skippedFiles.push(file.filename);
-      continue;
-    }
-    await fs.writeFile(file.filePath, file.content, "utf-8");
-    createdFiles.push(file.filename);
-  }
-
+  const dot_env_exists = await fs.pathExists(dotEnvPath);
   await appendMissingEnvEntries(
     dotEnvPath,
     "Downcity Create",
     [] satisfies EnvFileEntry[],
   );
-  await appendMissingEnvEntries(
-    dotEnvExamplePath,
-    "Downcity Create Example",
-    [] satisfies EnvFileEntry[],
-  );
+  (dot_env_exists ? skippedFiles : createdFiles).push(".env");
 
-  const gitignoreStatus = await ensureGitignoreEntry(projectRoot, ".downcity");
-  if (gitignoreStatus === "created" || gitignoreStatus === "updated") {
+  const downcity_gitignore_status = await ensureGitignoreEntry(projectRoot, ".downcity");
+  const dotenv_gitignore_status = await ensureGitignoreEntry(projectRoot, ".env");
+  if (
+    downcity_gitignore_status !== "unchanged" ||
+    dotenv_gitignore_status !== "unchanged"
+  ) {
     createdFiles.push(".gitignore");
   } else {
     skippedFiles.push(".gitignore");
   }
 
+  const downcity_dir_exists = await fs.pathExists(downcity_dir_path);
+  const skills_dir_exists = await fs.pathExists(skills_dir_path);
   const dirs = [
-    getDowncityDirPath(projectRoot),
+    downcity_dir_path,
     getDowncityTasksDirPath(projectRoot),
     getLogsDirPath(projectRoot),
     getCacheDirPath(projectRoot),
@@ -181,13 +137,14 @@ export async function initializeAgentProject(
     getDowncityAgentsRootDirPath(projectRoot),
     getDowncityPublicDirPath(projectRoot),
     getDowncityResourcesDirPath(projectRoot),
-    getDowncityConfigDirPath(projectRoot),
-    path.join(projectRoot, ".agents", "skills"),
+    skills_dir_path,
     getDowncityDebugDirPath(projectRoot),
   ];
   for (const dir of dirs) {
     await ensureDir(dir);
   }
+  (downcity_dir_exists ? skippedFiles : createdFiles).push(".downcity/");
+  (skills_dir_exists ? skippedFiles : createdFiles).push(".agents/skills/");
 
   try {
     await ensureDir(getDowncityProfileDirPath(projectRoot));

package/src/config/EnvFile.ts

@@ -2,7 +2,7 @@
  * Agent 配置域 Env 文件工具模块。
  *
  * 职责说明（中文）
- * - 负责 `.env` / `.env.example` 这类项目配置文件的轻量解析与补齐。
+ * - 负责项目 `.env` 文件的轻量解析与补齐。
  * - 服务于 agent 项目初始化与配置维护流程，避免把文本拼接逻辑散落到业务模块。
  *
  * 边界说明（中文）

package/src/config/ExecutionBinding.ts

@@ -2,7 +2,7 @@
  * 项目执行绑定解析与校验模块。
  *
  * 职责说明（中文）
- * - 统一负责从 `downcity.json` 中读取 agent 的执行目标定义。
+ * - 统一负责从宿主传入的 Agent 配置中读取执行目标定义。
  * - 负责提供最小的存在性判断、主模型读取与错误断言，避免调用方重复解析结构。
  * - 让初始化、配置装配、运行时启动都复用同一套执行目标解释规则。
  *
@@ -45,6 +45,6 @@ export function readProjectExecutionBinding(
 export function assertProjectExecutionTarget(config: DowncityConfig): void {
   if (readProjectExecutionBinding(config) !== null) return;
   throw new Error(
-    'Invalid downcity.json: "execution" is required and must be { "type": "api", "modelId": "..." }',
+    'Invalid Agent config: "execution" is required and must be { "type": "api", "modelId": "..." }',
   );
 }

package/src/config/Paths.ts

@@ -12,75 +12,6 @@
  */
 import path from "path";
 
-/**
- * PROFILE.md 候选文件名（按优先级从高到低）。
- *
- * 关键点（中文）
- * - 统一使用大写文件名：`PROFILE.md`。
- * - 与 SOUL 一起作为静态 prompt 入口。
- */
-export const PROFILE_MD_FILE_CANDIDATES = ["PROFILE.md"] as const;
-
-/**
- * 返回项目主 `PROFILE.md` 的标准路径。
- *
- * 关键点（中文）
- * - 当前始终返回候选列表中的第一优先级文件。
- * - 调用方可把该路径视为初始化时默认写入位置。
- */
-export function getProfileMdPath(cwd: string): string {
-  return path.join(cwd, PROFILE_MD_FILE_CANDIDATES[0]);
-}
-
-/**
- * 返回 `PROFILE.md` 的全部候选路径。
- *
- * 关键点（中文）
- * - 便于后续扩展多候选命名时保持调用方逻辑不变。
- * - 当前虽然只有一个候选值，仍统一暴露数组接口。
- */
-export function getProfileMdCandidatePaths(cwd: string): string[] {
-  return PROFILE_MD_FILE_CANDIDATES.map((filename) => path.join(cwd, filename));
-}
-
-/**
- * SOUL.md 候选文件名（按优先级从高到低）。
- *
- * 关键点（中文）
- * - 统一使用大写文件名：`SOUL.md`。
- * - 统一由 Paths 模块暴露，避免调用方散落硬编码。
- */
-export const SOUL_MD_FILE_CANDIDATES = ["SOUL.md"] as const;
-
-/**
- * 返回项目主 `SOUL.md` 的标准路径。
- *
- * 关键点（中文）
- * - 当前始终返回候选列表中的第一优先级文件。
- * - 与 `PROFILE.md` 一样，属于静态 system prompt 入口文件。
- */
-export function getSoulMdPath(cwd: string): string {
-  return path.join(cwd, SOUL_MD_FILE_CANDIDATES[0]);
-}
-
-/**
- * 返回 `SOUL.md` 的全部候选路径。
- *
- * 关键点（中文）
- * - 供探测逻辑统一遍历候选文件名。
- * - 保留数组形式便于后续新增兼容命名。
- */
-export function getSoulMdCandidatePaths(cwd: string): string[] {
-  return SOUL_MD_FILE_CANDIDATES.map((filename) => path.join(cwd, filename));
-}
-
-/**
- * 返回项目主配置文件 `downcity.json` 的路径。
- */
-export function getDowncityJsonPath(cwd: string): string {
-  return path.join(cwd, "downcity.json");
-}
-
 /**
  * 返回项目运行时状态根目录 `.downcity` 的路径。
  */
@@ -88,26 +19,6 @@ export function getDowncityDirPath(cwd: string): string {
   return path.join(cwd, ".downcity");
 }
 
-/**
- * 返回项目内 schema 快照文件路径。
- *
- * 关键点（中文）
- * - 初始化流程会把本地 schema 副本写到这里，供编辑器联想与校验。
- */
-export function getDowncitySchemaPath(cwd: string): string {
-  return path.join(getDowncityDirPath(cwd), "schema", "downcity.schema.json");
-}
-
-/**
- * 返回 `.downcity/config` 目录路径。
- *
- * 关键点（中文）
- * - 用于存放项目级额外配置快照或未来扩展的辅助配置文件。
- */
-export function getDowncityConfigDirPath(cwd: string): string {
-  return path.join(getDowncityDirPath(cwd), "config");
-}
-
 /**
  * 返回项目日志目录路径。
  */

package/src/index.ts

@@ -146,11 +146,6 @@ export type {
   SessionComposerOptions,
 } from "./types/session/SessionComposerOptions.js";
 export { transformPromptsIntoSystemMessages } from "./executor/composer/system/default/PromptRenderer.js";
-export {
-  loadStaticSystemPrompts,
-  StaticPromptCatalog,
-} from "./executor/composer/system/default/StaticPromptCatalog.js";
-
 // 通用 plugin 宿主工具
 export {
   buildStaticPluginAvailability,
@@ -198,10 +193,12 @@ export type {
 // 项目与配置集成
 export {
   initializeAgentProject,
-  isAgentProjectInitialized,
   normalizeDefaultAgentId,
 } from "./config/AgentInitializer.js";
-export { loadDowncityConfig } from "./config/Config.js";
+export {
+  load_project_dotenv,
+  resolve_agent_env,
+} from "./config/AgentEnv.js";
 export {
   getDowncityChatHistoryPath,
   getDowncitySessionMessagesPath,
@@ -238,7 +235,14 @@ export type {
 export type { ExecutionBindingConfig } from "./types/config/ExecutionBinding.js";
 
 // 配置与模型类型
-export type { DowncityConfig } from "./types/config/DowncityConfig.js";
+export type {
+  DowncityChatChannelConfig,
+  DowncityChatPluginChannelsConfig,
+  DowncityChatPluginConfig,
+  DowncityChatPluginQueueConfig,
+  DowncityConfig,
+  DowncityPluginConfigMap,
+} from "./types/config/DowncityConfig.js";
 export type {
   LlmConfig,
   LlmModelConfig,
@@ -266,14 +270,6 @@ export type {
 
 export type {
   PlatformAgentChatChannelStatus,
-  PlatformAgentShipChatChannelsConfig,
-  PlatformAgentShipChatPluginConfig,
-  PlatformAgentShipExecutionAgentConfig,
-  PlatformAgentShipExecutionConfig,
-  PlatformAgentShipJson,
-  PlatformAgentShipPluginsConfig,
-  PlatformAgentShipSingleChannelConfig,
-  PlatformAgentShipStartConfig,
 } from "./types/runtime/platform/PlatformGateway.js";
 
 // Inline instant 协议类型

package/src/plugin/core/PluginLocalExecution.ts

@@ -9,7 +9,7 @@
 
 import path from "node:path";
 import { logger as defaultLogger } from "@/utils/logger/Logger.js";
-import { resolveAgentEnv } from "@/config/Config.js";
+import { resolve_agent_env } from "@/config/AgentEnv.js";
 import { findPluginByName } from "@/plugin/core/PluginCatalog.js";
 import {
   createAgentPathRuntime,
@@ -39,7 +39,7 @@ export function createLocalPluginCommandContext(
 ): PluginCommandContext {
   const projectRoot = typeof input === "string" ? input : input.projectRoot;
   const rootPath = path.resolve(String(projectRoot || "").trim() || ".");
-  const env = resolveAgentEnv(rootPath);
+  const env = resolve_agent_env(rootPath);
   const config = typeof input === "string" || !input.config
     ? createFallbackSdkConfig(path.basename(rootPath) || "agent")
     : input.config;

package/src/session/runtime/SessionPromptRuntime.ts

@@ -98,6 +98,21 @@ export interface SessionPromptRuntimeOptions {
     input: AgentSessionPromptInput,
   ) => Promise<SessionUserMessageV1>;
 
+  /**
+   * 在 steer message 成功持久化后发送对应 action。
+   */
+  emit_steer_action: (input: {
+    /**
+     * steer message 所属的当前 turn 标识。
+     */
+    turn_id: string;
+
+    /**
+     * 已成功持久化的 steer message。
+     */
+    message: SessionUserMessageV1;
+  }) => Promise<void>;
+
   /**
    * 执行单轮 turn。
    */
@@ -126,6 +141,7 @@ export class SessionPromptRuntime {
   private readonly sessionId: string;
   private readonly publish: SessionPromptRuntimeOptions["publish"];
   private readonly createAndPersistUserMessage: SessionPromptRuntimeOptions["createAndPersistUserMessage"];
+  private readonly emit_steer_action: SessionPromptRuntimeOptions["emit_steer_action"];
   private readonly executeTurn: SessionPromptRuntimeOptions["executeTurn"];
   private readonly stopTurn: SessionPromptRuntimeOptions["stopTurn"];
   private readonly queue: QueuedPrompt[] = [];
@@ -136,6 +152,7 @@ export class SessionPromptRuntime {
     this.sessionId = String(options.sessionId || "").trim();
     this.publish = options.publish;
     this.createAndPersistUserMessage = options.createAndPersistUserMessage;
+    this.emit_steer_action = options.emit_steer_action;
     this.executeTurn = options.executeTurn;
     this.stopTurn = options.stopTurn;
     if (!this.sessionId) {
@@ -329,12 +346,20 @@ export class SessionPromptRuntime {
     const merged: SessionUserMessageV1[] = [];
 
     for (let index = 0; index < drained.length; index += 1) {
-        const item = drained[index];
+      const item = drained[index];
+      try {
+        const message = await this.createAndPersistUserMessage(item.input);
+        item.deferredHandle.resolve(createTurnHandle(activeTurn));
+        merged.push(message);
         try {
-          const message = await this.createAndPersistUserMessage(item.input);
-          item.deferredHandle.resolve(createTurnHandle(activeTurn));
-          merged.push(message);
+          await this.emit_steer_action({
+            turn_id: activeTurn.turnId,
+            message,
+          });
         } catch {
+          // action 发送失败不应阻断已经持久化的 steer message。
+        }
+      } catch {
         // 关键点（中文）：若某条消息持久化失败，把未处理部分重新放回队列头部，避免静默丢失。
         const remaining = drained.slice(index);
         this.queue.unshift(...remaining);

package/src/session/services/SessionTurnService.ts

@@ -83,6 +83,15 @@ export class SessionTurnService {
           input,
         );
       },
+      emit_steer_action: async ({ turn_id, message }) => {
+        await this.state_service.emit_action_event({
+          id: `steer-message:${message.id}`,
+          title: "Session steer message sent",
+          description: "Merged a new user message into the active turn.",
+          state: "completed",
+          turnId: turn_id,
+        });
+      },
       executeTurn: async ({ turnId, promptInput, onStepMerge, abortSignal }) => {
         return await this.execute_prompt_turn({
           turnId,

package/src/types/agent/AgentOptions.ts

@@ -11,6 +11,7 @@ import type { Shell } from "@downcity/shell";
 import type { Plugin } from "@/types/plugin/PluginDefinition.js";
 import type { AgentModel } from "@/model/CityModelAdapter.js";
 import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
+import type { AgentPluginConfigRuntime } from "@/types/agent/AgentRuntimeAssembly.js";
 import type {
   AgentManagedSession,
   SessionOptions,
@@ -66,7 +67,7 @@ export interface AgentOptions {
    *
    * 关键点（中文）
    * - `instruction` 是稳定、缓存友好的 system 前缀，不做动态变量替换。
-   * - SDK 不主动读取 `PROFILE.md` / `SOUL.md`；这类项目文件应由 city 或调用方读取后传入。
+   * - 项目目录不再提供隐式 prompt 文件；调用方需要的指令必须显式传入。
    * - 未传入时，SDK 会使用包内最小 core instruction 作为 fallback。
    */
   instruction?: string | string[];
@@ -116,8 +117,17 @@ export interface AgentOptions {
    * 宿主显式传入的运行时配置。
    *
    * 关键点（中文）
-   * - SDK 不要求项目目录存在 `downcity.json`。
-   * - CLI / Console 可从自己的配置存储读取后传入这里。
+   * - SDK 不读取项目配置文件。
+   * - CLI / Console 从自己的全局配置存储读取后传入这里。
    */
   config?: DowncityConfig;
+
+  /**
+   * 宿主提供的 plugin 配置持久化能力。
+   *
+   * 关键点（中文）
+   * - SDK 默认会拒绝持久化操作；CLI 等宿主可在这里接入自己的全局数据库。
+   * - plugin 只依赖该稳定接口，不感知 SQLite、文件或远端服务等具体实现。
+   */
+  plugin_config?: AgentPluginConfigRuntime;
 }

package/src/types/common/EnvFile.ts

@@ -2,7 +2,7 @@
  * Env 文件工具相关类型定义。
  *
  * 职责说明（中文）
- * - 统一描述 `.env` / `.env.example` 写入工具使用的最小数据结构。
+ * - 统一描述项目 `.env` 写入工具使用的最小数据结构。
  * - 避免工具模块直接内联匿名对象，便于后续在其他初始化流程中复用。
  * - 这里只描述“文件写入条目”，不承载运行时环境变量快照语义。
  */

package/src/types/config/DowncityConfig.ts

@@ -74,20 +74,6 @@ export interface DowncityChatPluginQueueConfig {
   mergeMaxWaitMs?: number;
 }
 
-/**
- * 聊天插件出站控制配置。
- */
-export interface DowncityChatPluginEgressConfig {
-  /**
-   * 单次 agent run 内，`chat_send` 允许调用的最大次数。
-   */
-  chatSendMaxCallsPerRun?: number;
-  /**
-   * 是否启用 `chat_send` 幂等去重（基于 inbound messageId + 回复内容 hash）。
-   */
-  chatSendIdempotency?: boolean;
-}
-
 /**
  * 聊天插件配置。
  */
@@ -96,10 +82,6 @@ export interface DowncityChatPluginConfig {
    * Chat 调度队列（按 chatKey 分 lane）。
    */
   queue?: DowncityChatPluginQueueConfig;
-  /**
-   * 出站（egress）控制：用于限制工具发送、避免重复与无限循环刷屏。
-   */
-  egress?: DowncityChatPluginEgressConfig;
   /**
    * 消息平台 channel 配置。
    */
@@ -107,7 +89,7 @@ export interface DowncityChatPluginConfig {
 }
 
 /**
- * downcity.json 中的插件配置映射。
+ * Agent 全局配置中的插件配置映射。
  */
 export interface DowncityPluginConfigMap {
   /**
@@ -124,7 +106,6 @@ export interface DowncityPluginConfigMap {
 }
 
 export interface DowncityConfig {
-  $schema?: string;
   /**
    * agent 唯一标识。
    *
@@ -147,7 +128,7 @@ export interface DowncityConfig {
    *
    * 关键点（中文）
    * - 所有可配置能力统一收敛到 `plugins`，不再保留独立 `services` 域。
-   * - 需要持久化到项目文件的 plugin 配置（例如 `plugins.chat.channels`）放在这里。
+   * - 需要持久化的 plugin 配置（例如 `plugins.chat.channels`）由宿主写入全局配置存储。
    * - key 为 plugin 名称，value 为对应插件的结构化配置对象。
    * - 当前阶段允许各 plugin 自定义字段，但必须保持 JSON 可序列化。
    */
@@ -166,7 +147,7 @@ export interface DowncityConfig {
    * 关键点（中文）
    * - `@downcity/agent` 本地 SDK 不直接消费该字段。
    * - 宿主侧（例如 `downcity`）可读取该字段控制模型工厂行为，例如 `llm.logMessages`。
-   * - 对于项目内 `downcity.json`，通常不需要显式写 provider/model 明细。
+   * - 该字段通常由宿主平台装配，不由 Agent SDK 解析。
    */
   llm?: LlmConfig;
 }

package/src/types/config/ExecutionBinding.ts

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - 项目运行入口只有一种执行模式：`api`。
  * - 绑定 City AIService 暴露的模型 ID。
- * - 该类型是项目 `downcity.json` 中唯一的执行配置。
+ * - 该类型是 Agent 全局配置中的执行绑定结构。
  */
 
 /**

package/src/types/runtime/platform/Platform.ts

@@ -17,7 +17,7 @@ export interface PlatformAgentOption {
   id: string;
 
   /**
-   * agent 项目自身的稳定标识（优先 downcity.json.id，回退目录名推导）。
+   * Agent 全局配置中的稳定标识。
    */
   agentId: string;
 
@@ -90,7 +90,7 @@ export interface PlatformAgentOption {
   }>;
 
   /**
-   * 当前 agent 绑定的 console 模型 ID（downcity.json.execution.modelId）。
+   * 当前 Agent 全局配置绑定的模型 ID。
    */
   modelId?: string;
 }
@@ -154,16 +154,6 @@ export interface PlatformAgentDirectoryInspection {
    */
   initialized: boolean;
 
-  /**
-   * `downcity.json` 是否存在。
-   */
-  hasShipJson: boolean;
-
-  /**
-   * `PROFILE.md` 是否存在。
-   */
-  hasProfileMd: boolean;
-
   /** 该目录是否已出现在 managed agent registry 中。 */
   knownAgent: boolean;
 
@@ -266,7 +256,7 @@ export interface ControlPlaneRuntimeStatus {
  */
 export interface PlatformConfigFileStatusItem {
   /**
-   * 配置文件逻辑名称（例如 `ship_json`、`control_plane_pid`）。
+   * 配置状态逻辑名称（例如 `agent_config`、`control_plane_pid`）。
    */
   key: string;
 
@@ -336,7 +326,7 @@ export interface PlatformConfigStatusResponse {
   selectedAgentId: string;
 
   /**
-   * 当前选中的 agent 项目 id（即 `downcity.json.id`，可能为空）。
+   * 当前选中的 Agent 配置 id（可能为空）。
    */
   selectedAgentProjectId: string;