跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.profy.cn/llms.txt

Use this file to discover all available pages before exploring further.

​
应用市场

Portal 应用市场是 Profy 面向消费者的统一应用入口。用户可以浏览分类、搜索应用、查看技能详情并管理收藏。市场的公开接口无需登录即可访问，降低发现门槛。

​
概述

​
核心功能

​
应用分类

应用按业务类型组织为多个分类，支持国际化标签。分类数据通过 appCategories + appCategoryLocales 表存储，前端根据用户语言偏好自动展示对应名称。

​
热门应用

首页展示热门应用推荐，由 /api/market/application/hot 接口返回，无需登录即可查看。

​
应用详情

每个应用拥有唯一的 appUuid，详情页展示完整描述、输入参数定义、定价信息和关联技能。

​
收藏管理

登录用户可以收藏/取消收藏应用，并通过收藏列表快速访问常用应用。收藏数据通过 applicationFavorites 表持久化。

​
技能列表

技能（Skill）是应用的原子能力单元，可独立浏览和搜索。技能详情包含描述、参数定义和关联的应用信息。

​
数据模型

​
API 接口

​
公开接口（无需认证）

公开接口在 Auth Filter 中通过 PUBLIC_PREFIXES 白名单放行，无需携带 Token。
方法路径说明
GET/api/market/category/list获取应用分类列表
POST/api/market/application/list分页查询应用列表
GET/api/market/application/detail/:appUuid应用详情
GET/api/market/application/hot热门应用推荐
POST/api/market/skill/list分页查询技能列表
POST/api/market/skill/detail技能详情

​
需要认证的接口

方法路径说明
POST/api/market/application/favorite收藏应用
POST/api/market/application/unfavorite取消收藏
POST/api/market/application/favorite/list收藏列表

​
请求/响应示例

查询应用列表： 
// POST /api/market/application/list
{
  "categoryId": 1,
  "keyword": "翻译",
  "page": 1,
  "pageSize": 20
}
响应格式： 
{
  "code": 0,
  "data": {
    "list": [
      {
        "appUuid": "app-xxxxx",
        "name": "智能翻译",
        "description": "多语言实时翻译",
        "icon": "https://...",
        "categoryId": 1
      }
    ],
    "total": 42,
    "page": 1,
    "pageSize": 20
  }
}

​
前端页面

路径功能
/[locale]/market市场首页，分类浏览 + 搜索
/[locale]/market/[appUuid]应用详情页
/[locale]/favorites收藏列表
前端使用 @profy/fetch 的 market 子模块进行类型安全的 API 调用，所有接口自动携带分页参数和用户 Token。

​
接入流程

​
相关链接

任务调度

从市场发现应用到创建和执行任务

Agent 平台

Expert 技能市场与 Agent 实例管理