上传文件至「/」

2026-05-14 21:05:25 +00:00
parent f8ed063b76
commit c44d7a4b63
5 changed files with 1375 additions and 0 deletions
@@ -0,0 +1,84 @@
+# 🦜 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      运行日志
+```
+
+---
+
+*展翅高飞 🦜*