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

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.1.0] - 2026-09-10
+
+### Added
+
+- 支持多账号切换，并记住每个应用使用的账号。
+- 支持一键安装 CLI 和 Agent Skill。
+- 支持检查新版本，并同步更新 CLI 和多个 Agent 中已安装的 Skill。
+
+### Changed
+
+- 完善应用新建、恢复、修改、故障诊断和验收的操作指引。
+
 ## [1.0.0] - 2026-09-08
 
 ### Added

package/README.md

@@ -5,31 +5,77 @@ Skill 和配套 CLI，用于基于飞书多维表格创建、开发并发布数
 负责初始化 Base 与应用、生成项目、校验和构建 Functions，以及发布 Preview
 和正式版本。
 
-## 安装 Agent Skill
+## 安装 CLI 和 Agent Skill
 
-首次安装到 Codex：
+需要 Node.js 20.19 或更新版本，以及可用的 npm。首次安装到 Codex：
 
 ```bash
-npx --yes @lark-base-open/base-database-cli@latest skill install --target codex
+npx --yes @lark-base-open/base-database-cli@latest install --target codex
 ```
 
-升级已安装的 Skill：
+安装器将自身版本安装到 npm 全局目录，再从全局包安装 Skill；已有同版本 CLI 时只安装 Skill。支持 `--target codex|claude|agents|all` 或 `--dir <skills 根目录>`。安装器也会同步上述受支持用户目录中可确认来源的公开版 Lark Base Database Skill，避免 Agent 读取另一份旧副本；自动发现跳过内部版和来源不明的副本，不会为未安装的 Agent 新建副本。任一目标已有内容时需显式添加 `--force`，否则在更改 CLI 前停止。单独的 `skill install` 仍只处理所选目标。Codex 使用 `CODEX_HOME/skills`，未设置时使用 `~/.codex/skills`。
+
+若已安装的 CLI 文件损坏，`npx` 可能复用损坏的全局命令，无法启动安装器。先用 `npm install -g @lark-base-open/base-database-cli@<精确版本>` 重装，再执行 `base-database-cli update --version <同一精确版本> --yes` 同步已安装的 Skills。测试或私有 registry 环境需在重装时保留对应 npm registry 配置。
+
+成功结果包含 CLI 版本、实际入口和 Skill 目录。PATH 不通时输出需加入的目录及可直接运行的 Node/CLI 参数；命令入口缺失时提示检查 npm 的 bin-links 配置。不修改 shell 配置、npm prefix 或 Node 安装。npm 失败时保留错误并停止后续步骤。重新加载 Skill 后，日常直接运行 `base-database-cli …`。
+
+已有全局 CLI、只需给另一个 Agent 安装 Skill 时：
 
 ```bash
-npx --yes @lark-base-open/base-database-cli@latest skill install --target codex --force
+base-database-cli skill install --target claude
 ```
 
-安装后，在 Codex 中描述要搭建的业务系统；Agent 会读取 Skill，并通过 CLI
-完成数据模型、页面和 Functions 的开发与发布。
+## 检查和更新
+
+Agent 每个会话首次业务操作前检查一次；检查只返回 JSON，不读取 stdin、不安装内容。示例路径需替换为当前实际加载的 Skill 目录：
+
+```bash
+base-database-cli check-update --json --skill-dir "/Users/alice/.codex/skills/lark-base-database"
+```
+
+无新版或查询失败时静默继续。有新版时询问用户，拒绝后本会话不再询问；下个会话仍会比较当前 CLI 与缓存中的最新版本。用户同意更新 CLI 及已安装的用户级 Skill 后，使用刚确认的精确版本（以下 1.0.1 仅为示例）：
+
+```bash
+base-database-cli update --version 1.0.1 --skill-dir "/Users/alice/.codex/skills/lark-base-database" --yes
+```
+
+更新先现场检查已支持的用户级目录：Codex（遵循 `CODEX_HOME`）、Claude（遵循 `CLAUDE_CONFIG_DIR`，默认 `~/.claude/skills`）、`~/.agents/skills`，再调用 npm 安装指定版本，并由全局 CLI 同步其中可确认来源的公开版 `lark-base-database` 副本。显式传入的 `--skill-dir` 不受公开版来源筛选限制，仍须是包含同名 Skill 的 `lark-base-database` 目录；没有自定义目录时可省略。合法共享 Skill 的符号链接会保留，但真实目标是 CLI 源目录、用户目录、Agent 根目录或工程根时会在安装前拒绝覆盖。没有安装的目录不补装，不保存历史路径清单，不搜索项目目录或任意手动副本。Skill 版本差异仅提示，不阻塞业务。
+
+npm 的权限、网络和环境错误直接报告，不预先探测或自动修复用户环境，也不覆盖用户的 npm engine-strict 配置。CLI 升级成功但部分 Skill 失败时返回 `skill-update-failed`，分别列出成功目录、失败目录及各自的修复参数；继续处理其他目录，不自动整体回滚。切换 npm/Node 环境后，应使用该环境中的全局 CLI。
+
+CLI 版本来自包内 `package.json`；每份 Skill 的 `base-database-version.json` 记录其来源版本；用户目录下 `.base-database-cli/update-state.json` 仅缓存 registry、latest 和 checkedAt，24 小时有效。查询与全局安装使用相同的 npm 全局配置，忽略项目级 registry；在线查询总预算 3 秒；缓存不可写不影响检查。CI 和托管 Builder 跳过公开更新。
 
 ## 创建、恢复并发布数据库应用
 
