1.1 公会产品文档

1.1 公会产品需求

最新确认（2026-09-28，D69）：首页推荐公会由固定5个调整为允许展示至10个，以兼容旧接口返回10个；发现页默认10个、TOP200及每卡前5个网站Logo规则不变。

2026-09-26当前修订（D60，优先于本节对应旧描述）：1.1所有用户统一进入指定公会，个人邀请码只建立邀请关系，不决定公会归属；当前默认自动审核入会，手动公会码提交统一错误继续保留。官方示范公会页筛选和搜索继承此前版本业务及UI，取代该页仅图片静态展示的业务目标；旧版具体来源待定位，现有原型未改。首页Banner内容和点击事件可按运营诉求调整。此前个人码优先、公会审核分支及静态国家页描述留作历史，详见末尾D60。

更新日期：2026-09-23。业务版本：1.1。状态：已确认规则汇总，含待明确事项；不代表原型或生产实现完成。

1. 范围与版本边界

D56后续确认（2026-09-24）：游客点击加入公会需引导注册登录，替代现有静态原型对游客直接打开邀请码弹窗的交互预期。原型尚未同步，登录完成后是否直接续接申请细节待设计。

公会是1.1核心业务之一，仅在VIB AI用户端展示。2026-09-23用户确认（D28）：公会页面合并到首页，不再单设底部公会入口；底部导航按顺序仅保留“首页、邀请、我的”三个按钮。首页承载公会内容及全部公会、详情与入会流程入口。1.1将公会归属及相关业务呈现给用户；页面布局、具体字段及正式交互文案尚未设计。

MVP默认分会为用户说明的现状，未核验生产实现；MVP既有用户向1.1迁移的归属规则待明确。

2. 入会方式

当前版本执行范围（2026-09-23，D38）：注册后默认进入指定公会；公会邀请码输入不执行入会，提交一律提示“邀请码错误”。以下手动码入会成功及审核分支为此前规则，当前版本不执行；个人邀请默认归属优先级等未被本次取消。

个人邀请和落地页路径不额外要求手填公会邀请码。“自动入会”不代表可以绕过审核。APK为用户提供的入会来源描述，不据此推导原生实现方案。

3. 来源优先级与已入会边界

• 个人邀请码权重最高。游客注册时与指定公会冲突，或未入会用户与落地页公会冲突，均以个人邀请者的公会为目标公会。注册应先确定目标公会，不能先绑定指定公会再将本次邀请码当作已入会后补填。
• 已入会用户补填个人邀请码时，只建立邀请关系，保留原公会；即使邀请者属于另一个公会，也不触发换会或新的入会流程。
• 当前1.1不支持用户退出或更换公会。个人邀请码最高优先级不能覆盖已有公会归属。
• 多个不同个人邀请码或多个落地页来源之间的归属规则、邀请者尚未入会时的处理待明确。

4. 入会审核

D38当前版本补充：公会码提交统一错误，不触发下述手动入会审核／直接加入分支。保留旧规则供追溯，不从静态页面确认生产实现。

管理后台按公会配置“入会审核”开关。原有三种入会方式（公会码、个人邀请、落地页）统一执行目标公会的设置。D30新增游客注册默认归属路径是否适用审核尚待明确；本次无需公会邀请码不改变原有个人邀请路径的审核规则。

手动加入需输入正确的公会邀请码。审核开启时，个人邀请及落地页路径也需等待审核。审核人、审核操作入口、拒绝及重新申请流程、待审核期间权限尚未明确。

5. 公会邀请码

公会邀请码仅可在管理后台获取和修改，不在用户端公会列表或详情公开提供。用户侧可以输入获得的公会邀请码申请加入；邀请码如何由管理人员分发给用户尚未规定。

公会邀请码与个人邀请码用途不同：公会码用于加入对应公会；个人码用于建立邀请关系，并在未入会时确定邀请者所在公会。个人码的“6位大写字母与数字组合、用户不可修改、永久有效”规则不自动套用于公会码。公会码格式及修改后旧码的有效性待明确。

6. 公会创建与后台配置

当前阶段公会只能由管理后台创建。未来考虑允许符合要求的用户申请创建公会，资格与流程尚未确定，不纳入本次已确认交付。

