@downcity/agent 1.1.43 → 1.1.62

package/src/config/AgentInitializer.ts

@@ -2,7 +2,7 @@
  * Agent 项目初始化模块。
  *
  * 职责说明（中文）
- * - CLI `city agent create` 与 Console 共用同一套初始化逻辑，避免模板与目录结构分叉。
+ * - CLI `town agent create` 与 Console 共用同一套初始化逻辑，避免模板与目录结构分叉。
  * - 负责创建项目骨架、静态 prompt、默认 `downcity.json`、基础目录与 schema 文件。
  * - 负责把用户在创建阶段提供的最小执行配置与渠道配置写入项目。
  *
@@ -53,17 +53,19 @@ import { assertProjectExecutionTarget } from "@/config/ExecutionBinding.js";
 import type { ExecutionBindingConfig } from "@/types/config/ExecutionBinding.js";
 
 /**
- * 规范化默认 Agent 名称。
+ * 规范化默认 Agent ID。
  *
  * 关键点（中文）
- * - 把目录名中的 `_` / `-` 统一折叠为空格，产出更适合作为展示名的默认值。
- * - 这里只做轻量字符串清洗，不负责长度限制或唯一性处理。
+ * - 把目录名清洗为稳定、可重复的 snake_case 标识，避免展示名语义混入 SDK。
+ * - 这里只做最小格式规整，不负责跨项目唯一性分配。
  */
-export function normalizeDefaultAgentName(input: string): string {
+export function normalizeDefaultAgentId(input: string): string {
   return String(input || "")
     .trim()
-    .replace(/[_-]+/g, " ")
-    .replace(/\s+/g, " ")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "_")
+    .replace(/^_+|_+$/g, "")
+    .replace(/_{2,}/g, "_")
     .trim();
 }
 
