编辑与纠错
编辑与纠错说明
这里公开站点的写作、核验、更新和纠错规则。
内容类型
站点的原创文章按读者意图分属“开始、系统学习、开发指南、生产实践、排错与迁移、参考手册”六个栏目,每篇在标题上方标明类型:
| 类型 | 含义 |
|---|---|
| 教程 | 从零带你完成一件事,按顺序操作即可 |
| 指南 | 帮你做判断或选型,核心是决策表 |
| 实验 | 用可重复运行的脚本把某个行为量出来,结论附实验输出 |
| Runbook | 带检查点和回滚方案的操作手册,用于迁移或上线 |
| 速查 | 查一个写法、import 或报错用的页面,给出精确对照,不带操作步骤 |
| 历史 | 站点早期对 LangChain 旧版(v0.1 / v0.2 时期)文档的中文翻译,仅为兼容旧链接而保留,不再更新 |
另有“官方资料预览”:基于官方文档固定版本生成的英文预览,页面顶部标明“英文预览”并链接官方原文,不代表本站观点。官方资料预览和历史版本默认不参与搜索引擎索引(noindex)。
每篇文章包含什么
原创文章(教程、指南、实验、Runbook、速查)按同一顺序编排:
- 顶部信息:类型、最近更新日期、适用版本和阅读时间;
- 问题与适用范围:开头说明解决什么问题、适合谁;“适用范围”写明环境版本,并分别列出“覆盖”和“未覆盖”的内容;
- 先给结论:读者要的答案放在最前面,再给步骤、表格和实验;
- 一手来源与核对日期:来源优先使用官方文档、官方仓库、包发布页和提供商文档;“依据与复现”一节写明核对日期和复现命令;
- 至少两类原创实测结果:例如实测对比、决策表、兼容矩阵、故障树、基准数据、中文环境适配、维护脚本。只翻译、只改标题、只做摘要拼接都不算;
- 可运行的示例与实际输出:代码固定版本,输出来自实际运行;无法运行的部分明确标注“未运行”和原因;
- 失败与回滚:说明出错时如何判断、如何恢复;
- 继续阅读:文末列出下一步可以读的文章,之后是文章反馈。
AI 辅助的披露
部分页面由 AI 辅助起草和整理。我们不把 AI 输出直接当作结论:页面中的代码要在固定版本的环境里实际运行,运行输出回填到页面,版本和来源可以逐项核对。涉及模型提供商、价格、限额等易变信息时,只引用官方页面并标注核验日期,不凭记忆写数据。
更新与存档
- 文章顶部的“最近更新”是最近一次重新运行实验并核对官方来源的日期。依赖版本、官方文档或提供商行为变化后,会重新运行并更新;
- 已经不适合作为当前版本参考的内容会进入历史存档,并通过
noindex退出搜索引擎索引; - 站点不会把历史存档的翻译包装成原创内容。
内容独立性
技术判断只依据固定版本下的实际运行结果和官方来源,我们不会发布没有实测依据的“排名”或“最佳”结论。
纠错
发现事实错误、代码无法运行或链接失效,请发邮件到 admin@langchaincn.com,写明页面地址、问题所在和可核验的依据,详见联系我们。我们会复现并核对来源:确认后修改页面并更新“最近更新”日期;影响判断的重大错误会在页面顶部说明。无法核实的说法不会被直接采纳。
最后更新于