- 个人模式 —— 安装 DOSIA，粘贴你自己的
sk-byts-...key，选模型。本页讲的就是这条路径。 - 企业模式 —— admin 通过飞书 SSO 预先开通，DOSIA 自动拿到允许的模型集，无需手动配 key。企业流程见 员工 onboarding。
安装
- macOS
- Windows / Linux
从 github.com/leave1206/dosia-releases
下载最新 dmg：
- Apple Silicon (M1/M2/M3/M4)：
DOSIA-x.y.z-arm64.dmg - Intel：
DOSIA-x.y.z.dmg
/Applications，启动。个人模式配置
拿到 ByteSpike key
console.bytespike.ai/keys → 创建 key。
按你希望 DOSIA 触达哪些模型挑路由分组（Claude 用
claude-default，Gemini 用 gemini-default，
或用 default 路由全部模型）。分组到模型的映射见 模型。保留 Personal 模式
Deploy Mode 保持默认的 Personal。Enterprise 模式是给 SSO 管理账户用的 —— 如果你的 admin 给了一个后端 URL，看 员工 onboarding。
把 ByteSpike 加成 provider
设置 → AI Models → Add Provider → “ByteSpike”。
DOSIA 会请求 ByteSpike 的
| 字段 | 值 |
|---|---|
| Base URL | https://llm.bytespike.ai |
| API key | 你的 sk-byts-... |
| 协议 | Anthropic Messages（或 OpenAI Chat Completions —— 同一个 key 都能用） |
/v1/models 拿到 key 实际能触达的模型列表。等几秒 dropdown 会填充。DOSIA 里能做什么
| 功能 | 背后 |
|---|---|
| 文本对话 | 所有文本模型（Claude / GPT / Gemini / DeepSeek / Kimi / GLM / MiniMax / Doubao） |
| 视觉（拖图进聊天框） | DOSIA 的 analyze_image MCP 工具调用视觉模型（Claude / GPT-5-4 / Gemini） |
| 图像生成（“画一张 …”） | generate_image MCP 工具路由到 Nano Banana / Seedream / GPT-Image |
| 视频生成（“生成一段视频 …”） | generate_video MCP 工具路由到 Sora / Veo / Seedance |
| Agent（多步任务） | DOSIA 的 agent 循环跨 provider 调 tool_use / function calling |
| MCP 插件 | DOSIA 内置 9 个官方插件（飞书集成、浏览器自动化、会议分析、知识库等） —— 见 github.com/leave1206/dosia-plugins |
切换模型
每个聊天线程会记住它打开时用的模型。在聊天框顶部切换 —— dropdown 列出 key 能触达的所有模型。图像 / 视频模型的选择发生在对应工具 调用内部，不需要按线程设。排错
| 症状 | 原因 | 处理 |
|---|---|---|
| 添加 provider 后报”Failed to fetch models” | key 无效或分组错 | 从 console 复制一把新 key；确认分组确实服务你预期的模型 |
| 模型 dropdown 是空的 | key 允许的模型数为 0 | 在 console 检查 key 的 group_id；换个非空分组 |
| 图像 / 视频工具按钮置灰 | DOSIA 设置里 MCP 插件没启用 | 设置 → MCP → 启用 image-tools / video-tools |
| 视觉拖拽返回 400 | 当前文本模型不支持图像输入 | 把聊天切换到 claude-sonnet-4-6、gpt-5-4 或 gemini-3-1-pro |
| ”insufficient_balance” | key（或组织钱包）credits 耗尽 | 去 console.bytespike.ai/billing 充值 |
| 首个 token 慢 | 跨协议翻译路径冷启动 | 先发一个小请求暖一下，或者热路径固定到原生协议 |
企业模式（飞书 SSO）
如果你的公司统一部署 DOSIA：admin 配置企业后端 URL，DOSIA 切到 Enterprise 模式，飞书 SSO 自动登录，允许的模型集自动同步 —— 不需要逐用户配 key。完整流程见 员工 onboarding。 Admin 侧（开通员工、监控用量、配允许分组）见 管理员运营手册。下一步
员工 onboarding
企业 / SSO 路径。
DOSIA Agent 模式
DOSIA agent 循环如何按步骤选模型。
MCP 集成
DOSIA 工具插件和模型侧之间的 bridge。
配置你的客户端
接入其他客户端（Claude Code / Codex / Cursor / SDK）。