name: bknd-repo-search-with-opencode description: 使用 btca CLI 查询 bknd 源代码仓库时使用。涵盖设置、配置和查询模式,用于学习 bknd 内部结构,包括数据模块、认证、媒体处理和适配器配置。 compatibility: 需要 bun 或 npm、btca、opencode-ai 以及互联网访问
使用 btca 查询 bknd
btca 是一个用于询问 git 仓库问题的 CLI 工具。它克隆仓库、索引它们,并使用 AI 回答问题。
快速设置
# 安装 btca 和 OpenCode
bun add -g btca opencode-ai
# 配置模型(Big Pickle:免费、快速、出奇的好)
btca config model --provider opencode --model big-pickle
# 将 bknd 添加为资源
btca config resources add --name bknd --type git --url https://github.com/bknd-io/bknd --branch main
或创建 btca.config.jsonc:
{
"$schema": "https://btca.dev/btca.schema.json",
"model": "big-pickle",
"provider": "opencode",
"providerTimeoutMs": 300000,
"resources": [
{
"type": "git",
"name": "bknd",
"url": "https://github.com/bknd-io/bknd",
"branch": "main"
}
]
}
核心命令
提问
btca ask --resource bknd --question "如何定义模式?"
交互式聊天
btca chat --resource bknd
启动 TUI
btca
参考文件
详细信息请参见:
- setup.md - 完整安装、配置选项、资源管理、解决设置问题
- query-patterns.md - 针对数据、认证、媒体、适配器和框架集成的特定查询模式
- advanced.md - 多资源查询、交互式工作流、性能优化、调试
查询最佳实践
- 具体化 - “如何定义具有一对多关系的模式?” 对比 “如何使用数据模块?”
- 提供上下文 - “我正在使用 Cloudflare Workers。如何配置数据库适配器?”
- 请求示例 - “展示设置密码认证的完整示例”
- 引用特定文件 - “src/App.ts 如何初始化模块?”
学习工作流
- 探索高层级:询问整体架构和主要模块
- 模块深入:使用
btca chat --resource bknd专注于一个模块 - 实现细节:询问查看特定功能实现
- 示例与模式:查询示例目录以获取最佳实践
资源
- btca 文档:https://btca.dev
- bknd 文档:https://docs.bknd.io
- bknd 仓库:https://github.com/bknd-io/bknd