@@ -783,6 +823,32 @@
description: "适合 DeepSeek 官方 chat 路线需求。当前用户侧建议直接使用 deepseek-chat。"
}
};
+ const MODEL_GUIDANCE = {
+ "kimi-k2.6": {
+ scenario: "适合日常聊天、长上下文问答和轻量智能体使用。",
+ recommendation: "默认先从这条模型线开始验证接入是否通畅。"
+ },
+ "gpt-5.4": {
+ scenario: "适合高质量推理、复杂编排、代码辅助和更稳的通用对话。",
+ recommendation: "如果你已经开通对应权限，优先用它做主模型。"
+ },
+ "gpt-5.4-mini": {
+ scenario: "适合低成本试跑、轻量自动化和更高频的小请求。",
+ recommendation: "更适合作为低成本补充线路或快速压测模型。"
+ },
+ "MiniMax-M2.5-highspeed": {
+ scenario: "适合对速度敏感的 MiniMax 使用场景。",
+ recommendation: "优先做高速场景和批量调用验证。"
+ },
+ "MiniMax-M2.7-highspeed": {
+ scenario: "适合需要更强能力、同时仍关注速度的 MiniMax 场景。",
+ recommendation: "适合和 M2.5 做效果与时延对照。"
+ },
+ "deepseek-chat": {
+ scenario: "适合通用 DeepSeek Chat 入口与官方兼容场景。",
+ recommendation: "建议直接按公开模型名调用，不需要额外记宿主细节。"
+ }
+ };
const state = {
accessToken: "",
@@ -1183,6 +1249,74 @@
}).join("");
}
+ function buildGuideEntries() {
+ return logicalGroupEntitlementRows().map((row) => {
+ const group = row.logicalGroup;
+ const models = portalLogicalGroupModels(group);
+ const primaryModel = models[0] || "";
+ const guidance = MODEL_GUIDANCE[primaryModel] || {
+ scenario: "适合按该逻辑分组下的公开模型集合统一接入。",
+ recommendation: "建议先用列表中的第一个公开模型做连通性验证。"
+ };
+ const nextStep = row.stateKey === "active"
+ ? "当前已具备订阅与权限，建议直接创建测试 Key 并使用推荐模型发起第一次请求。"
+ : row.stateKey === "granted"
+ ? "当前已具备线路权限，但未发现活跃订阅；建议先确认订阅状态后再发起调用。"
+ : row.stateKey === "pending"
+ ? "当前目录已公开，但你还没有对应兼容线路；建议联系管理员补开通后再申请 Key。"
+ : row.stateKey === "ambiguous"
+ ? "当前逻辑分组命中多条兼容线路；建议等待管理员整理归属，避免申请到不确定线路。"
+ : "当前可先浏览模型目录与接入建议，待管理员发布兼容线路后再申请测试 Key。";
+ const compatibility = (row.candidates || []).map((candidate) => candidate.title).join(" / ") || "尚未建立兼容线路";
+ return {
+ title: group.display_name || group.logical_group_id || "未命名逻辑分组",
+ logicalGroupID: group.logical_group_id || "",
+ models,
+ stateText: row.stateText,
+ stateKey: row.stateKey,
+ scenario: guidance.scenario,
+ recommendation: guidance.recommendation,
+ nextStep,
+ compatibility,
+ stickyMode: group.sticky_mode || "conversation_preferred",
+ routePolicy: group.route_policy || "priority"
+ };
+ });
+ }
+
+ function renderUsageGuides() {
+ const grid = $("guide-grid");
+ const guides = buildGuideEntries();
+ if (!guides.length) {
+ grid.innerHTML = '
当前还没有可展示的逻辑分组使用建议。
';
+ return;
+ }
+ grid.innerHTML = guides.map((guide) => {
+ const badgeClass = guide.stateKey === "active"
+ ? "active"
+ : guide.stateKey === "granted"
+ ? "neutral"
+ : "pending";
+ return (
+ '
' +
+ '' +
+ '' + escapeHTML(guide.stateText) + '' +
+ '' + escapeHTML(guide.logicalGroupID) + '' +
+ '
' +
+ '' + escapeHTML(guide.title) + '
' +
+ '' + escapeHTML(guide.scenario) + '
' +
+ '' +
+ '
推荐模型：' + escapeHTML(guide.models.join(", ") || "--") + '
' +
+ '
接入建议：' + escapeHTML(guide.recommendation) + '
' +
+ '
下一步：' + escapeHTML(guide.nextStep) + '
' +
+ '
兼容线路：' + escapeHTML(guide.compatibility) + '
' +
+ '
路由策略：' + escapeHTML(guide.routePolicy) + ' / ' + escapeHTML(guide.stickyMode) + '
' +
+ '
'
+ );
+ }).join("");
+ }
+
function getPresentationStatus(row) {
if ((row.enabledCandidates || []).length === 1) {
return { cls: "active", text: "可立即申请兼容 Key" };
@@ -1369,6 +1503,7 @@
renderSessionSummary();
renderGroupCatalog();
renderEntitlementView();
+ renderUsageGuides();
renderKeys();
}
diff --git a/scripts/test/test_tksea_portal_assets.sh b/scripts/test/test_tksea_portal_assets.sh
index 6ee011dd..cff6df84 100755
--- a/scripts/test/test_tksea_portal_assets.sh
+++ b/scripts/test/test_tksea_portal_assets.sh
@@ -62,6 +62,14 @@ assert_contains_file "$HTML_FILE" "portalLogicalGroups"
assert_contains_file "$HTML_FILE" "LEGACY_GROUP_CATALOG"
assert_contains_file "$HTML_FILE" "逻辑分组权限"
assert_contains_file "$HTML_FILE" "renderEntitlementView"
+assert_contains_file "$HTML_FILE" "使用建议与可用模型说明"
+assert_contains_file "$HTML_FILE" "MODEL_GUIDANCE"
+assert_contains_file "$HTML_FILE" "buildGuideEntries"
+assert_contains_file "$HTML_FILE" "renderUsageGuides"
+assert_contains_file "$HTML_FILE" "推荐模型"
+assert_contains_file "$HTML_FILE" "接入建议"
+assert_contains_file "$HTML_FILE" "下一步"
+assert_contains_file "$HTML_FILE" "路由策略"
assert_contains_file "$HTML_FILE" "已开通订阅"
assert_contains_file "$HTML_FILE" "已授予权限"
assert_contains_file "$HTML_FILE" "归属待整理"