从素材瀑布流到独立指导文档网络

研究状态（2026-10-29）

已阅读 Karpathy LLM Wiki 原始提案，检查用户提供的 Hugging Face Qwen 页面与 GitHub Chromium 页面。已通过 Chrome 逐项截取核心页面与状态，具体记录见下文。截图显示在主 chat 工具结果中，未导出为仓库图片；未覆盖整个网站，发布编辑器受实名限制。

已采集：首页首屏与下半屏、目录筛选布局、技能详情全部五个标签、企业作者页、登录弹窗、发布访问限制。移动视图尚未采集，已验证分类筛选和搜索空结果，其他筛选组合尚未完整遍历；无法访问的页面明确注明限制，不冒充已检查。

Hugging Face 可借鉴：owner/name 身份、标签、概览与文件/社区分栏、主内容加元数据侧栏。GitHub 可借鉴：稳定地址、版本历史、README 阅读层级、文件和讨论分离。这里应把“单篇文档”放在中心，集合只是可选组织方式；不复制仓库文件树为强制入口。

页面与组件

页面	首版行为	核心组件
/	搜索、种类筛选、文档目录	顶栏、搜索框、分类导航、文档行、说明侧栏
/guide/:id	独立阅读、条件链接、反向链接、XML	面包屑、版本标记、正文、步骤、采用提示、关联文档
/protocol	展示 0.1 约定与使用边界	语法示例、读取流程、协议状态
/account	注册、验证邮箱、登录、退出	表单、错误反馈、会话状态
作者与集合	后续真实用户内容组织	作者简介、非强制集合、收藏
/write、/documents/:id	持久化发布、作者更新、固定版本阅读与撤下	结构化/XML 编辑器、校验、预览、版本导航；差异比较后续实现

第一阶段提供真实可读样例和单篇机器接口。账户系统独立 PR；内容创作、收藏、讨论不可用静态按钮冒充完成。后续将原素材中的适用指导迁移为独立文档，保留原始来源，迁移前不删除。

技术与验收

沿用 Next.js Pages Router、TypeScript、现有 PostgreSQL、Tailwind 基础；旧首页保存到 src/legacy/WaterfallHome.tsx，原组件保留。新 UI 使用独立 CSS Module，避免影响原素材和 Studio 页面。认证保留管理员动态码，邮箱用户具有独立身份，不能获得现有管理员写权限。

构建只在用户确认的 ces-control；页面验收只访问 http://8.211.154.134:18131/。远程 CI、部署、浏览器验证分别记录结果。所有 PR 均由用户手动合并，主 chat 不执行 merge 或自动合并；不把 PR 创建视为部署成功。

已观察的 SkillHub 页面

/：白底黑字、宽屏顶栏、大面积留白、巨大居中标题、复制给 AI 安装条；下方轮播服务卡、近期飙升/下载榜、插件、个人企业发布与商业服务。营销与发现混合。
/skills?sortBy=trending：标题与总数，排序标签、来源/场景/API Key 三个筛选、搜索框、列表/卡片切换。列表以图标、名称、认证、分类、截断摘要、收藏和下载统计组成，细灰边框和分隔线。
/skills/zcwl/multi-search-engine：面包屑、图标与名称、命名空间、AI 评分、安全、作者、摘要与标签；概述/文件/评论/版本历史/评测报告五个标签。正文占宽约三分之二，右栏为安装提示词、ZIP、Agent 安装与元数据。
文件标签：观察到 references、scripts 文件夹和 SKILL.md、共 4 文件；侧栏有 token 预估、下载收藏、作者、安全报告、内容指纹、数字签名与相关推荐。文件树仍将整个包作为单位。

本项目取舍：保留清晰命名空间、列表可扫描性、阅读与源文档切换；将安装栏改为“采用单篇”，将包文件树改为条件链接和反向引用。暂不复制评分、下载热度、认证徽章，避免没有真实数据的信任暗示。当前暖绿原型是独立视觉探索，需完成参考截图与服务器验收后修订。

第二轮截图补充

已在主 chat 逐项截取：文件树与安装侧栏、元数据与签名侧栏、版本历史、手机号登录弹窗、企业作者页、发布访问限制。截图为 Chrome 原生窗口实拍，包含浏览器框；暂未存为仓库图片文件。

版本历史为时间线，显示当前版本标记、日期、说明、展开/下载控件；安装右栏在不同标签间保持一致。登录弹窗区分个人/团队，个人有微信和手机号模式，手机号模式包含验证码输入、协议勾选、主按钮；没有执行登录或同意协议。作者页包含头像/名称/认证/简介、关注、横向统计条、左侧排序分类、右侧搜索与作品目录。发布入口 /dashboard/publish 匿名访问明确显示“需要登录才能访问”，无法检查其内部编辑器，不假定内部布局。

待补：详情评论和评测标签、首页下半屏的独立截图、移动端；插件、付费服务、大赛作为非核心周边功能，不进入本次开发首版。第一版发布使用结构化指导编辑器，支持 XML 校验与预览，不沿用未知的 SkillHub 内部发布流程。

第三轮截图与发现

