企业官网建设流程全解析

1. WPF 炒股辅助工具为什么需要统一 Key 接入

做 WPF 桌面端炒股辅助工具，最容易被低估的不是界面，而是数据接入这一层。界面用 XAML 拖一拖、DataGrid 绑一绑就能出效果，但真正决定这个工具能不能长期用下去的，是行情、财务、选股因子这些数据从哪来、怎么调、Key 怎么管。我见过太多个人开发者写的选股工具，代码里散落着三四个不同平台的 Key，有的写死在App.config，有的塞进Settings.settings，换一个数据源就要全局搜索替换，维护成本极高。

StockPicker 这个选股工具的思路是把「策略筛选」和「数据接入」拆开：策略是本地逻辑，数据走统一通道。这样你在 WPF 里勾选「均线多头排列」「缩量回踩阳线」这些条件时，背后真正发出去的是一次标准化的选股请求，而不是每个策略各自去连一个数据源。TaoToken 在这里扮演的角色就是那个统一入口——一个 Key、一个 Base URL，把模型能力和数据调用收敛到一条链路上。

这篇文章面向的是已经在写 WPF 桌面工具、或者准备用 C# 做一个选股辅助程序的开发者。你不需要先懂大模型，只要会写HttpClient、会读 JSON、会在 WPF 里做异步绑定，就能跟着把整条链路跑通。核心检索词就三个：WPF、StockPicker、选股工具。我会从项目结构讲到可复制的配置片段，再到一次真实的选股请求验证，最后把常见的 401、超时、反序列化报错挨个排掉。

先说清楚定位：StockPicker 只做技术条件筛选，结果仅供参考，不构成投资建议。这句话不是客套，是这类工具的产品边界。你把它当成一个「把多个技术指标组合起来快速过滤股票池」的辅助器就好，别指望它替你决策。理解了这个边界，后面的接入设计反而更清晰——我们要的是一个稳定、可替换、Key 集中管理的调用链路，而不是一个黑盒预测器。

WPF 的优势在于它天生适合做这种「左侧参数区 + 右侧结果表格」的桌面工具。左侧勾选策略、选组合方式、选股票池，右侧 DataGrid 展示命中结果，中间用async/await把耗时请求丢到后台线程，UI 不卡。这套结构配上统一 Key 接入，就是一个能自己长期迭代的选股工具骨架。下面进入具体配置。

2. TaoToken 前置准备：Key、Base URL 与 StockPicker 调用链路

在动手改 WPF 代码之前，先把 TaoToken 这边的三件套准备好：API Key、Base URL、以及你要调用的 Model ID。这三样东西是后面所有配置的基础，缺一个都跑不通。

先访问官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 了解整体能力，然后进控制台创建 Key。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，在 API Keys 页面点新建，复制出来的那串就是你的统一 Key。注意这个 Key 只在创建时完整显示一次，复制后立刻存到安全的地方，别直接提交进 Git。

Base URL 用 https://taotoken.net/api ，注意这里不加任何 UTM 参数，代码里就写这个干净的地址。Model ID 根据你的选股场景选，做文本理解、策略描述解析、结果摘要这类任务，选一个通用对话模型就够；如果要做更复杂的因子推理，可以换更强的模型。Model ID 的具体取值在文档里查：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

为什么要在 WPF 项目里强调「统一 Key」？因为桌面工具的配置分散是通病。你可能在App.config里放一个，在Settings.settings里放一个，测试代码里又硬编码一个。等到 Key 需要轮换，或者你想把工具分享给别人用，就得挨个改。正确做法是：所有对外请求都走一个ApiClient类，Key 和 Base URL 从单一配置源读取，StockPicker 的策略模块只调用这个 Client，不直接碰网络层。

调用链路大致是这样：WPF 界面收集用户勾选的策略和股票池 → 组装成一次选股请求 → 通过ApiClient发到 TaoToken 的 API 通道 → 拿到返回的候选列表 → 反序列化成StockItem集合 → 绑定到右侧 DataGrid。整条链路里，Key 只在ApiClient出现一次，其余模块无感。这样你以后换数据源、加缓存、加重试，都只改一个地方。

还有一点要提前想好：桌面工具的 Key 存储。个人自用可以直接放配置文件，但如果要分发给别人，建议让用户自己填 Key，存在本地加密的user.config里，而不是打包进 exe。这不是技术难点，但决定了你的工具能不能合规地分享出去。

3. 可复制配置：WPF 项目里的 JSON 与 settings 片段

