飞书生活管家 zhiyang052/dsh-feishu-assistant

DSH 个人 AI 助手

基于 DeepSeek Harness 和飞书机器人的全能型个人 AI 助手：用飞书聊天框管理你的生活——记账、日历待办、健身健康、新闻推送、定时提醒、财务报告，一切数据同步到自建网站。

详见：docs/08-项目介绍.md — 功能/技术/架构/使用指南（完整版）

功能总览

| 模块 | 能力 |
| 飞书对话 | 多领域会话（日常/记账/健康）、流式卡片、AI 视觉识别截图 |
| 多账本记账 | 快捷记账（AI 自动分类）、改删流水、统计图表（ECharts）、PDF/Excel 财务报告（含 AI 总结与建议）、任意时间段导出 |
| 日历待办 | 全年日历、三类待办（每天/每周/单次）、课程表截图导入、辅导员通知自动排期、抢票倒计时提醒、完成状态全端同步 |
| 健身健康 | 身体指标（BMI/BMR/TDEE/VO2max）、运动记录（语言/截图录入）、肌肉分布图（点击部位看动作）、定制健身+饮食计划（热量缺口）、运动报告导出 |
| 定时推送 | 早报（待办+饮食+训练三合一）、课程/待办独立提醒、喝水提醒、新闻摘要、月报年报，全部可对话配置 |
| 记忆与摘抄 | 长期档案记忆（会话启动注入）、摘抄收藏、内容发布到网站 |
| 个人网站 | 主页仪表盘、日历、身体状况、账单、内容、定时任务、推送记录，所有内容飞书/网站双向同步 |
| 运维 | 开机自启、崩溃自动重启、健康检查 + 飞书故障告警、数据本地化（SQLite） |

架构

┌─────────────────────────────────────────────┐
│ 飞书 App（单聊） │ └──────────────────────┬──────────────────────┘ │ WebSocket 长连接（无需公网回调） ┌──────────────────────▼──────────────────────┐ │ feishu-bridge 插件 │ │ 消息接收/领域路由/图片下载/流式输出/审批卡片 │ └──────────────────────┬──────────────────────┘ │ followup / inject / 事件 ┌──────────────────────▼──────────────────────┐ │ DeepSeek Harness Agent（多领域会话） │ │ main（对话/健身/学习） ledger（记账） │ │ health（健康） │ └───────┬──────────────┬──────────────┬────────┘ ┌───────▼──────┐ ┌─────▼─────┐ ┌─────▼──────────┐ │ assistant-core│ │ content-web│ │ scheduler │ │ 记账/待办/健康│ │ 个人网站 │ │ 定时推送/提醒 │ │ 报表/记忆/摘抄│ │ 8090 端口 │ │ +健康检查告警 │ └───────┬──────┘ └───────────┘ └─────┬──────────┘ └──────────┬─────────────────┘ ┌──────────────────▼──────────────────────────┐ │ 数据：SQLite（记账/待办/健康/摘抄/报告存档） │ │ reminders.json（定时任务）＋ 素材文件 │ └─────────────────────────────────────────────┘

技术栈

| 层 | 技术 |
| 运行时 | Node.js 22+（内置 node:sqlite）、DeepSeek Harness（Cordis 插件体系） |
| IM 通道 | 飞书 @larksuiteoapi/node-sdk（WebSocket 长连接） |
| 模型 | DeepSeek API（deepseek-chat / deepseek-v4-flash-vision-exp 视觉） |
| 存储 | SQLite（WAL）+ JSON 配置 |
| 图表 | ECharts SSR + resvg（PNG） |
| 报表 | pdfkit（Noto CJK 字体）+ exceljs |
| 网站 | Node node:http 自建（无框架，纯静态渲染） |
| 部署 | systemd + Nginx（可选 Basic Auth 公网入口） |

环境要求

- 服务器：Ubuntu 22.04+，1 核 1G 起
- Node.js 22+（node:sqlite 需要）
- 飞书企业自建应用（机器人 + 长连接事件订阅）
- DeepSeek API Key（platform.deepseek.com）

快速开始

1. 服务器初始化

安装 Node 22+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

安装 DSH CLI
sudo npm install -g @deepseek-ai/dsh

