Field Agent 的资料、流式回答与使用边界

构建脚本读取站点配置、导航、公开页面简介、项目介绍、建站纪事、制作说明、随笔、失败记录及已跟踪的非草稿、非示例文章，生成站内知识索引。此次新增的十三篇双语文章通过明确收录清单进入索引，清单不自动扩展到其他本地文件。作者资料从“关于我”的简介、Agent 与全栈能力区域提取；课程目前收录公开入口说明。

当前检索使用关键词与中文双字片段评分，结合标题、正文和语言筛选，并不是向量数据库检索。网站概览、作者介绍和本站技术栈有明确资料入口；留言、统计、电台、课程等站内功能优先匹配对应页面，再补充相关文章。一般问题最多提供五份资料，只有明确的追问才使用上轮问题关键词。

浏览器只请求本站 API，DeepSeek 密钥留在服务端。服务端解析模型的 SSE 文字增量，以 NDJSON 发送额度、文字、完成和错误事件。前端按增量更新临时回答，完成后再提交到历史；取消请求会中止上游连接。

服务端检查引用编号是否属于本次检索资料，拒绝模型自行生成的链接，来源卡片的地址由检索结果提供。正文不显示编号，流式分块中的未完成标识也会隐藏。编号校验能约束来源范围，但不等于自动证明每一句事实都被资料支持。

每 IP 每日 15 次、全站每日 300 次，相邻请求至少间隔 5 秒，北京时间 00:00 重置；失败请求也计入额度。生产计数由 Cloudflare Durable Object 持久化事务保存，本地开发使用进程内计数。生产缺少对应绑定时拒绝提问。

限流存储使用经 HMAC 处理的访客标识，不保存原始 IP；这不代表共用网络中的每个人都有独立额度。问题、最近三轮对话和相关站内资料会发送至 DeepSeek。对话目前只保留在页面会话中，没有写入浏览器持久存储或本站数据库。

全站会话与面板显示分开管理，因此关闭助手或站内导航不会清空对话。桌面面板不锁定背景页面，手机全屏面板管理焦点与页面滚动；两种布局都固定输入区，让长回答在内容区内滚动。

GSAP 负责面板内容入场，CSS 负责光晕与卡片反馈，Canvas 绘制等距投影的信号矩阵。指针命中前方可见柱面，升起过程中保持选择稳定；局部影响有明确边界，待机不加入整片起伏。矩阵每秒最多 30 帧，页面隐藏、面板卸载时停止；关闭动效时静态矩阵仍可点击。此说明对应 V2.0.0 的实现。

构建时从知识索引生成十条轻量双语内容信号，按五个主题映射到四十九根光柱；客户端只载入标题、简介、地址和问题种子，不需要带上完整问答语料。来源缺失时构建会报错，避免卡片悄悄指向不存在的内容。

点击光柱或主题按钮只改变本地卡片状态；“换一条”轮换同主题内容，“打开原文”使用实际站内地址。“问问 Field Agent”只预填问题，访客点击发送才进入服务端检索、模型调用与额度流程。额度用完时仍可以发现和阅读内容；键盘使用方向键选择光柱，Enter 打开卡片，关闭卡片后焦点返回矩阵。