# Yishto > 面向 AI 应用开发者的双语原创工程学习笔记与独立产品入口。 作者为 Yishto。示例是教学数据，不代表生产测量。每篇 Markdown 与 HTML 使用相同正文、来源与日期。 ## 内容目录 - [作者与编辑说明](https://yishto.com/about/) - [完整目录](https://yishto.com/learn/index.md) - [产品入口](https://yishto.com/products/) ## 模型与 API - [模型与 API](https://yishto.com/learn/models/index.md): 理解模型的边界，写好第一次调用，再用评测做选择。 - [大模型 API 入门：Token 与上下文预算](https://yishto.com/learn/models/context-and-tokens/index.md): 分清 token、上下文窗口与输出预算，用一个离线示例练习如何组织模型输入。 - [流式输出与结构化结果：两种不同的可靠性](https://yishto.com/learn/models/streaming-and-structured-output/index.md): 理解流式事件和完整业务结果的区别，用本地 Python 示例验证结果字段，而不是把半段 JSON 当答案。 - [大模型评测：用任务集比较质量、延迟与成本](https://yishto.com/learn/models/model-evaluation/index.md): 用真实任务定义成功标准，比较模型质量、耗时与失败模式，避免仅凭排行榜做选型。 ## RAG 与知识检索 - [RAG 与知识检索](https://yishto.com/learn/rag/index.md): 把文档变成可检索的证据，让答案有出处、系统可评估。 - [RAG 的最小闭环：检索、证据、回答](https://yishto.com/learn/rag/retrieval-pipeline/index.md): 拆解知识检索与生成两条链路，用离线关键词检索示例理解出处、无答案与权限过滤。 - [RAG 文档切分与向量索引：保留语义，再做检索](https://yishto.com/learn/rag/chunking-and-indexes/index.md): 理解切块、重叠、元数据与向量索引的职责，用窗口切分示例观察边界与证据完整性。 - [如何评估 RAG：把检索和回答分开检查](https://yishto.com/learn/rag/rag-evaluation/index.md): 用 Recall@k、证据支持与无答案用例定位 RAG 问题，用小数据集演示检索评估。 ## Agent 工程 - [Agent 工程](https://yishto.com/learn/agents/index.md): 厘清工作流、工具与状态，把一次演示变成可恢复的任务。 - [AI Agent 与工作流：什么时候需要自主选择](https://yishto.com/learn/agents/workflows-and-agents/index.md): 从控制权、任务路径和失败成本判断是否需要 Agent，用路由示例划清模型和程序的职责。 - [MCP 与工具调用：输入契约、权限与执行边界](https://yishto.com/learn/agents/tool-contracts-and-mcp/index.md): 定义参数、结果、错误和权限契约，用离线工具分发器示例防止模型输出直接执行。 - [让 Agent 能恢复：任务状态、重试与幂等](https://yishto.com/learn/agents/durable-agent-state/index.md): 用 SQLite 演示任务状态迁移，区分对话历史、持久状态与外部副作用，处理重试造成的重复执行。 ## AI 应用上线 - [AI 应用上线](https://yishto.com/learn/production/index.md): 处理安全、延迟与失败，在真实约束下交付 AI 应用。 - [提示注入防护：把不可信内容留在数据边界内](https://yishto.com/learn/production/prompt-injection/index.md): 识别检索文档和工具结果中的间接指令，在程序侧限制工具、权限和资源访问。 - [AI 应用怎么观测：首字延迟、总耗时与成本](https://yishto.com/learn/production/latency-cost-observability/index.md): 拆分检索、模型和工具耗时，正确计算延迟分位数，用最小示例建立请求级观测。 - [AI 应用上线检查：超时、重试、权限与回滚](https://yishto.com/learn/production/shipping-checklist/index.md): 用失败矩阵检查超时、限流、权限、无证据和工具异常，把可用性与模型质量一起验收。 ## 计算与系统基础 - [计算与系统基础](https://yishto.com/learn/computing/index.md): 理解数据、程序和机器怎样配合，能解释开发中常见的系统现象。 - [一条加法指令怎样在计算机里执行](https://yishto.com/learn/computing/bits-instructions-and-cpu/index.md): 用 8 位模型区分无符号进位与有符号溢出，连接位表示、加法器、指令语义和 CPU 执行过程。 - [程序启动后：进程、虚拟内存与文件](https://yishto.com/learn/computing/process-memory-files/index.md): 区分进程草稿、虚拟内存与已保存内容，理解文件路径、保存失败、崩溃持久性和版本冲突。 - [同一份数据为什么会被读成不同的值](https://yishto.com/learn/computing/encoding-and-types/index.md): 分清字节、文本与类型，检查 UTF-8、字节序、数字精度和正则完整匹配，给接口补上运行时验证。 - [代码如何变成行为：语言、编译器与 DSL](https://yishto.com/learn/computing/languages-compilers-and-dsl/index.md): 理解解析、语义检查、编译、解释与 JIT，用有界表达式语言练习允许节点、资源限制和错误契约。 - [从查找问题理解算法与数据结构](https://yishto.com/learn/computing/algorithms-and-data-structures/index.md): 比较扫描、集合和二分查找的准备、查询与更新成本，理解顺序、计数和并发唯一性的边界。 - [从网址到页面：一次请求经过哪些边界](https://yishto.com/learn/computing/web-request-journey/index.md): 沿 URL、DNS、传输、TLS、HTTP 与浏览器渲染检查请求，区分连通、协议成功和业务成功。 ## 开发工具与工作流 - [开发工具与工作流](https://yishto.com/learn/developer-workflow/index.md): 从本地环境、版本控制到排错，建立可重复的开发过程。 - [让命令能在另一台电脑上运行](https://yishto.com/learn/developer-workflow/shell-environments-and-ports/index.md): 把命令搜索、工作目录、进程环境与端口监听分开检查，用合成路径演示跨电脑运行失败的定位方法。 - [把一次修改做成可审阅、可恢复的提交](https://yishto.com/learn/developer-workflow/git-ssh-and-review/index.md): 通过工作区与暂存快照的差异理解提交范围，结合分支恢复、SSH 身份检查和审阅说明完成一次修改。 - [装好工具之后，怎样确认项目真的能运行](https://yishto.com/learn/developer-workflow/packages-editors-and-ai-cli/index.md): 把依赖安装、锁文件一致性、调试配置与 AI 工具结果分别验证，建立资料目录应用的可复现运行证据。 - [排错时先找证据，再改代码](https://yishto.com/learn/developer-workflow/debugging-with-evidence/index.md): 围绕搜索页持续加载的失败路径，结合复现、网络证据、断点与合成追踪时间线，验证修复是否覆盖边界。 ## Web 界面工程 - [Web 界面工程](https://yishto.com/learn/web-interface/index.md): 从浏览器和语言基础到页面交互，兼顾可访问性、国际化与性能。 - [从页面结构到可操作的界面](https://yishto.com/learn/web-interface/html-layout-accessibility/index.md): 以资料目录页连接 HTML 语义、CSS 盒布局与键盘反馈，区分离线结构检查和真实浏览器可访问性验证。 - [JavaScript 为什么会先显示加载状态](https://yishto.com/learn/web-interface/javascript-runtime-and-async/index.md): 通过搜索请求解释同步执行、微任务与 await，并用请求身份处理加载终态和过期响应覆盖问题。 - [类型与组件怎样帮助维护界面](https://yishto.com/learn/web-interface/typescript-and-ui-frameworks/index.md): 把外部数据验证、联合状态和组件所有权连接起来，理解 TypeScript 与 React、Vue 各自能检查哪些问题。 - [页面、路由和状态应该放在哪里](https://yishto.com/learn/web-interface/state-routing-and-frontend-architecture/index.md): 按寿命划分 URL、局部和远程状态，再为阅读清单设计刷新路由、功能边界与可恢复的实时更新。 - [为产品准备图像、动画与交互素材](https://yishto.com/learn/web-interface/graphics-assets-and-motion/index.md): 按画面和操作选择位图、SVG 或 Canvas，结合像素预算、素材来源、减少运动与加载失败设计教学卡片。 - [多语言页面怎样兼顾 SEO 和加载体验](https://yishto.com/learn/web-interface/localization-and-web-performance/index.md): 为静态教程建立完整语言内容、独立 URL 与互指声明，并按 LCP、INP、CLS 分别验证加载体验。 ## 服务端与数据 - [服务端与数据](https://yishto.com/learn/service-data/index.md): 定义接口和数据约束，处理并发、任务、存储与权限。 - [接口契约：参数、身份、权限与错误](https://yishto.com/learn/service-data/http-api-contracts-and-access/index.md): 以私有草稿编辑契约连接 JSON 验证、身份与对象权限，处理安全错误、超时重试、分页和并发版本。 - [让数据库约束参与业务正确性](https://yishto.com/learn/service-data/database-indexes-and-transactions/index.md): 用库存预留验证唯一约束、条件扣减与事务回滚，并分清索引成本、并发隔离和 Supabase 行权限边界。 - [请求太多时：任务队列、缓存与背压](https://yishto.com/learn/service-data/jobs-caches-and-backpressure/index.md): 用有界资料任务队列连接接收、确认、重试与去重，分清限流背压和缓存陈旧策略的职责。 - [按职责组织服务端代码](https://yishto.com/learn/service-data/service-layers-and-frameworks/index.md): 按 HTTP 适配、用例、规则与仓储划分预约服务，验证事务、取消和依赖失败，并区分框架集成证据。 - [文件、索引和记录需要不同的存储策略](https://yishto.com/learn/service-data/storage-search-and-data-models/index.md): 将学习资料原文、所有权记录与检索索引分开，设计上传恢复、签名权限、模型选择和删除一致性。 ## 系统设计与交付 - [系统设计与交付](https://yishto.com/learn/delivery/index.md): 理解部署、扩容和故障恢复的取舍，给发布留下可验证的证据。 - [从单体到多服务：先设计失败与恢复](https://yishto.com/learn/delivery/distributed-systems-and-recovery/index.md): 用订单与库存的独立案例解释超时、幂等、补偿、共识与恢复目标，检验服务拆分后新增的失败状态。 - [从容器到集群，哪些责任发生了变化](https://yishto.com/learn/delivery/containers-orchestration-and-iac/index.md): 以无状态资料 API 区分镜像、实例、探针、调度资源和基础设施状态，检查容器与集群交付中的责任边界。 - [把服务放到正确的域名后面](https://yishto.com/learn/delivery/deployment-dns-gateways-and-cdn/index.md): 沿域名、证书、代理、源站与缓存逐层检查资料站交付，明确多语言缓存、私有响应和托管产品的边界。 - [让每次发布都能检查，也能恢复](https://yishto.com/learn/delivery/cicd-monitoring-and-incidents/index.md): 用搜索发布案例串起产物追踪、必要检查、用户健康、观测信号与事故处置，区分代码回滚和数据恢复。 - [从资产和入口开始设计安全边界](https://yishto.com/learn/delivery/security-boundaries-and-threat-models/index.md): 从资料助手的数据流识别资产、授权与执行边界，检查跨用户访问、模型注入、依赖代码和日志泄露。 ## 数据分析与工程质量 - [数据分析与工程质量](https://yishto.com/learn/data-practice/index.md): 从指标和实验到测试、重构与技术决策，保留可复核的依据。 - [指标、图表和实验怎样回答同一个问题](https://yishto.com/learn/data-practice/metrics-analysis-and-experiments/index.md): 以课程目录的合成数据说明指标分母、缺失、延迟分布与实验分配，区分描述性差异和能支持决策的证据。 - [埋点之前先定义数据的用途与边界](https://yishto.com/learn/data-practice/data-events-and-governance/index.md): 围绕课程完成事件定义用途、最小字段、版本与迟到规则，追踪重复、缺失和删除对指标的影响。 - [用测试和决策记录支持代码演进](https://yishto.com/learn/data-practice/testing-refactoring-and-decisions/index.md): 以整数折扣规则说明行为契约、舍入边界与测试层级，用小步重构和决策记录保留代码演进的依据。 ## AI 原理与应用设计 - [AI 原理与应用设计](https://yishto.com/learn/ai-foundations/index.md): 理解学习、注意力、多模态与模型适配，把能力边界落实到应用设计。 - [从学习目标理解神经网络与语言模型](https://yishto.com/learn/ai-foundations/learning-attention-and-language-models/index.md): 从训练目标与 token 预测解释模型行为，用 softmax 聚合实验理解注意力，并区分完整架构和应用评估。 - [把模型能力写成可检验的任务契约](https://yishto.com/learn/ai-foundations/prompts-context-and-capabilities/index.md): 把分类与提取任务拆成能力、上下文、输出和拒绝契约，核验结构之外的事实、来源与执行权限。 - [图像、语音与视频进入应用后要补什么](https://yishto.com/learn/ai-foundations/multimodal-image-and-speech/index.md): 把教学媒体处理拆成模态任务、输入校验、时间对齐、资产状态与复核，明确抽样、生成和识别的证据范围。 - [什么时候需要微调，什么时候改应用就够了](https://yishto.com/learn/ai-foundations/finetuning-inference-and-model-adaptation/index.md): 按分类错误比较提示、检索、微调与推理部署，说明数据泄漏、LoRA 条件、内存估算和版本恢复。 - [连接工具与 Agent 时，先定义谁负责执行](https://yishto.com/learn/ai-foundations/agent-protocols-and-sdk-boundaries/index.md): 区分 MCP 工具、A2A 任务、SDK 执行循环与 skills 材料，以窄读取契约检查授权、参数和结果责任。 - [把知识库应用做成能定位错误的系统](https://yishto.com/learn/ai-foundations/retrieval-orchestration-and-knowledge-apps/index.md): 把知识应用拆成采集、检索、生成与审计，核对片段来源、权限、无答案和框架状态，定位错误发生的阶段。 ## 产品发现与 AI 开发 - [产品发现与 AI 开发](https://yishto.com/learn/product-building/index.md): 先查清真实需求，再做原型、设计开发流程，并验证收费和发布行为。 - [从真实工作中找到值得做的产品问题](https://yishto.com/learn/product-building/needs-interviews-and-product-discovery/index.md): 从学习资料的近期工作调查问题、替代与购买角色，用有边界的证据和可失败原型决定下一步研究。 - [把需求变成能验证的原型和界面](https://yishto.com/learn/product-building/prototypes-design-systems-and-assets/index.md): 用独立阅读面板把原型假设变成层级、状态、组件、焦点与资产规格，区分截图覆盖和实际任务验证。 - [让 AI 开发过程留下可检查的结果](https://yishto.com/learn/product-building/specifications-and-coding-agents/index.md): 围绕资料导出定义行为、权限和失败验收，用小步差异、长任务检查点与结果矩阵复核 AI 开发产物。 - [收费功能怎样与产品权限保持一致](https://yishto.com/learn/product-building/payments-entitlements-and-webhooks/index.md): 把支付、订阅与产品权限分开建模，处理签名、重复、乱序和对账，并明确退款、取消与测试环境的边界。 - [把个人站做成可持续维护的内容产品](https://yishto.com/learn/product-building/personal-sites-content-and-release/index.md): 以原创双语知识系列设计内容、语言、来源和发布状态，让 sitemap、RSS、版本与恢复保持可复核的一致关系。 ## 跨平台应用开发 - [跨平台应用开发](https://yishto.com/learn/application-platforms/index.md): 比较运行环境和发布约束，通过独立练习理解原生、跨平台和扩展程序。 - [先看设备能力，再选应用平台](https://yishto.com/learn/application-platforms/choose-runtime-and-platform/index.md): 以离线资料阅读器为例，把文件访问、通知、后台下载和分发渠道拆成可验证条件，再选择运行时与平台。 - [用 SwiftUI 组织一个离线阅读应用](https://yishto.com/learn/application-platforms/swiftui-offline-reader/index.md): 围绕稳定资料ID设计SwiftUI列表、导航、离线仓库和下载状态，区分视图状态、磁盘数据与可取消异步任务。 - [用 Compose 构建可恢复的移动表单](https://yishto.com/learn/application-platforms/compose-offline-checklist/index.md): 为设备点检表建立草稿、校验、持久化和同步冲突状态，理解Compose重组与Android进程恢复的边界。 - [Flutter 应用怎样管理页面和异步状态](https://yishto.com/learn/application-platforms/flutter-reading-library/index.md): 以教学资料库解释Flutter组件身份、页面导航和异步请求顺序，建立本地仓库并处理旧响应、失败和页面销毁。 - [用 React Native 与 Expo 设计离线笔记](https://yishto.com/learn/application-platforms/expo-offline-notebook/index.md): 设计React Native与Expo读书笔记的数据表和同步队列，处理持久保存、重复请求、版本冲突与平台权限。 - [Electron 桌面工具怎样隔离文件和界面权限](https://yishto.com/learn/application-platforms/electron-transcript-workbench/index.md): 为访谈片段整理器划分Electron主进程、preload和界面职责，用文件授权ID、受限IPC和任务状态管理转录。 - [给学习页面加入可控的离线能力](https://yishto.com/learn/application-platforms/pwa-offline-learning/index.md): 为学习页面分别设计公共正文、静态资源和私有请求策略，解释Service Worker生命周期、版本缓存与更新恢复。 - [Qt 设备客户端怎样处理连接与界面状态](https://yishto.com/learn/application-platforms/qt-device-console/index.md): 使用合成传感器面板说明Qt信号槽、QObject线程归属和有界样本缓冲，建立连接状态与退出恢复规则。 - [为浏览器扩展划清页面和后台的边界](https://yishto.com/learn/application-platforms/browser-extension-study-assistant/index.md): 围绕用户主动选中文字的笔记助手设计Chrome扩展上下文、权限和消息校验，防止页面文本触发特权操作。 - [用 VS Code 扩展连接命令、文件与任务记录](https://yishto.com/learn/application-platforms/vscode-extension-task-notes/index.md): 构建项目任务记录扩展，连接命令声明、扩展生命周期和限定存储，明确工作区信任、URI与取消写入规则。 - [从游戏循环理解 Godot 的场景与状态](https://yishto.com/learn/application-platforms/godot-small-game-loop/index.md): 用收集方块练习组织Godot场景、输入动作、物理更新和游戏状态，验证暂停、重复碰撞与重开清理。 - [小程序怎样连接页面、身份与后端数据](https://yishto.com/learn/application-platforms/wechat-learning-miniapp/index.md): 设计学习进度小程序的页面、身份交换与数据授权，处理wx.login临时code、网络回调和真机域名校验。 - [在本地链上理解代币状态与交易确认](https://yishto.com/learn/application-platforms/local-chain-token-lab/index.md): 只用本地测试链设计练习凭据，解释ERC-721身份、铸造授权、转移与交易回执，并区分元数据和链上所有权。 - [应用发布前，哪些检查与平台有关](https://yishto.com/learn/application-platforms/application-release-and-maintenance/index.md): 把移动、桌面和扩展发布拆成构建、安装、提交与审核状态，制定产物、权限声明、可信更新和回退验收。 ## 完整项目实验室 - [完整项目实验室](https://yishto.com/learn/project-labs/index.md): 用独立设计的需求、数据模型和验收用例，把知识串成可实现的项目。 - [项目：商品描述审阅与协作工作台](https://yishto.com/learn/project-labs/lab-product-description-review/index.md): 设计草稿版本、审阅权限和证据校验，让 AI 建议经过人工批准后导出，处理多租户访问与旧版本冲突。 - [项目：文档处理任务编排器](https://yishto.com/learn/project-labs/lab-document-workflow-editor/index.md): 用独立文档项目连接图校验、节点契约、任务快照和恢复，区分模型提取与有权限的外部操作。 - [项目：培训练习与答题记录系统](https://yishto.com/learn/project-labs/lab-training-assessments/index.md): 冻结题目与评分版本，设计草稿、最终提交和结果权限，用独立练习系统检查重复请求与答案保护。 - [项目：教学插图任务与素材库](https://yishto.com/learn/project-labs/lab-illustration-job-queue/index.md): 把插图请求设计为有归属和预算的任务，协调队列、配额账本、R2 素材与人工审核，检查取消和重复执行。 - [项目：阅读推荐与解释服务](https://yishto.com/learn/project-labs/lab-book-recommendation/index.md): 先建立合成书目与规则推荐，再加入有出处的解释，处理冷启动、偏好权限、无结果和推荐评估。 - [项目：库存预留与履约状态服务](https://yishto.com/learn/project-labs/lab-inventory-reservations/index.md): 用独立库存项目连接预留、确认、过期和补偿，设计事务、条件迁移与 outbox，防止重复消息改变库存。 - [项目：设备采样数据与趋势面板](https://yishto.com/learn/project-labs/lab-sensor-data-dashboard/index.md): 从合成设备采样定义事件、质量和时间窗口，用 Go 接收与图表呈现思路检查重复、缺失与过期数据。 - [项目：出行约束与候选行程工作流](https://yishto.com/learn/project-labs/lab-outing-planning-workflow/index.md): 把行程生成拆成资料、候选、约束检查与确认，给工具访问和预算设边界，不让不可信内容授权订票。