@lark-base-open/base-database-cli 1.1.0 → 1.3.7

package/templates/database-starter/page/src/lib/date-time.ts

@@ -0,0 +1,61 @@
+/** 将时间点投影到显式指定的业务时区，不使用浏览器或服务器默认时区。 */
+function zonedParts(epochMs: number, timeZone: string) {
+  if (
+    !Number.isFinite(epochMs) ||
+    !Number.isFinite(new Date(epochMs).getTime())
+  ) {
+    throw new RangeError('Expected a valid Unix timestamp in milliseconds')
+  }
+  if (!timeZone || timeZone.trim() !== timeZone) {
+    throw new RangeError('An explicit business time zone is required')
+  }
+  const formatter = new Intl.DateTimeFormat('en-US', {
+    timeZone,
+    calendar: 'gregory',
+    numberingSystem: 'latn',
+    era: 'short',
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hourCycle: 'h23',
+  })
+  const parts = formatter.formatToParts(new Date(epochMs))
+  const get = (type: Intl.DateTimeFormatPartTypes) =>
+    parts.find((part) => part.type === type)!.value
+  if (get('era') !== 'AD' || Number(get('year')) > 9999) {
+    throw new RangeError('Expected a calendar year between 0001 and 9999')
+  }
+  return {
+    date: `${get('year').padStart(4, '0')}-${get('month')}-${get('day')}`,
+    time: `${get('hour')}:${get('minute')}:${get('second')}`,
+  }
+}
+
+/** TIMESTAMP → date input；空值由表单显式处理，不转换成今天。 */
+export function formatDateInput(epochMs: number, timeZone: string): string {
+  return zonedParts(epochMs, timeZone).date
+}
+
+/** 时间点 → 指定时区的无偏移文本；写入方必须使用同一时区解析。 */
+export function formatBaseDateTime(epochMs: number, timeZone: string): string {
+  const { date, time } = zonedParts(epochMs, timeZone)
+  return `${date} ${time}`
+}
+
+/** 日历日期 → Base 日期字段文本；不经 Date 解析或时区偏移。 */
+export function dateInputToBaseDateTime(value: string): string {
+  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value)
+  if (!match) throw new RangeError('Expected a calendar date: YYYY-MM-DD')
+  const year = Number(match[1])
+  const month = Number(match[2])
+  const day = Number(match[3])
+  const leap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0)
+  const days = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
+  if (year < 1 || month < 1 || month > 12 || day < 1 || day > days[month - 1]) {
+    throw new RangeError('Invalid calendar date')
+  }
+  return `${value} 00:00:00`
+}

package/templates/database-starter/page/src/lib/ui-language.ts

