@lark-base-open/base-database-cli 1.4.0 → 1.4.3

package/dist/unified-functions.js

@@ -0,0 +1,114 @@
+import { responseData, runLarkCli } from './lark-cli.js';
+export function functionEnv(value = 'preview') {
+    if (value !== 'preview' && value !== 'prod')
+        throw new Error('env must be preview or prod');
+    return value;
+}
+export function assertFunctionResults(data, expectedIds) {
+    const unknown = () => {
+        throw new Error('FUNCTION_RESPONSE_UNKNOWN: incomplete or invalid batch receipt; read back the affected Functions before retrying or publishing');
+    };
+    if (!Array.isArray(data.results))
+        return unknown();
+    const expected = new Set(expectedIds);
+    if (expected.size !== expectedIds.length)
+        return unknown();
+    const seen = new Set();
+    const deletedFunctionIds = [];
+    for (const item of data.results) {
+        if (!item ||
+            typeof item.functionId !== 'string' ||
+            !Number.isSafeInteger(item.code) ||
+            seen.has(item.functionId) ||
+            (!expected.has(item.functionId) && item.action !== 'delete'))
+            return unknown();
+        seen.add(item.functionId);
+        if (item.action === 'delete')
+            deletedFunctionIds.push(item.functionId);
+    }
+    if (expectedIds.some((id) => !seen.has(id)))
+        return unknown();
+    const failures = data.results.filter((item) => item.code !== 0);
+    if (failures.length)
+        throw new Error(`Function batch failed: ${JSON.stringify(failures)}`);
+    return deletedFunctionIds;
+}
+export function putFunctions(token, kinds, functions, env, cwd) {
+    const data = responseData(runLarkCli([
+        'api',
+        'PUT',
+        `/open-apis/base/v3/sites/${encodeURIComponent(token)}/functions`,
+        '--data',
+        JSON.stringify({ kinds, functions }),
+    ], env, cwd));
+    const deletedFunctionIds = assertFunctionResults(data, functions.map((item) => item.functionId));
+    return { ...data, deletedFunctionIds };
+}
+export function functionPage(data, state) {
+    if (data.skillHash === '')
+        throw new Error('FUNCTION_RESPONSE_UNKNOWN: 服务端返回了旧协议结果（skillHash 为空），无法确认完整函数列表；请等待服务端协议升级后重试');
+    if (++state.pages > 1000 ||
+        !Array.isArray(data.functions) ||
+        typeof data.hasMore !== 'boolean' ||
+        typeof data.skillHash !== 'string' ||
+        !((typeof data.versionId === 'number' &&
+            Number.isSafeInteger(data.versionId)) ||
+            (typeof data.versionId === 'string' && /^\d+$/.test(data.versionId))))
+        throw new Error('FUNCTION_RESPONSE_UNKNOWN: invalid or unbounded Function list; read again before writing');
+    const snapshot = JSON.stringify([data.versionId, data.skillHash]);
+    if (state.snapshot !== undefined && state.snapshot !== snapshot)
+        throw new Error('FUNCTION_RESPONSE_UNKNOWN: discovery snapshot changed; read again before writing');
+    state.snapshot = snapshot;
+    for (const item of data.functions) {
+        if (!item ||
+            typeof item.functionId !== 'string' ||
+            !/^[A-Za-z0-9_-]{1,64}$/.test(item.functionId) ||
+            !['sql', 'edge', 'mutation', 'ai'].includes(item.functionType) ||
+            state.ids.has(item.functionId))
+            throw new Error('FUNCTION_RESPONSE_UNKNOWN: invalid or duplicate function metadata');
+        state.ids.add(item.functionId);
+    }
+    return data.functions;
+}
+export function listFunctions(token, version, env, cwd) {
+    const functions = [];
+    const seen = new Set();
+    let pageToken = '';
+    const state = { pages: 0, ids: new Set() };
+    do {
+        const data = responseData(runLarkCli([
+            'api',
+            'GET',
+            `/open-apis/base/v3/sites/${encodeURIComponent(token)}/functions`,
+            '--params',
+            JSON.stringify({
+                env: functionEnv(version),
+                includeInternal: true,
+                pageSize: 20,
+                ...(pageToken ? { pageToken } : {}),
+            }),
+        ], env, cwd));
+        functions.push(...functionPage(data, state));
+        if (!data.hasMore)
+            return functions;
+        if (typeof data.pageToken !== 'string' ||
+            !data.pageToken ||
+            seen.has(data.pageToken))
+            throw new Error('Function list returned an empty or repeated pageToken');
+        pageToken = data.pageToken;
+        seen.add(pageToken);
+    } while (true);
+}
+export function getFunction(token, key, version, env, cwd) {
+    const data = responseData(runLarkCli([
+        'api',
+        'GET',
+        `/open-apis/base/v3/sites/${encodeURIComponent(token)}/functions/${encodeURIComponent(key)}`,
+        '--params',
+        JSON.stringify({ env: functionEnv(version), includeInternal: true }),
+    ], env, cwd));
+    if (!data.function || typeof data.function !== 'object')
+        throw new Error('Function detail is missing function');
+    return data.function;
+}
+//# sourceMappingURL=unified-functions.js.map

package/dist/unified-functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-functions.js","sourceRoot":"","sources":["../src/unified-functions.ts"],"names":[],"mappings":"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"}

