01下载与安装
下载
- 前往官网下载页：Windows 下载
.exe（x64）；macOS（Apple Silicon / M 系列）下载.dmg - 系统要求：Windows 需 Windows 10 / 11 64 位；macOS 需 Big Sur 11 及以上（Intel 机型为 2013 年 Haswell 及之后的处理器，Apple Silicon 需 macOS 13+）
- 国内网络直连：安装包与更新全部托管在自家服务器，无需科学上网
安装
- Windows：双击安装包，按向导完成即可，无需管理员权限；bun 运行时已内嵌，无需安装 Node / bun 等任何环境
- macOS：打开
.dmg把铁蛋拖入「应用程序」；首次打开若提示无法验证开发者，到「系统设置 → 隐私与安全性」点「仍要打开」
旧版本升级路径
| 当前版本 | 升级方式 |
|---|---|
| v0.7.6 ~ v0.7.9 | 应用内「检查更新」直接直升，无需手动操作 |
| v0.7.4 / v0.7.5 | 旧版更新公钥有误、无法应用内直升，请到官网手动下载覆盖安装一次（数据不受影响） |
| v0.7.3 及更早 | 官网下载最新版覆盖安装 |
02注册与登录
采用邮箱验证码登录：不设密码，收码即登录，验证通过自动创建账号（新用户免注册）。手机号通道即将开放。
- 首次启动会自动弹出登录引导；也可随时点主界面侧栏底部的登录入口
- 输入邮箱，点「获取验证码」
- 到邮箱收信（发件人「铁蛋 TieDan」），验证码 5 分钟内有效，收件箱没有就翻垃圾邮件
- 回应用输入 6 位数字验证码，提交即登录成功
- 内测期间登录即免费，登录后即可使用免费模型
- 会员状态多端同步：Windows / macOS 同一账号权益一致
- 验证码按邮箱冷却，发送后需等倒计时结束才能重发；邮箱/手机号通道切换会清掉旧码并重置倒计时，属正常现象
03模型接入
铁蛋是「模型的车库」：可以开官方备好的免费车，也可以接自己的车（API Key）。入口都在 「设置 → 供应商与密钥」。
免费模型（推荐首选）
- 「设置 → 供应商与密钥 → 免费模型」
- 打开「启用免费模型」开关——无需 API 密钥，启用后即可在模型选择器中使用
- 在「免费模型列表」里可单独启用/停用每个模型；点「检测可用性」做真实调用测试，查看可用状态与响应延迟
- 回到对话界面，模型选择器里选带「免费」徽标的模型即可开聊
自备 API Key
- 到模型厂商官网创建 API Key 并复制
- 「设置 → 供应商与密钥」→ 选择厂商 → 粘贴 Key 保存，应用自动拉取模型目录
- 提示「API Key 无效」时，通常是复制不完整或 Key 已过期
模型按用途分区管理：对话 / 语音识别 / 语音合成 / 视觉 / 图像生成 / 图像编辑 / 视频生成 / 向量嵌入 / 重排序 / 故障转移。日常关注「对话」即可；知识库检索依赖「向量嵌入」，免费模型路线已自动配好。
04核心功能
对话与会话
- 左侧栏是会话列表：新建会话开始新话题，多线话题互不干扰
- 发送前在模型选择器确认当前模型；「桌面伙伴」是常驻的日常问答入口
知识库（把资料喂给 AI）
- 左侧栏进入「知识库」→「新建知识库」并命名
- 新建文件夹 / 文件，或导入本地文档
- 对话时挂载知识库，提问自动触发「知识库检索」并引用你的资料
- 检索不准时优先补充资料、拆分大文档；「知识库检索模型」保持默认即可
定时任务
- 左侧栏「定时任务」→ 新建：写清「执行时间 + 要做的事」，AI 按计划自动执行并汇报
- 列表可暂停 / 恢复 / 立即运行 / 删除；运行产出落到对应会话，可点「前往会话」回看
小程序
- 一句话让 AI 生成小工具页面（番茄钟、报销计算器…），「小程序预览」里看效果、自然语言迭代
- 满意后「发布为小程序」保存复用；支持导入、重命名、删除
创意工坊
- 创作工具集：创作 Agent、图像、视频、音频、无限画布、模板与提示词库
- 图像 / 视频生成分区需对应模型可用（自备 Key 或看免费列表是否覆盖）
智能体与 MCP 集成
- 「设置 → MCP 集成」→「添加服务器」接入外部工具（数据库、浏览器、终端等）
- 连接后可在「工具」列表查看；部分服务需 OAuth 登录授权
- AI 调用工具默认需批准 / 拒绝，执行记录可在「执行历史」审计
更多能力速览
| 入口 | 用途 |
|---|---|
| 浏览器 | 受管浏览器：AI 代为搜索、检索、操作网页，带登录态管理 |
| 终端 | AI 在本机终端执行命令、登记知识、批处理（建议技术用户使用） |
| 资产库 | 集中管理对话产出的图片/文件素材，支持标签、集合、批量操作 |
| 语音会话 | 语音对话，模型在设置对应分区配置 |
05公告与保持更新
- 公告：重要通知以首页横幅展示，紧急事项弹窗提示
- 检查更新：应用内「设置 → 检查更新」（系统托盘同款入口），全程自动签名校验，重启即生效
- 每个版本更新内容见更新日志
06反馈问题（官方主渠道）
- 应用内「设置 → 反馈问题」，表单直达开发后台；登录状态下自动关联账号便于回访
- 尽量写清：版本号 + 操作步骤 + 期望结果 + 实际结果，能截图更好
- 也可发邮件到 hi@xiaotiedan.com，或到商务合作页
FAQ常见问题
需要科学上网吗？
不需要。安装包、更新、免费模型链路全部针对国内网络直连优化。
更新失败 / 卡在下载怎么办？
直接到官网下载页重新下载覆盖安装，数据不受影响，装完即恢复自动更新能力。
启动时提示「找不到 VCRUNTIME140_1.dll / MSVCP140_1.dll」？
这是 Windows 缺少微软 VC++ 运行库（部分全新安装的系统没有预装，与铁蛋无关）。下载安装微软官方运行库 vc_redist.x64.exe（几 MB，装一次全局生效），装完直接重新打开铁蛋即可，无需重装铁蛋。
免费模型响应慢或报错？
免费通道有第三方限流，高峰期偶发。可在「免费模型」页点「检测可用性」换一个可用模型；重度使用建议自备 API Key。
我的对话数据会上传到铁蛋服务器吗？
不会。对话、文件、任务数据都在本地。但对话内容必然会发送给你所选模型的提供方（云端大模型的工作方式），敏感信息请勿发送。
卸载会丢数据吗？
覆盖安装/升级不丢数据；彻底卸载前如需保留记录，先备份应用数据再操作。
v0.7.4 / v0.7.5 点「检查更新」没反应？
这两个旧版本内置的更新公钥有误，属已知历史问题。请官网手动下载覆盖安装一次，之后自动更新恢复。
安装时提示「此应用无法在你的电脑上运行」？
这句话是 Windows 说「这个程序不是给你这台电脑的系统版本/架构准备的」，与铁蛋安装包本身无关。请先自查两项：① 按 Win + R 输入 winver 回车，看系统版本；②「设置 → 系统 → 关于」看「系统类型」是 32 位还是 64 位。铁蛋要求 Windows 10 / 11 的 64 位系统：若是 Windows 7 / 8.1，或系统类型显示 32 位，当前版本无法安装，需升级到 64 位 Windows 10 / 11；若两项都满足，说明安装包可能下载不完整（正常约 80+ MB），请到官网下载页重新下载一次再试。
Windows 安装时提示「未知发布者」，或被浏览器 / 安全软件拦截？
铁蛋目前暂未使用商业数字签名证书，所以 Windows 与部分安全软件会以「未知发布者」提示，这是正常现象，不代表安装包有问题（可在下载页核对文件大小：Windows 约 82MB、macOS 约 88–94MB）。放行方法：
- 浏览器下载时被拦：点下载提示里的「保留」/「仍然下载」
- 出现「Windows 已保护你的电脑」蓝色窗口：点「更多信息」→「仍要运行」
- 360 / 电脑管家等报风险：选择「添加信任」或「允许本次操作」（亦可临时退出安全软件后再安装）
- 安装时弹出「你要允许此应用对你的设备进行更改吗」：点「是」即可
建议始终从本官网下载页获取安装包，不要使用来源不明的安装包。若文件大小与上述不符，说明下载不完整，重新下载即可。
macOS Intel 芯片能装吗？
能。官网下载页的 Intel 版 .dmg（x64）即适用于 Intel Mac，需 macOS 11 Big Sur 及以上、2013 年 Haswell 及之后的处理器。
手机上能用吗？
移动端在建设中，功能逐步开放，请留意官网与公告。