@bintel/dimens-cli

Dimens CLI

dimens-cli 是多维项目的本地命令行与 Node.js SDK 封装，当前已经落地可直接执行的本地 CLI 主链。

当前实现重点收口为两条主能力：

• 认证侧：API Key + API Secret 换取系统 token
• AI 侧：POST /app/flow/:teamId/v1/chat/completions

默认 baseUrl 固定为：

https://dimens.bintelai.com

只有当用户显式传入 --base-url、profile 配置或环境变量时，才会覆盖默认地址。

当前已实现能力

当前仓库里已经实现并验证的命令组有：

• auth
• project
• sheet
• column
• row
• ai
• system

对应 SDK 业务域有：

• sdk.auth
• sdk.project
• sdk.sheet
• sdk.column
• sdk.row
• sdk.ai

安装

作为 npm 包安装：

npm install @bintel/dimens-cli

或：

pnpm add @bintel/dimens-cli

如果你是在当前仓库里开发 dimens-cli，再看下面的“本地开发使用”。

本地开发使用

进入目录：

cd /Users/lixiang/data/代码库管理/binterAi/多维项目开发/dimens-cli

安装依赖：

pnpm install

构建：

pnpm build

本地直接执行 CLI：

node ./bin/dimens-cli.js help

如果你希望像全局命令一样使用：

npm link
dimens-cli help

CLI 快速开始

查看帮助：

node ./bin/dimens-cli.js help
node ./bin/dimens-cli.js help auth
node ./bin/dimens-cli.js help ai

使用 API Key 换 Token：

node ./bin/dimens-cli.js auth api-key-login \
  --api-key ak_xxx \
  --api-secret sk_xxx

写入默认团队：

node ./bin/dimens-cli.js auth use-team TEAM1

获取项目列表：

node ./bin/dimens-cli.js project list --team-id TEAM1

调用 AI chat completions：

node ./bin/dimens-cli.js ai chat-completions \
  --team-id TEAM1 \
  --message "你好" \
  --model default

SDK 快速开始

当前 SDK 不是旧版 callTool() 风格，而是“统一客户端 + 分域 SDK”结构。

import { createSDK } from '@bintel/dimens-cli';

const sdk = createSDK({
  baseUrl: 'https://dimens.bintelai.com',
});

const loginResult = await sdk.auth.exchangeTokenByApiKey({
  apiKey: 'ak_xxx',
  apiSecret: 'sk_xxx',
});

const businessSdk = createSDK({
  baseUrl: 'https://dimens.bintelai.com',
  token: loginResult.data.token,
  refreshToken: loginResult.data.refreshToken,
  teamId: 'TEAM1',
  projectId: 'PROJ1',
});

const projects = await businessSdk.project.page('TEAM1', {
  page: 1,
  size: 20,
});

const chat = await businessSdk.ai.completions('TEAM1', {
  model: 'default',
  messages: [
    {
      role: 'user',
      content: '你好',
    },
  ],
});

console.log(projects.data);
console.log(chat.data);

仓库内一键 Smoke Test

仓库开发场景已经提供现成脚本：

cd /Users/lixiang/data/代码库管理/binterAi/多维项目开发/dimens-cli

export DIMENS_API_KEY="ak_xxx"
export DIMENS_API_SECRET="sk_xxx"
export DIMENS_TEAM_ID="TEAM1"

bash ./scripts/smoke-test.sh

可选变量：

export DIMENS_BASE_URL="https://dimens.bintelai.com"
export DIMENS_SMOKE_MESSAGE="CLI smoke test"
export DIMENS_SMOKE_MODEL="default"

注意：

• scripts/smoke-test.sh 是仓库内联调脚本
• 如果你是通过 npm 安装包到其他项目中使用，请直接调用 dimens-cli 命令或 SDK，不依赖这份仓库脚本

文档索引

• 业务控制说明
• 命令结构设计
• SDK使用指南
• cli 命令使用指南
• 实现计划

开发命令

pnpm build
pnpm test
pnpm typecheck
pnpm publish:check

pnpm publish:check 会顺序执行：

• 测试
• 类型检查
• 构建
• npm pack --dry-run

常用版本命令：

pnpm release:patch
pnpm release:minor
pnpm release:major

更完整的发布步骤见：

• 发布检查清单
• 版本发布流程

项目结构

dimens-cli/
├── bin/                # CLI 入口
├── dist/               # 构建产物
├── scripts/            # 辅助脚本
├── src/
│   ├── cli.ts          # CLI 分发入口
│   ├── commands/       # 命令层
│   ├── core/           # 上下文、配置、输出
│   └── sdk/            # SDK 封装
├── tests/              # 测试
└── 文档/               # 设计与使用文档

说明

• 当前 api key 只保留“换 token”这一条主链，不扩展 API Key 管理命令
• 当前 ai 只保留 chat-completions 一条使用接口
• 旧版 callTool/getTools/getSkills 文档口径已废弃，不再适用于当前实现