+### 复用 lark-cli profile
+
+CLI 复用本机已有的 lark-cli profile，不另存应用密钥或用户 token。通过全局
+`--profile <name>` 选择账号；品牌和鉴权由该 profile 对应的 lark-cli 配置决定：
+
+```bash
+base-database-cli --profile my-lark doctor
+base-database-cli --profile my-lark init ./todo-database \
+  --base-token basxxxxxxxx --name 'Todo 管理' --description '管理个人任务'
+```
+
+`init` 和 `pull` 会将实际选中的名称保存为 `base-database.jsonc` 的 `larkProfile`。
+后续项目命令的优先级为：`--profile` → 项目 `larkProfile` →
+`LARKSUITE_CLI_PROFILE` → lark-cli 默认 profile。显式覆盖只影响本次命令，
+不修改项目绑定或 lark-cli 默认配置。项目目录内的 `auth` 和 `doctor` 也遵守此规则。
+`--profile` 选择账号，`--env` 选择运行环境，两者互不替代。
+运行时未配置所选品牌的路由时会停止，不跨环境发送请求。
+
+不存在的 profile 会报错，不回退或自动创建。已选 profile 与环境注入的凭证、
+AUTH_PROXY 等更高优先级凭证来源同时存在时会报冲突，避免静默换账号；
+没有选择 profile 的托管环境继续使用宿主凭证，不保存 `larkProfile`。
+跨设备时须在目标设备配置并授权对应 profile，不能复制凭证。
+
 ### 新建数据库应用
 
 新建工程时，`init` 支持两种 Base 来源。需要从零建数据模型时，Agent 根据 Skill 写出完整 `base-schema.json`，再用一条命令创建 Base、全部 table、应用与 binding，并生成 hello-world 工程和 Catalog：
 
 ```bash
-npx @lark-base-open/base-database-cli init ./todo-database \
+base-database-cli init ./todo-database \
   --schema ./base-schema.json \
   --name 'Todo 管理' \
   --env online
@@ -38,7 +84,7 @@ npx @lark-base-open/base-database-cli init ./todo-database \
 已有 Base 时，不创建或修改 Base。CLI 会读取其中的全部 table，直接创建绑定该 Base 的新应用，获取 Catalog，并生成同样的工程：
 
 ```bash
-npx @lark-base-open/base-database-cli init ./todo-database \
+base-database-cli init ./todo-database \
   --base-token basxxxxxxxx \
   --name 'Todo 管理' \
   --env online
