SuperAPI AI 工具集

db-list

通用与其它

查看项目

更新于 10-16 01:38

技能介绍

用途:管理项目根目录下的 .v8-project.json 数据库注册表,该文件保存 1С 信息库的连接参数、别名及与 Git 分支的绑定关系,供其他 db-* 等技能解析目标库。

主要能力:

  • /db-list:列出所有已注册数据库及类型、路径/服务器、默认库标记。
  • /db-list add:交互式添加数据库,采集 id、name、type(file/server)、path 或 server+ref、user、password、aliases、branches;若配置了配置库存储则填写 repository。首个库自动设为 default。
  • /db-list remove <id>:按 id 删除;若删除的是默认库,需重新指定默认库。
  • /db-list show <id|alias>:显示指定库的全部字段。

使用方式:注册表位于项目根目录(与 .git/ 同级)。根字段含 v8path、v8args、ibcmdargs、newObjectPosition、extensionApplyCheck、externalCheck、xsdPath、databases、default。库记录含 id、name、type、path(file)或 server/ref(server)、v8path、user、password、aliases、branches、configSrc、repository、extensions。

库解析顺序:显式连接参数优先;否则按 id、aliases(含词形匹配)、name(模糊)匹配;未指定时按当前 Git 分支匹配 branches(支持 glob,如 release/*),否则用 default;未找到或不唯一时询问用户;文件不存在时询问连接参数并可创建。执行后若所用库未注册,可建议 /db-list add。

平台选择顺序:显式 -V8Path → 库记录 v8path → 根 v8path → 自动检测。未设置 v8path 时可使用命令:Get-ChildItem "C:\Program Files\1cv8*\bin\1cv8.exe" | Sort-Object -Descending | Select-Object -First 1

连接串格式:文件库 /F "<path>";服务器库 /S "<server>/<ref>";认证 /N"<user>" /P"<password>"(/N、/P 后无空格,空密码省略 /P)。若库配置了 repository,脚本会自动附加 /ConfigurationRepositoryF、/ConfigurationRepositoryN、/ConfigurationRepositoryP。连接到配置库存储的库,在未提供存储凭据时无法执行任何配置器操作。

适用场景:多库、多平台版本、按 Git 分支切换目标库的 1С 项目开发流程。

限制:.v8-project.json 含密码等敏感信息,应加入 .gitignore;网络存储地址为 tcp://<host>[:<port>]/<name>,默认端口 1542,存储服务不可用时平台报连接错误。具体价格、平台范围等资料未提供。