# Deno 中文生态中心

> 从 Node.js 迁移、全栈开发到 Edge 与 AI Agent 的任务型文档索引。

- [Deno 中文生态中心](/docs/): 从 Node.js 迁移、全栈开发到 Edge 与 AI Agent 的 Deno 实战手册
- [关于本站](/docs/about/): Deno 中文生态中心的定位、事实来源、编辑原则与版本策略
- [AI / Agent 入口](/docs/ai/): 用最少上下文安全、准确地完成 Deno 开发任务
- [Deno Agent 架构](/docs/ai/agent-loop/): 在直接 SDK、MCP、LangChain 与 LlamaIndex 之间选择可控的 Agent 实现
- [可复制的 Agent 规则](/docs/ai/agent-rules/): 把 Deno 权限、依赖、验证和危险操作边界写入仓库指令
- [用 Deno 构建 AI 应用](/docs/ai/building-ai-apps/): 设计流式响应、密钥权限、工具调用、RAG 与可观测性边界
- [用 Deno 构建 MCP Server](/docs/ai/mcp-server/): 使用官方 TypeScript SDK、Zod 和 stdio 暴露经过校验的 MCP tool
- [Deno + OpenAI](/docs/ai/openai/): 用官方 OpenAI SDK 和 Responses API 构建最小权限的 Deno 服务
- [Deno Sandbox](/docs/ai/sandbox/): 用 Deno Deploy 的临时 Linux 微虚拟机隔离 Agent、插件与不可信代码
- [编译为单文件可执行程序](/docs/core/compile/): 用 deno compile 分发单文件应用，掌握交叉编译、资源嵌入与选型边界
- [调试与编辑器配置](/docs/core/debugging/): 配置 VS Code 与 deno lsp，用 --inspect 断点调试并定位权限与泄漏问题
- [依赖、JSR 与 npm](/docs/core/dependencies/): 管理 JSR、npm、Node 内置模块、imports、deno.lock 与缓存
- [Deno Desktop](/docs/core/desktop/): 使用 Deno 2.9 的 deno desktop 将 Web 应用打包为跨平台桌面程序
- [环境变量与 .env 管理](/docs/core/env-variables/): 用 --env-file、Deno.env 与精确 --allow-env 管理配置与密钥
- [模块与 Import Maps](/docs/core/imports/): 使用 ESM、JSR、npm 和 deno.json imports 管理清晰的模块边界
- [OpenTelemetry 可观测性](/docs/core/observability/): 使用 Deno 内置 OpenTelemetry 导出日志、指标、追踪与运行时自动埋点
- [权限与安全边界](/docs/core/permissions/): 用最小权限控制文件、网络、环境变量、子进程、FFI 与动态导入
- [运行时与 HTTP](/docs/core/runtime/): 运行 TypeScript、使用 Web API、启动 HTTP 服务并管理生命周期
- [Deno Standard Library](/docs/core/standard-library/): 正确使用发布在 JSR 上、按包独立版本化的 Deno 标准库
- [供应链安全](/docs/core/supply-chain/): 使用 deno ci、audit、依赖年龄、生命周期脚本审批、锁文件与 vendor 降低依赖风险
- [测试、Mock 与覆盖率](/docs/core/testing/): 使用 Deno.test、权限、过滤、覆盖率与资源清理建立可靠测试
- [内置开发工具](/docs/core/tooling/): 使用 fmt、lint、check、doc、bench、compile 与 bundle 管理工程质量
- [内置 TypeScript](/docs/core/typescript/): 直接运行 TypeScript，并把执行与类型检查放进明确的工程流程
- [Workspaces 与 Monorepo](/docs/core/workspaces/): 在单个 deno.json 中组织成员、共享依赖、任务与发布边界
- [Deno 数据库选型](/docs/database/): 在 PostgreSQL、SQLite、MongoDB、Redis、Supabase 与 Deno KV 之间选择
- [Deno KV](/docs/database/kv/): Deno KV 的现状、API 要点、一致性模型，以及新 Deno Deploy 与 Classic 关停后的迁移边界
- [PostgreSQL 与 Drizzle CRUD](/docs/database/postgres-drizzle/): 使用 Deno、postgres.js 和 Drizzle 建立可迁移、可测试的数据层
- [SQLite 与 node:sqlite](/docs/database/sqlite/): 在 Deno 中使用 node:sqlite 与兼容库，覆盖选型、最小权限与 WAL/备份边界
- [Supabase](/docs/database/supabase/): 从 Deno 直连 Supabase Postgres 或使用 supabase-js，覆盖连接池端口、RLS、Edge Functions 与密钥边界
- [部署决策](/docs/deploy/): 在 Deno Deploy、容器和通用云平台之间按运行时边界做选择
- [CI/CD 实战](/docs/deploy/ci-cd/): 用 setup-deno、deno ci 与分层门禁构建可复现的 Deno CI，并把产物发布到静态托管或 Deno Deploy
- [从 Deploy Classic 迁移](/docs/deploy/classic-migration/): 迁移 dash.deno.com、deployctl、旧 serve、KV、Queue、域名和 Subhosting v1
- [数据库、Cron 与 Timelines](/docs/deploy/data-and-cron/): 理解新 Deno Deploy 的 PostgreSQL、Deno KV、Cron、环境上下文与 Timeline 隔离
- [Deno Deploy](/docs/deploy/deno-deploy/): 将仓库连接到 Deno Deploy，并验证构建、环境变量、数据与可观测性边界
- [Docker 与容器](/docs/deploy/docker/): 使用官方 Deno 镜像、非 root 用户、缓存分层与最小权限构建生产容器
- [生产工程基线](/docs/deploy/production-baseline/): 用固定版本、锁文件、最小权限、CI 与可观测性约束 Deno 服务
- [第一个 Deno 项目](/docs/getting-started/first-project/): 从 main.ts、deno.json 和测试文件建立一个最小可维护项目
- [安装 Deno](/docs/getting-started/installation/): 在 macOS、Linux 和 Windows 安装、升级并验证 Deno
- [心智模型](/docs/getting-started/mental-model/): 理解 Deno 运行时、权限、模块、缓存与内置工具的职责边界
- [5 分钟上手](/docs/getting-started/quickstart/): 安装 Deno，运行一个最小权限的 TypeScript HTTP 服务并执行测试
- [Deno 是什么](/docs/getting-started/what-is-deno/): 理解 Deno 的来历、设计取舍，以及它与 Node.js、Bun 和 Workers 的边界
- [从 Node.js 迁移到 Deno](/docs/migration/): 一条保留回滚能力、逐层验证兼容性的 Deno 2 迁移路线
- [Node API 替换表](/docs/migration/api-mapping/): 在 Node 内置模块、Web API 与 Deno API 之间做可验证的迁移选择
- [从 Node.js 迁移](/docs/migration/from-node/): 在保留 package.json 与 npm 依赖的前提下渐进迁移到 Deno 2
- [npm、package.json 与 deno.json](/docs/migration/packages-and-config/): 理解 Deno 2 的依赖安装、锁文件与 node_modules 模式
- [Node 迁移常见问题](/docs/migration/troubleshooting/): 排查模块解析、CommonJS、原生扩展、权限与测试差异
- [Deno 实战项目蓝图](/docs/projects/): 四个可继续扩展的 Deno 项目结构、里程碑与验收清单
- [实战：Deno Cron 服务](/docs/projects/cron-service/): 把 job 写成可测试的普通函数，用 Deno.cron 触发，以唯一 execution key 保证幂等
- [实战：Fresh 2 + PostgreSQL + Drizzle 博客](/docs/projects/fresh-blog/): 按里程碑实现文章列表、详情、受保护创建，再加 Markdown、草稿、图片与搜索
- [实战：图片处理 API（Hono + sharp）](/docs/projects/image-api/): 用 Hono 与 npm:sharp 构建受限尺寸的图片转换服务，含 MIME/像素校验、对象存储与原生依赖 smoke test
- [实战：Deno MCP Server 项目](/docs/projects/mcp-server-project/): 从 stdio 与只读 tool 起步，用 Zod 校验参数、fixtures 做协议测试，再扩展到 Streamable HTTP
- [CLI 与 deno.json 速查](/docs/reference/cli-and-config/): Deno 常用子命令、配置职责、tasks、imports 与排错顺序
- [Deno vs Node.js vs Bun](/docs/reference/deno-vs-node-bun/): 按运行时模型、权限、TypeScript、包管理、工具链与部署形态对比三个 JavaScript 运行时并给出选型决策
- [生态选型](/docs/reference/ecosystem-decisions/): 在 JSR/npm、原生 API、Fresh 与 Node 框架之间按约束做决策
- [常见错误与排错](/docs/reference/errors/): 按权限、模块、类型、Node 兼容和平台边界定位 Deno 错误
- [常见问题](/docs/reference/faq/): Deno 2 的 Node 兼容、TypeScript、安全、npm/JSR 与生产使用答案
- [发布 JSR 包](/docs/reference/publishing-jsr/): 配置 exports、验证 TypeScript 包，并通过 GitHub Actions OIDC 发布带 provenance 的版本
- [Deno 2.x 能力矩阵](/docs/reference/version-matrix/): 区分稳定基线、需按版本核对的功能与托管平台能力
- [Deno Web 开发](/docs/web/): 在 Deno.serve、Fresh、Hono、Oak 与静态站工具之间选择
- [Fresh 2 全栈开发](/docs/web/fresh/): 使用当前 Fresh 2 路由、Island、中间件与部署模型
- [用 Hono 构建 API](/docs/web/hono/): 在 Deno 上创建可测试、可跨 runtime 部署的 Hono REST API
- [用 Lume 构建静态站](/docs/web/lume/): Lume 3 初始化、插件、_components 与具名权限的实战配置
- [用 Oak 构建后端](/docs/web/oak/): 使用 Oak 的 Application、Router 与 middleware 模型构建 Deno 服务