@@ -47,7 +93,7 @@ npx @lark-base-open/base-database-cli init ./todo-database \
 `--schema` 与 `--base-token` 必须且只能选择一个。宿主已经创建目标应用时，额外传入 `--app-token`；CLI 会把选中的 Base 绑定到该应用，而不会再调用应用创建接口：
 
 ```bash
-npx @lark-base-open/base-database-cli init ./todo-database \
+base-database-cli init ./todo-database \
   --schema ./base-schema.json \
   --app-token PrjExistingToken \
   --name 'Todo 管理' \
@@ -63,7 +109,7 @@ npx @lark-base-open/base-database-cli init ./todo-database \
 已有数据库应用存在源码制品时，使用 `pull` 恢复可编辑工程，不要重新执行 `init`。目标目录必须为空；CLI 会下载当前 `page/`、`server-functions/` 和 `sql/` 源码，读取应用 Catalog，并重建 `base-database.jsonc` 与 `catalog.json`，不会创建或修改 Base、应用元信息和 binding：
 
 ```bash
-npx @lark-base-open/base-database-cli pull ./todo-database \
+base-database-cli pull ./todo-database \
   --app-token PrjExistingToken \
   --env online
 ```
@@ -76,18 +122,20 @@ npx @lark-base-open/base-database-cli pull ./todo-database \
 
 ```bash
 cd todo-database
-npx @lark-base-open/base-database-cli deploy
+base-database-cli deploy
 ```
 
 部署结果只返回当前环境用户可访问的顶层 `baseAppUrl`。Agent 把链接交给用户后停止；用户体验并明确回复“部署正式版”后，把同一制品发布到 Prod：
 
 ```bash
-npx @lark-base-open/base-database-cli deploy --production --yes
+base-database-cli deploy --production --yes
 ```
 
 Preview 回执会记录生成该制品时的工作区输入指纹。Preview 之后只要源码、配置或
 文件结构发生变化，Production 发布就会在任何远端请求前停止，并要求重新运行
 普通 `deploy` 生成和验证新的 Preview；旧版回执缺少输入指纹时同样不会放行。
+Preview 回执同时绑定有效的 lark-cli profile；切换 profile 或旧回执没有 profile
+而当前使用本地 profile 时，需要重新发布 Preview，不能直接推广为正式版。
 
 ### 部署后的应用能力 Skill
 
@@ -98,13 +146,14 @@ Skill 按需读取正式版的 Function 和参数 Schema，不依赖应用工程
 需要单独修复安装或指定其他 Agent 的用户技能目录时：
 
 ```bash
-npx @lark-base-open/base-database-cli database-skill install --app-token <app-token> --title '<应用名称>' --dir <skills-root>
+base-database-cli --profile <profile-name> database-skill install --app-token <app-token> --title '<应用名称>' --dir <skills-root>
 ```
 
 只更新本工具管理的该应用 `SKILL.md`，不删除其他文件；安装失败会单独返回，不影响已经成功的应用发布。
 
 能力 Skill 使用 `base-database-<hash>` 名称，通过 `database-skill` 命令安装和使用。
-同一应用和环境使用固定目录，每次部署更新本工具管理的 `SKILL.md`，保留附加文件。
+同一应用、环境和 profile 使用固定目录，每次部署更新本工具管理的 `SKILL.md`，保留附加文件。
+生成的发现和调用命令显式携带 profile，不跟随 lark-cli 默认账号变化；托管凭证模式不写入 profile。
 目标目录不受本工具管理或存在符号链接冲突时报告错误，不自动覆盖。
 
 ## 环境
@@ -114,11 +163,13 @@ CLI 只支持 `online`，`--env` 默认且仅接受 `online`。保留该参数
 需要登录或诊断时：
 
 ```bash
-npx @lark-base-open/base-database-cli auth login --env online
-npx @lark-base-open/base-database-cli doctor --env online
+base-database-cli auth login --env online
+base-database-cli doctor --env online
 ```
 
-`auth login` 使用默认 lark-cli 配置；首次使用时自动启动 `config init --new`，配置完成后继续申请 Base 用户权限。
+`auth login` 使用上述规则选中的 lark-cli profile，并申请 Base 用户权限。仅未指定
+profile 且 lark-cli 尚未配置时，才自动启动首次 `config init --new`；指定的 profile
+不存在时直接报错，不创建或覆盖配置。
 
 Base Database CLI 会按 `PATH` 顺序探测全部 `lark-cli`，读取各自的 `--version`，并跳过版本号中带构建 hash 的定制版本，默认使用第一个不带构建 hash 的 release 版本。如果没有可用的 release 版本，命令会明确失败而不会回退到定制版本。需要显式覆盖自动选择时，可将 `BASE_DATABASE_LARK_CLI_PATH` 设置为目标可执行文件的绝对路径；显式设置不会应用版本过滤。
 
@@ -146,14 +197,17 @@ Base Database CLI 会按 `PATH` 顺序探测全部 `lark-cli`，读取各自的
 ## CLI 命令
 
 ```text