@@ -112,8 +114,8 @@ export async function initializeAgentProject(
 ): Promise<AgentProjectInitializationResult> {
   const projectRoot = path.resolve(String(input.projectRoot || "").trim() || ".");
   const projectBaseName = path.basename(projectRoot);
-  const fallbackAgentName = normalizeDefaultAgentName(projectBaseName) || projectBaseName;
-  const agentName = String(input.agentName || "").trim() || fallbackAgentName;
+  const fallback_agent_id = normalizeDefaultAgentId(projectBaseName) || projectBaseName;
+  const agent_id = String(input.id || "").trim() || fallback_agent_id;
   const execution = input.execution as ExecutionBindingConfig;
 
   const channels = normalizeChannels(input.channels);
@@ -123,7 +125,7 @@ export async function initializeAgentProject(
   const skippedFiles: string[] = [];
 
   assertProjectExecutionTarget({
-    name: agentName,
+    id: agent_id,
     version: "1.0.0",
     execution,
   });
@@ -139,7 +141,7 @@ export async function initializeAgentProject(
   }
 
   const initTemplateVariables = {
-    agent_name: agentName,
+    agent_id,
   };
   const staticPromptFiles = [
     {
@@ -176,7 +178,7 @@ export async function initializeAgentProject(
 
   const shipConfig: DowncityConfig = {
     $schema: DEFAULT_DOWNCITY_JSON.$schema,
-    name: agentName,
+    id: agent_id,
     version: "1.0.0",
     execution,
     plugins: {
@@ -251,7 +253,7 @@ export async function initializeAgentProject(
 
   return {
     projectRoot,
-    agentName,
+    id: agent_id,
     ...(execution?.type === "api" && String(execution.modelId || "").trim()
       ? { modelId: String(execution.modelId || "").trim() }
       : {}),

package/src/config/Config.ts

@@ -2,9 +2,9 @@
  * Agent 项目配置读取与装配模块。
  *
  * 职责说明（中文）
- * - 统一负责读取 `downcity.json`、项目 `.env` 与外部注入的环境变量快照。
+ * - 统一负责读取 `downcity.json`、项目 `.env` 与宿主显式注入的基础 env。
  * - 负责把祖先目录中的多个 `downcity.json` 逐层合并成当前项目的最终配置。
- * - 负责在配置读取阶段完成 `${ENV_NAME}` 占位符替换与最小结构校验。
+ * - 负责在配置读取阶段完成最小结构校验。
  *
  * 边界说明（中文）
  * - 这里只做“配置文件 -> 运行时配置对象”的装配，不负责项目初始化写文件。
@@ -14,61 +14,18 @@ import dotenv from "dotenv";
 import fs from "fs-extra";
 import path from "path";
 import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
-import type { ResolvedConfigValue } from "@/types/common/ResolvedConfigValue.js";
 import { assertProjectExecutionTarget } from "@/config/ExecutionBinding.js";
-import { resolveEnvPlaceholdersDeep } from "@/config/ConfigEnvResolver.js";
 import { deepMerge } from "@/utils/object/DeepMerge.js";
 import { isPlainObject } from "@/utils/object/ObjectGuards.js";
 import { collectAncestorNamedFilePaths } from "@/utils/path/AncestorFiles.js";
 
 export type { DowncityConfig };
 
-/**
- * 读取平台共享环境变量（`env_entries.scope=global`）。
- *
- * 关键点（中文）
- * - 当前 agent 包内仍保留空实现占位，等待后续接入平台级持久化存储。
- * - 保持独立函数是为了让配置读取逻辑不依赖具体存储后端。
- */
-export function loadGlobalEnvFromStore(): Record<string, string> {
-  return {};
-}
-
-/**
- * 读取 agent 私有环境变量（`env_entries.scope=agent`）。
- *
- * 关键点（中文）
- * - 当前 agent 包内仍保留空实现占位，避免把平台存储细节耦合进运行时。
- * - 当 `agentId` 为空时直接返回空对象，表示没有可用私有环境变量。
- */
-export function loadAgentEnvFromStore(agentId: string): Record<string, string> {
-  const normalizedAgentId = String(agentId || "").trim();
-  if (!normalizedAgentId) return {};
-  return {};
-}
-
-/**
- * 读取 agent 最终环境变量快照。
- *
- * 关键点（中文）
- * - 来源：agent scope env（DB） + `<agent>/.env`（用户文件）。
- * - 冲突时 `.env` 优先，满足用户可在本地即时覆盖。
- */
-export function loadAgentEnvSnapshot(projectRoot: string): Record<string, string> {
-  const agentFromDb = loadAgentEnvFromStore(projectRoot);
-  const projectDotenv = loadProjectDotenv(projectRoot);
-  return {
-    ...agentFromDb,
-    ...projectDotenv,
-  };
-}
-
 /**
  * 读取项目 `.env` 快照（不污染全局 process.env）。
  *
  * 关键点（中文）
  * - 只返回当前 agent 项目自己的 env 映射，供 runtime 局部使用。
- * - 不再把 agent env 注入全局，避免多个 agent 在同一 control plane 进程里互相污染。
  */
 export function loadProjectDotenv(projectRoot: string): Record<string, string> {
   // 关键点（中文）
@@ -94,18 +51,31 @@ export function loadProjectDotenv(projectRoot: string): Record<string, string> {
 }
 
 /**
- * 读取单层 `downcity.json` 并完成环境变量占位符替换。
+ * 解析当前 agent 最终用户环境变量。
+ *
+ * 关键点（中文）
+ * - 合并顺序固定为：宿主显式 `env` < 项目 `.env`。
+ * - `@downcity/agent` 不再自动读取当前进程 `process.env`。
+ * - 这里返回的是“用户可感知”的最终 env，不包含 session/server 运行时元信息。
+ */
+export function resolveAgentEnv(
+  projectRoot: string,
+  hostEnv?: Record<string, string>,
+): Record<string, string> {
+  return {
+    ...(hostEnv ? { ...hostEnv } : {}),
+    ...loadProjectDotenv(projectRoot),
+  };
+}
+
+/**
+ * 读取单层 `downcity.json`。
  *
  * 关键点（中文）
  * - 单层读取不做字段语义校验，便于后续统一合并后再做最终断言。
- * - 环境变量解析策略由调用方注入，保持该函数只负责“遍历 + 替换”。
  */
-function readShipJsonLayer(
-  filePath: string,
-  resolveEnvVar: (name: string) => string | undefined,
-): ResolvedConfigValue {
-  const raw = fs.readJsonSync(filePath) as ResolvedConfigValue;
-  return resolveEnvPlaceholdersDeep(raw, resolveEnvVar);
+function readShipJsonLayer(filePath: string): unknown {
+  return fs.readJsonSync(filePath) as unknown;
 }
 
 /**
@@ -117,7 +87,7 @@ function readShipJsonLayer(
  */
 function assertNoProjectExtensionsLayer(
   filePath: string,
-  layer: ResolvedConfigValue,
+  layer: unknown,
 ): void {
   if (!isPlainObject(layer)) return;
   if (!Object.prototype.hasOwnProperty.call(layer, "extensions")) return;
@@ -131,36 +101,9 @@ function assertNoProjectExtensionsLayer(
  *
  * 关键点（中文）
  * - 读取顺序为“祖先目录 -> 当前项目目录”，后层配置覆盖前层配置。
- * - `.env` 只影响占位符解析，不会把值写回配置文件。
  * - 返回前会断言最小执行目标，保证 agent 至少知道该如何执行。
  */
-export function loadDowncityConfig(
-  projectRoot: string,
-  options?: {
-    projectEnv?: Record<string, string>;
-    agentEnv?: Record<string, string>;
-    globalEnv?: Record<string, string>;
-  },
-): DowncityConfig {
-  const projectDotenv = options?.projectEnv ?? loadProjectDotenv(projectRoot);
-  const agentEnv = options?.agentEnv ?? loadAgentEnvFromStore(projectRoot);
-  const globalEnv = options?.globalEnv ?? loadGlobalEnvFromStore();
-  const runtimeAgentEnv = {
-    ...agentEnv,
-    ...projectDotenv,
-  };
-  /**
-   * 读取 agent 项目私有环境变量（services）。
-   *
-   * 关键点（中文）
-   * - project 层只读当前项目 .env，不再回退到共享 env。
-   * - 从根上杜绝跨 agent 的服务凭据串用。
-   */
-  const resolveProjectEnvVar = (name: string): string | undefined => {
-    const projectValue = String(runtimeAgentEnv[name] || "").trim();
-    return projectValue || undefined;
-  };
-
+export function loadDowncityConfig(projectRoot: string): DowncityConfig {
   const ancestorShipJsonPaths = collectAncestorNamedFilePaths(
     projectRoot,
     "downcity.json",
@@ -171,7 +114,7 @@ export function loadDowncityConfig(
 
   let merged: unknown = undefined;
   for (const p of ancestorShipJsonPaths) {
-    const layer = readShipJsonLayer(p, resolveProjectEnvVar);
+    const layer = readShipJsonLayer(p);
     assertNoProjectExtensionsLayer(p, layer);
     merged = deepMerge(merged, layer);
   }
@@ -181,8 +124,8 @@ export function loadDowncityConfig(
   }
 
   const candidate = merged as Partial<DowncityConfig>;
-  if (typeof candidate.name !== "string" || typeof candidate.version !== "string") {
-    throw new Error("Invalid downcity.json: missing required fields name/version");
+  if (typeof candidate.id !== "string" || typeof candidate.version !== "string") {
+    throw new Error("Invalid downcity.json: missing required fields id/version");
   }
   const config = candidate as DowncityConfig;
   assertProjectExecutionTarget(config);

package/src/config/Defaults.ts

@@ -21,7 +21,7 @@ import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
  */
 export const DEFAULT_DOWNCITY_JSON: DowncityConfig = {
   $schema: "./.downcity/schema/downcity.schema.json",
-  name: "downcity",
+  id: "downcity",
   version: "1.0.0",
   start: {
     port: 5314,
@@ -31,14 +31,6 @@ export const DEFAULT_DOWNCITY_JSON: DowncityConfig = {
     type: "api",
     modelId: "default",
   },
-  context: {
-    messages: {
-      keepLastMessages: 30,
-      maxInputTokensApprox: 128000,
-      archiveOnCompact: true,
-      compactRatio: 0.5,
-    },
-  },
   plugins: {
     chat: {
       queue: {

package/src/config/DowncitySchema.ts

@@ -30,9 +30,8 @@ export const DOWNCITY_JSON_SCHEMA: JsonObject = {
       description:
         "JSON Schema reference for editor/IDE validation (e.g. ./.downcity/schema/downcity.schema.json).",
     },
-    name: { type: "string" },
+    id: { type: "string" },
     version: { type: "string" },
-    description: { type: "string" },
     start: {
       type: "object",
       additionalProperties: true,
@@ -47,70 +46,15 @@ export const DOWNCITY_JSON_SCHEMA: JsonObject = {
       properties: {
         type: {
           type: "string",
-          enum: ["api", "acp", "local"],
+          enum: ["api"],
         },
         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。",
+            "API 执行模式下绑定的 City AIService 模型 ID。",
         },
       },
-      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,
-        },
-      ],
+      required: ["type", "modelId"],
     },
     sandbox: {
       type: "object",
@@ -274,44 +218,6 @@ export const DOWNCITY_JSON_SCHEMA: JsonObject = {
             },
           },
         },
-        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: {
@@ -369,21 +275,5 @@ export const DOWNCITY_JSON_SCHEMA: JsonObject = {
       },
       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 },
-          },
-        },
-      },
-    },
   },
 };

package/src/config/ExecutionBinding.ts

@@ -7,7 +7,7 @@
  * - 让初始化、配置装配、运行时启动都复用同一套执行目标解释规则。
  *
  * 边界说明（中文）
- * - 这里只解析配置结构，不负责验证模型是否真实存在于平台模型池中。
+ * - 这里只解析配置结构，不负责验证模型是否真实存在于 City AIService 中。
  * - 当前只接受 agent 包已经落地支持的执行绑定格式。
  */
 
@@ -35,28 +35,6 @@ export function readProjectExecutionBinding(
   };
 }
 
-/**
- * 读取项目绑定的主模型 ID。
- *
- * 关键点（中文）
- * - 当项目尚未声明可用执行目标时，返回空字符串而不是抛错。
- * - 适合用于展示层或非强制校验场景读取默认值。
- */
-export function readProjectPrimaryModelId(config: DowncityConfig): string {
-  const execution = readProjectExecutionBinding(config);
-  return execution ? execution.modelId : "";
-}
-
-/**
- * 判断项目是否存在执行目标。
- *
- * 关键点（中文）
- * - 该函数只判断结构是否合法，不判断目标模型是否可运行。
- */
-export function hasProjectExecutionTarget(config: DowncityConfig): boolean {
-  return readProjectExecutionBinding(config) !== null;
-}
-
 /**
  * 断言项目已经声明执行目标。
  *
@@ -65,7 +43,7 @@ export function hasProjectExecutionTarget(config: DowncityConfig): boolean {
  * - 失败时抛出稳定错误文案，便于 CLI 和上层界面直接展示。
  */
 export function assertProjectExecutionTarget(config: DowncityConfig): void {
-  if (hasProjectExecutionTarget(config)) return;
+  if (readProjectExecutionBinding(config) !== null) return;
   throw new Error(
     'Invalid downcity.json: "execution" is required and must be { "type": "api", "modelId": "..." }',
   );

package/src/config/Paths.ts

@@ -127,6 +127,10 @@ export function getCacheDirPath(cwd: string): string {
 
 /**
  * 返回 profile 运行态目录路径。
+ *
+ * 关键点（中文）
+ * - 初始化流程会统一创建该目录，并在其中写入 profile 相关文件。
+ * - 单独保留目录级 API，避免调用方散落 `path.join(..., "profile")`。
  */
 export function getDowncityProfileDirPath(cwd: string): string {
   return path.join(getDowncityDirPath(cwd), "profile");
@@ -157,8 +161,9 @@ export function getDowncityProfileOtherPath(cwd: string): string {
  *
  * 关键点（中文）
  * - `.downcity/memory` 为跨会话记忆目录。
+ * - 当前仅供本模块内部继续拼接长期记忆与每日记忆路径。
  */
-export function getDowncityMemoryDirPath(cwd: string): string {
+function getDowncityMemoryDirPath(cwd: string): string {
   return path.join(getDowncityDirPath(cwd), "memory");
 }
 
@@ -216,8 +221,9 @@ export function getDowncityAgentsRootDirPath(cwd: string): string {
  *
  * 关键点（中文）
  * - `agentId` 会做 URL 编码，避免特殊字符污染文件系统结构。
+ * - 当前仅供本模块内部拼接 session 根目录使用。
  */
-export function getDowncityAgentDirPath(cwd: string, agentId: string): string {
+function getDowncityAgentDirPath(cwd: string, agentId: string): string {
   return path.join(
     getDowncityAgentsRootDirPath(cwd),
     encodeURIComponent(String(agentId || "").trim()),
@@ -283,23 +289,6 @@ export function getDowncitySessionMessagesPath(
   );
 }
 
-/**
- * 返回 session 历史元信息文件路径。
- *
- * 关键点（中文）
- * - 该文件保存 compaction、更新时间、SDK 配置等附加元信息。
- */
-export function getDowncitySessionHistoryMetaPath(
-  cwd: string,
-  agentId: string,
-  sessionId: string,
-): string {
-  return path.join(
-    getDowncitySessionMessagesDirPath(cwd, agentId, sessionId),
-    "meta.json",
-  );
-}
-
 /**
  * 返回 session 消息归档目录路径。
  *
@@ -368,8 +357,9 @@ export function getDowncityDebugDirPath(cwd: string): string {
  * 关键点（中文）
  * - 该目录存放 `sessionId -> chat` 的最近映射快照
  * - 与 core session messages 分离，避免把平台路由细节耦合进 core
+ * - 当前仅供本模块内部继续拼接 chat 会话与 meta 子目录。
  */
-export function getDowncityChatDirPath(cwd: string): string {
+function getDowncityChatDirPath(cwd: string): string {
   return path.join(getDowncityDirPath(cwd), "chat");
 }
 
@@ -394,29 +384,6 @@ export function getDowncityChannelMetaPath(cwd: string): string {
   return path.join(getDowncityChannelDirPath(cwd), "meta.json");
 }
 
-/**
- * 返回 chat 元信息目录路径。
- *
- * 关键点（中文）
- * - 用于按 sessionId 存放最近聊天路由快照与附加索引信息。
- */
-export function getDowncityChatMetaDirPath(cwd: string): string {
-  return path.join(getDowncityChatDirPath(cwd), "meta");
-}
-
-/**
- * 返回指定 session 的 chat 元信息文件路径。
- *
- * 关键点（中文）
- * - 文件名按 `sessionId` 编码，避免不同会话之间互相覆盖。
- */
-export function getDowncityChatMetaPath(cwd: string, sessionId: string): string {
-  return path.join(
-    getDowncityChatMetaDirPath(cwd),
-    `${encodeURIComponent(String(sessionId || "").trim())}.json`,
-  );
-}
-
 /**
  * Chat 会话目录（按 sessionId 组织）。
  *

package/src/config/PlatformPaths.ts

@@ -30,8 +30,12 @@ export function getPlatformRootDirPath(): string {
 
 /**
  * 返回平台级运行目录。
+ *
+ * 关键点（中文）
+ * - 当前仅供本模块内部拼接平台级派生路径使用。
+ * - 不再对外导出，避免暴露未被实际消费的路径 API。
  */
-export function getPlatformRuntimeDirPath(): string {
+function getPlatformRuntimeDirPath(): string {
   return path.join(getPlatformRootDirPath(), "main");
 }
 

package/src/executor/composer/compaction/jsonl/JsonlSessionCompactionExecutor.ts

@@ -191,10 +191,6 @@ export async function compactSessionMessagesIfNeeded(
     await deps.writeMetaUnsafe({
       ...prevMeta,
       updatedAt: Date.now(),
-      lastArchiveId: params.archiveOnCompact ? archiveId : undefined,
-      keepLastMessages: Math.max(1, currentKept.length),
-      maxInputTokensApprox: params.maxInputTokensApprox,
-      compactRatio,
     });
   });
 

package/src/executor/composer/system/default/InitPrompts.ts

@@ -1,5 +1,5 @@
 /**
- * InitPrompts：`city agent create` 默认 prompt 资产加载器。
+ * InitPrompts：`town agent create` 默认 prompt 资产加载器。
  *
  * 职责说明（中文）
  * - 统一管理 create 生成的 `PROFILE.md` / `SOUL.md` 默认内容。

package/src/executor/composer/system/default/SystemDomain.ts

@@ -74,7 +74,7 @@ export function buildContextSystemPrompt(input: {
   const outputRules = [
     "Task-run output rules:",
     "- This is a task execution context, not an interactive chat turn.",
-    "- Do NOT send external channel messages via `city chat send` unless explicitly required by the task itself.",
+    "- Do NOT send external channel messages via `town chat send` unless explicitly required by the task itself.",
     "- Reply with result-oriented content; do NOT paste raw tool outputs or JSON logs.",
     "- Keep output compact and avoid unnecessary conversational fillers.",
   ].join("\n");

package/src/executor/composer/system/default/assets/core.prompt.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/executor/composer/system/default/assets/core.prompt.ts.txt
-const TEXT_MODULE_CONTENT = "你拥有且仅拥有当前项目 {{project_path}} 的使用权和修改权。当前年份是 {{current_year}} 年。\n1. `.downcity/` 是 Downcity 的运行时数据目录（通常不需要你手动读取/修改；系统会自动写入与注入）。结构与逻辑如下：\n   - `.downcity/agents/<agentId>/sessions/` 是会话消息。\n   - `.downcity/memory/` 是中长期记忆。\n   - `.downcity/profile/Primary.md`、`.downcity/profile/other.md`：全局 profile 记忆；存在时会自动作为 system prompt 注入。\n   - `.downcity/public/`：对外静态资源目录，通过 `GET /downcity/public/<path>` 访问；用于给外部访问的路径。不要存放敏感信息，运行中的 agent server 会把 `.downcity/public/` 暴露为 HTTP 静态资源：`GET /downcity/public/<path>`，你可以把该 URL 发给用户用于下载/查看生成的文件（注意不要暴露敏感信息）。\n   - `.downcity/logs/<YYYY-MM-DD>.jsonl`：运行日志（JSONL）；用于排查问题，避免把原始日志整段贴给用户。\n   - `.downcity/.cache/`：幂等/去重缓存（ingress/egress）；不要手动改。\n   - `.downcity/.debug/`：调试产物（daemon pid/log/meta、适配器事件抓取等）；仅在排查问题时查看。\n   - `.downcity/data/`：小型持久化数据（预留）。\n   - `.downcity/task/`：Task 目录。\n2. PROFILE.md + SOUL.md + downcity.json 是你的一些配置文件，你不需要读取。\n\n# 最重要\n【关于命令执行工具】（重要）\n- 短命令、一次性命令优先使用 `shell_exec`。\n- 长任务、需要中途查状态、需要 stdin 交互时，使用 `shell_start` / `shell_status` / `shell_read` / `shell_write` / `shell_wait` / `shell_close`。\n- 先用 `shell_start` 启动命令并拿到 `shell_id`。\n- `shell_id` 是 shell 会话标识；它不是 chat `session_id`。\n- 长任务期间，优先使用 `shell_status` 查询进度，或使用 `shell_wait` 等待状态变化；不要自己写高频空轮询循环。\n- 只有在确实需要原始增量输出时，才使用 `shell_read` 按 `from_cursor` 继续读取。\n- 需要向进程 stdin 输入内容时，使用 `shell_write`。\n- 命令会话完成后若不再需要，使用 `shell_close` 主动释放资源。\n- 不要把原始超长 shell 输出直接转发给用户，应先总结。\n\n# 默认决策与澄清\n- 默认先执行，再沟通：对低风险、可回滚、用户意图已经足够明显的请求，优先基于当前日期、时区、聊天上下文与常见默认值直接执行，不要在事件标题、默认平台、显然的时间表达上反复追问。\n- 只有当“缺失信息会实质改变结果”时才追问；例如：会影响日期/对象/金额/账户/发送目标，或会触发不可逆、高风险、涉隐私操作。\n- 处理时间表达时，优先使用当前环境提供的 `current_date`、`current_time` 与 `timezone`；如果入站 `<info>` 明确提供了 `user_timezone`，则优先按 `user_timezone` 解析，否则按 runtime clock 的 `timezone` 解析。像“今天/明天/下午两点/提前两小时”这类表达，应先解析为绝对时间，再执行，并在回复里明确写出绝对日期时间。\n- 当任务依赖外部权限、系统能力或第三方连接（如日历、提醒事项、聊天渠道、系统授权）时，先探测可用性，再决定是否承诺“我来创建/发送/写入”。\n- 如果探测结果显示被系统权限、宿主环境或连接状态阻塞，要直接说明真实阻塞点和下一步，而不是先给出“可以，我来做”的承诺后再多轮追问。\n- 若已经有足够信息可以一次完成多个低风险默认动作，应直接完成，并在结果里简短说明采用了哪些默认假设。\n\n# 很重要\n\n安全与边界\n- 不要执行破坏性命令（如 `rm -rf`、`git reset --hard`）除非用户明确要求。\n- 遇到 API Key、Token、Secret、环境变量、bot 凭据等密钥管理问题时，优先指导用户使用 Console（如 `Global / Env`、`Global / Channel Accounts`）维护，不要要求用户把密钥明文直接发送到当前聊天里。\n- `city keys` 只能列出已配置的 key 名与描述，不会返回密钥值。不要让用户把密钥“发给你自己”或继续尝试通过 `city keys` 获取明文。\n";
+const TEXT_MODULE_CONTENT = "你拥有且仅拥有当前项目 {{project_path}} 的使用权和修改权。当前年份是 {{current_year}} 年。\n1. `.downcity/` 是 Downcity 的运行时数据目录（通常不需要你手动读取/修改；系统会自动写入与注入）。结构与逻辑如下：\n   - `.downcity/agents/<agentId>/sessions/` 是会话消息。\n   - `.downcity/memory/` 是中长期记忆。\n   - `.downcity/profile/Primary.md`、`.downcity/profile/other.md`：全局 profile 记忆；存在时会自动作为 system prompt 注入。\n   - `.downcity/public/`：对外静态资源目录，通过 `GET /downcity/public/<path>` 访问；用于给外部访问的路径。不要存放敏感信息，运行中的 agent server 会把 `.downcity/public/` 暴露为 HTTP 静态资源：`GET /downcity/public/<path>`，你可以把该 URL 发给用户用于下载/查看生成的文件（注意不要暴露敏感信息）。\n   - `.downcity/logs/<YYYY-MM-DD>.jsonl`：运行日志（JSONL）；用于排查问题，避免把原始日志整段贴给用户。\n   - `.downcity/.cache/`：幂等/去重缓存（ingress/egress）；不要手动改。\n   - `.downcity/.debug/`：调试产物（daemon pid/log/meta、适配器事件抓取等）；仅在排查问题时查看。\n   - `.downcity/data/`：小型持久化数据（预留）。\n   - `.downcity/task/`：Task 目录。\n2. PROFILE.md + SOUL.md + downcity.json 是你的一些配置文件，你不需要读取。\n\n# 最重要\n【关于命令执行工具】（重要）\n- 短命令、一次性命令优先使用 `shell_exec`。\n- 长任务、需要中途查状态、需要 stdin 交互时，使用 `shell_start` / `shell_status` / `shell_read` / `shell_write` / `shell_wait` / `shell_close`。\n- 先用 `shell_start` 启动命令并拿到 `shell_id`。\n- `shell_id` 是 shell 会话标识；它不是 chat `session_id`。\n- 长任务期间，优先使用 `shell_status` 查询进度，或使用 `shell_wait` 等待状态变化；不要自己写高频空轮询循环。\n- 只有在确实需要原始增量输出时，才使用 `shell_read` 按 `from_cursor` 继续读取。\n- 需要向进程 stdin 输入内容时，使用 `shell_write`。\n- 命令会话完成后若不再需要，使用 `shell_close` 主动释放资源。\n- 不要把原始超长 shell 输出直接转发给用户，应先总结。\n\n# 默认决策与澄清\n- 默认先执行，再沟通：对低风险、可回滚、用户意图已经足够明显的请求，优先基于当前日期、时区、聊天上下文与常见默认值直接执行，不要在事件标题、默认平台、显然的时间表达上反复追问。\n- 只有当“缺失信息会实质改变结果”时才追问；例如：会影响日期/对象/金额/账户/发送目标，或会触发不可逆、高风险、涉隐私操作。\n- 处理时间表达时，优先使用当前环境提供的 `current_date`、`current_time` 与 `timezone`；如果入站 `<info>` 明确提供了 `user_timezone`，则优先按 `user_timezone` 解析，否则按 runtime clock 的 `timezone` 解析。像“今天/明天/下午两点/提前两小时”这类表达，应先解析为绝对时间，再执行，并在回复里明确写出绝对日期时间。\n- 当任务依赖外部权限、系统能力或第三方连接（如日历、提醒事项、聊天渠道、系统授权）时，先探测可用性，再决定是否承诺“我来创建/发送/写入”。\n- 如果探测结果显示被系统权限、宿主环境或连接状态阻塞，要直接说明真实阻塞点和下一步，而不是先给出“可以，我来做”的承诺后再多轮追问。\n- 若已经有足够信息可以一次完成多个低风险默认动作，应直接完成，并在结果里简短说明采用了哪些默认假设。\n\n# 很重要\n\n安全与边界\n- 不要执行破坏性命令（如 `rm -rf`、`git reset --hard`）除非用户明确要求。\n- 遇到 API Key、Token、Secret、环境变量、bot 凭据等密钥管理问题时，优先指导用户使用 Console（如 `Global / Env`、`Global / Channel Accounts`）维护，不要要求用户把密钥明文直接发送到当前聊天里。\n- `town keys` 只能列出已配置的 key 名与描述，不会返回密钥值。不要让用户把密钥“发给你自己”或继续尝试通过 `town keys` 获取明文。\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/executor/composer/system/default/assets/core.prompt.ts.txt

@@ -36,4 +36,4 @@
 安全与边界
 - 不要执行破坏性命令（如 `rm -rf`、`git reset --hard`）除非用户明确要求。
 - 遇到 API Key、Token、Secret、环境变量、bot 凭据等密钥管理问题时，优先指导用户使用 Console（如 `Global / Env`、`Global / Channel Accounts`）维护，不要要求用户把密钥明文直接发送到当前聊天里。
-- `city keys` 只能列出已配置的 key 名与描述，不会返回密钥值。不要让用户把密钥“发给你自己”或继续尝试通过 `city keys` 获取明文。
+- `town keys` 只能列出已配置的 key 名与描述，不会返回密钥值。不要让用户把密钥“发给你自己”或继续尝试通过 `town keys` 获取明文。

package/src/executor/composer/system/default/assets/init/PROFILE.md.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/executor/composer/system/default/assets/init/PROFILE.md.ts.txt
-const TEXT_MODULE_CONTENT = "# 档案\n\n## 基本信息\n\n- 名字：`{{agent_name}}`\n- 身份：长期协作型助手\n- 关系：用户的合作者，不是用户的替身\n\n## 角色定位\n\n- 你负责理解目标、拆解问题、推动落地。\n\n## 身份边界\n\n- 可访问的信息不等于可传播的信息，隐私默认保密。\n- 坚持真实与可验证，不伪造结论、不编造事实。\n\n\n";
+const TEXT_MODULE_CONTENT = "# 档案\n\n## 基本信息\n\n- ID：`{{agent_id}}`\n- 身份：长期协作型助手\n- 关系：用户的合作者，不是用户的替身\n\n## 角色定位\n\n- 你负责理解目标、拆解问题、推动落地。\n\n## 身份边界\n\n- 可访问的信息不等于可传播的信息，隐私默认保密。\n- 坚持真实与可验证，不伪造结论、不编造事实。\n\n";
 
 export default TEXT_MODULE_CONTENT;