中文字体（PDF 报告）
sudo apt-get install -y fonts-noto-cjk

2. 获取代码与依赖

git clone https://github.com/zhiyang052/dsh-feishu-assistant.git
cd dsh-assistant
npm install

3. 配置凭证

cp cordis.example.yml cordis.yml
编辑 cordis.yml：填飞书 AppID/AppSecret、服务器 IP
export DEEPSEEK_API_KEY=sk-xxx # 写入 ~/.bashrc 或 systemd EnvironmentFile

飞书应用配置（open.feishu.cn）：

1. 创建企业自建应用 → 开启机器人能力
2. 「事件与回调」→ 订阅方式选长连接 → 添加事件 im.message.receive_v1
3. 「卡片回调」→ 接收方式选长连接
4. 权限管理开通：im:message、im:message:send_as_bot、im:resource
5. 发布应用版本（改动后必须重新发布）

4. 启动

dsh web --patch ./cordis.yml

生产环境：复制 deploy/dsh-assistant.service.example 到 systemd，deploy/health-check.sh 提供飞书故障告警。

💬 使用指南（飞书对话）

| 你说 | 助手做 |
| 「帮我记一笔：中行卡 -35 午饭」 | 记账 + 自动分类 |
| 「上个月账单总结」 | 统计图表 + AI 总结 + PDF/Excel 报告 |
| 「明天下午3点体测」 | 建待办，到点提醒 |
| 「我10月1号回家」 | 自动安排抢票提醒（提前15天+提前2天） |
| 「今天跑步5公里32分钟」 | 记录运动，网站出趋势图 |
| 「定制减脂计划，不吃猪肉」 | 生成健身+饮食计划（热量缺口）+ 每周待办 |
| 「今天吃什么」 | 生成四餐推荐（含热量），明早早报推送 |
| 「12分钟跑了2500米」 | 估算 VO2max |
| 「记下来：自律给我自由」 | 存入摘抄 |
| 发课程表截图 | AI 视觉提取课程，自动生成每周待办 |

网站

http://<服务器IP>:8090（默认无鉴权，建议 Nginx Basic Auth 后公网访问）：

- 主页：今日待办（可一键完成）、账本余额、最近推送
- 日历：月历视图 + 完成率角标 + 月度统计
- 身体状况：指标卡、体重/运动趋势图、肌肉分布图、计划、饮食、AI 总结
- 账单：账本总览、生成财务报告（时间段/账本/图表/总结可配）、历史报告下载
- 内容/摘抄/定时任务/推送记录：全量归档

目录结构

assistant/
├── cordis.example.yml # 插件组合配置模板（凭证占位） ├── plugins/ │ ├── feishu-bridge/ # 飞书长连接桥接（消息/路由/图片/审批/推送） │ ├── assistant-core/ # 业务核心（记账/待办/健康/报表/记忆/调度） │ └── content-web/ # 个人网站（页面 + API） ├── deploy/ │ ├── install.sh # 一键部署脚本 │ ├── health-check.sh # 健康检查 + 飞书告警 │ └── dsh-assistant.service.example ├── data/ # 运行时数据（SQLite/配置，不入库） └── docs/ # 文档

📄 文档

- docs/01-项目方案.md — 整体方案与架构设计
- docs/02-环境搭建与API申请教程.md — 环境/飞书/API 申请
- docs/03-账单功能设计.md — 记账与报告设计
- docs/04-日历待办系统设计.md — 待办/日历/课程表/抢票
- docs/05-财务报告系统设计.md — PDF/Excel 报告
- docs/06-身体状况与健身管理设计.md — 健康/运动/肌肉图/计划
- docs/07-运维手册.md — 自启动/告警/故障排查/备份
- docs/08-项目介绍.md — 功能/技术/架构/使用指南（完整版）
- docs/09-网站搭建教程.md — 网站代码结构/改样式/加页面/部署

安全说明

- 凭证（飞书 AppSecret、DeepSeek Key）存于 cordis.yml / .env，已 gitignore
- 默认权限模式 danger-full-access（AI 可执行任意服务器命令）——个人服务器使用，生产请按需收紧
- 数据全部本地化（SQLite），无第三方存储

License

MIT