企业官网建设流程全解析

你在 AnythingLLM 里按 Agent Skills 规范建好 weixin-document-expert 和 SKILL.md 后，执行公众号润色仍然报模型请求失败？TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=article_top 提供 Key 与 Base URL，用来把 AnythingLLM 或 Claude 兼容客户端的请求接到可用模型通道。本文不从 Agent Skills 的概念重新讲起，而是直接处理接入配置里最容易卡住的一环：Skill 能识别、指令能加载，但真正调用 Claude 兼容模型执行润色时，Key、Base URL、模型名或请求路径没有对齐。TaoToken 在这里只提供可用的 Key 和 Base URL，不替代 SKILL.md 里的润色 SOP；润色风格、输出格式、标题备选规则，仍然由你的 SKILL.md 决定。下面按“先定位问题、再创建 Skill、再配 TaoToken、再验证请求”的顺序展开。

原问题与场景：AnythingLLM 里 SKILL.md 能触发，执行润色仍卡在模型请求

很多人在 AnythingLLM 的storage\plugins\agent-skills下创建了weixin-document-expert文件夹，也写了SKILL.md，但实际输入公众号草稿时还是跑不起来。常见表现不是 SKILL.md 语法错误，而是模型请求没有返回：界面一直转圈、提示 API Key 无效、返回 404、提示模型不存在，或者只给出一段普通聊天式回答，完全没有触发润色 SOP。

这里要先分清两层。第一层是 Agent Skills 的加载机制。SKILL.md里的 name 和 description 会在启动时被读取，用于判断这个 Skill 是否与当前请求匹配；当用户明确提出“公众号润色”“标题备选”“提升转发”等意图时，Agent 才加载更完整的指令。这个机制就是渐进式信息披露，它的价值在于减少无关指令常驻上下文，让 Agent 不必一开始就把所有 SOP 都塞进请求。

第二层才是模型执行。Skill 本身不是模型，SKILL.md也不是模型权重。它只是一份结构化的工作流说明。真正执行润色时，仍然要由 Claude 兼容模型读取你的草稿、理解指令、生成润色正文、生成标题备选，并输出修改要点。这些推理和输出动作会消耗 Token。也就是说，渐进式披露能优化“指令加载”的成本，但不会消除“执行润色”本身的模型调用成本。

所以当你看到“Token 成本高”或“润色跑不起来”时，不要把问题全部归到 SKILL.md 上。先确认 Skill 是否触发，再确认模型通道是否配通。如果 Key、Base URL、模型名没有对齐，Skill 写得再细，也只能停在触发阶段，无法得到润色结果。本文的重点就是把 AnythingLLM 到 TaoToken 的模型通道接上，让weixin-document-expert真正执行。

在 AnythingLLM 创建 weixin-document-expert 与 SKILL.md

先保留原教程里最有用的部分：在 AnythingLLM 中创建 Skill 文件夹和SKILL.md。不同系统的 AnythingLLM 安装目录不一样，你需要进入实际安装目录，再找到子目录：

storage\plugins\agent-skills

在这个目录下新建文件夹，名称建议使用小写和连字符，例如：

weixin-document-expert

注意文件夹名称要和SKILL.md里的 name 对齐，否则 Agent 在匹配和加载时可能找不到对应关系。接着进入weixin-document-expert文件夹，新建标准文件名：

SKILL.md

文件名建议保持大写SKILL.md，不要写成skill.md或Skill.md，避免在大小写敏感或插件扫描规则不一致时漏读。

SKILL.md至少包含 YAML frontmatter 和 Markdown 指令。下面是一个精简示例，你可以按自己的公众号润色流程扩展：

--- name: weixin-document-expert description: 当用户需要对公众号草稿做润色、结构优化和标题备选时触发。 --- # 公众号润色工作流 当用户要求“公众号风格润色”“提升阅读感”“优化标题”时，按以下流程执行： 1. 读取草稿，识别目标读者和核心情绪，但不编造事实。 2. 保留作者原意，调整段落节奏，短句优先，减少公文腔。 3. 输出润色后的正文，适合直接复制到公众号编辑器。 4. 输出 3 到 5 个标题备选，覆盖情绪型、利益型、共鸣型。 5. 输出修改要点，只说明调整方向，不改变用户核心立场。 6. 不添加虚构数据、虚构经历和未经用户提供的案例。

这个示例的重点不是把 SOP 写得多复杂，而是让 description 能准确告诉 Agent 何时触发，让正文指令能告诉 Agent 触发后如何输出。description 太短、太泛，比如只写“文档处理”，Agent 很难判断该不该加载；description 太窄，又可能在你输入“改标题”时错过触发。