这一节给你可以直接抄的配置。WPF 项目常见的配置载体有三种：appsettings.json、App.config、以及Properties/Settings.settings。我推荐用appsettings.json，配合Microsoft.Extensions.Configuration读取，结构清晰、易扩展。

先看appsettings.json，放在项目根目录，设置「复制到输出目录」为「如果较新则复制」：

{ "TaoToken": { "BaseUrl": "https://taotoken.net/api", "ApiKey": "sk-你的Key粘贴在这里", "ModelId": "你的ModelID", "TimeoutSeconds": 60 }, "StockPicker": { "DefaultPool": "沪深300", "ExcludeST": true, "ForceRefresh": false, "MaxConcurrency": 4 } }

注意BaseUrl就是干净的https://taotoken.net/api，不要在后面拼/v1之类的路径，具体端点由 SDK 或请求代码决定。ApiKey这里先占位，实际项目里建议改成从环境变量或用户配置读取，避免明文进仓库。

如果你更习惯用App.config，等价写法是这样：

<configuration> <appSettings> <add key="TaoToken.BaseUrl" value="https://taotoken.net/api"/> <add key="TaoToken.ApiKey" value="sk-你的Key"/> <add key="TaoToken.ModelId" value="你的ModelID"/> <add key="StockPicker.DefaultPool" value="沪深300"/> </appSettings> </configuration>

读取端我封装成一个AppConfig静态类，只初始化一次：

public static class AppConfig { private static readonly IConfigurationRoot _root; static AppConfig() { _root = new ConfigurationBuilder() .SetBasePath(AppDomain.CurrentDomain.BaseDirectory) .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true) .Build(); } public static string BaseUrl => _root["TaoToken:BaseUrl"]; public static string ApiKey => _root["TaoToken:ApiKey"]; public static string ModelId => _root["TaoToken:ModelId"]; public static int TimeoutSeconds => int.Parse(_root["TaoToken:TimeoutSeconds"] ?? "60"); }

然后是ApiClient，这是整个链路唯一持有 Key 的地方：

