// apiKey accepts a single key OR an array → automatic rotation across calls
const wrappedFn = ollama(myFn, 'llama3.3:70b', ['key1', 'key2', 'key3']);

所有12个都有一个签名—— <T>(fn: T, model: string, apiKey?: string | string[]) => T 运行 fn 内部 ContextService.runInContext({ apiKey, inference, model })匹配 InferenceName enum + 每个提供者 client/*Provider.client.ts + 键 config/*.ts 解决实际的 SDK 呼叫.

// schema/Signal.schema.ts
import { z } from 'zod';
export const SignalSchema = z.object({
  position: z.enum(['long', 'short', 'wait']).describe('long: bullish · short: bearish · wait: unclear'),
  price_open: z.number().describe('Entry price in USD'),
  price_stop_loss: z.number().describe('LONG: below entry · SHORT: above entry'),
  price_take_profit: z.number().describe('LONG: above entry · SHORT: below entry'),
  minute_estimated_time: z.number().describe('Estimated minutes to reach TP'),
  risk_note: z.string().describe('Whale manipulation, order-book imbalance, divergences — with numbers'),
});
export type TSignalSchema = z.infer<typeof SignalSchema>;

// outline/signal.outline.ts
import { addOutline } from 'agent-swarm-kit';
import { zodResponseFormat } from 'openai/helpers/zod';
import { SignalSchema, TSignalSchema } from '../schema/Signal.schema';
import { CompletionName } from '@backtest-kit/ollama';

addOutline<TSignalSchema>({
  outlineName: 'SignalOutline',
  completion: CompletionName.RunnerOutlineCompletion,
  format: zodResponseFormat(SignalSchema, 'position_decision'),
  getOutlineHistory: async ({ history, param: messages = [] }) => { await history.push(messages); },
  validations: [{
    validate: ({ data }) => {
      if (data.position === 'long'  && data.price_stop_loss >= data.price_open) throw new Error('LONG: SL must be below entry');
      if (data.position === 'short' && data.price_stop_loss <= data.price_open) throw new Error('SHORT: SL must be above entry');
    },
  }],
});

import { addOutline, IOutlineFormat } from 'agent-swarm-kit';
import { CompletionName } from '@backtest-kit/ollama';

const format: IOutlineFormat = {
  type: 'object',
  properties: {
    take_profit_price: { type: 'number', description: 'Take profit price in USD' },
    stop_loss_price:   { type: 'number', description: 'Stop-loss price in USD' },
    description:       { type: 'string', description: 'User-friendly risk explanation, min 10 sentences' },
    reasoning:         { type: 'string', description: 'Technical analysis, min 15 sentences' },
  },
  required: ['take_profit_price', 'stop_loss_price', 'description', 'reasoning'],
};

addOutline({
  outlineName: 'SignalOutline', format, completion: CompletionName.RunnerOutlineCompletion,
  prompt: 'Generate crypto trading signals from price & volume indicators in JSON.',
  getOutlineHistory: async ({ history, param }) => {
    const report = await ioc.signalReportService.getSignalReport(param);
    await commitReports(history, report);
    await history.push({ role: 'user', content: 'Generate JSON based on reports.' });
  },
  validations: [
    { docDescription: 'Stop-loss vs max loss %',  validate: ({ data }) => { if (data.action === 'buy' && percentDiff(data.current_price, data.stop_loss_price)   > CC_LADDER_STOP_LOSS)   throw new Error(`SL must not exceed -${CC_LADDER_STOP_LOSS}%`); } },
    { docDescription: 'Take-profit vs max profit %', validate: ({ data }) => { if (data.action === 'buy' && percentDiff(data.current_price, data.take_profit_price) > CC_LADDER_TAKE_PROFIT) throw new Error(`TP must not exceed +${CC_LADDER_TAKE_PROFIT}%`); } },
  ],
});

// config/prompt/signal.prompt.cjs
module.exports = {
  system: (symbol, strategyName, exchangeName, frameName, backtest) => [
    `You are analyzing ${symbol} on ${exchangeName}`,
    `Strategy: ${strategyName}, Timeframe: ${frameName}`,
    backtest ? 'Backtest mode' : 'Live mode',
  ],
  user: (symbol) => `Analyze ${symbol} and return a trading decision`,
};

import { Module, Prompt, commitPrompt, MessageModel } from '@backtest-kit/ollama';

// from a .cjs module (default baseDir: {cwd}/config/prompt/), memoized
const signalModule = Module.fromPath('./signal.prompt.cjs');
// or inline
const inline = Prompt.fromPrompt({ system: ['You are a trading bot'], user: (symbol) => `Trend for ${symbol}?` });

const messages: MessageModel[] = [];
await commitPrompt(signalModule, messages);   // pushes rendered system + user messages with context

完整策略: 注册大纲, 从一个快速, 请求结构化的 JSON , 用一个提供者 HOF 包:

import './outline/signal.outline';
import { deepseek, Module, commitPrompt, MessageModel } from '@backtest-kit/ollama';
import { addStrategy } from 'backtest-kit';
import { json } from 'agent-swarm-kit';

const signalModule = Module.fromPath('./signal.prompt.cjs');
const getSignal = async () => {
  const messages: MessageModel[] = [];
  await commitPrompt(signalModule, messages);
  const { data } = await json('SignalOutline', messages);
  return data;
};
addStrategy({ strategyName: 'llm-signal', interval: '5m',
  getSignal: deepseek(getSignal, 'deepseek-chat', process.env.DEEPSEEK_API_KEY) });

进 {outputDir}/{signalId}/ (默认) ./dump/strategy: 00_system_prompt.md (系统信息+产出摘要),编号 XX_user_message.md 编号 : XX_assistant_message.md 每转一圈,最后 XX_llm_output.md 信号DTO。 打电话来 getSignal 在返回信号之前.

import { Optimizer, addOptimizerSchema, listenOptimizerProgress } from '@backtest-kit/ollama';

// describe sources, training ranges, strategy/template generation (see IOptimizer* interfaces)
addOptimizerSchema({ optimizerName: 'my-optimizer', /* sources, ranges, strategy, template */ });