-npx @lark-base-open/base-database-cli skill install
-npx @lark-base-open/base-database-cli auth login|logout|whoami
-npx @lark-base-open/base-database-cli doctor
-npx @lark-base-open/base-database-cli init
-npx @lark-base-open/base-database-cli pull
-npx @lark-base-open/base-database-cli deploy
-npx @lark-base-open/base-database-cli deployments status
-npx @lark-base-open/base-database-cli lark-cli -- <arguments...>
+base-database-cli install
+base-database-cli check-update
+base-database-cli update
+base-database-cli skill install
+base-database-cli auth login|logout|whoami
+base-database-cli doctor
+base-database-cli init
+base-database-cli pull
+base-database-cli deploy
+base-database-cli deployments status
+base-database-cli lark-cli -- <arguments...>
 ```
 
 `deploy` 在一次调用内先生成 Function metadata 并完成全部 SQL validate，通过后再检查依赖指纹、执行必要的依赖安装、Page/FaaS build、archive、Functions sync、Artifact upload、Preview publish 和状态轮询。CLI 会汇总全部未通过的 SQL Function 后一次性报错；存在任一 SQL 校验失败时不会安装依赖或执行 build。依赖指纹未变化且对应 `node_modules` 仍存在时，默认跳过该子项目的 `npm ci`；`--force-install` 强制重装，`--no-install` 无条件跳过安装。build 仍会在每次 Preview deploy 中执行。正常应用开发不单独运行这些步骤；FaaS 子项目仍保留 `npm run build`，因为平台镜像打包器直接调用它。
@@ -163,7 +217,7 @@ npx @lark-base-open/base-database-cli lark-cli -- <arguments...>
 `lark-cli` 子命令仅用于调试。先进入包含 `base-database.jsonc` 的项目根目录；命令只读取当前目录，不接受额外项目路径，并在线上环境直接透传参数。正常初始化和发布无需调用：
 
 ```bash
