SuperAPI AI 工具集

btca-cli

编程与开发

查看项目

更新于 10-15 15:14

技能介绍

用途

btca 是一个以源码为先(source-first)的研究型 CLI。它先将资源(git、本地、npm)抓取为可搜索的上下文,然后基于这些来源回答问题。既可以使用已配置的资源进行长期工作,也可以在 btca ask 中直接使用一次性的匿名资源。

主要能力

  • 添加资源,支持三种类型:git 仓库、本地目录、npm 包。
  • 查看与管理已配置的资源。
  • 基于一个或多个资源提问,回答以这些来源为依据。
  • 在提问时临时使用匿名的一次性资源,不会保存到配置中。
  • 支持项目级与全局配置文件,项目配置覆盖全局配置。

使用方式

添加资源:

# Git 资源
btca add -n svelte-dev https://github.com/sveltejs/svelte.dev

# 本地目录
btca add -n my-docs -t local /absolute/path/to/docs

# npm 包
btca add npm:@types/node@22.10.1 -n node-types -t npm

验证资源:

btca resources

提问:

btca ask -r svelte-dev -q "How do I define remote functions?"

多资源提问:

btca ask -r react -r typescript -q "How do I type useState?"

使用匿名一次性资源提问(不保存到配置):

# 一次性 git 仓库
btca ask -r https://github.com/sveltejs/svelte -q "Where is the implementation of writable stores?"

# 一次性 npm 包
btca ask -r npm:react@19.0.0 -q "How is useTransition exported?"

配置说明

配置位于 btca.config.jsonc(项目)和 ~/.config/btca/btca.config.jsonc(全局)。项目配置覆盖全局配置,并控制 provider、model 和资源。

常见问题排查

  • "No resources configured":使用 btca add ... 添加资源,然后重新运行 btca resources。
  • "Provider not connected":运行 btca connect 并按提示操作。
  • "Unknown resource":用 btca resources 查看已配置的名称,或在 btca ask 中传入有效的 HTTPS git URL / npm:<package> 作为匿名一次性资源。

限制

资料未提供关于平台支持、收费、性能、回答准确度等更多信息。完整 CLI 参考见 https://docs.btca.dev/guides/cli-reference。