创建完成后，建议重启 AnythingLLM，或者在插件/技能相关页面刷新一次，让新的weixin-document-expert被扫描到。如果界面有技能列表，先确认列表里能看到它。看不到时，优先检查路径是不是storage\plugins\agent-skills\weixin-document-expert\SKILL.md，以及SKILL.md是否放在文件夹根目录，而不是多套了一层目录。

TaoToken 前置：先创建 Key，Base URL 只填 https://taotoken.net/api

Skill 创建好之后，下一步不是继续改 SOP，而是把执行润色所需的模型通道配通。执行润色前，先去 TaoToken 创建 Key。入口可以从官网控制台进入：

https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite

也可以直接打开 API Keys 页面：

https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite

创建 Key 后，把它保存到安全位置。本文的示例里统一写成：

YOUR_API_KEY

不要把YOUR_API_KEY当成真实 Key 填进去，也不要把它提交到公开仓库。建议为 AnythingLLM 单独创建一个 Key，后续如果出现异常，可以单独停用，不会影响你在其他客户端上的配置。

在 AnythingLLM 或 Claude 兼容的模型设置里，需要填两个关键值：

• API Key：填你在 TaoToken 创建的 Key。
• Base URL：填https://taotoken.net/api。

这里要特别强调：Base URL 不要加/v1，也不要填官网地址。官网地址是控制台和文档入口，不是模型请求地址。https://taotoken.net/api才是本文要求填写的 API Base URL。如果你把它写成https://taotoken.net/api/v1，某些客户端会自动再拼一次版本路径，导致请求路径重复，最后表现为 404 或模型不存在。

TaoToken 在这里只提供可用的 Key 和 Base URL，不替代SKILL.md里的润色 SOP。你的公众号润色规则、标题备选数量、输出格式、禁止行为，仍然由SKILL.md决定。Key 和 Base URL 解决的是“模型请求能不能发出去”，不是“润色风格好不好”。

可复制配置：AnythingLLM 与 Claude 兼容模型设置

AnythingLLM 不同版本的设置界面略有差异，但核心字段是一致的。进入 Settings，找到 LLM Preference 或模型提供商设置，选择 Anthropic/Claude 兼容入口，或者你的版本里对应的 Claude 模型配置项。然后按下面方式填写：

Provider: Anthropic / Claude Compatible API Key: YOUR_API_KEY Base URL: https://taotoken.net/api Model: MODEL_ID Max Tokens: 按润色任务长度设置 Temperature: 0.3 到 0.7 之间按风格调整

其中MODEL_ID不要凭记忆填写，要以 TaoToken 控制台当前可用的模型列表为准。模型名写错时，常见报错是 model not found、invalid model 或 404。Max Tokens 如果太小，长文润色可能输出到一半被截断；如果太大，又可能让一次请求的输出成本变高。公众号草稿较长时，可以分段润色，再让模型做一次合并和标题生成。

如果你的 AnythingLLM 版本只提供 OpenAI Compatible 入口，也要以界面实际要求为准，但核心原则不变：API Key 用 TaoToken Key，Base URL 用https://taotoken.net/api，不要填官网地址，也不要自己额外追加/v1。若界面有“自动添加 /v1”的选项，需要根据报错判断是否与当前兼容模式冲突。最稳妥的方式是优先选择 Anthropic/Claude 兼容入口，因为本文的 Skill 执行目标是 Claude 兼容模型。

如果你同时使用 Claude Code，配置方式不同。Claude Code 通常看settings.json，关键环境字段是ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY、ANTHROPIC_MODEL。示例结构如下：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "YOUR_API_KEY", "ANTHROPIC_MODEL": "MODEL_ID" } }

无论你是在 AnythingLLM 里配，还是在 Claude 兼容客户端里配，保存后都要重启对应进程。很多“配置明明填了但没生效”的情况，其实是旧进程还在使用旧环境变量或旧设置缓存。

验证请求与成功结果：输入公众号草稿触发 weixin-document-expert

配置完成后，不要先拿长文测试。先用一段短草稿验证模型通道是否走通。新建一个 AnythingLLM 对话，确认当前模型是你刚刚配置的 Claude 兼容模型，然后输入类似下面的内容：

请用公众号风格润色下面这段草稿，并给出标题备选。 最近我在整理 Agent Skills 的接入流程。很多人卡在 SKILL.md 能触发，但模型请求失败。本文想讲清 Base URL 和 Key 怎么配，以及怎么确认润色请求真的走通。

如果你的description写得合适，Agent 应该能识别“公众号风格润色”和“标题备选”这两个意图，进而触发weixin-document-expert。成功结果通常包含三部分：