@@ -0,0 +1,86 @@
+import { useEffect, useSyncExternalStore } from 'react'
+
+import { siteRuntime } from './database-runtime'
+
+const LANGUAGES = [
+  { id: 'en', locale: 'en-US', match: /^en(?:-|$)/ },
+  { id: 'zh', locale: 'zh-CN', match: /^zh(?:-|$)/ },
+  { id: 'ja', locale: 'ja-JP', match: /^ja(?:-|$)/ },
+] as const
+
+export type UiLanguage = (typeof LANGUAGES)[number]['id']
+
+const listeners = new Set<() => void>()
+let hostLanguage: UiLanguage | undefined
+let hostLanguageRequest: Promise<UiLanguage> | null = null
+
+function supportedLanguage(locale: unknown): UiLanguage | undefined {
+  if (typeof locale !== 'string') return undefined
+  const normalized = locale.trim().replace(/_/g, '-').toLowerCase()
+  return LANGUAGES.find(({ match }) => match.test(normalized))?.id
+}
+
+function browserLocale(): string | undefined {
+  return typeof navigator === 'undefined' ? undefined : navigator.language
+}
+
+/** Supported host locale wins; otherwise use the browser, then English. */
+export function selectUiLanguage(
+  hostLocale: unknown,
+  fallbackLocale: unknown,
+): UiLanguage {
+  return (
+    supportedLanguage(hostLocale) ?? supportedLanguage(fallbackLocale) ?? 'en'
+  )
+}
+
+export function getUiLanguage(): UiLanguage {
+  return hostLanguage ?? selectUiLanguage(undefined, browserLocale())
+}
+
+export function getUiLocale(language = getUiLanguage()): string {
+  return LANGUAGES.find(({ id }) => id === language)?.locale ?? 'en-US'
+}
+
+function subscribe(listener: () => void): () => void {
+  listeners.add(listener)
+  return () => listeners.delete(listener)
+}
+
+function applyHostLocale(locale: unknown): UiLanguage {
+  hostLanguage = supportedLanguage(locale)
+  const language = getUiLanguage()
+  setDocumentLanguage(language)
+  for (const listener of listeners) listener()
+  return language
+}
+
+function setDocumentLanguage(language: UiLanguage): void {
+  if (typeof document !== 'undefined') {
+    document.documentElement.lang = getUiLocale(language)
+  }
+}
+
+/** The Channel waits for the host handshake. All components share one request. */
+export function initializeUiLanguage(): Promise<UiLanguage> {
+  if (!hostLanguageRequest) {
+    setDocumentLanguage(getUiLanguage())
+    hostLanguageRequest = siteRuntime
+      .getRuntimeContext()
+      .then((context) => applyHostLocale(context?.locale))
+      .catch(() => applyHostLocale(undefined))
+  }
+  return hostLanguageRequest
+}
+
+export function useUiLanguage(): UiLanguage {
+  const language = useSyncExternalStore(
+    subscribe,
+    getUiLanguage,
+    () => 'en' as const,
+  )
+  useEffect(() => {
+    void initializeUiLanguage()
+  }, [])
+  return language
+}

package/templates/database-starter/page/src/main.tsx

