1. 为什么我要把 GitHub Rust 榜单做成脚本每天手动刷 GitHub Trending 的 Rust 分区翻二十个仓库、复制简介、整理 Stars 和 Forks再拼成一份日报草稿这件事做一次两次还行连着做一周就会烦。更麻烦的是榜单里混着 Rust 项目和非 Rust 项目比如用 Elixir、Python、TypeScript 写的仓库也会因为关键词命中而出现人工筛选时容易漏掉语言字段最后日报里出现「语言Elixir」却挂在 Rust 专题下的尴尬。我想要的其实很简单一条命令跑完本地生成一份 Markdown 草稿包含项目名、语言、Stars、Forks、简介和仓库链接语言字段不是 Rust 的自动标注出来方便我二次判断要不要保留。这个脚本本身不复杂真正卡住人的是「调用模型做摘要和分类」这一步——如果每个脚本都去申请一家厂商的 Key配置会散落在各个项目里换机器就得重新找。这篇就围绕这个场景用一份可复制的config.toml骨架把 TaoToken 的统一 Key 和 API 通道接进本地 Rust 榜单速览脚本批量拉取当日 Top 20 并生成日报草稿。适合已经在写 Rust 小工具、想让脚本具备「抓取 模型整理」能力的人。下面从配置到验证一步步来最后会给出一次可复现的验证动作确认榜单数据能稳定写入本地文件。2. TaoToken 在脚本里的位置与前置准备TaoToken 在这里扮演的角色是「统一入口」脚本不需要关心背后具体是哪个模型只需要一个兼容 OpenAI 格式的base_url和一个 Key。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 注意这个地址后面不加任何查询参数。前置准备只有三件事。第一注册并登录后到控制台创建一个 API Key入口在 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 创建后立刻复制页面刷新就看不到了。第二确认本地 Rust 工具链可用cargo --version能输出版本号即可。第三准备一个 GitHub 只读 Token可选因为未认证的 GitHub API 每小时只有 60 次请求跑一次榜单脚本大概要 20 多次连续调试容易触顶带上 Token 会舒服很多。这里要提醒一句Key 不要写进会提交到 Git 的文件。我的做法是config.toml里只放占位符真实 Key 通过环境变量注入脚本读取时优先环境变量、其次配置文件。这样即使配置文件被误传也不会泄露。如果你只是想先验证模型通道是否通可以打开模型对话页面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 手动发一条消息确认返回正常再回到脚本里配置。这个顺序能帮你排除「到底是网络问题还是代码问题」。3. 可复制的 config.toml 骨架与脚本结构先看配置文件。我把它放在项目根目录命名为config.toml结构分成三段模型通道、GitHub 抓取、输出路径。字段名尽量直白方便你按自己习惯改。# config.toml [llm] # 统一走 TaoToken 的 OpenAI 兼容通道 base_url https://taotoken.net/api api_key env:TAOTOKEN_API_KEY # 支持 env: 前缀从环境变量读取 model gpt-4o-mini # 换成你账号下可用的模型名 timeout_secs 60 max_retries 3 [github] # 可选GitHub 只读 Token同样支持 env: 前缀 token env:GITHUB_TOKEN trending_url https://api.github.com/search/repositories language rust per_page 20 sort stars order desc [output] dir ./reports filename_pattern rust-trending-{date}.md date_format %Y-%m-%dapi_key env:TAOTOKEN_API_KEY这种写法是我自己约定的脚本里解析时判断前缀是env:就去读环境变量。你也可以直接写明文但我不推荐。设置环境变量的方式Linux/macOS 用export TAOTOKEN_API_KEY你的KeyWindows PowerShell 用$env:TAOTOKEN_API_KEY你的Key。接下来是脚本的依赖。用cargo new rust-trending-daily建项目Cargo.toml里加这些[package] name rust-trending-daily version 0.1.0 edition 2021 [dependencies] tokio { version 1, features [full] } reqwest { version 0.12, features [json, rustls-tls] } serde { version 1, features [derive] } serde_json 1 toml 0.8 anyhow 1 chrono 0.4这里选rustls-tls而不是默认的 native-tls是为了避免部分环境缺少 OpenSSL 开发库导致编译失败这个坑我在两台机器上踩过。tokio用 full feature 是为了省事实际只用到 rt 和 macros 的话可以裁剪。脚本主流程分四步读配置、拉 GitHub 榜单、对每个仓库调用模型生成一句话摘要、把结果拼成 Markdown 写入文件。下面把关键部分拆开讲。3.1 读取配置与解析 env 前缀use serde::Deserialize; use std::env; #[derive(Deserialize)] struct Config { llm: LlmConfig, github: GithubConfig, output: OutputConfig, } #[derive(Deserialize)] struct LlmConfig { base_url: String, api_key: String, model: String, timeout_secs: u64, max_retries: u32, } #[derive(Deserialize)] struct GithubConfig { token: String, trending_url: String, language: String, per_page: u32, sort: String, order: String, } #[derive(Deserialize)] struct OutputConfig { dir: String, filename_pattern: String, date_format: String, } fn resolve_env(value: str) - String { if let Some(key) value.strip_prefix(env:) { env::var(key).unwrap_or_default() } else { value.to_string() } } fn load_config(path: str) - anyhow::ResultConfig { let raw std::fs::read_to_string(path)?; let mut cfg: Config toml::from_str(raw)?; cfg.llm.api_key resolve_env(cfg.llm.api_key); cfg.github.token resolve_env(cfg.github.token); Ok(cfg) }resolve_env只处理env:前缀其他情况原样返回。这样配置文件里既能写明文也能写环境变量引用迁移时不用改结构。3.2 拉取 GitHub 榜单GitHub 的 search API 支持按语言和 stars 排序正好满足「Rust 热度排行榜 Top 20」的需求。注意qlanguage:rust这个查询会把主语言标记为 Rust 的仓库筛出来比 Trending 页面更稳定也更容易分页。use serde::Deserialize; #[derive(Deserialize)] struct SearchResp { items: VecRepo, } #[derive(Deserialize)] struct Repo { full_name: String, html_url: String, description: OptionString, language: OptionString, stargazers_count: u64, forks_count: u64, } async fn fetch_top_repos(cfg: GithubConfig) - anyhow::ResultVecRepo { let client reqwest::Client::builder() .user_agent(rust-trending-daily/0.1) .build()?; let mut req client .get(cfg.trending_url) .query([ (q, format!(language:{}, cfg.language)), (sort, cfg.sort.clone()), (order, cfg.order.clone()), (per_page, cfg.per_page.to_string()), ]); if !cfg.token.is_empty() { req req.header(Authorization, format!(Bearer {}, cfg.token)); } let resp: SearchResp req.send().await?.error_for_status()?.json().await?; Ok(resp.items) }user_agent必须设置GitHub API 对没有 UA 的请求会直接拒绝这是新手最容易忽略的一点。返回的items就是仓库数组字段名和 GitHub 文档一致。3.3 调用 TaoToken 生成摘要这一步是脚本和模型通道的衔接点。请求体用 OpenAI 兼容格式messages里放系统提示和用户内容用户内容里带上仓库名、语言、Stars 和原始描述让模型输出一句中文摘要并标注语言是否真的是 Rust。use serde_json::json; async fn summarize_repo( client: reqwest::Client, cfg: LlmConfig, repo: Repo, ) - anyhow::ResultString { let prompt format!( 仓库{}\n语言{}\nStars{}\nForks{}\n原始描述{}\n\n\ 请用一句中文概括这个项目做什么并判断它的主语言是否为 Rust。\ 输出格式摘要 | 主语言语言 | 是否Rust是/否, repo.full_name, repo.language.as_deref().unwrap_or(未知), repo.stargazers_count, repo.forks_count, repo.description.as_deref().unwrap_or(无描述), ); let body json!({ model: cfg.model, messages: [ {role: system, content: 你是技术日报编辑输出简洁准确不编造信息。}, {role: user, content: prompt} ], temperature: 0.3 }); let url format!({}/v1/chat/completions, cfg.base_url.trim_end_matches(/)); let resp client .post(url) .bearer_auth(cfg.api_key) .json(body) .send() .await? .error_for_status()? .json::serde_json::Value() .await?; let text resp[choices][0][message][content] .as_str() .unwrap_or(摘要生成失败) .to_string(); Ok(text) }注意 URL 拼接base_url是https://taotoken.net/api补上/v1/chat/completions后是https://taotoken.net/api/v1/chat/completions。trim_end_matches(/)是为了防止配置里多写了斜杠导致双斜杠。bearer_auth会自动加Authorization: Bearer key头。max_retries字段这里没展开实际用的时候可以在send外面包一层循环遇到 429 或 5xx 时按指数退避重试最多max_retries次。这个逻辑不复杂但能显著提升批量请求的成功率。3.4 拼装 Markdown 并写入文件async fn write_report( cfg: OutputConfig, repos: [Repo], summaries: [String], ) - anyhow::ResultString { let date chrono::Local::now().format(cfg.date_format).to_string(); let filename cfg.filename_pattern.replace({date}, date); let path std::path::Path::new(cfg.dir).join(filename); std::fs::create_dir_all(cfg.dir)?; let mut md String::new(); md.push_str(format!(# GitHub Rust 热门项目日报{}\n\n, date)); md.push_str(| # | 项目 | 语言 | Stars | Forks | 摘要 |\n); md.push_str(|---|------|------|-------|-------|------|\n); for (i, (repo, summary)) in repos.iter().zip(summaries.iter()).enumerate() { md.push_str(format!( | {} | [{}]({}) | {} | {} | {} | {} |\n, i 1, repo.full_name, repo.html_url, repo.language.as_deref().unwrap_or(未知), repo.stargazers_count, repo.forks_count, summary.replace(\n, ), )); } std::fs::write(path, md)?; Ok(path.display().to_string()) }摘要里的换行要替换成空格否则会破坏 Markdown 表格结构。写入前先create_dir_all避免目录不存在时报错。4. 一次可复现的验证请求配置和代码都齐了现在做一次最小验证确认榜单数据能稳定写入本地文件。先设置环境变量export TAOTOKEN_API_KEY你的Key export GITHUB_TOKEN你的GitHub只读Token然后跑脚本cargo run --release预期输出类似已拉取 20 个仓库 [1/20] emilk/egui 摘要完成 [2/20] actix/examples 摘要完成 ... 报告已写入./reports/rust-trending-2026-08-31.md打开生成的 Markdown应该能看到一个 20 行的表格每行包含项目名、语言、Stars、Forks 和一句中文摘要。如果某个仓库的主语言不是 Rust比如榜单里混进来的 Elixir 或 Python 项目摘要末尾的「是否Rust否」会提示你方便决定是否保留。想单独验证模型通道是否通可以先用 curl 发一条最小请求curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: 回复两个字通了}] }返回 JSON 里choices[0].message.content是「通了」说明 Key 和通道都正常。这一步能帮你把「脚本问题」和「通道问题」分开定位。验证通过后你可以把脚本挂到 cron 或 Windows 任务计划里每天早上自动生成日报草稿。我自己的习惯是生成后人工扫一遍把明显不相关的项目删掉再补几句点评这样日报既有自动化效率又保留人工判断。5. 本篇常见错排查报错一401 Unauthorized或invalid api key。先确认环境变量是否真的注入成功echo $TAOTOKEN_API_KEY看有没有输出。如果配置文件里写的是明文检查有没有多余空格。还有一种情况是 Key 被复制时带了换行用tr -d \n清理一下。报错二403 rate limit exceeded。这是 GitHub API 的限流不是 TaoToken 的问题。未认证请求每小时 60 次认证后 5000 次。检查GITHUB_TOKEN是否设置以及请求头里Authorization: Bearer有没有拼错。如果只是调试把per_page临时改成 5 减少请求量。报错三error decoding response body。通常是模型返回的 JSON 结构和预期不符。先用第 4 节的 curl 命令确认返回格式再检查脚本里resp[choices][0][message][content]的路径。如果模型返回的是流式格式需要改成stream: false或解析 SSE。报错四编译时failed to find openssl。这是 reqwest 默认启用 native-tls 导致的。按第 3 节的Cargo.toml改成rustls-tls即可不需要额外安装系统库。报错五写入文件时No such file or directory。检查output.dir路径脚本里已经调用了create_dir_all但如果路径是相对路径运行目录不同结果会不同。建议用绝对路径或者在脚本启动时打印当前工作目录确认。报错六摘要内容为空或乱码。检查temperature是否设得过高以及 prompt 里是否包含特殊字符。另外如果模型名写错部分服务会返回空内容而不是报错建议先用 curl 验证模型名可用。6. 把 Key 和通道固定下来之后脚本跑通之后真正省心的地方在于以后不管写多少个类似的小工具模型通道这一层都不用再动。config.toml里那几行base_url和api_key就是全部复制到新项目里改改输出路径就能用。我试过把同一份配置同时用在榜单脚本、提交信息生成和 README 翻译上切换成本几乎为零。如果你接下来想让脚本具备更强的整理能力比如自动给项目打标签、按用途分组、生成周报对比那模型调用量会上去可以考虑用 Coding Plan 这类长期方案入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有不同语言的调用示例遇到参数不确定时翻一下比猜快。最后留一个实用技巧把生成的日报文件按日期归档到reports/目录下再用一个简单的ls -t reports/ | head -7就能看到最近一周的榜单对比 Stars 变化时不用重新跑脚本。这个习惯坚持下来你会发现自己对 Rust 生态的动向比刷 Trending 页面清楚得多。