fn_b/docs/maintenance/NEWCOMER_TUTORIALS_2026-11-01.md

新手教程与点赞配置调整

2026-11-02状态更新：本文所述待发布实现已随整批Git发布及固定文章API发布生效；当前范围、服务器侧验收与回退以整批发布记录为准。下文原日期的“仅本地/未发布”保留为当时记录。未做线上页面验收。

状态：2026-11-01 本地完成，未提交、推送或部署生产。正式发布仍必须经白色机使用固定文章发布封装，程序与公共样式按Git发布；本记录不构成生产已更新的证明。

范围与结果

• 本地client栏目改名“新手教程”，URL与平台子栏目保留；新增8篇并置顶新手指引。
• HN参考来源为/Users/hellcat/Documents/GemCodes/xb/content/hn/tutorials/和其维护索引：新手指引、所有客户端、Windows、Mac、Android FlClash、iOS Hiddify、Linux、OpenWrt OpenClash，共8个主题。HN只读，未修改共享核心或HN数据。
• FNA正文重新按公开免费节点场景撰写，不照搬HN登录、订购套餐、个人订阅与工单流程。每篇源文件及实际关系登记在写作索引，不在此重复关系表。
• 原7篇平台教程移至advanced，现综合教程11篇。仅移动分类，保留正文、标题、摘要、URL、图片、标签、创建与展示日期、点赞设置及增长进度。
• 免费节点结构化页面在“获取免费订阅”标题下显示主题色指引卡片；旧正文回退页在正文前显示。组件只在指引公开可用且属于新手栏目时输出，避免内容尚未发布时断链。使用说明中的平台入口改指新手子栏目。

内容与图片