在独立 Chrome 窗口补截了详情“评论”和“评测报告”：评论输入区限制 500 字，支持表情和最多 9 张图片，下方以热门/最新排序展示独立评论卡，包含点赞与回复。没有发表评论、点赞或上传内容。评测报告使用紫色信息卡、五维雷达图、综合分数、评级摘要及分项进度条，并注明基于 AI 自动检测、结果供参考。

当前公开评论包含使用故障反馈，而页面仍展示高自动评分。本记录只说明两种信息同时存在，不核实或转述评论中的故障结论。对本项目的启发是把“作者身份”“静态校验”“真实任务验证”和“用户反馈”分别表达，不能将它们合成一个未经说明的可信徽章。

本轮发现浏览器已有用户登录状态；进入 /dashboard/publish 仍显示“需要完成实名认证”，尚不能查看编辑器。没有进入实名认证或提交资料。此前匿名登录限制与本轮实名限制属于不同访问状态，均须保留，不能声称已研究发布表单。

第四轮：首页下半屏截图与首版取舍

本轮补截首页榜单、个人与企业发布流程、商业服务区、企业展示区、专家包入口及页脚。榜单以黑底第一名大卡和两列紧凑列表突出排行；发布流程用个人/企业双列分步说明，辅以操作界面图片；商业区以灰蓝底大面板展示按调用计费的服务示意。企业区使用横排浅灰卡片，专家包以横幅和单一浏览按钮收束，页脚列出服务/隐私协议、来源和版权说明。这里只记录可见设计，不将示意收益或排名视作已核实数据。

首版采用三种可复用结构：可扫描的文档列表、宽正文加窄元数据侧栏、清晰的发布步骤及校验反馈。首页不展示无真实来源的排行、收益、企业背书或专家包。可选集合以后可以作为导航，但每篇文档始终保有独立地址、独立版本和独立适用范围，不要求整组加载。

当前实现与交付状态

原型、邮箱账户及持久化发布已由用户合并（PR #6/#7/#8/#9），运行时仍需 ces-control CI 成功并部署后验收。PR #11 修正首页 data URL 的旧测试预期；PR #12 修复 llms.txt、Markdown 入口和 /api/guides 的公开只读发现规则，均等待用户手动合并。单篇 XML/JSON、条件链接、固定版本与作者权限已有实现和测试代码，不等于远程验证已经通过。

第五轮：目录筛选与空结果

实测 /skills?sortBy=trending 的“所有场景分类”菜单，选择开发编程后地址变为 /skills?category=dev-programming&sortBy=trending，结果数量随之更新。输入不匹配关键词后，地址同时保留 keyword/category/sortBy，显示 0 个结果、空结果插画和“清除所有筛选”按钮。菜单、分类结果和空状态均已在主 chat 截图。

本项目对应修复在 PR #13：分类数量包含用户文档与样例，避免只因样例未命中而误报全局无结果；区分加载失败与真实空结果；搜索提交、分类和快捷主题写入 URL，可刷新恢复并清除。真实数据库与 Chromium 回归代码已提交，远程 CI 尚待执行。

第六轮：其他主要页面模板

在新建 Chrome 研究窗口补截以下页面首屏，未安装插件、购买服务、投稿或执行页面中的命令：

实际页面	可见结构	对本项目的取舍
`/plugins`	大标题与数量、横向安装说明条、分类按钮、搜索/排序/视图切换、来源与统计列表	复用目录控件层级；独立文档采用读取地址，不要求安装运行时
`/skillpay`	巨大居中标题、普通/付费服务双栏对照、上架与接入流程按钮	说明页可用清晰对照，但本次不引入交易或调用计费
`/contest`	期数与状态、主题大标题、投稿/作品按钮、三联图片、数据及后续赛事说明	活动运营是独立模块；不作为文档发现或可信度的基础
`/tutorials`	左侧分组文档树、中间长文与表格、右侧本篇目录、阅读进度	协议与作者指南可借鉴锚点目录；文档本身不绑定整棵目录
`/skillspackage`	行业分类横栏、列表/卡片切换、专家角色与技能数量	只把集合视为可选导航；保留单篇独立入口
`/skillspackage/tech-test-automation`	概述/技能模块标签、串联工作步骤、右栏整包安装提示与 ZIP	本项目使用每条链接的 when/relation/revision，Agent 根据当前任务决定下一篇，不能默认执行全组步骤
`/enterprise-zone`	精选/最新/热门三块彩色面板、行业筛选、搜索和企业卡片区域	作者来源可展示；认证与热门数据不能代替单篇的适用条件和实际验证

企业专区截图仍包含加载骨架，后续读取超时；未据此声称卡片全部加载或交互已验证。活动页截图包含入场渐显效果，只用于识别版式；没有核实其运营数字。窄屏参考尚未采集，服务器视觉验收仍须覆盖窄屏。

截至本轮，已覆盖 SkillHub 主要公开页面模板和核心详情状态；实名受限的发布编辑器、个人后台及全部筛选组合未遍历。截图保留在主 chat 工具结果中。组件/页面规划见 design-system.md，研究观察与功能验证分开记录。

10 KiB Raw Blame History Unescape Escape