funapp

基于 nicegui 的小型 Web 应用，提供健康检查、游戏/活动数据模型（SQLAlchemy） 以及若干便捷的本地工作入口（如一键打开商品详情页）。

安装

pip install funapp

快速开始

启动 nicegui 服务：

from funapp.server.core import run

run()

服务启动后监听 5678 端口，提供两个 HTTP 入口：

入口	说明
GET /status.taobao	健康检查，返回 success 表示存活
GET /work/item?item_id=<id>	在本机用喵街 App 打开指定商品详情页（依赖 macOS 的 open）

funapp.ui.login 只是登录页的静态布局原型：按钮和链接都没有绑定回调，run() 也不会挂载它，可用的登录流程仍待实现。

数据模型定义在 funapp.schema，使用前需通过 funsecret 配置数据库连接串 （funapp / mysql / url）。未配置时使用不含凭据的本地 sqlite:///funapp.db 数据库：

from funapp.schema import User, create_tables

create_tables()

服务启停

长期运行的 nicegui 服务统一通过 scripts/setup.sh 启停：

scripts/setup.sh run dev      # 前台运行（开发，直接加载本仓库 src/ 源码）
scripts/setup.sh start dev    # 后台运行（开发）
scripts/setup.sh status       # 查看运行状态
scripts/setup.sh stop dev     # 停止
scripts/setup.sh start prod   # 后台运行（生产，要求已 pip/uv 安装正式发布包，不回退到源码）

PID 与日志统一放在 .run/。prod 会断言 funapp 的实际加载路径落在 site-packages 内，editable 安装或 PYTHONPATH 注入都会直接报错退出。

---

关于 farfarfun

farfarfun 是一个专注于实用工具库的开源组织， 涵盖云存储、数据处理、AI、多媒体与开发工具链等方向。

• 🏠 组织主页：https://github.com/farfarfun
• 📦 PyPI：https://pypi.org/user/niuliangtao/
• 📧 联系：farfarfun@qq.com

本项目基于 MIT 协议开源。