> ## 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.

# 探索

> 浏览与发布推广笔记：排序与分栏规则、互动的幂等性、发布门槛与审核状态

探索（`/explore`）是用户分享专家使用成果的地方。看到别人做出的东西，一键跳到同一个专家开始你自己的尝试——这是它存在的核心理由。

## 四个 Tab

| Tab | 内容 | 需要登录 |
| - | - | - |
| **发现** | 公开笔记信息流（默认） | 否 |
| **我的笔记** | 你发布的笔记与草稿 | 是 |
| **收藏** | 你收藏的专家 | 是 |
| **点赞** | 你点过赞的笔记 | 是 |

## 信息流

### 排序

| 排序 | 依据 |
| - | - |
| 推荐 | 平台策展位 + 综合排序（默认） |
| 最新 | 发布时间 |
| 最多浏览 / 最多点赞 / 最多收藏 / 最多评论 | 对应计数 |
| 关注 | 你关注的创作者 |

未登录时选「关注」返回空列表——这是预期行为，不是加载失败。可用排序由运营配置，传入未启用的排序值会回落到默认排序而不是报错。

### 分页与分栏

* 每页 **24 条**，上限 50 条，无限滚动加载
* 瀑布流列数按视口宽度：**\<1024px 两列，1024–1279px 三列，≥1280px 四列**
* 分列用 JS 最短列贪心，追加下一页时**已渲染的卡片位置不会变**（不会跳动）

> [!NOTE]
>
> 首行卡片必然按数据顺序从左到右排列，所以「推荐第一条」永远在左上角。

## 笔记类型

媒体类型由内容**派生**，不是单独选一个开关：有 HTML 文件 → HTML 笔记；否则有视频 → 视频笔记；否则有音频 → 音乐笔记；否则按图片笔记处理。

> **图片笔记**
>
> 图文结合展示使用场景与成果

> **视频笔记**
>
> 录屏演示创作过程

> **音乐笔记**
>
> AI 音乐作品，支持手写 LRC 歌词与打点

> **互动 HTML 笔记**
>
> 嵌入可交互网页，比如 AI 生成的小游戏

> [!WARNING]
>
> HTML 笔记**必须手动上传封面**——网页内容无法自动抓帧，没有封面在信息流里就没有缩略图。封面尺寸会一并记录，用来在图片加载前占好位，避免瀑布流抖动。

## 互动

| 操作 | 幂等性 | 说明 |
| - | - | - |
| 点赞 / 收藏 | ✅ 切换式，重复点不会累加 | 同一套接口按类型区分 |
| 评论 | ❌ 每次新建 | 需要登录 |
| 分享 | ❌ 每次累加 | 分享数统计 |
| 浏览 | 无按人去重 | 见下 |

### 浏览量怎么算

每次打开详情页都算一次浏览，**不按人去重**。两道过滤：

* **机器人过滤**：常见爬虫 UA 与缺失 UA 一律不计
* **频率限制**：同一身份 **60 秒内最多计 60 次**，超出不计

浏览量先写 Redis，由后台任务每 15 秒回写数据库，所以刚刷的数字可能有十几秒延迟。登录用户还会额外记一条永久去重的浏览记录，用作转化率的分母。

### 谁能删评论

三种身份都能删同一条评论：

1. 评论作者本人
2. 笔记作者
3. 持有内容运营权限的管理员

不需要单独的评论管理后台，作者直接在笔记详情里删就行。

## 做同款

笔记详情页的「做同款」跳到该笔记关联的专家。跳转会带上笔记 ID 作为归因标记，如果你之后解锁了这个专家，这次转化会计到该笔记名下。

缺失笔记 ID 时**不归因**，系统不会猜——所以从专家市场直接进入的解锁不会算到任何笔记头上。归因写入是尽力而为的，失败不影响解锁本身。

## 发布笔记

### 门槛

任何登录用户都能发，**不需要创作者身份**。唯一硬条件：你必须用过要关联的那位专家（有对话记录），否则返回 403。

### 流程

**1. 进入发布入口**

探索 → 「我的笔记」Tab → 「发布笔记」。

**2. 选择关联专家**

列表里只有你用过的专家。

**3. 编辑内容**

上传媒体与封面，填标题和正文。

**4. AI 辅助（可选）**

「AI 生成」几秒内出文案；「AI 生成图片」是异步任务，提交后轮询结果，最长约 4 分钟。

**5. 提交审核**

通过后出现在探索。

### 提交校验

三项缺一不可，缺哪项报哪项：

| 校验 | 错误 |
| - | - |
| 标题非空 | `title is required`（400） |
| 正文非空 | `description is required`（400） |
| 至少一种媒体（图片 / 视频 / 音频 / HTML） | `media is required`（400） |

### 笔记状态

| 状态 | 含义 | 你看到的标签 |
| - | - | - |
| 草稿 | 编辑中，未提交 | 草稿 |
| 审核中 | 已提交待审 | 审核中 |
| 已发布 | 在探索展示 | 已发布 |
| 未通过 | 首次发布被拒 | 未通过 |
| 已下架 | 你自己下架的 | 已下架 |
| 违规下架 | 管理员下架，带理由 | 未通过 |

「未通过」和「违规下架」在你这边合并显示为「未通过」，因为后续操作一样：改完重新提交。驳回理由文本会区分具体问题。

已发布的笔记改版时**老版本继续在线**，新内容进待审队列；有待审提交时不能再次编辑或提交（409）。可以撤回待审提交回到可编辑状态。

## 失败与对策

| 提示 | 原因 | 怎么办 |
| - | - | - |
| 403 `You have not used this expert` | 关联了没用过的专家 | 先和该专家聊一次再发 |
| 409 已有待审提交 | 上一次提交还在审核 | 撤回或等审核结果 |
| 400 缺标题 / 正文 / 媒体 | 必填项为空 | 按提示补齐 |
| 「关注」Tab 空白 | 未登录，或还没关注任何创作者 | 登录并关注创作者 |
| 浏览量不涨 | 被频率限制，或 UA 被判为机器人 | 正常浏览器访问；数字有约 15 秒回写延迟 |
| HTML 笔记在信息流里没有图 | 没传封面 | 补一张封面重新提交 |
| 推首页按钮提示去订阅 | 没有付费订阅 | 见下方推首页说明 |

## 推首页

把笔记推到首页精选位需要**持有付费订阅**或**拥有管理员角色**，二者满足其一即可。免费用户界面会提示前往订阅页。

订阅到期后由后台任务把已推上首页的笔记降级回常规排序；管理员授予的置顶不受该回落影响。

## 相关页面

> **[专家市场](/zh/documentation/marketplace/expert-marketplace.md)**
>
> 找到你想分享的专家

> **[订阅套餐](/zh/documentation/billing/subscription-plans.md)**
>
> 推首页等付费权益


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.