listenOptimizerProgress((p) => console.log(p)); // ProgressOptimizerContract

const strategies = await Optimizer.getData('BTCUSDT', { optimizerName: 'my-optimizer' }); // metadata + LLM context per range
const code       = await Optimizer.getCode('BTCUSDT', { optimizerName: 'my-optimizer' }); // full TS/JS source as string
await Optimizer.dump('BTCUSDT', { optimizerName: 'my-optimizer' }, './output');           // writes {optimizerName}_{symbol}.mjs

getData 从所有来源获取并构建每个培训范围的LLM对话; getCode 组装可执行战略; dump 写给 {optimizerName}_{symbol}.mjs配套登记功能: getOptimizerSchema, (中文(简体) ), listOptimizerSchema,以及 listenError它背后的发动机是 common/ClientOptimizer.ts 驾驶员: IOptimizer* 接口( e)IOptimizerSchema, (中文(简体) ), IOptimizerSource, (中文(简体) ), IOptimizerStrategy, (中文(简体) ), IOptimizerTemplate, (中文(简体) ), IOptimizerRange, (中文(简体) ), IOptimizerData, (中文(简体) ), IOptimizerFetchArgs, (中文(简体) ), IOptimizerFilterArgs, (中文(简体) ), IOptimizerCallbacks) (中文(简体) ).

• function/signal.function.ts ——12家供应商HOF. function/{add,get,list,event,setup,validate,history,dump,signal}.ts 登记、活动、, setLogger, (中文(简体) ), commitPrompt, (中文(简体) ), dumpSignalData。 。 。 .
• client/*Provider.client.ts (12) – 提供方SDK适配器. config/*.ts ——每个提供者基础URL/段落, ollama.rotate.ts (按键旋转), params.ts, (中文(简体) ), emitters.ts。 。 。 .
• classes/ —— 说 Module, (中文(简体) ), Prompt, (中文(简体) ), Optimizer。 。 。 . common/ClientOptimizer.ts ——优化引擎.
• enum/ —— 说 InferenceName (12个), CompletionName。 。 。 . interface/Optimizer.interface.ts, (中文(简体) ), contract/ProgressOptimizer.contract.ts, (中文(简体) ), model/{Message,Prompt}.model.ts。 。 。 .
• helpers/{toLintMarkdown,toPlainString}.ts, (中文(简体) ), lib/ (IoC: core/{di,provide,types}服务)。 没有 src/ 没有证件.