ai-profile 0.1.3

AI 模型服务配置层：provider 预置、ai.profile 互通协议、端点拼接与连通性验证
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

//! # ai-profile
//!
//! 桌面应用的 AI 模型服务配置层：provider 预置清单、`ai.profile` 互通协议、
//! 端点拼接与连通性验证。
//!
//! ## 边界：什么进、什么不进
//!
//! | | 内容 | 归属 |
//! |---|---|---|
//! | ✅ | 预置清单、协议、端点拼接、模型清洗、验证与结构化错误、token 限额、历史裁剪 | 本 crate |
//! | ❌ | **密钥存储与加密** | 留给应用（各家差异极大） |
//! | ❌ | 数据库 / CRUD / 激活态管理 | 同上 |
//!
//! **本 crate 不持久化任何密钥明文**。验证/调用时接收调用方传入的 key，用完即弃。
//!
//! ## 三条数据铁律（都是踩出来的）
//!
//! 1. **`base_url` 原样使用，绝不推断版本段** —— 各家不统一（多数 `/v1`、智谱 `/v4`、
//!    Gemini `/v1beta/openai`）。推断错的代价是隐性的：用户照文档填对了，
//!    库悄悄加一段，他只看到 404。详见 [`endpoint`]。
//! 2. **默认 model 选「够用档」而非「最强档」** —— 把旗舰塞进默认值，
//!    等于替用户做了一个他没同意的花钱决定。
//! 3. **模型清单清洗用排除法，不用白名单** —— 厂商上新远快于特征词更新，
//!    白名单必然把新模型误藏，而"藏起来"对用户不可见。详见 [`model_filter`]。
//!
//! ## feature
//!
//! ```toml
//! ai-profile = { version = "0.1", features = ["chat"] }              # 仅对话
//! ai-profile = { version = "0.1", features = ["chat", "client"] }    # + 真实调用
//! ```
//!
//! 不开 `client` 时零 HTTP 依赖，纯数据 + 纯函数，可编到 Android / iOS。

#![forbid(unsafe_code)]
#![warn(missing_docs)]

pub mod endpoint;
pub mod error;
pub mod history;
pub mod kind;
pub mod limits;
pub mod model_filter;
pub mod preset;
pub mod protocol;

#[cfg(feature = "client")]
pub mod client;

/// 生图 / 视频 / 配音的真实调用。要同时开 `client` 与对应 kind 的 feature。
#[cfg(all(
    feature = "client",
    any(feature = "image", feature = "video", feature = "tts")
))]
pub mod media;

pub use error::VerifyError;
pub use kind::{Kind, Protocol};
pub use limits::{LimitSource, TokenLimits};
pub use preset::{preset_by_key, presets, presets_for, vendors, ProviderPreset, Vendor};
pub use protocol::{
    parse_profile, parse_profiles, to_profile, ParseError, ParsedProfile, ParsedProfiles,
};

#[cfg(feature = "client")]
pub use client::{verify, ServiceConfig, Verifier, VerifyOk};

/// 重导出 `reqwest`，供 [`client::Verifier::from_builder`] 使用。
///
/// # 为什么要重导出
///
/// `from_builder` 收的是 `reqwest::ClientBuilder` —— 一个别人 crate 的类型。
/// 下游若用自己依赖树里的 reqwest 建 builder，**版本对不上就编译不过**，
/// 而且报错信息会是「expected ClientBuilder, found ClientBuilder」这种极难懂的形式。
///
/// 重导出之后下游写 `ai_profile::reqwest::Client::builder()`，版本必然匹配。
///
/// 🔴 代价要认：这让 reqwest 的大版本进入本 crate 的公开 API。
/// 升到 reqwest 0.13 就是本 crate 的 **major** 变更，不是 patch。
#[cfg(feature = "client")]
pub use reqwest;

// ⏸ 后续阶段（见 docs/tasks/archive/2026-09/ 的规划，已归档）：
// - client::dry_run —— 真实调用（产生费用），按 kind 分实现