🦜 CiBird 词鸟

你的私人英语单词本，住在你自己的 VPS 上，AI 自动造句，专攻推特/游戏英语场景

一行命令安装

curl -sSL https://raw.githubusercontent.com/zhangyang-games/cibird/main/install.sh | bash

安装过程会问你：

选 AI 服务商（推荐 Gemini 免费额度 / DeepSeek 便宜好用）
粘贴 API Key
设置登录密码
选端口（默认 8848）

完成后脚本会告诉你访问地址，打开浏览器就能用。

功能

➕ 添加单词 → AI 自动生成释义、音标、2 个例句（口语/推特/游戏场景）
🔊 发音 → 点击发音按钮，浏览器直接朗读
📝 笔记 → 每个单词可以写自己的理解或记忆方法
✦ 重新造句 → 一键让 AI 换新例句
🔍 搜索 → 支持按单词、释义、笔记搜索
📱 全平台 → 手机/电脑浏览器均可访问，SPA 单页应用

支持的 AI 服务商

服务商	推荐模型	备注
Google Gemini	gemini-2.0-flash	免费额度大，首选
DeepSeek	deepseek-chat	国产良心价
Groq	llama-3.1-8b-instant	速度极快，免费
OpenRouter	任意	一个 Key 用几十种模型
Claude	claude-haiku-4-5	Anthropic 原生
OpenAI	gpt-4o-mini	ChatGPT 同款

管理命令

cibird           # 查看状态
cibird start     # 启动
cibird stop      # 停止
cibird restart   # 重启
cibird log       # 查看日志（排查问题）

常见问题

Q: 装完打不开网页？
A: Oracle Cloud 需要在"安全列表"里添加端口规则，腾讯云/阿里云要在安全组开放端口。

Q: AI 造句失败？
A: 运行 cibird log 看报错，通常是 API Key 填错了。

Q: 怎么换 AI 服务商？
A: 编辑 ~/cibird/config.json，修改 provider / api_key / model，然后 cibird restart。

文件结构

~/cibird/
├── server.py       后端服务
├── index.html      前端单页应用
├── config.json     配置（API Key 等，权限 600）
├── cibird.db       单词数据库（SQLite）
├── cibird.pid      进程 ID
└── cibird.log      运行日志

展翅高飞 🦜

2.3 KiB Raw Blame History Unescape Escape