@hupu-tech/shaper 0.2.12 → 0.2.13
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 +6 -0
- package/README.md +6 -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/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-2WDEQ3AQ.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 +5 -1
- package/skills/core/shaper-development/references/project-setup.md +1 -1
- package/skills/core/shaper-game-development/SKILL.md +1 -1
- 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 +1 -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 +11 -0
- package/templates/offline-game/src/main.js +12 -0
- package/templates/offline-game/src/style.css +1 -0
- package/templates/offline-game/test/game.test.js +7 -0
- package/dist/shared-APGA5MU5.js +0 -19
- package/templates/cloud-service/handlers.cjs +0 -46
package/skills/business/activity/hupu-pk-voting/example/migrations/20260828220000_create_pk_vote.sql
ADDED
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
create extension if not exists pgcrypto;
|
|
2
|
+
|
|
3
|
+
create table public.pk_matches (
|
|
4
|
+
id text primary key,
|
|
5
|
+
title text not null,
|
|
6
|
+
description text not null default '',
|
|
7
|
+
starts_at timestamptz not null,
|
|
8
|
+
ends_at timestamptz not null,
|
|
9
|
+
status text not null default 'draft',
|
|
10
|
+
created_at timestamptz not null default now(),
|
|
11
|
+
updated_at timestamptz not null default now(),
|
|
12
|
+
constraint pk_matches_id_chk check (id ~ '^[a-z0-9][a-z0-9_-]{0,63}$'),
|
|
13
|
+
constraint pk_matches_status_chk check (status in ('draft', 'scheduled', 'live', 'ended')),
|
|
14
|
+
constraint pk_matches_time_chk check (ends_at > starts_at)
|
|
15
|
+
);
|
|
16
|
+
|
|
17
|
+
create table public.pk_candidates (
|
|
18
|
+
id uuid primary key default gen_random_uuid(),
|
|
19
|
+
match_id text not null references public.pk_matches(id) on delete cascade,
|
|
20
|
+
side text not null,
|
|
21
|
+
name text not null,
|
|
22
|
+
description text not null default '',
|
|
23
|
+
image_url text,
|
|
24
|
+
vote_count integer not null default 0,
|
|
25
|
+
created_at timestamptz not null default now(),
|
|
26
|
+
updated_at timestamptz not null default now(),
|
|
27
|
+
constraint pk_candidates_side_chk check (side in ('left', 'right')),
|
|
28
|
+
constraint pk_candidates_vote_count_chk check (vote_count >= 0),
|
|
29
|
+
constraint pk_candidates_match_side_uidx unique (match_id, side)
|
|
30
|
+
);
|
|
31
|
+
|
|
32
|
+
create table public.pk_votes (
|
|
33
|
+
id uuid primary key default gen_random_uuid(),
|
|
34
|
+
match_id text not null references public.pk_matches(id) on delete cascade,
|
|
35
|
+
candidate_id uuid not null references public.pk_candidates(id) on delete cascade,
|
|
36
|
+
side text not null,
|
|
37
|
+
puid text not null,
|
|
38
|
+
proof_url text,
|
|
39
|
+
created_at timestamptz not null default now(),
|
|
40
|
+
constraint pk_votes_side_chk check (side in ('left', 'right')),
|
|
41
|
+
constraint pk_votes_proof_url_chk check (
|
|
42
|
+
proof_url is null or (char_length(proof_url) <= 2048 and proof_url ~ '^https://')
|
|
43
|
+
),
|
|
44
|
+
constraint pk_votes_match_puid_uidx unique (match_id, puid)
|
|
45
|
+
);
|
|
46
|
+
|
|
47
|
+
create index pk_matches_status_time_idx
|
|
48
|
+
on public.pk_matches (status, starts_at, ends_at);
|
|
49
|
+
create index pk_votes_match_created_idx
|
|
50
|
+
on public.pk_votes (match_id, created_at desc, id desc);
|
|
51
|
+
create index pk_votes_puid_match_idx
|
|
52
|
+
on public.pk_votes (puid, match_id);
|
|
53
|
+
|
|
54
|
+
create or replace function public.submit_pk_vote(
|
|
55
|
+
p_match_id text,
|
|
56
|
+
p_side text,
|
|
57
|
+
p_puid text,
|
|
58
|
+
p_proof_url text default null
|
|
59
|
+
)
|
|
60
|
+
returns jsonb
|
|
61
|
+
language plpgsql
|
|
62
|
+
security definer
|
|
63
|
+
set search_path = public
|
|
64
|
+
as $$
|
|
65
|
+
declare
|
|
66
|
+
selected_match public.pk_matches;
|
|
67
|
+
selected_candidate public.pk_candidates;
|
|
68
|
+
inserted_vote public.pk_votes;
|
|
69
|
+
current_vote_count integer;
|
|
70
|
+
begin
|
|
71
|
+
if p_match_id is null or p_match_id !~ '^[a-z0-9][a-z0-9_-]{0,63}$' then
|
|
72
|
+
return jsonb_build_object('error', 'INVALID_MATCH_ID');
|
|
73
|
+
end if;
|
|
74
|
+
if p_side is null or p_side not in ('left', 'right') then
|
|
75
|
+
return jsonb_build_object('error', 'INVALID_SIDE');
|
|
76
|
+
end if;
|
|
77
|
+
if p_puid is null or btrim(p_puid) = '' or char_length(p_puid) > 128 then
|
|
78
|
+
return jsonb_build_object('error', 'INVALID_IDENTITY');
|
|
79
|
+
end if;
|
|
80
|
+
if p_proof_url is not null and (
|
|
81
|
+
char_length(p_proof_url) > 2048 or p_proof_url !~ '^https://'
|
|
82
|
+
) then
|
|
83
|
+
return jsonb_build_object('error', 'INVALID_PROOF_URL');
|
|
84
|
+
end if;
|
|
85
|
+
|
|
86
|
+
perform pg_advisory_xact_lock(hashtextextended(p_match_id || ':' || p_puid, 0));
|
|
87
|
+
|
|
88
|
+
select * into selected_match
|
|
89
|
+
from public.pk_matches
|
|
90
|
+
where id = p_match_id;
|
|
91
|
+
|
|
92
|
+
if not found then
|
|
93
|
+
return jsonb_build_object('error', 'MATCH_NOT_FOUND');
|
|
94
|
+
end if;
|
|
95
|
+
if selected_match.status in ('draft', 'scheduled') or now() < selected_match.starts_at then
|
|
96
|
+
return jsonb_build_object('error', 'MATCH_NOT_STARTED');
|
|
97
|
+
end if;
|
|
98
|
+
if selected_match.status = 'ended' or now() >= selected_match.ends_at then
|
|
99
|
+
return jsonb_build_object('error', 'MATCH_ENDED');
|
|
100
|
+
end if;
|
|
101
|
+
if exists (
|
|
102
|
+
select 1 from public.pk_votes where match_id = p_match_id and puid = p_puid
|
|
103
|
+
) then
|
|
104
|
+
return jsonb_build_object('error', 'ALREADY_VOTED');
|
|
105
|
+
end if;
|
|
106
|
+
|
|
107
|
+
select * into selected_candidate
|
|
108
|
+
from public.pk_candidates
|
|
109
|
+
where match_id = p_match_id and side = p_side;
|
|
110
|
+
|
|
111
|
+
if not found then
|
|
112
|
+
return jsonb_build_object('error', 'CANDIDATE_NOT_FOUND');
|
|
113
|
+
end if;
|
|
114
|
+
|
|
115
|
+
insert into public.pk_votes (match_id, candidate_id, side, puid, proof_url)
|
|
116
|
+
values (p_match_id, selected_candidate.id, p_side, p_puid, p_proof_url)
|
|
117
|
+
returning * into inserted_vote;
|
|
118
|
+
|
|
119
|
+
update public.pk_candidates
|
|
120
|
+
set vote_count = vote_count + 1,
|
|
121
|
+
updated_at = now()
|
|
122
|
+
where id = selected_candidate.id
|
|
123
|
+
returning vote_count into current_vote_count;
|
|
124
|
+
|
|
125
|
+
return jsonb_build_object(
|
|
126
|
+
'voteId', inserted_vote.id,
|
|
127
|
+
'side', inserted_vote.side,
|
|
128
|
+
'remaining', 0,
|
|
129
|
+
'voteCount', current_vote_count,
|
|
130
|
+
'createdAt', inserted_vote.created_at
|
|
131
|
+
);
|
|
132
|
+
end;
|
|
133
|
+
$$;
|
|
134
|
+
|
|
135
|
+
insert into public.pk_matches (
|
|
136
|
+
id, title, description, starts_at, ends_at, status
|
|
137
|
+
)
|
|
138
|
+
values (
|
|
139
|
+
'plan-final',
|
|
140
|
+
'你更支持哪一个方案?',
|
|
141
|
+
'每个登录账号限投 1 票,截止时间以服务端配置为准。',
|
|
142
|
+
now() - interval '1 day',
|
|
143
|
+
now() + interval '30 days',
|
|
144
|
+
'live'
|
|
145
|
+
)
|
|
146
|
+
on conflict (id) do nothing;
|
|
147
|
+
|
|
148
|
+
insert into public.pk_candidates (
|
|
149
|
+
match_id, side, name, description, vote_count
|
|
150
|
+
)
|
|
151
|
+
values
|
|
152
|
+
('plan-final', 'left', '方案 A', '稳健推进,优先保证核心体验。', 0),
|
|
153
|
+
('plan-final', 'right', '方案 B', '快速突破,优先验证创新方向。', 0)
|
|
154
|
+
on conflict (match_id, side) do nothing;
|
|
155
|
+
|
|
156
|
+
alter table public.pk_matches disable row level security;
|
|
157
|
+
alter table public.pk_candidates disable row level security;
|
|
158
|
+
alter table public.pk_votes disable row level security;
|
|
159
|
+
|
|
160
|
+
grant usage on schema public to anon, authenticated, service_role, public;
|
|
161
|
+
grant select on table public.pk_matches, public.pk_candidates
|
|
162
|
+
to anon, authenticated, service_role, public;
|
|
163
|
+
grant select on table public.pk_votes
|
|
164
|
+
to authenticated, service_role, public;
|
|
165
|
+
grant insert, update, delete on table public.pk_matches, public.pk_candidates, public.pk_votes
|
|
166
|
+
to service_role, public;
|
|
167
|
+
grant execute on function public.submit_pk_vote(text, text, text, text)
|
|
168
|
+
to service_role, public;
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-activity-execute-vote-task
|
|
3
|
+
description: 执行投票活动任务,支持分享页面、发帖、回帖、浏览页面、创建评分及通用 schema 跳转;任务奖励由服务端确认。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.activity.executeVoteTask(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 必须由用户点击等明确交互触发,执行期间禁用按钮,禁止自动重试或轮询
|
|
13
|
+
- 只允许在已登录的虎扑 App 内执行;任务 ID、任务编码和 schema 必须来自活动配置或业务数据
|
|
14
|
+
- SHARE_PAGE/share_activity 只有原生分享返回 data.platform === "app-bridge" 后才上报完成;Web fallback、取消分享和仅打开面板不能领取奖励
|
|
15
|
+
- PUBLISH_THREAD 在发帖编辑器成功唤起后上报;编辑器不返回用户最终发布回执。REPLY 在回帖接口成功后上报
|
|
16
|
+
- BROWSE_PAGE 先上报任务再跳转;CREATE_SCORE_ITEM 需要 App 版本 >= 8.0.79,CREATE_MOMENT 需要 App 版本 >= 8.0.78
|
|
17
|
+
- 任务执行成功不等于投票候选项得票数增加;如需确认结果,应由业务页面刷新活动数据,不得本地伪造票数或次数
|
|
18
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
19
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
20
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
21
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
22
|
+
|
|
23
|
+
# Parameters
|
|
24
|
+
|
|
25
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
26
|
+
| --- | --- | --- | --- |
|
|
27
|
+
| activityId | number | 是 | 投票活动唯一 ID,例如 123 |
|
|
28
|
+
| taskId | string | 是 | 活动配置提供的任务 ID |
|
|
29
|
+
| taskCode | string | 是 | 活动配置提供的任务行为编码,如 SHARE_PAGE、PUBLISH_THREAD、REPLY、BROWSE_PAGE |
|
|
30
|
+
| status | number | 否 | 任务状态;1 表示已完成,已完成任务不可重复执行 |
|
|
31
|
+
| schema | string | 否 | 任务目标 schema,来自任务数据;通用跳转任务必填 |
|
|
32
|
+
| title | string | 否 | 分享标题,分享任务可选 |
|
|
33
|
+
| text | string | 否 | 分享描述,分享任务可选 |
|
|
34
|
+
| imageUrl | string | 否 | 分享图片 HTTPS 地址,分享任务可选 |
|
|
35
|
+
| link | string | 否 | 分享链接,分享任务可选;默认当前活动页面 URL |
|
|
36
|
+
| topicId | string | 否 | PUBLISH_THREAD 发帖目标专区 ID,可选 |
|
|
37
|
+
| tagId | string | 否 | PUBLISH_THREAD 发帖目标话题 ID,可选 |
|
|
38
|
+
| topicName | string | 否 | PUBLISH_THREAD 发帖目标专区名称,可选 |
|
|
39
|
+
| tagName | string | 否 | PUBLISH_THREAD 发帖目标话题名称,可选 |
|
|
40
|
+
| content | string / array | 否 | PUBLISH_THREAD 的帖子正文,或 REPLY 的回帖内容 |
|
|
41
|
+
| tid | string | 否 | REPLY 目标帖子 ID |
|
|
42
|
+
|
|
43
|
+
# Returns
|
|
44
|
+
|
|
45
|
+
- Type: `Promise<Response>`
|
|
46
|
+
|
|
47
|
+
### Response Properties
|
|
48
|
+
|
|
49
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
50
|
+
| --- | --- | --- | --- |
|
|
51
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
52
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
53
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
54
|
+
| data.completed | boolean | 否 | 任务是否完成或已被服务端确认 |
|
|
55
|
+
| data.behavior | string | 否 | 实际执行的任务行为编码 |
|
|
56
|
+
| data.reported | boolean | 否 | 是否已向活动服务端上报任务完成 |
|
|
57
|
+
| data.reason | string | 否 | 失败原因编码,可能为 APP_REQUIRED、UPGRADE_REQUIRED 或 SHARE_NOT_CONFIRMED |
|
|
58
|
+
|
|
59
|
+
# Examples
|
|
60
|
+
|
|
61
|
+
```javascript
|
|
62
|
+
window.ShaperAI.request.activity.executeVoteTask({ activityId: 123, taskId, taskCode, schema, title: "活动开始啦", link: window.location.href }).then(res => { if (res.code !== 200) console.warn(res.message); })
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
# Frontend Request Guard
|
|
66
|
+
|
|
67
|
+
| 策略 | 默认值 |
|
|
68
|
+
| --- | --- |
|
|
69
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
70
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
71
|
+
| 请求超时 | 8000ms |
|
|
72
|
+
| 单能力最大并发 | 不限制 |
|
|
73
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
74
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
75
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
76
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
77
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-activity-get-vote-detail
|
|
3
|
+
description: 查看投票活动的完整信息,包括活动介绍、投票分组与候选选项,用于搭建投票玩法。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.activity.getVoteDetail(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 | string | 是 | 投票活动唯一ID,例如 "1" |
|
|
23
|
+
|
|
24
|
+
# Returns
|
|
25
|
+
|
|
26
|
+
- Type: `Promise<Response>`
|
|
27
|
+
|
|
28
|
+
### Response Properties
|
|
29
|
+
|
|
30
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
31
|
+
| --- | --- | --- | --- |
|
|
32
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
33
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
34
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
35
|
+
| data.id | number | 否 | 活动ID |
|
|
36
|
+
| data.name | string | 否 | 活动名称 |
|
|
37
|
+
| data.startDt | string | 否 | 活动开始时间(如 "2026-07-17 14:50:44") |
|
|
38
|
+
| data.endDt | string | 否 | 活动结束时间(如 "2026-07-19 23:59:59") |
|
|
39
|
+
| data.userRemainVoteNum | number | 否 | 当前用户剩余投票次数 |
|
|
40
|
+
| data.promoteOptionCount | number | 否 | 推广/置顶选项数量 |
|
|
41
|
+
| data.groups | array | 否 | 投票分组(赛道)列表 |
|
|
42
|
+
| data.groups[].id | number | 否 | 分组ID |
|
|
43
|
+
| data.groups[].activityId | number | 否 | 所属活动ID |
|
|
44
|
+
| data.groups[].name | string | 否 | 分组名称 |
|
|
45
|
+
| data.groups[].pic | string | 否 | 分组图片 URL |
|
|
46
|
+
| data.groups[].selectedPic | string | 否 | 分组选中态图片 URL |
|
|
47
|
+
| data.groups[].voteNum | number / null | 否 | 分组总投票数(可能为 null) |
|
|
48
|
+
| data.groups[].userVoteNum | number / null | 否 | 当前用户在该分组的投票数(可能为 null) |
|
|
49
|
+
| data.groups[].allowMaxVoteNum | number | 否 | 该分组允许的最大投票数 |
|
|
50
|
+
| data.groups[].parentId | number | 否 | 父分组ID,0 表示顶级分组 |
|
|
51
|
+
| data.groups[].sort | number | 否 | 排序序号 |
|
|
52
|
+
| data.groups[].items | array / null | 否 | 该分组内的候选项列表(可能为 null,候选项通常挂在子分组下) |
|
|
53
|
+
| data.groups[].items[].id | number | 否 | 选项ID |
|
|
54
|
+
| data.groups[].items[].activityId | number | 否 | 所属活动ID |
|
|
55
|
+
| data.groups[].items[].groupId | number | 否 | 所属分组ID |
|
|
56
|
+
| data.groups[].items[].name | string | 否 | 选项名称 |
|
|
57
|
+
| data.groups[].items[].pic | string | 否 | 选项图片 URL |
|
|
58
|
+
| data.groups[].items[].voteNum | number | 否 | 该选项得票数 |
|
|
59
|
+
| data.groups[].items[].userVoteNum | number | 否 | 当前用户已投给该选项的票数 |
|
|
60
|
+
| data.groups[].items[].allowMaxVoteNum | number | 否 | 该选项允许的最大投票数 |
|
|
61
|
+
| data.groups[].items[].itemDesc | string / null | 否 | 选项描述(可能为 null) |
|
|
62
|
+
| data.groups[].items[].jumpUrl | string / null | 否 | 选项跳转链接(可能为 null) |
|
|
63
|
+
| data.groups[].subGroups | array | 否 | 子分组列表,结构与本分组相同,可继续嵌套 |
|
|
64
|
+
| data.status | string | 否 | 活动状态(如 ENDED 已结束、START 进行中) |
|
|
65
|
+
|
|
66
|
+
# Examples
|
|
67
|
+
|
|
68
|
+
```javascript
|
|
69
|
+
window.ShaperAI.request.activity.getVoteDetail({ activityId: "1" }).then(res => { if (res.code === 200) { console.log(res.data); } })
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
# Frontend Request Guard
|
|
73
|
+
|
|
74
|
+
| 策略 | 默认值 |
|
|
75
|
+
| --- | --- |
|
|
76
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
77
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
78
|
+
| 请求超时 | 8000ms |
|
|
79
|
+
| 单能力最大并发 | 不限制 |
|
|
80
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
81
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
82
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
83
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
84
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-activity-get-vote-task-list
|
|
3
|
+
description: 根据活动 ID 调用 /bbsactivityapi/activity/vote/task/progress 获取投票活动任务。服务端成功响应的 data 包含 puid、date 和 taskProgressList;taskProgressList 返回每个任务的 taskId、taskCategory、status、taskName、taskCode、schema、cycle、taskAward、maxCompleteNum 和 currCompleteNum。SDK 外层统一返回 code=200/message,并保留 activityId/tasks 兼容字段。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.activity.getVoteTaskList(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 必须使用活动 ID 查询任务,不能传 sessionId 或客户端用户身份字段
|
|
13
|
+
- 返回任务字段来自服务端,taskId、taskCode、status 和 schema 只能展示或传给后续能力使用,不能自行臆造
|
|
14
|
+
- 只在页面初始化、用户完成任务返回页面或用户主动刷新时调用,禁止无限轮询和自动重试
|
|
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
|
+
| activityId | number | 是 | 投票活动唯一 ID,例如 123 |
|
|
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.activityId | number | 否 | 投票活动 ID |
|
|
39
|
+
| data.puid | number / string / null | 否 | 服务端返回的用户 PUID,未绑定用户时为 null |
|
|
40
|
+
| data.date | string | 否 | 任务进度日期,如 20260921 |
|
|
41
|
+
| data.taskProgressList | array | 否 | 服务端 data.taskProgressList 活动任务列表 |
|
|
42
|
+
| data.taskProgressList[].id | string | 否 | SDK 兼容字段,值与 taskId 对应 |
|
|
43
|
+
| data.taskProgressList[].taskId | string | 否 | 任务 ID |
|
|
44
|
+
| data.taskProgressList[].taskCode | string | 否 | 任务行为编码,如 BROWSE_PAGE、SHARE_PAGE |
|
|
45
|
+
| data.taskProgressList[].taskCategory | string | 否 | 任务分类 |
|
|
46
|
+
| data.taskProgressList[].status | number | 否 | 任务状态,服务端原值;通常 0 表示未完成 |
|
|
47
|
+
| data.taskProgressList[].taskName | string | 否 | 任务名称 |
|
|
48
|
+
| data.taskProgressList[].schema | string | 否 | 任务目标 schema,没有跳转目标时为空字符串;服务端可能返回 URL 编码值 |
|
|
49
|
+
| data.taskProgressList[].cycle | number | 否 | 任务周期 |
|
|
50
|
+
| data.taskProgressList[].taskAward | number | 否 | 任务奖励分值 |
|
|
51
|
+
| data.taskProgressList[].score | number | 否 | SDK 兼容字段,值取 taskAward |
|
|
52
|
+
| data.taskProgressList[].maxCompleteNum | number | 否 | 新版任务目标次数 |
|
|
53
|
+
| data.taskProgressList[].currCompleteNum | number | 否 | 当前已完成次数 |
|
|
54
|
+
| data.tasks | array | 否 | taskProgressList 的兼容别名 |
|
|
55
|
+
| data.tasks[].id | string | 否 | SDK 兼容字段,值与 taskId 对应 |
|
|
56
|
+
| data.tasks[].taskId | string | 否 | 任务 ID |
|
|
57
|
+
| data.tasks[].taskCode | string | 否 | 任务行为编码,如 BROWSE_PAGE、SHARE_PAGE |
|
|
58
|
+
| data.tasks[].taskCategory | string | 否 | 任务分类 |
|
|
59
|
+
| data.tasks[].status | number | 否 | 任务状态,服务端原值;通常 0 表示未完成 |
|
|
60
|
+
| data.tasks[].taskName | string | 否 | 任务名称 |
|
|
61
|
+
| data.tasks[].schema | string | 否 | 任务目标 schema,没有跳转目标时为空字符串;服务端可能返回 URL 编码值 |
|
|
62
|
+
| data.tasks[].cycle | number | 否 | 任务周期 |
|
|
63
|
+
| data.tasks[].taskAward | number | 否 | 任务奖励分值 |
|
|
64
|
+
| data.tasks[].score | number | 否 | SDK 兼容字段,值取 taskAward |
|
|
65
|
+
| data.tasks[].maxCompleteNum | number | 否 | 新版任务目标次数 |
|
|
66
|
+
| data.tasks[].currCompleteNum | number | 否 | 当前已完成次数 |
|
|
67
|
+
|
|
68
|
+
# Examples
|
|
69
|
+
|
|
70
|
+
```javascript
|
|
71
|
+
window.ShaperAI.request.activity.getVoteTaskList({ activityId: 123 }).then(res => { if (res.code === 200) console.log(res.data.taskProgressList); })
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
# Frontend Request Guard
|
|
75
|
+
|
|
76
|
+
| 策略 | 默认值 |
|
|
77
|
+
| --- | --- |
|
|
78
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
79
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
80
|
+
| 请求超时 | 8000ms |
|
|
81
|
+
| 单能力最大并发 | 不限制 |
|
|
82
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
83
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
84
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
85
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
86
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-activity-list-by-biz-keys
|
|
3
|
+
description: 批量获取球员、装备等业务对象的评分数据与打分明细,一次请求即可覆盖多个对象,方便活动页统一展示。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.activity.listByBizKeys(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 必须通过 window.ShaperAI.request.activity.listByBizKeys(params) 接口,严禁直接拼凑网络接口 URL
|
|
13
|
+
- bizKeys 必须为非空数组
|
|
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
|
+
|
|
19
|
+
# Parameters
|
|
20
|
+
|
|
21
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
22
|
+
| --- | --- | --- | --- |
|
|
23
|
+
| bizKeys | array | 是 | 待查询的业务对象列表。数组内每个对象需包含 outBizType(请求侧业务分类,常用:nbaPlayer、cbaPlayer、equipment、games、movie、food、school;返回 data[].bizType 为更细粒度类型,如 movie_movie、movie_role)和 outBizNo(业务对象 ID) |
|
|
24
|
+
| querySubItemLimit | number | 否 | 子项查询限制数,默认为 1 |
|
|
25
|
+
| queryHasLight | boolean | 否 | 是否查询亮评,默认为 false |
|
|
26
|
+
|
|
27
|
+
# Returns
|
|
28
|
+
|
|
29
|
+
- Type: `Promise<Response>`
|
|
30
|
+
|
|
31
|
+
### Response Properties
|
|
32
|
+
|
|
33
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
34
|
+
| --- | --- | --- | --- |
|
|
35
|
+
| code | number | 否 | 状态码,1 表示成功 |
|
|
36
|
+
| type | string | 否 | 返回类型,如 COMMON |
|
|
37
|
+
| msg | string | 否 | 提示信息,如“成功” |
|
|
38
|
+
| success | boolean | 否 | 是否成功 |
|
|
39
|
+
| data | array | 否 | 评分项列表,每个元素对应一个查询的业务对象 |
|
|
40
|
+
| data[].bizType | string | 否 | 业务类型,如 movie_movie、movie_role |
|
|
41
|
+
| data[].bizId | string | 否 | 业务对象ID |
|
|
42
|
+
| data[].name | string | 否 | 评分对象名称 |
|
|
43
|
+
| data[].pic | string | 否 | 封面图片 URL |
|
|
44
|
+
| data[].coverStyle | string | 否 | 封面样式,如 rectangle(矩形) |
|
|
45
|
+
| data[].desc | string | 否 | 描述文案,如上映日期、角色饰演信息 |
|
|
46
|
+
| data[].behave | string / null | 否 | 行为标识,可能为 null |
|
|
47
|
+
| data[].score | number | 否 | 平均评分 |
|
|
48
|
+
| data[].canScore | boolean | 否 | 当前是否可评分 |
|
|
49
|
+
| data[].showScore | boolean | 否 | 是否展示评分 |
|
|
50
|
+
| data[].scoreCountThreshold | number | 否 | 评分展示所需的最少评分人数阈值 |
|
|
51
|
+
| data[].scoreValueHighlight | boolean | 否 | 评分值是否高亮展示 |
|
|
52
|
+
| data[].scoreColorDay | string | 否 | 评分日间模式颜色(十六进制) |
|
|
53
|
+
| data[].scoreColorNight | string | 否 | 评分夜间模式颜色(十六进制) |
|
|
54
|
+
| data[].scorePersonCount | number | 否 | 评分人数 |
|
|
55
|
+
| data[].scoreCount | number | 否 | 评分次数 |
|
|
56
|
+
| data[].comment | object / null | 否 | 该评分项的热评,可能为 null |
|
|
57
|
+
| data[].comment.subjectId | string | 否 | 评论所属主题ID |
|
|
58
|
+
| data[].comment.commentId | string | 否 | 评论ID |
|
|
59
|
+
| data[].comment.commentContent | string | 否 | 评论原始文本内容 |
|
|
60
|
+
| data[].comment.processCommentContent | string | 否 | 处理后的评论展示文本(含 [图片] 等占位标记) |
|
|
61
|
+
| data[].comment.ancillaryContents | array | 否 | 评论附属内容列表(图片/音频等),可能为空数组 |
|
|
62
|
+
| data[].comment.ancillaryContents[].commentContentId | string | 否 | 附属内容ID |
|
|
63
|
+
| data[].comment.ancillaryContents[].commentContent | string | 否 | 附属内容值,如图片 URL |
|
|
64
|
+
| data[].comment.ancillaryContents[].commentContentType | string | 否 | 附属内容类型,如 IMAGE、AUDIO |
|
|
65
|
+
| data[].comment.ancillaryContents[].durationInSec | number / null | 否 | 时长(秒),仅音频类型有值,否则为 null |
|
|
66
|
+
| data[].comment.contentColorDay | string | 否 | 评论文本日间模式颜色(十六进制) |
|
|
67
|
+
| data[].comment.contentColorNight | string | 否 | 评论文本夜间模式颜色(十六进制) |
|
|
68
|
+
| data[].comment.lightCount | number | 否 | 评论点亮(点赞)数 |
|
|
69
|
+
| data[].comment.userId | number | 否 | 评论用户ID |
|
|
70
|
+
| data[].comment.username | string | 否 | 评论用户名(可能为空字符串) |
|
|
71
|
+
| data[].comment.hasLight | boolean | 否 | 当前用户是否已点亮该评论 |
|
|
72
|
+
| data[].schema | string | 否 | 跳转到评分详情的 schema 链接 |
|
|
73
|
+
| data[].hexColor | string | 否 | 主题背景色(十六进制) |
|
|
74
|
+
| data[].maskColor | string | 否 | 蒙层颜色(含透明度的十六进制) |
|
|
75
|
+
| data[].commentCount | number | 否 | 评论数 |
|
|
76
|
+
| data[].summedCommentCount | number | 否 | 累计评论数(含子项) |
|
|
77
|
+
| data[].itemId | number | 否 | 评分项ID |
|
|
78
|
+
| data[].resourceMark | string / null | 否 | 资源标记,可能为 null |
|
|
79
|
+
| data[].resourceDetail | object / null | 否 | 资源详情,可能为 null |
|
|
80
|
+
| data[].allowAudio | boolean | 否 | 是否允许音频评论 |
|
|
81
|
+
| data[].playNum | number / null | 否 | 播放数,可能为 null |
|
|
82
|
+
| data[].scoreItemSupplementUrl | string / null | 否 | 评分项补充/编辑链接,可能为 null |
|
|
83
|
+
| data[].creatorId | number / null | 否 | 创建者ID,可能为 null |
|
|
84
|
+
| data[].creatorName | string / null | 否 | 创建者名称,可能为 null |
|
|
85
|
+
| data[].creatorAvatar | string / null | 否 | 创建者头像 URL,可能为 null |
|
|
86
|
+
| data[].subItems | array / null | 否 | 子评分项列表;无子项时为 null。子项结构与父项相同,可继续嵌套(schema 仅展开一层) |
|
|
87
|
+
| data[].subItems[].bizType | string | 否 | 业务类型,如 movie_movie、movie_role |
|
|
88
|
+
| data[].subItems[].bizId | string | 否 | 业务对象ID |
|
|
89
|
+
| data[].subItems[].name | string | 否 | 评分对象名称 |
|
|
90
|
+
| data[].subItems[].pic | string | 否 | 封面图片 URL |
|
|
91
|
+
| data[].subItems[].coverStyle | string | 否 | 封面样式,如 rectangle(矩形) |
|
|
92
|
+
| data[].subItems[].desc | string | 否 | 描述文案,如上映日期、角色饰演信息 |
|
|
93
|
+
| data[].subItems[].behave | string / null | 否 | 行为标识,可能为 null |
|
|
94
|
+
| data[].subItems[].score | number | 否 | 平均评分 |
|
|
95
|
+
| data[].subItems[].canScore | boolean | 否 | 当前是否可评分 |
|
|
96
|
+
| data[].subItems[].showScore | boolean | 否 | 是否展示评分 |
|
|
97
|
+
| data[].subItems[].scoreCountThreshold | number | 否 | 评分展示所需的最少评分人数阈值 |
|
|
98
|
+
| data[].subItems[].scoreValueHighlight | boolean | 否 | 评分值是否高亮展示 |
|
|
99
|
+
| data[].subItems[].scoreColorDay | string | 否 | 评分日间模式颜色(十六进制) |
|
|
100
|
+
| data[].subItems[].scoreColorNight | string | 否 | 评分夜间模式颜色(十六进制) |
|
|
101
|
+
| data[].subItems[].scorePersonCount | number | 否 | 评分人数 |
|
|
102
|
+
| data[].subItems[].scoreCount | number | 否 | 评分次数 |
|
|
103
|
+
| data[].subItems[].comment | object / null | 否 | 该评分项的热评,可能为 null |
|
|
104
|
+
| data[].subItems[].comment.subjectId | string | 否 | 评论所属主题ID |
|
|
105
|
+
| data[].subItems[].comment.commentId | string | 否 | 评论ID |
|
|
106
|
+
| data[].subItems[].comment.commentContent | string | 否 | 评论原始文本内容 |
|
|
107
|
+
| data[].subItems[].comment.processCommentContent | string | 否 | 处理后的评论展示文本(含 [图片] 等占位标记) |
|
|
108
|
+
| data[].subItems[].comment.ancillaryContents | array | 否 | 评论附属内容列表(图片/音频等),可能为空数组 |
|
|
109
|
+
| data[].subItems[].comment.ancillaryContents[].commentContentId | string | 否 | 附属内容ID |
|
|
110
|
+
| data[].subItems[].comment.ancillaryContents[].commentContent | string | 否 | 附属内容值,如图片 URL |
|
|
111
|
+
| data[].subItems[].comment.ancillaryContents[].commentContentType | string | 否 | 附属内容类型,如 IMAGE、AUDIO |
|
|
112
|
+
| data[].subItems[].comment.ancillaryContents[].durationInSec | number / null | 否 | 时长(秒),仅音频类型有值,否则为 null |
|
|
113
|
+
| data[].subItems[].comment.contentColorDay | string | 否 | 评论文本日间模式颜色(十六进制) |
|
|
114
|
+
| data[].subItems[].comment.contentColorNight | string | 否 | 评论文本夜间模式颜色(十六进制) |
|
|
115
|
+
| data[].subItems[].comment.lightCount | number | 否 | 评论点亮(点赞)数 |
|
|
116
|
+
| data[].subItems[].comment.userId | number | 否 | 评论用户ID |
|
|
117
|
+
| data[].subItems[].comment.username | string | 否 | 评论用户名(可能为空字符串) |
|
|
118
|
+
| data[].subItems[].comment.hasLight | boolean | 否 | 当前用户是否已点亮该评论 |
|
|
119
|
+
| data[].subItems[].schema | string | 否 | 跳转到评分详情的 schema 链接 |
|
|
120
|
+
| data[].subItems[].hexColor | string | 否 | 主题背景色(十六进制) |
|
|
121
|
+
| data[].subItems[].maskColor | string | 否 | 蒙层颜色(含透明度的十六进制) |
|
|
122
|
+
| data[].subItems[].commentCount | number | 否 | 评论数 |
|
|
123
|
+
| data[].subItems[].summedCommentCount | number | 否 | 累计评论数(含子项) |
|
|
124
|
+
| data[].subItems[].itemId | number | 否 | 评分项ID |
|
|
125
|
+
| data[].subItems[].resourceMark | string / null | 否 | 资源标记,可能为 null |
|
|
126
|
+
| data[].subItems[].resourceDetail | object / null | 否 | 资源详情,可能为 null |
|
|
127
|
+
| data[].subItems[].allowAudio | boolean | 否 | 是否允许音频评论 |
|
|
128
|
+
| data[].subItems[].playNum | number / null | 否 | 播放数,可能为 null |
|
|
129
|
+
| data[].subItems[].scoreItemSupplementUrl | string / null | 否 | 评分项补充/编辑链接,可能为 null |
|
|
130
|
+
| data[].subItems[].creatorId | number / null | 否 | 创建者ID,可能为 null |
|
|
131
|
+
| data[].subItems[].creatorName | string / null | 否 | 创建者名称,可能为 null |
|
|
132
|
+
| data[].subItems[].creatorAvatar | string / null | 否 | 创建者头像 URL,可能为 null |
|
|
133
|
+
| data[].subItems[].subItems | array / null | 否 | 更深层子评分项列表,结构同父项,可继续嵌套;无子项时为 null |
|
|
134
|
+
|
|
135
|
+
# Examples
|
|
136
|
+
|
|
137
|
+
```javascript
|
|
138
|
+
window.ShaperAI.request.activity.listByBizKeys({ bizKeys: [{ outBizType: "nbaPlayer", outBizNo: "12345" }] })
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
# Frontend Request Guard
|
|
142
|
+
|
|
143
|
+
| 策略 | 默认值 |
|
|
144
|
+
| --- | --- |
|
|
145
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
146
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
147
|
+
| 请求超时 | 8000ms |
|
|
148
|
+
| 单能力最大并发 | 不限制 |
|
|
149
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
150
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
151
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
152
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
153
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-activity-report-vote-task
|
|
3
|
+
description: 在发帖、回帖或评分等活动行为成功后上报投票任务完成,触发服务端发放活动奖励。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.activity.reportVoteTask(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 只能在用户明确完成对应活动行为后调用,禁止页面加载时调用、自动重试或伪造完成状态
|
|
13
|
+
- taskId 和 taskCode 必须来自活动配置或业务数据,不能臆造
|
|
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
|
+
| taskId | string | 是 | 活动配置提供的任务 ID |
|
|
25
|
+
| taskCode | string | 是 | 活动配置提供的任务行为编码 |
|
|
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.reported | boolean | 否 | 是否已成功上报任务完成 |
|
|
39
|
+
|
|
40
|
+
# Examples
|
|
41
|
+
|
|
42
|
+
```javascript
|
|
43
|
+
window.ShaperAI.request.activity.reportVoteTask({ taskId, taskCode }).then(res => { if (res.code !== 200) console.warn(res.message); })
|
|
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 页 |
|