@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/api

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

当前已实现能力

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

• auth
• project
• sheet
• column
• row
• ai
• skill
• 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 提示“command not found”，说明当前环境还没有这个命令。先安装 @bintel/dimens-cli，安装完成后再继续看 skills/ 文档、CLI 案例和 Skill 路由说明。

如果你是在当前仓库里开发 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
node ./bin/dimens-cli.js help skill

查看技能列表：

node ./bin/dimens-cli.js skill list
node ./bin/dimens-cli.js skill list --output json

查看技能详情：

node ./bin/dimens-cli.js skill info dimens-workflow
node ./bin/dimens-cli.js skill info dimens-system-orchestrator
node ./bin/dimens-cli.js skill show dimens-workflow --references
node ./bin/dimens-cli.js skill show dimens-table --mapping-only

说明：

• skill info <name> 现在除了主文件、命令映射、references 外，还会显示“推荐关键词示例”
• 这个区块用于反向说明：什么样的输入更容易命中当前 Skill
• --output json 下会返回 recommendExamples 字段

根据关键词推荐技能：

node ./bin/dimens-cli.js skill recommend 工作流 默认模型 AI 分析
node ./bin/dimens-cli.js skill recommend api-key token --output json
node ./bin/dimens-cli.js skill recommend 生成一个客户管理系统
node ./bin/dimens-cli.js skill recommend '帮我做一个项目管理平台'
node ./bin/dimens-cli.js skill recommend '生成一个审批系统' --output json

说明：

• skill recommend 支持关键词输入，也支持自然语言整句输入
• 如果输入是“生成一个 XX 系统 / 平台 / 管理系统 / 业务系统”这类系统建设需求，当前会优先推荐 dimens-system-orchestrator
• --output json 不会再污染推荐文本，参数值不会被拼进 query
• --output json 下的推荐结果除了 score，还会额外返回 matchedBy 和 reason，用于解释“为什么命中这个 Skill”

JSON 输出示例：

{
  "success": true,
  "message": "技能推荐完成",
  "data": [
    {
      "score": 22,
      "matchedBy": ["system-build-intent"],
      "reason": "命中系统建设意图",
      "skill": {
        "name": "dimens-system-orchestrator"
      }
    }
  ]
}

当前已经支持的高频解释标签包括：

• system-build-intent：系统建设意图
• workflow-intent：工作流意图
• auth-intent：鉴权接入意图
• table-intent：多维表格意图
• permission-intent：权限意图
• report-intent：报表意图

例如：

node ./bin/dimens-cli.js skill info dimens-key-auth --output json

返回结果中会包含类似：

{
  "recommendExamples": [
    "api-key token",
    "api secret 登录",
    "第三方鉴权接入"
  ]
}

使用 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

分页读取行数据：

node ./bin/dimens-cli.js row page \
  --team-id TEAM1 \
  --project-id PROJ1 \
  --sheet-id SHEET1 \
  --page 1 \
  --size 20

说明：

• row page 是当前唯一保留的行读取命令
• 不再使用 row list

调用 AI chat completions：

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

执行前显示相关 Skill 提示：

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

执行前只看 Skill 映射：

node ./bin/dimens-cli.js ai chat-completions \
  --team-id TEAM1 \
  --message "你好" \
  --show-skill mapping

执行前查看完整 Skill 文档：

node ./bin/dimens-cli.js ai chat-completions \
  --team-id TEAM1 \
  --message "你好" \
  --show-skill full

如果是系统建设类需求，也可以直接先看系统级总控 Skill：

node ./bin/dimens-cli.js skill info dimens-system-orchestrator
node ./bin/dimens-cli.js skill show dimens-system-orchestrator --references

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 命令使用指南
• skills/README.md
• 实现计划

开发命令

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 一条使用接口
• 当前 skill 命令组用于本地查看、推荐和展示 Skills，不调用后端接口
• 旧版 callTool/getTools/getSkills 文档口径已废弃，不再适用于当前实现