以上为业务能力要求，不代表后台界面已经完成；具体表单字段、排序操作方式及审核流程待设计或确认。

7. 游戏网站与信号权限

各公会支持的游戏网站可以不同，由后台公会管理配置。该配置同时约束用户可获取和使用信号的网站：用户只能在所属公会支持的网站获取、使用信号。

不同公会的网站集合不要求互斥。游客可查看其从属公会绑定的网站列表（D24），但D31已确认内嵌开关开启时游客可打开游戏并按游戏账号资格获取／使用新手信号，使用后限制游戏并引导登录VIB；其他游客信号权限不能由此推导。已登录未入会／待审核用户可见的网站及信号权限、网站配置调整后已有信号的处理仍待明确。

8. 公会列表与浏览

呈现约定（2026-09-22用户确认）：公会页面无需特意体现游客角色，不展示“游客浏览”等身份标签；未登录时自然展示当前公会及已确认可见内容。此约定仅调整呈现，不改变游客从属配置、登录后归属或操作权限边界。

未登录游客可正常访问首页中的公会内容，查看全部公会列表及从属公会绑定的网站列表（2026-09-22，D24）。游客默认从属的成员性质及登录后衔接见Q15。

已加入公会的用户仍可查看公会列表，列表排序由管理后台配置。可浏览其他公会不代表可以退出或更换当前公会。列表及详情的展示字段、查找方式与页面布局待后续设计。

8.1 公会政策入口与页面（2026-09-23，D29）

当前补充（2026-09-23，D43）：用户要求公会政策二级页先使用本轮新附件截图，已替代D34该页待补状态。当前素材为 prototype/v1/assets/guild-policy-current.png，按比例完整显示、可滚动阅读并返回首页；图内箭头与申请按钮仅作为图像展示，不新增交互或改变现行业务规则。旧素材及D29确认保留追溯。

用户确认：首页中的公会区域增加“公会政策”入口，点击进入公会政策页面；政策页先用本轮附件截图占位。原型入口放在公会介绍主视觉下方、当前公会卡片上方，四种评审身份均可进入，并可返回首页。入口位置为本轮设计实现。

截图保存为 prototype/v1/assets/guild-policy.png，仅作为临时展示素材；图片中的箭头和“立即申请创建公会”为静态图像，不开放申请流程。截图内L4创建公会、20%管理收益、5%孵化奖励和自治等描述不构成新增需求确认，不覆盖当前仅后台创建公会等规则。正式政策内容及后续交互待提供，画面外评审说明记录此边界。

8.2 首页网站展示与入会入口（2026-09-23，D33）

替代说明（D34）：网站Logo现仅展示、无点击事件；已入会用户也显示邀请码输入框。以下Logo直接开窗为历史，当前结构与入口见§8.3。

用户本轮确认以下五项原型调整：

1. 公会支持的网站列表项展示网站RTP数值。
2. “更多公会，更多发现”区域展示支持网站Logo，点击直接弹出对应公会的入会弹窗，输入公会邀请码。
3. 删除“选好公会，开启新体验”区域。
4. 删除“你可能想了解”区域。
5. 删除首页右上角感叹号／帮助图标。

原型所有身份均展示推荐公会网站Logo并可打开码输入弹窗；未入会状态沿用正确码后的需审核／直接加入分支。已入会不允许换会，待审核不重复申请，未登录提示先登录；这些状态的提交限制为沿用既有边界的保守实现，不据本次入口调整确认游客申请权限或新增换会规则。公会详情与全部列表入口、公会政策及三项底部导航保留。

正式Logo、RTP数值来源、统计口径及刷新周期待提供（Q18）。当前Logo采用本地临时字标，RTP为原型样例；不得据此认定真实网站回报率，说明放在画面外评审区。首页推荐区Logo可见与点击开窗由本次要求补充此前游客仅看列表的原型范围，其他公会网站访问与信号权限不随之开放。

8.3 按附件调整首页结构（2026-09-23，D34）

当前修订（2026-09-23，D35）：用户要求删除首页“创建公会，拓展你的网站”整张卡片及“了解创建条件”入口；底部仅保留公会分析网站说明、AI如何分析游戏两张说明卡片，独立公会政策入口保留。下文三张卡片及创建条件入口为D34历史，不再作为当前首页要求。

