# @backtest-kit/sidekick 中文文档

规范地址：https://npmcn.com/package/%40backtest-kit/sidekick/

版本：23\.7\.0
npm 元数据更新时间：2026-10-29T15:14:05.819Z
中文译文更新时间：2026-11-07T19:23:20.645Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40backtest-kit/sidekick
原文对照：https://npmcn.com/package/%40backtest-kit/sidekick/?lang=original
项目主页：https://backtest-kit.github.io/documents/article_07_ai_news_trading_signals.html
源码仓库：https://github.com/tripolskypetr/backtest-kit

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：95.4 kB，49 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：4 个
- 首次发布：2026-01-15T07:42:26.973Z
- 最新版本发布：2026-10-29T15:14:04.704Z
- 近 30 天下载量：2979（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：176（近 12 个月 176 个）

## 中文简介

创建新的 Backtest Kit 交易机器人项目最简单的方法. 如创建-反应-应用,但用于与LLM集成和技术分析的算法交易.

## 安装

```sh
npm install @backtest-kit/sidekick
```

也可以使用：`pnpm add @backtest-kit/sidekick`、`yarn add @backtest-kit/sidekick`、`bun add @backtest-kit/sidekick`

## README

# @ kit/ sidekick

> 最快的启动方式 [反测试- kit](https://www.npmjs.com/package/backtest-kit) -但是 _全控_ 一个 脚手架是一个完整的多时间框架加密策略,每条线(交换、帧、风险、动作、跑道)在其中可编辑源 **** 项目:Pine Script中的4H趋势滤波器+15m信号生成器,部分取利,断向后行站,以及风险验证.

![screenshot](https://raw.githubusercontent.com/tripolskypetr/backtest-kit/HEAD/assets/screenshots/screenshot16.png)

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/tripolskypetr/backtest-kit) [![npm](https://img.shields.io/npm/v/@backtest-kit/sidekick.svg?style=flat-square)](https://npmjs.org/package/@backtest-kit/sidekick) [![License](https://img.shields.io/npm/l/@backtest-kit/sidekick.svg)](https://github.com/tripolskypetr/backtest-kit/blob/master/LICENSE)

📚 **[文档](https://backtest-kit.github.io/documents/article_07_ai_news_trading_signals.html)** • 妇女 **[参考执行情况](https://github.com/tripolskypetr/backtest-kit/tree/master/example)** • 妇女 **[GitHub 图像](https://github.com/tripolskypetr/backtest-kit)**

```bash
npx -y @backtest-kit/sidekick my-trading-bot
cd my-trading-bot && npm start
```

* * *

## (原始内容存档于2018-03-21). Init vs. Sidekick——选择控制级别

`@backtest-kit/cli --init` 保持锅炉板 _内部_ cLI; 您的 Repo 只持有策略文件 . **Sidekick是"弹出":** 它将整个线条——交换适配器,帧,风险规则,动作,靴子,跑道——写成你项目中简单,可编辑的来源,循环中没有CLI,没有隐藏. 在您想要阅读和拥有每行时选择 Sidekick, 而不仅仅是策略.

从盒子里得到的东西: 一个有效的多时框架 Pine 脚本策略( 4H 趋势 + 15m 信号), SL/ TP 距离风险验证, 部分利润 + 断面跟踪站, 缓存设施和调试脚本, a `CLAUDE.md` 用于AI辅助迭代,以及环境配置.

-   🚀 **零配置** - 一个命令,没有设置.
-   📊 **多时间框架** ——4H通向滤波器(RSI+MACD+ADX)+15m条目(EMA交叉+音量突起+动力).
-   📜 **松脚本 v5** 地方战略通过 `@backtest-kit/pinets`没有贸易维尤.
-   🛡️ **风险管理** ——SL/TP距离验证,33/33/34部分利润,断面后追.
-   🔄 **整个生命周期** 预定/开放/关闭/取消活动记录.
-   🔌 **通过 CCXT 的二进制** ——OHLCV,订单-书深,勾选精确格式.
-   🕐 **历史框架** ——公牛,锐地投出,并预定了侧道期.
-   🎨 **网络仪表板** —— 说 `@backtest-kit/ui` 绘制图表.
-   💾 **崩溃安全存储** ——原子持久性,用于后测活.

* * *

## 它的脚手架策略

4H 趋势过滤器(时间范围 4h.pine)

从三个指标对市场制度进行分类:

| 制度 | 条件 |
| --- | --- |
| **允许长度** | ADX > 25, MACD直方图 > 0, DI+ > DI−, RSI > 50 |
| **允许快速** | ADX > 25,MACD直方图 < 0,DI− > DI+,RSI < 50 |
| **允许两个** | 强劲趋势,没有明确的公牛/熊制度 |
| **无贸易** | ADX 25(弱趋势) |

15m信号生成器(时间范围 15m.pine)

经体积和动力证实的EMA交叉:

-   **长** ——EMA(5)跨越EMA(13),RSI 40-65,价格高于EMA(50),体积猛增(>1.5×MA),正势头.
-   **短数** ——EMA(5)跨出EMA(13)下,RSI 35-60下,价格低于EMA(50)下,体积猛增,负势.
-   **SL/TP 软件** ——静态2%/3%出入口. **信号过期** - 5条.

风险过滤器和位置管理

**风险过滤器 :** 拒绝 SL 距离 < 0.2% 或 TP 距离 < 0.2% (滑行保护); 执行趋势对齐(熊制度拒绝长,公牛制度拒绝短) .

**职位管理:** 部分利润分为三个层次——33%的TP3,33%的TP2,34%的TP1;当达到断面时,后端站降低3分.

后测试框架

| 框架 | 期间 | 市场说明 |
| --- | --- | --- |
| `February2024` | 2024年2月1日至29日,纽约 | 公牛跑动 |
| `October2025` | 2025年10月1日至31日,纽约 | 10月9-11日,美国 |
| `November2025` | 2025年11月1日至30日,日内瓦 | 有下行趋势的侧道 |
| `December2025` | 2025年12月1日至31日,日内瓦 | 侧道,没有清晰的方向 |

* * *

## 生成的项目结构

在您的工程中, 下方所有土地都作为可编辑的源头 _实值_ 包裹的交付.

全树

```
my-trading-bot/
├── src/
│   ├── index.mjs                  # Entry point — loads config, logic, bootstrap
│   ├── main/bootstrap.mjs         # Mode dispatcher (backtest / paper / live)
│   ├── config/
│   │   ├── setup.mjs              # Logger, storage, notifications, UI server
│   │   ├── validate.mjs          # Schema validation for all enums
│   │   ├── params.mjs            # Environment variables (Ollama API key)
│   │   └── ccxt.mjs              # Binance exchange singleton via CCXT
│   ├── logic/
│   │   ├── strategy/main.strategy.mjs    # Main strategy — multi-TF signal logic
│   │   ├── exchange/binance.exchange.mjs # Exchange schema — candles, order book, formatting
│   │   ├── frame/*.frame.mjs             # Backtest time frames (Feb 2024, Oct–Dec 2025)
│   │   ├── risk/sl_distance.risk.mjs     # Stop-loss distance validation (≥0.2%)
│   │   ├── risk/tp_distance.risk.mjs     # Take-profit distance validation (≥0.2%)
│   │   └── action/
│   │       ├── backtest_partial_profit_taking.action.mjs
│   │       ├── backtest_lower_stop_on_breakeven.action.mjs
│   │       └── backtest_position_monitor.action.mjs
│   ├── classes/
│   │   ├── BacktestPartialProfitTakingAction.mjs  # Scale out at 3 TP levels
│   │   ├── BacktestLowerStopOnBreakevenAction.mjs # Trailing stop on breakeven
│   │   └── BacktestPositionMonitorAction.mjs      # Position event logger
│   ├── math/
│   │   ├── timeframe_4h.math.mjs   # 4H trend data — RSI, MACD, ADX, DI+/DI−
│   │   └── timeframe_15m.math.mjs  # 15m signal data — EMA, ATR, volume, momentum
│   ├── enum/                       # String constants for type-safe schema refs
│   └── utils/getArgs.mjs           # CLI argument parser with defaults
├── config/source/
│   ├── timeframe_4h.pine    # Pine Script v5 — Daily Trend Filter (RSI/MACD/ADX)
│   └── timeframe_15m.pine   # Pine Script v5 — Signal Strategy (EMA/ATR/Volume)
├── scripts/
│   ├── run_timeframe_15m.mjs # Standalone 15m Pine Script runner
│   ├── run_timeframe_4h.mjs  # Standalone 4H Pine Script runner
│   └── cache/
│       ├── cache_candles.mjs     # Pre-download OHLCV candles (1m/15m/4h)
│       ├── validate_candles.mjs  # Verify cached candle data integrity
│       └── cache_model.mjs       # Pull Ollama LLM model with progress bar
├── docker/ollama/
│   ├── docker-compose.yaml   # Ollama GPU container setup
│   └── watch.sh              # nvidia-smi monitor
├── CLAUDE.md                 # AI strategy development guide
├── .env                      # Environment variables
└── package.json
```

* * *

## CLI 选项和依赖性

```bash
npx -y @backtest-kit/sidekick my-bot   # named project
npx -y @backtest-kit/sidekick .        # current directory (must be empty)
```

已安装的依赖

| 软件包 | 目的 |
| --- | --- |
| [反测试- kit](https://www.npmjs.com/package/backtest-kit) | 核心反测试/交易框架 |
| [@ backtest- kit/ pitchts (英语)](https://www.npmjs.com/package/@backtest-kit/pinets) | 松脚本 v5 节点运行时间.js |
| [@ backtest- kit/ ui (英语)](https://www.npmjs.com/package/@backtest-kit/ui) | 交互式制图仪表板 |
| [@backtest-kit/ollama (英语)](https://www.npmjs.com/package/@backtest-kit/ollama) | LLM 推论集成 |
| [页:1](https://github.com/ccxt/ccxt) | Binance 交换连接 |
| [functools - kit (英语)](https://www.npmjs.com/package/functools-kit) | `singleshot`, (中文(简体) ), `randomString` 水电费 |
| [皮诺克语name](https://www.npmjs.com/package/pinolog) | 基于文件的结构化记录 |
| [打开](https://www.npmjs.com/package/openai) | OpenAI API 客户端 |
| [奥拉玛](https://www.npmjs.com/package/ollama) | Ollama 本地 LLM 客户端 |

## 链接

[文档](https://backtest-kit.github.io/documents/article_07_ai_news_trading_signals.html) • 妇女 [GitHub 图像](https://github.com/tripolskypetr/backtest-kit) • 妇女 [参考执行情况](https://github.com/tripolskypetr/backtest-kit/tree/master/example)

## \* 贡献

找到错误还是想要一个特性? [打开一个问题](https://github.com/tripolskypetr/backtest-kit/issues) 或提交公关.

## 许可证

麻省理工学院 [特立奥尔斯基平板电脑](https://github.com/tripolskypetr)

## 常见问题

### @backtest-kit/sidekick 是什么？

创建新的 Backtest Kit 交易机器人项目最简单的方法\. 如创建-反应-应用,但用于与LLM集成和技术分析的算法交易\.

### 如何安装 @backtest-kit/sidekick？

在项目目录运行 npm install @backtest-kit/sidekick，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 sidekick，可以用 npx sidekick 直接运行。

### @backtest-kit/sidekick 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/backtest-kit\_\_sidekick 是否存在。

### @backtest-kit/sidekick 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @backtest-kit/sidekick 可以商用吗？

@backtest-kit/sidekick 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @backtest-kit/sidekick 的下载量有多少？

根据 npm 官方下载统计，@backtest-kit/sidekick 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,979 次，日均约 99 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @backtest-kit/sidekick 还在维护吗？

最新版本 23\.7\.0 发布于 2026/10/29（9 天前）；至今共发布 176 个版本，其中过去 12 个月发布了 176 个；首次发布于 2026/01/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。