85 lines
2.3 KiB
Markdown
85 lines
2.3 KiB
Markdown
# 🦜 CiBird 词鸟
|
||
|
||
> 你的私人英语单词本，住在你自己的 VPS 上，AI 自动造句，专攻推特/游戏英语场景
|
||
|
||
## 一行命令安装
|
||
|
||
```bash
|
||
curl -sSL https://raw.githubusercontent.com/zhangyang-games/cibird/main/install.sh | bash
|
||
```
|
||
|
||
安装过程会问你：
|
||
1. 选 AI 服务商（推荐 Gemini 免费额度 / DeepSeek 便宜好用）
|
||
2. 粘贴 API Key
|
||
3. 设置登录密码
|
||
4. 选端口（默认 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 同款 |
|
||
|
||
---
|
||
|
||
## 管理命令
|
||
|
||
```bash
|
||
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 运行日志
|
||
```
|
||
|
||
---
|
||
|
||
*展翅高飞 🦜*
|