1. 润色后的公众号正文，语言比原草稿更利落，段落节奏更清楚。
2. 3 到 5 个标题备选，最好覆盖不同情绪或利益角度。
3. 修改要点清单，说明做了哪些表达调整，但不改变你的核心意思。

只要这三类内容出现，就说明至少有两个环节已经通了：Skill 被触发，模型请求也成功返回。接下来再去 TaoToken 控制台查看请求记录或用量变化，确认请求确实来自 AnythingLLM 这次对话。不要只看前端有没有 loading，也不要只看模型有没有说话；有些失败场景下，前端会显示一条兜底回复，但实际请求并没有按你的 Skill 执行。

如果返回的是普通回答，比如只改了句子但没有标题备选，也没有修改要点，优先怀疑 Skill 没有触发或没有加载完整指令。回去检查SKILL.md的 description 是否包含“公众号”“润色”“标题备选”等触发词，以及文件夹名和 frontmatter 的 name 是否一致。如果直接报 401、403、404 或 model not found，则优先检查 Key、Base URL 和模型名，不要继续改润色 SOP。

本篇常见错排查：Base URL、/v1、模型名与 SKILL.md 触发条件

围绕 AnythingLLM、SKILL.md和 TaoToken 接入，最常见的错误集中在下面几类。

第一类，Base URL 填错。把 Base URL 写成官网地址https://taotoken.net/，请求会打到页面入口而不是 API 入口。把 Base URL 写成https://taotoken.net/api/v1，某些客户端会再次拼接/v1，最后请求路径变成重复版本号。本文要求填的是https://taotoken.net/api，不要加/v1，也不要填官网地址。

第二类，API Key 复制错误。Key 前后有空格、换行、引号，或者复制时漏掉字符，都会导致 401 或 403。建议重新创建 Key 后直接粘贴，不要手动输入。如果 AnythingLLM 有“测试连接”按钮，先测试连接，再回到对话里验证 Skill。

第三类，模型名写错。MODEL_ID不是固定不变的，也不要用网上看到的旧示例硬填。以 TaoToken 控制台可用列表为准。模型名错误时，即使 Key 和 Base URL 正确，也会报模型不存在或权限不足。

第四类，SKILL.md没被正确加载。检查路径是否为storage\plugins\agent-skills\weixin-document-expert\SKILL.md，文件名是否大写，文件夹名是否与 frontmatter 的 name 一致。改完SKILL.md后重启 AnythingLLM，避免旧缓存继续生效。

第五类，description 无法触发。description 太抽象时，Agent 不知道什么时候该加载这个 Skill。可以写成“当用户需要对公众号草稿做润色、结构优化和标题备选时触发”，并在测试时明确说“公众号风格润色”“给标题备选”，不要只发一句“帮我改改”。

第六类，Token 成本没有预期下降。需要理解一点：渐进式信息披露节省的是指令常驻上下文，不是模型输出成本。润色长文、生成多个标题、输出修改要点，都会消耗 Token。要控制成本，可以把长文分段，限制标题备选数量，减少无关历史对话，并选择适合当前任务的模型。Base URL 改到 TaoToken 后，请求变得可观测，你可以在控制台看用量，但 TaoToken 不替代SKILL.md里的润色 SOP，也不会替你决定文章该怎么改。

第七类，配置改了但没重启。AnythingLLM、Claude 兼容客户端、环境变量都有缓存可能。保存 Key、Base URL、模型名后，重启进程再测试。尤其是 Windows 下修改系统环境变量后，已经打开的终端和客户端不会自动读取新值。

语义一致 CTA：API Keys、接入文档与模型对话

如果你正在处理 AnythingLLM 的接入配置和排障，优先从 API Keys 与接入文档开始。API Keys 页面用于创建和管理 TaoToken Key，接入文档用于核对 Base URL、模型名和兼容方式：

https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite

https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

如果你要确认模型本身是否可用，建议先到模型对话里发一条短消息，排除 AnythingLLM 插件层和 Skill 触发层的干扰：

https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite

如果你准备长期把 Agent Skills 用在编码、自动化或复杂工作流里，可以进一步查看 Coding Plan：

https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite

回到本篇场景，关键动作只有几个：在 AnythingLLM 的storage\plugins\agent-skills下创建weixin-document-expert和SKILL.md，让 Agent 在公众号润色请求出现时加载指令；然后去 TaoToken 创建 Key，把 Base URL 填成https://taotoken.net/api，不要加/v1，不要填官网地址；最后用一段公众号草稿触发 Skill，检查是否返回润色正文、标题备选和修改要点。只要这三步对齐，Skill 负责 SOP，TaoToken 负责模型通道，润色请求就能真正跑起来。