/**
 * A 股 / 中国金融数据渠道知识库（零依赖、零网络，随包分发）。
 *
 * 定位（DeepQuant Harness 原则）：本插件不提供数据 API、不为数据付费；
 * 提供的是渠道导航——哪里有什么数据、费用与门槛、怎么接入、教程在哪里，
 * 把数据成本决策权交给用户。
 *
 * 内容来源：官方文档与社区教程调研（2026-08）。
 */
export interface DataChannel {
    /** 渠道标识（英文小写，可查询） */
    name: string;
    /** 展示名 */
    displayName: string;
    /** 渠道类型 */
    category: 'python-lib' | 'api-platform' | 'terminal' | 'official-exchange' | 'index' | 'dsh-plugin';
    /** 官网/文档地址 */
    url: string;
    /** 费用与门槛 */
    cost: string;
    /** 数据类型（用于按类型查询） */
    dataTypes: string[];
    /** 接入步骤（要点式） */
    setup: string[];
    /** 教程/文档链接 */
    tutorialUrls: string[];
    /** 最适合的场景 */
    bestFor: string;
    /** 补充说明 */
    notes?: string;
}
export declare const DATA_CHANNELS: DataChannel[];
/** 按渠道名精确查找。 */
export declare function findChannel(name: string): DataChannel | undefined;
export interface GuideMatch {
    channel: DataChannel;
    /** 命中原因：渠道名命中或命中的数据类型 */
    matchReason: string;
}
/** 按关键词搜索：渠道名/展示名/数据类型/场景描述。返回按渠道名精确度排序的匹配。 */
export declare function searchChannels(query: string): GuideMatch[];
export interface ChannelComparison {
    name: string;
    displayName: string;
    cost: string;
    /** 是否覆盖所查数据类型 */
    covers: boolean;
    bestFor: string;
}
/** 按数据类型对比全部渠道：返回覆盖情况 + 费用门槛。 */
export declare function compareChannels(dataType: string): {
    dataType: string;
    channels: ChannelComparison[];
};
export interface AdviceRequirements {
    dataType: string;
    /** free = 免费优先；low = 可少量付费（积分/小额）；institutional = 有机构账号 */
    budget?: 'free' | 'low' | 'institutional';
    /** research = 研究探索；backtest = 历史回测；official = 权威/合规 */
    purpose?: 'research' | 'backtest' | 'official';
}
export interface AdviceEntry {
    rank: number;
    name: string;
    displayName: string;
    reason: string;
}
/** 场景决策：按数据类型 + 预算 + 用途给出渠道推荐排序与理由。 */
export declare function adviseChannels(requirements: AdviceRequirements): AdviceEntry[];
/** 渠道接入指令（agent 可执行）。 */
export interface ChannelAccessGuide {
    channel: string;
    displayName: string;
    /** 接入步骤（copy-paste 级别） */
    steps: string[];
    /** 前置条件（账号/积分/依赖） */
    prerequisites: string[];
    /** 典型调用示例（伪代码） */
    example: string;
    /** 失败时的 fallback */
    fallback: string;
}
/** 根据渠道名生成 agent 可执行的接入指南（知识库 + 启发式）。 */
export declare function channelAccessGuide(channel: string): ChannelAccessGuide;
/** 渠道接入就绪检查：给定渠道名与用户声称的环境，返回可执行结论。 */
export interface AccessReadiness {
    channel: string;
    /** 是否就绪 */
    ready: boolean;
    /** 阻塞项 */
    blockers: string[];
    /** 建议动作 */
    actions: string[];
}
/**
 * 接入就绪检查（启发式）：渠道是否有门槛、是否需要凭据、是否有依赖。
 * 用于 agent 决定"这个渠道我现在能不能直接用"。
 */
export declare function accessReadiness(channel: string, hasCredentials?: boolean): AccessReadiness;