-npx @lark-base-open/base-database-cli lark-cli -- \
+base-database-cli lark-cli -- \
   api GET /open-apis/base/v3/sites/list \
   --params '{"pageSize":1}' --json
 ```

package/config-schema.json

@@ -19,6 +19,12 @@
       "type": "string",
       "minLength": 1
     },
+    "larkProfile": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "description": "Name of an existing lark-cli profile; credentials stay in lark-cli."
+    },
     "appToken": {
       "type": "string",
       "minLength": 1

package/dist/agent-guide.d.ts

@@ -2,6 +2,7 @@ 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;

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

@@ -1 +1 @@
-{"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,CAAA;CAAE;YAgB7C,MAAM;;;;;;;gBALJ,QAAQ;;;;EAgBrB"}
+{"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

@@ -8,6 +8,7 @@ export function deploymentAgentGuide(appToken, target, options) {
             appToken,
             title: validatePageTitle(options.workspace),
             profile: options.profile,
+            larkProfile: options.larkProfile,
         });
     }
     catch (error) {
@@ -20,11 +21,11 @@ export function deploymentAgentGuide(appToken, target, options) {
         target: 'prod',
         availability: target === 'prod'
             ? '正式版发布成功；实际发现结果以服务端接口及开关状态为准，尚未自动验证。'
-            : '本次仅发布预览版；Skill 只读取正式版，不代表本次预览可被发现。不执行发现或调用，先等待用户确认。',
+            : '本次仅发布预览版；本应用 Skill 只发现正式版，不代表本次 Preview。不要因安装而额外发现或调用正式版能力；本次约定的 Preview 数据验证与通知收尾仍须完成。',
         skill,
         message: skill.status === 'failed'
             ? '应用发布成功，但专属 Skill 安装失败；向用户报告原因，不要重新发布应用来修复安装。'
-            : `已${skill.status === 'installed' ? '安装' : '更新'}本应用 Skill。请告知用户可直接让 Agent 使用本应用能力，或使用 $${skill.name}；当前客户端若未自动刷新 Skill 列表，请开启新会话。安装不代表业务操作授权。`,
+            : `已${skill.status === 'installed' ? '安装' : '更新'}本应用 Skill。请告知用户可直接让 Agent 使用本应用能力，或使用 $${skill.name}；先确认安装路径属于目标客户端的发现目录，再按客户端方式刷新；仅重开会话不能修复目录不匹配。安装不代表业务操作授权。`,
     };
 }
 //# sourceMappingURL=agent-guide.js.map

package/dist/agent-guide.js.map

@@ -1 +1 @@
-{"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,OAAuD;IAEvD,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;SACzB,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,qDAAqD;QAC3D,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,2CAA2C;KACpJ,CAAC;AACJ,CAAC"}
+{"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/auth.d.ts

@@ -1,12 +1,13 @@
 import { type RuntimeProfile } from './environment.js';
 import { runCommand } from './process.js';
 export declare function ensureConfiguration(env: NodeJS.ProcessEnv, runner?: typeof runCommand): void;
-export declare function login(profile?: RuntimeProfile): Promise<void>;
-export declare function logout(profile?: RuntimeProfile): Promise<void>;
-export declare function whoami(profile?: RuntimeProfile): Promise<import("./types.js").CommandResult>;
-export declare function doctor(profile?: RuntimeProfile): Promise<{
+export declare function login(profile?: RuntimeProfile, larkProfile?: string): Promise<void>;
+export declare function logout(profile?: RuntimeProfile, larkProfile?: string): Promise<void>;
+export declare function whoami(profile?: RuntimeProfile, larkProfile?: string): Promise<import("./types.js").CommandResult>;
+export declare function doctor(profile?: RuntimeProfile, selectedLarkProfile?: string): Promise<{
     ok: true;
     environment: string;
+    larkProfile?: string | undefined;
     node: string;
     user: {
         status: unknown;

package/dist/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE/E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO1C,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,MAAM,oBAAa,GAClB,IAAI,CAWN;AAED,wBAAsB,KAAK,CACzB,OAAO,GAAE,cAAuC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAsB,MAAM,CAC1B,OAAO,GAAE,cAAuC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,MAAM,CAAC,OAAO,GAAE,cAAuC,+CAG5E;AAED,wBAAsB,MAAM,CAAC,OAAO,GAAE,cAAuC;;;;;QA4BvE,MAAM;QACN,SAAS;QACT,QAAQ;;GAGb"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAO1B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAiB1C,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,MAAM,oBAAa,GAClB,IAAI,CAaN;AAED,wBAAsB,KAAK,CACzB,OAAO,GAAE,cAAuC,EAChD,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,MAAM,CAC1B,OAAO,GAAE,cAAuC,EAChD,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAsB,MAAM,CAC1B,OAAO,GAAE,cAAuC,EAChD,WAAW,CAAC,EAAE,MAAM,+CASrB;AAED,wBAAsB,MAAM,CAC1B,OAAO,GAAE,cAAuC,EAChD,mBAAmB,CAAC,EAAE,MAAM;;;;;;QA+BxB,MAAM;QACN,SAAS;QACT,QAAQ;;GAGb"}

package/dist/auth.js

@@ -1,6 +1,14 @@
-import { ONLINE_RUNTIME_PROFILE } from './environment.js';
-import { resolveLarkCliExecutable, runLarkCli } from './lark-cli.js';
+import { existsSync } from 'node:fs';
+import { CONFIG_FILE_NAME, readConfig } from './config.js';
+import { assertProjectRuntimeProfile, ONLINE_RUNTIME_PROFILE, } from './environment.js';
+import { resolveLarkCliExecutable, runLarkCli, selectLarkProfileEnvironment, resolveLarkProfileEnvironment, } from './lark-cli.js';
 import { runCommand } from './process.js';
+async function authEnvironment(profile, larkProfile) {
+    const config = existsSync(CONFIG_FILE_NAME) ? readConfig() : undefined;
+    if (config)
+        assertProjectRuntimeProfile(config.runtimeProfile, profile);
+    return selectLarkProfileEnvironment(await profile.commandEnvironment(), larkProfile, config?.larkProfile);
+}
 function isNotConfigured(error) {
     const message = error instanceof Error ? error.message : String(error);
     return /"subtype"\s*:\s*"not_configured"/.test(message);
@@ -11,34 +19,34 @@ export function ensureConfiguration(env, runner = runCommand) {
         runner(executable, ['config', 'show'], { env, capture: true });
     }
     catch (error) {
+        // A dangling named profile is not permission to replace the default configuration.
+        if (env.LARKSUITE_CLI_PROFILE)
+            throw error;
         if (!isNotConfigured(error))
             throw error;
         process.stderr.write('lark-cli is not configured for this environment; starting first-time setup...\n');
         runner(executable, ['config', 'init', '--new'], { env });
     }
 }
-export async function login(profile = ONLINE_RUNTIME_PROFILE) {
-    const env = await profile.commandEnvironment();
-    ensureConfiguration(env);
+export async function login(profile = ONLINE_RUNTIME_PROFILE, larkProfile) {
+    const selected = await authEnvironment(profile, larkProfile);
+    ensureConfiguration(selected);
+    const { env } = resolveLarkProfileEnvironment(selected, undefined, undefined, profile);
     runCommand(resolveLarkCliExecutable(env), ['auth', 'login', '--domain', 'base'], { env });
 }
-export async function logout(profile = ONLINE_RUNTIME_PROFILE) {
-    const env = await profile.commandEnvironment();
+export async function logout(profile = ONLINE_RUNTIME_PROFILE, larkProfile) {
+    const { env } = resolveLarkProfileEnvironment(await authEnvironment(profile, larkProfile), undefined, undefined, profile);
     runCommand(resolveLarkCliExecutable(env), ['auth', 'logout'], { env });
 }
-export async function whoami(profile = ONLINE_RUNTIME_PROFILE) {
-    const env = await profile.commandEnvironment();
+export async function whoami(profile = ONLINE_RUNTIME_PROFILE, larkProfile) {
+    const { env } = resolveLarkProfileEnvironment(await authEnvironment(profile, larkProfile), undefined, undefined, profile);
     return runLarkCli(['auth', 'status', '--verify'], env);
 }
-export async function doctor(profile = ONLINE_RUNTIME_PROFILE) {
+export async function doctor(profile = ONLINE_RUNTIME_PROFILE, selectedLarkProfile) {
     const major = Number(process.versions.node.split('.')[0]);
     if (major < 20)
         throw new Error('Node.js 20 or newer is required');
-    const env = await profile.commandEnvironment();
-    runCommand(resolveLarkCliExecutable(env), ['config', 'show'], {
-        env,
-        capture: true,
-    });
+    const { env, larkProfile } = resolveLarkProfileEnvironment(await authEnvironment(profile, selectedLarkProfile), undefined, undefined, profile);
     const identity = runLarkCli(['auth', 'status', '--verify'], env);
     runLarkCli([
         'api',
@@ -52,6 +60,7 @@ export async function doctor(profile = ONLINE_RUNTIME_PROFILE) {
     return {
         ok: true,
         environment: profile.name,
+        ...(larkProfile ? { larkProfile } : {}),
         node: process.version,
         user: {
             status: user?.status,

package/dist/auth.js.map

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

package/dist/cli.js

@@ -2,14 +2,15 @@
 import { readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { addDistributionCommands } from './distribution-commands.js';
 import { ONLINE_RUNTIME_PROFILE } from './environment.js';
 import { createBaseDatabaseProgram, runBaseDatabaseProgram, } from './program.js';
 const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
 const packageJson = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'));
-runBaseDatabaseProgram(createBaseDatabaseProgram({
+runBaseDatabaseProgram(addDistributionCommands(createBaseDatabaseProgram({
     commandName: 'base-database-cli',
     description: 'Build and deploy database applications on Lark Base',
     version: packageJson.version,
     runtimeProfiles: [ONLINE_RUNTIME_PROFILE],
-}));
+})));
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACxE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACjC,CAAC;AAEzB,sBAAsB,CACpB,yBAAyB,CAAC;IACxB,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,qDAAqD;IAClE,OAAO,EAAE,WAAW,CAAC,OAAO;IAC5B,eAAe,EAAE,CAAC,sBAAsB,CAAC;CAC1C,CAAC,CACH,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACxE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACjC,CAAC;AAEzB,sBAAsB,CACpB,uBAAuB,CACrB,yBAAyB,CAAC;IACxB,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,qDAAqD;IAClE,OAAO,EAAE,WAAW,CAAC,OAAO;IAC5B,eAAe,EAAE,CAAC,sBAAsB,CAAC;CAC1C,CAAC,CACH,CACF,CAAC"}

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAOrD,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAEtD,wBAAgB,UAAU,CAAC,SAAS,SAAgB,GAAG,kBAAkB,CA8BxE;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,kBAAkB,GACzB,MAAM,CAUR"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQrD,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAEtD,wBAAgB,UAAU,CAAC,SAAS,SAAgB,GAAG,kBAAkB,CAgCxE;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,kBAAkB,GACzB,MAAM,CAWR"}

package/dist/config.js

@@ -3,6 +3,7 @@ import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import Ajv2020 from 'ajv/dist/2020.js';
 import { parse, printParseErrorCode } from 'jsonc-parser';
+import { validateLarkProfile } from './profile-name.js';
 const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 const schema = JSON.parse(readFileSync(join(packageRoot, 'config-schema.json'), 'utf8'));
 const validate = new Ajv2020({ allErrors: true }).compile(schema);
@@ -34,7 +35,10 @@ export function readConfig(workspace = process.cwd()) {
             .join('; ');
         throw new Error(`Invalid ${configPath}: ${detail}`);
     }
-    return value;
+    const config = value;
+    if (config.larkProfile !== undefined)
+        validateLarkProfile(config.larkProfile);
+    return config;
 }
 export function writeConfig(workspace, config) {
     if (!validate(config)) {
@@ -43,6 +47,8 @@ export function writeConfig(workspace, config) {
             .join('; ');
         throw new Error(`Cannot write invalid Base Database config: ${detail}`);
     }
+    if (config.larkProfile !== undefined)
+        validateLarkProfile(config.larkProfile);
     const path = join(resolve(workspace), CONFIG_FILE_NAME);
     writeFileSync(path, `${JSON.stringify(config, null, 2)}\n`);
     return path;

package/dist/config.js.map

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

package/dist/database-skill.d.ts

@@ -1,12 +1,14 @@
 import type { RuntimeProfile } from './environment.js';
-export declare function databaseSkillName(token: string, environment: string): string;
+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;
@@ -18,5 +20,5 @@ export declare function installDatabaseSkill(options: {
 };
 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[]): Promise<import("./types.js").CommandResult>;
+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 +1 @@
-{"version":3,"file":"database-skill.d.ts","sourceRoot":"","sources":["../src/database-skill.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAQvD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAI1E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG,MAAM,CA0BT;AAoCD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;EAwBA;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,+CAGf"}
+{"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

@@ -3,36 +3,48 @@ import { lstatSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSy
 import { homedir } from 'node:os';
 import { join, resolve } from 'node:path';
 import { packageRoot } from './assets.js';
-import { runLarkCli } from './lark-cli.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) {
+export function databaseSkillName(token, environment, larkProfile) {
     validateAppToken(token);
+    if (larkProfile !== undefined)
+        validateLarkProfile(larkProfile);
     return `base-database-${createHash('sha256')
-        .update(JSON.stringify([environment, token]))
+        .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');
-    return profile.deployCommand.slice(0, -' deploy'.length);
+    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);
+    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}。`),
+        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),
-        managed_marker: `<!-- base-database-managed-skill:${profile.name}:${appToken} -->`,
+        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];
@@ -71,13 +83,13 @@ function assertManagedDirectory(directory, marker) {
     return true;
 }
 export function installDatabaseSkill(options) {
-    const name = databaseSkillName(options.appToken, options.profile.name);
+    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 = `<!-- base-database-managed-skill:${options.profile.name}:${options.appToken} -->`;
+    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`);
@@ -129,7 +141,11 @@ export function invocationArgs(appToken, functionId, params) {
         'user',
     ];
 }
-export async function runDatabaseSkillRequest(profile, args) {
-    return runLarkCli(args, await profile.commandEnvironment());
+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