package/dist/updates.d.ts

@@ -1,4 +1,6 @@
-export declare function checkUpdate(skillDirectory?: string): Promise<{
+import type { Command } from 'commander';
+export { businessUpdateNotice } from './business-update-notice.js';
+export declare function checkUpdate(skillDirectory?: string, timeoutMs?: number): Promise<{
     current: string;
     skill: {
         directory: string | undefined;
@@ -6,6 +8,15 @@ export declare function checkUpdate(skillDirectory?: string): Promise<{
         status: string;
     };
     status: string;
+} | {
+    current: string;
+    skill: {
+        directory: string | undefined;
+        version: string | undefined;
+        status: string;
+    };
+    status: string;
+    cached: boolean;
 } | {
     current: string;
     skill: {
@@ -17,4 +28,5 @@ export declare function checkUpdate(skillDirectory?: string): Promise<{
     latest: string;
     cached: boolean;
 }>;
+export declare function enableBusinessUpdateNotices(program: Command): void;
 //# sourceMappingURL=updates.d.ts.map

package/dist/updates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updates.d.ts","sourceRoot":"","sources":["../src/updates.ts"],"names":[],"mappings":"AAQA,wBAAsB,WAAW,CAAC,cAAc,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;GAwGxD"}
+{"version":3,"file":"updates.d.ts","sourceRoot":"","sources":["../src/updates.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,wBAAsB,WAAW,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,SAAS,SAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkH1E;AAKD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqBlE"}

package/dist/updates.js

@@ -4,7 +4,9 @@ import { join, resolve } from 'node:path';
 import semver from 'semver';
 import { cliPackage, npm } from './distribution-npm.js';
 import { readSkillVersion } from './skill.js';
-export async function checkUpdate(skillDirectory) {
+import { businessChecks } from './business-update-notice.js';
+export { businessUpdateNotice } from './business-update-notice.js';
+export async function checkUpdate(skillDirectory, timeoutMs = 5000) {
     const current = cliPackage.version;
     const recordedVersion = skillDirectory
         ? readSkillVersion(resolve(skillDirectory))
@@ -22,12 +24,33 @@ export async function checkUpdate(skillDirectory) {
                 : 'mismatch',
     };
     const local = { current, skill };
-    if ((process.env.CI && process.env.CI !== 'false') ||
-        process.env.BASE_SITE_BUILDER_WORKSPACE_SOURCE ||
-        process.env.BASE_SITE_BUILDER_SITE_TOKEN) {
+    if (process.env.CI && process.env.CI !== 'false') {
         return { ...local, status: 'skipped' };
     }
-    const deadline = Date.now() + 5000;
+    const statePath = join(homedir(), '.base-database-cli', 'update-state.json');
+    let previous;
+    try {
+        previous = JSON.parse(readFileSync(statePath, 'utf8'));
+    }
+    catch {
+        // Missing or damaged cache does not prevent a fresh query.
+    }
+    const age = typeof previous?.checkedAt === 'string'
+        ? Date.now() - Date.parse(previous.checkedAt)
+        : Number.NaN;
+    if (previous?.status === 'unavailable' && age >= 0 && age < 3_600_000) {
+        return { ...local, status: 'unavailable', cached: true };
+    }
+    const saveState = (state) => {
+        try {
+            mkdirSync(join(homedir(), '.base-database-cli'), { recursive: true });
+            writeFileSync(statePath, JSON.stringify({ ...state, checkedAt: new Date().toISOString() }, null, 2) + '\n');
+        }
+        catch {
+            // Optional cache writes must not affect business commands.
+        }
+    };
+    const deadline = Date.now() + timeoutMs;
     const query = (args) => {
         const remaining = deadline - Date.now();
         if (remaining <= 0)
@@ -47,21 +70,15 @@ export async function checkUpdate(skillDirectory) {
         // Do not persist credentials if a custom registry URL contains them.
         const url = new URL(registry);
         const cacheable = !url.username && !url.password && !url.search;
-        const statePath = join(homedir(), '.base-database-cli', 'update-state.json');
         let latest;
-        try {
-            const cached = JSON.parse(readFileSync(statePath, 'utf8'));
-            const age = Date.now() - Date.parse(cached.checkedAt);
-            if (cacheable &&
-                cached.registry === registry &&
-                age >= 0 &&
-                age < 86_400_000 &&
-                semver.valid(cached.latest))
-                latest = cached.latest;
-        }
-        catch {
-            /* A missing or damaged cache is disposable. */
-        }
+        if (cacheable &&
+            (previous?.status === 'latest' || previous?.status === undefined) &&
+            previous?.registry === registry &&
+            age >= 0 &&
+            age < 86_400_000 &&
+            typeof previous?.latest === 'string' &&
+            semver.valid(previous.latest))
+            latest = previous.latest;
         const cached = Boolean(latest);
         if (!latest) {
             latest = JSON.parse(await query([
@@ -73,15 +90,8 @@ export async function checkUpdate(skillDirectory) {
             ]));
             if (!latest || !semver.valid(latest))
                 throw new Error('npm returned an invalid latest version');
-            if (cacheable) {
-                try {
-                    mkdirSync(join(homedir(), '.base-database-cli'), { recursive: true });
-                    writeFileSync(statePath, JSON.stringify({ registry, latest, checkedAt: new Date().toISOString() }, null, 2) + '\n');
-                }
-                catch {
-                    /* Cache writes must not block business commands. */
-                }
-            }
+            if (cacheable)
+                saveState({ status: 'latest', registry, latest });
         }
         return {
             ...local,
@@ -92,7 +102,33 @@ export async function checkUpdate(skillDirectory) {
     }
     catch {
         // npm diagnostics may contain private registry details; availability is optional.
-        return { ...local, status: 'unavailable' };
+        saveState({ status: 'unavailable' });
+        return { ...local, status: 'unavailable', cached: false };
     }
 }
+// Only the public executable installs this hook. Bound all npm queries together
+// to 500 ms; business actions may use synchronous child processes, so finish
+// the optional check first rather than letting them stall its deadline timers.
+export function enableBusinessUpdateNotices(program) {
+    program.hook('preAction', async (_root, action) => {
+        let top = action;
+        while (top.parent && top.parent !== program)
+            top = top.parent;
+        if ([
+            'doctor',
+            'init',
+            'pull',
+            'deploy',
+            'deployments',
+            'ai-functions',
+            'environment-variables',
+            'env-vars',
+        ].includes(top.name())) {
+            businessChecks.set(program, await checkUpdate(undefined, 500));
+        }
+        else {
+            businessChecks.delete(program);
+        }
+    });
+}
 //# sourceMappingURL=updates.js.map

package/dist/updates.js.map

@@ -1 +1 @@
-{"version":3,"file":"updates.js","sourceRoot":"","sources":["../src/updates.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"updates.js","sourceRoot":"","sources":["../src/updates.ts"],"names":[],"mappings":"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"}

package/dist/workspace-fingerprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-fingerprint.d.ts","sourceRoot":"","sources":["../src/workspace-fingerprint.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qCAAqC,2BAA2B,CAAC;AAC9E,eAAO,MAAM,8CAA8C,oCACxB,CAAC;AACpC,eAAO,MAAM,sCAAsC,+BACrB,CAAC;AAC/B,eAAO,MAAM,+CAA+C,wCACrB,CAAC;AACxC,eAAO,MAAM,6CAA6C,+BAC5B,CAAC;AAC/B,eAAO,MAAM,sDAAsD,wCAC5B,CAAC;AA6BxC,MAAM,WAAW,yBAAyB;IACxC,SAAS,EACL,OAAO,qCAAqC,GAC5C,OAAO,sCAAsC,GAC7C,OAAO,6CAA6C,CAAC;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iCAAiC;IAChD,SAAS,EACL,OAAO,qCAAqC,GAC5C,OAAO,8CAA8C,GACrD,OAAO,sCAAsC,GAC7C,OAAO,+CAA+C,GACtD,OAAO,6CAA6C,GACpD,OAAO,sDAAsD,CAAC;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AA2GD,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,GAChB,yBAAyB,CAW3B;AAED,8EAA8E;AAC9E,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,GAChB,yBAAyB,CAc3B;AAED,0EAA0E;AAC1E,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,MAAM,GAChB,yBAAyB,CAc3B;AAED,kFAAkF;AAClF,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,GAChB,iCAAiC,CAMnC;AAED,4EAA4E;AAC5E,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,MAAM,GAChB,iCAAiC,CAMnC;AAED,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,MAAM,GAChB,iCAAiC,CAMnC"}
+{"version":3,"file":"workspace-fingerprint.d.ts","sourceRoot":"","sources":["../src/workspace-fingerprint.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qCAAqC,2BAA2B,CAAC;AAC9E,eAAO,MAAM,8CAA8C,oCACxB,CAAC;AACpC,eAAO,MAAM,sCAAsC,+BACrB,CAAC;AAC/B,eAAO,MAAM,+CAA+C,wCACrB,CAAC;AACxC,eAAO,MAAM,6CAA6C,+BAC5B,CAAC;AAC/B,eAAO,MAAM,sDAAsD,wCAC5B,CAAC;AAkCxC,MAAM,WAAW,yBAAyB;IACxC,SAAS,EACL,OAAO,qCAAqC,GAC5C,OAAO,sCAAsC,GAC7C,OAAO,6CAA6C,CAAC;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iCAAiC;IAChD,SAAS,EACL,OAAO,qCAAqC,GAC5C,OAAO,8CAA8C,GACrD,OAAO,sCAAsC,GAC7C,OAAO,+CAA+C,GACtD,OAAO,6CAA6C,GACpD,OAAO,sDAAsD,CAAC;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AA2GD,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,GAChB,yBAAyB,CAW3B;AAED,8EAA8E;AAC9E,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,GAChB,yBAAyB,CAc3B;AAED,0EAA0E;AAC1E,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,MAAM,GAChB,yBAAyB,CAc3B;AAED,kFAAkF;AAClF,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,GAChB,iCAAiC,CAMnC;AAED,4EAA4E;AAC5E,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,MAAM,GAChB,iCAAiC,CAMnC;AAED,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,MAAM,GAChB,iCAAiC,CAMnC"}

package/dist/workspace-fingerprint.js

@@ -20,6 +20,11 @@ const LEGACY_DEPLOYMENT_INPUT_ROOTS = new Set([
 const DEPLOYMENT_INPUT_ROOTS = new Set([
     ...LEGACY_DEPLOYMENT_INPUT_ROOTS,
     'README.md',
+    'server',
+    'agent-tools.json',
+    'package.json',
+    'package-lock.json',
+    'base-app.config.ts',
 ]);
 const EXCLUDED_DIRECTORIES = new Set([
     '.base-database-cli',

package/dist/workspace-fingerprint.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-fingerprint.js","sourceRoot":"","sources":["../src/workspace-fingerprint.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workspace-fingerprint.js","sourceRoot":"","sources":["../src/workspace-fingerprint.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-base-open/base-database-cli",
-  "version": "1.4.0",
+  "version": "1.4.3",
   "description": "CLI and Agent Skill for building database applications on Lark Base.",
   "type": "module",
   "bin": {
@@ -8,13 +8,16 @@
   },
   "files": [
     "dist",
+    "data/*.json",
+    "data/template-index-html/*.html",
     "config-schema.json",
     "skills/lark-base-database/SKILL.md",
     "skills/lark-base-database/references",
     "templates",
     "README.md",
     "CHANGELOG.md",
-    "changelog"
+    "changelog",
+    "THIRD_PARTY_LICENSES.json"
   ],
   "publishConfig": {
     "access": "public"
@@ -23,35 +26,44 @@
     "node": ">=20.19.0"
   },
   "scripts": {
-    "build": "node scripts/clean.mjs && tsc -p tsconfig.json",
+    "build": "node scripts/clean.mjs && tsc -p tsconfig.json && node scripts/copy-builder-version.mjs",
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\" \"scripts/**/*.{js,mjs,ts,tsx}\" \"templates/**/*.{js,mjs,ts,tsx}\"",
     "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\" \"scripts/**/*.{js,mjs,ts,tsx}\" \"templates/**/*.{js,mjs,ts,tsx}\"",
     "check": "tsc -p tsconfig.json --noEmit",
     "validate": "pnpm format:check && pnpm check && node scripts/validate.mjs",
-    "test": "tsx --test test/**/*.test.ts && npm run test:behavior-harness",
+    "test": "node scripts/sync-builder.mjs --check && node scripts/sync-development-pairing.mjs --check && node scripts/check-template-hmr.mjs && node --test scripts/skill-review/*.test.mjs && tsx --test --test-concurrency=4 test/**/*.test.ts && npm run test:behavior-harness",
     "install:skill": "pnpm build && node dist/cli.js skill install",
     "prepack": "pnpm build && pnpm validate && pnpm test && pnpm validate:starter-dependencies",
     "validate:starter-dependencies": "node scripts/check-starter-dependencies.mjs",
     "test:behavior-harness": "node scripts/skill-behavior-eval/run-tests.mjs"
   },
   "dependencies": {
+    "@babel/parser": "7.28.5",
+    "@babel/traverse": "7.28.5",
     "ajv": "8.17.1",
     "archiver": "8.0.0",
     "commander": "14.0.3",
     "crc-32": "1.2.2",
+    "esbuild": "0.28.2",
     "jsonc-parser": "3.3.1",
     "npm": "10.9.2",
+    "parse5": "7.3.0",
     "re2js": "2.8.6",
     "semver": "7.7.3",
+    "yaml": "2.9.1",
     "yauzl": "3.2.0"
   },
   "devDependencies": {
     "@types/archiver": "8.0.0",
+    "@types/babel__traverse": "7.28.0",
     "@types/node": "24.1.0",
     "@types/semver": "7.7.1",
     "@types/yauzl": "2.10.3",
+    "json-schema-to-typescript": "16.0.0",
     "prettier": "3.6.2",
     "tsx": "4.23.1",
-    "typescript": "7.0.2"
+    "typescript": "7.0.2",
+    "vite": "8.1.4",
+    "zod": "4.6.5"
   }
 }

package/skills/lark-base-database/SKILL.md

@@ -1,40 +1,29 @@
 ---
 name: lark-base-database
-description: 使用飞书多维表格作为业务数据后端，创建、修改、恢复、发布、验收或排查 Base Database 业务系统。适用于 Base Database 的 Page、Database Function、Mutation、FaaS 和原生 Base 集成；仅操作多维表格资源时使用 lark-base。
+description: 以飞书多维表格为业务数据后端，规划、搭建、修改、恢复、发布、验收或排查带页面与业务逻辑的 Base Database 网站、工作台或管理系统；支持从零或基于已有 Base 建站。仅管理多维表格的表、字段、记录、视图时使用 lark-base。
 metadata:
-  compatibility: 需要 Node.js 20.19+、npm/npx、lark-cli 及目标平台访问权限；优先使用本机安装的 Base Database CLI，托管环境使用宿主提供的 CLI。
+  compatibility: CLI/存量 classic 需要 Node.js 20.19+；新建 workspace 与契约生成需要 Node.js 22+；需要 npm/npx、lark-cli 及目标平台访问权限；优先使用本机安装的 Base Database CLI。
 ---
 
 # Lark Base Database
 
 将业务需求实现为基于真实 Base 数据、可维护且可验证的应用。先选择任务路径，再读取所需协议；不要在任务开始时读取全部 reference。同一文件在首次进入相关阶段时读取，内容或任务范围变化后再补读。
 
-CLI 使用 `--app-token`、配置字段 `appToken`、`base-database.jsonc` 和 `.base-database-cli/state/`，不读取旧配置或旧状态，不接受旧参数。服务端 `/sites/` 路径、SDK 的 `siteToken` 和宿主 `BASE_SITE_BUILDER_*` 环境变量保持原协议；将宿主提供的应用 token 传给 `--app-token`，不改造外部协议。
+本 Skill 面向开发者 Agent，用于搭建、修改和发布应用；`skill install` 安装这份随 CLI 分发的开发者 Skill。让外部 Agent 使用某个已发布站点的业务功能时，使用 `agent-tools skill install` 安装该站点的 Skill，见[外部 Agent 工具策略](references/agent-tools.md#安装到本地-agent)。
+
+新建 init 仅生成 workspace；存量 classic 的 SDK 接入和工程迁移按[工程与环境](references/workspace.md)与[Page 开发](references/development.md)执行。工程迁移按[迁移指南](references/workspace-migration.md)由 coding agent 执行；`dev` 仅在用户选择时使用。
 
 账号选择遵守[工程与环境的 profile 约定](references/workspace.md#账号选择)；直接调用原生 lark-cli 时也使用同一个 profile。
 `lark-cli` 的账号管理和文档命令按环境提供，不是所有宿主的必备能力；首次选择入口及缺少命令时按[环境与依赖](references/workspace.md#环境与依赖)处理。
 
-### 首次使用前的环境准备
-
-本地公开环境首次使用时，先确认依赖再进入任务路由；托管环境使用宿主已提供的 CLI 与凭证，跳过本节。
-
-1. 确认 `lark-cli` 与 `base-database-cli` 都可执行；任一缺失时按[环境与依赖](references/workspace.md#环境与依赖)中的安装命令或回退入口处理，不猜测包名或全盘搜索。
-2. 执行 `base-database-cli doctor`。返回未配置或未登录（`not_configured`、`token_missing`、`need_user_authorization`）时执行 `base-database-cli auth login`，由用户在浏览器完成授权后重新执行 `doctor`；`ok` 为 `true` 后再执行 `init`。`init`、`pull` 不会自动触发登录。
-
-### Base Database 权限不足时重新授权
-
-CLI 明确报告 `app_scope_not_applied`、`missing_scopes` 等 scope 权限不足错误时，向用户说明原因，并使用本任务已选定的 CLI 入口和同一 profile 执行 `base-database-cli auth login`，申请构建应用所需的权限。若错误另有应用权限开通或额外 scope 的处理要求，按错误提示处理。用户完成授权后只重试原命令一次；仍失败时停止并保留原错误，不循环授权。其他错误按其原因处理。AI Function 管理命令或 `deploy` 返回 `800004011`（`ai function feature is not enabled`）不是 scope 问题，`auth login` 无效；按[未开通 AI Function](references/ai-function.md#未开通-ai-function-时) 降级处理。
-
-### 公开 CLI 版本预检
-
-本地使用 `@lark-base-open/base-database-cli` 时，在本会话首次业务操作前按[工程与环境](references/workspace.md#公开-cli-版本预检)确认入口与版本；托管 Builder 和 CI 跳过。预检失败或旧 CLI 不支持时继续当前任务，升级及覆盖 Skill 须取得相应授权。
+开始前：本地公开环境首次使用时，按[环境与依赖](references/workspace.md#环境与依赖)确认 CLI、登录和版本。命令报告认证或 scope 错误时，按[认证与重新授权](references/workspace.md#认证与重新授权)处理，授权后只重试原命令一次。
 
 ## 任务路由
 
 | 用户任务                 | 执行路径                                                           | 主要命令                                                  | 进入阶段前读取                                                                            |
 | ------------------------ | ------------------------------------------------------------------ | --------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
 | 新建系统                 | 明确需求与访问模型 → 确定 Base 来源 → 初始化 → 开发 → Preview 交付 | `init` → `deploy`                                         | [工程与环境](references/workspace.md)、[权限设计](references/permission-design.md)        |
-| 修改已有系统             | 确认现有工程 → 判断影响范围 → 增量修改 → 验证与交付                | 按影响范围修改，必要时 `deploy`                           | [工程与环境](references/workspace.md)，再读取受影响的协议                                 |
+| 修改已有系统             | 确认现有工程 → 判断影响范围 → 增量修改 → 验证与交付                | 按影响范围修改，必要时 `deploy`                           | [增量修改与追加绑定](references/workspace.md#增量修改与追加绑定)，再读取受影响的协议                                 |
 | 恢复远端工程             | 确认本地状态和应用 → 恢复源码与 Catalog → 继续原任务              | 按来源选择 `pull` 或 `init`                               | [工程与环境](references/workspace.md)                                                     |
 | 设计或评审               | 按评审范围分析并输出，不创建资源或发布                             | 只读分析                                                  | [工程质量](references/style-guide.md)，涉及权限、查询或视觉时读取对应专项                 |
 | 排查故障                 | 收集证据 → 定位失败阶段 → 按用户要求诊断或修复                     | `deployments status`、`doctor` 或项目级 `lark-cli -- ...` | [诊断与验收](references/verification.md)，再读取失败链路的协议                            |
@@ -42,22 +31,25 @@ CLI 明确报告 `app_scope_not_applied`、`missing_scopes` 等 scope 权限不
 | 专项验收                 | 确定检查范围 → 执行已授权检查 → 报告证据与未验证项                 | 按契约调用 Database Function 或执行已授权检查                           | [诊断与验收](references/verification.md)                                                  |
 | 发布当前工程或已验证版本 | 检查工程、制品及授权 → 发布 → 必要收尾 → 交付                      | `deploy`；确认后 `deploy --production --yes`              | [发布与交付](references/release.md)                                                       |
 
-表格和 references 的示例默认使用本机 `base-database-cli`；需要回退时只替换命令前缀，保留其余参数。托管环境使用宿主 CLI。完整参数见对应 reference。
+表格和 references 的示例默认使用本机 `base-database-cli`；需要回退时只替换命令前缀，保留其余参数。完整参数见对应 reference。
 
 新建默认创建 Base；用户明确指定已有 Base 时复用，不额外询问数据来源选择题。只有目标资源、数据所有权、权限或核心流程存在实质歧义时才询问。用户提供的工程、技术选择和已明确授权在后续步骤中持续有效。
 
 ## 开发阶段路由
 
-新增或修改 Database Function、Mutation、FaaS 时，按[函数能力描述](references/database-function.md#函数能力描述)维护可供站点助手发现的用途与调用影响。
+新增或修改 Database Function、Mutation、FaaS 时，先按[面向 Agent 的函数与参数设计](references/agent-tool-design.md)写函数说明和参数声明（`name`、`description`、可选 `enum`），使[外部 Agent](#术语) 能选对函数并填对参数；按[外部 Agent 工具策略](references/agent-tools.md)确定需要排除的内部函数。
 
 | 需要完成的工作                                        | 必读协议                                                                                |
 | ----------------------------------------------------- | --------------------------------------------------------------------------------------- |
 | 首次实现页面、整体视觉改版或视觉评审                  | [前端设计指南](references/frontend-design-guide.md)     |
 | 修改布局、颜色、排版或控件样式                        | 上述设计指导的相关章节，沿用现有设计系统；与视觉无关的修改不重读                        |
-| Page runtime、组件接入或 Function 调用                | [Page 开发](references/development.md)                                                  |
+| 本地 dev、Page runtime、组件接入或 Function 调用                | [Page 开发](references/development.md)；执行 dev 前须安装 SDK 且页面入口经 `startBaseApp` 启动，classic 旧工程先按该 reference 接入 SDK |
 | AI 对话、生成、分类、总结、文生图、文生视频或模型调用 | [AI Function](references/ai-function.md)，并结合 [Page 开发](references/development.md) |
 | AI Function 使用本地图片或 Base 附件作为参考图       | 同时读取 [AI Function](references/ai-function.md) 与 [文件传输](references/file-transfer.md)，先得到模型可访问的 URL 或 Data URL，再传入 `input.image` |
 | Database Function 查询、参数和结果解析                              | [Database Function](references/database-function.md)                                              |
+| 函数说明、参数 `name`/`description`/`enum` 声明，或处理 `functionHints` | [面向 Agent 的函数与参数设计](references/agent-tool-design.md) |
+| 通过 `lark-cli api` 发现、读取说明或调用已发布函数 | [调用站点函数](references/agent-tools.md#调用站点函数) |
+| 决定哪些函数不向外部 Agent 开放，或修改 `agent-tools.json` | [外部 Agent 工具策略](references/agent-tools.md) |
 | 日期表单、到期日、事件时间或时间筛选                  | [日期与时区](references/development.md#日期与时区)                                      |
 | 判断查询支持集之外的形态或处理兼容错误               | [查询能力边界](references/database-function-limitations.md)                                      |
 | FaaS 引用自定义环境变量，或用户要求查询、配置环境变量或第三方凭证            | [第三方 Agent 环境变量](references/environment-variables.md)                           |
@@ -71,33 +63,16 @@ CLI 明确报告 `app_scope_not_applied`、`missing_scopes` 等 scope 权限不
 
 新建或整体改版先在内部规划中确定视觉方案，再实现设计变量和组件。业务建模与通用工程取舍按[工程质量](references/style-guide.md)执行；默认不创建额外设计文件。新建站点或修改业务能力时，按[站点 README](references/release.md#站点-readme)维护随源码制品上传的项目说明；用户要求其他文档时按要求交付。
 
-AI 能力路由统一使用版本化托管的 AI Function。Page 从 `database-runtime` 导入 `callSiteAIFunction` 或 `invokeSiteAIFunctionStream`，并按 [AI Function](references/ai-function.md) 的能力类型选择聚合、流式或媒体任务调用。
-
-需要模型参与当前页面业务流程时，AI Function 是默认选择。例如点餐系统根据口味、预算、用餐人数和菜单生成点餐推荐，应建模为 AI Function，不创建 FaaS 模型代理。
-
-**AI Function 是按需可选能力，不是建站或发布的前置条件。** 用户需求未涉及 AI 对话、生成、分类、总结、文生图或文生视频时，不创建 `ai/` 目录、不调用任何 `ai-functions` 命令，也不要求或提示用户开通 AI 能力；普通 `deploy` 在空 `ai/` 时自动跳过 AI Function 同步，Page/Database Function/FaaS 照常发布，不因此阻塞。
-
-远端 AI Function 的恢复与保护由 CLI 完成，不需要 Agent 判断：`pull` 会把远端 AI Function 草稿写回 `ai/`（当前账号未开通时不落 `ai/`）；`deploy` 时空 `ai/` 会跳过 AI Function 同步（`no_local_ai_functions`），本地全集非空时先核对远端已有 key 都在本地，缺任何一个就拒绝发布而不是静默删除，通过后按全量覆盖写入草稿；需要让本次 deploy 完全跳过 AI Function 同步时使用显式参数 `deploy --skip-ai-functions`，并按[诊断与验收](references/verification.md)在报告中说明 AI Function 未同步、未验证。`ai-functions sync` 不管本地是否为空都立即全量覆盖，因此显式 `sync` 空集合会把远端 AI Function 全部删除。创建、配置、调用、调试 AI Function 的完整流程见 [AI Function](references/ai-function.md)。
-
-### 增量绑定新 Table
-
-修改已有应用时需要使用当前已绑定 Base 中的新 Table，不重新执行 `init` 或 `pull`。先用 `lark-cli base +table-list/get` 的真实返回取得 Table ID，再在项目根目录执行：
-
-```bash
-base-database-cli lark-cli -- api POST /open-apis/base/v3/sites/Prjxxxxxxxx/bind_base --data '{"baseToken":"basxxxxxxxx","tableIds":["tbl_new"]}' --json
-base-database-cli lark-cli -- api GET /open-apis/base/v3/sites/Prjxxxxxxxx/catalog --json
-```
-
-`bind_base` 只向同一 Base 追加并去重 Table ID，不覆盖原绑定。成功后把 Catalog 返回 envelope 的 `data` 对象写入 `catalog.json`，并在 `base-database.jsonc` 保留原 binding 的前提下把新 ID 合并进 `tableIds`。删除本地 Table ID 不会触发远程解绑；解绑须另行调用 unbind 接口并先取得用户授权。
+恢复已有 AI Function 时先读[恢复协议](references/ai-function.md#恢复已有-ai-function)，配置与调用按[AI Function](references/ai-function.md)执行。AI 与其他函数的发布顺序、skip 行为、显式 sync 的删除边界及失败恢复统一见[发布参考](references/release.md#function-发布顺序与错误边界)。
 
 ## 关键约束
 
-1. 应用资源与发布优先使用本机 `base-database-cli`；原生 Base 配置使用 `lark-cli base +...`。托管环境使用宿主提供的 CLI，不切换环境。命令选择与工程恢复见[工程与环境](references/workspace.md)。
+1. 应用资源与发布优先使用本机 `base-database-cli`；原生 Base 配置使用 `lark-cli base +...`。命令选择与工程恢复见[工程与环境](references/workspace.md)。
 2. Base 是业务数据事实源，`catalog.json` 是已绑定表的 schema 事实源。表、字段、ID、类型、选项和关系来自真实结果，不由名称或建模输入猜测。
-3. **权限边界**：应用以 owner 身份访问 Base。访问者通过已发布 Function 使用业务能力；浏览器直接记录 CRUD 已关闭，固定写入由 Mutation 声明约束。FaaS ticket 内部记录回调保留兼容，需单独约束其输入。读取身份通过 Database Function 中的 `CURRENT_USER_ID()` 获取，Mutation 使用服务端 `current_user`。自定义角色和统一行列权限尚未接入。绑定与权限设计必须遵守[权限边界](references/permission-design.md)。
-4. Page 读取走 Database Function；普通单表创建、按记录 ID 更新和删除（含批量及附件写入）优先使用 Mutation；需要声明之外的服务端业务校验、计算或编排时使用 FaaS，边界见[写入方式选择](references/mutations.md#写入方式选择)。Database Function 必须引用至少一个已绑定 Catalog 真实表；纯常量与无表依赖计算按[SQL 外实现放在哪](#sql-外实现放在哪)选择位置。输入只能进入声明的业务参数，不能决定查询语句、URL、method、Base token、table ID、字段名、Function ID 或凭证。
+3. **权限边界**：应用以 owner 身份访问 Base。访问者通过已发布 Function 使用业务能力；浏览器直接记录 CRUD 已关闭，固定写入由 Mutation 声明约束。FaaS 通过[固定记录写入路由](references/faas.md#应用记录写入协议)写入，不受 Mutation 声明约束，须在 FaaS 内校验输入与调用者身份。读取身份通过 Database Function 中的 `CURRENT_USER_ID()` 获取，Mutation 使用服务端 `current_user`。自定义角色和统一行列权限尚未接入。绑定与权限设计必须遵守[权限边界](references/permission-design.md)。
+4. Page 读取走 Database Function；普通单表创建、按记录 ID 更新和删除（含批量及附件写入）优先使用 Mutation；需要声明之外的服务端业务校验、计算或编排时使用 FaaS，边界见[写入方式选择](references/mutations.md#写入方式选择)。Database Function 必须引用至少一个已绑定 Catalog 真实表；纯常量与无表依赖计算按[SQL 外实现放在哪](references/database-function-limitations.md#sql-外实现放在哪)选择位置。SQL 无法表达的计算，不得把查看者无权看到的明细发给 Page 处理，拿不准时放 FaaS。输入只能进入声明的业务参数，不能决定查询语句、URL、method、Base token、table ID、字段名、Function ID 或凭证。
 5. Database Function、Mutation 与 FaaS 的参数、返回值不同。Page 使用 `invokeDatabaseFunction<TData>`，`TData` 只描述顶层 `data`，不二次解包；协议见[Page 开发](references/development.md#function-调用契约)。部分成功与重试按 [Mutation 结果](references/mutations.md#调用与结果)或 [FaaS 记录协议](references/faas.md#应用记录写入协议)处理。
-6. AI 对话、生成、分类、总结、文生图或文生视频使用 Page 侧 AI Function 调用平台 AI 能力，不创建 FaaS 模型代理，不直连模型域名；需求不涉及 AI 时不创建 AI Function、不调用 AI 接口，也不把 AI Function 开通作为前置条件。完整契约见[AI Function](references/ai-function.md)。
+6. AI 对话、生成、分类、总结、文生图或文生视频，使用 Page 侧 AI Function，不建 FaaS 模型代理、不直连模型域名。AI 是按需能力：需求不涉及时不创建 `ai/`、不调用 `ai-functions` 命令，也不提示用户开通。详见 [AI Function](references/ai-function.md)。
 7. 修改保留需求外源码、Base schema、metadata、bindings 和 Function。Functions 更新为全量覆盖，不能以只提交本次新增 Function 的方式更新已有应用。
 8. 保留 starter 的 ready 上报及宿主组件接入。附件能力取决于目标环境的父页面、所选写入方式和服务端协议；按[文件传输](references/file-transfer.md)实现，不以模拟成功代替真实能力。
 9. 第三方 npm 依赖必须使用目标应用的服务端依赖策略判断；普通 registry 版本默认可用，受限来源只有被 `allowedValues` 中某条正则完整匹配时可用。详见[第三方依赖策略](references/development.md#第三方依赖策略)。
@@ -123,21 +98,12 @@ workflow 启停及失败补偿按[通知集成](references/notifications.md#状
 - **部分完成**：已有成果可交付，但存在已知功能缺失、违反需求的实现、平台不支持的要求，或约定验证、外部配置未完成；即使 Preview 发布成功，也逐项列出缺口。
 - **阻塞**：必需步骤受认证、权限、平台能力或缺失输入等外部条件限制，记录阻塞及恢复条件。
 
-默认交付访问链接、业务变更、体验步骤、实际验证结果和影响使用的限制。仅使用发布命令返回的顶层 `baseAppUrl` 作为应用访问入口；不猜测地址或展示内部静态资源 `staticUrl`。技术清单与诊断信息按研发、排障或审计需要提供；不输出凭证，也不要求普通业务用户检查协议字段。
+默认按[交付结果](references/release.md#交付结果)提供访问链接、业务变更、体验步骤、实际验证结果和影响使用的限制；有开放函数时一并介绍本地 Agent 业务用法与站点 Skill 安装方式。仅使用发布命令返回的顶层 `baseAppUrl` 作为应用访问入口；不猜测地址或展示内部静态资源 `staticUrl`。技术清单与诊断信息按研发、排障或审计需要提供；不输出凭证，也不要求普通业务用户检查协议字段。
 
 ## 术语
 
 - **Database Function**：通过固定查询语句读取 Base 数据的函数；查询定义位于 `database-functions/<functionId>/main.sql`。
-- **应用 appToken**：应用标识；协议字段 `appToken`、FaaS 的 `projectId` 与示例中的工程常量 `PROJECT_ID` 在相应入口指向该应用，不是 Base token。`PROJECT_ID` 由示例调用方定义，不是 starter 提供的标识。
+- **应用 appToken**：应用标识；协议字段 `appToken`、FaaS 的 `projectId` 与示例中的工程常量 `PROJECT_ID` 在相应入口指向该应用，不是 Base token。`PROJECT_ID` 由示例调用方定义，不是 starter 提供的标识。服务端路径 `/sites/<app-token>`、SDK 的 `siteToken` 都指同一个应用 token，原样使用，不改写外部协议。
 - **Catalog**：已绑定数据表的 schema；本地快照为 `catalog.json`，更新从应用 catalog 接口获取。Base 的业务记录不保存在 Catalog。
 - **operation**：业务动作及其固定输入输出契约，例如查询任务或审批申请；不是任意 URL 或查询语句的代理。
-- **托管环境**：平台提供 CLI、登录态或工程的建站环境；使用其已提供的入口。自行安装 CLI 的本地环境按公开安装流程执行。
-
-
-## SQL 外实现放在哪
-
-原则：SQL 无法等价表达时，在消费查询结果的代码中完成计算；选择位置首先看数据可见性，再看规模与复用需求。
-
-判定：只有计算仅影响查看者本就有权看到的行的展示、结果集小且无需跨页面复用时，才适合放在 Page。若计算需要查看者不应看到的明细、数据量大、需要跨页面复用或写回，则放在 FaaS（SQL 报错中的 “Edge Function” 即指 FaaS），并沿用既有身份、权限和参数边界；FaaS 仍需在服务端校验调用者权限，只返回允许公开的结果。不能先把无权查看的明细发给浏览器，再靠 Page 过滤或隐藏。
-
-默认：拿不准时选 FaaS。把应在服务端处理的计算放到 Page，可能泄露数据；多一道服务端调用通常更容易纠正。SQL 报错中的“SQL 外实现”不等于一律新建 FaaS，也不构成绕过现有权限模型的授权。
+- **外部 Agent**：不经过页面、通过 `lark-cli api` 发现并调用本站点已发布函数的 Agent，例如站点成员在对话或本地 Agent 中使用的助手。它看不到页面源码，只依据函数的 `name`、`description` 和服务端生成的参数说明判断何时调用、如何传参。