依据：用户提供黑白首页结构图，并逐项确认底部仍为首页／邀请／我的、继续显示RTP、按钮用“打开网站”、首页二级内容页均待补充、附件只确定结构、“官方示范公会”为正常公会名称、文字沿用当前。随后明确网站Logo不需要点击事件，“查看支持网站”进入公会二级介绍页、“探索更多公会”进入全部列表；已入会用户也显示邀请码输入框。

当前首页结构：顶部左文右图介绍；当前公会与支持网站合为一张卡片；更多公会采用横向滚动卡片，网站Logo仅展示；底部增加公会分析网站说明、AI如何分析游戏、创建公会条件三张内容入口卡片。沿用蓝绿视觉、当前介绍文案、RTP及“打开网站”，不采用附件“免费解析”、四项导航或AI浏览器绑定说明；不展示“公会示例”环境标签，官方示范公会作为正常名称。

首页二级内容页含公会介绍、全部列表、两类说明、创建条件和公会政策，正文均待补充；原型用正常产品未开放状态及返回入口，不自行新增政策与创建能力。既有政策截图保留为历史素材。

邀请码输入框对已入会用户同样显示；Logo不再作为入口。本轮暂在公会二级页保留独立“输入公会邀请码”按钮供流程评审，此位置是实现选择，二级页最终布局待补。显示输入框不等于允许换会，已有入会审核、不可退换会等规则保留；如果后续要求调整提交后的归属行为，需另行确认。正式Logo及RTP规格仍见Q18。

8.4 公会分析网站说明截图页（2026-09-23，D36）

用户确认：点击首页“公会分析网站说明”后进入本轮附件截图页面，直接使用原截图。素材保存于 prototype/v1/assets/guild-sites-info.png，按宽度完整显示、可滚动查看，并提供返回首页入口。此项替代D34该页面内容待补状态；其他二级页状态不变。

本轮授权为截图页面展示，截图内网站门槛与申请流程作为用户提供的页面内容呈现，不据此实现后台申请、资格校验、建模服务或更改公会创建权限。

8.5 AI分析说明截图页（2026-09-23，D37）

用户确认：“VIB AI 如何分析游戏？”点击后的二级页采用本轮附件原截图。素材为 prototype/v1/assets/guild-ai-info.png，完整按比例显示、可滚动查看，顶部提供返回首页入口。替代D34该页内容待补状态；其他二级页状态不变。截图内部“VIB AI 2.0”保留原样，不据此更改项目1.1业务版本命名；图片底部止于第二节标题，未提供的后续正文不自行补写。

8.6 静态公会目录与国家官方公会（2026-09-23，D38）

最新呈现修订（D39）：探索更多公会移除当前／我所在的公会区块；两层列表仍纵向排列公会卡片，卡片内网站改为紧凑Logo横排，数量多时横向滚动显示全部Logo，不再逐行显示名称与标签。两层列表均移除查看详情，申请加入置于卡片标题右侧；官方入口文案改为“查看官方示范公会”。此修订替代下文当前公会区块及逐行网站／列表详情入口描述，首页前五个Logo规则不变。

确认来源：用户对两张参考截图及四项设计问题的逐项批注。

• 本版本采用前端静态页面，不实现真实排名计算；TOP200限制与排名依据未进一步确认，不从截图推导。本轮使用“发现公会”展示样例列表。
• 注册后默认进入指定公会；输入邀请码不真正入会，提交时始终提示“邀请码错误”。适用于所有身份和入口，包括空码、任意码和旧原型正确码；不改变公会归属，不显示申请成功或加入成功。
• 当前不做名称搜索和国家筛选。独立“VIB 官方”仅为进入国家官方公会页的入口，不再作为国家列表中的单独公会。
• 首页横向推荐卡片内仅显示每个公会前五个支持网站Logo；网站Logo仍无点击。二级页公会卡片纵向排列，卡片内全部支持网站按行显示Logo和名称，不显示RTP；首页当前公会网站列表的RTP与标签保留。

