服务 · Go
玩法教程
阅读官方 NAS 与 Docker 玩法教程，并把合适的教程内容转成可确认的部署任务。
可以做什么
- 订阅并阅读官方教程内容
- 使用 AI 总结快速理解教程
- 从教程发起按文部署
这个页面解决什么问题
玩法教程页把官方（或你自定义 RSS 订阅的）NAS/Docker 实操文章集中到一个双面板阅读器：左侧目录、右侧正文，各自独立滚动。收录标准偏向实操——包含有效 Compose、可解析的 docker run，或同时具备 NAS 场景、明确步骤和可执行命令的文章；贴图、新闻和纯评测不会进入列表。
它与 AI 的关系是“辅助阅读、受控部署”：AI 总结帮助你快速判断文章值不值得读，AI 问答以只读方式分析文章内容，而真正的部署动作必须通过「AI 部署」按钮单独发起，并在 AI 会话里经过方案确认才会执行。
文章内容由 Client 后端获取并安全清洗后渲染；图片经授权接口按需下载到本地缓存，浏览器不直连上游地址，正文中的脚本和危险链接会被移除。
开始前准备
- 需要 TRADIS Go 授权；未授权时页面展示订阅说明与授权入口，不加载教程数据。
- AI 总结、问答与按文部署需要设置中已保存可用的模型连接。
- 使用自定义 RSS 订阅时，在「设置 → 服务」中填写 HTTP(S) RSS 地址；留空则不读取任何内容。
如何操作
检索与阅读教程
想找一篇 NAS 或 Docker 的实操教程照着做。
- 在左侧目录中按标题或更新时间浏览，使用搜索快速定位主题。
- 打开文章后，正文左侧自动生成悬浮目录，点击章节滚动定位并标记阅读位置；窄屏目录回到正文上方。
- 代码块支持一键复制；图片接近可视区域时按需加载，失败可重试并支持原图预览。
- 需要对照原文时使用「跳转原文」；仅允许安全的 HTTP(S) 原文链接。
- 订阅了自定义 RSS 的用户可使用「使用官方教程」切回官方源：点击后清空覆盖项并刷新，失败会直接显示错误，不用旧缓存冒充成功。
结果检查：正文完整可读；正文开头的封面图与“往期推荐”等推广内容不会出现，阅读不受广告干扰。
生成与管理 AI 总结
文章很长，想先花三十秒判断是否值得完整阅读。
- 在正文工具栏点击「AI 总结」生成当前文章的摘要。
- 总结按文章内容指纹缓存：刷新页面后仍展示已有总结；需要更新时使用重新生成。
- 使用显示/隐藏切换总结，偏好会被记住；摘要只展示最终内容，模型输出的思考块会被过滤。
- 生成成功但缓存写入失败时，正文仍展示本次总结并提示缓存失败，不会误报为生成失败。
结果检查：每次打开文章都能快速获取结论；总结是辅助阅读的概览，不能替代正文中的具体命令和参数。
从教程发起按文部署
读完教程决定照做，把部署交给 Agent 执行。
- 在正文工具栏点击「AI 部署」；页面切换到 AI 一键部署并提交后台任务。
- 教程来源通过结构化字段传递给 Agent，不会在聊天区出现来源卡片或样板文案。
- Agent 先读取教程正文，提取其中的 Compose、Dockerfile、脚本和部署步骤；只有教程缺少必要信息时才会搜索 GitHub 或向你提问。
- 在 AI 会话中确认生成的部署方案后，操作才会执行。
结果检查：部署方案与教程内容对应；Agent 的每一步计划、工具调用和待确认项都在会话中可见，最终以实际容器状态为准。
与教程对话问答
对文章某一步有疑问，想针对内容追问。
- 打开正文右侧的问答面板（Full）。
- 直接输入问题；客户端只提交文章标识与问题，服务端按当前教程缓存读取正文作答。
- 问答运行强制只读，不会对系统做任何修改；支持分析、追问、停止和恢复文章对话。
- 需要真正执行部署时，仍回到正文的「AI 部署」按钮发起。
结果检查：获得针对当前文章的解释与分析；问答与部署是两条独立通道，问答永远不触发写操作。
注意事项
- 正文与问答没有独立业务弹窗；工具栏操作（AI 总结、AI 部署、跳转原文）都在页面内完成。
- 教程图片固定缓存于本地数据目录，容量由设置控制，超限按最近最少使用清理；私有 RSS 图片只允许读取同步时记录的同源地址。
- 切换教程来源时，旧来源的正文与摘要缓存不会继承到新来源，迟到的旧请求也不会覆盖新内容。