@hupu-tech/shaper 0.2.12 → 0.2.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +12 -0
- package/README.md +6 -0
- package/dist/auth/auth.d.ts +1 -0
- package/dist/cli.js +2 -2
- package/dist/cloud/client.d.ts +0 -1
- package/dist/cloud/service-build.d.ts +2 -4
- package/dist/index.js +1 -1
- package/dist/platform/api.d.ts +2 -0
- package/dist/project/create.d.ts +9 -3
- package/dist/project/delivery.d.ts +5 -5
- package/dist/runtime.d.ts +2 -1
- package/dist/runtime.js +1 -1
- package/dist/shared-UKIFY6QO.js +19 -0
- package/package.json +1 -1
- package/skills/business/SKILL.md +158 -0
- package/skills/business/activity/README.md +14 -0
- package/skills/business/activity/hupu-leaderboard-template/SKILL.md +52 -0
- package/skills/business/activity/hupu-leaderboard-template/example/README.md +20 -0
- package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/.cloudignore +3 -0
- package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/index.js +218 -0
- package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/package.json +15 -0
- package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/scf_bootstrap +3 -0
- package/skills/business/activity/hupu-leaderboard-template/example/index.html +291 -0
- package/skills/business/activity/hupu-leaderboard-template/example/migrations/20260828210000_create_leaderboard.sql +54 -0
- package/skills/business/activity/hupu-lottery-draw/SKILL.md +50 -0
- package/skills/business/activity/hupu-lottery-draw/example/README.md +21 -0
- package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/.cloudignore +3 -0
- package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/index.js +142 -0
- package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/package.json +9 -0
- package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/scf_bootstrap +3 -0
- package/skills/business/activity/hupu-lottery-draw/example/index.html +178 -0
- package/skills/business/activity/hupu-lottery-draw/example/migrations/20260828220000_create_draw.sql +193 -0
- package/skills/business/activity/hupu-pk-voting/SKILL.md +54 -0
- package/skills/business/activity/hupu-pk-voting/example/README.md +44 -0
- package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/.cloudignore +3 -0
- package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/index.js +370 -0
- package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/package.json +15 -0
- package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/scf_bootstrap +2 -0
- package/skills/business/activity/hupu-pk-voting/example/index.html +729 -0
- package/skills/business/activity/hupu-pk-voting/example/migrations/20260828220000_create_pk_vote.sql +168 -0
- package/skills/business/activity/hupu-request-activity-execute-vote-task/SKILL.md +77 -0
- package/skills/business/activity/hupu-request-activity-get-vote-detail/SKILL.md +84 -0
- package/skills/business/activity/hupu-request-activity-get-vote-task-list/SKILL.md +86 -0
- package/skills/business/activity/hupu-request-activity-list-by-biz-keys/SKILL.md +153 -0
- package/skills/business/activity/hupu-request-activity-report-vote-task/SKILL.md +58 -0
- package/skills/business/activity/hupu-request-activity-submit-vote/SKILL.md +58 -0
- package/skills/business/activity/hupu-vote-task/SKILL.md +47 -0
- package/skills/business/community/README.md +13 -0
- package/skills/business/community/hupu-request-bbs-detail/SKILL.md +197 -0
- package/skills/business/community/hupu-request-bbs-get-tag-thread-list/SKILL.md +257 -0
- package/skills/business/community/hupu-request-bbs-get-topic-threads/SKILL.md +159 -0
- package/skills/business/community/hupu-request-bbs-gets-thread-post-list/SKILL.md +124 -0
- package/skills/business/community/hupu-request-bbs-open-post-editor/SKILL.md +75 -0
- package/skills/business/community/hupu-request-bbs-reply-post/SKILL.md +59 -0
- package/skills/business/community/hupu-score-add-score/SKILL.md +57 -0
- package/skills/business/community/hupu-score-get-item-detail/SKILL.md +173 -0
- package/skills/business/community/hupu-score-get-score/SKILL.md +263 -0
- package/skills/business/quality/README.md +7 -0
- package/skills/business/quality/hupu-security-check-audit/SKILL.md +39 -0
- package/skills/business/quality/hupu-wasm-compression/SKILL.md +69 -0
- package/skills/business/quality/hupu-wasm-compression/agents/openai.yaml +4 -0
- package/skills/business/quality/hupu-wasm-compression/tool/checks.mjs +90 -0
- package/skills/business/quality/hupu-wasm-compression/tool/compress-worker.mjs +40 -0
- package/skills/business/quality/hupu-wasm-compression/tool/public/app.js +84 -0
- package/skills/business/quality/hupu-wasm-compression/tool/public/index.html +80 -0
- package/skills/business/quality/hupu-wasm-compression/tool/public/style.css +3 -0
- package/skills/business/quality/hupu-wasm-compression/tool/server.mjs +126 -0
- package/skills/business/quality/hupu-web-security-audit/SKILL.md +45 -0
- package/skills/business/quality/hupu-web-security-audit/agents/openai.yaml +4 -0
- package/skills/business/rewards/README.md +13 -0
- package/skills/business/rewards/hupu-vacoin/SKILL.md +70 -0
- package/skills/business/rewards/hupu-vacoin-consume-coins/SKILL.md +47 -0
- package/skills/business/rewards/hupu-vacoin-get-coin-overview/SKILL.md +52 -0
- package/skills/business/rewards/hupu-vacoin-get-session-coins/SKILL.md +44 -0
- package/skills/business/rewards/hupu-vacoin-reset-session-id/SKILL.md +39 -0
- package/skills/business/rewards/hupu-vatask/SKILL.md +63 -0
- package/skills/business/rewards/hupu-vatask-complete-reward-video/SKILL.md +43 -0
- package/skills/business/rewards/hupu-vatask-consume-activity-chance/SKILL.md +48 -0
- package/skills/business/rewards/hupu-vatask-get-activity-task-state/SKILL.md +49 -0
- package/skills/business/runtime/README.md +13 -0
- package/skills/business/runtime/hupu-add-to-desktop/SKILL.md +51 -0
- package/skills/business/runtime/hupu-close-webview/SKILL.md +48 -0
- package/skills/business/runtime/hupu-cloud-auth/SKILL.md +43 -0
- package/skills/business/runtime/hupu-cloud-request/SKILL.md +56 -0
- package/skills/business/runtime/hupu-fullscreen-safe-top/SKILL.md +33 -0
- package/skills/business/runtime/hupu-navigate-to/SKILL.md +45 -0
- package/skills/business/runtime/hupu-request/SKILL.md +67 -0
- package/skills/business/runtime/hupu-seer-chat/SKILL.md +183 -0
- package/skills/business/runtime/hupu-track-report/SKILL.md +71 -0
- package/skills/business/sharing/README.md +7 -0
- package/skills/business/sharing/hupu-oss-upload-file/SKILL.md +40 -0
- package/skills/business/sharing/hupu-result-poster-posting/SKILL.md +37 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/README.md +14 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/.cloudignore +3 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/index.js +187 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/package.json +15 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/scf_bootstrap +3 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/index.html +256 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/migrations/20260828213000_create_result_poster_results.sql +60 -0
- package/skills/business/sharing/hupu-result-poster-posting/references/api-contract.md +46 -0
- package/skills/business/sharing/hupu-social-share/SKILL.md +27 -0
- package/skills/business/sports/README.md +27 -0
- package/skills/business/sports/hupu-request-basketball-player-info/SKILL.md +131 -0
- package/skills/business/sports/hupu-request-basketball-single-match/SKILL.md +158 -0
- package/skills/business/sports/hupu-request-basketball-team-info/SKILL.md +96 -0
- package/skills/business/sports/hupu-request-basketball-team-player-list/SKILL.md +108 -0
- package/skills/business/sports/hupu-request-basketball-team-salary-info/SKILL.md +85 -0
- package/skills/business/sports/hupu-request-football-coach-info/SKILL.md +76 -0
- package/skills/business/sports/hupu-request-football-live-room-news-list/SKILL.md +85 -0
- package/skills/business/sports/hupu-request-football-match-info/SKILL.md +126 -0
- package/skills/business/sports/hupu-request-football-player-info/SKILL.md +82 -0
- package/skills/business/sports/hupu-request-football-team-info/SKILL.md +83 -0
- package/skills/business/sports/hupu-request-football-team-player-season-stats/SKILL.md +73 -0
- package/skills/business/sports/hupu-request-football-team-season-year/SKILL.md +68 -0
- package/skills/business/sports/hupu-request-kog-playbyplay/SKILL.md +77 -0
- package/skills/business/sports/hupu-request-live-tab-info-list/SKILL.md +85 -0
- package/skills/business/sports/hupu-request-live-tab-list/SKILL.md +66 -0
- package/skills/business/sports/hupu-request-lol-playbyplay/SKILL.md +77 -0
- package/skills/business/sports/hupu-request-match-get-tab-detail-schedule-list/SKILL.md +113 -0
- package/skills/business/sports/hupu-request-match-query-all-diagram-info-by-id/SKILL.md +79 -0
- package/skills/business/sports/hupu-request-match-query-match-stats-by-match-info/SKILL.md +85 -0
- package/skills/business/sports/hupu-request-news-news-common-list/SKILL.md +90 -0
- package/skills/business/sports/hupu-request-news-player-news-list/SKILL.md +79 -0
- package/skills/business/sports/hupu-request-news-subject-news/SKILL.md +89 -0
- package/skills/business/sports/hupu-request-news-team-news-list/SKILL.md +76 -0
- package/skills/business/storage/README.md +9 -0
- package/skills/business/storage/hupu-cloud-save/SKILL.md +129 -0
- package/skills/business/storage/hupu-cloud-save/references/legacy-migration.md +111 -0
- package/skills/business/storage/hupu-cloud-save-load/SKILL.md +41 -0
- package/skills/business/storage/hupu-cloud-save-save/SKILL.md +45 -0
- package/skills/business/storage/hupu-storage-get-value/SKILL.md +26 -0
- package/skills/business/storage/hupu-storage-set-value/SKILL.md +42 -0
- package/skills/business/user/README.md +6 -0
- package/skills/business/user/hupu-auth-get-user-info/SKILL.md +47 -0
- package/skills/business/user/hupu-game-auth/SKILL.md +46 -0
- package/skills/core/hupu-business/SKILL.md +1 -1
- package/skills/core/hupu-business/references/runtime.md +17 -11
- package/skills/core/shaper-backend/SKILL.md +1 -1
- package/skills/core/shaper-backend/references/database.md +2 -2
- package/skills/core/shaper-backend/references/legacy.md +1 -1
- package/skills/core/shaper-backend/references/node-server.md +29 -20
- package/skills/core/shaper-development/SKILL.md +6 -1
- package/skills/core/shaper-development/references/materials.md +14 -0
- package/skills/core/shaper-development/references/project-setup.md +1 -1
- package/skills/core/shaper-game-development/SKILL.md +16 -9
- package/skills/core/shaper-game-development/references/implementation.md +13 -0
- package/skills/core/shaper-game-development/references/iteration.md +11 -0
- package/skills/core/shaper-game-development/references/playable-loop.md +12 -0
- package/skills/core/shaper-game-development/references/playtest.md +18 -0
- package/skills/core/shaper-game-development/references/sources.md +6 -0
- package/skills/core/shaper-release/SKILL.md +1 -1
- package/templates/cloud-service/README.md +4 -30
- package/templates/cloud-service/cloud.json +5 -8
- package/templates/cloud-service/package-lock.json +922 -15
- package/templates/cloud-service/release.json +4 -4
- package/templates/cloud-service/server.cjs +37 -0
- package/templates/leaderboard/README.md +3 -0
- package/templates/leaderboard/cloud/database/migrations/202611130001_leaderboard.sql +6 -0
- package/templates/leaderboard/cloud/functions/api/cloud.json +10 -0
- package/templates/leaderboard/cloud/functions/api/leaderboard.cjs +49 -0
- package/templates/leaderboard/cloud/functions/api/package-lock.json +1093 -0
- package/templates/leaderboard/cloud/functions/api/package.json +19 -0
- package/templates/leaderboard/cloud/functions/api/server.cjs +25 -0
- package/templates/leaderboard/cloud/gateway/routes.json +15 -0
- package/templates/leaderboard/docs/design.md +1 -0
- package/templates/leaderboard/docs/integration.md +12 -0
- package/templates/leaderboard/docs/product.md +1 -0
- package/templates/leaderboard/docs/validation.md +1 -0
- package/templates/leaderboard/index.html +12 -0
- package/templates/leaderboard/package-lock.json +828 -0
- package/templates/leaderboard/package.json +17 -0
- package/templates/leaderboard/public/.gitkeep +1 -0
- package/templates/leaderboard/shaper.config.json +7 -0
- package/templates/leaderboard/src/main.js +67 -0
- package/templates/leaderboard/src/style.css +69 -0
- package/templates/leaderboard/test/leaderboard.test.cjs +93 -0
- package/templates/offline-game/README.md +3 -0
- package/templates/offline-game/docs/design.md +1 -0
- package/templates/offline-game/docs/integration.md +10 -0
- package/templates/offline-game/docs/product.md +1 -0
- package/templates/offline-game/docs/validation.md +1 -0
- package/templates/offline-game/index.html +12 -0
- package/templates/offline-game/package-lock.json +828 -0
- package/templates/offline-game/package.json +16 -0
- package/templates/offline-game/public/.gitkeep +1 -0
- package/templates/offline-game/shaper.config.json +7 -0
- package/templates/offline-game/src/game.js +42 -0
- package/templates/offline-game/src/main.js +60 -0
- package/templates/offline-game/src/style.css +69 -0
- package/templates/offline-game/test/game.test.js +25 -0
- package/dist/shared-APGA5MU5.js +0 -19
- package/templates/cloud-service/handlers.cjs +0 -46
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-activity-submit-vote
|
|
3
|
+
description: 让用户对指定活动的分组和候选选项进行投票,用于搭建投票互动玩法。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.activity.submitVote(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
13
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
14
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
15
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
16
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
17
|
+
|
|
18
|
+
# Parameters
|
|
19
|
+
|
|
20
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
21
|
+
| --- | --- | --- | --- |
|
|
22
|
+
| activityId | number | 是 | 投票活动唯一ID,例如 1 |
|
|
23
|
+
| groupId | number | 是 | 投票分组唯一ID,例如 5 |
|
|
24
|
+
| itemId | number | 是 | 候选项唯一ID,例如 14 |
|
|
25
|
+
| voteNum | number | 否 | 投票票数,默认为 1 |
|
|
26
|
+
|
|
27
|
+
# Returns
|
|
28
|
+
|
|
29
|
+
- Type: `Promise<Response>`
|
|
30
|
+
|
|
31
|
+
### Response Properties
|
|
32
|
+
|
|
33
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
34
|
+
| --- | --- | --- | --- |
|
|
35
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
36
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
37
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
38
|
+
| data.succeed | boolean | 否 | 是否投票成功 |
|
|
39
|
+
|
|
40
|
+
# Examples
|
|
41
|
+
|
|
42
|
+
```javascript
|
|
43
|
+
window.ShaperAI.request.activity.submitVote({ activityId: 1, groupId: 5, itemId: 14, voteNum: 1 }).then(res => { if (res.code === 200) { console.log("投票成功"); } })
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
# Frontend Request Guard
|
|
47
|
+
|
|
48
|
+
| 策略 | 默认值 |
|
|
49
|
+
| --- | --- |
|
|
50
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
51
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
52
|
+
| 请求超时 | 8000ms |
|
|
53
|
+
| 单能力最大并发 | 不限制 |
|
|
54
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
55
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
56
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
57
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
58
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-vote-task
|
|
3
|
+
description: 通过任务 ID 直接参与投票活动任务;支持发帖、回帖、分享页面、浏览页面和评分,不用于独立抽奖活动任务。
|
|
4
|
+
metadata:
|
|
5
|
+
required-skills:
|
|
6
|
+
- hupu-request-activity-execute-vote-task
|
|
7
|
+
- hupu-request-activity-report-vote-task
|
|
8
|
+
- hupu-request-activity-get-vote-detail
|
|
9
|
+
- hupu-request-activity-submit-vote
|
|
10
|
+
- hupu-request-bbs-open-post-editor
|
|
11
|
+
- hupu-request-bbs-reply-post
|
|
12
|
+
- hupu-score-add-score
|
|
13
|
+
- hupu-social-share
|
|
14
|
+
- hupu-navigate-to
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# 投票活动任务
|
|
18
|
+
|
|
19
|
+
投票活动直接使用活动侧配置的 `activityId`、`taskId` 和 `taskCode` 执行任务,不再调用任务查询能力。`taskId`、`taskCode` 及任务目标 `schema` 必须来自活动配置或业务数据,不能臆造或写死。发帖、回帖和评分所需的帖子 ID、正文、评分对象及分值也必须来自活动配置或用户明确输入。
|
|
20
|
+
|
|
21
|
+
## 直接执行
|
|
22
|
+
|
|
23
|
+
```js
|
|
24
|
+
const result = await window.ShaperAI.request.activity.executeVoteTask({
|
|
25
|
+
activityId,
|
|
26
|
+
taskId,
|
|
27
|
+
taskCode,
|
|
28
|
+
schema,
|
|
29
|
+
link: window.location.href
|
|
30
|
+
});
|
|
31
|
+
if (result.code !== 200) {
|
|
32
|
+
console.warn(result.message);
|
|
33
|
+
}
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
直接执行时必须使用服务端或活动配置提供的任务字段;不要在前端自行增加票数、任务进度或奖励次数。
|
|
37
|
+
|
|
38
|
+
## 行为
|
|
39
|
+
|
|
40
|
+
- `SHARE_PAGE` / `share_activity`:必须由用户点击触发 `window.ShaperAI.social.share`;只有返回 `data.platform === "app-bridge"` 才能调用活动任务上报并领取奖励。Web fallback、仅打开分享面板或取消分享都不能上报。
|
|
41
|
+
- `BROWSE_PAGE`:先完成任务上报,再使用 `window.ShaperAI.navigate.to` 跳转 `schema`。
|
|
42
|
+
- `PUBLISH_THREAD`:使用 `window.ShaperAI.request.bbs.openPostEditor` 唤起发帖编辑器并预填活动提供的标题、正文、专区或话题信息;编辑器成功唤起后调用 `window.ShaperAI.request.activity.reportVoteTask({ taskId, taskCode })`。该能力不返回用户最终发布回执,不能把“编辑器已打开”表述为服务端已确认帖子发布。
|
|
43
|
+
- `REPLY`:使用 `window.ShaperAI.request.bbs.replyPost({ tid, content })` 回帖;接口返回成功后调用 `window.ShaperAI.request.activity.reportVoteTask({ taskId, taskCode })`,再提示任务完成。
|
|
44
|
+
- `CREATE_SCORE_ITEM` / `SCORE`:使用 `window.ShaperAI.score.addScore({ outBizType, outBizNo, score })` 完成评分,分值必须在 1 到 10 之间;接口返回成功后调用 `window.ShaperAI.request.activity.reportVoteTask({ taskId, taskCode })`,再提示任务完成。
|
|
45
|
+
- 未知 `taskCode`:只有在任务提供合法 `schema` 时,才能使用 `window.ShaperAI.navigate.to` 跳转;不要臆造任务行为、任务奖励或完成状态。
|
|
46
|
+
|
|
47
|
+
任务执行只支持已登录的虎扑 App。所有行为必须由用户明确点击触发并在执行期间禁用重复提交。任务上报成功后调用 `window.ShaperAI.request.activity.getVoteDetail({ activityId })` 刷新活动详情,从服务端读取最新的 `data.userRemainVoteNum`;不能在前端直接增加票数或可用次数。任务完成不等于候选项自动增加票数,投票必须另行调用 `window.ShaperAI.request.activity.submitVote`。
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# 社区互动
|
|
2
|
+
|
|
3
|
+
帖子浏览、发帖回帖、评分。本目录仅分类,技能内容暂不重构。
|
|
4
|
+
|
|
5
|
+
- [hupu-request-bbs-detail](hupu-request-bbs-detail/SKILL.md)
|
|
6
|
+
- [hupu-request-bbs-get-tag-thread-list](hupu-request-bbs-get-tag-thread-list/SKILL.md)
|
|
7
|
+
- [hupu-request-bbs-get-topic-threads](hupu-request-bbs-get-topic-threads/SKILL.md)
|
|
8
|
+
- [hupu-request-bbs-gets-thread-post-list](hupu-request-bbs-gets-thread-post-list/SKILL.md)
|
|
9
|
+
- [hupu-request-bbs-open-post-editor](hupu-request-bbs-open-post-editor/SKILL.md)
|
|
10
|
+
- [hupu-request-bbs-reply-post](hupu-request-bbs-reply-post/SKILL.md)
|
|
11
|
+
- [hupu-score-add-score](hupu-score-add-score/SKILL.md)
|
|
12
|
+
- [hupu-score-get-item-detail](hupu-score-get-item-detail/SKILL.md)
|
|
13
|
+
- [hupu-score-get-score](hupu-score-get-score/SKILL.md)
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-bbs-detail
|
|
3
|
+
description: 查看帖子的标题、正文、作者、话题与互动数据,用于帖子详情页展示。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.bbs.detail(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 优先从 data.moduleConfigList.title.moduleContent.title 读取帖子标题;兼容旧版扁平字段 data.title。
|
|
13
|
+
- 优先从 data.moduleConfigList.content.moduleContent.content 读取帖子正文 HTML;兼容旧版扁平字段 data.content。
|
|
14
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
15
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
16
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
17
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
18
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
19
|
+
|
|
20
|
+
# Parameters
|
|
21
|
+
|
|
22
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
23
|
+
| --- | --- | --- | --- |
|
|
24
|
+
| tid | string | 是 | 帖子唯一ID,例如 "123456" |
|
|
25
|
+
|
|
26
|
+
# Returns
|
|
27
|
+
|
|
28
|
+
- Type: `Promise<Response>`
|
|
29
|
+
|
|
30
|
+
### Response Properties
|
|
31
|
+
|
|
32
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
33
|
+
| --- | --- | --- | --- |
|
|
34
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
35
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
36
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
37
|
+
| data.basicInfo | object | 否 | 帖子基础信息 |
|
|
38
|
+
| data.basicInfo.fid | number | 否 | 论坛版块 ID |
|
|
39
|
+
| data.basicInfo.topicCategoryName | string | 否 | 话题分类名称 |
|
|
40
|
+
| data.basicInfo.author | object | 否 | 作者信息 |
|
|
41
|
+
| data.basicInfo.author.puid | number | 否 | 作者 PUID |
|
|
42
|
+
| data.basicInfo.author.name | string | 否 | 作者昵称 |
|
|
43
|
+
| data.basicInfo.author.nftInfo | object | 否 | NFT 信息 |
|
|
44
|
+
| data.basicInfo.author.nftInfo.assetAmount | number / null | 否 | NFT 资产数量,可能为 null |
|
|
45
|
+
| data.basicInfo.author.nftInfo.assetCate | string / null | 否 | NFT 资产分类,可能为 null |
|
|
46
|
+
| data.basicInfo.author.nftInfo.assetId | string / null | 否 | NFT 资产 ID,可能为 null |
|
|
47
|
+
| data.basicInfo.author.nftInfo.assetTitle | string / null | 否 | NFT 资产标题,可能为 null |
|
|
48
|
+
| data.basicInfo.author.nftInfo.assetType | string / null | 否 | NFT 资产类型,可能为 null |
|
|
49
|
+
| data.basicInfo.author.nftInfo.contentUrl | string / null | 否 | NFT 内容 URL,可能为 null |
|
|
50
|
+
| data.basicInfo.author.nftInfo.hasNFT | boolean / null | 否 | 是否拥有 NFT,可能为 null |
|
|
51
|
+
| data.basicInfo.author.nftInfo.id | number / string / null | 否 | NFT 记录 ID,可能为 null |
|
|
52
|
+
| data.basicInfo.author.nftInfo.ownerPuid | number / null | 否 | NFT 拥有者 PUID,可能为 null |
|
|
53
|
+
| data.basicInfo.author.nftInfo.shardId | number / string / null | 否 | NFT 分片 ID,可能为 null |
|
|
54
|
+
| data.basicInfo.author.nftInfo.shardNo | number / string / null | 否 | NFT 分片序号,可能为 null |
|
|
55
|
+
| data.basicInfo.author.nftInfo.shardUniqueCode | string / null | 否 | NFT 分片唯一编码,可能为 null |
|
|
56
|
+
| data.basicInfo.topicName | string | 否 | 话题名称 |
|
|
57
|
+
| data.basicInfo.topic_id | number | 否 | 话题 ID |
|
|
58
|
+
| data.basicInfo.tid | number | 否 | 帖子 ID |
|
|
59
|
+
| data.basicInfo.relation | number | 否 | 当前用户与作者关系状态 |
|
|
60
|
+
| data.basicInfo.status | number | 否 | 帖子状态 |
|
|
61
|
+
| data.basicInfo.isAuthor | boolean | 否 | 当前用户是否为作者 |
|
|
62
|
+
| data.cardList | array | 否 | 帖子卡片列表 |
|
|
63
|
+
| data.cardList[] | object | 否 | 帖子卡片项 |
|
|
64
|
+
| data.containsAi | number | 否 | 是否包含 AI 内容,0/1 |
|
|
65
|
+
| data.containsPodcast | boolean / null | 否 | 是否包含播客,可能为 null |
|
|
66
|
+
| data.contentStyleType | number / string / null | 否 | 正文样式类型,可能为 null |
|
|
67
|
+
| data.contentType | number | 否 | 内容类型 |
|
|
68
|
+
| data.deepTalk | object | 否 | 深聊/问 AI 引导信息 |
|
|
69
|
+
| data.deepTalk.guideName | string | 否 | 深聊引导标题 |
|
|
70
|
+
| data.deepTalk.guideNameSubtitle | string | 否 | 深聊引导副标题 |
|
|
71
|
+
| data.deepTalk.guideOutTime | number | 否 | 引导消失时间,单位秒 |
|
|
72
|
+
| data.deepTalk.guideStayTime | number | 否 | 引导停留时间,单位秒 |
|
|
73
|
+
| data.deepTalk.iconDay | string | 否 | 日间模式图标 URL |
|
|
74
|
+
| data.deepTalk.iconName | string | 否 | 图标名称 |
|
|
75
|
+
| data.deepTalk.iconNight | string | 否 | 夜间模式图标 URL |
|
|
76
|
+
| data.deepTalk.needShow | boolean | 否 | 是否展示深聊入口 |
|
|
77
|
+
| data.deepTalk.replyAiShow | boolean | 否 | 是否展示回复 AI 引导 |
|
|
78
|
+
| data.deepTalk.replyGuideName | string | 否 | 回复区 AI 引导文案 |
|
|
79
|
+
| data.enableCorrect | number | 否 | 是否开启纠错,0/1 |
|
|
80
|
+
| data.giftCacheDtoList | array | 否 | 礼物缓存列表 |
|
|
81
|
+
| data.giftCacheDtoList[] | object | 否 | 礼物缓存项 |
|
|
82
|
+
| data.guideWords | string / null | 否 | 引导文案,可能为 null |
|
|
83
|
+
| data.hcoinThreadDTO | object | 否 | H 币/礼物聚合信息 |
|
|
84
|
+
| data.hcoinThreadDTO.detailDtoList | array | 否 | H 币/礼物明细列表 |
|
|
85
|
+
| data.hcoinThreadDTO.detailDtoList[] | object | 否 | H 币/礼物明细项 |
|
|
86
|
+
| data.hcoinThreadDTO.hcoinReplyDTOMap | object / null | 否 | 回复维度 H 币信息映射,可能为 null |
|
|
87
|
+
| data.hcoinThreadDTO.showGiftIconMinCount | number | 否 | 展示礼物图标的最小数量阈值 |
|
|
88
|
+
| data.hcoinThreadDTO.tid | number / null | 否 | 帖子 ID,可能为 null |
|
|
89
|
+
| data.hcoinThreadDTO.totalCoins | number | 否 | 累计 H 币数量 |
|
|
90
|
+
| data.hcoinThreadDTO.totalUsers | number | 否 | 累计参与用户数 |
|
|
91
|
+
| data.location | string | 否 | 作者 IP 属地/地理位置,可能为空字符串 |
|
|
92
|
+
| data.marketThreadFlag | boolean | 否 | 是否营销帖 |
|
|
93
|
+
| data.moduleConfigList | object | 否 | 帖子详情模块配置 |
|
|
94
|
+
| data.moduleConfigList.jfb | object | 否 | 九分半模块 |
|
|
95
|
+
| data.moduleConfigList.jfb.moduleContent | object / null | 否 | 模块内容,可能为 null |
|
|
96
|
+
| data.moduleConfigList.jfb.moduleName | string | 否 | 模块名称 |
|
|
97
|
+
| data.moduleConfigList.jfb.moduleShow | boolean / null | 否 | 是否展示模块,可能为 null |
|
|
98
|
+
| data.moduleConfigList.topic | object | 否 | 话题模块 |
|
|
99
|
+
| data.moduleConfigList.topic.moduleContent | object | 否 | 话题模块内容 |
|
|
100
|
+
| data.moduleConfigList.topic.moduleContent.tags | array | 否 | 话题标签列表 |
|
|
101
|
+
| data.moduleConfigList.topic.moduleContent.tags[].logo | string | 否 | 话题图标 URL |
|
|
102
|
+
| data.moduleConfigList.topic.moduleContent.tags[].name | string | 否 | 话题名称 |
|
|
103
|
+
| data.moduleConfigList.topic.moduleContent.tags[].topic_category | string | 否 | 话题分类名称 |
|
|
104
|
+
| data.moduleConfigList.topic.moduleContent.tags[].topic_id | number | 否 | 话题 ID |
|
|
105
|
+
| data.moduleConfigList.topic.moduleContent.tags[].unlight | number | 否 | 话题未点亮/关注状态标识 |
|
|
106
|
+
| data.moduleConfigList.topic.moduleContent.tags[].url | string | 否 | 话题跳转链接/Schema |
|
|
107
|
+
| data.moduleConfigList.topic.moduleName | string | 否 | 模块名称 |
|
|
108
|
+
| data.moduleConfigList.topic.moduleShow | boolean | 否 | 是否展示模块 |
|
|
109
|
+
| data.moduleConfigList.redpacket | object | 否 | 红包模块 |
|
|
110
|
+
| data.moduleConfigList.redpacket.moduleContent | object | 否 | 红包模块内容 |
|
|
111
|
+
| data.moduleConfigList.redpacket.moduleName | string | 否 | 模块名称 |
|
|
112
|
+
| data.moduleConfigList.redpacket.moduleShow | boolean | 否 | 是否展示模块 |
|
|
113
|
+
| data.moduleConfigList.title | object | 否 | 标题模块 |
|
|
114
|
+
| data.moduleConfigList.title.moduleContent | object | 否 | 标题模块内容 |
|
|
115
|
+
| data.moduleConfigList.title.moduleContent.merge_title | string | 否 | 合并标题,可能为空字符串 |
|
|
116
|
+
| data.moduleConfigList.title.moduleContent.title | string | 否 | 帖子标题 |
|
|
117
|
+
| data.moduleConfigList.title.moduleName | string | 否 | 模块名称 |
|
|
118
|
+
| data.moduleConfigList.title.moduleShow | boolean | 否 | 是否展示模块 |
|
|
119
|
+
| data.moduleConfigList.user | object | 否 | 用户模块 |
|
|
120
|
+
| data.moduleConfigList.user.moduleContent | object | 否 | 用户模块内容 |
|
|
121
|
+
| data.moduleConfigList.user.moduleContent.enableSendMsg | boolean | 否 | 是否允许私信 |
|
|
122
|
+
| data.moduleConfigList.user.moduleContent.header | string | 否 | 用户头像 URL |
|
|
123
|
+
| data.moduleConfigList.user.moduleContent.name | string | 否 | 用户昵称 |
|
|
124
|
+
| data.moduleConfigList.user.moduleContent.nftInfo | object | 否 | NFT 信息 |
|
|
125
|
+
| data.moduleConfigList.user.moduleContent.nftInfo.assetAmount | number / null | 否 | NFT 资产数量,可能为 null |
|
|
126
|
+
| data.moduleConfigList.user.moduleContent.nftInfo.assetCate | string / null | 否 | NFT 资产分类,可能为 null |
|
|
127
|
+
| data.moduleConfigList.user.moduleContent.nftInfo.assetId | string / null | 否 | NFT 资产 ID,可能为 null |
|
|
128
|
+
| data.moduleConfigList.user.moduleContent.nftInfo.assetTitle | string / null | 否 | NFT 资产标题,可能为 null |
|
|
129
|
+
| data.moduleConfigList.user.moduleContent.nftInfo.assetType | string / null | 否 | NFT 资产类型,可能为 null |
|
|
130
|
+
| data.moduleConfigList.user.moduleContent.nftInfo.contentUrl | string / null | 否 | NFT 内容 URL,可能为 null |
|
|
131
|
+
| data.moduleConfigList.user.moduleContent.nftInfo.hasNFT | boolean / null | 否 | 是否拥有 NFT,可能为 null |
|
|
132
|
+
| data.moduleConfigList.user.moduleContent.nftInfo.id | number / string / null | 否 | NFT 记录 ID,可能为 null |
|
|
133
|
+
| data.moduleConfigList.user.moduleContent.nftInfo.ownerPuid | number / null | 否 | NFT 拥有者 PUID,可能为 null |
|
|
134
|
+
| data.moduleConfigList.user.moduleContent.nftInfo.shardId | number / string / null | 否 | NFT 分片 ID,可能为 null |
|
|
135
|
+
| data.moduleConfigList.user.moduleContent.nftInfo.shardNo | number / string / null | 否 | NFT 分片序号,可能为 null |
|
|
136
|
+
| data.moduleConfigList.user.moduleContent.nftInfo.shardUniqueCode | string / null | 否 | NFT 分片唯一编码,可能为 null |
|
|
137
|
+
| data.moduleConfigList.user.moduleContent.ornament | string | 否 | 头像挂件 URL |
|
|
138
|
+
| data.moduleConfigList.user.moduleContent.puid | number | 否 | 用户 PUID |
|
|
139
|
+
| data.moduleConfigList.user.moduleContent.time | string | 否 | 帖子发布时间展示文案 |
|
|
140
|
+
| data.moduleConfigList.user.moduleContent.type | number | 否 | 用户/作者类型 |
|
|
141
|
+
| data.moduleConfigList.user.moduleContent.view | number | 否 | 浏览数 |
|
|
142
|
+
| data.moduleConfigList.user.moduleName | string | 否 | 模块名称 |
|
|
143
|
+
| data.moduleConfigList.user.moduleShow | boolean | 否 | 是否展示模块 |
|
|
144
|
+
| data.moduleConfigList.content | object | 否 | 正文内容模块 |
|
|
145
|
+
| data.moduleConfigList.content.moduleContent | object | 否 | 正文模块内容 |
|
|
146
|
+
| data.moduleConfigList.content.moduleContent.content | string | 否 | 帖子正文 HTML 字符串 |
|
|
147
|
+
| data.moduleConfigList.content.moduleContent.description | string | 否 | 帖子摘要/描述文案 |
|
|
148
|
+
| data.moduleConfigList.content.moduleName | string | 否 | 模块名称 |
|
|
149
|
+
| data.moduleConfigList.content.moduleShow | boolean | 否 | 是否展示模块 |
|
|
150
|
+
| data.podcastInfo | object / null | 否 | 播客信息,可能为 null |
|
|
151
|
+
| data.replies | number | 否 | 回复数 |
|
|
152
|
+
| data.searchWords | array | 否 | 正文命中的搜索词/实体词列表 |
|
|
153
|
+
| data.searchWords[].extraData | object | 否 | 搜索词扩展数据 |
|
|
154
|
+
| data.searchWords[].extraData.itemId | string | 否 | 实体项 ID |
|
|
155
|
+
| data.searchWords[].extraData.itemType | string | 否 | 实体项类型 |
|
|
156
|
+
| data.searchWords[].fromIndex | number | 否 | 命中词在正文中的起始位置 |
|
|
157
|
+
| data.searchWords[].jumpUrl | string | 否 | 点击跳转链接/Schema |
|
|
158
|
+
| data.searchWords[].name | string | 否 | 命中词名称 |
|
|
159
|
+
| data.searchWords[].toIndex | number | 否 | 命中词在正文中的结束位置 |
|
|
160
|
+
| data.tagInfoList | array | 否 | 标签信息列表 |
|
|
161
|
+
| data.tagInfoList[] | object | 否 | 标签信息项 |
|
|
162
|
+
| data.templateId | number | 否 | 模板 ID |
|
|
163
|
+
| data.templateType | number | 否 | 模板类型 |
|
|
164
|
+
| data.topicPushingFlag | boolean | 否 | 是否话题推送 |
|
|
165
|
+
| data.videoTranscodeState | number / string / null | 否 | 视频转码状态,可能为 null |
|
|
166
|
+
| data.video_info | object / null | 否 | 视频信息,可能为 null |
|
|
167
|
+
| data.visibleRange | string | 否 | 可见范围,如 ALL_SEE |
|
|
168
|
+
| data.title | string | 否 | 兼容旧版扁平字段:帖子标题 |
|
|
169
|
+
| data.content | string | 否 | 兼容旧版扁平字段:帖子正文 HTML 字符串 |
|
|
170
|
+
| data.author | string | 否 | 兼容旧版扁平字段:作者昵称/账号名称 |
|
|
171
|
+
| data.avatar | string | 否 | 兼容旧版扁平字段:作者头像 URL,可能为空字符串 |
|
|
172
|
+
| data.replyCount | number | 否 | 兼容旧版扁平字段:回复数量 |
|
|
173
|
+
| data.lightReplyCount | number | 否 | 兼容旧版扁平字段:亮评数量 |
|
|
174
|
+
| data.recommends | number | 否 | 兼容旧版扁平字段:推荐/点亮数量 |
|
|
175
|
+
| data.fid | number / string | 否 | 兼容旧版扁平字段:论坛版块 ID;接口缺失时可能为空字符串 |
|
|
176
|
+
| data.forumName | string | 否 | 兼容旧版扁平字段:论坛版块名称,可能为空字符串 |
|
|
177
|
+
| success | boolean | 否 | 接口业务是否成功 |
|
|
178
|
+
|
|
179
|
+
# Examples
|
|
180
|
+
|
|
181
|
+
```javascript
|
|
182
|
+
window.ShaperAI.request.bbs.detail({ tid: "12345" }).then(res => { if (res.code === 200) { console.log(res.data.moduleConfigList?.title?.moduleContent?.title || res.data.title); } })
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
# Frontend Request Guard
|
|
186
|
+
|
|
187
|
+
| 策略 | 默认值 |
|
|
188
|
+
| --- | --- |
|
|
189
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
190
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
191
|
+
| 请求超时 | 8000ms |
|
|
192
|
+
| 单能力最大并发 | 不限制 |
|
|
193
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
194
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
195
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
196
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
197
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,257 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-bbs-get-tag-thread-list
|
|
3
|
+
description: 按话题标签拉取帖子列表,支持分页与游标加载,用于话题聚合页展示。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.bbs.getTagThreadList(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 优先从返回数据的 list 字段读取帖子流,若 list 为空则回退读取 threads 字段
|
|
13
|
+
- 分页加载结束判定:当返回数据中的 nextPage 字段为 false 时,代表没有更多数据
|
|
14
|
+
- 兼容返回中的 next_page、stamp、total 字段,并按实际返回原样保留
|
|
15
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
16
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
17
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
18
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
19
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
20
|
+
|
|
21
|
+
# Parameters
|
|
22
|
+
|
|
23
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
24
|
+
| --- | --- | --- | --- |
|
|
25
|
+
| tagId | string | 是 | 话题 ID,来自话题详情的 tagId,如 "152660" |
|
|
26
|
+
| tabType | string | 是 | Tab 类型,如 "1" 为最新发布,"2" 为最新回复 |
|
|
27
|
+
| page | number | 是 | 分页页码,从 1 开始,刷新时传 1,之后递增 |
|
|
28
|
+
| lastCursor | string | 是 | 上一页返回的游标,首页传空串 "" |
|
|
29
|
+
| scene | string | 否 | 可选,场景标识(活动/运营场景) |
|
|
30
|
+
| activityId | string | 否 | 可选,活动 ID,用于埋点区分 |
|
|
31
|
+
|
|
32
|
+
# Returns
|
|
33
|
+
|
|
34
|
+
- Type: `Promise<Response>`
|
|
35
|
+
|
|
36
|
+
### Response Properties
|
|
37
|
+
|
|
38
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
39
|
+
| --- | --- | --- | --- |
|
|
40
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
41
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
42
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
43
|
+
| data.cursor | string | 否 | 下一页请求的游标,加载更多时传给 lastCursor |
|
|
44
|
+
| data.nextPage | boolean | 否 | 是否还有下一页 |
|
|
45
|
+
| data.next_page | number | 否 | 兼容旧分页字段;优先使用 nextPage 判断是否还有更多数据 |
|
|
46
|
+
| data.stamp | number / null | 否 | 分页时间戳/服务端返回的列表标记,可能为 null |
|
|
47
|
+
| data.total | number / null | 否 | 总数,接口可能返回 null |
|
|
48
|
+
| data.list | array | 否 | 帖子列表数组 |
|
|
49
|
+
| data.list[].tid | number | 否 | 帖子唯一 ID |
|
|
50
|
+
| data.list[].title | string | 否 | 帖子标题 |
|
|
51
|
+
| data.list[].summary | string | 否 | 帖子摘要/正文截断内容,可能为空字符串 |
|
|
52
|
+
| data.list[].puid | number | 否 | 发帖人 PUID |
|
|
53
|
+
| data.list[].fid | number | 否 | 论坛版块 ID |
|
|
54
|
+
| data.list[].replies | number | 否 | 回复数 |
|
|
55
|
+
| data.list[].repliesDesc | string / null | 否 | 回复数展示文案,可能为 null |
|
|
56
|
+
| data.list[].userName | string | 否 | 发帖人昵称 |
|
|
57
|
+
| data.list[].userHeader | string | 否 | 发帖人头像 URL |
|
|
58
|
+
| data.list[].time | string | 否 | 帖子展示时间,如 "07-19" |
|
|
59
|
+
| data.list[].createTime | number | 否 | 发帖时间戳 |
|
|
60
|
+
| data.list[].lastPostTime | number | 否 | 最后回复/更新时间戳 |
|
|
61
|
+
| data.list[].recommendCount | number | 否 | 推荐/亮了数量 |
|
|
62
|
+
| data.list[].shareNum | number | 否 | 分享数 |
|
|
63
|
+
| data.list[].topicId | number | 否 | 帖子所属话题/专区 ID |
|
|
64
|
+
| data.list[].topicName | string | 否 | 帖子所属话题/专区名称 |
|
|
65
|
+
| data.list[].topicIcon | string | 否 | 帖子所属话题/专区图标 URL |
|
|
66
|
+
| data.list[].topThread | boolean | 否 | 是否置顶帖 |
|
|
67
|
+
| data.list[].specialIdentifyPics | string / null | 否 | 特殊标识图片 URL,可能为 null |
|
|
68
|
+
| data.list[].nightSpecialIdentifyPics | string / null | 否 | 夜间模式特殊标识图片 URL,可能为 null |
|
|
69
|
+
| data.list[].specialIdentifyPicsWidth | number / null | 否 | 特殊标识图片宽度,可能为 null |
|
|
70
|
+
| data.list[].specialIdentifyPicsHeight | number / null | 否 | 特殊标识图片高度,可能为 null |
|
|
71
|
+
| data.list[].videoThread | boolean | 否 | 是否视频帖 |
|
|
72
|
+
| data.list[].jumpUrl | string | 否 | 帖子跳转 Schema/链接 |
|
|
73
|
+
| data.list[].video | object / null | 否 | 视频信息;非视频帖为 null |
|
|
74
|
+
| data.list[].video.duration | number | 否 | 视频时长,单位秒 |
|
|
75
|
+
| data.list[].video.vid | number | 否 | 视频 ID |
|
|
76
|
+
| data.list[].video.img | string | 否 | 视频封面 URL |
|
|
77
|
+
| data.list[].video.size | number | 否 | 视频大小,单位字节 |
|
|
78
|
+
| data.list[].video.width | number | 否 | 视频宽度 |
|
|
79
|
+
| data.list[].video.play_num | number | 否 | 播放数 |
|
|
80
|
+
| data.list[].video.url | string | 否 | 视频播放 URL |
|
|
81
|
+
| data.list[].video.bullet_comment_num | number | 否 | 弹幕数 |
|
|
82
|
+
| data.list[].video.height | number | 否 | 视频高度 |
|
|
83
|
+
| data.list[].video.humanDuration | string | 否 | 格式化视频时长,如 "4:04" |
|
|
84
|
+
| data.list[].video.humanSize | string | 否 | 格式化视频大小,如 "29MB" |
|
|
85
|
+
| data.list[].picList | array | 否 | 图片列表 |
|
|
86
|
+
| data.list[].picList[].url | string | 否 | 图片 URL |
|
|
87
|
+
| data.list[].picList[].is_gif | number | 否 | 是否 GIF,0 表示否,1 表示是 |
|
|
88
|
+
| data.list[].picList[].width | number | 否 | 图片宽度 |
|
|
89
|
+
| data.list[].picList[].height | number | 否 | 图片高度 |
|
|
90
|
+
| data.list[].picList[].type | string | 否 | 图片类型,如 common |
|
|
91
|
+
| data.list[].picList[].videoUrl | string / null | 否 | 图片关联视频 URL,可能为 null |
|
|
92
|
+
| data.list[].containPic | boolean | 否 | 是否包含图片 |
|
|
93
|
+
| data.list[].lightReplyResult | object / null | 否 | 亮评信息;无亮评时为 null |
|
|
94
|
+
| data.list[].lightReplyResult.lightReplyData | object | 否 | 亮评内容 |
|
|
95
|
+
| data.list[].lightReplyResult.lightReplyData.pid | number | 否 | 亮评回复 ID |
|
|
96
|
+
| data.list[].lightReplyResult.lightReplyData.tid | number | 否 | 亮评所属帖子 ID |
|
|
97
|
+
| data.list[].lightReplyResult.lightReplyData.aid | number / null | 否 | 亮评 aid,可能为 null |
|
|
98
|
+
| data.list[].lightReplyResult.lightReplyData.puid | number | 否 | 亮评用户 PUID |
|
|
99
|
+
| data.list[].lightReplyResult.lightReplyData.username | string | 否 | 亮评用户昵称 |
|
|
100
|
+
| data.list[].lightReplyResult.lightReplyData.user_ip | string | 否 | 亮评用户 IP |
|
|
101
|
+
| data.list[].lightReplyResult.lightReplyData.via | number | 否 | 亮评来源端标识 |
|
|
102
|
+
| data.list[].lightReplyResult.lightReplyData.content | string | 否 | 亮评内容 |
|
|
103
|
+
| data.list[].lightReplyResult.lightReplyData.quote | object / null | 否 | 引用回复信息;无引用时为 null |
|
|
104
|
+
| data.list[].lightReplyResult.lightReplyData.quote.rerferInfo | object | 否 | 被引用用户信息(接口字段名为 rerferInfo) |
|
|
105
|
+
| data.list[].lightReplyResult.lightReplyData.quote.rerferInfo.username | string | 否 | 被引用用户昵称 |
|
|
106
|
+
| data.list[].lightReplyResult.lightReplyData.quote.rerferInfo.puid | number | 否 | 被引用用户 PUID |
|
|
107
|
+
| data.list[].lightReplyResult.lightReplyData.quote.content | string | 否 | 被引用回复内容 |
|
|
108
|
+
| data.list[].lightReplyResult.lightReplyData.quote.togglecontent | string / null | 否 | 折叠/展开内容,可能为 null |
|
|
109
|
+
| data.list[].lightReplyResult.lightReplyData.quote.attr | string | 否 | 引用回复扩展属性序列化字符串 |
|
|
110
|
+
| data.list[].lightReplyResult.lightReplyData.quote.videoInfo | object / null | 否 | 引用回复视频信息,可能为 null |
|
|
111
|
+
| data.list[].lightReplyResult.lightReplyData.quote.ancillaryContents | array / null | 否 | 引用回复附属内容,可能为 null |
|
|
112
|
+
| data.list[].lightReplyResult.lightReplyData.quote.pid | number | 否 | 被引用回复 ID |
|
|
113
|
+
| data.list[].lightReplyResult.lightReplyData.create_time | number | 否 | 亮评创建时间戳 |
|
|
114
|
+
| data.list[].lightReplyResult.lightReplyData.update_info | string | 否 | 亮评更新信息 |
|
|
115
|
+
| data.list[].lightReplyResult.lightReplyData.attr | string | 否 | 亮评扩展属性序列化字符串 |
|
|
116
|
+
| data.list[].lightReplyResult.lightReplyData.score | number | 否 | 亮评分数 |
|
|
117
|
+
| data.list[].lightReplyResult.lightReplyData.checkReplyInfo | object | 否 | 亮评检查/回复状态信息 |
|
|
118
|
+
| data.list[].lightReplyResult.lightReplyData.checkReplyInfo.type | number | 否 | 状态类型 |
|
|
119
|
+
| data.list[].lightReplyResult.lightReplyData.checkReplyInfo.num | number | 否 | 状态数量 |
|
|
120
|
+
| data.list[].lightReplyResult.lightReplyData.light_count | number | 否 | 亮了数量 |
|
|
121
|
+
| data.list[].lightReplyResult.lightReplyData.allLightCount | number | 否 | 总亮了数量 |
|
|
122
|
+
| data.list[].lightReplyResult.lightReplyData.videoInfo | object / null | 否 | 亮评视频信息,可能为 null |
|
|
123
|
+
| data.list[].lightReplyResult.lightReplyData.header | string | 否 | 亮评用户头像 URL |
|
|
124
|
+
| data.list[].lightReplyResult.lightReplyData.header_big | string | 否 | 亮评用户大头像 URL |
|
|
125
|
+
| data.list[].lightReplyResult.lightReplyData.header_small | string | 否 | 亮评用户小头像 URL |
|
|
126
|
+
| data.list[].lightReplyResult.lightReplyData.groupId | number | 否 | 用户组 ID |
|
|
127
|
+
| data.list[].lightReplyResult.lightReplyData.picInfos | array | 否 | 亮评图片信息列表 |
|
|
128
|
+
| data.list[].lightReplyResult.lightReplyData.ancillaryContents | array / null | 否 | 亮评附属内容,可能为 null |
|
|
129
|
+
| data.list[].lightReplyResult.total | number | 否 | 亮评总数 |
|
|
130
|
+
| data.list[].timeFormatter | string / null | 否 | 时间格式化结果,可能为 null |
|
|
131
|
+
| data.list[].contentType | number | 否 | 内容类型 |
|
|
132
|
+
| data.list[].voteThread | boolean | 否 | 是否投票帖 |
|
|
133
|
+
| data.list[].voteIdList | array | 否 | 投票 ID 列表 |
|
|
134
|
+
| data.list[].voteList | array / null | 否 | 投票信息列表,可能为 null |
|
|
135
|
+
| data.list[].showIcon | string / null | 否 | 展示图标 URL,可能为 null |
|
|
136
|
+
| data.list[].showIconNight | string / null | 否 | 夜间模式展示图标 URL,可能为 null |
|
|
137
|
+
| data.list[].certIconUrl | string / null | 否 | 认证图标 URL,可能为 null |
|
|
138
|
+
| data.list[].certTitle | string / null | 否 | 认证标题,可能为 null |
|
|
139
|
+
| data.list[].filterWords | array / null | 否 | 过滤词列表,可能为 null |
|
|
140
|
+
| data.list[].containsPodcast | boolean / null | 否 | 是否包含播客,可能为 null |
|
|
141
|
+
| data.list[].podcastInfo | object / null | 否 | 播客信息,可能为 null |
|
|
142
|
+
| data.list[].isDraw | boolean | 否 | 是否抽奖帖 |
|
|
143
|
+
| data.threads | array / null | 否 | 兼容字段;当 list 为空时可回退读取,元素结构同 list |
|
|
144
|
+
| data.threads[].tid | number | 否 | 帖子唯一 ID |
|
|
145
|
+
| data.threads[].title | string | 否 | 帖子标题 |
|
|
146
|
+
| data.threads[].summary | string | 否 | 帖子摘要/正文截断内容,可能为空字符串 |
|
|
147
|
+
| data.threads[].puid | number | 否 | 发帖人 PUID |
|
|
148
|
+
| data.threads[].fid | number | 否 | 论坛版块 ID |
|
|
149
|
+
| data.threads[].replies | number | 否 | 回复数 |
|
|
150
|
+
| data.threads[].repliesDesc | string / null | 否 | 回复数展示文案,可能为 null |
|
|
151
|
+
| data.threads[].userName | string | 否 | 发帖人昵称 |
|
|
152
|
+
| data.threads[].userHeader | string | 否 | 发帖人头像 URL |
|
|
153
|
+
| data.threads[].time | string | 否 | 帖子展示时间,如 "07-19" |
|
|
154
|
+
| data.threads[].createTime | number | 否 | 发帖时间戳 |
|
|
155
|
+
| data.threads[].lastPostTime | number | 否 | 最后回复/更新时间戳 |
|
|
156
|
+
| data.threads[].recommendCount | number | 否 | 推荐/亮了数量 |
|
|
157
|
+
| data.threads[].shareNum | number | 否 | 分享数 |
|
|
158
|
+
| data.threads[].topicId | number | 否 | 帖子所属话题/专区 ID |
|
|
159
|
+
| data.threads[].topicName | string | 否 | 帖子所属话题/专区名称 |
|
|
160
|
+
| data.threads[].topicIcon | string | 否 | 帖子所属话题/专区图标 URL |
|
|
161
|
+
| data.threads[].topThread | boolean | 否 | 是否置顶帖 |
|
|
162
|
+
| data.threads[].specialIdentifyPics | string / null | 否 | 特殊标识图片 URL,可能为 null |
|
|
163
|
+
| data.threads[].nightSpecialIdentifyPics | string / null | 否 | 夜间模式特殊标识图片 URL,可能为 null |
|
|
164
|
+
| data.threads[].specialIdentifyPicsWidth | number / null | 否 | 特殊标识图片宽度,可能为 null |
|
|
165
|
+
| data.threads[].specialIdentifyPicsHeight | number / null | 否 | 特殊标识图片高度,可能为 null |
|
|
166
|
+
| data.threads[].videoThread | boolean | 否 | 是否视频帖 |
|
|
167
|
+
| data.threads[].jumpUrl | string | 否 | 帖子跳转 Schema/链接 |
|
|
168
|
+
| data.threads[].video | object / null | 否 | 视频信息;非视频帖为 null |
|
|
169
|
+
| data.threads[].video.duration | number | 否 | 视频时长,单位秒 |
|
|
170
|
+
| data.threads[].video.vid | number | 否 | 视频 ID |
|
|
171
|
+
| data.threads[].video.img | string | 否 | 视频封面 URL |
|
|
172
|
+
| data.threads[].video.size | number | 否 | 视频大小,单位字节 |
|
|
173
|
+
| data.threads[].video.width | number | 否 | 视频宽度 |
|
|
174
|
+
| data.threads[].video.play_num | number | 否 | 播放数 |
|
|
175
|
+
| data.threads[].video.url | string | 否 | 视频播放 URL |
|
|
176
|
+
| data.threads[].video.bullet_comment_num | number | 否 | 弹幕数 |
|
|
177
|
+
| data.threads[].video.height | number | 否 | 视频高度 |
|
|
178
|
+
| data.threads[].video.humanDuration | string | 否 | 格式化视频时长,如 "4:04" |
|
|
179
|
+
| data.threads[].video.humanSize | string | 否 | 格式化视频大小,如 "29MB" |
|
|
180
|
+
| data.threads[].picList | array | 否 | 图片列表 |
|
|
181
|
+
| data.threads[].picList[].url | string | 否 | 图片 URL |
|
|
182
|
+
| data.threads[].picList[].is_gif | number | 否 | 是否 GIF,0 表示否,1 表示是 |
|
|
183
|
+
| data.threads[].picList[].width | number | 否 | 图片宽度 |
|
|
184
|
+
| data.threads[].picList[].height | number | 否 | 图片高度 |
|
|
185
|
+
| data.threads[].picList[].type | string | 否 | 图片类型,如 common |
|
|
186
|
+
| data.threads[].picList[].videoUrl | string / null | 否 | 图片关联视频 URL,可能为 null |
|
|
187
|
+
| data.threads[].containPic | boolean | 否 | 是否包含图片 |
|
|
188
|
+
| data.threads[].lightReplyResult | object / null | 否 | 亮评信息;无亮评时为 null |
|
|
189
|
+
| data.threads[].lightReplyResult.lightReplyData | object | 否 | 亮评内容 |
|
|
190
|
+
| data.threads[].lightReplyResult.lightReplyData.pid | number | 否 | 亮评回复 ID |
|
|
191
|
+
| data.threads[].lightReplyResult.lightReplyData.tid | number | 否 | 亮评所属帖子 ID |
|
|
192
|
+
| data.threads[].lightReplyResult.lightReplyData.aid | number / null | 否 | 亮评 aid,可能为 null |
|
|
193
|
+
| data.threads[].lightReplyResult.lightReplyData.puid | number | 否 | 亮评用户 PUID |
|
|
194
|
+
| data.threads[].lightReplyResult.lightReplyData.username | string | 否 | 亮评用户昵称 |
|
|
195
|
+
| data.threads[].lightReplyResult.lightReplyData.user_ip | string | 否 | 亮评用户 IP |
|
|
196
|
+
| data.threads[].lightReplyResult.lightReplyData.via | number | 否 | 亮评来源端标识 |
|
|
197
|
+
| data.threads[].lightReplyResult.lightReplyData.content | string | 否 | 亮评内容 |
|
|
198
|
+
| data.threads[].lightReplyResult.lightReplyData.quote | object / null | 否 | 引用回复信息;无引用时为 null |
|
|
199
|
+
| data.threads[].lightReplyResult.lightReplyData.quote.rerferInfo | object | 否 | 被引用用户信息(接口字段名为 rerferInfo) |
|
|
200
|
+
| data.threads[].lightReplyResult.lightReplyData.quote.rerferInfo.username | string | 否 | 被引用用户昵称 |
|
|
201
|
+
| data.threads[].lightReplyResult.lightReplyData.quote.rerferInfo.puid | number | 否 | 被引用用户 PUID |
|
|
202
|
+
| data.threads[].lightReplyResult.lightReplyData.quote.content | string | 否 | 被引用回复内容 |
|
|
203
|
+
| data.threads[].lightReplyResult.lightReplyData.quote.togglecontent | string / null | 否 | 折叠/展开内容,可能为 null |
|
|
204
|
+
| data.threads[].lightReplyResult.lightReplyData.quote.attr | string | 否 | 引用回复扩展属性序列化字符串 |
|
|
205
|
+
| data.threads[].lightReplyResult.lightReplyData.quote.videoInfo | object / null | 否 | 引用回复视频信息,可能为 null |
|
|
206
|
+
| data.threads[].lightReplyResult.lightReplyData.quote.ancillaryContents | array / null | 否 | 引用回复附属内容,可能为 null |
|
|
207
|
+
| data.threads[].lightReplyResult.lightReplyData.quote.pid | number | 否 | 被引用回复 ID |
|
|
208
|
+
| data.threads[].lightReplyResult.lightReplyData.create_time | number | 否 | 亮评创建时间戳 |
|
|
209
|
+
| data.threads[].lightReplyResult.lightReplyData.update_info | string | 否 | 亮评更新信息 |
|
|
210
|
+
| data.threads[].lightReplyResult.lightReplyData.attr | string | 否 | 亮评扩展属性序列化字符串 |
|
|
211
|
+
| data.threads[].lightReplyResult.lightReplyData.score | number | 否 | 亮评分数 |
|
|
212
|
+
| data.threads[].lightReplyResult.lightReplyData.checkReplyInfo | object | 否 | 亮评检查/回复状态信息 |
|
|
213
|
+
| data.threads[].lightReplyResult.lightReplyData.checkReplyInfo.type | number | 否 | 状态类型 |
|
|
214
|
+
| data.threads[].lightReplyResult.lightReplyData.checkReplyInfo.num | number | 否 | 状态数量 |
|
|
215
|
+
| data.threads[].lightReplyResult.lightReplyData.light_count | number | 否 | 亮了数量 |
|
|
216
|
+
| data.threads[].lightReplyResult.lightReplyData.allLightCount | number | 否 | 总亮了数量 |
|
|
217
|
+
| data.threads[].lightReplyResult.lightReplyData.videoInfo | object / null | 否 | 亮评视频信息,可能为 null |
|
|
218
|
+
| data.threads[].lightReplyResult.lightReplyData.header | string | 否 | 亮评用户头像 URL |
|
|
219
|
+
| data.threads[].lightReplyResult.lightReplyData.header_big | string | 否 | 亮评用户大头像 URL |
|
|
220
|
+
| data.threads[].lightReplyResult.lightReplyData.header_small | string | 否 | 亮评用户小头像 URL |
|
|
221
|
+
| data.threads[].lightReplyResult.lightReplyData.groupId | number | 否 | 用户组 ID |
|
|
222
|
+
| data.threads[].lightReplyResult.lightReplyData.picInfos | array | 否 | 亮评图片信息列表 |
|
|
223
|
+
| data.threads[].lightReplyResult.lightReplyData.ancillaryContents | array / null | 否 | 亮评附属内容,可能为 null |
|
|
224
|
+
| data.threads[].lightReplyResult.total | number | 否 | 亮评总数 |
|
|
225
|
+
| data.threads[].timeFormatter | string / null | 否 | 时间格式化结果,可能为 null |
|
|
226
|
+
| data.threads[].contentType | number | 否 | 内容类型 |
|
|
227
|
+
| data.threads[].voteThread | boolean | 否 | 是否投票帖 |
|
|
228
|
+
| data.threads[].voteIdList | array | 否 | 投票 ID 列表 |
|
|
229
|
+
| data.threads[].voteList | array / null | 否 | 投票信息列表,可能为 null |
|
|
230
|
+
| data.threads[].showIcon | string / null | 否 | 展示图标 URL,可能为 null |
|
|
231
|
+
| data.threads[].showIconNight | string / null | 否 | 夜间模式展示图标 URL,可能为 null |
|
|
232
|
+
| data.threads[].certIconUrl | string / null | 否 | 认证图标 URL,可能为 null |
|
|
233
|
+
| data.threads[].certTitle | string / null | 否 | 认证标题,可能为 null |
|
|
234
|
+
| data.threads[].filterWords | array / null | 否 | 过滤词列表,可能为 null |
|
|
235
|
+
| data.threads[].containsPodcast | boolean / null | 否 | 是否包含播客,可能为 null |
|
|
236
|
+
| data.threads[].podcastInfo | object / null | 否 | 播客信息,可能为 null |
|
|
237
|
+
| data.threads[].isDraw | boolean | 否 | 是否抽奖帖 |
|
|
238
|
+
|
|
239
|
+
# Examples
|
|
240
|
+
|
|
241
|
+
```javascript
|
|
242
|
+
window.ShaperAI.request.bbs.getTagThreadList({ tagId: "152660", tabType: "2", page: 1, lastCursor: "" }).then(res => { console.log(res.data.list); });
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
# Frontend Request Guard
|
|
246
|
+
|
|
247
|
+
| 策略 | 默认值 |
|
|
248
|
+
| --- | --- |
|
|
249
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
250
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
251
|
+
| 请求超时 | 8000ms |
|
|
252
|
+
| 单能力最大并发 | 不限制 |
|
|
253
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
254
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
255
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
256
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
257
|
+
| 自动分页建议上限 | 5 页 |
|