本轮设计：探索更多公会页依次展示官方入口、当前公会、其他公会；国家页以单列卡片展示国家标识、公会名称及完整支持网站。两层卡片保留查看详情和申请加入按钮，申请打开邀请码弹窗，提交统一错误。详情暂复用公会与网站清单，最终更多详情待补。未登录当前公会不标成正式已加入。国家与网站映射均为静态样例，不定义正式运营配置；保留首页／邀请／我的导航及蓝绿风格。

变更前文档见 docs/history/2026-09-23-static-guild-directory/。原型已移除码正确后的加入／等待审核状态变更；历史未入会、待审核评审切换仅用于兼容状态测试，不说明当前可产生申请。

8.7 首页三张Banner轮播（2026-09-23，D40）

用户确认：首页Banner支持左右滑动，第二张采用本轮附件，第三张为教程视频占位图。第一张保留现有首页介绍；第二张原图保存为 prototype/v1/assets/home-banner-ai.png，完整显示不裁切；第三张使用页面内绘制的教程封面与播放图标，不虚构视频资源。

本轮交互设计：手动滑动与吸附切换，三枚指示点支持点击，支持鼠标拖动和左右方向键，不自动播放；教程视频未提供时点击提示“教程视频暂未开放”。边界说明放画面外评审区。附件内容仅作为本次Banner素材，不新增业务承诺。

8.8 原型身份与未登录体验入口（2026-09-23，D41）

用户要求原型取消未入会和审核中状态，评审只保留已入会、未登录。未登录首页支持网站的操作按钮改为“体验AI”，点击应进入游戏网站；已入会状态继续使用“打开网站”。此修改不要求用户先登录再点击。

最新用户确认（2026-09-23，D42）：原型中未登录“体验AI”和已入会“打开网站”点击均仅弹出Toast：“此处将跳转至游戏网站”，不执行导航。此规则替代D41接入游戏演示界面的行为；旧确认保留在后文追溯。既有静态列表及邀请码统一错误不变。

8.9 首页推荐与TOP100列表（2026-09-23，D44）

当前数量由2026-09-24 D58更新为TOP200，搜索数据同步扩展200条；本节100条为历史确认，其余适用规则见§8.20。

用户确认：首页“更多公会，更多发现”卡片删除“查看支持网站”按钮及后续详情页。卡片仅展示公会与支持网站信息，原先Logo无点击规则保留。

探索更多公会页的发现公会区域默认展示10条，底部增加“查看TOP100的公会”按钮，进入前100列表；前100页沿用紧凑公会卡片、网站Logo及申请加入，顶部返回探索更多公会。原型使用同一份100条静态数据，默认10条为其前10条，不接入真实排名计算。国家官方列表、首页每卡前五个Logo、邀请码统一错误不变。

此条替代D34以来保留的首页详情入口与后续页，以及D38未明确条数的列表呈现。静态名称与网站映射仅用于设计评审，不当作真实排名或运营数据。

8.10 首页五个推荐公会与加入入口（2026-09-23，D45）

用户确认：首页“更多公会，更多发现”横向列表展示5个公会，每张卡片增加“加入公会”按钮。5张卡片通过横向滑动浏览，不要求同屏展示。网站Logo仍仅展示，每卡最多前5个。

布局采用三列网站Logo，统一预留两行区域，公会卡片等高且加入按钮底部对齐，避免一行与两行网站造成跳动。点击加入按钮打开对应公会的邀请码输入框；已入会与未登录均可输入，提交继续统一提示“邀请码错误”，不改变归属。

本条补充D44的首页信息卡展示：保留删除“查看支持网站”及详情页的决定，新增独立加入入口。探索更多公会默认10条、TOP100静态列表及国家列表不变。

8.11 首页文案精简（2026-09-23，D46）

根据用户附件标注及逐项确认：首页删除“本公会支持的网站”后的数量标签；所有网站名称后的标签统一改为“已接入AI分析”；已入会与未登录的网站按钮均为“免费解析”；删除“更多公会，更多发现”下的“了解每个公会的不同之处”。按钮点击仍仅提示“此处将跳转至游戏网站”，不导航。

后续呈现补充：用户要求免费解析按钮体现“VIB”，且不影响按钮及主文字。最初采用按钮上沿小号VIB品牌标识；用户后续要求角标或更协调的样式，当前改为贴合右上角的浅绿色VIB角标。保持原按钮尺寸和“免费解析”主文案位置，点击反馈不变。

