跳至内容
编辑与纠错

编辑与纠错说明

这里公开站点的写作、核验、更新和纠错规则。

内容类型

站点的原创文章按读者意图分属“开始、系统学习、开发指南、生产实践、排错与迁移、参考手册”六个栏目,每篇在标题上方标明类型:

类型含义
教程从零带你完成一件事,按顺序操作即可
指南帮你做判断或选型,核心是决策表
实验用可重复运行的脚本把某个行为量出来,结论附实验输出
Runbook带检查点和回滚方案的操作手册,用于迁移或上线
速查查一个写法、import 或报错用的页面,给出精确对照,不带操作步骤
历史站点早期对 LangChain 旧版(v0.1 / v0.2 时期)文档的中文翻译,仅为兼容旧链接而保留,不再更新

另有“官方资料预览”:基于官方文档固定版本生成的英文预览,页面顶部标明“英文预览”并链接官方原文,不代表本站观点。官方资料预览和历史版本默认不参与搜索引擎索引(noindex)。

每篇文章包含什么

原创文章(教程、指南、实验、Runbook、速查)按同一顺序编排:

  • 顶部信息:类型、最近更新日期、适用版本和阅读时间;
  • 问题与适用范围:开头说明解决什么问题、适合谁;“适用范围”写明环境版本,并分别列出“覆盖”和“未覆盖”的内容;
  • 先给结论:读者要的答案放在最前面,再给步骤、表格和实验;
  • 一手来源与核对日期:来源优先使用官方文档、官方仓库、包发布页和提供商文档;“依据与复现”一节写明核对日期和复现命令;
  • 至少两类原创实测结果:例如实测对比、决策表、兼容矩阵、故障树、基准数据、中文环境适配、维护脚本。只翻译、只改标题、只做摘要拼接都不算;
  • 可运行的示例与实际输出:代码固定版本,输出来自实际运行;无法运行的部分明确标注“未运行”和原因;
  • 失败与回滚:说明出错时如何判断、如何恢复;
  • 继续阅读:文末列出下一步可以读的文章,之后是文章反馈。

AI 辅助的披露

部分页面由 AI 辅助起草和整理。我们不把 AI 输出直接当作结论:页面中的代码要在固定版本的环境里实际运行,运行输出回填到页面,版本和来源可以逐项核对。涉及模型提供商、价格、限额等易变信息时,只引用官方页面并标注核验日期,不凭记忆写数据。

更新与存档

  • 文章顶部的“最近更新”是最近一次重新运行实验并核对官方来源的日期。依赖版本、官方文档或提供商行为变化后,会重新运行并更新;
  • 已经不适合作为当前版本参考的内容会进入历史存档,并通过 noindex 退出搜索引擎索引;
  • 站点不会把历史存档的翻译包装成原创内容。

内容独立性

技术判断只依据固定版本下的实际运行结果和官方来源,我们不会发布没有实测依据的“排名”或“最佳”结论。

纠错

发现事实错误、代码无法运行或链接失效,请发邮件到 admin@langchaincn.com,写明页面地址、问题所在和可核验的依据,详见联系我们。我们会复现并核对来源:确认后修改页面并更新“最近更新”日期;影响判断的重大错误会在页面顶部说明。无法核实的说法不会被直接采纳。

最后更新于