正文源与最终API渲染稿：docs/content/tutorials/newcomer/*.md、*.html。封面原稿、JPG展示稿与提示说明：docs/content/tutorials/assets/newcomer/。8张封面独立生成，分别采用路径分岔、Windows窗口、Mac桌面、Android配置卡片、iOS玻璃设备、Linux安装包、路由器房屋网络和客户端设备盘的主题；均带clashfreenode.com网址水印。原稿1536×1024，展示稿JPEG82，约350～540KB；通过本地文章图片API上传，未扩大Nginx上传限制。正文保留语义化操作流程图，Windows配现有官方操作图。

资料依据：Clash Verge Rev官方安装、快速入门、订阅管理及Mac/Linux FAQ，FlClash官方仓库与导入实现，Hiddify官方使用文档及App Store页面，OpenClash官方仓库与订阅设置实现。公开正文保留对读者有用的官方入口；未安装各平台客户端、未进行设备联网测试，这些编辑验收事实不写入公开内容。

后续每篇必须独立设计主题封面并加网址水印，不能套用同一底图只换标题；规则已写入WRITING，现有fna周期写作任务同步此要求。频率、发布路线和额度未改变。

本地发布回执与恢复

工作目录：output/newcomer-20261101/。

• 新稿draft：bd3cd742-c522-4a33-a366-451580f7cdfa；publication：4caba2a1-0025-4932-aea0-9c74627b49ca。本地ID367～374，版本1；真实对应关系见new-receipt.json与写作索引。手动批次展示时间偏移关闭，不占生产每周额度。
• 移栏draft：a0064607-de7a-4d27-9098-2dc32ab6383f；7篇准确请求与回执为move-draft-request.json、move-receipt.json。修改前before-{id}.json，回读after-{id}.json。
• 栏目名称/置顶命令：php artisan tutorials:organize默认只预览，--apply才事务修改。先要求指引已在目标栏目公开保存，写私有备份，再改栏目sName与指引iIsTop；不写正文或点赞。
• 本地元数据备份：storage/app/private/editorial/tutorial-metadata-39a87680-c354-47f3-b2da-42cfaca05d96.json。此路径不作公开资产。
• 普通文章均经本站文章API保存草稿、预览及按hash发布；缓存与独立Meilisearch索引同步done，IndexNow本地禁用并返回skipped。
• 回退时按当前revision与原回执核对，7篇通过API创建恢复分类的草稿；新稿按API撤回流程处理并先恢复入口，保留请求UUID和历史版本。栏目/置顶只恢复私有备份中的对应字段，拒绝覆盖其他后续变化。样式与组件按本次差异撤回，不整份覆盖并行文件。

点赞配置优先级

用户修改的范围有效，原值保留在config/article_likes.php。本站配置覆盖所有上游/API传入的自动点赞值，配置0同样优先。接口参数继续做兼容校验，但不能改变本站策略；旧通用receive移除后续字段循环对i7like/i365like的二次覆盖。已存在文章的更新不重置进度，已冻结草稿重试不重抽。iLikeCount不是自动增长额度，本次不改变其旧接口语义。

新8篇草稿均按新手配置取值：短期1～18、持续年度50、一次性年度50～150；回读全部符合范围。原7篇移动分类没有套用综合教程的新参数。完整机制和当前类型表见自动点赞维护。以上代码与配置仍仅本地。

验收

• 35项PHP测试、325断言通过：EditorialApiTest、OneYearArticleLikesTest、LatestFreeNodeHomeTest。含配置0压过上游非0、旧通用接口不能二次覆盖、旧文章不重启进度、冻结草稿不重抽、指引缺失/非公开/错栏目不显示入口。
• verification.json：8篇新文源、分类与点赞参数回读通过；7篇移栏的正文、URL、日期、图与进度逐字段保持一致。
• link-checks.json：58条站内正文链接、目标锚点和正文图片本地HTTP通过。官方资料访问与本地页面验收不等于实际客户端联网测试。
• 浏览器：8篇草稿桌面与390px手机宽度无横向溢出，主题图加载；新手列表置顶顺序、计数8、滚动加载全部8篇确认；免费节点指引入口、主题色与手机换行确认。截图free-node-guide-entry.png、检查JSON在同工作目录。
• 本地使用既有Vite开发模式。未访问项目线上HTTP/API，未部署、未做线上页面验收。

封面风格与全宽显示（同日用户修订）

用户认可客户端下载封面的纸艺拼贴、微缩立体质感，并进一步认可新手指引的地图关卡封面。明确“把握风格，但别像一个模子复制出来的”：统一材质、层次与光影，每篇独立设计主题比喻、构图、镜头、主体与配色，不复制设备托盘。已写入WRITING并同步周期任务，免费节点插画池不变。

保留客户端下载原图；其余7篇使用新的纸艺主题封面：新手地图、Windows窗口建筑、Mac纸船、Android传送带、iOS纸桥、Linux印刷工坊、路由器城市网络。最终原稿、JPG与完整提示词为docs/content/tutorials/assets/newcomer/{key}-paper-cover.png/.jpg/.txt，通过内置imagegen生成，原封面保留供回退。清单与提示集合在output/newcomer-20261101/paper-style-files.json，不将未采用方案混入实际资产索引。

7篇仅封面变更，通过本地文章API草稿eb0e09d8-36fd-4770-ae52-8eb41a10d53d的准确hash发布，版本2；客户端下载仍版本1。paper-draft-request.json、paper-receipt.json与paper-before/after-{key}.json为回执及逐字段回查。正文、日期、分类、标签、点赞设置和进度不变。

详情模板首图增加专用article-cover类，display:block、width:100%、max-width:100%、height:auto并使用文章标题作为alt。它铺满正文栏、保留原3:2比例，不扩展页面栏宽，也不裁切画面。桌面封面/正文均702px；390px手机视口两者均322px，文档无横向溢出。7篇真实模板预览封面全部加载且等宽，证据paper-cover-checks.json和cover-full-width.png。本次仅本地生效，未部署生产。

新手指引双比例试样（同日）

用户要求先做一篇：本地ID373/newcomer-start保留原3:2列表封面，另生成1942×809（约2.4:1）纸艺横幅。三个关卡和路线重新横向排布，未压扁或裁剪原图。内置imagegen生成，素材与完整提示词在docs/content/tutorials/assets/newcomer/start-wide-hero.png/.jpg/.txt。

沿用现有API字段：cover不变，show_cover=false，正文开头插入一幅guide-figure tutorial-hero图片，使用本站上传资产。无需新数据库字段或修改其他文章；tutorials.css仅补该类的边距与无边框样式。源Markdown和实际渲染HTML已同步。本地草稿98b43b70-c04b-4962-8d85-85d6dba80e4c，版本3；工作目录wide-before/after.json、wide-draft-request.json、wide-receipt.json保存准确输入与回读。除了新增头图和关闭重复封面，文字、分类、日期、缩略图和点赞进度均一致。

实际预览桌面图为702×292，手机图为322×134，均与正文等宽、完整等比显示；390px视口无横向溢出，wide-checks.json保存测量结果。当时仅此篇本地生效，未上线；用户随后确认推广到本批其余7篇，完成状态见下节。单篇回退通过API恢复版本2内容和show_cover=true，保留原thumbnail与增长进度。

双比例配图推广与固定写作规范（同日）

用户确认试样后，本批剩余7篇均另生成约2.4:1详情横幅，保留原3:2缩略图；现在8篇均采用同一发布方式。每张横幅重新构图，没有裁剪或拉伸原图。正文文字、日期、分类、标签、列表封面与点赞进度逐字段回读一致，仅新增正文头图并关闭重复封面。

• 本地draft：08be340a-a7b9-4895-9c00-eb7a022a6bd9；publication：6d91a080-008e-4449-9263-b8334d06355d，状态published。
• Windows、Mac、Android、iOS、Linux、路由器版本3；客户端下载版本2；新手指引保持试样版本3。
• 内置imagegen生成，原图、交付JPG、完整提示词：docs/content/tutorials/assets/newcomer/{key}-wide-hero.png/.jpg/.txt。JPG约447～719KB；真实尺寸约1942×809，少数1935×812或1939×811，以上传资产返回值为准。
• 源稿Markdown与渲染HTML同步；准确请求、回执及前后数据在output/newcomer-20261101/wide-batch-*.json，恢复时按当前revision通过API恢复相应before内容及show_cover，保留其余字段。
• 七篇真实模板签名预览均检查桌面与390px手机：各仅一幅横图、无重复article-cover、全部加载；桌面702×292～295，手机322×134～135，无横向溢出。证据wide-batch-preview-checks.json。

正式规范已替换WRITING中的“仅单篇试样”，明确双图比例、分别构图、水印、API字段、唯一figure、源文件交付与逐篇验收；AGENTS、EDITORIAL_API及WEEKLY_TUTORIALS增加对应入口。现有fna自动任务提示词已通过automation_update更新并回读确认，ACTIVE和每日15:00频率不变。其他聊天按项目入口读取同一规范，不依赖本聊天记忆。

新手栏目banner（同日用户追加）

/client总列表去掉大图及对应介绍块，直接展示文章；保留不可见语义标题。Windows、Mac、Android、iOS、Linux五个真实子栏目使用各自21:9纸艺平台图，页面叠加平台名称与真实文章数量。图片内仅网址水印；取消原标题区毛玻璃模糊，使用底部柔和渐变保证文字对比。综合教程保持原有无大图表现，其他栏目不变。

映射入口：config/tutorials.php的category_banners；只应用于client真实子栏目，Android沿用既有andoridslug。模板为resources/views/pages/articles/default/index.blade.php，范围内样式在public/css/tutorials.css。公开JPG为public/images/tutorial-categories/{platform}-paper-banner.jpg（1916×821），原稿与内置imagegen完整提示词在docs/content/tutorials/assets/categories/；未写分类数据库或覆盖历史banner素材。

六个页面桌面1280px及手机390px核对：父级0个banner；五个子栏目各1个且资源加载、平台标题和数量正确；无横向溢出。证据output/newcomer-20261101/category-banner-checks.json。回退只撤销本节映射、模板和局部CSS差异，旧数据库banner字段仍在。文章双比例配图、栏目图与相关代码目前均仅本地，未提交、推送或部署生产。