此条替代旧“支持 AI 分析”标签及按身份区分的“体验AI／打开网站”文案。保留RTP、五张推荐公会卡、加入按钮及两行网站区域对齐；不改变收费、信号权限或真实接入机制。

8.12 首页参考样式与入口调整（2026-09-23，D47）

来源：用户本轮五项首页调整及附件1网站卡片、附件2政策入口样式。适用于1.1首页原型。

• 更多公会卡片的网站Logo仅一行：实现为前2个Logo，加“+N”表示剩余支持网站数量（按当前数据计算）；仍展示5个公会，卡片等高、加入按钮对齐。替代D45／D46的两行Logo区域。
• “VIB AI 如何分析游戏？”入口移到“更多公会，更多发现”模块之前。
• “公会分析网站说明”移至第一张介绍Banner内；保留三张手动轮播与原二级页。
• “本公会支持的网站”改为附件1风格的深色圆角大卡片：上部Logo／名称／分析标签、中部放大RTP、底部全宽青绿渐变按钮。沿用已有网站与RTP样例、已接入AI分析标签、“免费解析”及VIB角标。附件仅作为样式参考，未提供当前网站网址、用户规模、运营年限及关联状态映射，不添加这些数据或推荐背书。
• 公会政策入口改为附件2风格的深色容器、蓝色图标、三块权益介绍（公会收益／增加支持网站／指定网站专属建模）、底部“了解更多”按钮；进入原政策截图页。未将附件20%等文字确认为新业务规则，介绍使用引导阅读文案。

本次大卡片替代此前首页高度压缩呈现，不再保证首屏露出发现区域。网站按钮Toast、邀请码统一错误、两身份及三项导航不变；仅样式与入口调整，生产未核验。

8.13 国家官方公会列表精简（2026-09-23，D48）

用户确认：国家官方公会列表不需要显示支持的网站Logo。当前列表移除网站Logo区域，保留国家标识、公会名称、国家及申请加入按钮；说明文案同步为“了解各国家的官方示范公会”。只替代D39国家列表的网站展示，普通公会目录、TOP100及首页网站展示不变；后台网站配置和邀请码统一错误规则不变。

8.14 发现公会与TOP100显示国家（2026-09-23，D49）

后续呈现确认（2026-09-23）：用户截图标注删除卡片右侧支持网站数量，发现列表及TOP100统一移除“6 个／3 个”等计数，仅保留“支持网站”标题与Logo；国家、申请及搜索不变。

用户确认：“发现公会”列表及“查看TOP100”中的每个公会均需显示国家名称。在公会名称下方显示国家，替代原通用介绍副文案；保留网站Logo与申请加入。两页使用同一份公会数据的country字段，发现页10项与TOP100前10项一致。

当前为静态原型，未提供普通公会真实国家映射；暂按现有七国循环配置样例国家，仅用于展示与交互评审，并在画面外标注。正式归属数据待补，不能从样例推导业务事实。国家官方列表仍不显示网站Logo，首页卡片与邀请码规则不变。

8.15 国家示范公会截图页（2026-09-23，D50）

用户确认：国家示范公会页面直接使用本轮附件截图。素材保存为 prototype/v1/assets/guild-countries.png，按页面宽度完整等比展示，支持滚动，顶部返回探索更多公会。替代D48及此前国家列表的可交互卡片实现。

截图内申请加入、查看详情、已开放及巴西“当前所在”均为图片内容，不执行操作、不代表当前用户实际归属，也不新增业务规则。发现公会／TOP100的国家名称、支持网站与申请入口不变。附件只用于该页面，原图不改写。

8.16 发现公会搜索栏（2026-09-23，D51）

当前搜索范围更新（2026-09-24，D58）：检索200条静态公会，清空仍恢复前10条；下文100条为原实现记录。

用户确认：“发现公会”需要搜索栏。替代D38该区域不提供搜索的范围限制。

