学习笔记 · Obsidian
JavaScript / TypeScript API Reference 与文档状态
入口映射
| docs 入口 | 外部 Reference 目标 | 代表性公开入口 |
|---|---|---|
| Deep Agents | /javascript/deepagents | createDeepAgent、backend、sandbox、summarization、subagent |
| LangChain | /javascript/langchain | createAgent、messages、tools、middleware、structured output |
| LangGraph | /javascript/langchain-langgraph | graph、state、checkpoint、stream、interrupt |
| Integrations | /javascript/integrations/overview | provider 与组件包 |
Overview 还列出 JavaScript MCP Adapter。与 Python 相同，四个具体 docs 路由主要承担跳转职责，深层符号由 reference.langchain.com 的独立生成管线维护。
2026-08-11 的实测状态
- Deep Agents 与 LangChain 跳转后的 Markdown 顶层清单可读取。
- LangGraph 的 docs 路由正确返回 307，但当次目标 Markdown 返回 404。
- Integrations 的 docs 路由正确返回 307，但当次目标返回 503。
- Overview 重复展示了两张 Deep Agents 卡片。
这些是文档生成/可用性观测，不能推断 LangGraph 或 integrations 包不存在。编码时应同时核对 npm 包版本、导出声明、类型检查和实际构建；文档故障应通过 reference docs issue 报告。
浏览器与 Node 运行时边界
Deep Agents Reference 同时出现 browser、node 与通用导出路径，说明不能默认所有后端在浏览器可用。涉及本地文件系统、shell、sandbox 或 Node 内建模块的能力，应在目标 runtime 做 bundler 与权限验证；前端包不得因为一个顶层导出就意外引入服务端代码或敏感凭证。
版本化验证清单
- 锁定
package.json与 lockfile 中的实际版本。 - 从包的公开 exports 与
.d.ts确认入口，不依赖深层内部路径。 - 运行
tsc、单元测试和目标 bundler 构建。 - Node、Edge、browser 分别验证运行时能力与 polyfill 假设。
- provider 包独立升级；记录 breaking change、迁移和回滚方式。