1. workbuddy 文件保存到底难在哪从桌面资料文件夹说起workbuddy 是一个把智能体能力封装进微信对话的桌面工具你扫码连上微信之后就能在聊天窗口里让它帮你干活。它能做什么最典型的一类就是文件保存你把手机里的文件丢给它它帮你落到电脑指定目录。适合谁适合那些不想折腾原生配置、只想用聊天方式管理文件的人。但真正用起来文件保存这个场景的坑比想象中多。我见过最多的情况是你在微信里说“帮我把这个文件存到桌面的资料文件夹”它回你一句“已解析文件内容”然后文件根本没落地。为什么因为默认行为是解析不是保存。解析和保存是两条不同的执行路径前者读内容后者写磁盘。你不明确说“保存”它就可能走解析。还有一个高频问题路径写错。你说“桌面”它可能理解成/root/Desktop也可能理解成/home/你的用户名/Desktop甚至在某些封装环境里桌面目录压根不存在。路径不存在保存就失败但报错信息往往很含糊只告诉你“操作未完成”。再往下权限问题。workbuddy 运行在某个用户上下文里如果目标目录属于另一个用户或者目录权限是755而当前用户不是 owner写入就会被拒绝。这种失败在日志里通常表现为Permission denied或EACCES但微信对话框里可能只显示“保存失败请重试”。最后是模型调用层面的问题。workbuddy 背后要调模型来理解你的指令如果 API Key 没配好、Base URL 写错、Model ID 对不上整个链路就断了。这时候你看到的可能不是“保存失败”而是“请求超时”或“认证失败”。很多人会误以为是文件保存的问题其实是接入配置的问题。所以这篇内容我会按两条线走一条是文件保存路径的设置与排查另一条是 TaoToken 统一 Key 的接入配置。两条线在实际使用中是交织的——保存失败可能是路径问题也可能是模型调用问题得分开验证。先明确一个核心检索词workbuddy 文件保存路径设置。你搜这个词大概率是遇到了保存位置不对、保存失败、或者不知道怎么改默认目录。下面我从环境准备开始一步步给可复制的配置。在开始之前你需要确认几件事workbuddy 已经安装并扫码连上微信你知道自己的操作系统是 Windows 还是 macOS 还是 Linux你能访问终端或命令行。这些是后续所有操作的前提。另外提醒一点workbuddy 的对话窗口里指令要尽量明确。不要说“处理这个文件”要说“把这个文件保存到某个绝对路径”。模糊指令会让模型走解析路径而不是保存路径。这是很多人踩的第一个坑。2. TaoToken 前置统一 Key 与 Base URL 怎么配workbuddy 要调模型就得有接入配置。TaoToken 在这里的角色是提供统一的 API 入口你不需要分别去配多家模型的 Key用一个 Key 就能切换不同模型。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。先说清楚为什么要用统一 Key。workbuddy 这类工具在解析文件、理解指令、生成回复时可能调用不同能力的模型。如果每个模型都单独配 Key管理成本高而且切换模型时要改多处配置。统一 Key 的好处是Base URL 不变Key 不变只改 Model ID 就能换模型。你需要准备三样东西Base URL、API Key、Model ID。这三件套在后面的配置文件里会反复出现。Base URL 填https://taotoken.net/api注意不要加多余的路径也不要加 UTM 参数。API Key 在控制台创建地址是 https://taotoken.net/console/api-keys 。Model ID 根据你要用的模型填比如对话类、代码类各有对应的 ID。创建 Key 的步骤打开控制台找到 API Keys 页面点创建复制生成的 Key。这个 Key 只显示一次丢了就得重新建。建议建完之后先在一个测试脚本里验证确认能通再写进 workbuddy 的配置。验证 Key 是否可用可以用最简单的 curl 请求。下面这个命令你可以直接复制把你的Key替换成实际值curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的Key \ -H Content-Type: application/json \ -d { model: 你的ModelID, messages: [{role: user, content: 回复ok}] }如果返回里有choices字段说明 Key 和 Base URL 都没问题。如果返回 401说明 Key 错了或没带对。如果返回local proxy failed说明网络层有问题不是 Key 的问题。这里要强调Base URL 必须是https://taotoken.net/api不要写成https://taotoken.net/api/v1再加/chat/completions导致路径重复。很多 404 都是路径拼错造成的。Model ID 怎么选如果你只是让 workbuddy 理解指令、做文件保存这类操作选一个通用的对话模型就行。如果你还要它解析代码文件选代码能力强的模型。具体 ID 在文档里查地址是 https://taotoken.net/doc 。配置写在哪里workbuddy 的配置文件位置取决于你的安装方式。常见的位置包括用户目录下的.workbuddy/config.json或settings.json。如果你用的是 Claude Code 类的封装可能在~/.claude/settings.json。下面给一个通用的 JSON 配置片段路径和字段名按你的实际文件调整{ api: { base_url: https://taotoken.net/api, api_key: 你的Key, model: 你的ModelID }, file_save: { default_dir: /Users/你的用户名/Desktop/资料, auto_parse: false } }注意auto_parse这个字段设为false表示默认不解析直接保存。这能避免前面说的“它去解析了但没保存”的问题。如果你的配置文件里没有这个字段可以在指令里明确说“不要解析直接保存”。如果你用的是 TOML 格式的配置比如某些 Rust 工具链的封装写法类似[api] base_url https://taotoken.net/api api_key 你的Key model 你的ModelID [file_save] default_dir /Users/你的用户名/Desktop/资料 auto_parse false配置改完之后要重启 workbuddy否则不生效。重启方式看你的安装方式一般是退出托盘图标再重新打开或者在终端里CtrlC再重新运行。还有一个容易忽略的点Key 的权限。如果你在控制台给 Key 设了额度限制或模型白名单而 workbuddy 调用的模型不在白名单里就会报 403。这时候不是 Key 错了是权限不够。去控制台检查 Key 的权限设置。3. 可复制配置保存目录与统一 Key 的完整写法这一节给完整的可复制配置包括保存目录的设置和 TaoToken 三件套的写入。你按自己的系统改路径就行。先确定保存目录。Windows 下桌面路径通常是C:\Users\你的用户名\Desktop\资料macOS 下是/Users/你的用户名/Desktop/资料Linux 下是/home/你的用户名/Desktop/资料。注意反斜杠和正斜杠的区别JSON 里反斜杠要转义写成C:\\Users\\...。创建目录的命令# macOS / Linux mkdir -p ~/Desktop/资料 # Windows PowerShell New-Item -ItemType Directory -Force -Path $env:USERPROFILE\Desktop\资料创建完之后确认权限ls -ld ~/Desktop/资料输出应该是drwxr-xr-x开头owner 是你当前用户。如果 owner 不对用chown改。如果权限是r--没有写权限用chmod uw加写权限。接下来是 workbuddy 的配置文件。假设配置文件在~/.workbuddy/config.json完整内容如下{ api: { base_url: https://taotoken.net/api, api_key: sk-你的实际Key, model: 你的ModelID, timeout: 60 }, file_save: { default_dir: /Users/你的用户名/Desktop/资料, auto_parse: false, overwrite: false, allowed_extensions: [.pdf, .docx, .txt, .md, .png, .jpg] }, logging: { level: info, file: /Users/你的用户名/.workbuddy/logs/workbuddy.log } }几个字段说明timeout是请求超时秒数文件大或模型慢的时候可以调大。overwrite设为false表示同名文件不覆盖会加时间戳后缀。allowed_extensions限制可保存的文件类型防止意外保存可执行文件。logging.file是日志路径排查问题时要看这个文件。如果你用的是 Claude Code 的 settings.json配置结构不同但三件套是一样的{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的实际Key, ANTHROPIC_MODEL: 你的ModelID } }注意这里的变量名是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY不是通用的base_url。不同工具的环境变量名不一样写错了就不生效。Claude Code 的接入文档在 https://taotoken.net/doc 里面有完整的变量名列表。如果你用的是 Cline 或类似的 VS Code 插件配置在插件的设置界面里填三个字段Base URL、API Key、Model ID。Base URL 填https://taotoken.net/api不要填别的。Codex 的auth.json配置类似{ base_url: https://taotoken.net/api, api_key: sk-你的实际Key, model: 你的ModelID }文件路径通常在~/.codex/auth.json。改完之后重启 Codex。CC Switch 这类工具也是同样的三件套逻辑Base URL、Key、Model ID。不管界面长什么样核心就这三个值。记住这一点换任何工具都能快速配好。配置写完之后先别急着在微信里发文件。先在终端里跑一个测试请求确认模型调用是通的。用第 2 节给的 curl 命令返回choices就说明接入没问题。接入没问题了再去测文件保存。文件保存的测试在微信对话框里发一句“把 /tmp/test.txt 保存到 /Users/你的用户名/Desktop/资料”。如果/tmp/test.txt不存在先创建一个echo test content /tmp/test.txt然后发指令。成功的话去资料文件夹里看应该有test.txt。失败的话看日志文件找ERROR行。4. 验证请求与成功结果从日志确认保存动作配置写完只是第一步验证才是关键。这一节给完整的验证流程包括模型调用验证和文件保存验证。先验证模型调用。用 curl 发一个最小请求curl -s -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的实际Key \ -H Content-Type: application/json \ -d { model: 你的ModelID, messages: [{role: user, content: 只回复两个字成功}], max_tokens: 10 } | python3 -m json.tool预期返回{ choices: [ { message: { role: assistant, content: 成功 } } ] }看到choices就说明 Base URL、Key、Model ID 三件套都对。如果报 401检查 Key 有没有复制完整有没有多余空格。如果报 404检查 Base URL 是不是https://taotoken.net/api路径有没有拼错。如果报local proxy failed检查本机网络设置不要开任何代理类工具。模型调用通了之后验证文件保存。在微信对话框里发帮我把 /tmp/test.txt 保存到 /Users/你的用户名/Desktop/资料不要解析注意“不要解析”这四个字能强制走保存路径。发完之后去终端看文件在不在ls -la ~/Desktop/资料/预期输出里有test.txt大小和/tmp/test.txt一致。用diff确认内容一致diff /tmp/test.txt ~/Desktop/资料/test.txt echo 内容一致如果文件不在看日志tail -50 ~/.workbuddy/logs/workbuddy.log日志里会有请求记录和错误信息。成功的保存会有一条类似file_save success: /tmp/test.txt - /Users/.../资料/test.txt的记录。失败的话会有ERROR行后面跟原因。常见的成功日志长这样2025-01-01 10:00:00 INFO api request: modelxxx, tokens50 2025-01-01 10:00:01 INFO file_save: source/tmp/test.txt, dest/Users/.../资料/test.txt 2025-01-01 10:00:01 INFO file_save success如果日志里只有api request没有file_save说明模型理解了指令但没触发保存动作。这时候要检查指令里有没有“保存”这个关键词或者auto_parse是不是true导致走了解析路径。如果日志里有file_save但后面跟ERROR看错误类型。Permission denied是权限问题No such file or directory是路径问题Disk full是磁盘满。验证保存成功还有一个方法在微信里问它“刚才的文件保存到哪了”。如果配置正确它会回复你配置的default_dir。如果回复的是别的路径说明配置没生效检查配置文件路径对不对有没有重启。再给一个批量验证的脚本你可以保存成verify.sh#!/bin/bash KEYsk-你的实际Key MODEL你的ModelID BASEhttps://taotoken.net/api echo 1. 测试模型调用... curl -s -X POST $BASE/v1/chat/completions \ -H Authorization: Bearer $KEY \ -H Content-Type: application/json \ -d {\model\:\$MODEL\,\messages\:[{\role\:\user\,\content\:\ok\}],\max_tokens\:5} \ | grep -q choices echo 模型调用 OK || echo 模型调用 FAIL echo 2. 测试目录权限... test -w ~/Desktop/资料 echo 目录可写 OK || echo 目录不可写 FAIL echo 3. 测试文件保存... echo verify /tmp/verify.txt cp /tmp/verify.txt ~/Desktop/资料/verify.txt 2/dev/null \ echo 文件保存 OK || echo 文件保存 FAIL跑这个脚本三项都 OK 就说明基础环境没问题。如果第三项 FAIL是系统权限问题不是 workbuddy 的问题。5. 常见错误排查401、local proxy failed、reading choices、OAuth这一节对照真实报错给排查步骤。这些错误我在配置过程中都遇到过按顺序排查基本能解决。401 Unauthorized报错原文{error:{message:Invalid API key,type:authentication_error}}原因Key 错了、没带、或者带了多余字符。排查步骤第一确认Authorization头是Bearer sk-xxx格式Bearer和 Key 之间有一个空格。第二确认 Key 没有过期或被删除去控制台看 Key 状态。第三确认 Key 没有前后空格复制的时候容易带上。第四确认 Base URL 是https://taotoken.net/api不是别的域名。如果 curl 能通但 workbuddy 报 401说明 workbuddy 的配置文件里 Key 写错了或者配置文件没被读取。检查配置文件路径确认 workbuddy 读的是你改的那个文件。local proxy failed报错原文local proxy failed: connection refused或proxy error原因本机有代理类工具在运行请求被拦截了。排查步骤第一关掉所有代理类软件。第二检查环境变量HTTP_PROXY和HTTPS_PROXY如果有值就清掉unset HTTP_PROXY unset HTTPS_PROXY第三检查~/.curlrc或~/.wgetrc里有没有代理配置。第四重启终端再试。这个错误和 TaoToken 无关是本机网络环境的问题。清掉代理配置后请求就能正常出去。reading choices 相关报错报错原文error reading choices: unexpected end of JSON input或cannot read property choices of undefined原因返回的响应不是预期的 JSON 结构。可能是 Base URL 拼错导致返回了 HTML 错误页也可能是 Model ID 不存在导致返回了错误对象。排查步骤第一用 curl 加-v看完整响应curl -v -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d {model:你的ModelID,messages:[{role:user,content:ok}]}第二看响应体是不是 JSON。如果是 HTML说明 URL 错了。第三确认 Model ID 在文档里有拼写一致。第四确认请求体里messages字段格式正确是数组每个元素有role和content。OAuth 相关报错报错原文OAuth token expired或invalid_grant原因某些工具用 OAuth 方式认证token 过期了。如果你用的是 Claude Code 的 OAuth 流程需要重新登录。但如果你用的是 API Key 方式不应该出现 OAuth 错误。排查步骤第一确认你用的是 API Key 而不是 OAuth。第二如果工具强制走 OAuth看它的文档怎么切换到 API Key 模式。第三Claude Code 的接入文档在 https://taotoken.net/doc 里面有 API Key 模式的配置方法。文件保存失败但模型调用正常这种最隐蔽。模型调用通了但文件没保存。排查步骤第一看日志里有没有file_save记录。没有的话是指令没触发保存动作在指令里加“保存到”和“不要解析”。第二有file_save但ERROR看错误类型。Permission denied改权限No such file or directory建目录。第三确认default_dir路径存在且可写。第四确认allowed_extensions包含你要保存的文件类型。保存到了错误的位置比如你想存桌面结果存到了用户主目录。原因default_dir没配或者配了但没生效。排查第一确认配置文件里default_dir是绝对路径不是相对路径。第二确认 workbuddy 重启过。第三在指令里显式写绝对路径比如“保存到 /Users/你的用户名/Desktop/资料”。同名文件被覆盖如果你不希望覆盖把overwrite设为false。这样同名文件会加时间戳后缀比如test_20250101_100000.txt。排查的时候记住一个原则先验证模型调用再验证文件保存。模型调用不通文件保存肯定不通。模型调用通了文件保存不通就是路径或权限问题。分开验证能快速定位。6. 长期使用建议与接入入口文件保存这个场景配好之后日常用起来很顺。但有几个长期使用的建议。第一定期检查日志。日志文件会越来越大建议每周清理一次。可以在配置里设logging.level为warn减少日志量。排查问题的时候再临时改成info。第二Key 的额度管理。在控制台给 Key 设额度上限防止意外超支。地址是 https://taotoken.net/console/api-keys 。如果 Key 泄露了立即删除重建。第三模型切换。如果你发现某个模型在文件保存场景下理解指令不准换一个 Model ID 试试。Base URL 和 Key 不用改只改 Model ID。这就是统一 Key 的好处。第四保存目录的组织。建议按日期或类型分子目录比如资料/2025-01/或资料/文档/。在指令里写清楚子目录比如“保存到资料/文档”。workbuddy 会按你给的路径创建。如果你还没配好接入先去控制台创建 Keyhttps://taotoken.net/console/api-keys 。创建完看文档确认 Model IDhttps://taotoken.net/doc 。想先测试模型对话效果可以用模型对话页面https://taotoken.net/chat 。如果你打算长期用 workbuddy 做编码或 Agent 类任务可以看 Coding Planhttps://taotoken.net/coding-plan 。Claude Code 用户看这个接入文档https://taotoken.net/doc/claudecode 。API 入口统一是 https://taotoken.net/api 不要加多余路径。最后给一个日常使用的指令模板你可以直接复制到微信对话框以后我发给你的文件不要解析直接保存到 /Users/你的用户名/Desktop/资料同名文件加时间戳保存完告诉我完整路径发一次这个指令后续再发文件它就会按这个规则执行。保存完会回复你完整路径方便确认。如果某次没按规则来检查是不是指令被新的对话覆盖了重新发一次模板就行。实测下来配好三件套和保存目录之后文件保存的成功率很高。剩下的问题基本都在指令清晰度和目录权限上。把这两点控制好日常用起来没什么障碍。
workbuddy使用技巧一：文件保存路径与TaoToken配置实践
1. workbuddy 文件保存到底难在哪从桌面资料文件夹说起workbuddy 是一个把智能体能力封装进微信对话的桌面工具你扫码连上微信之后就能在聊天窗口里让它帮你干活。它能做什么最典型的一类就是文件保存你把手机里的文件丢给它它帮你落到电脑指定目录。适合谁适合那些不想折腾原生配置、只想用聊天方式管理文件的人。但真正用起来文件保存这个场景的坑比想象中多。我见过最多的情况是你在微信里说“帮我把这个文件存到桌面的资料文件夹”它回你一句“已解析文件内容”然后文件根本没落地。为什么因为默认行为是解析不是保存。解析和保存是两条不同的执行路径前者读内容后者写磁盘。你不明确说“保存”它就可能走解析。还有一个高频问题路径写错。你说“桌面”它可能理解成/root/Desktop也可能理解成/home/你的用户名/Desktop甚至在某些封装环境里桌面目录压根不存在。路径不存在保存就失败但报错信息往往很含糊只告诉你“操作未完成”。再往下权限问题。workbuddy 运行在某个用户上下文里如果目标目录属于另一个用户或者目录权限是755而当前用户不是 owner写入就会被拒绝。这种失败在日志里通常表现为Permission denied或EACCES但微信对话框里可能只显示“保存失败请重试”。最后是模型调用层面的问题。workbuddy 背后要调模型来理解你的指令如果 API Key 没配好、Base URL 写错、Model ID 对不上整个链路就断了。这时候你看到的可能不是“保存失败”而是“请求超时”或“认证失败”。很多人会误以为是文件保存的问题其实是接入配置的问题。所以这篇内容我会按两条线走一条是文件保存路径的设置与排查另一条是 TaoToken 统一 Key 的接入配置。两条线在实际使用中是交织的——保存失败可能是路径问题也可能是模型调用问题得分开验证。先明确一个核心检索词workbuddy 文件保存路径设置。你搜这个词大概率是遇到了保存位置不对、保存失败、或者不知道怎么改默认目录。下面我从环境准备开始一步步给可复制的配置。在开始之前你需要确认几件事workbuddy 已经安装并扫码连上微信你知道自己的操作系统是 Windows 还是 macOS 还是 Linux你能访问终端或命令行。这些是后续所有操作的前提。另外提醒一点workbuddy 的对话窗口里指令要尽量明确。不要说“处理这个文件”要说“把这个文件保存到某个绝对路径”。模糊指令会让模型走解析路径而不是保存路径。这是很多人踩的第一个坑。2. TaoToken 前置统一 Key 与 Base URL 怎么配workbuddy 要调模型就得有接入配置。TaoToken 在这里的角色是提供统一的 API 入口你不需要分别去配多家模型的 Key用一个 Key 就能切换不同模型。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。先说清楚为什么要用统一 Key。workbuddy 这类工具在解析文件、理解指令、生成回复时可能调用不同能力的模型。如果每个模型都单独配 Key管理成本高而且切换模型时要改多处配置。统一 Key 的好处是Base URL 不变Key 不变只改 Model ID 就能换模型。你需要准备三样东西Base URL、API Key、Model ID。这三件套在后面的配置文件里会反复出现。Base URL 填https://taotoken.net/api注意不要加多余的路径也不要加 UTM 参数。API Key 在控制台创建地址是 https://taotoken.net/console/api-keys 。Model ID 根据你要用的模型填比如对话类、代码类各有对应的 ID。创建 Key 的步骤打开控制台找到 API Keys 页面点创建复制生成的 Key。这个 Key 只显示一次丢了就得重新建。建议建完之后先在一个测试脚本里验证确认能通再写进 workbuddy 的配置。验证 Key 是否可用可以用最简单的 curl 请求。下面这个命令你可以直接复制把你的Key替换成实际值curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的Key \ -H Content-Type: application/json \ -d { model: 你的ModelID, messages: [{role: user, content: 回复ok}] }如果返回里有choices字段说明 Key 和 Base URL 都没问题。如果返回 401说明 Key 错了或没带对。如果返回local proxy failed说明网络层有问题不是 Key 的问题。这里要强调Base URL 必须是https://taotoken.net/api不要写成https://taotoken.net/api/v1再加/chat/completions导致路径重复。很多 404 都是路径拼错造成的。Model ID 怎么选如果你只是让 workbuddy 理解指令、做文件保存这类操作选一个通用的对话模型就行。如果你还要它解析代码文件选代码能力强的模型。具体 ID 在文档里查地址是 https://taotoken.net/doc 。配置写在哪里workbuddy 的配置文件位置取决于你的安装方式。常见的位置包括用户目录下的.workbuddy/config.json或settings.json。如果你用的是 Claude Code 类的封装可能在~/.claude/settings.json。下面给一个通用的 JSON 配置片段路径和字段名按你的实际文件调整{ api: { base_url: https://taotoken.net/api, api_key: 你的Key, model: 你的ModelID }, file_save: { default_dir: /Users/你的用户名/Desktop/资料, auto_parse: false } }注意auto_parse这个字段设为false表示默认不解析直接保存。这能避免前面说的“它去解析了但没保存”的问题。如果你的配置文件里没有这个字段可以在指令里明确说“不要解析直接保存”。如果你用的是 TOML 格式的配置比如某些 Rust 工具链的封装写法类似[api] base_url https://taotoken.net/api api_key 你的Key model 你的ModelID [file_save] default_dir /Users/你的用户名/Desktop/资料 auto_parse false配置改完之后要重启 workbuddy否则不生效。重启方式看你的安装方式一般是退出托盘图标再重新打开或者在终端里CtrlC再重新运行。还有一个容易忽略的点Key 的权限。如果你在控制台给 Key 设了额度限制或模型白名单而 workbuddy 调用的模型不在白名单里就会报 403。这时候不是 Key 错了是权限不够。去控制台检查 Key 的权限设置。3. 可复制配置保存目录与统一 Key 的完整写法这一节给完整的可复制配置包括保存目录的设置和 TaoToken 三件套的写入。你按自己的系统改路径就行。先确定保存目录。Windows 下桌面路径通常是C:\Users\你的用户名\Desktop\资料macOS 下是/Users/你的用户名/Desktop/资料Linux 下是/home/你的用户名/Desktop/资料。注意反斜杠和正斜杠的区别JSON 里反斜杠要转义写成C:\\Users\\...。创建目录的命令# macOS / Linux mkdir -p ~/Desktop/资料 # Windows PowerShell New-Item -ItemType Directory -Force -Path $env:USERPROFILE\Desktop\资料创建完之后确认权限ls -ld ~/Desktop/资料输出应该是drwxr-xr-x开头owner 是你当前用户。如果 owner 不对用chown改。如果权限是r--没有写权限用chmod uw加写权限。接下来是 workbuddy 的配置文件。假设配置文件在~/.workbuddy/config.json完整内容如下{ api: { base_url: https://taotoken.net/api, api_key: sk-你的实际Key, model: 你的ModelID, timeout: 60 }, file_save: { default_dir: /Users/你的用户名/Desktop/资料, auto_parse: false, overwrite: false, allowed_extensions: [.pdf, .docx, .txt, .md, .png, .jpg] }, logging: { level: info, file: /Users/你的用户名/.workbuddy/logs/workbuddy.log } }几个字段说明timeout是请求超时秒数文件大或模型慢的时候可以调大。overwrite设为false表示同名文件不覆盖会加时间戳后缀。allowed_extensions限制可保存的文件类型防止意外保存可执行文件。logging.file是日志路径排查问题时要看这个文件。如果你用的是 Claude Code 的 settings.json配置结构不同但三件套是一样的{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的实际Key, ANTHROPIC_MODEL: 你的ModelID } }注意这里的变量名是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY不是通用的base_url。不同工具的环境变量名不一样写错了就不生效。Claude Code 的接入文档在 https://taotoken.net/doc 里面有完整的变量名列表。如果你用的是 Cline 或类似的 VS Code 插件配置在插件的设置界面里填三个字段Base URL、API Key、Model ID。Base URL 填https://taotoken.net/api不要填别的。Codex 的auth.json配置类似{ base_url: https://taotoken.net/api, api_key: sk-你的实际Key, model: 你的ModelID }文件路径通常在~/.codex/auth.json。改完之后重启 Codex。CC Switch 这类工具也是同样的三件套逻辑Base URL、Key、Model ID。不管界面长什么样核心就这三个值。记住这一点换任何工具都能快速配好。配置写完之后先别急着在微信里发文件。先在终端里跑一个测试请求确认模型调用是通的。用第 2 节给的 curl 命令返回choices就说明接入没问题。接入没问题了再去测文件保存。文件保存的测试在微信对话框里发一句“把 /tmp/test.txt 保存到 /Users/你的用户名/Desktop/资料”。如果/tmp/test.txt不存在先创建一个echo test content /tmp/test.txt然后发指令。成功的话去资料文件夹里看应该有test.txt。失败的话看日志文件找ERROR行。4. 验证请求与成功结果从日志确认保存动作配置写完只是第一步验证才是关键。这一节给完整的验证流程包括模型调用验证和文件保存验证。先验证模型调用。用 curl 发一个最小请求curl -s -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的实际Key \ -H Content-Type: application/json \ -d { model: 你的ModelID, messages: [{role: user, content: 只回复两个字成功}], max_tokens: 10 } | python3 -m json.tool预期返回{ choices: [ { message: { role: assistant, content: 成功 } } ] }看到choices就说明 Base URL、Key、Model ID 三件套都对。如果报 401检查 Key 有没有复制完整有没有多余空格。如果报 404检查 Base URL 是不是https://taotoken.net/api路径有没有拼错。如果报local proxy failed检查本机网络设置不要开任何代理类工具。模型调用通了之后验证文件保存。在微信对话框里发帮我把 /tmp/test.txt 保存到 /Users/你的用户名/Desktop/资料不要解析注意“不要解析”这四个字能强制走保存路径。发完之后去终端看文件在不在ls -la ~/Desktop/资料/预期输出里有test.txt大小和/tmp/test.txt一致。用diff确认内容一致diff /tmp/test.txt ~/Desktop/资料/test.txt echo 内容一致如果文件不在看日志tail -50 ~/.workbuddy/logs/workbuddy.log日志里会有请求记录和错误信息。成功的保存会有一条类似file_save success: /tmp/test.txt - /Users/.../资料/test.txt的记录。失败的话会有ERROR行后面跟原因。常见的成功日志长这样2025-01-01 10:00:00 INFO api request: modelxxx, tokens50 2025-01-01 10:00:01 INFO file_save: source/tmp/test.txt, dest/Users/.../资料/test.txt 2025-01-01 10:00:01 INFO file_save success如果日志里只有api request没有file_save说明模型理解了指令但没触发保存动作。这时候要检查指令里有没有“保存”这个关键词或者auto_parse是不是true导致走了解析路径。如果日志里有file_save但后面跟ERROR看错误类型。Permission denied是权限问题No such file or directory是路径问题Disk full是磁盘满。验证保存成功还有一个方法在微信里问它“刚才的文件保存到哪了”。如果配置正确它会回复你配置的default_dir。如果回复的是别的路径说明配置没生效检查配置文件路径对不对有没有重启。再给一个批量验证的脚本你可以保存成verify.sh#!/bin/bash KEYsk-你的实际Key MODEL你的ModelID BASEhttps://taotoken.net/api echo 1. 测试模型调用... curl -s -X POST $BASE/v1/chat/completions \ -H Authorization: Bearer $KEY \ -H Content-Type: application/json \ -d {\model\:\$MODEL\,\messages\:[{\role\:\user\,\content\:\ok\}],\max_tokens\:5} \ | grep -q choices echo 模型调用 OK || echo 模型调用 FAIL echo 2. 测试目录权限... test -w ~/Desktop/资料 echo 目录可写 OK || echo 目录不可写 FAIL echo 3. 测试文件保存... echo verify /tmp/verify.txt cp /tmp/verify.txt ~/Desktop/资料/verify.txt 2/dev/null \ echo 文件保存 OK || echo 文件保存 FAIL跑这个脚本三项都 OK 就说明基础环境没问题。如果第三项 FAIL是系统权限问题不是 workbuddy 的问题。5. 常见错误排查401、local proxy failed、reading choices、OAuth这一节对照真实报错给排查步骤。这些错误我在配置过程中都遇到过按顺序排查基本能解决。401 Unauthorized报错原文{error:{message:Invalid API key,type:authentication_error}}原因Key 错了、没带、或者带了多余字符。排查步骤第一确认Authorization头是Bearer sk-xxx格式Bearer和 Key 之间有一个空格。第二确认 Key 没有过期或被删除去控制台看 Key 状态。第三确认 Key 没有前后空格复制的时候容易带上。第四确认 Base URL 是https://taotoken.net/api不是别的域名。如果 curl 能通但 workbuddy 报 401说明 workbuddy 的配置文件里 Key 写错了或者配置文件没被读取。检查配置文件路径确认 workbuddy 读的是你改的那个文件。local proxy failed报错原文local proxy failed: connection refused或proxy error原因本机有代理类工具在运行请求被拦截了。排查步骤第一关掉所有代理类软件。第二检查环境变量HTTP_PROXY和HTTPS_PROXY如果有值就清掉unset HTTP_PROXY unset HTTPS_PROXY第三检查~/.curlrc或~/.wgetrc里有没有代理配置。第四重启终端再试。这个错误和 TaoToken 无关是本机网络环境的问题。清掉代理配置后请求就能正常出去。reading choices 相关报错报错原文error reading choices: unexpected end of JSON input或cannot read property choices of undefined原因返回的响应不是预期的 JSON 结构。可能是 Base URL 拼错导致返回了 HTML 错误页也可能是 Model ID 不存在导致返回了错误对象。排查步骤第一用 curl 加-v看完整响应curl -v -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d {model:你的ModelID,messages:[{role:user,content:ok}]}第二看响应体是不是 JSON。如果是 HTML说明 URL 错了。第三确认 Model ID 在文档里有拼写一致。第四确认请求体里messages字段格式正确是数组每个元素有role和content。OAuth 相关报错报错原文OAuth token expired或invalid_grant原因某些工具用 OAuth 方式认证token 过期了。如果你用的是 Claude Code 的 OAuth 流程需要重新登录。但如果你用的是 API Key 方式不应该出现 OAuth 错误。排查步骤第一确认你用的是 API Key 而不是 OAuth。第二如果工具强制走 OAuth看它的文档怎么切换到 API Key 模式。第三Claude Code 的接入文档在 https://taotoken.net/doc 里面有 API Key 模式的配置方法。文件保存失败但模型调用正常这种最隐蔽。模型调用通了但文件没保存。排查步骤第一看日志里有没有file_save记录。没有的话是指令没触发保存动作在指令里加“保存到”和“不要解析”。第二有file_save但ERROR看错误类型。Permission denied改权限No such file or directory建目录。第三确认default_dir路径存在且可写。第四确认allowed_extensions包含你要保存的文件类型。保存到了错误的位置比如你想存桌面结果存到了用户主目录。原因default_dir没配或者配了但没生效。排查第一确认配置文件里default_dir是绝对路径不是相对路径。第二确认 workbuddy 重启过。第三在指令里显式写绝对路径比如“保存到 /Users/你的用户名/Desktop/资料”。同名文件被覆盖如果你不希望覆盖把overwrite设为false。这样同名文件会加时间戳后缀比如test_20250101_100000.txt。排查的时候记住一个原则先验证模型调用再验证文件保存。模型调用不通文件保存肯定不通。模型调用通了文件保存不通就是路径或权限问题。分开验证能快速定位。6. 长期使用建议与接入入口文件保存这个场景配好之后日常用起来很顺。但有几个长期使用的建议。第一定期检查日志。日志文件会越来越大建议每周清理一次。可以在配置里设logging.level为warn减少日志量。排查问题的时候再临时改成info。第二Key 的额度管理。在控制台给 Key 设额度上限防止意外超支。地址是 https://taotoken.net/console/api-keys 。如果 Key 泄露了立即删除重建。第三模型切换。如果你发现某个模型在文件保存场景下理解指令不准换一个 Model ID 试试。Base URL 和 Key 不用改只改 Model ID。这就是统一 Key 的好处。第四保存目录的组织。建议按日期或类型分子目录比如资料/2025-01/或资料/文档/。在指令里写清楚子目录比如“保存到资料/文档”。workbuddy 会按你给的路径创建。如果你还没配好接入先去控制台创建 Keyhttps://taotoken.net/console/api-keys 。创建完看文档确认 Model IDhttps://taotoken.net/doc 。想先测试模型对话效果可以用模型对话页面https://taotoken.net/chat 。如果你打算长期用 workbuddy 做编码或 Agent 类任务可以看 Coding Planhttps://taotoken.net/coding-plan 。Claude Code 用户看这个接入文档https://taotoken.net/doc/claudecode 。API 入口统一是 https://taotoken.net/api 不要加多余路径。最后给一个日常使用的指令模板你可以直接复制到微信对话框以后我发给你的文件不要解析直接保存到 /Users/你的用户名/Desktop/资料同名文件加时间戳保存完告诉我完整路径发一次这个指令后续再发文件它就会按这个规则执行。保存完会回复你完整路径方便确认。如果某次没按规则来检查是不是指令被新的对话覆盖了重新发一次模板就行。实测下来配好三件套和保存目录之后文件保存的成功率很高。剩下的问题基本都在指令清晰度和目录权限上。把这两点控制好日常用起来没什么障碍。