本轮原型实现选择：搜索栏置于发现公会标题与列表之间，支持按公会名称或国家进行包含匹配、实时过滤当前100条静态公会，忽略首尾空格与英文大小写；无输入时沿用默认10条。显示结果数量，未匹配显示“未找到相关公会／试试其他公会名称或国家”；清空按钮恢复10条并保持输入焦点。搜索结果保留国家、网站Logo及申请加入；提交邀请码仍统一错误。搜索只更新结果区域，不重绘输入框；离开页面再次进入时恢复默认状态。

上述匹配字段与范围为本轮可交互原型的实现选择，不代表生产搜索接口规格已确认。TOP100和国家截图页不新增搜索栏，静态数据及真实国家归属待补的边界不变。

8.17 支持网站卡片按附件复刻（2026-09-23，D52）

用户纠正：D47实现未按截图，要求重新查看并尽可能复刻本轮附件。适用于首页“本公会支持的网站”区域，替代D47仅保留简化字段的处理，以及D46免费解析、AI标签、VIB角标的当前呈现。其他模块不变。

复刻深灰卡片、圆角边框、右上金色角标、左Logo右名称／URL／状态、三列指标和全宽青绿渐变按钮；按钮文案采用“立即下载，开始游戏 →”。Logo直接从保存的原附件通过SVG视口显示对应区域，原图未改写。素材为 prototype/v1/assets/home-sites-reference.png。

以上为用户要求复刻的截图展示样例，在产品画面外注明，不代表实际网址可用、用户关联、推荐背书或实时运营数据。按钮保留D42的Toast“此处将跳转至游戏网站”，不下载、不导航；两身份同样展示，不据截图变更认证或业务规则。其他公会仍沿用原静态目录，不将此附件映射扩展至全部公会。

8.18 网站按钮按登录与体验开关区分（2026-09-23，D53）

用户确认：首页支持网站按钮区分以下状态。开关对应D31“VIB内体验游戏网站”，默认关闭沿用D32。

替代D52两身份统一下载按钮文案，三个网站均适用，可访问名称同步。原型已登录沿用已入会身份数据；产品画面外增加评审开关（默认关闭），即时切换文案。该控件不是用户端设置，也不代表后台配置或重启生效链路已实现。按钮点击继续D42既有Toast，不据本轮文字变更新增下载或导航；网站卡片其他字段不变。

8.19 当前公会行增加探索入口（2026-09-24，D54）

用户根据截图标注确认：首页当前／我的公会信息行右侧增加“探索公会”按钮，点击进入国家公会列表页面。两种评审身份均显示；目标复用D50国家示范公会原图页，不另建列表。

返回按入口来源处理：首页进入则返回首页，原探索更多公会入口进入则返回原列表。当前国家页仍为静态截图，图内按钮不新增操作。保留原“探索更多公会”及列表内官方公会入口，其他按钮文案与开关规则不变。

8.20 TOP200公会与搜索扩容（2026-09-24，D58）

用户确认：查看TOP100的公会改为查看TOP200，数量增加，同步修改方案和原型。

• 发现公会底部入口改为“查看TOP200的公会”，目标页标题“TOP200公会”，展示200条公会卡片；辅助说明与可访问名称同步。
• 原型同源静态公会数据从100条扩为200条，原前100条名称、顺序、国家及网站映射保持，新增100条名称唯一的样例。国家归属与网站仍为评审配置，不代表真实运营排名。
• 发现公会默认仍展示前10条，首页推荐仍5条；搜索按名称／国家覆盖全部200条，清空恢复10条。TOP200前10条与发现默认列表一致。
• 每张卡保留国家名称、支持网站Logo及申请加入，不显示网站数量。国家公会原图页与原返回行为保留。
• 本条替代D44／D49／D51等在数量及TOP100名称上的旧描述，其余业务规则不因扩容改变。D56游客申请需登录仍为已确认但未同步原型的独立事项；本轮不以旧邀请码错误行为替代该需求。

9. 待明确事项

10. 确认依据与交付状态

依据2026-09-21用户公会概述、五项逐条确认、审核开关及全部入会路径确认整理，对应D16—D19；2026-09-22用户七项用户体系补充新增游客浏览及后台从属公会配置（D24）。原始记录保留在本文后文。仅整理产品需求，不新增业务规则；尚未制作公会交互原型、实现后台能力或核验生产服务。