@my-life-buddies/cli 0.15.1 → 0.17.0

package/dist/bin/core.js

@@ -215,21 +215,16 @@ async function readRuntimeModelCatalog(projectRoot) {
   }
   return Object.freeze({ runtimeVersion, models: Object.freeze([...models]) });
 }
-async function validateRuntimeModel(projectRoot, model) {
-  if (model === void 0) return;
-  const catalog = await readRuntimeModelCatalog(projectRoot);
-  if (!catalog.models.includes(model)) throw new Error(`/model\uFF1A\u5DE5\u7A0B Runtime ${catalog.runtimeVersion} \u4E0D\u652F\u6301 ${model}\uFF1B\u53EF\u9009 ${catalog.models.join("\u3001")}`);
-}
 async function validateRuntimeDatasets(projectRoot, requirements = []) {
   const catalog = await readRuntimeDataCatalog(projectRoot);
   const ids = new Set(catalog.datasets.map((item) => item.id));
   for (const [index, item] of requirements.entries()) {
-    if (!ids.has(item.id)) throw new Error(`/datasets/${index}/id\uFF1A\u5DE5\u7A0B Runtime ${catalog.runtimeVersion} \u4E0D\u652F\u6301 ${item.id}`);
+    if (!ids.has(item.id)) throw new Error(`data-access.json/requirements/${index}/id\uFF1A\u5DE5\u7A0B Runtime ${catalog.runtimeVersion} \u4E0D\u652F\u6301 ${item.id}`);
   }
 }
 
 // packages/cli-core/src/project-context.ts
-import { lstat as lstat7, realpath as realpath3 } from "node:fs/promises";
+import { lstat as lstat7, realpath as realpath3, readFile as readFile10 } from "node:fs/promises";
 import { dirname, join as join9, resolve as resolve5 } from "node:path";
 
 // packages/cli-core/src/config/index.ts
@@ -240,68 +235,29 @@ import {
   open as open3,
   readFile as readFile9,
   readdir as readdir3,
-  rename as rename5,
+  rename as rename6,
   unlink as unlink4
 } from "node:fs/promises";
-import { randomUUID as randomUUID3 } from "node:crypto";
+import { randomUUID as randomUUID4 } from "node:crypto";
 import { isAbsolute as isAbsolute2, join as join8, resolve as resolve4, win32 } from "node:path";
 import { isDeepStrictEqual } from "node:util";
 import { Ajv2020 } from "ajv/dist/2020.js";
 