@@ -12,7 +12,7 @@ function bootstrapDatabaseApp(): void {
   const rootElement = document.getElementById('root')
 
   if (!rootElement) {
-    throw new Error('未找到应用挂载节点 #root')
+    throw new Error('Application mount element #root was not found')
   }
 
   createRoot(rootElement).render(

package/templates/database-starter/page/tsconfig.json

@@ -1,9 +1,9 @@
 {
   "compilerOptions": {
     "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
-    "target": "ES2020",
+    "target": "ES2021",
     "useDefineForClassFields": true,
-    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "lib": ["ES2021", "DOM", "DOM.Iterable"],
     "module": "ESNext",
     "skipLibCheck": true,
     "moduleResolution": "bundler",

package/templates/database-starter/page/vite.config.ts

@@ -1,4 +1,3 @@
-import { createArgusCsrfPlugin } from '@lark-base-open/base-site-js/vite'
 import tailwindcss from '@tailwindcss/vite'
 import react from '@vitejs/plugin-react'
 import { defineConfig } from 'vite'
@@ -9,5 +8,5 @@ export default defineConfig({
   build: {
     sourcemap: false,
   },
-  plugins: [createArgusCsrfPlugin(), react(), tailwindcss()],
+  plugins: [react(), tailwindcss()],
 })

package/templates/database-starter/prettierignore

@@ -1 +1 @@
-sql/
+database-functions/

package/templates/database-starter/server-functions/README.md

@@ -1,6 +1,6 @@
 # Server Functions
 
-每个业务写入 operation 放在：
+This directory contains FaaS business actions. For new writes, choose the implementation using the installed Skill's `references/mutations.md#写入方式选择`. Place each FaaS action in:
 
 ```text
 functions/<functionId>/
@@ -8,4 +8,4 @@ functions/<functionId>/
 └── meta.json
 ```
 
-本目录是服务端 FaaS Functions 的源码与构建工作区，不是一个长期运行的服务。依赖与脚本以本目录 `package.json` 为准。Function ID、handler、`rawParams`、`context`、读写路径和返回结构见 `lark-base-database` Skill 的 `development.md`。
+This directory contains source and build files for server-side FaaS Functions; it is not a long-running service. Use this directory's `package.json` for dependencies and scripts. See the `lark-base-database` Skill's `references/faas.md` for Function IDs, handlers, `rawParams`, `context`, read and write paths, and response shapes.

package/templates/database-starter/server-functions/package-lock.json

@@ -10,7 +10,7 @@
       "devDependencies": {
         "@types/node": "^22.15.30",
         "oxlint": "^1.42.0",
-        "prettier": "^3.7.4",
+        "prettier": "3.6.2",
         "typescript": "~5.8.3",
         "vitest": "^4.1.0"
       }
@@ -1345,9 +1345,9 @@
       }
     },
     "node_modules/prettier": {
-      "version": "3.9.5",
-      "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.9.5.tgz",
-      "integrity": "sha512-/FVl766LpUfB5vXgCYOYa0MeV/441Ia99AeICQIQFTY/Nw0roZwULcXpku5i1/m5kt/baz+s4Zogspd839HSMg==",
+      "version": "3.6.2",
+      "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.6.2.tgz",
+      "integrity": "sha512-I7AIg5boAr5R0FFtJ6rCfD+LFsWHp81dolrFD8S79U9tb8Az2nGrJncnMSnys+bpQJfRUzqs9hnA81OAA3hCuQ==",
       "dev": true,
       "license": "MIT",
       "bin": {

package/templates/database-starter/server-functions/package.json

@@ -15,7 +15,7 @@
   "devDependencies": {
     "@types/node": "^22.15.30",
     "oxlint": "^1.42.0",
-    "prettier": "^3.7.4",
+    "prettier": "3.6.2",
     "typescript": "~5.8.3",
     "vitest": "^4.1.0"
   }

package/dist/agent-guide.d.ts

@@ -1,19 +0,0 @@
-import type { RuntimeProfile } from './environment.js';
-export declare function deploymentAgentGuide(appToken: string, target: 'preview' | 'prod', options: {
-    workspace: string;
-    profile: RuntimeProfile;
-    larkProfile?: string;
-}): {
-    target: 'prod';
-    availability: string;
-    skill: {
-        status: "installed" | "updated";
-        name: string;
-        path: string;
-    } | {
-        status: 'failed';
-        error: string;
-    };
-    message: string;
-};
-//# sourceMappingURL=agent-guide.d.ts.map

package/dist/agent-guide.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-guide.d.ts","sourceRoot":"","sources":["../src/agent-guide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,GAAG,MAAM,EAC1B,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;YAiBnE,MAAM;;;;;;;gBALJ,QAAQ;;;;EAgBrB"}

package/dist/agent-guide.js

@@ -1,31 +0,0 @@
-import { validatePageTitle } from './page-title.js';
-import { installDatabaseSkill } from './database-skill.js';
-// Runs only after successful publication; never discovers or invokes Functions.
-export function deploymentAgentGuide(appToken, target, options) {
-    let skill;
-    try {
-        skill = installDatabaseSkill({
-            appToken,
-            title: validatePageTitle(options.workspace),
-            profile: options.profile,
-            larkProfile: options.larkProfile,
-        });
-    }
-    catch (error) {
-        skill = {
-            status: 'failed',
-            error: error instanceof Error ? error.message : String(error),
-        };
-    }
-    return {
-        target: 'prod',
-        availability: target === 'prod'
-            ? '正式版发布成功；实际发现结果以服务端接口及开关状态为准，尚未自动验证。'
-            : '本次仅发布预览版；本应用 Skill 只发现正式版，不代表本次 Preview。不要因安装而额外发现或调用正式版能力；本次约定的 Preview 数据验证与通知收尾仍须完成。',
-        skill,
-        message: skill.status === 'failed'
-            ? '应用发布成功，但专属 Skill 安装失败；向用户报告原因，不要重新发布应用来修复安装。'
-            : `已${skill.status === 'installed' ? '安装' : '更新'}本应用 Skill。请告知用户可直接让 Agent 使用本应用能力，或使用 $${skill.name}；先确认安装路径属于目标客户端的发现目录，再按客户端方式刷新；仅重开会话不能修复目录不匹配。安装不代表业务操作授权。`,
-    };
-}
-//# sourceMappingURL=agent-guide.js.map

package/dist/agent-guide.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-guide.js","sourceRoot":"","sources":["../src/agent-guide.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,MAA0B,EAC1B,OAA6E;IAE7E,IAAI,KAAK,CAAC;IACV,IAAI,CAAC;QACH,KAAK,GAAG,oBAAoB,CAAC;YAC3B,QAAQ;YACR,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC;YAC3C,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,GAAG;YACN,MAAM,EAAE,QAAiB;YACzB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,MAAe;QACvB,YAAY,EACV,MAAM,KAAK,MAAM;YACf,CAAC,CAAC,qCAAqC;YACvC,CAAC,CAAC,yFAAyF;QAC/F,KAAK;QACL,OAAO,EACL,KAAK,CAAC,MAAM,KAAK,QAAQ;YACvB,CAAC,CAAC,8CAA8C;YAChD,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,0CAA0C,KAAK,CAAC,IAAI,4DAA4D;KACrK,CAAC;AACJ,CAAC"}

package/dist/database-skill.d.ts

@@ -1,24 +0,0 @@
-import type { RuntimeProfile } from './environment.js';
-export declare function databaseSkillName(token: string, environment: string, larkProfile?: string): string;
-export declare function databaseSkillCommandPrefix(profile: RuntimeProfile): string;
-export declare function renderDatabaseSkill(options: {
-    larkProfile?: string;
-    appToken: string;
-    title: string;
-    profile: RuntimeProfile;
-}): string;
-export declare function installDatabaseSkill(options: {
-    larkProfile?: string;
-    appToken: string;
-    title: string;
-    profile: RuntimeProfile;
-    directory?: string;
-}): {
-    status: "installed" | "updated";
-    name: string;
-    path: string;
-};
-export declare function discoveryArgs(appToken: string, pageSize: number, pageToken?: string): string[];
-export declare function invocationArgs(appToken: string, functionId: string, params: string): string[];
-export declare function runDatabaseSkillRequest(profile: RuntimeProfile, args: string[], larkProfile?: string): Promise<import("./types.js").CommandResult>;
-//# sourceMappingURL=database-skill.d.ts.map

package/dist/database-skill.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-skill.d.ts","sourceRoot":"","sources":["../src/database-skill.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AASvD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAWR;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAO1E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG,MAAM,CAoCT;AAoCD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;EAgCA;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,EAAE,CAgBV;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,MAAM,EAAE,CAgBV;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EAAE,EACd,WAAW,CAAC,EAAE,MAAM,+CASrB"}

package/dist/database-skill.js

@@ -1,151 +0,0 @@
-import { createHash, randomUUID } from 'node:crypto';
-import { lstatSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from 'node:fs';
-import { homedir } from 'node:os';
-import { join, resolve } from 'node:path';
-import { packageRoot } from './assets.js';
-import { runLarkCli, resolveLarkProfileEnvironment } from './lark-cli.js';
-import { validateLarkProfile } from './profile-name.js';
-function validateAppToken(token) {
-    if (!/^[A-Za-z0-9_-]{1,128}$/.test(token))
-        throw new Error('Invalid Application token');
-}
-export function databaseSkillName(token, environment, larkProfile) {
-    validateAppToken(token);
-    if (larkProfile !== undefined)
-        validateLarkProfile(larkProfile);
-    return `base-database-${createHash('sha256')
-        .update(JSON.stringify(larkProfile ? [environment, token, larkProfile] : [environment, token]))
-        .digest('hex')
-        .slice(0, 20)}`;
-}
-export function databaseSkillCommandPrefix(profile) {
-    if (!profile.deployCommand.endsWith(' deploy'))
-        throw new Error('Runtime profile has no CLI command prefix');
-    const command = profile.deployCommand.slice(0, -' deploy'.length);
-    return profile.name === 'online' && command === 'base-database-cli'
-        ? 'npx @lark-base-open/base-database-cli'
-        : command;
-}
-export function renderDatabaseSkill(options) {
-    const { appToken, profile } = options;
-    const name = databaseSkillName(appToken, profile.name, options.larkProfile);
-    if (!/^[a-z][a-z0-9-]*$/.test(profile.name))
-        throw new Error('Invalid runtime profile name');
-    const title = options.title.replace(/\s+/g, ' ').trim().slice(0, 200) || appToken;
-    const values = {
-        skill_name: name,
-        description_json: JSON.stringify(`当用户希望查询或操作“${title}”应用时使用。当前能力发现仅限应用所有者，通过实时 Function 发现和参数 Schema 使用该应用业务能力；不用于修改源码或部署。应用 ${appToken}，环境 ${profile.name}${options.larkProfile ? `，profile ${options.larkProfile}` : ''}。`),
-        app_token: appToken,
-        environment: profile.name,
-        command_prefix: databaseSkillCommandPrefix(profile),
-        profile_option: options.larkProfile
-            ? ` --profile '${options.larkProfile}'`
-            : '',
-        profile_guidance: options.larkProfile
-            ? `lark-cli profile 固定为 ${JSON.stringify(options.larkProfile)}；每条命令显式携带 --profile，不跟随默认账号。该 profile 必须在本机存在并已授权；缺失或凭证来源冲突时停止，不回退其他账号。`
-            : '本应用使用宿主提供的凭证上下文；不自动选择或创建本地 profile。',
-        managed_marker: databaseSkillMarker(appToken, profile.name, options.larkProfile),
-    };
-    return readFileSync(join(packageRoot, 'templates/database-capability/SKILL.md.tmpl'), 'utf8').replace(/\{\{([a-z_]+)\}\}/g, (_, key) => {
-        const value = values[key];
-        if (value === undefined)
-            throw new Error(`Unknown Skill template field: ${key}`);
-        return value;
-    });
-}
-function fileStat(path) {
-    try {
-        return lstatSync(path);
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return undefined;
-        throw error;
-    }
-}
-function assertManagedDirectory(directory, marker) {
-    const directoryStat = fileStat(directory);
-    if (!directoryStat)
-        return false;
-    if (!directoryStat.isDirectory() || directoryStat.isSymbolicLink()) {
-        throw new Error(`Refusing to replace non-directory or symlink: ${directory}`);
-    }
-    const path = join(directory, 'SKILL.md');
-    const existing = fileStat(path);
-    if (!existing) {
-        throw new Error(`Skill directory is not managed by Base Database CLI: ${directory}`);
-    }
-    if (!existing.isFile() ||
-        existing.isSymbolicLink() ||
-        !readFileSync(path, 'utf8').split('\n').includes(marker)) {
-        throw new Error(`Refusing to overwrite an unmanaged Skill: ${path}`);
-    }
-    return true;
-}
-export function installDatabaseSkill(options) {
-    const name = databaseSkillName(options.appToken, options.profile.name, options.larkProfile);
-    const root = resolve(options.directory ??
-        join(process.env.CODEX_HOME || join(homedir(), '.codex'), 'skills'));
-    const directory = join(root, name);
-    const path = join(directory, 'SKILL.md');
-    const content = renderDatabaseSkill(options);
-    const marker = databaseSkillMarker(options.appToken, options.profile.name, options.larkProfile);
-    const existing = assertManagedDirectory(directory, marker);
-    mkdirSync(directory, { recursive: true });
-    const temporary = join(directory, `.SKILL-${randomUUID()}.tmp`);
-    try {
-        writeFileSync(temporary, content, { flag: 'wx', mode: 0o600 });
-        renameSync(temporary, path);
-    }
-    finally {
-        if (fileStat(temporary))
-            unlinkSync(temporary);
-    }
-    return {
-        status: existing ? 'updated' : 'installed',
-        name,
-        path,
-    };
-}
-export function discoveryArgs(appToken, pageSize, pageToken) {
-    validateAppToken(appToken);
-    if (!Number.isSafeInteger(pageSize) || pageSize < 1)
-        throw new Error('page-size must be a positive integer');
-    return [
-        'api',
-        'GET',
-        `/open-apis/base/v3/sites/${appToken}/functions`,
-        '--params',
-        JSON.stringify({
-            pageSize,
-            ...(pageToken === undefined ? {} : { pageToken }),
-        }),
-        '--as',
-        'user',
-    ];
-}
-export function invocationArgs(appToken, functionId, params) {
-    validateAppToken(appToken);
-    if (!/^[A-Za-z0-9_-]{1,64}$/.test(functionId))
-        throw new Error('Invalid Function ID');
-    const value = JSON.parse(params);
-    return [
-        'api',
-        'POST',
-        `/open-apis/base/v3/sites/${appToken}/invoke_function/${functionId}`,
-        '--params',
-        '{"env":"prod"}',
-        '--data',
-        JSON.stringify({ params: value }),
-        '--as',
-        'user',
-    ];
-}
-export async function runDatabaseSkillRequest(profile, args, larkProfile) {
-    const { env } = resolveLarkProfileEnvironment(await profile.commandEnvironment(), larkProfile, undefined, profile);
-    return runLarkCli(args, env);
-}
-function databaseSkillMarker(appToken, environment, larkProfile) {
-    return `<!-- base-database-managed-skill:${environment}:${appToken}${larkProfile ? `:profile=${encodeURIComponent(larkProfile)}` : ''} -->`;
-}
-//# sourceMappingURL=database-skill.js.map

package/dist/database-skill.js.map

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

package/skills/lark-base-database/references/base-sql-unsupported.md

@@ -1,42 +0,0 @@
-# Base SQL 能力边界
-
-仅在判断支持集之外的 SQL 语法、评审或排查 SQL，或者处理 SQL 编译与运行兼容失败时读取。本文件是当前生成与兼容策略：明确不支持的协议不使用；“默认不生成”“支持不统一”属于保守生成边界，不据此声称平台整体不支持。已知限制正常开发直接遵守，只有版本或验证证据变化时复核。以下形态不写入常规 `main.sql`：
-
-## Stored Query 与分页
-
-- 参数 kind 不使用 `OPTION`；SingleSelect 选项名使用 `TEXT` 参数，并在 Page/FaaS 按 Catalog 选项白名单约束输入后用于 `=`、`!=`、`IN`、`NOT IN`。
-- 不把 `USER`、`GROUP`、`FILE`、数组或集合声明为正常业务参数；也不传 null 参数。
-- 不通过移除服务端筛选、读取固定前 N 条后在 Page 分页来声称完整分页或全量导出。业务确实需要任意翻页、完整搜索或全量导出时记录平台限制。
-
-## 查询结构与引用
-
-- 查询结构：`SELECT *`、`table.*`、`UNION`、`INTERSECT`、`EXCEPT`、`INSERT`、`UPDATE`、`DELETE`、`MERGE`、递归 CTE、嵌套 CTE，以及右侧会展开为多个 FROM item 的右深嵌套 JOIN。
-- 无真实表依赖查询：`SELECT 1`、`SELECT $1`、仅 `FROM (SELECT 1) AS x`、仅常量 CTE 或仅 `UNNEST(...)` 的查询。绑定 Base 的 SQL Function 必须直接或经由派生表/CTE 引用至少一个 Catalog 真实表，否则 Project 执行可能报“BaseSQL 上下文路由失败：SQL 未引用可路由表”。与 Base 数据无关的常量在 Page/FaaS 中用代码返回。
-- 分组：`GROUP BY` 超过 5 项；需要更多展示列时拆成聚合 SQL 与明细 SQL 后在 Page/FaaS 合并。
-- JOIN：`RIGHT JOIN`、`FULL JOIN`、`NATURAL JOIN`、`JOIN ... USING`、JOIN group alias、`LEFT JOIN UNNEST(...)`、`INNER JOIN UNNEST(...)`、含 `GROUP BY` 或聚合函数的派生表 JOIN，以及单条查询超过 16 个 JOIN。
-- 列引用：`table_alias.user_field.userId` 等三段引用；标量对象子字段只使用 `"人员字段".userId` 或 `UNNEST` 后的 `u.userId` 两段形式。
-- 派生对象：把 `USER`、`GROUP`、`FILE` 完整对象投影到派生表后再 JOIN。frontend 可能接受该形态，online backend 仍可能统一返回 `SQL is not supported`。
-
-## 类型、表达式与字段操作
-
-- 类型与表达式：`CURRENT_DATE`、`COALESCE`、`CASE expr WHEN value THEN ... END`、显式 `CAST` / Coerce，以及固定支持集之外的函数调用。
-- CASE：应该写 `CASE WHEN expr = value THEN ... ELSE ... END`；不要写 `CASE expr WHEN value THEN ... END`。
-- 条件聚合：不要写 `SUM/AVG(CASE WHEN ... THEN 1 ELSE 0 END)`；改用 `SUM(CASE WHEN ... THEN 1.0 ELSE 0.0 END)`。
-- `ILIKE`、`NOT ILIKE`：字段支持不统一，正常查询使用 `LIKE`、`NOT LIKE`。
-- 子查询表达式：投影、`WHERE` 或 `ORDER BY` 表达式里的标量子查询。用单独 SQL Function 查询聚合或明细，再在 Page/FaaS 合并。
-- 聚合与窗口函数：`STDDEV`、`VARIANCE`、`PERCENTILE`、`MEDIAN`、`ROW_NUMBER()`、`RANK()`。
-- 字符串函数：`SPLIT`、`SUBSTRING`、`REPLACE`、`POSITION`、`REGEXP` / `RLIKE`。
-- 数字函数：`POWER`、`SQRT`、`LOG`、`EXP`。
-- 日期函数：`DATEDIFF` 及其他未列入支持集的 DURATION 函数。
-- `rec_id`、`TEXT`、Phone：顺序比较、`BETWEEN`、`NOT BETWEEN`。文本日期字符串不能用 `<`、`<=`、`>`、`>=` 做范围筛选；需要日期范围时把字段建成 DateTime/TIMESTAMP，或改用 Text 支持的 `=`、`IN`、`LIKE` 后在 Page/FaaS 中判断范围。
-- Checkbox：`IN`、顺序比较、`BETWEEN`、`NOT BETWEEN`。
-- DateTime：`IN`、`NOT IN`、`LIKE`、`ILIKE`。
-- SingleSelect：顺序比较、`BETWEEN`、`NOT BETWEEN`、`LIKE`、`ILIKE`，以及与 `''` 空字符串比较；动态选项名筛选使用 `TEXT` 参数，不使用 `OPTION` 参数 kind。
-- MultiSelect：`LIKE`。
-
-## 不要误判为整体不支持
-
-- `LIKE $1` 本身可用，参数携带 `%`；历史复合查询失败主要来自 `OPTION` 参数 kind 或其他不支持节点，不要把参数化 `LIMIT/OFFSET` 误判为 backend 不支持。
-- OPTION 字段可以与 Catalog 中合法的固定选项名或 `TEXT` 参数使用 `=`、`!=`、`IN`、`NOT IN` 比较；不支持的是 Stored Query 的 `OPTION` 参数 kind。
-- 参数化 `LIMIT $n` / `OFFSET $n` 可用；页面输入不能直接决定返回规模，确需动态条数时由 Page/FaaS 先校验为非负整数并限制最大值。
-- 支持集内的 `CASE WHEN ... THEN ... END`、`INNER JOIN`、`LEFT JOIN`、`CROSS JOIN`、非递归顶层 CTE、派生标量列、`FROM` 子查询、逗号连接或 `CROSS JOIN` 形态的 `UNNEST`、`TIMESTAMP` 字面量、`INTERVAL`、`EXTRACT`、DURATION 运算、`ARRAY_AGG`、`CEIL` 和 `FLOOR` 可以使用；某个复合查询失败时先按错误节点缩小，不把这些能力整体降级。

package/skills/lark-base-database/references/database-capability-skill.md

@@ -1,40 +0,0 @@
-# 应用能力 Skill
-
-本应用 Skill 用于在后续会话中发现并调用已发布的正式版 Function，不依赖建站工程。生成文件仅保存应用、环境与 profile 定位、发现及调用流程，不缓存 Function 列表或参数 Schema，不包含凭证、源码或工程绝对路径。当前发现范围仅限 应用所有者；安装成功不证明接口已开通或当前用户有访问权限。
-
-## 安装与恢复
-
-普通 `deploy` 在本次 Preview / Prod 轮询成功后自动安装或更新本地 Skill；安装结果在 `agentGuide.skill`。按实际证据交付：
-
-| 返回状态 | 可报告的结果 | 后续动作 |
-| --- | --- | --- |
-| `installed` / `updated` | 本地安装成功，附 `name`、`path` | 核对目标客户端的发现目录，再按客户端方式刷新 |
-| `failed` | 应用发布成功，但 Skill 安装失败 | 说明 `error`，处理目录权限或冲突；此分支没有 `name`、`path` |
-| 仅通过 `deployments status` 查询或恢复发布成功 | 发布成功，Skill 安装状态未确认 | 不假定安装成功；需要时显式安装 |
-
-`deployments status`（包括 `--wait`）只查询发布任务并按需恢复回执，不安装 Skill，也不返回 `agentGuide`。补装不需要再次 deploy。使用发布结果中的真实 应用 appToken 和已确认的应用名称：
-
-```bash
-npx @lark-base-open/base-database-cli --profile <profile-name> database-skill install --app-token <app-token> --title '<应用名称>'
-```
-
-此操作通过 `lark-cli config show` 读取所选账号的本地元信息，再安装 Skill，不发布应用、不调用远端、不更改授权。安装器仅更新带有相同应用/环境/profile 管理标记的 `SKILL.md`；无管理标记的文件、同名目录或符号链接冲突会报错。报告冲突路径，不删除用户文件来强行安装。
-
-默认安装到 `$CODEX_HOME/skills`，未配置时使用 `~/.codex/skills`。其他客户端可通过 `--dir <skills-root>` 指定其实际技能目录，但先确认目标路径可写且被客户端发现。不能由“文件已写入”推断“当前 Agent 已加载”；目录正确时才尝试客户端支持的刷新或重开会话。受管沙箱可能使用另一发现目录或只读技能目录，不能为安装擅自修改其全局配置或权限。
-
-跨设备使用须在目标设备安装对应 CLI 和 Skill，并完成该环境的用户登录。沙箱内安装不等于用户电脑已安装；不能通过拷贝凭证完成迁移。
-
-独立 `database-skill` 命令不读取项目配置，修复安装时显式传入部署使用的 profile。发现与调用固定该 profile，不跟随默认账号变化；宿主提供凭证且未选择 profile 时保持宿主凭证模式，不写入本地 profile。跨设备须配置并授权同名 profile；缺失或与注入凭证冲突时停止，不回退其他账号。
-
-## 发现与调用
-
-后续命令可在任意目录执行；环境由当前 CLI 固定，不支持在调用参数里覆盖环境或用户身份：
-
-```bash
-npx @lark-base-open/base-database-cli --profile <profile-name> database-skill discover --app-token <app-token> --page-size 20
-npx @lark-base-open/base-database-cli --profile <profile-name> database-skill invoke --app-token <app-token> --function-id <发现的-id> --params '<业务参数JSON>'
-```
-
-发现始终读取正式版。Preview 部署不代表正式版已有对应能力；不要因安装而额外发现或调用正式版，本次约定的 Preview 数据验证与通知收尾仍须完成。
-
-`invoke --params` 是业务值本身（SQL 为数组），CLI 只包一层 `params` 并固定使用 `env=prod`。仅按实时发现的 Function 与 Schema 调用。写操作需用户明确授权相应业务动作，自动安装不构成授权；写入结果未知时仅用已发现的只读能力核对，无法核对则保留待确认，不自动重试写入。