mcpField
T
tinyship-ai

tinyship-ai

github.com/tinyshipcn开发585 次安装2 周前更新
代码仓库

关于 tinyship-ai

tinyship-ai 是 TinyShip 中配置 AI 功能的技能，面向需要启用聊天、图像和视频生成的项目维护者。它说明了提供商设置、配置文件和验证步骤，并介绍如何扩展提供商及设置积分消耗。

主要功能

  1. 01配置 AI 聊天提供商
  2. 02设置图像生成提供商与模型
  3. 03设置视频生成提供商与模型
  4. 04配置 AI 功能积分消耗
  5. 05添加新的 AI 提供商

适用场景

  1. 01为 TinyShip 启用 AI 聊天
  2. 02配置图像或视频生成功能
  3. 03为 AI 功能设置积分成本

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tinyshipcn/tinyship-skills --skill tinyship-ai

安装后在 Claude Code 中输入/tinyship-ai确认已加载。

详细介绍

TinyShip AI 集成

TinyShip 中 AI 功能的配置指南。基于 Vercel AI SDK 构建。

可用功能

功能提供商配置文件
AI 聊天Qwen、DeepSeek、OpenAIconfig/ai.ts
图像生成fal.ai、Gemini、Qwenconfig/aiImage.ts
视频生成Qwen（DashScope）、Volcengineconfig/aiVideo.ts

询问用户希望启用哪些功能。

AI 聊天设置

步骤 1：选择提供商
提供商优势成本API 密钥来源
Qwen（推荐）支持中文和英文，性价比高低Aliyun DashScope
DeepSeek编码能力强，价格非常低非常低DeepSeek Platform
OpenAI综合性能最佳高OpenAI Platform
步骤 2：配置环境

将所选提供商的 API 密钥添加到 .env：

# Default provider selection
AI_PROVIDER="qwen"  # or "deepseek" or "openai"

# Qwen
QWEN_API_KEY="sk-xxxxx"
QWEN_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"

# DeepSeek
DEEPSEEK_API_KEY="sk-xxxxx"

# OpenAI
OPENAI_API_KEY="sk-xxxxx"
OPENAI_BASE_URL=""  # optional: custom gateway URL
步骤 3：验证
  1. 启动开发服务器
  2. 访问 /ai
  3. 发送测试消息
  4. 验证流式响应是否正常

图像生成设置

将所选提供商的 API 密钥添加到 .env：

# fal.ai (recommended, supports many models)
FAL_API_KEY="xxxxx"

# Google Gemini
GOOGLE_GENERATIVE_AI_API_KEY="xxxxx"
GOOGLE_GENERATIVE_AI_BASE_URL=""  # optional: custom gateway

# Qwen (reuses QWEN_API_KEY from chat setup)

在 config/aiImage.ts 中配置可用模型。配置文件定义了可用的模型及其默认参数。

在 /image-generate 验证。

视频生成设置

将所选提供商的 API 密钥添加到 .env：

# Qwen/DashScope (reuses QWEN_API_KEY)
# No additional config needed if Qwen chat is already set up

# Volcengine
VOLCENGINE_ACCESS_KEY_ID="xxxxx"
# VOLCENGINE_BASE_URL="https://ark.cn-beijing.volces.com"  # optional

在 config/aiVideo.ts 中配置可用模型。

在 /video-generate 验证。

积分消耗（可选）

如果希望 AI 功能消耗积分，请配置 config/credits.ts：

credits: {
  consumptionMode: 'dynamic',
  dynamicChatCostPerKiloToken: 1,
  modelMultipliers: {
    'qwen-turbo': 1.0,
    'qwen-max': 2.0,
    'deepseek-chat': 0.5,
    'gpt-4': 3.0,
    'default': 1.0
  },
  imageGenerationCost: 5,   // credits per image
  videoGenerationCost: 20,  // credits per video
}

确保已设置积分购买方案（使用 tinyship-payment skill）。

添加新的 AI 提供商

阅读 libs/ai/AGENTS.md 了解完整流程。概要如下：

  1. 安装 SDK：pnpm add @ai-sdk/new-provider
  2. 更新 libs/ai/types.ts 中的类型
  3. 在 libs/ai/config.ts 中添加环境变量密钥映射
  4. 在 libs/ai/providers.ts 中实现提供商
  5. 将环境变量添加到 env.example

TinyShip 仓库中的参考文件

  • config/ai.ts — 聊天提供商配置
  • config/aiImage.ts — 图像生成配置
  • config/aiVideo.ts — 视频生成配置
  • config/credits.ts — AI 功能的积分消耗
  • libs/ai/AGENTS.md — AI 库架构和提供商模式
  • libs/credits/AGENTS.md — 积分系统架构
  • docs/user-guide/ai/chat.md — AI 聊天文档
  • docs/user-guide/ai/image.md — 图像生成文档
  • docs/user-guide/ai/video.md — 视频生成文档

评论

支持 Markdown