mimic-shrimp-rs

KO | EN

gitlite — search

#hacktoberfest #go #android #docker #nodejs #java #cli #kubernetes #vue #awesome-list #security #pytorch #openai #open-source

mimic-shrimp-rs

(★ 16)

No description available.

mimic-shrimp-rs Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# mimic-shrimp-rs

仿照龙虾，搞了一个基于 Rust 的英语学习助手服务，当前重点是把“每日英语学习卡片 + 飞书互动”这条链路跑通。

## 交互式学习的有意思的地方

- 它不是一次性丢给你一大段材料，而是先给你一张当天的学习卡片，再按会话一步步往下练。
- “这句话什么意思”和“再出一道题”这种短口令就能继续推进，不需要每次都重新解释上下文。
- 文本和语音可以混着用：你可以先看摘要和重点句，再直接发一段英语语音做跟读。
- 跟读反馈不是只说“对/不对”，而是会结合重点句子给出匹配度、漏读词和可能多读的词，便于继续修正。
- 如果这轮互动本身就是英文问答，系统还能顺手补一条英语语音回复，形成“看文本 + 听语音 + 自己跟读”的闭环。

## 交互流程

1. 用户在飞书发送文本或语音消息。
2. 如果是语音消息，服务会先下载音频并转写成文本；如果当前会话已经进入“今天的英语学习”，会优先按英文语音场景做转写。
3. 转写后的文本会先判断是不是学习口令，例如 `开始今天的英语学习`、`这句话什么意思`、`再出一道题`。
4. 如果不是口令，但当前会话已经进入当天学习上下文，系统会继续尝试把这段转写文本当作跟读内容，对照当天重点句子给出反馈。
5. 如果既不是学习口令，也不是可判定的跟读文本，就回退到普通对话链路生成文本回复。
6. 文本回复发回飞书后，如果“用户这段语音像英文”且“系统生成的回复也像英文”，并且已经配置好语音合成能力，系统还会再附加回送一条英语语音回复，方便用户直接听和模仿。

## 现在能做什么

- 每天抓取固定 RSS 新闻源，生成一份“今日英语学习卡片”。
- 学习卡片包含中英摘要、重点词汇、重点句子、理解问题、跟读练习和翻译练习。
- 支持在同一会话里继续追问重点句、继续做下一题，以及对英语跟读文本给出反馈。
- 飞书里除了文本交互，也支持语音输入；在合适条件下会附加回送一条英语语音回复。
- 学习内容默认落盘保存，便于按天复用和追踪。

## 飞书接入状态

- 已接通飞书回调入口：`POST /feishu/callback`。
- 已支持接收飞书文本和语音消息事件，并异步调用现有能力后回复原消息。
- 已支持飞书学习口令优先命中英语学习流程，而不是普通聊天。
- 当前已支持的学习口令包括：`开始今天的英语学习`、`这句话什么意思`、`再出一道题`。

## 飞书演示

下面这组演示覆盖了“开始今天的英语学习”后的典型交互过程，包括卡片下发、重点句追问、继续出题，以及在同一会话里继续完成练习。

下面是可直接在 README 中播放的 2 倍速 GIF 演示；如果你想看更清晰的原始录屏，也可以打开[视频演示（MP4）](images/54346.MP4)。

![飞书英语学习完整流程演示（2 倍速）](https://raw.githubusercontent.com/847850277/mimic-shrimp-rs/main/images/54346.gif)

![飞书英语学习对话示例 1](https://raw.githubusercontent.com/847850277/mimic-shrimp-rs/main/images/1.png)

![飞书英语学习对话示例 2](https://raw.githubusercontent.com/847850277/mimic-shrimp-rs/main/images/2.png)

## 内置英语学习工具

- `english_learning_start_today`
- `english_learning_explain_focus_sentence`
- `english_learning_next_question`
- `english_learning_shadowing_feedback`

## 快速运行

```bash
cp .env.example .env
cargo run
```

如果你要启用飞书完整消息收发，至少需要配置：

- `FEISHU_APP_ID`
- `FEISHU_APP_SECRET`
- `FEISHU_CALLBACK_VERIFICATION_TOKEN`（如果飞书后台开启了 token 校验）
- `FEISHU_CALLBACK_ENCRYPT_KEY`（如果飞书后台开启了加密策略）

英语学习能力默认启用，可通过以下环境变量调整：

- `ENGLISH_LEARNING_ENABLED`
- `ENGLISH_LEARNING_SCHEDULER_ENABLED`
- `ENGLISH_LEARNING_SCHEDULE_HOUR`
- `ENGLISH_LEARNING_TZ_OFFSET_HOURS`
- `ENGLISH_LEARNING_NEWS_SOURCES`

## 详细说明

完整接口、部署、工具列表和请求示例见 [detail.md](detail.md)。

mimic-shrimp-rs

mimic-shrimp-rs Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

mimic-shrimp-rs

mimic-shrimp-rs Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README