随着大模型能力普及，个人创作者与企业对可复用、可按次付费的 AI 工具型技能（Skill）需求快速增长。本项目立项旨在解决"AI 能力难以低成本、按需、合规交付"的产品问题：开发者封装的 AI 技能缺乏一个能直接对外销售、自动计费、即时履约的在线服务出口。项目业务背景为北京日舍科技有限公司旗下 AI 品牌"起点 AI"（域名 start-ai.cn），面向 C 端个人用户与 B 端企业客户，通过 SkillHub 平台分发工具型 Skill 产品，覆盖内容创作、办公自动化、数据处理等高频场景。
项目核心是一个支持多 Skill 扩展的付费服务框架，基于 X402 协议实现"技能调用 + 微信支付"全链路。主要功能模块包括：
1. Skill 插件化架构：每个 Skill 独立打包，继承 SkillBase 实现免费规则检查与执行逻辑，通过 SkillRegistry 统一注册，新增 Skill 时路由层无需改动。
2. 内置两个 Skill：① wx-md2html（Markdown 转公众号 HTML，支持 5 套模板 default/tech/warm/business/nature、扩展卡片语法 :::tip/:::warn/:::danger 等、元数据自动提炼）；② visual-card-prompt（知识卡片一键生图，通过 LLM 生成符合视觉笔记规范的图片提示词）。
3. X402 付费主流程：首请求自动下单返回 HTTP 402 + 支付凭证 Header，重试请求验真履约返回内容，支持幂等与异常自动退款。
4. 微信支付 v3 集成：Native 下单、支付回调、退款回调，支持平台公钥模式与 APIv3 密钥。
5. 免费规则系统：DEBUG 模式全局免费、各 Skill 自定义免费规则（如 default 模板免费、指定签名免费）。
6. 订单持久化：SQLAlchemy 2.0，默认 SQLite 零运维，可平滑切换 PostgreSQL，支持幂等字段自动迁移。
7. 样式缓存机制：首次提取模板样式后缓存，配合通用全集样式兜底，保证渲染性能与全标签覆盖。
8. 一键部署：systemd 守护 + Nginx 反代 + Docker/Docker Compose，deploy.sh 一键 init/deploy。
9. 公司官网：北京日舍科技有限公司企业门户站点，介绍 AI 智能技能开发、软件技术服务与信息技术咨询三大业务。
技术栈与架构：
- 后端：Python 3 + FastAPI + Gunicorn，分层架构（routers 路由层 / skills 插件层 / services 服务层 / db 数据层）。
- 数据层：SQLAlchemy 2.0 ORM，订单持久化与幂等控制，支持 SQLite/PostgreSQL 平滑切换。
- 支付层：微信支付 v3 SDK 封装（services/wechat_pay.py），支持 Native 下单、支付/退款回调、平台公钥模式；X402 协议通过 SkillHub 开发者密钥签名完成 AI 预下单。
- 插件层：SkillBase 抽象基类定义 free_check / execute / get_description 三方法契约，SkillRegistry 集中注册，路由层通过 skill_id 动态分发；目录名含连字符的插件（如 visual-card-prompt）使用动态加载。
- LLM 集成：兼容 OpenAI 协议，支持 OpenAI / DeepSeek / 通义千问 / Kimi / 智谱，通过环境变量配置。
- 样式系统：md2html 使用 style_cache 样式缓存 + universal_styles 通用全集样式 + 默认兜底样式，三级优先级保障全标签覆盖。
- 配置管理：全环境变量驱动（.env 文件），MOCK_MODE 在密钥缺失时自动启用。
- 部署：deploy.sh 一键 init/deploy，systemd 守护进程，Nginx 反代 HTTPS，已上线域名 https://www.start-ai.cn。
- 测试：tools 目录下提供插件化架构测试、convert 接口测试、visual-card-prompt 测试与 X402 全链路测试。
评论