下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/byteplan--bp-dev-cli.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @byteplan/bp-dev-cli。用户需要安装或使用当前项目的 BytePlan Dev CLI，或查询它支持的命令及用途时使用。
阅读全文 （展开查看完整说明）
概述
BytePlan Dev CLI 安装与命令参考
本 Skill 说明当前项目 packages/byteplan-code-cli 中的 CLI。包名和可执行命令以该目录的 package.json 为准：npm 包名为 byteplan-dev-cli，命令入口为 byteplan-dev-cli、bp-dev 和 bpd。不要把其他 BytePlan CLI 包的命令混入本命令清单。
命令清单根据当前项目的命令注册和 CLI_USAGE.md 整理。参数以本机 CLI 分级帮助为准；不确定时先查看帮助，不要猜测参数。大多数 API 命令输出 JSON；logs 会输出日志行。每个新对话首次使用本 Skill 时，先检查并同步 CLI 版本，再处理其他 CLI 操作。
每个新对话开始时检查 CLI 版本
在每个新对话开始时，只要本 Skill 适用于当前任务，就先运行以下命令，再进行其他 CLI 操作：
byteplan-dev-cli --version
npm view byteplan-dev-cli version如果本机没有安装 CLI，且当前任务需要使用 CLI，按下方安装步骤安装 npm 最新版。比较本地和 npm 上的版本；一致时继续。不一致时以 npm 最新版为准，升级 CLI 并同步已安装的 Skills：
npm install -g byteplan-dev-cli@latest
byteplan-dev-cli --version
byteplan-dev-cli skill install --force如果 Skills 安装在 Codex 目录，升级后对同一目录执行同步：
byteplan-dev-cli skill install --target ~/.codex/skills --force若 npm 查询失败，如实说明无法确认线上版本；本机 CLI 可用时可继续使用当前版本。版本不一致时，升级命令失败就停止并报告错误，不要使用 sudo。
开始任务前查找相关 CLI Skills
版本检查完成后、开始具体任务前，先查看 CLI 随包提供的 Skills：
bpd skill list根据输出中的 name 和 desc 判断是否有与当前任务相关的 Skill。skill list 输出包含 Skills 源目录 src；对每个匹配项，读取 <src>/<skill-name>/SKILL.md 的完整内容并按其说明完成任务。若 CLI 暂不可用但当前仓库可读，从 packages/byteplan-code-cli/skills/<skill-name>/SKILL.md 查找。没有相关 Skill 时，再按本 Skill 的命令参考继续。
安装与开始使用
CLI 要求 Node.js 22.5.0 或更高版本。先检查 Node.js 和 npm：
command -v node
node --version
command -v npm
npm --version安装 npm 包并确认命令帮助可用：
npm install -g byteplan-dev-cli@latest
byteplan-dev-cli --help
bp-dev --help
bpd --help安装后将包内 Skills 复制到使用中的助手目录：
byteplan-dev-cli skill install
byteplan-dev-cli skill list在仓库内本地运行时，从 CLI 包目录执行：
cd packages/byteplan-code-cli
node src/cli.js --help首次登录可以使用设备码流程：
bpd login也可以使用账号密码；建议通过 stdin 输入密码：
printf '%sn' '<password>' | bpd login -u <phone> --password-stdin查看当前账号和环境：
bpd config
bpd account list
bpd env list
bpd env current用 bpd env switch <environment> 持久切换活动环境。给单次命令加顶层 -e <environment> 只指定本次调用的环境，例如：
bpd -e uat model list -n "订单"查看任意命令和子命令的参数：
bpd -h
bpd <command> -h
bpd <command> <subcommand> -h命令与用途
| 命令 | 支持的操作与用途 |
|---|---|
| login / config | 登录 BytePlan，查看当前环境和认证状态。登录支持账号密码、工号 tenantCode 和设备码流程。 |
| account list | 查看当前环境中已授权的账号及当前账号。 |
| env list / current / switch | 查看环境状态、查询当前环境、切换活动环境。 |
| user info / tenants；tenant switch | 查看用户和可用租户，或切换租户。 |
| app / app switch | 查询当前用户可访问的应用，或按应用编码、ID 切换应用上下文。 |
| analysis list / create / get / update | 搜索和查看数据分析，创建基础分析，配置坐标轴、指标、图表和日期字段。 |
| form | 预算表单 AI 操作：解析模型和文件夹、创建或更新表单、保存配置、查询规则、目录和表单。常见子命令有 resolve-identifiers、model-options、create、config-update、reverse-create、save、data-config、rules、get、query-folder-forms、search。 |
| model | 查询模型和字段；创建模型、添加或更新字段；查询关系；管理多维模型字段和模型事件流。常见子命令有 list、count、columns、column-count、field-config、create、create-multidim、multidim-list、multidim-fields、multidim-fields-save、column-add、column-update、relations、children、relation-add、events 和 event-*。 |
| physical-scheme / table | 查询物理方案文件夹，创建物理表方案；table 是 physical-scheme 的别名。 |
| view | 创建视图模型、查看或更新视图 SQL、查询字段、更新字段说明和增加默认排序。 |
| page | 查询页面和授权信息，生成本地页面项目，创建 sourceCode 或 lowcode 页面，拉取源码、管理 tag 版本、发布页面授权。常见子命令有 list、auth-pages、detail、assign-function、count、templates、project、create-source、lowcode、source、tag-create、tag-info、tag-publish、publish。 |
| datasource list / count | 查询数据源及数量。 |
| sql | 查询和管理保存的 SQL，查看数据源表和字段，并执行动态 SQL。用 sql create / update 管理保存的查询，用 sql exec 执行查询。 |
| dict | 查询或创建数据字典，查询字典项并添加新项。 |
| lov | 查询、创建和更新 LOV，查看和配置 LOV 显示字段。 |
| coding rules / details | 查询编码规则列表和规则明细。 |
| task | 查询、创建、更新和运行脚本任务；生成本地任务项目，拉取或推送脚本，维护参数并查询执行实例。 |
| hierarchy | 查询维度、层级、维度值和层级值；也支持创建或更新维度、维度值和层级。 |
| logs | 查询 Grafana Loki 日志，可按时间、关键词、label 或 traceId 筛选，也支持尾随日志。 |
| component list / info / props | 查询 byte-builder PC 组件及其属性、事件和方法；也可扫描指定的本地 byte-builder 项目。 |
| issue search / list / get | 分阶段只读查询本地知识库：先搜索关键词，再查看标题列表，最后读取选定记录的完整内容。 |
| skill list / install / remove | 查看、安装和卸载 CLI 随包提供的 Skills。 |
| local-request（隐藏） | 内部执行经校验的请求定义，通常不需要直接调用。 |
当前 CLI 包含会修改平台数据的操作，例如模型、表单、页面、字典、LOV、任务和层级的创建或更新，以及页面发布和任务运行。执行前先查看具体子命令的帮助，并按用户请求选择对应操作。
预算表单也保留了隐藏的 ai-form-* 直连别名；日常使用优先通过 form <operation> 调用。
安装随 CLI 提供的 Skills
查看 Skill 清单、安装全部 Skills，或只安装命令参考 Skill：
bpd skill list
bpd skill install
bpd skill install bp-cli-commands安装器默认复制到 ~/.claude/skills。安装到 Codex 时指定其 Skills 目录：
bpd skill install bp-cli-commands --target ~/.codex/skills