public class ApiClient { private readonly HttpClient _http; public ApiClient() { _http = new HttpClient { BaseAddress = new Uri(AppConfig.BaseUrl), Timeout = TimeSpan.FromSeconds(AppConfig.TimeoutSeconds) }; _http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", AppConfig.ApiKey); _http.DefaultRequestHeaders.Accept.Add( new MediaTypeWithQualityHeaderValue("application/json")); } public async Task<string> PostAsync(string endpoint, object payload) { var json = JsonSerializer.Serialize(payload); var content = new StringContent(json, Encoding.UTF8, "application/json"); var resp = await _http.PostAsync(endpoint, content); resp.EnsureSuccessStatusCode(); return await resp.Content.ReadAsStringAsync(); } }

这里BaseAddress用AppConfig.BaseUrl，Authorization头用Bearer加 Key，这是标准做法。StockPicker 的策略模块只调用PostAsync，传端点名和 payload，完全不关心 Key 从哪来。

如果你用的是 Cline MCP 或者 Codex 这类工具做辅助开发，配置里同样要写全三件套：Base URL 填https://taotoken.net/api，Key 填你创建的，Model ID 填对应模型。三件套缺一不可，尤其是 Model ID，很多人只填了前两个，结果请求返回模型不存在。

4. 验证请求：一次 StockPicker 选股调用的完整过程

配置写完，必须做一次端到端验证，确认从 WPF 发出的请求能拿到结果。我以「均线多头排列 + 缩量回踩阳线，股票池沪深300，剔除 ST」这个组合为例，走一遍完整流程。

先定义请求和响应的数据模型：

public class StockPickRequest { public string Pool { get; set; } public List<string> Strategies { get; set; } public string CombineMode { get; set; } public bool ExcludeST { get; set; } public bool ForceRefresh { get; set; } } public class StockItem { public string Code { get; set; } public string Name { get; set; } public int HitCount { get; set; } public List<string> HitStrategies { get; set; } }

组装请求并调用：

var client = new ApiClient(); var request = new StockPickRequest { Pool = "沪深300", Strategies = new List<string> { "均线多头排列", "缩量回踩阳线" }, CombineMode = "同时满足所选", ExcludeST = true, ForceRefresh = false }; var raw = await client.PostAsync("/stock/pick", request); var result = JsonSerializer.Deserialize<List<StockItem>>(raw);

在 WPF 里，这段调用要放在按钮的async事件处理器里，别阻塞 UI 线程：

private async void OnStartPickClick(object sender, RoutedEventArgs e) { StartButton.IsEnabled = false; StatusText.Text = "选股中..."; try { var items = await RunPickAsync(); ResultGrid.ItemsSource = items; StatusText.Text = $"完成，命中 {items.Count} 只"; } catch (Exception ex) { StatusText.Text = "失败：" + ex.Message; } finally { StartButton.IsEnabled = true; } }

验证成功的标志是：右侧 DataGrid 出现候选列表，每行有代码、名称、命中策略数。命中 2 个策略可以标记为「买入观察」，命中 3 个及以上标记为「强烈买入」，这只是辅助分级，不构成建议。如果结果为空，先确认股票池和策略组合是否过严，把组合方式改成「满足任一」再试一次。

想单独验证模型通道是否通，可以用模型对话页面发一条测试消息：https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 。如果那边能正常返回，说明 Key 和 Base URL 没问题，问题就出在选股端点的参数上。

实测下来，同一天第二次扫描会明显更快，因为走了本地缓存。股票池选「沪深300」比选「沪A」快很多，第一次跑全市场要有耐心。扫到一半可以点取消，CancellationToken传进PostAsync即可。

5. 常见报错排查：401、超时与反序列化失败

接入过程里最容易撞上的几类错误，我按出现频率排一下，每个都给出定位方法。

401 Unauthorized。这是 Key 问题，但原因有好几种。第一种是 Key 复制时带了空格或换行，Bearer后面多了字符。第二种是Authorization头没设对，比如写成了Token而不是Bearer。第三种是 Key 被禁用或额度用尽。排查方法：在ApiClient构造后打印一次_http.DefaultRequestHeaders.Authorization，确认格式是Bearer sk-xxx。如果格式对还报 401，去控制台 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 确认 Key 状态。

local proxy failed / 连接被拒绝。这类报错通常出现在你本地配了代理，但代理没启动或端口不对。WPF 的HttpClient默认会读系统代理设置。如果你不需要代理，在HttpClientHandler里显式关掉：

var handler = new HttpClientHandler { UseProxy = false }; _http = new HttpClient(handler) { BaseAddress = new Uri(AppConfig.BaseUrl) };

如果确实需要走本地代理，确认代理进程在监听，且BaseAddress没被代理规则拦截。注意别把代理地址和 Base URL 搞混，Base URL 始终是https://taotoken.net/api。

reading choices 相关报错。这通常发生在反序列化阶段，返回的 JSON 结构和你的模型对不上。比如返回体是{ "choices": [...] }这种包装结构，而你直接按List<StockItem>反序列化，就会报字段找不到。解决办法是先打印原始raw字符串，看清楚外层结构，再决定是加一层包装类还是取choices[0].message.content再二次解析。调试期建议把原始响应写进日志文件，别只看异常消息。

OAuth / 认证流程报错。如果你在接入 Claude Code 或类似需要 OAuth 的工具，报错往往出在回调地址或 token 刷新上。这类场景建议直接看文档里的接入说明：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，按步骤走，别自己拼认证 URL。

超时。默认 60 秒对全市场扫描可能不够。把TimeoutSeconds调到 120，同时给请求加CancellationToken，让用户能中途取消。超时后不要立刻重试，先确认是不是股票池太大，换成沪深300再试。

Model ID 不存在。三件套里最容易被忽略的就是 Model ID。Base URL 和 Key 都对，但 Model ID 填错，请求会返回模型不存在的错误。去文档确认当前可用的 Model ID 列表，别凭记忆填。

6. 长期编码与 Agent 场景：把选股工具做成可持续迭代的项目

跑通一次请求只是起点。真正让这个 WPF 选股工具有价值的，是它能持续迭代——加策略、换数据源、优化缓存、做结果导出。这些长期编码工作，用 Coding Plan 会更顺：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。它适合那种需要反复改代码、加功能、调参数的场景，比单次对话更省心。

具体到项目结构，我建议把 StockPicker 拆成三层：Data层负责所有网络请求和缓存，Strategy层负责策略定义和组合逻辑，UI层只做绑定和交互。这样你加一个新策略，只需要在Strategy层注册，不用动网络代码。缓存用本地 SQLite 或简单的 JSON 文件都行，按日期分文件，第二天自动失效。

导出 CSV 这块，用CsvHelper或者手写StringBuilder都可以，注意处理中文编码，写文件时用UTF-8 with BOM，不然 Excel 打开会乱码。结果表格支持排序和筛选，用户能按命中策略数倒序看，体验会好很多。

最后提醒一句：这类工具的核心价值是帮你快速过滤，不是替你判断。策略组合、股票池、剔除条件这些参数，最终要结合你自己的观察去调。把接入链路做稳、把 Key 管好、把缓存做对，剩下的就是慢慢打磨策略。工具是辅助，决策在你。