-// packages/cli-core/src/config/buddy.agent.schema.json
-var buddy_agent_schema_default = {
+// packages/cli-core/src/config/buddy.package.schema.json
+var buddy_package_schema_default = {
   $schema: "https://json-schema.org/draft/2020-12/schema",
-  title: "buddy.agent.json",
-  description: "\u642D\u642D\u9879\u76EE\u8EAB\u4EFD\u3001\u6A21\u578B\u9009\u62E9\u4E0E\u6570\u636E\u8BBF\u95EE\u9700\u6C42\uFF1B\u5DE5\u7A0B\u662F\u5426\u53EF\u8FD0\u884C\u7531\u5B9E\u9645\u6587\u4EF6\u5224\u65AD",
+  title: "Buddy package.json",
+  description: "package.json \u9876\u5C42 buddyId \u6807\u8BC6\u5E73\u53F0\u642D\u5B50\uFF1B\u5176\u4F59 npm \u5DE5\u7A0B\u5B57\u6BB5\u4FDD\u7559",
   type: "object",
-  additionalProperties: false,
   required: [
-    "schemaVersion",
     "buddyId"
   ],
   properties: {
-    schemaVersion: {
-      const: 1
-    },
     buddyId: {
       type: "string",
       minLength: 1,
       maxLength: 256,
-      pattern: "^[^\\s\\u0000-\\u001f\\u007f]+$",
-      description: "\u5E73\u53F0\u751F\u6210\u7684\u7A33\u5B9A\u642D\u5B50 ID"
-    },
-    model: {
-      type: "string",
-      minLength: 1,
-      maxLength: 128,
-      pattern: "^[^\\s\\u0000-\\u001f\\u007f]+$",
-      description: "\u4ECE buddy-cli models \u67E5\u770B Runtime \u6A21\u578B\u76EE\u5F55\uFF1B\u5DE5\u7A0B\u5185\u8BFB\u53D6\u5B89\u88C5\u7248\u672C\uFF0C\u5DE5\u7A0B\u5916\u8BFB\u53D6 npm \u6700\u65B0\u7248\u3002\u8FD0\u884C\u4E0E\u4E0A\u4F20\u9884\u68C0\u6309\u5DE5\u7A0B Runtime \u6821\u9A8C\u3002"
-    },
-    datasets: {
-      type: "array",
-      description: "\u672C\u642D\u5B50\u7533\u8BF7\u7684\u6570\u636E\u96C6\u53CA\u7528\u9014\uFF1B\u7701\u7565\u6216\u7A7A\u6570\u7EC4\u8868\u793A\u4E0D\u7533\u8BF7\u6570\u636E\uFF0C\u58F0\u660E\u4E0D\u4EE3\u8868\u7528\u6237\u5DF2\u6388\u6743",
-      default: [],
-      items: {
-        type: "object",
-        additionalProperties: false,
-        required: ["id", "purpose"],
-        properties: {
-          id: {
-            type: "string",
-            minLength: 1,
-            maxLength: 128,
-            pattern: "^[^\\s\\u0000-\\u001f\\u007f]+$",
-            description: "\u53D6\u503C\u6765\u81EA\u5DE5\u7A0B Runtime \u5BFC\u51FA\u7684 DATA_ACCESS_CAPABILITIES\uFF0C\u7531\u8FD0\u884C\u4E0E\u4E0A\u4F20\u9884\u68C0\u6821\u9A8C\u3002\u58F0\u660E\u6570\u91CF\u4E0D\u7B49\u4E8E\u5355\u6B21\u67E5\u8BE2\u4E0A\u9650\u3002"
-          },
-          purpose: {
-            type: "string",
-            minLength: 1,
-            maxLength: 200,
-            pattern: "\\S",
-            description: "\u5411\u7528\u6237\u8BF4\u660E\u8FD9\u53EA\u642D\u5B50\u4E3A\u4F55\u9700\u8981\u8BE5\u6570\u636E"
-          }
-        }
-      }
+      pattern: "^[^\\s\\u0000-\\u001f\\u007f]+$"
     }
   }
 };
@@ -818,8 +774,9 @@ import { lstat as lstat5 } from "node:fs/promises";
 import { join as join7 } from "node:path";
 
 // packages/cli-core/src/init/scaffold.ts
-import { lstat as lstat4, mkdir as mkdir5, open as open2, readFile as readFile8, rmdir as rmdir2, unlink as unlink3, writeFile as writeFile6 } from "node:fs/promises";
+import { lstat as lstat4, mkdir as mkdir5, open as open2, readFile as readFile8, rename as rename5, rmdir as rmdir2, unlink as unlink3 } from "node:fs/promises";
 import { resolve as resolve3 } from "node:path";
+import { randomUUID as randomUUID3 } from "node:crypto";
 
 // packages/cli-core/src/config/models.ts
 var MODEL_IDS = Object.freeze([
@@ -909,14 +866,13 @@ function platformAgentTemplate(name) {
   return `${promptFor(name)}
 `;
 }
-function platformFactoryTemplate() {
+function platformFactoryTemplate(model = DEFAULT_MODEL_ID) {
   return `import { readFileSync } from "node:fs";
 
 const systemPrompt = readFileSync(new URL("../agent.md", import.meta.url), "utf8").trim();
 if (!systemPrompt) throw new Error("agent.md must contain the Buddy system prompt");
-const config = JSON.parse(readFileSync(new URL("../buddy.agent.json", import.meta.url), "utf8"));
 /** @type {import("@my-life-buddies/buddy-runtime").ModelId} */
-const model = config.model ?? "${DEFAULT_MODEL_ID}";
+const model = ${JSON.stringify(model)};
 
 /**
  * Builds BuddyOptions when the Runtime creates an agent for a conversation.
@@ -924,7 +880,7 @@ const model = config.model ?? "${DEFAULT_MODEL_ID}";
  * Shared business code can live in ./services/; directories do not enable capabilities.
  * Use conversation.memory / dataAccess / widget / resource / proactive for platform capabilities.
  * Add conversation.tools.data_access_query / data_access_request / data_access_read_result
- * to initialState.tools for model-driven data access; declarations come from buddy.agent.json.datasets.
+ * to initialState.tools for model-driven data access; declarations come from data-access.json.requirements.
  * Add conversation.tools.ask_question for multiple-choice questions.
  * Add conversation.tools.resource_list / resource_read to discover and read reference material.
  * Place widget assets in ../widgets/<type-id>/index.html and schema.json.
@@ -947,27 +903,16 @@ export default function createBuddyOptions(_conversation) {
 }
 function platformStartTemplate() {
   return `// Generated startup: local DEV and hosted execution use the same Buddy Runtime.
-import { readFileSync } from "node:fs";
 import { BuddyServer } from "@my-life-buddies/buddy-runtime";
 import createBuddyOptions from "./src/buddy-options.mjs";
 
-const config = JSON.parse(readFileSync(new URL("./buddy.agent.json", import.meta.url), "utf8"));
-if (!config || config.schemaVersion !== 1 || typeof config.buddyId !== "string" || !config.buddyId) {
-  throw new Error("buddy.agent.json is not a complete Buddy project");
-}
-if (process.env.BUDDY_ID && process.env.BUDDY_ID !== config.buddyId) {
-  throw new Error("BUDDY_ID does not match buddy.agent.json");
-}
 const lifecycle = new AbortController();
 const stop = () => lifecycle.abort();
 process.on("SIGINT", stop);
 process.on("SIGTERM", stop);
 let runtime;
 try {
-  runtime = await BuddyServer.start({
-    dataRequirements: config.datasets ?? [],
-    buddy: createBuddyOptions,
-  });
+  runtime = await BuddyServer.start(createBuddyOptions);
   if (!lifecycle.signal.aborted) {
     await new Promise((resolve) => lifecycle.signal.addEventListener("abort", resolve, { once: true }));
   }
@@ -983,34 +928,13 @@ try {
 }
 `;
 }
-function legacyPlatformStartTemplate() {
-  return platformStartTemplate().replace("    dataRequirements: config.datasets ?? [],", "    buddyId: process.env.BUDDY_ID,\n    token: process.env.BUDDY_TOKEN,\n    dataRequirements: config.datasets ?? [],");
-}
-async function migrateRuntimeStartup(projectRoot) {
-  const packagePath = resolve3(projectRoot, BUDDY_PLATFORM_PACKAGE_JSON);
-  const entryPath = resolve3(projectRoot, BUDDY_PLATFORM_START_ENTRY);
-  for (const path of [packagePath, entryPath]) {
-    if (!(await lstat4(path)).isFile()) throw new Error("\u542F\u52A8\u6587\u4EF6\u5FC5\u987B\u662F\u666E\u901A\u6587\u4EF6\uFF0C\u4E0D\u80FD\u4F7F\u7528\u7B26\u53F7\u94FE\u63A5");
-  }
-  const pkg = JSON.parse(await readFile8(packagePath, "utf8"));
-  if (!runtimeUsesEnvironmentIdentity(pkg)) return false;
-  const current = await readFile8(entryPath, "utf8");
-  const latest = platformStartTemplate();
-  const legacy = legacyPlatformStartTemplate();
-  let changed2 = false;
-  if (current.replace(/\r\n/gu, "\n") === legacy) {
-    await writeFile6(entryPath, latest, "utf8");
-    changed2 = true;
-  }
-  if (pkg.scripts?.start === "node start.mjs") {
-    pkg.scripts.start = "node --env-file-if-exists=.env start.mjs";
-    await writeFile6(packagePath, JSON.stringify(pkg, null, 2) + "\n", "utf8");
-    changed2 = true;
-  }
-  return changed2;
-}
 async function scaffoldPlatformAgent(projectRoot, name, options = {}) {
   const path = resolve3(projectRoot, BUDDY_PLATFORM_AGENT_ENTRY);
+  const packagePath = resolve3(projectRoot, BUDDY_PLATFORM_PACKAGE_JSON);
+  if (!(await lstat4(packagePath)).isFile()) throw new Error("package.json \u5FC5\u987B\u662F\u666E\u901A\u6587\u4EF6");
+  const originalPackage = await readFile8(packagePath, "utf8");
+  const projectPackage = parseBuddyProjectManifest(originalPackage);
+  const isIdentityDraft = Object.keys(projectPackage).every((key) => key === "buddyId");
   const hasAlternateLockfile = (await Promise.all(["pnpm-lock.yaml", "yarn.lock"].map(async (name2) => {
     try {
       if (!(await lstat4(resolve3(projectRoot, name2))).isFile()) {
@@ -1024,10 +948,11 @@ async function scaffoldPlatformAgent(projectRoot, name, options = {}) {
   }))).some(Boolean);
   const files = [
     { path, content: platformAgentTemplate(name) },
-    { path: resolve3(projectRoot, BUDDY_PLATFORM_FACTORY_ENTRY), content: platformFactoryTemplate() },
+    { path: resolve3(projectRoot, BUDDY_PLATFORM_FACTORY_ENTRY), content: platformFactoryTemplate(options.model) },
     { path: resolve3(projectRoot, BUDDY_PLATFORM_PACKAGE_JSON), content: await readFile8(new URL("../../resources/agent-template/package.json", import.meta.url), "utf8") },
     ...hasAlternateLockfile ? [] : [{ path: resolve3(projectRoot, BUDDY_PLATFORM_PACKAGE_LOCK), content: await readFile8(new URL("../../resources/agent-template/package-lock.json", import.meta.url), "utf8") }],
     { path: resolve3(projectRoot, BUDDY_PLATFORM_START_ENTRY), content: platformStartTemplate() },
+    { path: resolve3(projectRoot, "data-access.json"), content: '{\n  "requirements": []\n}\n' },
     { path: resolve3(projectRoot, ".gitignore"), content: "node_modules/\n/.env\n" },
     { path: resolve3(projectRoot, ".env.example"), content: "# \u9996\u6B21\u8FD0\u884C buddy-cli dev \u6216\u5728\u540E\u53F0\u542F\u52A8 DEV \u65F6\uFF0CCLI \u4F1A\u51C6\u5907 .env\u3002\nBUDDY_ID=\nBUDDY_TOKEN=\n# \u53EF\u9009\uFF1A\u4F7F\u7528\u5176\u4ED6\u5E73\u53F0\u65F6\u8BBE\u7F6E MLB_GATEWAY_URL\u3002\n" }
   ];
@@ -1058,13 +983,17 @@ async function scaffoldPlatformAgent(projectRoot, name, options = {}) {
     }
     const packageFile = files.find((file) => file.path === resolve3(projectRoot, BUDDY_PLATFORM_PACKAGE_JSON));
     const lockFile = files.find((file) => file.path === resolve3(projectRoot, BUDDY_PLATFORM_PACKAGE_LOCK));
-    if (options.resolveDependencies && lockFile && handles.some((file) => file.path === packageFile.path) && handles.some((file) => file.path === lockFile.path)) {
+    packageFile.content = JSON.stringify({ ...JSON.parse(packageFile.content), buddyId: projectPackage.buddyId }, null, 2) + "\n";
+    if (options.resolveDependencies && isIdentityDraft && lockFile && handles.some((file) => file.path === lockFile.path)) {
       const template = await options.resolveDependencies({ packageJson: packageFile.content, packageLock: lockFile.content });
+      if (parseBuddyProjectManifest(template.packageJson).buddyId !== projectPackage.buddyId) {
+        throw new Error("\u4F9D\u8D56\u89E3\u6790\u6539\u53D8\u4E86 package.json.buddyId\uFF0C\u5DF2\u505C\u6B62\u8865\u9F50\u5DE5\u7A0B");
+      }
       packageFile.content = template.packageJson;
       lockFile.content = template.packageLock;
     }
-    if (lockFile && (handles.some((file) => file.path === packageFile.path) || handles.some((file) => file.path === lockFile.path))) {
-      const packageContents = handles.some((file) => file.path === packageFile.path) ? packageFile.content : await readFile8(packageFile.path, "utf8");
+    if (lockFile && (isIdentityDraft || handles.some((file) => file.path === lockFile.path))) {
+      const packageContents = isIdentityDraft ? packageFile.content : await readFile8(packageFile.path, "utf8");
       const lockContents = handles.some((file) => file.path === lockFile.path) ? lockFile.content : await readFile8(lockFile.path, "utf8");
       const declared = JSON.parse(packageContents).dependencies ?? {};
       const locked = JSON.parse(lockContents).packages?.[""]?.dependencies ?? {};
@@ -1072,17 +1001,30 @@ async function scaffoldPlatformAgent(projectRoot, name, options = {}) {
         throw new Error("\u5DF2\u6709 package.json \u4E0E\u5F85\u8865\u9F50\u7684\u9501\u6587\u4EF6\u4E0D\u4E00\u81F4\uFF0C\u8BF7\u7528\u5DE5\u7A0B\u7684\u5305\u7BA1\u7406\u5668\u6062\u590D\u5339\u914D\u7684\u4F9D\u8D56\u6587\u4EF6\u540E\u91CD\u8BD5");
       }
     }
-    const effectivePackage = handles.some((file) => file.path === packageFile.path) ? packageFile.content : await readFile8(packageFile.path, "utf8");
-    if (!runtimeUsesEnvironmentIdentity(JSON.parse(effectivePackage))) {
-      files.find((file) => file.path === resolve3(projectRoot, BUDDY_PLATFORM_START_ENTRY)).content = legacyPlatformStartTemplate();
-    }
     for (const { path: filePath, handle } of handles) {
       const file = files.find((candidate) => candidate.path === filePath);
       await handle.writeFile(file.content, "utf8");
       await handle.sync();
     }
-    const migrated = await migrateRuntimeStartup(projectRoot);
-    return Object.freeze({ path, created: migrated || handles.length > 0 || createdDirectories.length > 0 });
+    if (isIdentityDraft) {
+      const temporary = `${packagePath}.${randomUUID3()}.tmp`;
+      const handle = await open2(temporary, "wx", 384);
+      try {
+        await handle.writeFile(packageFile.content, "utf8");
+        await handle.sync();
+        await handle.close();
+        if (!(await lstat4(packagePath)).isFile() || await readFile8(packagePath, "utf8") !== originalPackage) {
+          throw new Error("\u8865\u9F50\u5DE5\u7A0B\u65F6 package.json \u5DF2\u6539\u53D8\uFF0C\u8BF7\u91CD\u8BD5");
+        }
+        await rename5(temporary, packagePath);
+      } finally {
+        await handle.close().catch(() => void 0);
+        await unlink3(temporary).catch((cause) => {
+          if (cause.code !== "ENOENT") throw cause;
+        });
+      }
+    }
+    return Object.freeze({ path, created: isIdentityDraft || handles.length > 0 || createdDirectories.length > 0 });
   } catch (cause) {
     await Promise.all(handles.map(({ handle }) => handle.close().catch(() => void 0)));
     await Promise.all(handles.map(({ path: createdPath }) => unlink3(createdPath).catch(() => void 0)));
@@ -1117,8 +1059,8 @@ async function missingBuddyAgentFiles(projectRoot) {
 }
 
 // packages/cli-core/src/config/index.ts
-var BUDDY_AGENT_FILENAME = "buddy.agent.json";
-var BUDDY_AGENT_SCHEMA = buddy_agent_schema_default;
+var BUDDY_PACKAGE_FILENAME = "package.json";
+var BUDDY_PACKAGE_SCHEMA = buddy_package_schema_default;
 var BuddyConfigValidationError = class extends Error {
   constructor(issues) {
     super(issues.map((issue2) => `${issue2.path}: ${issue2.message}`).join("\n"));
@@ -1128,7 +1070,7 @@ var BuddyConfigValidationError = class extends Error {
   issues;
 };
 var ajv = new Ajv2020({ allErrors: true, strict: true });
-var validateAgentSchema = ajv.compile(buddy_agent_schema_default);
+var validateAgentSchema = ajv.compile(buddy_package_schema_default);
 function schemaIssues(errors) {
   return (errors ?? []).map((error2) => ({
     path: error2.instancePath || "/",
@@ -1154,7 +1096,7 @@ function validateBuddyConfig(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
     return { ok: false, issues: [{ path: "/", message: "\u914D\u7F6E\u5FC5\u987B\u662F\u5BF9\u8C61" }] };
   }
-  const result = validateBuddyAgentConfig({ schemaVersion: 1, ...value });
+  const result = validateBuddyAgentConfig(value);
   return result.ok ? { ok: true, value } : result;
 }
 function assertBuddyConfig(value) {
@@ -1174,15 +1116,7 @@ function validateBuddyProjectManifest(value) {
   if (!validateAgentSchema(value)) {
     return { ok: false, issues: schemaIssues(validateAgentSchema.errors) };
   }
-  const manifest = value;
-  const seen = /* @__PURE__ */ new Set();
-  for (const [index, dataset] of (manifest.datasets ?? []).entries()) {
-    if (seen.has(dataset.id)) {
-      return { ok: false, issues: [{ path: `/datasets/${index}/id`, message: `\u6570\u636E\u96C6\u4E0D\u80FD\u91CD\u590D\u58F0\u660E\uFF1A${dataset.id}` }] };
-    }
-    seen.add(dataset.id);
-  }
-  return { ok: true, value: manifest };
+  return { ok: true, value };
 }
 function validateBuddyAgentConfig(value) {
   return validateBuddyProjectManifest(value);
@@ -1208,18 +1142,13 @@ function serializeBuddyAgentConfig(config) {
 `;
 }
 function buddyAgentConfig(config) {
-  return assertBuddyAgentConfig({ schemaVersion: 1, ...config });
+  return assertBuddyAgentConfig({ buddyId: config.buddyId });
 }
 function combineBuddyProject(config) {
-  const { schemaVersion: _version, ...project } = assertBuddyAgentConfig(config);
-  return project;
+  return { buddyId: assertBuddyAgentConfig(config).buddyId };
 }
 function createBuddyConfig(options) {
-  return assertBuddyConfig({
-    buddyId: options.buddyId,
-    ...options.model === void 0 ? {} : { model: options.model },
-    datasets: options.datasets ?? []
-  });
+  return assertBuddyConfig({ buddyId: options.buddyId });
 }
 var ProjectInitializationError = class extends Error {
   constructor(code2, message, targetPath, options) {
@@ -1296,7 +1225,7 @@ async function readExistingManifest(agentConfigPath) {
   if (state2.kind !== "other") {
     throw new ProjectInitializationError(
       "TARGET_CHANGED",
-      `${BUDDY_AGENT_FILENAME} \u5FC5\u987B\u662F\u666E\u901A\u6587\u4EF6\uFF0C\u4E0D\u80FD\u662F\u76EE\u5F55\u3002`,
+      `${BUDDY_PACKAGE_FILENAME} \u5FC5\u987B\u662F\u666E\u901A\u6587\u4EF6\uFF0C\u4E0D\u80FD\u662F\u76EE\u5F55\u3002`,
       agentConfigPath
     );
   }
@@ -1304,7 +1233,7 @@ async function readExistingManifest(agentConfigPath) {
   if (!entry2.isFile() || entry2.isSymbolicLink()) {
     throw new ProjectInitializationError(
       "TARGET_CHANGED",
-      `${BUDDY_AGENT_FILENAME} \u5FC5\u987B\u662F\u9879\u76EE\u5185\u7684\u666E\u901A\u6587\u4EF6\uFF0C\u4E0D\u80FD\u662F\u7B26\u53F7\u94FE\u63A5\u3002`,
+      `${BUDDY_PACKAGE_FILENAME} \u5FC5\u987B\u662F\u9879\u76EE\u5185\u7684\u666E\u901A\u6587\u4EF6\uFF0C\u4E0D\u80FD\u662F\u7B26\u53F7\u94FE\u63A5\u3002`,
       agentConfigPath
     );
   }
@@ -1313,7 +1242,7 @@ async function readExistingManifest(agentConfigPath) {
   } catch (cause) {
     throw new ProjectInitializationError(
       "TARGET_CHANGED",
-      `\u65E0\u6CD5\u8BFB\u53D6\u6216\u6821\u9A8C\u5DF2\u6709 ${BUDDY_AGENT_FILENAME}\u3002`,
+      `\u65E0\u6CD5\u8BFB\u53D6\u6216\u6821\u9A8C\u5DF2\u6709 ${BUDDY_PACKAGE_FILENAME}\u3002`,
       agentConfigPath,
       { cause }
     );
@@ -1321,7 +1250,7 @@ async function readExistingManifest(agentConfigPath) {
 }
 async function planBuddyDraftInitialization(directory) {
   const rootDirectory = resolve4(directory);
-  const agentConfigPath = join8(rootDirectory, BUDDY_AGENT_FILENAME);
+  const agentConfigPath = join8(rootDirectory, BUDDY_PACKAGE_FILENAME);
   const state2 = await pathState(rootDirectory);
   if (state2.kind === "other") {
     throw new ProjectInitializationError(
@@ -1349,7 +1278,7 @@ async function planBuddyDraftInitialization(directory) {
 }
 async function planBuddyProjectInitialization(options) {
   const rootDirectory = resolve4(options.directory);
-  const agentConfigPath = resolve4(rootDirectory, BUDDY_AGENT_FILENAME);
+  const agentConfigPath = resolve4(rootDirectory, BUDDY_PACKAGE_FILENAME);
   const state2 = await pathState(rootDirectory);
   if (state2.kind === "other") {
     throw new ProjectInitializationError(
@@ -1395,7 +1324,7 @@ async function publishNewFile(options) {
   let publishedHandle;
   const temporaryPath = join8(
     options.rootDirectory,
-    `.${options.temporaryLabel}.${process.pid}.${randomUUID3()}.tmp`
+    `.${options.temporaryLabel}.${process.pid}.${randomUUID4()}.tmp`
   );
   let temporaryIdentity;
   let publishedIdentity;
@@ -1466,7 +1395,7 @@ async function publishNewFile(options) {
 async function replaceExistingFile(options) {
   const temporaryPath = join8(
     options.rootDirectory,
-    `.${options.temporaryLabel}.${process.pid}.${randomUUID3()}.tmp`
+    `.${options.temporaryLabel}.${process.pid}.${randomUUID4()}.tmp`
   );
   const handle = await open3(temporaryPath, "wx", 384);
   try {
@@ -1478,7 +1407,7 @@ async function replaceExistingFile(options) {
   try {
     const root = await pathState(options.rootDirectory);
     if (root.kind !== "directory" || root.identity !== options.directoryIdentity || await fileIdentity(options.targetPath) !== options.expectedFileIdentity) throw targetChanged({ rootDirectory: options.rootDirectory });
-    await rename5(temporaryPath, options.targetPath);
+    await rename6(temporaryPath, options.targetPath);
     if (await readFile9(options.targetPath, "utf8") !== options.contents) {
       throw targetChanged({ rootDirectory: options.rootDirectory });
     }
@@ -1496,7 +1425,7 @@ async function applyBuddyDraftInitialization(plan, draft) {
     if (current === void 0 || current.buddyId !== draft.buddyId || (await missingBuddyAgentFiles(plan.rootDirectory)).length === 0) {
       throw new ProjectInitializationError(
         "ALREADY_INITIALIZED",
-        `\u5DF2\u6709 ${BUDDY_AGENT_FILENAME} \u7ED1\u5B9A\u7684 buddyId \u4E0E\u672C\u6B21\u4E91\u7AEF\u642D\u5B50\u4E0D\u4E00\u81F4\u3002`,
+        `\u5DF2\u6709 ${BUDDY_PACKAGE_FILENAME} \u7ED1\u5B9A\u7684 buddyId \u4E0E\u672C\u6B21\u4E91\u7AEF\u642D\u5B50\u4E0D\u4E00\u81F4\u3002`,
         plan.agentConfigPath
       );
     }
@@ -1520,7 +1449,7 @@ async function applyBuddyDraftInitialization(plan, draft) {
     if (cause.code === "EEXIST") {
       throw new ProjectInitializationError(
         "ALREADY_INITIALIZED",
-        `\u9879\u76EE\u5DF2\u7ECF\u5B58\u5728 ${BUDDY_AGENT_FILENAME}\uFF0C\u6CA1\u6709\u8986\u76D6\u4EFB\u4F55\u6587\u4EF6\u3002`,
+        `\u9879\u76EE\u5DF2\u7ECF\u5B58\u5728 ${BUDDY_PACKAGE_FILENAME}\uFF0C\u6CA1\u6709\u8986\u76D6\u4EFB\u4F55\u6587\u4EF6\u3002`,
         plan.agentConfigPath,
         { cause }
       );
@@ -1528,7 +1457,7 @@ async function applyBuddyDraftInitialization(plan, draft) {
     if (cause instanceof ProjectInitializationError) throw cause;
     throw new ProjectInitializationError(
       "WRITE_FAILED",
-      `\u65E0\u6CD5\u5199\u5165 ${BUDDY_AGENT_FILENAME}\uFF0C\u9879\u76EE\u8EAB\u4EFD\u6CA1\u6709\u521D\u59CB\u5316\u5B8C\u6210\u3002`,
+      `\u65E0\u6CD5\u5199\u5165 ${BUDDY_PACKAGE_FILENAME}\uFF0C\u9879\u76EE\u8EAB\u4EFD\u6CA1\u6709\u521D\u59CB\u5316\u5B8C\u6210\u3002`,
       plan.agentConfigPath,
       { cause }
     );
@@ -1539,7 +1468,7 @@ async function applyBuddyProjectInitialization(plan, config) {
   if (plan.existingManifest !== void 0 && plan.existingManifest.buddyId !== requestedConfig.buddyId) {
     throw new ProjectInitializationError(
       "ALREADY_INITIALIZED",
-      `\u5DF2\u6709 ${BUDDY_AGENT_FILENAME} \u7ED1\u5B9A\u7684\u662F ${plan.existingManifest.buddyId}\uFF0C\u4E0D\u80FD\u6539\u6210 ${requestedConfig.buddyId}\u3002`,
+      `\u5DF2\u6709 ${BUDDY_PACKAGE_FILENAME} \u7ED1\u5B9A\u7684\u662F ${plan.existingManifest.buddyId}\uFF0C\u4E0D\u80FD\u6539\u6210 ${requestedConfig.buddyId}\u3002`,
       plan.agentConfigPath
     );
   }
@@ -1585,7 +1514,7 @@ async function applyBuddyProjectInitialization(plan, config) {
     if (cause.code === "EEXIST") {
       throw new ProjectInitializationError(
         "ALREADY_INITIALIZED",
-        `${BUDDY_AGENT_FILENAME} \u5DF2\u88AB\u5176\u4ED6\u64CD\u4F5C\u521B\u5EFA\uFF0C\u6CA1\u6709\u8986\u76D6\u4EFB\u4F55\u6587\u4EF6\u3002`,
+        `${BUDDY_PACKAGE_FILENAME} \u5DF2\u88AB\u5176\u4ED6\u64CD\u4F5C\u521B\u5EFA\uFF0C\u6CA1\u6709\u8986\u76D6\u4EFB\u4F55\u6587\u4EF6\u3002`,
         plan.rootDirectory,
         { cause }
       );
@@ -1593,7 +1522,7 @@ async function applyBuddyProjectInitialization(plan, config) {
     if (cause instanceof ProjectInitializationError) throw cause;
     throw new ProjectInitializationError(
       "WRITE_FAILED",
-      `\u65E0\u6CD5\u5199\u5165 ${BUDDY_AGENT_FILENAME}\uFF0C\u9879\u76EE\u521D\u59CB\u5316\u6CA1\u6709\u5B8C\u6210\u3002`,
+      `\u65E0\u6CD5\u5199\u5165 ${BUDDY_PACKAGE_FILENAME}\uFF0C\u9879\u76EE\u521D\u59CB\u5316\u6CA1\u6709\u5B8C\u6210\u3002`,
       plan.rootDirectory,
       { cause }
     );
@@ -1605,11 +1534,11 @@ async function initializeBuddyProject(options) {
 }
 async function readBuddyProjectManifest(projectRoot) {
   const rootDirectory = resolve4(projectRoot);
-  return parseBuddyProjectManifest(await readFile9(resolve4(rootDirectory, BUDDY_AGENT_FILENAME), "utf8"));
+  return parseBuddyProjectManifest(await readFile9(resolve4(rootDirectory, BUDDY_PACKAGE_FILENAME), "utf8"));
 }
 async function readBuddyAgentConfig(projectRoot) {
   const rootDirectory = resolve4(projectRoot);
-  const source = await readFile9(resolve4(rootDirectory, BUDDY_AGENT_FILENAME), "utf8");
+  const source = await readFile9(resolve4(rootDirectory, BUDDY_PACKAGE_FILENAME), "utf8");
   return parseBuddyAgentConfig(source);
 }
 async function readBuddyConfig(projectRoot) {
@@ -1673,7 +1602,15 @@ async function projectFileState(directory, filename) {
 async function searchUp(startDirectory) {
   let directory = startDirectory;
   while (true) {
-    if (await projectFileState(directory, BUDDY_AGENT_FILENAME) === "valid") return directory;
+    if (await projectFileState(directory, BUDDY_PACKAGE_FILENAME) === "valid") {
+      let pkg;
+      try {
+        pkg = JSON.parse(await readFile10(join9(directory, BUDDY_PACKAGE_FILENAME), "utf8"));
+      } catch (cause) {
+        throw new BuddyProjectContextError("PROJECT_CONFIG_INVALID", `\u65E0\u6CD5\u89E3\u6790 ${join9(directory, BUDDY_PACKAGE_FILENAME)}`, directory, { cause });
+      }
+      if (pkg && typeof pkg === "object" && Object.hasOwn(pkg, "buddyId")) return directory;
+    }
     const parent = dirname(directory);
     if (parent === directory) return void 0;
     directory = parent;
@@ -1690,14 +1627,14 @@ async function requireBuddyProjectRoot(startDirectory) {
     "PROJECT_NOT_FOUND",
     [
       "\u5F53\u524D\u76EE\u5F55\u4E0D\u5C5E\u4E8E\u642D\u642D\u9879\u76EE\u3002",
-      `\u8BF7\u8FDB\u5165\u5305\u542B ${BUDDY_AGENT_FILENAME} \u7684\u9879\u76EE\u76EE\u5F55\u540E\u91CD\u8BD5\uFF0C\u6216\u8005\u8FD0\u884C buddy-cli init \u521B\u5EFA\u65B0\u9879\u76EE\u3002`
+      `\u8BF7\u8FDB\u5165\u5305\u542B\u9876\u5C42 buddyId \u7684 ${BUDDY_PACKAGE_FILENAME} \u6240\u5728\u9879\u76EE\u76EE\u5F55\u540E\u91CD\u8BD5\uFF0C\u6216\u8005\u8FD0\u884C buddy-cli init \u521B\u5EFA\u65B0\u9879\u76EE\u3002`
     ].join("\n"),
     requested
   );
 }
 async function requireBuddyAgentProjectRoot(startDirectory) {
   const root = await requireBuddyProjectRoot(startDirectory);
-  const agentPath = join9(root, BUDDY_AGENT_FILENAME);
+  const agentPath = join9(root, BUDDY_PACKAGE_FILENAME);
   try {
     await readBuddyAgentConfig(root);
     const missing2 = await missingBuddyAgentFiles(root);
@@ -1707,7 +1644,7 @@ async function requireBuddyAgentProjectRoot(startDirectory) {
     throw new BuddyProjectContextError(
       "PROJECT_NOT_FOUND",
       [
-        `\u5F53\u524D buddy.agent.json \u6240\u5728\u5DE5\u7A0B\u5C1A\u4E0D\u53EF\u8FD0\u884C\uFF1A${cause instanceof Error ? cause.message : "\u8BF7\u68C0\u67E5 buddy.agent.json \u4E0E\u5DE5\u7A0B\u6587\u4EF6"}`,
+        `\u5F53\u524D package.json \u6240\u5728\u5DE5\u7A0B\u5C1A\u4E0D\u53EF\u8FD0\u884C\uFF1A${cause instanceof Error ? cause.message : "\u8BF7\u68C0\u67E5 package.json \u4E0E\u5DE5\u7A0B\u6587\u4EF6"}`,
         "\u8BF7\u5148\u8FD0\u884C buddy-cli init --mode direct \u8865\u9F50\u5B98\u65B9 Runtime \u5DE5\u7A0B\uFF0C\u518D\u8FD0\u884C dev\u3001preview \u6216 push\u3002"
       ].join("\n"),
       agentPath,
@@ -1768,7 +1705,7 @@ async function assertInitializableBuddyTarget(target) {
     } catch (cause) {
       throw new BuddyProjectContextError(
         "PROJECT_CONFIG_INVALID",
-        `${join9(projectRoot, BUDDY_AGENT_FILENAME)} \u4E0D\u662F\u6709\u6548\u7684\u9879\u76EE\u6E05\u5355\u3002`,
+        `${join9(projectRoot, BUDDY_PACKAGE_FILENAME)} \u4E0D\u662F\u6709\u6548\u7684\u9879\u76EE\u6E05\u5355\u3002`,
         requested,
         { cause }
       );
@@ -1799,7 +1736,7 @@ async function runtimeCatalogSource(directory, options = {}) {
 var MODELS_COMMAND_HELP = `\u7528\u6CD5: buddy-cli models [--directory <\u9879\u76EE\u76EE\u5F55>] [--json]
 \u59CB\u7EC8\u8054\u7F51\u67E5\u8BE2\u516C\u5171 npm \u6700\u65B0 Runtime\uFF0C\u8BFB\u53D6\u5E76\u7F13\u5B58\u5176\u6A21\u578B\u76EE\u5F55\u3002
 \u65E0\u9700\u767B\u5F55\u642D\u642D\u8D26\u53F7\u3002\u8F93\u51FA\u5305\u542B\u5B9E\u9645 Runtime \u7248\u672C\u548C\u6765\u6E90\u3002
-\u5C06\u6240\u9009 ID \u5199\u5165 buddy.agent.json.model\uFF1B\u6A21\u677F\u5728 initialState.model \u4E2D\u4F7F\u7528\u5B83\u3002`;
+\u5C06\u6240\u9009 ID \u5199\u5165 src/buddy-options.mjs \u7684 initialState.model\uFF1B\u6A21\u677F\u5728 initialState.model \u4E2D\u4F7F\u7528\u5B83\u3002`;
 async function runModelsCommand(args, io, cwd, options = {}) {
   try {
     if (args.length === 1 && (args[0] === "--help" || args[0] === "-h")) {
@@ -1820,7 +1757,7 @@ ${MODELS_COMMAND_HELP}`);
     else {
       io.write(`npm \u6700\u65B0 Runtime ${catalog.runtimeVersion} \u63D0\u4F9B ${catalog.models.length} \u4E2A\u6A21\u578B\uFF1A`);
       for (const id of catalog.models) io.write(`- ${id}`);
-      io.write("\u5C06\u6240\u9009 ID \u5199\u5165 buddy.agent.json.model\uFF1B\u81EA\u5B9A\u4E49\u4F1A\u8BDD\u5DE5\u5382\u4E5F\u53EF\u6309\u4F1A\u8BDD\u8BBE\u7F6E initialState.model\u3002");
+      io.write("\u5C06\u6240\u9009 ID \u5199\u5165 src/buddy-options.mjs \u7684 initialState.model\uFF1B\u81EA\u5B9A\u4E49\u4F1A\u8BDD\u5DE5\u5382\u4E5F\u53EF\u6309\u4F1A\u8BDD\u8BBE\u7F6E initialState.model\u3002");
     }
     return { exitCode: 0 };
   } catch (cause) {
@@ -1830,13 +1767,13 @@ ${MODELS_COMMAND_HELP}`);
 }
 
 // packages/cli-core/src/index.ts
-import { lstat as lstat13 } from "node:fs/promises";
+import { lstat as lstat14 } from "node:fs/promises";
 
 // packages/cli-core/src/commands/datasets.ts
 import { resolve as resolve7 } from "node:path";
 var DATASETS_COMMAND_HELP = `\u7528\u6CD5: buddy-cli datasets [--directory <\u9879\u76EE\u76EE\u5F55>] [--json]
 \u59CB\u7EC8\u8054\u7F51\u67E5\u8BE2\u516C\u5171 npm \u6700\u65B0 Runtime\uFF0C\u8BFB\u53D6\u5E76\u7F13\u5B58\u5176 DATA_ACCESS_CAPABILITIES\u3002
-\u65E0\u9700\u767B\u5F55\u642D\u642D\u8D26\u53F7\u3002\u5C06\u6240\u9009 id \u4E0E\u7528\u9014 purpose \u5199\u5165 buddy.agent.json.datasets\uFF1B\u76EE\u5F55\u4E0D\u4EE3\u8868\u7528\u6237\u5DF2\u6388\u6743\u3002`;
+\u65E0\u9700\u767B\u5F55\u642D\u642D\u8D26\u53F7\u3002\u5C06\u6240\u9009 id \u4E0E\u7528\u9014 purpose \u5199\u5165 data-access.json.requirements\uFF1B\u76EE\u5F55\u4E0D\u4EE3\u8868\u7528\u6237\u5DF2\u6388\u6743\u3002`;
 async function runDatasetsCommand(args, io, cwd, options = {}) {
   try {
     if (args.length === 1 && (args[0] === "--help" || args[0] === "-h")) {
@@ -1857,7 +1794,7 @@ ${DATASETS_COMMAND_HELP}`);
     else {
       io.write(`npm \u6700\u65B0 Runtime ${catalog.runtimeVersion} \u63D0\u4F9B ${catalog.datasets.length} \u9879\u6570\u636E\u80FD\u529B\uFF1A`);
       for (const item of catalog.datasets) io.write(`- ${item.id} \u2014 ${item.title}\uFF08${item.source}\uFF0CSchema ${item.schemaVersion}\uFF09`);
-      io.write("\u5C06\u6240\u9009 id \u548C purpose \u5199\u5165 buddy.agent.json.datasets\uFF1B\u7528\u6237\u6388\u6743\u7531\u5E73\u53F0\u5904\u7406\u3002");
+      io.write("\u5C06\u6240\u9009 id \u548C purpose \u5199\u5165 data-access.json.requirements\uFF1B\u7528\u6237\u6388\u6743\u7531\u5E73\u53F0\u5904\u7406\u3002");
     }
     return { exitCode: 0 };
   } catch (cause) {
@@ -1867,8 +1804,8 @@ ${DATASETS_COMMAND_HELP}`);
 }
 
 // packages/cli-core/src/commands/knowledge.ts
-import { createHash as createHash2, randomUUID as randomUUID4 } from "node:crypto";
-import { lstat as lstat8, mkdir as mkdir7, readFile as readFile10, rename as rename6, unlink as unlink5, writeFile as writeFile7 } from "node:fs/promises";
+import { createHash as createHash2, randomUUID as randomUUID5 } from "node:crypto";
+import { lstat as lstat8, mkdir as mkdir7, readFile as readFile11, rename as rename7, unlink as unlink5, writeFile as writeFile6 } from "node:fs/promises";
 import { dirname as dirname2, join as join10, resolve as resolve8 } from "node:path";
 var MANIFEST = "knowledge-manifest.json";
 var INDEX = "resources/knowledge/index.md";
@@ -1927,7 +1864,7 @@ async function read(root, path) {
   });
   if (!entry2) return void 0;
   if (!entry2.isFile() || entry2.size > MAX_BYTES) throw new Error(`\u6587\u4EF6\u5FC5\u987B\u662F\u666E\u901A\u6587\u4EF6\u4E14\u4E0D\u8D85\u8FC7 100 MiB\uFF1A${path}`);
-  return readFile10(full);
+  return readFile11(full);
 }
 async function requiredRead(root, path) {
   const bytes = await read(root, path);
@@ -1937,10 +1874,10 @@ async function requiredRead(root, path) {
 async function atomicWrite(root, path, value) {
   const full = await safePath(root, path);
   await mkdir7(dirname2(full), { recursive: true });
-  const temporary = `${full}.${randomUUID4()}.tmp`;
-  await writeFile7(temporary, value, { flag: "wx", mode: 384 });
+  const temporary = `${full}.${randomUUID5()}.tmp`;
+  await writeFile6(temporary, value, { flag: "wx", mode: 384 });
   try {
-    await rename6(temporary, full);
+    await rename7(temporary, full);
   } finally {
     await unlink5(temporary).catch((error2) => {
       if (!missing(error2)) throw error2;
@@ -2113,7 +2050,7 @@ async function syncKnowledge(root, planPath) {
       if (current && hash2(current) !== hash2(content) && hash2(current) !== expected.get(path)) conflicts.push(path);
     }
     if (conflicts.length) {
-      const directory = `.buddy/knowledge/conflicts/${randomUUID4()}`;
+      const directory = `.buddy/knowledge/conflicts/${randomUUID5()}`;
       for (const [path, content] of files) await atomicWrite(root, `${directory}/${path}`, content);
       await atomicWrite(root, `${directory}/${MANIFEST}`, json(next));
       return { status: "conflict", conflicts, candidateDirectory: directory, written: [] };
@@ -2180,11 +2117,11 @@ ${KNOWLEDGE_HELP}`);
 }
 
 // packages/cli-core/src/index.ts
-import { join as join20, resolve as resolve18 } from "node:path";
+import { join as join21, resolve as resolve18 } from "node:path";
 
 // packages/cli-core/src/init/creator.ts
-import { createHash as createHash3, randomUUID as randomUUID5 } from "node:crypto";
-import { link as link2, lstat as lstat9, mkdir as mkdir8, readFile as readFile11, rename as rename7, unlink as unlink6, writeFile as writeFile8 } from "node:fs/promises";
+import { createHash as createHash3, randomUUID as randomUUID6 } from "node:crypto";
+import { link as link2, lstat as lstat9, mkdir as mkdir8, readFile as readFile12, rename as rename8, unlink as unlink6, writeFile as writeFile7 } from "node:fs/promises";
 import { dirname as dirname3, join as join12 } from "node:path";
 
 // packages/cli-core/src/init/creator-package.ts
@@ -2269,18 +2206,19 @@ ${KNOWLEDGE_GUIDE}
 | \u5FC5\u987B\u9075\u5FAA\u7684\u5904\u7406\u987A\u5E8F\u6216\u9644\u52A0\u5904\u7406 | \u5148\u770B Runtime \u9ED8\u8BA4\u56DE\u5408\u662F\u5426\u6EE1\u8DB3\uFF1B\u5FC5\u987B\u7531\u7A0B\u5E8F\u4FDD\u8BC1\u7684\u987A\u5E8F\u53EF\u7528 Tool\uFF0C\u6216\u5728 \`src/buddy-options.mjs\` \u4F7F\u7528 \`beforeToolCall\`\u3001\`afterToolCall\`\u3001\`shouldStopAfterTurn\` \u7B49\u56DE\u5408\u94A9\u5B50\u3002 |
 | \u4EE5\u540E\u8FD8\u9700\u8981\u8BB0\u4F4F\u7684\u4FE1\u606F | \u901A\u8FC7 \`conversation.memory\` \u843D\u5B9E\u4FDD\u5B58\u3001\u8BFB\u53D6\u3001\u66F4\u65B0\u548C\u9057\u5FD8\uFF0C\u5E76\u6309\u9700\u8981\u5C01\u88C5\u4E3A\u6A21\u578B Tool\u3002\u65B0 Runtime \u4E0D\u4F1A\u81EA\u52A8\u67E5\u8BE2\u6216\u63D0\u70BC\u8BB0\u5FC6\uFF1B\u662F\u5426\u4FDD\u5B58\u3001\u4FDD\u5B58\u4EC0\u4E48\u5FC5\u987B\u7531\u4E1A\u52A1\u4EE3\u7801\u548C\u5DF2\u786E\u8BA4\u7684\u6570\u636E\u8FB9\u754C\u51B3\u5B9A\u3002 |
 | \u56DE\u7B54\u65F6\u9700\u8981\u53C2\u8003\u7684\u5386\u53F2\u3001\u8BA1\u5212\u548C\u72B6\u6001 | Runtime \u4F1A\u4ECE MLB \u91CD\u5EFA\u4F1A\u8BDD\u5386\u53F2\uFF1B\u957F\u671F\u8BA1\u5212\u548C\u7ED3\u6784\u5316\u72B6\u6001\u4E0D\u80FD\u53EA\u4F9D\u8D56\u5B83\u4E00\u76F4\u7559\u5728\u6700\u8FD1\u804A\u5929\u91CC\u3002\u6309\u9700\u6C42\u4F7F\u7528 Memory\u3001\u6388\u6743\u6570\u636E\u6216\u4E1A\u52A1 Tool\uFF0C\u4E0D\u8981\u627F\u8BFA\u9ED8\u8BA4\u914D\u7F6E\u5DF2\u7ECF\u8986\u76D6\u3002 |
-| \u6A21\u578B\u548C\u5E73\u53F0\u8D44\u6E90 | \u5DF2\u786E\u5B9A\u7684\u6A21\u578B\u76F4\u63A5\u6CBF\u7528\uFF1B\u672A\u6307\u5B9A\u65F6\u67E5\u8BE2 \`buddy-cli models\`\uFF0C\u6838\u5BF9\u53EF\u7528\u6027\u5E76\u91C7\u7528\u6EE1\u8DB3\u9700\u6C42\u7684\u9009\u62E9\uFF0C\u4E0D\u9ED8\u8BA4\u518D\u95EE\u4E00\u8F6E\u9009\u578B\u95EE\u9898\uFF0C\u4E5F\u4E0D\u7F16\u9020\u4EF7\u683C\u6216\u80FD\u529B\u3002\u6A21\u677F\u628A\u914D\u7F6E\u4E2D\u7684\u6A21\u578B\u4EA4\u7ED9 \`initialState.model\`\uFF1B\u81EA\u5B9A\u4E49\u5DE5\u5382\u4E5F\u53EF\u6309\u4F1A\u8BDD\u9009\u62E9\u53D7\u652F\u6301\u6A21\u578B\uFF1B\u4F1A\u4EA7\u751F\u65B0\u7684\u8D39\u7528\u3001\u6570\u636E\u4F7F\u7528\u6216\u6743\u9650\u8FB9\u754C\u65F6\u5148\u786E\u8BA4\u3002 |
+| \u6A21\u578B\u548C\u5E73\u53F0\u8D44\u6E90 | \u5DF2\u786E\u5B9A\u7684\u6A21\u578B\u76F4\u63A5\u6CBF\u7528\uFF1B\u672A\u6307\u5B9A\u65F6\u67E5\u8BE2 \`buddy-cli models\`\uFF0C\u6838\u5BF9\u53EF\u7528\u6027\u5E76\u91C7\u7528\u6EE1\u8DB3\u9700\u6C42\u7684\u9009\u62E9\uFF0C\u4E0D\u9ED8\u8BA4\u518D\u95EE\u4E00\u8F6E\u9009\u578B\u95EE\u9898\uFF0C\u4E5F\u4E0D\u7F16\u9020\u4EF7\u683C\u6216\u80FD\u529B\u3002\u6A21\u578B\u76F4\u63A5\u5199\u5165\u4E1A\u52A1\u5DE5\u5382\u8FD4\u56DE\u7684 \`initialState.model\`\uFF1B\u81EA\u5B9A\u4E49\u5DE5\u5382\u4E5F\u53EF\u6309\u4F1A\u8BDD\u9009\u62E9\u53D7\u652F\u6301\u6A21\u578B\uFF1B\u4F1A\u4EA7\u751F\u65B0\u7684\u8D39\u7528\u3001\u6570\u636E\u4F7F\u7528\u6216\u6743\u9650\u8FB9\u754C\u65F6\u5148\u786E\u8BA4\u3002 |
 
-\`src/buddy-options.mjs\` \u662F\u6BCF\u573A\u4F1A\u8BDD\u7684\u4E1A\u52A1\u88C5\u914D\u5165\u53E3\uFF0C\u5BFC\u51FA \`createBuddyOptions(conversation)\`\uFF0C\u8FD4\u56DE \`initialState\`\u3001\u5728 \`initialState.tools\` \u6CE8\u518C\u7684\u4E1A\u52A1\u53CA\u5E73\u53F0\u5DE5\u5177\u548C\u53EF\u9009\u56DE\u5408\u94A9\u5B50\u3002\`start.mjs\` \u4ECE \`./src/buddy-options.mjs\` \u5BFC\u5165\u5DE5\u5382\u5E76\u4F20\u7ED9 \`BuddyServer.start({ dataRequirements: config.datasets ?? [], buddy: createBuddyOptions })\`\uFF1B\u7EC4\u88C5\u5668\u8BFB\u53D6 \`buddy.agent.json.model\`\uFF0C\u7701\u7565\u65F6\u7528 \`kimi-k2.6\`\uFF0C\u653E\u5165 \`initialState.model\`\uFF1B\u7528 \`new URL("../agent.md", import.meta.url)\` \u8BFB\u53D6\u6839\u76EE\u5F55 Prompt\u3002\u9ED8\u8BA4\u6A21\u677F\u53EA\u662F\u8D77\u70B9\uFF0C\u53EA\u6539\u8BF4\u660E\u4E0D\u7B49\u4E8E\u6539\u53D8\u4E86\u4FDD\u5B58\u3001\u67E5\u8BE2\u6216\u5904\u7406\u903B\u8F91\u3002 Runtime 0.16.0 \u4ECE\u73AF\u5883\u53D8\u91CF\u8BFB\u53D6\u8EAB\u4EFD\u548C\u4EE4\u724C\uFF1B\u9996\u6B21\u542F\u52A8 DEV \u65F6 CLI \u51C6\u5907\u5DE5\u7A0B \`.env\`\uFF0CNode \u7528 \`--env-file-if-exists=.env\` \u52A0\u8F7D\u3002\u4E0D\u8981\u5C06 token \u5199\u5165\u4E1A\u52A1\u4EE3\u7801\u3002
+\`src/buddy-options.mjs\` \u662F\u6BCF\u573A\u4F1A\u8BDD\u7684\u4E1A\u52A1\u88C5\u914D\u5165\u53E3\uFF0C\u5BFC\u51FA \`createBuddyOptions(conversation)\`\uFF0C\u8FD4\u56DE \`initialState\`\u3001\u5728 \`initialState.tools\` \u6CE8\u518C\u7684\u4E1A\u52A1\u53CA\u5E73\u53F0\u5DE5\u5177\u548C\u53EF\u9009\u56DE\u5408\u94A9\u5B50\u3002\`start.mjs\` \u4ECE \`./src/buddy-options.mjs\` \u5BFC\u5165\u5DE5\u5382\u5E76\u4F20\u7ED9 \`BuddyServer.start(createBuddyOptions)\`\uFF1B\u6A21\u578B\u76F4\u63A5\u5199\u5728\u5DE5\u5382\u8FD4\u56DE\u7684 \`initialState.model\`\uFF0C\u6A21\u677F\u4E3A \`kimi-k2.6\`\uFF1B\u7528 \`new URL("../agent.md", import.meta.url)\` \u8BFB\u53D6\u6839\u76EE\u5F55 Prompt\u3002\u9ED8\u8BA4\u6A21\u677F\u53EA\u662F\u8D77\u70B9\uFF0C\u53EA\u6539\u8BF4\u660E\u4E0D\u7B49\u4E8E\u6539\u53D8\u4E86\u4FDD\u5B58\u3001\u67E5\u8BE2\u6216\u5904\u7406\u903B\u8F91\u3002 Runtime 0.17.0 \u4ECE\u73AF\u5883\u53D8\u91CF\u8BFB\u53D6\u8EAB\u4EFD\u548C\u4EE4\u724C\uFF1B\u9996\u6B21\u542F\u52A8 DEV \u65F6 CLI \u51C6\u5907\u5DE5\u7A0B \`.env\`\uFF0CNode \u7528 \`--env-file-if-exists=.env\` \u52A0\u8F7D\u3002\u4E0D\u8981\u5C06 token \u5199\u5165\u4E1A\u52A1\u4EE3\u7801\u3002
 
 ### \u6309\u76EE\u5F55\u804C\u8D23\u7EC4\u7EC7\u5B9E\u73B0
 
 | \u4F4D\u7F6E | \u804C\u8D23\u4E0E\u751F\u6210\u65F6\u673A |
 | --- | --- |
-| \`buddy.agent.json\` | \u9ED8\u8BA4\u751F\u6210\uFF0C\u4FDD\u5B58\u5E73\u53F0\u8EAB\u4EFD\u3001\u53EF\u9009\u6A21\u578B\u548C\u6570\u636E\u9700\u6C42 datasets\uFF0C\u4E0D\u653E\u4E1A\u52A1\u51FD\u6570 |
+| \`package.json\` | \u9ED8\u8BA4\u751F\u6210\uFF0C\u4FDD\u5B58\u9876\u5C42 buddyId\u3001npm \u542F\u52A8\u547D\u4EE4\u548C\u4F9D\u8D56\uFF1B\u4E0D\u4FDD\u5B58 model\u3001datasets \u6216 schemaVersion |
 | \`agent.md\` | \u9ED8\u8BA4\u751F\u6210\uFF0C\u4FDD\u5B58\u7CFB\u7EDF Prompt |
 | \`start.mjs\` | \u9ED8\u8BA4\u751F\u6210\uFF0C\u8BFB\u53D6\u542F\u52A8\u914D\u7F6E\u3001\u542F\u52A8 Runtime \u5E76\u5904\u7406\u9000\u51FA |
-| \`package.json\`\u3001\`package-lock.json\` | \u9ED8\u8BA4\u751F\u6210\uFF0C\u58F0\u660E\u542F\u52A8\u547D\u4EE4\u3001\u51C6\u786E Runtime \u7248\u672C\u5E76\u9501\u5B9A\u4F9D\u8D56 |
+| \`package-lock.json\` | \u9ED8\u8BA4\u751F\u6210\uFF0C\u9501\u5B9A\u4F9D\u8D56 |
+| \`data-access.json\` | \u9ED8\u8BA4\u751F\u6210\uFF0Crequirements \u6570\u7EC4\u58F0\u660E\u6570\u636E\u96C6 ID \u548C\u7528\u9014\uFF1B\u65E0\u9700\u6C42\u4E3A\u7A7A\u6570\u7EC4 |
 | \`src/buddy-options.mjs\` | \u9ED8\u8BA4\u751F\u6210\uFF0C\u7EC4\u88C5\u5E76\u6CE8\u518C\u4F1A\u8BDD\u4E2D\u7684\u80FD\u529B |
 | \`src/tools/\` | \u9ED8\u8BA4\u7A7A\u76EE\u5F55\uFF1B\u653E\u6A21\u578B\u53EF\u8C03\u7528\u7684\u5DE5\u5177\u540D\u79F0\u3001\u8BF4\u660E\u3001\u53C2\u6570 Schema \u548C\u6267\u884C\u51FD\u6570 |
 | \`src/hooks/\` | \u9ED8\u8BA4\u7A7A\u76EE\u5F55\uFF1B\u653E\u5DE5\u5177\u8C03\u7528\u524D\u540E\u3001\u505C\u6B62\u7B49\u94A9\u5B50 |
@@ -2301,9 +2239,9 @@ Tool \u548C Hook \u662F Runtime \u7684\u6269\u5C55\u70B9\uFF1BService \u53EA\u66
 
 \u5E73\u53F0\u80FD\u529B\u8981\u4EE5\u5B9E\u9645\u63A5\u5165\u4E3A\u51C6\u3002\u5F53\u524D Runtime \u63D0\u4F9B\u4F1A\u8BDD\u6D88\u606F\u3001Memory\u3001\u6388\u6743\u6570\u636E\u3001\u5C0F\u6302\u4EF6\u548C\u672C\u5730 Markdown \u8D44\u6599\u80FD\u529B\uFF1B\u6CA1\u6709\u63A5\u901A\u7684 Files\u3001Knowledge \u4E0D\u80FD\u56E0\u624B\u518C\u63D0\u5230\u5C31\u5BA3\u79F0\u53EF\u7528\u3002\u666E\u901A Tool \u4E5F\u4E0D\u4EE3\u8868\u5DF2\u7ECF\u63D0\u4F9B\u5B9A\u65F6\u3001\u957F\u671F\u4EFB\u52A1\u3001\u540E\u53F0\u8C03\u5EA6\u6216\u4E3B\u52A8\u89E6\u8FBE\u3002\u624B\u518C\u63CF\u8FF0\u7684\u4ED8\u8D39\u3001\u53D1\u5E03\u7B49\u670D\u52A1\u8BBE\u8BA1\u4E5F\u4E0D\u6784\u6210\u6267\u884C\u6536\u8D39\u6216\u53D1\u5E03\u52A8\u4F5C\u7684\u6388\u6743\u3002
 
-\u9700\u8981\u7528\u6237\u6570\u636E\u65F6\uFF0C\u5148\u5728\u5DE5\u7A0B\u76EE\u5F55\u6267\u884C \`buddy-cli datasets\`\uFF08\u811A\u672C\u53EF\u7528 \`--json\`\uFF09\uFF0C\u4ECE npm \u6700\u65B0 Runtime \u5BFC\u51FA\u8BFB\u53D6\u5168\u90E8\u6570\u636E\u96C6\uFF1B\u4E0D\u8981\u6C42\u767B\u5F55\uFF0C\u4E0D\u4ECE Server \u62C9\u76EE\u5F55\u3002CLI \u6BCF\u6B21\u67E5\u8BE2 latest\uFF0C\u540C\u7248\u672C\u590D\u7528\u7F13\u5B58\uFF0C\u4E0D\u590D\u5236\u679A\u4E3E\u3002\u76EE\u5F55\u547D\u4EE4\u4F1A\u63D0\u793A\u5DE5\u7A0B\u7248\u672C\u5DEE\u5F02\uFF1B\u4F7F\u7528\u65B0\u7248\u80FD\u529B\u524D\uFF0C\u7531\u4F60\u6216\u5F00\u53D1 Agent \u6309\u63D0\u793A\u5347\u7EA7\u4F9D\u8D56\uFF0C\u68C0\u67E5\u542F\u52A8\u53C2\u6570\u3001\u6A21\u578B\u3001datasets\u3001\u5DE5\u5177\u53CA Hook \u7684\u9002\u914D\u5E76\u9A8C\u8BC1 DEV\u3002CLI \u4E0D\u81EA\u52A8\u4FEE\u6539\u5DE5\u7A0B\u4F9D\u8D56\u6216\u914D\u7F6E\u3002\u628A\u5B9E\u9645\u9700\u8981\u7684 \`id\` \u548C\u7528\u9014 \`purpose\` \u5199\u5165 \`buddy.agent.json.datasets\`\uFF0C\u540C\u4E00 ID \u53EA\u5199\u4E00\u6B21\uFF0C\u7528\u9014\u4E0D\u80FD\u4E3A\u7A7A\u4E14\u6700\u591A 200 \u5B57\uFF1B\u65E0\u9700\u6C42\u65F6\u4FDD\u7559\u7A7A\u6570\u7EC4\u3002DEV \u548C\u58F0\u660E\u975E\u7A7A\u65F6\u7684 push \u9884\u68C0\u7528\u8FD9\u4EFD\u5DE5\u7A0B\u4F9D\u8D56\u6821\u9A8C ID\uFF1B\u9700\u8981\u5148\u5B89\u88C5\u4E0E package.json \u51C6\u786E\u7248\u672C\u4E00\u81F4\u7684 Runtime\u3002\u6E05\u5355\u58F0\u660E\u6570\u91CF\u4E0D\u7B49\u4E8E\u5355\u6B21\u67E5\u8BE2\u4E0A\u9650\uFF0C\u5F53\u524D\u4E00\u6B21\u67E5\u8BE2\u6700\u591A 8 \u9879\u3002
+\u9700\u8981\u7528\u6237\u6570\u636E\u65F6\uFF0C\u5148\u5728\u5DE5\u7A0B\u76EE\u5F55\u6267\u884C \`buddy-cli datasets\`\uFF08\u811A\u672C\u53EF\u7528 \`--json\`\uFF09\uFF0C\u4ECE npm \u6700\u65B0 Runtime \u5BFC\u51FA\u8BFB\u53D6\u5168\u90E8\u6570\u636E\u96C6\uFF1B\u4E0D\u8981\u6C42\u767B\u5F55\uFF0C\u4E0D\u4ECE Server \u62C9\u76EE\u5F55\u3002CLI \u6BCF\u6B21\u67E5\u8BE2 latest\uFF0C\u540C\u7248\u672C\u590D\u7528\u7F13\u5B58\uFF0C\u4E0D\u590D\u5236\u679A\u4E3E\u3002\u76EE\u5F55\u547D\u4EE4\u4F1A\u63D0\u793A\u5DE5\u7A0B\u7248\u672C\u5DEE\u5F02\uFF1B\u4F7F\u7528\u65B0\u7248\u80FD\u529B\u524D\uFF0C\u7531\u4F60\u6216\u5F00\u53D1 Agent \u6309\u63D0\u793A\u5347\u7EA7\u4F9D\u8D56\uFF0C\u68C0\u67E5\u542F\u52A8\u53C2\u6570\u3001\u6A21\u578B\u3001datasets\u3001\u5DE5\u5177\u53CA Hook \u7684\u9002\u914D\u5E76\u9A8C\u8BC1 DEV\u3002CLI \u4E0D\u81EA\u52A8\u4FEE\u6539\u5DE5\u7A0B\u4F9D\u8D56\u6216\u914D\u7F6E\u3002\u628A\u5B9E\u9645\u9700\u8981\u7684 \`id\` \u548C\u7528\u9014 \`purpose\` \u5199\u5165 \`data-access.json.requirements\`\uFF0C\u6700\u591A 32 \u9879\uFF0C\u540C\u4E00 ID \u53EA\u5199\u4E00\u6B21\uFF0CID \u548C\u7528\u9014\u53BB\u9664\u9996\u5C3E\u7A7A\u767D\uFF0C\u7528\u9014\u4E3A 1\uFF5E200 \u5B57\uFF1B\u65E0\u9700\u6C42\u65F6\u4FDD\u7559\u7A7A\u6570\u7EC4\u3002DEV \u548C\u58F0\u660E\u975E\u7A7A\u65F6\u7684 push \u9884\u68C0\u7528\u8FD9\u4EFD\u5DE5\u7A0B\u4F9D\u8D56\u6821\u9A8C ID\uFF1B\u9700\u8981\u5148\u5B89\u88C5\u4E0E package.json \u51C6\u786E\u7248\u672C\u4E00\u81F4\u7684 Runtime\u3002\u6E05\u5355\u58F0\u660E\u6570\u91CF\u4E0D\u7B49\u4E8E\u5355\u6B21\u67E5\u8BE2\u4E0A\u9650\uFF0C\u5F53\u524D\u4E00\u6B21\u67E5\u8BE2\u6700\u591A 8 \u9879\u3002
 
-\`start.mjs\` \u5C06\u58F0\u660E\u4EA4\u7ED9 \`StartOptions.dataRequirements\`\u3002Runtime \u5728\u5B9E\u9645\u6570\u636E\u67E5\u8BE2\u3001HealthKit \u6388\u6743\u548C\u4E3B\u52A8\u670D\u52A1\u8BF7\u6C42\u4E2D\u643A\u5E26\u5B8C\u6574\u58F0\u660E\uFF0C\u7531 Server \u6821\u9A8C\u8303\u56F4\u4E0E\u7528\u6237\u540C\u610F\uFF1B\u586B\u5199\u914D\u7F6E\u4E0D\u8868\u793A\u5DF2\u7ECF\u6388\u6743\u3002\u670D\u52A1\u7AEF\u4ECE\u4E0A\u4F20\u5305\u89E3\u6790\u5E76\u7ED1\u5B9A\u53D1\u5E03\u7248\u672C\u4ECD\u5F85\u5B9E\u73B0\u3002
+Runtime \u542F\u52A8\u65F6\u8BFB\u53D6\u6839\u76EE\u5F55 \`data-access.json\`\uFF0C\u901A\u8FC7 \`PUT /internal/v1/data-access/requirements\` \u767B\u8BB0\uFF0C\u6210\u529F\u540E\u518D\u8FDE\u63A5\u4E8B\u4EF6\u6D41\uFF1B\u767B\u8BB0\u5931\u8D25\u963B\u6B62\u542F\u52A8\u3002\u6587\u4EF6\u7F3A\u5931\u6216\u7A7A\u6570\u7EC4\u90FD\u4F1A\u4E0A\u4F20\u7A7A\u58F0\u660E\u5E76\u6E05\u9664\u65E7\u58F0\u660E\u3002DEV \u4FDD\u5B58\u8BE5\u6587\u4EF6\u540E\u81EA\u52A8\u91CD\u542F\u5E76\u91CD\u65B0\u767B\u8BB0\u3002\u58F0\u660E\u4E0D\u8868\u793A\u7528\u6237\u5DF2\u6388\u6743\uFF1B\u4F4D\u7F6E\u548C\u65E5\u5386\u4E0D\u653E\u5165\u6B64\u6587\u4EF6\u3002
 
 \u6A21\u578B\u9700\u8981\u67E5\u6570\u636E\u65F6\uFF0C\u5728 \`src/buddy-options.mjs\` \u7684 \`initialState.tools\` \u4E2D\u52A0\u5165 \`conversation.tools.data_access_query\`\uFF1B\u9700\u8981\u5411\u7528\u6237\u7533\u8BF7\u65F6\u52A0\u5165 \`conversation.tools.data_access_request\`\uFF0C\u4F4D\u7F6E\u3001\u65E5\u5386\u7684\u4E00\u6B21\u6027\u7ED3\u679C\u901A\u8FC7 \`data_access_read_result\` \u8BFB\u53D6\uFF0CHealthKit \u5219\u91CD\u65B0\u67E5\u8BE2 Dataset\u3002\u4E1A\u52A1\u4EE3\u7801\u5BF9\u5E94\u4F7F\u7528 \`conversation.dataAccess.query/request/readResult\`\u3002\u65B0\u5EFA\u5DE5\u7A0B\u52A8\u6001\u9009\u62E9\u516C\u5171 npm latest \u5E76\u9501\u5B9A\u51C6\u786E\u7248\u672C\uFF1B\u67E5\u8BE2\u6216\u9501\u6587\u4EF6\u751F\u6210\u5931\u8D25\u65F6\u505C\u6B62\uFF0C\u4E0D\u56DE\u9000\u5185\u7F6E\u65E7\u7248\u672C\u3002\u5DF2\u6709\u5DE5\u7A0B\u901A\u8FC7\u5305\u7BA1\u7406\u5668\u663E\u5F0F\u5347\u7EA7\u4F9D\u8D56\u3002CLI \u7684 DEV \u542F\u52A8\u3001\u81EA\u52A8\u91CD\u8F7D\u548C push \u5FC5\u987B\u4F7F\u7528\u672C\u6B21 npm \u6700\u65B0\u7A33\u5B9A\u7248\uFF0C\u58F0\u660E\u3001\u5B89\u88C5\u548C npm \u9501\u6587\u4EF6\u7248\u672C\u5FC5\u987B\u4E00\u81F4\uFF0C\u67E5\u8BE2\u5931\u8D25\u4F1A\u963B\u6B62\u64CD\u4F5C\u3002
 
@@ -2360,7 +2298,7 @@ function legacyHandoffMarkdown(context, skillRoot, session, workspacePath) {
 ## \u5DF2\u5B8C\u6210\u7684\u8EAB\u4EFD\u767B\u8BB0
 
 \u9879\u76EE\u6E05\u5355\uFF1A${JSON.stringify(context.manifestPath)}\u3002\u5176\u4E2D\u7684 buddyId \u7ED1\u5B9A\u5DF2\u7ECF\u767B\u8BB0\u7684\u4E91\u7AEF\u642D\u5B50\uFF1B\u540D\u79F0\u3001tagline \u548C intro \u4EE5\u5E73\u53F0 Meta \u4E3A\u51C6\uFF0C\u4E0D\u4FDD\u5B58\u5728\u672C\u5730\u6E05\u5355\u3002
-\u5E73\u53F0 buddyId\uFF1A${JSON.stringify(context.buddyId)}\u3002Skill \u81EA\u5DF1\u7684 buddyId \u53EA\u6807\u8BC6\u672C\u5730\u4F5C\u54C1\uFF0C\u4E0D\u80FD\u66FF\u6362 buddy.agent.json.buddyId\uFF0C\u4E5F\u4E0D\u8981\u91CD\u65B0\u521B\u5EFA\u4E91\u7AEF\u642D\u5B50\u3002
+\u5E73\u53F0 buddyId\uFF1A${JSON.stringify(context.buddyId)}\u3002Skill \u81EA\u5DF1\u7684 buddyId \u53EA\u6807\u8BC6\u672C\u5730\u4F5C\u54C1\uFF0C\u4E0D\u80FD\u66FF\u6362 package.json.buddyId\uFF0C\u4E5F\u4E0D\u8981\u91CD\u65B0\u521B\u5EFA\u4E91\u7AEF\u642D\u5B50\u3002
 
 \u672C\u6B21\u5F00\u59CB\u521B\u4F5C\u65F6\u7684\u5E73\u53F0\u8D44\u6599\u5982\u4E0B\uFF1B\u5B83\u4EEC\u53EA\u662F\u91C7\u8BBF\u8D77\u70B9\uFF0C\u540E\u7EED\u4FEE\u6539\u4ECD\u4EE5\u5E73\u53F0 Meta \u4E3A\u51C6\uFF1A
 
@@ -2405,7 +2343,7 @@ ${IMPLEMENTATION_GUIDE}
 ${JSON.stringify(directArgs, null, 2)}
 \`\`\`
 
-\u8BE5\u547D\u4EE4\u590D\u7528 buddy.agent.json \u4E2D\u7684 buddyId\uFF0C\u5E76\u4ECE\u5E73\u53F0\u8BFB\u53D6\u6700\u65B0 Meta\u3001\u91CD\u65B0\u9A8C\u8BC1\u5F52\u5C5E\uFF0C\u4E0D\u4F1A\u53E6\u5EFA\u642D\u5B50\u3002\u5DE5\u7A0B\u7EDF\u4E00\u4F7F\u7528\u5B98\u65B9 Runtime\uFF1B\u5168\u90E8\u8BBE\u8BA1\u9A8C\u6536\u53CA\u4EA4\u4ED8\u6821\u9A8C\u5B8C\u6210\u524D\u4E0D\u751F\u6210\u4E1A\u52A1\u4EE3\u7801\uFF0C\u4E5F\u4E0D\u8981\u628A\u9700\u6C42\u624B\u518C\u8BF4\u6210\u5DF2\u5B9E\u73B0\u4EE3\u7801\u3002
+\u8BE5\u547D\u4EE4\u590D\u7528 package.json \u4E2D\u7684 buddyId\uFF0C\u5E76\u4ECE\u5E73\u53F0\u8BFB\u53D6\u6700\u65B0 Meta\u3001\u91CD\u65B0\u9A8C\u8BC1\u5F52\u5C5E\uFF0C\u4E0D\u4F1A\u53E6\u5EFA\u642D\u5B50\u3002\u5DE5\u7A0B\u7EDF\u4E00\u4F7F\u7528\u5B98\u65B9 Runtime\uFF1B\u5168\u90E8\u8BBE\u8BA1\u9A8C\u6536\u53CA\u4EA4\u4ED8\u6821\u9A8C\u5B8C\u6210\u524D\u4E0D\u751F\u6210\u4E1A\u52A1\u4EE3\u7801\uFF0C\u4E5F\u4E0D\u8981\u628A\u9700\u6C42\u624B\u518C\u8BF4\u6210\u5DF2\u5B9E\u73B0\u4EE3\u7801\u3002
 \u5DF2\u6709\u5B8C\u6574 Agent \u5DE5\u7A0B\u65F6\u4E0D\u91CD\u590D init\uFF0C\u76F4\u63A5\u6309\u624B\u518C\u7EE7\u7EED\u5B9E\u73B0\u3002\u6821\u9A8C\u9879\u76EE\u8EAB\u4EFD\u4E0E Booklet \u6765\u6E90\uFF0C\u4E0D\u7528\u5176\u4ED6\u642D\u5B50\u7684\u624B\u518C\u6216\u76EE\u5F55\u3002
 ${DEVELOPMENT_HANDOFF}
 `;
@@ -2413,7 +2351,6 @@ ${DEVELOPMENT_HANDOFF}
 
 // packages/cli-core/src/init/creator.ts
 var MAX_LOCAL_FILE_BYTES = 1024 * 1024;
-var IMPLEMENTATION_GUIDANCE2 = "\u8BFB\u53D6 completion.manualPath \u6307\u5411\u7684\u771F\u5B9E\u624B\u518C\u548C\u73B0\u6709\u5DE5\u7A0B\uFF0C\u5B8C\u6574\u7406\u89E3\u9700\u6C42\u540E\u6309\u4E0B\u65B9\u6307\u5F15\u843D\u5B9E\u5230\u4EE3\u7801\u3002\u5DF2\u786E\u8BA4\u6216\u80FD\u591F\u636E\u6B64\u786E\u5B9A\u7684\u76F4\u63A5\u5B9E\u73B0\uFF0C\u4E0D\u518D\u56FA\u5B9A\u786E\u8BA4\u4E00\u904D\uFF1B\u53EA\u6709\u5F71\u54CD\u4F53\u9A8C\u3001\u6570\u636E\u4F7F\u7528\u6216\u6388\u6743\u7684\u5173\u952E\u7F3A\u53E3\u624D\u8865\u95EE\u3002\u7EDF\u4E00\u4F7F\u7528\u5B98\u65B9 Runtime\uFF0C\u6309\u9700\u6C42\u914D\u7F6E Prompt\u3001\u4E1A\u52A1 Tool \u548C\u56DE\u5408\u94A9\u5B50\u3002";
 var CreatorPreparationError = class extends Error {
 };
 async function state(path) {
@@ -2436,11 +2373,11 @@ async function safeRead(path) {
   if (!entry2.isFile() || entry2.size > MAX_LOCAL_FILE_BYTES) {
     throw new CreatorPreparationError(`\u521B\u4F5C\u6587\u4EF6\u4E0D\u662F\u666E\u901A\u6587\u4EF6\u6216\u8D85\u51FA\u5927\u5C0F\u9650\u5236\uFF1A${path}`);
   }
-  return readFile11(path);
+  return readFile12(path);
 }
 async function writeOnce(path, bytes) {
-  const temporary = `${path}.${randomUUID5()}.tmp`;
-  await writeFile8(temporary, bytes, { flag: "wx", mode: 384 });
+  const temporary = `${path}.${randomUUID6()}.tmp`;
+  await writeFile7(temporary, bytes, { flag: "wx", mode: 384 });
   try {
     await link2(temporary, path).catch((cause) => {
       if (cause.code !== "EEXIST") throw cause;
@@ -2450,10 +2387,10 @@ async function writeOnce(path, bytes) {
   }
 }
 async function replaceFile(path, content) {
-  const temporary = `${path}.${randomUUID5()}.tmp`;
+  const temporary = `${path}.${randomUUID6()}.tmp`;
   try {
-    await writeFile8(temporary, content, { flag: "wx", mode: 384 });
-    await rename7(temporary, path);
+    await writeFile7(temporary, content, { flag: "wx", mode: 384 });
+    await rename8(temporary, path);
   } finally {
     await unlink6(temporary).catch((error2) => {
       if (error2.code !== "ENOENT") throw error2;
@@ -2476,7 +2413,10 @@ function handoffMarkdown(context, skillRoot, session, workspacePath) {
   ];
   return `# Buddy \u521B\u5EFA\u63A5\u7EED\u8BF4\u660E
 
-<!-- buddy-cli creator-handoff:2 -->
+<!-- buddy-cli creator-handoff:3 -->
+
+\u5148\u6267\u884C \`buddy-cli guide\` \u5E76\u5B8C\u6574\u9605\u8BFB\u5F53\u524D\u5F00\u53D1\u6307\u5F15\uFF1BCLI \u4F1A\u5148\u81EA\u68C0\u5E76\u5728\u9700\u8981\u65F6\u81EA\u52A8\u66F4\u65B0\uFF0C\u7B49\u5F85\u547D\u4EE4\u5B8C\u6210\uFF0C\u4E0D\u91CD\u590D\u53D1\u8D77\u3002
+\u672C\u6587\u4EF6\u53EA\u63D0\u4F9B\u672C\u6B21\u5DE5\u7A0B\u4E0E Skill \u7684\u63A5\u7EED\u4FE1\u606F\uFF1B\u901A\u7528\u5F00\u53D1\u548C\u4EA4\u4ED8\u89C4\u5219\u4EE5 guide \u4E3A\u51C6\u3002
 
 \u9879\u76EE\u6E05\u5355\uFF1A${JSON.stringify(context.manifestPath)}\u3002
 \u5E73\u53F0 buddyId\uFF1A${JSON.stringify(context.buddyId)}\u3002\u6B64\u8EAB\u4EFD\u5DF2\u767B\u8BB0\uFF0C\u4E0D\u53E6\u5EFA\u4E91\u7AEF\u642D\u5B50\uFF1BSkill \u7684\u4F5C\u54C1 ID \u4E0D\u66FF\u6362\u5E73\u53F0\u8EAB\u4EFD\u3002
@@ -2497,8 +2437,7 @@ ${JSON.stringify(openArgs, null, 2)}
 
 \u4EC5 directive=creator_complete \u4E14 completion.status=ready\u3001manualPath \u5B58\u5728\u4E14\u4EA4\u4ED8\u6709\u6548\u65F6\u8FDB\u5165\u5F00\u53D1\u3002directive=finalize_required \u65F6\u5148\u4FEE\u590D\u4EA4\u4ED8\u3002\u5DF2\u5B8C\u6210\u4F5C\u54C1\u76F4\u63A5\u63A5\u56DE\u5F00\u53D1\uFF1B\u7528\u6237\u660E\u786E\u4EC5\u505A\u8BBE\u8BA1\u6216\u6682\u505C\u65F6\u9075\u5B88\u8BE5\u8303\u56F4\u3002
 
-${IMPLEMENTATION_GUIDANCE2}
-${IMPLEMENTATION_GUIDE}
+\u91CD\u65B0\u6267\u884C \`buddy-cli guide\` \u83B7\u53D6\u5F53\u524D\u89C4\u5219\uFF0C\u8BFB\u53D6 completion.manualPath \u6307\u5411\u7684\u771F\u5B9E\u624B\u518C\u4E0E\u73B0\u6709\u5DE5\u7A0B\uFF0C\u518D\u6309\u5F00\u53D1\u6307\u5F15\u7EE7\u7EED\u5B9E\u73B0\u3002
 
 \u4F7F\u7528\u5B98\u65B9 Runtime \u521D\u59CB\u5316\u5DE5\u7A0B\uFF0C\u8C03\u7528 buddy-cli\uFF0Cargv \u4E3A\uFF1A
 
@@ -2506,8 +2445,7 @@ ${IMPLEMENTATION_GUIDE}
 ${JSON.stringify(["init", "--mode", "direct", "--directory", context.projectRoot], null, 2)}
 \`\`\`
 
-\u5DF2\u6709\u5B8C\u6574\u5DE5\u7A0B\u4E0D\u91CD\u590D\u521D\u59CB\u5316\u3002\u590D\u7528\u5F53\u524D\u8EAB\u4EFD\uFF0C\u8BFB\u53D6\u771F\u5B9E\u4EA4\u4ED8\u3001\u6765\u6E90\u4E0E\u73B0\u6709\u4EE3\u7801\uFF0C\u5B8C\u6210\u540E\u6309\u4E0B\u65B9\u6D41\u7A0B\u9A8C\u8BC1\u3002
-${DEVELOPMENT_HANDOFF}
+\u5DF2\u6709\u5B8C\u6574\u5DE5\u7A0B\u4E0D\u91CD\u590D\u521D\u59CB\u5316\u3002\u590D\u7528\u5F53\u524D\u8EAB\u4EFD\uFF0C\u8BFB\u53D6\u771F\u5B9E\u4EA4\u4ED8\u3001\u6765\u6E90\u4E0E\u73B0\u6709\u4EE3\u7801\uFF0C\u6309 guide \u5B8C\u6210\u9A8C\u8BC1\u548C\u5F00\u53D1\u8005\u9884\u89C8\u4EA4\u63A5\u3002
 `;
 }
 async function prepareCreatorSkill(context, io, options = {}) {
@@ -2519,7 +2457,7 @@ async function prepareCreatorSkill(context, io, options = {}) {
     await writeOnce(sessionPath, JSON.stringify({
       schemaVersion: 1,
       platformBuddyId: context.buddyId,
-      creationKey: randomUUID5()
+      creationKey: randomUUID6()
     }, null, 2) + "\n");
     const session = JSON.parse((await safeRead(sessionPath)).toString("utf8"));
     if (session.schemaVersion !== 1 || session.platformBuddyId !== context.buddyId || !/^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/u.test(session.creationKey)) {
@@ -2589,7 +2527,7 @@ async function prepareCreatorSkill(context, io, options = {}) {
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : "Creator \u4E0B\u8F7D\u6216\u672C\u5730\u5199\u5165\u5931\u8D25\uFF0C\u8BF7\u68C0\u67E5\u7F51\u7EDC\u548C\u76EE\u5F55\u6743\u9650\u3002";
     io.writeError(`Creator Skill \u51C6\u5907\u5931\u8D25\uFF1A${message}`);
-    io.writeError(`buddy.agent.json \u548C\u5DF2\u6709\u521B\u4F5C\u8D44\u6599\u5DF2\u4FDD\u7559\u3002\u91CD\u8BD5 buddy-cli init --mode create --directory ${JSON.stringify(context.projectRoot)}\uFF0C\u4E0D\u4F1A\u53E6\u5EFA\u4E91\u7AEF\u642D\u5B50\u3002`);
+    io.writeError(`package.json \u548C\u5DF2\u6709\u521B\u4F5C\u8D44\u6599\u5DF2\u4FDD\u7559\u3002\u91CD\u8BD5 buddy-cli init --mode create --directory ${JSON.stringify(context.projectRoot)}\uFF0C\u4E0D\u4F1A\u53E6\u5EFA\u4E91\u7AEF\u642D\u5B50\u3002`);
     return { exitCode: 1 };
   }
 }
@@ -2667,6 +2605,7 @@ var CLI_HELP = `\u642D\u642D Developer Platform CLI
   --version  \u67E5\u770B\u5F53\u524D CLI \u7248\u672C
 
 \u76F4\u63A5\u8FD0\u884C buddy-cli \u53EF\u8BC6\u522B\u5F53\u524D\u5DE5\u7A0B\u6216\u5F15\u5BFC\u521B\u5EFA\u3002
+\u6B63\u5E38\u547D\u4EE4\u5148\u8054\u7F51\u81EA\u68C0\uFF0C\u65E7\u7248\u81EA\u52A8\u66F4\u65B0\u540E\u7EE7\u7EED\u6267\u884C\uFF1B\u5931\u8D25\u65F6\u505C\u6B62\u3002\u5E2E\u52A9\u548C --version \u79BB\u7EBF\u53EF\u7528\u3002
 \u53C2\u6570\u4E0E\u793A\u4F8B: buddy-cli <\u547D\u4EE4> --help\uFF0C\u4F8B\u5982 buddy-cli init --help\u3002
 Coding Agent \u5F00\u59CB\u5DE5\u4F5C\u524D\u8BF7\u8BFB\u53D6 buddy-cli guide\u3002`;
 var INIT_HELP = `\u7528\u6CD5: buddy-cli init [\u53C2\u6570]
@@ -2694,12 +2633,20 @@ var INIT_HELP = `\u7528\u6CD5: buddy-cli init [\u53C2\u6570]
 Coding Agent \u7684\u786E\u8BA4\u4E0E\u63A5\u7EED\u89C4\u5219\u89C1 buddy-cli guide\u3002`;
 var GUIDE_HELP = `\u7528\u6CD5: buddy-cli guide
 \u8F93\u51FA Coding Agent \u7684\u5B8C\u6574\u5F00\u53D1\u6307\u5F15\uFF0C\u5305\u62EC\u8D44\u6599\u786E\u8BA4\u3001Skill \u63A5\u7EED\u3001\u5B9E\u73B0\u4E0E\u4EA4\u4ED8\u89C4\u5219\u3002
-\u65E0\u9700\u5DE5\u7A0B\u3001\u767B\u5F55\u6216\u8054\u7F51\uFF1B\u53EA\u8F93\u51FA\u6587\u5B57\uFF0C\u4E0D\u751F\u6210\u6587\u4EF6\u6216\u6267\u884C\u5F00\u53D1\u3002`;
+\u65E0\u9700\u5DE5\u7A0B\u6216\u767B\u5F55\uFF1B\u5148\u8054\u7F51\u68C0\u67E5 CLI \u5E76\u6309\u9700\u81EA\u52A8\u66F4\u65B0\uFF0C\u518D\u8F93\u51FA\u65B0\u7248\u6307\u5357\uFF0C\u4E0D\u4FEE\u6539\u5DE5\u7A0B\u6216\u6267\u884C\u5F00\u53D1\u3002`;
 var AGENT_GUIDE = `# Coding Agent \u5F00\u53D1\u6307\u5F15
 
 \u901A\u7528\u89C4\u5219\u5728\u6B64\u8BFB\u53D6\uFF1B\u53C2\u6570\u89C1 buddy-cli <\u547D\u4EE4> --help\uFF0C\u5DE5\u7A0B\u72B6\u6001\u4E0E\u5177\u4F53\u63A5\u7EED\u6B65\u9AA4\u4EE5 CLI \u8FD4\u56DE\u7684 HANDOFF.md \u4E3A\u51C6\u3002
 Skill \u7684\u5177\u4F53\u6D41\u7A0B\u8BFB\u53D6 HANDOFF.md \u4E2D\u7684\u6587\u4EF6\u8DEF\u5F84\uFF1B\u65E0\u9700\u5728 CLI \u5E2E\u52A9\u4E2D\u7EF4\u62A4\u4E00\u4EFD\u526F\u672C\u3002
 
+## CLI \u7248\u672C\u4E0E\u6267\u884C\u89C4\u5219
+
+\u4F7F\u7528\u5B98\u65B9 buddy-cli \u5165\u53E3\u3002\u6BCF\u6761\u6B63\u5E38\u547D\u4EE4\uFF08\u5305\u62EC guide\uFF09\u6267\u884C\u524D\u90FD\u4F1A\u67E5\u8BE2\u516C\u5171 npm latest\uFF1B\u7248\u672C\u8FC7\u65E7\u65F6\u81EA\u52A8\u66F4\u65B0\uFF0C\u518D\u7531\u65B0\u7248\u6267\u884C\u540C\u4E00\u547D\u4EE4\u3002\u7B49\u5F85\u5F53\u524D\u547D\u4EE4\u5B8C\u6210\uFF0C\u4E0D\u91CD\u590D\u53D1\u8D77\uFF0C\u4E0D\u53E6\u5F00\u8FDB\u7A0B\u540C\u65F6\u91CD\u8DD1\u3002
+\u5168\u5C40\u5B89\u88C5\u66F4\u65B0\u5BF9\u5E94 npm \u73AF\u5883\u7684\u5B89\u88C5\uFF1B\u6E90\u7801\u3001npm link\u3001\u9879\u76EE\u5185\u5B89\u88C5\u548C npx \u901A\u8FC7\u7F13\u5B58\u7684\u65B0\u7248\u7EE7\u7EED\u6267\u884C\uFF0C\u4E0D\u6539\u5199\u6E90\u7801\u6216\u9879\u76EE\u4F9D\u8D56\u3002\u53C2\u6570\u3001\u5DE5\u4F5C\u76EE\u5F55\u3001\u7EC8\u7AEF\u8F93\u5165\u8F93\u51FA\u548C\u9000\u51FA\u72B6\u6001\u4FDD\u7559\u3002\u4E00\u6B21\u8C03\u7528\u6700\u591A\u81EA\u52A8\u5207\u6362\u4E00\u6B21\uFF1B\u5F53\u524D\u7248\u672C\u9AD8\u4E8E latest \u65F6\u4E0D\u964D\u7EA7\uFF0C\u5DF2\u8FD0\u884C\u7684 DEV \u4E0D\u4F1A\u56E0\u53D1\u5E03\u65B0 CLI \u81EA\u52A8\u91CD\u542F\u3002
+\u5E2E\u52A9\u3001\u5404\u547D\u4EE4 --help \u548C --version \u79BB\u7EBF\u53EF\u7528\uFF1Bupdate \u662F\u5355\u72EC\u68C0\u67E5\u6216\u66F4\u65B0\u5165\u53E3\u3002\u67E5\u8BE2\u6216\u66F4\u65B0\u5931\u8D25\u65F6\u539F\u4E1A\u52A1\u64CD\u4F5C\u4E0D\u4F1A\u5F00\u59CB\uFF0C\u6839\u636E\u9519\u8BEF\u5904\u7406\u540E\u91CD\u8BD5\uFF0C\u4E0D\u8C03\u7528\u65E7\u7248\u6E90\u7801\u7ED5\u8FC7\u68C0\u67E5\u3002\u65E7 CLI \u9700\u5148\u901A\u8FC7\u5B98\u65B9 npm \u5B89\u88C5\u547D\u4EE4\u5347\u7EA7\u4E00\u6B21\uFF0C\u624D\u80FD\u83B7\u5F97\u6B64\u673A\u5236\u3002
+CLI \u81EA\u52A8\u66F4\u65B0\u4E0D\u7B49\u4E8E\u5DE5\u7A0B Runtime \u5DF2\u9002\u914D\u3002\u4ECD\u987B\u6839\u636E Runtime \u68C0\u67E5\u7ED3\u679C\u66F4\u65B0\u5DE5\u7A0B\u4F9D\u8D56\u3001\u9501\u6587\u4EF6\u548C\u5FC5\u8981\u7684\u4E1A\u52A1\u4EE3\u7801\uFF0C\u5B8C\u6210\u9A8C\u8BC1\u540E\u518D\u542F\u52A8\u6216\u4E0A\u4F20\uFF1B\u4E0D\u8981\u53EA\u4FEE\u6539\u7248\u672C\u53F7\u5C31\u5BA3\u79F0\u9002\u914D\u5B8C\u6210\u3002
+\u901A\u7528\u89C4\u5219\u4EE5\u672C\u547D\u4EE4\u7684\u5F53\u524D\u8F93\u51FA\u4E3A\u51C6\u3002HANDOFF.md \u53EA\u63D0\u4F9B\u5F53\u524D\u5DE5\u7A0B\u3001Skill \u8DEF\u5F84\u53CA\u5177\u4F53\u63A5\u7EED\u65B9\u5F0F\uFF0C\u4E0D\u5305\u542B\u6574\u4EFD\u5F00\u53D1\u6307\u5357\u3002
+
 ## \u8D44\u6599\u786E\u8BA4\u4E0E\u521D\u59CB\u5316
 
 init \u5148\u6536\u96C6\u540D\u79F0\u3001\u4E00\u53E5\u8BDD\u4ECB\u7ECD\u548C\u5B8C\u6574\u4ECB\u7ECD\uFF0C\u51C6\u5907\u5934\u50CF\uFF1B\u5F00\u53D1\u8005\u786E\u8BA4\u8D44\u6599\u548C\u5934\u50CF\u540E\uFF0C\u518D\u767B\u8BB0\u4E91\u7AEF Meta\u3002\u672A\u786E\u8BA4\u65F6\u4EC5\u4FDD\u5B58 .buddy/meta/ \u672C\u5730\u8349\u7A3F\u3002
@@ -2714,7 +2661,7 @@ Coding Agent \u5E94\u76F4\u63A5\u6CBF\u7528\u7528\u6237\u660E\u786E\u63D0\u4F9B\
 \u975E\u4EA4\u4E92\u8C03\u7528\u987B\u5728\u5F00\u53D1\u8005\u660E\u786E\u786E\u8BA4\u5B9E\u9645\u5934\u50CF\u548C\u8D44\u6599\u540E\u4F20 --avatar <\u5DF2\u786E\u8BA4\u56FE\u7247> --confirm-meta\u3002\u672A\u786E\u8BA4\u4E0D\u5F97\u4F20\u8BE5\u6807\u5FD7\uFF1B\u7F3A\u5C11\u56FE\u7247\u6216\u786E\u8BA4\u65F6\u9000\u51FA\u7801\u4E3A 2\uFF0C\u8349\u7A3F\u4FDD\u7559\uFF0C\u53EF\u4EE5\u5728\u539F\u76EE\u5F55\u7EE7\u7EED\u3002
 --mode create \u5B8C\u6210\u8D44\u6599\u548C\u5934\u50CF\u767B\u8BB0\u540E\uFF0C\u52A8\u6001\u83B7\u53D6\u72EC\u7ACB Creator Skill \u5E76\u751F\u6210\u63A5\u7EED\u8BF4\u660E\uFF0C\u9879\u76EE .buddy/creator/ \u4FDD\u5B58\u521B\u4F5C\u8D44\u6599\u4E0E skill-lock.json \u7248\u672C\u8BB0\u5F55\u3002\u4F7F\u7528 --creator-version <\u51C6\u786E\u7248\u672C> \u663E\u5F0F\u5347\u7EA7\uFF0C\u5DF2\u6709\u9879\u76EE\u9ED8\u8BA4\u590D\u7528\u56FA\u5B9A\u7248\u672C\uFF1B\u672C\u5730\u8054\u8C03\u53EF\u8BBE\u7F6E BUDDY_CREATOR_SKILL_PATH \u7EDD\u5BF9\u8DEF\u5F84\u3002
 \u7531\u5F53\u524D Coding Agent \u8BFB\u53D6 .buddy/creator/HANDOFF.md \u5E76\u6267\u884C\u5176\u4E2D\u6307\u5411\u7684 Skill\uFF1B\u9700\u8981 Python 3.9+\uFF0C\u4E0D\u542F\u52A8\u65E7\u91C7\u8BBF Web \u6216\u72EC\u7ACB\u6A21\u578B\u3002
-\u56DB\u518C\u786E\u8BA4\u540E\u7EE7\u7EED\u5C0F\u6302\u4EF6\u6E05\u5355\u3001\u539F\u578B\u548C\u8BBE\u8BA1\u9A8C\u6536\uFF1B\u5168\u90E8\u786E\u8BA4\u5E76\u901A\u8FC7\u4EA4\u4ED8\u6821\u9A8C\u540E\uFF0C\u7531 Coding Agent \u81EA\u52A8\u8854\u63A5\u5F00\u53D1\uFF0C\u9700\u8981\u521D\u59CB\u5316\u65F6\u6267\u884C init --mode direct \u751F\u6210\u5B98\u65B9 Runtime \u5DE5\u7A0B\u3002\u540C\u76EE\u5F55\u6062\u590D\u65F6\u4ECE buddy.agent.json \u8BFB\u53D6 buddyId\uFF0C\u5E76\u4F7F\u7528\u5E73\u53F0\u6700\u65B0 Meta\u3002
+\u56DB\u518C\u786E\u8BA4\u540E\u7EE7\u7EED\u5C0F\u6302\u4EF6\u6E05\u5355\u3001\u539F\u578B\u548C\u8BBE\u8BA1\u9A8C\u6536\uFF1B\u5168\u90E8\u786E\u8BA4\u5E76\u901A\u8FC7\u4EA4\u4ED8\u6821\u9A8C\u540E\uFF0C\u7531 Coding Agent \u81EA\u52A8\u8854\u63A5\u5F00\u53D1\uFF0C\u9700\u8981\u521D\u59CB\u5316\u65F6\u6267\u884C init --mode direct \u751F\u6210\u5B98\u65B9 Runtime \u5DE5\u7A0B\u3002\u540C\u76EE\u5F55\u6062\u590D\u65F6\u4ECE package.json \u8BFB\u53D6 buddyId\uFF0C\u5E76\u4F7F\u7528\u5E73\u53F0\u6700\u65B0 Meta\u3002
 Coding Agent \u5E94\u4F20\u5165\u6309\u4E0A\u8FF0\u89C4\u5219\u786E\u5B9A\u7684\u8D44\u6599\uFF0C\u811A\u672C\u4F7F\u7528\u5F00\u53D1\u8005\u63D0\u4F9B\u7684\u53C2\u6570\uFF0C\u907F\u514D\u7B49\u5F85\u7EC8\u7AEF\u8F93\u5165\u3002CLI \u6821\u9A8C\u53C2\u6570\uFF0C\u4E0D\u5224\u65AD\u5BF9\u8BDD\u4E2D\u662F\u5426\u5DF2\u7ECF\u786E\u8BA4\uFF1B\u53C2\u6570\u9F50\u5168\u4E0D\u7B49\u4E8E\u7528\u6237\u786E\u8BA4\u3002
 Coding Agent \u6839\u636E\u5DF2\u786E\u8BA4\u624B\u518C\u6216\u9700\u6C42\u63A8\u8FDB\u5B9E\u73B0\uFF1B\u53EA\u4E3A\u5173\u952E\u7F3A\u53E3\u8BE2\u95EE\uFF0C\u4E0D\u56FA\u5B9A\u8FFD\u52A0\u7B56\u7565\u786E\u8BA4\u3002
 \u6240\u6709\u642D\u5B50\u7EDF\u4E00\u4F7F\u7528\u5B98\u65B9 Runtime\uFF1B\u9700\u6C42\u660E\u786E\u65F6\u4F7F\u7528 --mode direct\uFF0C\u9700\u8981\u68B3\u7406\u9700\u6C42\u65F6\u4F7F\u7528 --mode create\u3002
@@ -2748,8 +2695,8 @@ function resolvePlatformUrl(options = {}) {
 
 // packages/cli-core/src/dev/project-env.ts
 import { constants } from "node:fs";
-import { open as open4, rename as rename8, unlink as unlink7 } from "node:fs/promises";
-import { randomUUID as randomUUID6 } from "node:crypto";
+import { open as open4, rename as rename9, unlink as unlink7 } from "node:fs/promises";
+import { randomUUID as randomUUID7 } from "node:crypto";
 import { join as join13 } from "node:path";
 import { parseEnv } from "node:util";
 
@@ -2808,7 +2755,7 @@ async function readProjectEnvironment(projectRoot, buddyId) {
   } catch {
     throw invalid("\u5DE5\u7A0B .env \u683C\u5F0F\u65E0\u6548\uFF0C\u8BF7\u68C0\u67E5\u540E\u91CD\u8BD5\u3002");
   }
-  if (values.BUDDY_ID && values.BUDDY_ID !== buddyId) throw invalid(".env \u7684 BUDDY_ID \u4E0E buddy.agent.json \u4E0D\u4E00\u81F4\uFF0C\u8BF7\u5148\u4FEE\u6B63\u5DE5\u7A0B\u8EAB\u4EFD\u3002");
+  if (values.BUDDY_ID && values.BUDDY_ID !== buddyId) throw invalid(".env \u7684 BUDDY_ID \u4E0E package.json \u4E0D\u4E00\u81F4\uFF0C\u8BF7\u5148\u4FEE\u6B63\u5DE5\u7A0B\u8EAB\u4EFD\u3002");
   return values;
 }
 async function projectBuddyToken(projectRoot, buddyId, gatewayUrl) {
@@ -2871,7 +2818,7 @@ function updateValues(source, values) {
   return output;
 }
 async function replaceFile2(path, contents, mode) {
-  const temporary = `${path}.${randomUUID6()}.tmp`;
+  const temporary = `${path}.${randomUUID7()}.tmp`;
   let file;
   try {
     file = await open4(temporary, "wx", mode);
@@ -2879,7 +2826,7 @@ async function replaceFile2(path, contents, mode) {
     await file.sync();
     await file.close();
     file = void 0;
-    await rename8(temporary, path);
+    await rename9(temporary, path);
   } finally {
     await file?.close();
     await unlink7(temporary).catch((cause) => {
@@ -3035,7 +2982,7 @@ var MlbDevRegistrationClient = class {
       throw new BuddyDevError({
         code: "DEV_AGENT_ID_INVALID",
         phase: "registration",
-        message: "buddy.agent.json \u4E2D\u7684 buddyId \u65E0\u6548\u3002"
+        message: "package.json \u4E2D\u7684 buddyId \u65E0\u6548\u3002"
       });
     }
     options.signal.throwIfAborted();
@@ -3167,13 +3114,13 @@ function buildAgentEnvironment(options) {
 
 // packages/cli-core/src/dev/orchestrator.ts
 import { createHash as createHash6 } from "node:crypto";
-import { readFile as readFile14 } from "node:fs/promises";
-import { join as join16, resolve as resolve12 } from "node:path";
+import { readFile as readFile16 } from "node:fs/promises";
+import { join as join17, resolve as resolve12 } from "node:path";
 
 // packages/cli-core/src/dev/reload.ts
 import { watch } from "node:fs";
 import { createHash as createHash5 } from "node:crypto";
-import { readFile as readFile12, readdir as readdir4 } from "node:fs/promises";
+import { readFile as readFile13, readdir as readdir4 } from "node:fs/promises";
 import { join as join15, resolve as resolve9 } from "node:path";
 import { setTimeout as sleep } from "node:timers/promises";
 
@@ -3202,7 +3149,7 @@ async function snapshot(root, prefix = "", result = /* @__PURE__ */ new Map()) {
     if (!relevant(path)) continue;
     try {
       if (entry2.isDirectory()) await snapshot(root, path, result);
-      else if (entry2.isFile()) result.set(path, digest2(await readFile12(join15(root, path))));
+      else if (entry2.isFile()) result.set(path, digest2(await readFile13(join15(root, path))));
     } catch (cause) {
       if (cause.code !== "ENOENT") throw cause;
     }
@@ -3292,7 +3239,7 @@ var ReloadingDevSession = class {
         const path = String(name);
         if (!relevant(path)) return;
         if (path === ".env") {
-          void readFile12(join15(this.projectRoot, path), "utf8").then((contents) => {
+          void readFile13(join15(this.projectRoot, path), "utf8").then((contents) => {
             if (contents !== this.#environment) {
               this.#environment = contents;
               this.#changed();
@@ -3470,7 +3417,7 @@ function startReloadingDev(options, startProcess) {
 }
 
 // packages/cli-core/src/config/runtime-policy.ts
-import { readFile as readFile13, realpath as realpath4 } from "node:fs/promises";
+import { readFile as readFile14, realpath as realpath4 } from "node:fs/promises";
 import { createRequire as createRequire2 } from "node:module";
 import { resolve as resolve10 } from "node:path";
 var RuntimeRequirementError = class extends Error {
@@ -3510,11 +3457,11 @@ async function requireLatestRuntime(root, options = {}) {
     const installedPath = await realpath4(resolve10(root, "node_modules", BUDDY_RUNTIME_PACKAGE, "package.json"));
     const fromProject = createRequire2(resolve10(root, "package.json")).resolve(`${BUDDY_RUNTIME_PACKAGE}/package.json`);
     if (await realpath4(fromProject) !== installedPath) throw new Error("Runtime \u5FC5\u987B\u5B89\u88C5\u5728\u5F53\u524D\u5DE5\u7A0B\u4E2D");
-    const installed2 = JSON.parse(await readFile13(installedPath, "utf8"));
+    const installed2 = JSON.parse(await readFile14(installedPath, "utf8"));
     if (installed2.version !== latest) throw new Error(`Runtime \u5B9E\u9645\u5B89\u88C5 ${installed2.version}\uFF0C\u8981\u6C42 ${latest}`);
     let lock;
     try {
-      lock = await readFile13(resolve10(root, "package-lock.json"), "utf8");
+      lock = await readFile14(resolve10(root, "package-lock.json"), "utf8");
     } catch (cause) {
       if (cause.code !== "ENOENT") throw cause;
     }
@@ -3532,6 +3479,48 @@ async function requireLatestRuntime(root, options = {}) {
 import { lstatSync, readFileSync } from "node:fs";
 import { createRequire as createRequire3 } from "node:module";
 import { dirname as dirname4, resolve as resolve11 } from "node:path";
+
+// packages/cli-core/src/config/data-access.ts
+import { lstat as lstat10, readFile as readFile15 } from "node:fs/promises";
+import { join as join16 } from "node:path";
+var DATA_ACCESS_FILENAME = "data-access.json";
+function parseDataAccessRequirements(source) {
+  if (source === void 0) return [];
+  const invalid3 = (reason) => {
+    throw new Error(`${DATA_ACCESS_FILENAME}\uFF1A${reason}`);
+  };
+  let value;
+  try {
+    value = JSON.parse(source);
+  } catch {
+    return invalid3("\u4E0D\u662F\u6709\u6548 JSON");
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value) || Object.keys(value).some((key) => key !== "requirements") || !Array.isArray(value.requirements) || value.requirements.length > 32) {
+    return invalid3("\u5FC5\u987B\u662F\u4EC5\u5305\u542B requirements \u6570\u7EC4\u7684\u5BF9\u8C61\uFF0C\u6700\u591A\u58F0\u660E 32 \u9879");
+  }
+  const seen = /* @__PURE__ */ new Set();
+  return value.requirements.map((item, index) => {
+    if (!item || typeof item !== "object" || Array.isArray(item) || Object.keys(item).some((key) => key !== "id" && key !== "purpose") || !("id" in item) || typeof item.id !== "string" || !item.id.trim() || !("purpose" in item) || typeof item.purpose !== "string" || !item.purpose.trim() || item.purpose.trim().length > 200) {
+      return invalid3(`requirements[${index}] \u5FC5\u987B\u5305\u542B\u975E\u7A7A id \u548C 1\u2013200 \u5B57\u7684 purpose`);
+    }
+    const id = item.id.trim(), purpose = item.purpose.trim();
+    if (seen.has(id)) return invalid3(`\u6570\u636E\u96C6\u4E0D\u80FD\u91CD\u590D\u58F0\u660E\uFF1A${id}`);
+    seen.add(id);
+    return { id, purpose };
+  });
+}
+async function readDataAccessRequirements(projectRoot) {
+  const path = join16(projectRoot, DATA_ACCESS_FILENAME);
+  try {
+    if (!(await lstat10(path)).isFile()) throw new Error(`${DATA_ACCESS_FILENAME} \u5FC5\u987B\u662F\u666E\u901A\u6587\u4EF6`);
+    return parseDataAccessRequirements(await readFile15(path, "utf8"));
+  } catch (cause) {
+    if (cause.code === "ENOENT") return [];
+    throw cause;
+  }
+}
+
+// packages/cli-core/src/dev/launch.ts
 async function officialAgentLaunchPlan(input) {
   const entry2 = resolve11(input.projectRoot, BUDDY_PLATFORM_START_ENTRY);
   for (const [filename, kind] of [
@@ -3562,8 +3551,7 @@ async function officialAgentLaunchPlan(input) {
     const runtimePath = createRequire3(packagePath).resolve(`${BUDDY_RUNTIME_PACKAGE}/package.json`);
     const installed2 = JSON.parse(readFileSync(runtimePath, "utf8")).version;
     if (installed2 !== expected) throw new Error(`Runtime \u5DF2\u5B89\u88C5 ${installed2}\uFF0C\u5DE5\u7A0B\u8981\u6C42 ${expected}`);
-    await validateRuntimeDatasets(input.projectRoot, input.datasets);
-    await validateRuntimeModel(input.projectRoot, input.model);
+    await validateRuntimeDatasets(input.projectRoot, await readDataAccessRequirements(input.projectRoot));
   } catch (cause) {
     throw new BuddyDevError({
       code: cause instanceof RuntimeRequirementError ? `DEV_${cause.code}` : "DEV_CONFIG_INVALID",
@@ -3572,7 +3560,6 @@ async function officialAgentLaunchPlan(input) {
       cause
     });
   }
-  await migrateRuntimeStartup(input.projectRoot);
   return Object.freeze({
     command: process.execPath,
     args: Object.freeze(["--env-file-if-exists=.env", entry2])
@@ -3818,8 +3805,6 @@ function validateLaunchPlan(value) {
 async function launchPlanFor(config, options, projectRoot, signal) {
   const provider = options.platformLaunchPlan ?? ((context) => officialAgentLaunchPlan({
     runtimeUpdate: { ...options.runtimeUpdate, signal },
-    datasets: config.datasets,
-    model: config.model,
     projectRoot: context.projectRoot
   }));
   try {
@@ -4047,13 +4032,13 @@ async function startBuddyDevProcess(options, hooks) {
     let config;
     let configSource;
     try {
-      configSource = await readFile14(join16(projectRoot, BUDDY_AGENT_FILENAME), "utf8");
+      configSource = await readFile16(join17(projectRoot, BUDDY_PACKAGE_FILENAME), "utf8");
       config = combineBuddyProject(parseBuddyAgentConfig(configSource));
     } catch (cause) {
       throw new BuddyDevError({
         code: "DEV_CONFIG_INVALID",
         phase: "config",
-        message: `\u65E0\u6CD5\u8BFB\u53D6\u6216\u6821\u9A8C buddy.agent.json\uFF1A${cause instanceof Error ? cause.message : "\u642D\u5B50\u5DE5\u7A0B\u5C1A\u672A\u5B8C\u6210"}`,
+        message: `\u65E0\u6CD5\u8BFB\u53D6\u6216\u6821\u9A8C package.json\uFF1A${cause instanceof Error ? cause.message : "\u642D\u5B50\u5DE5\u7A0B\u5C1A\u672A\u5B8C\u6210"}`,
         cause
       });
     }
@@ -4531,7 +4516,7 @@ var PushPreflightError = class extends Error {
 import { resolve as resolve15 } from "node:path";
 
 // packages/cli-core/src/cloud/auth.ts
-import { randomUUID as randomUUID7 } from "node:crypto";
+import { randomUUID as randomUUID8 } from "node:crypto";
 
 // packages/cli-core/src/cloud/validation.ts
 function record(value, path = "request") {
@@ -4599,7 +4584,7 @@ var CloudAuthenticator = class {
     this.#adapter = adapter;
     this.#store = store;
     this.#now = options.now ?? Date.now;
-    this.#createState = options.createState ?? randomUUID7;
+    this.#createState = options.createState ?? randomUUID8;
     this.#minimumValidityMs = options.minimumValidityMs ?? 3e4;
     if (!Number.isSafeInteger(this.#minimumValidityMs) || this.#minimumValidityMs < 0) {
       throw new TypeError("minimumValidityMs must be a non-negative safe integer");
@@ -5545,8 +5530,8 @@ async function runCloudCommand(command, args, io, options = {}) {
 var CLOUD_COMMAND_HELP = HELP;
 
 // packages/cli-core/src/migration/index.ts
-import { lstat as lstat10, open as open5, readdir as readdir5, realpath as realpath5, stat } from "node:fs/promises";
-import { extname, isAbsolute as isAbsolute3, join as join17, relative, resolve as resolve16, sep, win32 as win322 } from "node:path";
+import { lstat as lstat11, open as open5, readdir as readdir5, realpath as realpath5, stat } from "node:fs/promises";
+import { extname, isAbsolute as isAbsolute3, join as join18, relative, resolve as resolve16, sep, win32 as win322 } from "node:path";
 var DEFAULT_SKILL_SCAN_LIMITS = Object.freeze({
   maxFiles: 128,
   maxFileBytes: 256 * 1024,
@@ -5715,9 +5700,9 @@ async function existingProjectRoot(value) {
   }
 }
 async function existingSkillRoot(projectRoot, skillPath) {
-  const candidate = skillPath === "." ? projectRoot : join17(projectRoot, ...skillPath.split("/"));
+  const candidate = skillPath === "." ? projectRoot : join18(projectRoot, ...skillPath.split("/"));
   try {
-    await lstat10(candidate);
+    await lstat11(candidate);
   } catch (cause) {
     if (filesystemCode(cause) === "ENOENT") {
       return rejectScan("SKILL_ROOT_NOT_FOUND", skillPath, "\u627E\u4E0D\u5230\u6307\u5B9A\u7684 Skill \u76EE\u5F55\u3002");
@@ -5752,9 +5737,9 @@ async function existingSkillRoot(projectRoot, skillPath) {
 }
 async function assertEntrypoint(context) {
   const entryPath = reportChild(context.skillPath, "SKILL.md");
-  const candidate = join17(context.skillRoot, "SKILL.md");
+  const candidate = join18(context.skillRoot, "SKILL.md");
   try {
-    await lstat10(candidate);
+    await lstat11(candidate);
     const target = await realpath5(candidate);
     if (!isWithin(context.projectRoot, target) || !isWithin(context.skillRoot, target)) {
       rejectScan(
@@ -5856,7 +5841,7 @@ async function walkDirectory(actualDirectory, reportDirectory, ancestors, contex
   }
   for (const entry2 of entries) {
     const childReportPath = reportChild(reportDirectory, entry2.name);
-    const childPath = join17(directory, entry2.name);
+    const childPath = join18(directory, entry2.name);
     let target;
     try {
       target = await realpath5(childPath);
@@ -6311,8 +6296,8 @@ async function scanExternalSkillPortability(options) {
 
 // packages/cli-core/src/push/preflight.ts
 import { createHash as createHash10 } from "node:crypto";
-import { lstat as lstat11, open as open6, readdir as readdir6, realpath as realpath6 } from "node:fs/promises";
-import { isAbsolute as isAbsolute4, join as join18, relative as relative2, resolve as resolve17, sep as sep2, win32 as win323 } from "node:path";
+import { lstat as lstat12, open as open6, readdir as readdir6, realpath as realpath6 } from "node:fs/promises";
+import { isAbsolute as isAbsolute4, join as join19, relative as relative2, resolve as resolve17, sep as sep2, win32 as win323 } from "node:path";
 var MEBIBYTE = 1024 * 1024;
 var DEFAULT_PUSH_MANIFEST_LIMITS = Object.freeze({
   maxFiles: 1e4,
@@ -6489,7 +6474,7 @@ async function canonicalProjectRoot(projectRoot) {
   const absolute = resolve17(projectRoot);
   let entry2;
   try {
-    entry2 = await lstat11(absolute);
+    entry2 = await lstat12(absolute);
   } catch (cause) {
     error({
       code: "PUSH_PROJECT_INVALID",
@@ -6517,10 +6502,10 @@ async function canonicalProjectRoot(projectRoot) {
   }
 }
 async function captureConfigWithinLimit(projectRoot, maxFileBytes, filename) {
-  const path = join18(projectRoot, filename);
+  const path = join19(projectRoot, filename);
   let entry2;
   try {
-    entry2 = await lstat11(path);
+    entry2 = await lstat12(path);
   } catch (cause) {
     error({
       code: "PUSH_CONFIG_INVALID",
@@ -6579,7 +6564,7 @@ function parseCapturedProject(agentFile) {
   } catch (cause) {
     error({
       code: "PUSH_CONFIG_INVALID",
-      message: `${BUDDY_AGENT_FILENAME} \u65E0\u6548\u3001Agent \u5DE5\u7A0B\u5C1A\u672A\u5B8C\u6210\u3002`,
+      message: `${BUDDY_PACKAGE_FILENAME} \u65E0\u6548\u3001Agent \u5DE5\u7A0B\u5C1A\u672A\u5B8C\u6210\u3002`,
       cause
     });
   }
@@ -6615,11 +6600,11 @@ async function selectLockfile(projectRoot) {
 }
 function assertBookletIsNotRequiredInput(bookletPath, lockfile) {
   if (bookletPath === void 0) return;
-  if (bookletPath === BUDDY_AGENT_FILENAME || bookletPath === lockfile.path || OFFICIAL_RUNTIME_INPUTS.some((path) => path === bookletPath)) {
+  if (bookletPath === BUDDY_PACKAGE_FILENAME || bookletPath === DATA_ACCESS_FILENAME || bookletPath === lockfile.path || OFFICIAL_RUNTIME_INPUTS.some((path) => path === bookletPath)) {
     error({
       code: "PUSH_BOOKLET_INVALID",
       path: bookletPath,
-      message: `Booklet \u4E0D\u80FD\u4F2A\u88C5\u6210 ${BUDDY_AGENT_FILENAME}\u3001\u4F9D\u8D56\u9501\u6587\u4EF6\u3001Runtime \u542F\u52A8\u8F93\u5165\u3002`
+      message: `Booklet \u4E0D\u80FD\u4F2A\u88C5\u6210 ${BUDDY_PACKAGE_FILENAME}\u3001\u4F9D\u8D56\u9501\u6587\u4EF6\u3001Runtime \u542F\u52A8\u8F93\u5165\u3002`
     });
   }
 }
@@ -6720,10 +6705,10 @@ async function createManifest(options) {
         sensitiveEntriesExcluded += 1;
         continue;
       }
-      const absolutePath = join18(directory, name);
+      const absolutePath = join19(directory, name);
       let entry2;
       try {
-        entry2 = await lstat11(absolutePath);
+        entry2 = await lstat12(absolutePath);
       } catch (cause) {
         error({
           code: "PUSH_FILE_CHANGED",
@@ -6974,8 +6959,8 @@ async function assertCapturedConfigStable(options) {
   }
   let current;
   try {
-    const path = join18(options.projectRoot, options.filename);
-    const entry2 = await lstat11(path);
+    const path = join19(options.projectRoot, options.filename);
+    const entry2 = await lstat12(path);
     if (!entry2.isFile() || entry2.isSymbolicLink()) {
       error({
         code: "PUSH_FILE_CHANGED",
@@ -7015,15 +7000,22 @@ async function createPushPreflight(options) {
   const initialAgentEntry = await captureConfigWithinLimit(
     projectRoot,
     limits.maxFileBytes,
-    BUDDY_AGENT_FILENAME
+    BUDDY_PACKAGE_FILENAME
   );
   parseCapturedProject(initialAgentEntry);
+  let initialDataEntry;
+  try {
+    await lstat12(join19(projectRoot, DATA_ACCESS_FILENAME));
+    initialDataEntry = await captureConfigWithinLimit(projectRoot, limits.maxFileBytes, DATA_ACCESS_FILENAME);
+  } catch (cause) {
+    if (cause.code !== "ENOENT") throw cause;
+  }
   const lockfile = await selectLockfile(projectRoot);
   assertBookletIsNotRequiredInput(bookletPath, lockfile);
   const manifest = await createManifest({
     projectRoot,
     limits,
-    capturePaths: /* @__PURE__ */ new Set([BUDDY_AGENT_FILENAME, lockfile.path, BUDDY_PLATFORM_PACKAGE_JSON, BUDDY_PLATFORM_AGENT_ENTRY, BUDDY_PLATFORM_FACTORY_ENTRY]),
+    capturePaths: /* @__PURE__ */ new Set([DATA_ACCESS_FILENAME, BUDDY_PACKAGE_FILENAME, lockfile.path, BUDDY_PLATFORM_AGENT_ENTRY, BUDDY_PLATFORM_FACTORY_ENTRY]),
     ...bookletPath === void 0 ? {} : { bookletPath }
   });
   const lockEntry = manifest.files.find((file) => file.path === lockfile.path);
@@ -7048,24 +7040,32 @@ async function createPushPreflight(options) {
   }
   const agentEntry = await assertCapturedConfigStable({
     projectRoot,
-    filename: BUDDY_AGENT_FILENAME,
+    filename: BUDDY_PACKAGE_FILENAME,
     initial: initialAgentEntry,
     manifestFiles: manifest.files,
     maxFileBytes: limits.maxFileBytes
   });
-  const config = parseCapturedProject(agentEntry);
-  if (config.datasets?.length || config.model !== void 0) {
-    try {
-      if (config.datasets?.length) await validateRuntimeDatasets(projectRoot, config.datasets);
-      await validateRuntimeModel(projectRoot, config.model);
-    } catch (cause) {
-      error({
-        code: "PUSH_CONFIG_INVALID",
-        path: BUDDY_AGENT_FILENAME,
-        message: `\u65E0\u6CD5\u6309\u5DE5\u7A0B Runtime \u6821\u9A8C\u6A21\u578B\u6216\u6570\u636E\u58F0\u660E\uFF1A${cause instanceof Error ? cause.message : String(cause)}`,
-        cause
-      });
-    }
+  parseCapturedProject(agentEntry);
+  if (initialDataEntry) {
+    await assertCapturedConfigStable({
+      projectRoot,
+      filename: DATA_ACCESS_FILENAME,
+      initial: initialDataEntry,
+      manifestFiles: manifest.files,
+      maxFileBytes: limits.maxFileBytes
+    });
+  }
+  try {
+    const dataEntry = manifest.files.find((file) => file.path === DATA_ACCESS_FILENAME);
+    const requirements = parseDataAccessRequirements(dataEntry ? decodeCapturedConfig(dataEntry) : void 0);
+    if (requirements.length) await validateRuntimeDatasets(projectRoot, requirements);
+  } catch (cause) {
+    error({
+      code: "PUSH_CONFIG_INVALID",
+      path: DATA_ACCESS_FILENAME,
+      message: `\u65E0\u6CD5\u6309\u5DE5\u7A0B Runtime \u6821\u9A8C\u6570\u636E\u58F0\u660E\uFF1A${cause instanceof Error ? cause.message : String(cause)}`,
+      cause
+    });
   }
   const files = Object.freeze(manifest.files.map((file) => Object.freeze({
     path: file.path,
@@ -7107,8 +7107,8 @@ async function createPushPreflight(options) {
 
 // packages/cli-core/src/push/bundle.ts
 import { createHash as createHash11 } from "node:crypto";
-import { lstat as lstat12, readFile as readFile15, realpath as realpath7 } from "node:fs/promises";
-import { join as join19, relative as relative3, sep as sep3, win32 as win324 } from "node:path";
+import { lstat as lstat13, readFile as readFile17, realpath as realpath7 } from "node:fs/promises";
+import { join as join20, relative as relative3, sep as sep3, win32 as win324 } from "node:path";
 import { Writable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { createGzip } from "node:zlib";
@@ -7130,15 +7130,15 @@ function inside(root, target) {
   return path === "" || path !== ".." && !path.startsWith(`..${sep3}`) && !path.startsWith("/") && !win324.isAbsolute(path);
 }
 async function capture(root, file) {
-  const absolute = join19(root, ...file.path.split("/"));
+  const absolute = join20(root, ...file.path.split("/"));
   try {
-    const entry2 = await lstat12(absolute);
+    const entry2 = await lstat13(absolute);
     if (!entry2.isFile() || entry2.isSymbolicLink() || entry2.size !== file.bytes) {
       changed(file.path, `\u63D0\u4EA4\u524D\u6587\u4EF6\u53D1\u751F\u53D8\u5316\uFF1A${file.path}`);
     }
     const canonical = await realpath7(absolute);
     if (!inside(root, canonical)) changed(file.path, `\u63D0\u4EA4\u6587\u4EF6\u8D8A\u8FC7\u9879\u76EE\u6839\u76EE\u5F55\uFF1A${file.path}`);
-    const contents = await readFile15(absolute);
+    const contents = await readFile17(absolute);
     if (contents.byteLength !== file.bytes || digest3(contents) !== file.digest) {
       changed(file.path, `\u63D0\u4EA4\u524D\u6587\u4EF6\u5185\u5BB9\u53D1\u751F\u53D8\u5316\uFF1A${file.path}`);
     }
@@ -7439,7 +7439,7 @@ async function initializeProjectRoute(route, args, io, options, application) {
   const existingBuddyId = initializationPlan?.existingManifest?.buddyId;
   if (existingBuddyId !== void 0 && args.buddyId !== void 0 && existingBuddyId !== args.buddyId) {
     throw new CliUsageError(
-      `\u5DF2\u6709 buddy.agent.json \u7ED1\u5B9A\u7684\u662F ${existingBuddyId}\uFF0C\u4E0E --buddy-id ${args.buddyId} \u4E0D\u4E00\u81F4`
+      `\u5DF2\u6709 package.json \u7ED1\u5B9A\u7684\u662F ${existingBuddyId}\uFF0C\u4E0E --buddy-id ${args.buddyId} \u4E0D\u4E00\u81F4`
     );
   }
   const requestedBuddyId = existingBuddyId ?? args.buddyId;
@@ -7511,7 +7511,7 @@ async function runRoute(route, args, io, options) {
   const existingBuddyId = plan.existingManifest?.buddyId;
   if (existingBuddyId !== void 0 && args.buddyId !== void 0 && existingBuddyId !== args.buddyId) {
     throw new CliUsageError(
-      `\u5DF2\u6709 buddy.agent.json \u7ED1\u5B9A\u7684\u662F ${existingBuddyId}\uFF0C\u4E0E --buddy-id ${args.buddyId} \u4E0D\u4E00\u81F4`
+      `\u5DF2\u6709 package.json \u7ED1\u5B9A\u7684\u662F ${existingBuddyId}\uFF0C\u4E0E --buddy-id ${args.buddyId} \u4E0D\u4E00\u81F4`
     );
   }
   const requestedBuddyId = existingBuddyId ?? args.buddyId;
@@ -7521,7 +7521,7 @@ async function runRoute(route, args, io, options) {
   let draft;
   try {
     plan = await planBuddyDraftInitialization(rootDirectory);
-    draft = await applyBuddyDraftInitialization(plan, { schemaVersion: 1, buddyId });
+    draft = await applyBuddyDraftInitialization(plan, { buddyId });
   } catch (cause) {
     io.writeError(
       `\u4E91\u7AEF\u642D\u5B50\u8EAB\u4EFD ${buddyId} \u5DF2\u51C6\u5907\u597D\uFF0C\u4F46\u672C\u5730 ${plan.agentConfigPath} \u5199\u5165\u5931\u8D25\u3002\u8BF7\u4F7F\u7528 --buddy-id ${buddyId} \u91CD\u8BD5\u3002`
@@ -7545,7 +7545,7 @@ async function resumeProjectArguments(args, cwd, options, io) {
   await assertInitializableBuddyTarget(root);
   let entry2;
   try {
-    entry2 = await lstat13(join20(root, "buddy.agent.json"));
+    entry2 = await lstat14(join21(root, "package.json"));
   } catch (cause) {
     if (cause.code === "ENOENT") {
       const draft = await readMetaDraft(root);
@@ -7562,13 +7562,13 @@ async function resumeProjectArguments(args, cwd, options, io) {
     throw cause;
   }
   if (!entry2.isFile() || entry2.isSymbolicLink()) {
-    throw new CliUsageError("buddy.agent.json \u5FC5\u987B\u662F\u666E\u901A\u6587\u4EF6\uFF0C\u4E0D\u80FD\u4F7F\u7528\u7B26\u53F7\u94FE\u63A5");
+    throw new CliUsageError("package.json \u5FC5\u987B\u662F\u666E\u901A\u6587\u4EF6\uFF0C\u4E0D\u80FD\u4F7F\u7528\u7B26\u53F7\u94FE\u63A5");
   }
   const manifest = await readBuddyProjectManifest(root);
   await checkRuntimeUpdate(root, (message) => io.writeError(message), options.runtimeCatalog);
   if (args.buddyId !== void 0 && args.buddyId !== manifest.buddyId) {
     throw new CliUsageError(
-      `\u5DF2\u6709 buddy.agent.json \u7ED1\u5B9A\u7684\u662F ${manifest.buddyId}\uFF0C\u4E0E --buddy-id ${args.buddyId} \u4E0D\u4E00\u81F4`
+      `\u5DF2\u6709 package.json \u7ED1\u5B9A\u7684\u662F ${manifest.buddyId}\uFF0C\u4E0E --buddy-id ${args.buddyId} \u4E0D\u4E00\u81F4`
     );
   }
   const { client } = platformDependencies(options);
@@ -7754,8 +7754,8 @@ async function* parseServerSentEvents(body, options = {}) {
 }
 export {
   AGENT_INHERITED_ENV_ALLOWLIST,
-  BUDDY_AGENT_FILENAME,
-  BUDDY_AGENT_SCHEMA,
+  BUDDY_PACKAGE_FILENAME,
+  BUDDY_PACKAGE_SCHEMA,
   BUDDY_PLATFORM_AGENT_ENTRY,
   BUDDY_PLATFORM_FACTORY_ENTRY,
   BUDDY_PLATFORM_PACKAGE_JSON,
@@ -7810,7 +7810,6 @@ export {
   isSafeProjectRelativePath,
   isWindowsReservedPathSegment,
   latestRuntimeTemplate,
-  migrateRuntimeStartup,
   normalizePlatformUrl,
   openExternalUrl,
   parseBuddyAgentConfig,