ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

Excalidraw Obsidian 接 DeepSeek Harness,TaoToken 填 Key

Excalidraw Obsidian 接 DeepSeek Harness,TaoToken 填 Key 1. Excalidraw 画板接 Obsidian 笔记时为什么要在 DeepSeek Harness 里填 TaoToken Key把 Excalidraw 画板塞进 Obsidian 做绘图笔记再让 DeepSeek Harness 去读笔记、补图注、拆绘图步骤这套流程真正卡人的地方往往不是画图而是模型请求的 Key 和 Base URL 怎么填。我的做法是在 Harness 的 API Key 配置里改填 TaoToken 的 Key获取入口是 TaoToken 官网Base URL 写https://taotoken.net/api。这样 DeepSeek Harness 每次调用模型处理 Obsidian 笔记时Token 消耗都走这个 Key。这里要先把“谁消耗 Token”说清楚不是 Excalidraw 自己消耗也不是 Obsidian 同步消耗而是 DeepSeek Harness 调模型处理 Obsidian 笔记时的请求在消耗。比如你让 Harness 读取当前笔记里的画板元素摘要、根据文字段落生成图注、把图注回写到 Markdown 表格、再把长笔记拆成“先画流程框、再连箭头、再补注释”的步骤这些都会触发模型请求。请求越多、上下文越长、回写内容越复杂Token 消耗越明显。所以给 Harness 单独配一个可管理的 Key比到处散落配置更稳。这篇从绘图笔记视角写不讨论花哨玩法只解决三件事第一在 TaoToken 拿到 Key 并确认 Base URL第二把 Key 和 Base URL 填进 DeepSeek Harness 或相关 CLI 配置第三用 Excalidraw Obsidian 的实际笔记样例产出一份可核对的图注对照表。中间会给出 Claude Code 的settings.json、Codex 的config.toml、CC Switch 三件套配置方便你在同一套工作流里复用。需要先说明不同版本的 Harness、Obsidian 插件、CLI 工具字段名可能不同但核心只有两个值API Key YOUR_API_KEYBase URL https://taotoken.net/api。模型名一律以 TaoToken 控制台可选列表为准不要凭记忆硬填。如果你之前习惯在 DeepSeek 官方页面找 Key这次统一改掉注册、创建 Key、查看模型、管理额度都回到 TaoToken 官网处理。尤其填 API Key 那一步直接打开 TaoToken 官网登录后创建 Key再复制到 Harness。这样后面排障时你能明确知道请求是从 Harness 发出、经过 TaoToken 的 Base URL、最后落到你选用的模型上。2. 在 TaoToken 创建 Key把注册、申请、控制台步骤统一收口先处理 Key。打开 TaoToken 官网完成登录后进入控制台。建议不要复用其他项目的 Key而是新建一个专门给 Obsidian Excalidraw DeepSeek Harness 用的 Key命名可以用obsidian-excalidraw-harness。这样做的好处是当你在笔记里批量生成图注、让 Harness 读长文档、或者临时测试不同模型时能单独观察这个 Key 的调用情况不会和别的工具混在一起。创建完成后把 Key 复制出来。本文统一用占位符YOUR_API_KEY表示实际使用时替换成你刚创建的值。不要把真实 Key 写进 Obsidian 仓库尤其不要提交到 Git。推荐放在本机环境变量、系统钥匙串、或本地未跟踪的配置文件中。Obsidian 笔记通常有同步需求Key 一旦进仓库很容易被同步到不该去的地方。配置 Base URL 时注意TaoToken 的 Base URL 是https://taotoken.net/api不要在后面乱加/v1、/chat/completions之类的路径除非 Harness 或 CLI 文档明确要求。很多 404 都是因为把 Base URL 和完整接口地址混在一起。正确做法是工具里让你填 Base URL你就填https://taotoken.net/api工具自己会拼接它需要的路径。Key 则填YOUR_API_KEY。如果你还没确定用哪个模型可以先通过模型对话做一次简单验证看看控制台里可选的模型名。验证链接可以后面统一走 CTA但这里先记住原则Harness 里填的模型名必须和控制台可选模型一致。绘图笔记场景通常不需要极端复杂的模型重点是稳定读上下文、按结构输出 JSON 或 Markdown 表格。你可以先选一个成本可控、响应稳定的模型跑通图注生成再决定是否换成更强模型处理复杂画板。另外建议给这个 Key 设置使用边界只在本机 Harness、Claude Code、Codex、CC Switch 中使用不要分发给不可信环境如果发现调用异常先停用旧 Key再创建新 Key 替换。TaoToken 官网控制台就是这些操作的入口不要再去其他地方绕。3. DeepSeek Harness 填 Key 的最小配置OpenAI Compatible 与 Anthropic Compatible 要分清DeepSeek Harness 的配置界面可能因版本不同而不同但常见字段逃不出这几类Provider、Base URL、API Key、Model。你要做的是找到“自定义模型”“OpenAI Compatible”“Anthropic Compatible”或“第三方供应商”之类的入口然后填入Provider自定义 / OpenAI Compatible / Anthropic Compatible以 Harness 实际选项为准 Base URLhttps://taotoken.net/api API KeyYOUR_API_KEY Model以 TaoToken 控制台可选模型为准如果 Harness 让你选 OpenAI Compatible那么它内部会按 OpenAI 风格请求处理你只需要提供 Base URL 和 Key。不要自己拼完整 URL。如果 Harness 让你选 Anthropic Compatible那么它可能会使用ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN这类环境变量。注意ANTHROPIC_*只适用于 Claude Code 或明确支持 Anthropic 协议的工具不要把这套变量套到 Codex 的config.toml里。可以先在本机设置环境变量避免把 Key 写死在 Obsidian 插件配置中。下面只是本地示例命令由你在本机终端执行export TAOTOKEN_API_KEYYOUR_API_KEY export TAOTOKEN_BASE_URLhttps://taotoken.net/api然后在 Harness 的 API Key 字段填YOUR_API_KEYBase URL 填https://taotoken.net/api。如果 Harness 支持从环境变量读取就选择对应环境变量名如果不支持再填入本地配置文件。无论哪种方式都不要在笔记正文里出现真实 Key。配置完成后先做一个最小验证在 Obsidian 里打开一篇包含 Excalidraw 画板的笔记让 Harness 只读取当前段落输出一句“已连接”。这个请求会消耗极少量 Token但能验证 Key、Base URL、模型名三件事是否都对。如果这里报 401通常是 Key 错或没带上如果报 404通常是 Base URL 多写了路径如果报模型不存在通常是模型名和控制台不一致。验证通过后再把 Excalidraw 画板元素摘要加入上下文。注意Harness 处理的是 Obsidian 笔记里的文本和你提供的画板描述不是直接“看懂”整个 Excalidraw 文件。你需要让笔记里保留可读的元素说明或者让 Harness 读取导出后的元素列表。这样才能稳定生成图注而不是靠模型猜。4. Claude Code settings.json、Codex config.toml 与 CC Switch 三件套虽然主线是 DeepSeek Harness 连 Obsidian但绘图笔记工作流经常会搭配其他命令行工具比如用 Claude Code 批量整理 Obsidian 仓库、用 Codex 生成 Markdown 表格、用 CC Switch 切换不同供应商。它们可以共用同一套 TaoToken Key 和 Base URL但配置方式不同不能混用。先看 Claude Code。它通常通过settings.json或环境变量读取 Anthropic 协议配置。示例结构如下模型名只是占位实际以 TaoToken 控制台可选列表为准{ env: { ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_MODEL: claude-sonnet-4-20250514, ANTHROPIC_SMALL_FAST_MODEL: claude-3-5-haiku-20241022 } }这里的关键是ANTHROPIC_AUTH_TOKEN填YOUR_API_KEYANTHROPIC_BASE_URL填https://taotoken.net/api。不要把 Base URL 写成带 UTM 的官网地址工具配置只认 API Base URL。官网链接是给人打开控制台用的https://taotoken.net/api才是给工具填的。再看 Codex。Codex 用config.toml不要使用ANTHROPIC_*。示例model gpt-5 model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat然后在本地设置环境变量export TAOTOKEN_API_KEYYOUR_API_KEYCodex 的env_key指向TAOTOKEN_API_KEYbase_url仍然是https://taotoken.net/api。模型名gpt-5只是示例请以 TaoToken 控制台实际可选模型为准。不要把ANTHROPIC_AUTH_TOKEN写进 Codex 配置这是两套协议混填会导致请求失败。最后是 CC Switch 三件套。你可以把它理解成供应商切换器核心填三项Base URLhttps://taotoken.net/api API KeyYOUR_API_KEY Model以 TaoToken 控制台可选模型为准如果 CC Switch 还要求供应商名称可以写TaoToken。配置好后切换到这个供应商再让 Harness 或 Claude Code 读取对应配置。注意检查 CC Switch 是否覆盖了settings.json中的ANTHROPIC_*如果两边同时存在以实际生效的那一层为准。排障时先只保留一套配置避免多个入口互相打架。这套组合的意义是DeepSeek Harness 负责在 Obsidian 里处理 Excalidraw 绘图笔记Claude Code、Codex、CC Switch 负责周边自动化但它们的 Key 和 Base URL 都统一到 TaoToken。这样你只需要管理一个 Key 来源而不是每个工具都去不同地方找配置。5. Excalidraw 绘图调用示例从 Obsidian 笔记到图注对照表现在进入可复现产出。假设你在 Obsidian 里有一篇绘图笔记里面嵌了 Excalidraw 画板画板上有几个矩形、箭头和文字标签。你希望 DeepSeek Harness 读取笔记后生成一份图注对照表方便回写到 Markdown 中。关键不是让模型直接修改 Excalidraw 二进制文件而是让它输出结构化文本再由你或脚本回写。先准备一段笔记上下文。示例# 数据流草图 画板元素摘要 - 节点 Aidnode-a文字“用户请求” - 节点 Bidnode-b文字“API 网关” - 节点 Cidnode-c文字“模型服务” - 箭头 1从 node-a 到 node-b标签“HTTPS” - 箭头 2从 node-b 到 node-c标签“内部调用” 说明这是一张请求链路图需要为每个节点生成短图注并给整张图生成标题。然后把这段内容交给 HarnessPrompt 可以这样写你是绘图笔记助手。请阅读下面的 Obsidian 笔记和 Excalidraw 画板元素摘要输出 JSON。 要求 1. 不要编造不存在的元素只能使用摘要中出现的 id。 2. 每个节点生成一句图注不超过 30 字。 3. 每条箭头生成一句关系说明。 4. 最后给整张图生成一个标题。 5. 输出仅为 JSON不要额外解释。 笔记内容 {{这里粘贴 Obsidian 笔记片段和画板元素摘要}}Harness 返回示例可能是{ canvas_title: 用户请求到模型服务的链路图, nodes: [ { id: node-a, label: 用户请求, caption: 请求起点由客户端发起 }, { id: node-b, label: API 网关, caption: 统一入口负责鉴权与转发 }, { id: node-c, label: 模型服务, caption: 实际处理推理请求的后端 } ], edges: [ { from: node-a, to: node-b, label: HTTPS, caption: 用户通过 HTTPS 访问网关 }, { from: node-b, to: node-c, label: 内部调用, caption: 网关将请求转发给模型服务 } ] }拿到结果后回写成图注对照表Excalidraw 元素识别文字生成图注建议回写位置node-a用户请求请求起点由客户端发起节点 A 下方注释node-bAPI 网关统一入口负责鉴权与转发节点 B 下方注释node-c模型服务实际处理推理请求的后端节点 C 下方注释箭头 1HTTPS用户通过 HTTPS 访问网关箭头旁标签箭头 2内部调用网关将请求转发给模型服务箭头旁标签这张表就是可核对的产出。你可以检查每个图注是否与画板一致再把文字复制回 Obsidian。注意Harness 调模型处理这段笔记时Token 消耗发生在请求阶段笔记上下文、Prompt 指令、返回 JSON 都会计入。如果笔记特别长不要整篇塞进去只截取画板相关段落和元素摘要能显著降低消耗。如果你想把 Excalidraw 元素 id 和图注绑定得更稳建议在画板里给元素命名或在笔记里维护一份“元素 id - 文字 - 图注”的对照区。每次让 Harness 只更新对照区而不是重画整个画板。这样既保留人工可控性也避免模型生成不存在的节点。6. 排障401、404、模型不存在、图注串位时先查什么第一类问题是 401 或鉴权失败。先确认 Harness 里填的是YOUR_API_KEY对应的真实 Key而不是官网链接或占位符。如果最近在 TaoToken 控制台轮换过 Key需要把 Harness、Claude Code、Codex、CC Switch 里的配置都更新。最稳妥的方式是回到 TaoToken 官网 重新创建一个 Key命名为obsidian-excalidraw-harness-new然后逐项替换。不要跳过验证步骤先用短 Prompt 测通再处理长笔记。第二类问题是 404。绝大多数情况是 Base URL 填错。工具配置里只填https://taotoken.net/api不要填https://taotoken.net/api/v1/chat/completions也不要带 UTM 参数。官网链接用于打开控制台API Base URL 用于工具请求两者用途不同。如果你在 Harness 里看到“完整请求地址”和“Base URL”两个字段只填 Base URL完整地址让工具自己拼。第三类问题是模型不存在。把 Harness 里的模型名和 TaoToken 控制台可选列表逐字对照。大小写、连字符、版本号都要一致。不要因为之前用过某个模型名就默认现在可用。绘图笔记场景可以先用稳定模型跑通再按需切换。每次切换后重新跑一次“读取画板摘要并输出 JSON”的测试。第四类问题是图注串位。常见原因是 Excalidraw 元素 id 没有传进 Prompt模型只能按顺序猜。解决方式是在笔记里显式写出idnode-a、idnode-b并要求模型输出时带上 id。回写时按 id 匹配而不是按顺序匹配。如果画板元素很多可以分批次处理先处理节点再处理箭头最后处理整图标题。每批次都要求模型只使用当前批次的 id。第五类问题是 Token 消耗异常。先检查是否把整篇长笔记都传给了 Harness。绘图笔记往往包含大量旧内容如果每次都全文读取消耗会快速上升。建议只传画板摘要、当前需要生成的图注区、以及必要的上下文段落。还可以给这个工作流单独建 Key观察调用频率。如果发现异常先停用 Key再从 TaoToken 官网创建新 Key。第六类问题是 CC Switch 配置冲突。检查 CC Switch 三件套是否覆盖了 Claude Code 的settings.json。如果两边同时配置了不同 Base URL 或 Key实际生效的可能不是你预期的那个。排障时先只保留一套要么用 CC Switch 切换要么直接写settings.json不要同时开多个入口。Codex 则只检查config.toml和TAOTOKEN_API_KEY不要把 Anthropic 变量混进去。7. 把绘图笔记工作流跑顺验收、回写与文末 CTA当 Key、Base URL、模型名都填对后这套 Excalidraw Obsidian DeepSeek Harness 的绘图笔记流程就可以稳定复用了。建议按下面清单验收Harness 能读取 Obsidian 笔记中的画板摘要。请求使用Base URL https://taotoken.net/apiKey 为YOUR_API_KEY。模型能按 id 输出节点图注和箭头说明。图注对照表能和 Excalidraw 元素一一对应。Claude Code 的settings.json、Codex 的config.toml、CC Switch 三件套没有互相冲突。长笔记只传相关段落避免无意义 Token 消耗。回写时建议保留人工审核。模型生成的图注可以复制到 Obsidian 的 Markdown 表格中也可以由你手动补到 Excalidraw 元素附近。不要直接让模型改动画板文件除非你非常清楚回写逻辑。绘图笔记的价值在于图、文、注三者一致模型负责提速你负责最终确认。如果你还没有 Key或者想先验证模型效果可以按这个顺序走先打开 模型对话用一段画板摘要测试模型输出 JSON 是否稳定。如果准备长期跑 Obsidian 绘图笔记和 Harness 自动化再看 Coding Plan。然后去 创建 API Key把YOUR_API_KEY替换成真实 Key。如果你还要配置 Claude Code参考 Claude Code 文档核对ANTHROPIC_*写法。最后再回到核心配置在 DeepSeek Harness 的 API Key 一栏填 TaoToken 的 KeyBase URL 填https://taotoken.net/api。这样 DeepSeek Harness 调模型处理 Obsidian 笔记时的请求就都走 TaoToken 管理。Excalidraw 负责画Obsidian 负责记Harness 负责生成图注TaoToken 负责把 Key 和请求入口统一起来。整套流程跑顺后绘图笔记不再是画完就丢的草图而是能持续回写、持续复用、持续对照的结构化知识。
返回列表