diff --git a/.vitepress/locales/zh.js b/.vitepress/locales/zh.js
index 4f135ae..c69adf0 100644
--- a/.vitepress/locales/zh.js
+++ b/.vitepress/locales/zh.js
@@ -154,7 +154,7 @@ export default {
             link: '/zh/breaking-changes/transition-group'
           },
           {
-            text: 'VNode 声明周期事件',
+            text: 'VNode 生命周期事件',
             link: '/zh/breaking-changes/vnode-lifecycle-events'
           },
           { text: 'Watch 侦听数组', link: '/zh/breaking-changes/watch' }
diff --git a/.vitepress/theme/MigrationBadges.vue b/.vitepress/theme/MigrationBadges.vue
index 2d5ce2a..46b1170 100644
--- a/.vitepress/theme/MigrationBadges.vue
+++ b/.vitepress/theme/MigrationBadges.vue
@@ -1,10 +1,20 @@
 <script>
+import { useData } from 'vitepress'
 const validBadges = {
   new: 'new',
   breaking: 'breaking',
   removed: 'removed',
   updated: 'updated'
 }
+const localeBadges = {
+  'en-US': validBadges,
+  'zh-CN': {
+    new: '新增',
+    breaking: '非兼容',
+    removed: '移除',
+    updated: '更新'
+  }
+}
 
 export default {
   props: {
@@ -16,10 +26,9 @@ export default {
       }
     }
   },
-  data() {
-    return {
-      validBadges
-    }
+  setup () {
+    const { site } = useData()
+    return { validBadges: localeBadges[site.value.lang] ?? validBadges }
   }
 }
 </script>
diff --git a/src/zh/breaking-changes/async-components.md b/src/zh/breaking-changes/async-components.md
index 57fe035..79bacfe 100644
--- a/src/zh/breaking-changes/async-components.md
+++ b/src/zh/breaking-changes/async-components.md
@@ -58,7 +58,7 @@ const asyncModalWithOptions = defineAsyncComponent({
 ```
 
 ::: tip 注意
-Vue Router 支持一个类似的机制来异步加载路由组件，也就是俗称的*懒加载*。尽管类似，但是这个功能和 Vue 所支持的异步组件是不同的。当用 Vue Router 配置路由组件时，你**不**应该使用 `defineAsyncComponent`。你可以在 Vue Router 文档的[懒加载路由](https://next.router.vuejs.org/guide/advanced/lazy-loading.html)章节阅读更多相关内容。
+Vue Router 支持一个类似的机制来异步加载路由组件，也就是俗称的*懒加载*。尽管类似，但是这个功能和 Vue 所支持的异步组件是不同的。当用 Vue Router 配置路由组件时，你**不**应该使用 `defineAsyncComponent`。你可以在 Vue Router 文档的[懒加载路由](https://router.vuejs.org/zh/guide/advanced/lazy-loading.html)章节阅读更多相关内容。
 :::
 
 对 2.x 所做的另一个更改是，`component` 选项现在被重命名为 `loader`，以明确组件定义不能直接被提供。
@@ -94,5 +94,5 @@ const asyncComponent = defineAsyncComponent(
 
 有关异步组件用法的详细信息，请参阅：
 
-- [指南：动态 & 异步组件](/guide/component-dynamic-async.html#在动态组件上使用-keep-alive)
-- [迁移构建开关：`COMPONENT_ASYNC`](migration-build.html#兼容性配置)
+- [指南：异步组件](https://cn.vuejs.org/guide/components/async.html)
+- [迁移构建开关：`COMPONENT_ASYNC`](../migration-build.html#兼容性配置)
diff --git a/src/zh/breaking-changes/attribute-coercion.md b/src/zh/breaking-changes/attribute-coercion.md
index d4dcc03..687bbc0 100644
--- a/src/zh/breaking-changes/attribute-coercion.md
+++ b/src/zh/breaking-changes/attribute-coercion.md
@@ -140,7 +140,7 @@ badges:
   </tbody>
 </table>
 
-[迁移构建开关：](migration-build.html#兼容性配置)
+[迁移构建开关：](../migration-build.html#兼容性配置)
 
 - `ATTR_FALSE_VALUE`
 - `ATTR_ENUMERATED_COERCION`
diff --git a/src/zh/breaking-changes/attrs-includes-class-style.md b/src/zh/breaking-changes/attrs-includes-class-style.md
index 90869ed..678be0d 100644
--- a/src/zh/breaking-changes/attrs-includes-class-style.md
+++ b/src/zh/breaking-changes/attrs-includes-class-style.md
@@ -60,7 +60,7 @@ export default {
 
 在使用了 `inheritAttrs: false` 的组件中，请确保样式仍然符合预期。如果你之前依赖了 `class` 和 `style` 的特殊行为，那么一些视觉效果可能会遭到破坏，因为这些 attribute 现在可能被应用到了另一个元素中。
 
-[迁移构建开关：`INSTANCE_ATTRS_CLASS_STYLE`](migration-build.html#兼容性配置)
+[迁移构建开关：`INSTANCE_ATTRS_CLASS_STYLE`](../migration-build.html#兼容性配置)
 
 ## 参考
 
diff --git a/src/zh/breaking-changes/children.md b/src/zh/breaking-changes/children.md
index 5fdf029..34aa46a 100644
--- a/src/zh/breaking-changes/children.md
+++ b/src/zh/breaking-changes/children.md
@@ -37,8 +37,8 @@ export default {
 
 ## 3.x 更新
 
-在 3.x 中，`$children` property 已被移除，且不再支持。如果你需要访问子组件实例，我们建议使用 [$refs](/guide/component-template-refs.html#模板引用)。
+在 3.x 中，`$children` property 已被移除，且不再支持。如果你需要访问子组件实例，我们建议使用 [模板引用](https://cn.vuejs.org/guide/essentials/template-refs.html#template-refs)。
 
 ## 迁移策略
 
-[迁移构建开关：`INSTANCE_CHILDREN`](migration-build.html#兼容性配置)
+[迁移构建开关：`INSTANCE_CHILDREN`](../migration-build.html#兼容性配置)
diff --git a/src/zh/breaking-changes/custom-directives.md b/src/zh/breaking-changes/custom-directives.md
index 4a20560..ca26672 100644
--- a/src/zh/breaking-changes/custom-directives.md
+++ b/src/zh/breaking-changes/custom-directives.md
@@ -103,9 +103,9 @@ mounted(el, binding, vnode) {
 ```
 
 :::warning
-有了[片段](/guide/migration/fragments.html#概览)的支持，组件可能会有多个根节点。当被应用于多根组件时，自定义指令将被忽略，并将抛出警告。
+有了[片段](../new/fragments.html#概览)的支持，组件可能会有多个根节点。当被应用于多根组件时，自定义指令将被忽略，并将抛出警告。
 :::
 
 ## 迁移策略
 
-[迁移构建开关：`CUSTOM_DIR`](migration-build.html#兼容性配置)
+[迁移构建开关：`CUSTOM_DIR`](../migration-build.html#兼容性配置)
diff --git a/src/zh/breaking-changes/custom-elements-interop.md b/src/zh/breaking-changes/custom-elements-interop.md
index 6e22ba0..eb6a3c7 100644
--- a/src/zh/breaking-changes/custom-elements-interop.md
+++ b/src/zh/breaking-changes/custom-elements-interop.md
@@ -96,7 +96,7 @@ Vue.config.ignoredElements = ['plastic-button']
     document.createElement('button', { is: 'plastic-button' })
     ```
 
-[迁移构建开关：`COMPILER_IS_ON_ELEMENT`](migration-build.html#兼容性配置)
+[迁移构建开关：`COMPILER_IS_ON_ELEMENT`](../migration-build.html#兼容性配置)
 
 ## 使用 `vue:` 前缀来解决 DOM 内模板解析问题
 
@@ -128,3 +128,7 @@ Vue.config.ignoredElements = ['plastic-button']
 - 将 `config.ignoredElements` 替换为 `vue-loader` 的 `compilerOptions` (使用构建步骤) 或 `app.config.compilerOptions.isCustomElement` (使用动态模板编译)
 
 - 将所有非针对 `<component>` 标签的 `is` 用法更改为 `<component is="...">` (对于 SFC 模板) 或为其添加 `vue:` 前缀 (对于 DOM 内模板)。
+
+## 参考
+
+- [迁移指南 - Vue 与 Web Components](https://cn.vuejs.org/guide/extras/web-components.html)
\ No newline at end of file
diff --git a/src/zh/breaking-changes/data-option.md b/src/zh/breaking-changes/data-option.md
index e0de86f..bc212bf 100644
--- a/src/zh/breaking-changes/data-option.md
+++ b/src/zh/breaking-changes/data-option.md
@@ -111,7 +111,7 @@ const CompA = {
 }
 ```
 
-[迁移构建开关：`OPTIONS_DATA_FN`](migration-build.html#兼容性配置)
+[迁移构建开关：`OPTIONS_DATA_FN`](../migration-build.html#兼容性配置)
 
 ## 迁移策略
 
@@ -122,7 +122,7 @@ const CompA = {
 
 对于依赖 mixin 的深度合并行为的用户，我们建议重构代码以完全避免这种依赖，因为 mixin 的深度合并非常隐式，这让代码逻辑更难理解和调试。
 
-[迁移构建开关：](migration-build.html#兼容性配置)
+[迁移构建开关：](../migration-build.html#兼容性配置)
 
 - `OPTIONS_DATA_FN`
 - `OPTIONS_DATA_MERGE`
diff --git a/src/zh/breaking-changes/emits-option.md b/src/zh/breaking-changes/emits-option.md
index 74cdf1d..077ac6b 100644
--- a/src/zh/breaking-changes/emits-option.md
+++ b/src/zh/breaking-changes/emits-option.md
@@ -49,7 +49,7 @@ Vue 3 现在提供一个 `emits` 选项，和现有的 `props` 选项类似。
 
 该选项也可以接收一个对象，该对象允许开发者定义传入事件参数的验证器，和 `props` 定义里的验证器类似。
 
-更多信息请参阅[这部分特性的 API 文档](../../api/options-data.md#emits)。
+更多信息请参阅[这部分特性的 API 文档](https://cn.vuejs.org/api/options-state.html#emits)。
 
 ## 迁移策略
 
diff --git a/src/zh/breaking-changes/events-api.md b/src/zh/breaking-changes/events-api.md
index d3b4879..5f1cf39 100644
--- a/src/zh/breaking-changes/events-api.md
+++ b/src/zh/breaking-changes/events-api.md
@@ -58,7 +58,7 @@ export default {
 
 ## 迁移策略
 
-[迁移构建开关：`INSTANCE_EVENT_EMITTER`](migration-build.html#兼容性配置)
+[迁移构建开关：`INSTANCE_EVENT_EMITTER`](../migration-build.html#兼容性配置)
 
 在 Vue 3 中，借助这些 API 从一个组件内部监听其自身触发的事件已经不再可能了。该用例没有办法迁移。
 
@@ -97,8 +97,8 @@ export default {
 
 在绝大多数情况下，不鼓励使用全局的事件总线在组件之间进行通信。虽然在短期内往往是最简单的解决方案，但从长期来看，它维护起来总是令人头疼。根据具体情况来看，有多种事件总线的替代方案：
 
-* [Prop](/guide/component-basics.html#passing-data-to-child-components-with-props) 和[事件](/guide/component-basics.html#listening-to-child-components-events)应该是父子组件之间沟通的首选。兄弟节点可以通过它们的父节点通信。
-* [Provide 和 inject](/guide/component-provide-inject.html) 允许一个组件与它的插槽内容进行通信。这对于总是一起使用的紧密耦合的组件非常有用。
-* `provide`/`inject` 也能够用于组件之间的远距离通信。它可以帮助避免“prop 逐级透传”，即 prop 需要通过许多层级的组件传递下去，但这些组件本身可能并不需要那些 prop。
+* Props 和 事件 应该是父子组件之间沟通的首选。兄弟节点可以通过它们的父节点通信。
+* `provide` / `inject` 允许一个组件与它的插槽内容进行通信。这对于总是一起使用的紧密耦合的组件非常有用。
+* `provide` / `inject` 也能够用于组件之间的远距离通信。它可以帮助避免“prop 逐级透传”，即 prop 需要通过许多层级的组件传递下去，但这些组件本身可能并不需要那些 prop。
 * Prop 逐级透传也可以通过重构以使用插槽来避免。如果一个中间组件不需要某些 prop，那么表明它可能存在关注点分离的问题。在该类组件中使用 slot 可以允许父节点直接为它创建内容，因此 prop 可以被直接传递而不需要中间组件的参与。
-* [全局状态管理](/guide/state-management.html)，比如 [Vuex](https://next.vuex.vuejs.org/zh/index.html)。
+* [全局状态管理](https://cn.vuejs.org/guide/scaling-up/state-management.html)，比如 [Pinia](https://pinia.vuejs.org/zh/index.html)。
diff --git a/src/zh/breaking-changes/filters.md b/src/zh/breaking-changes/filters.md
index 3132288..cbc97d8 100644
--- a/src/zh/breaking-changes/filters.md
+++ b/src/zh/breaking-changes/filters.md
@@ -73,7 +73,7 @@ badges:
 
 我们建议用计算属性或方法代替过滤器，而不是使用过滤器。
 
-[迁移构建开关：](migration-build.html#兼容性配置)
+[迁移构建开关：](../migration-build.html#兼容性配置)
 
 - `FILTERS`
 - `COMPILER_FILTERS`
@@ -82,7 +82,7 @@ badges:
 
 如果在应用中全局注册了过滤器，那么在每个组件中用计算属性或方法调用来替换它可能就没那么方便了。
 
-取而代之的是，你可以通过[全局属性](../../api/application-config.html#globalproperties)以让它能够被所有组件使用到：
+取而代之的是，你可以通过[全局属性](https://cn.vuejs.org/api/application.html#app-config-globalproperties)以让它能够被所有组件使用到：
 
 ```js
 // main.js
diff --git a/src/zh/breaking-changes/functional-components.md b/src/zh/breaking-changes/functional-components.md
index 4c959fc..a96f889 100644
--- a/src/zh/breaking-changes/functional-components.md
+++ b/src/zh/breaking-changes/functional-components.md
@@ -115,6 +115,6 @@ export default {
 
 有关新的函数式组件的用法和对渲染函数的更改的详细信息，请参考：
 
-- [迁移：渲染函数](/guide/migration/render-function-api.html)
-- [指南：渲染函数](/guide/render-function.html)
-- [迁移构建开关：`COMPONENT_FUNCTIONAL`](migration-build.html#兼容性配置)
+- [迁移：渲染函数](./render-function-api.html)
+- [指南：渲染函数](https://cn.vuejs.org/guide/extras/render-function.html#render-functions-jsx)
+- [迁移构建开关：`COMPONENT_FUNCTIONAL`](../migration-build.html#兼容性配置)
diff --git a/src/zh/breaking-changes/global-api-treeshaking.md b/src/zh/breaking-changes/global-api-treeshaking.md
index 153fa70..f57d4cc 100644
--- a/src/zh/breaking-changes/global-api-treeshaking.md
+++ b/src/zh/breaking-changes/global-api-treeshaking.md
@@ -17,7 +17,7 @@ Vue.nextTick(() => {
 })
 ```
 
-或者，如果你曾经对涉及[异步组件](/guide/component-dynamic-async.html)的应用进行单元测试，那么你很可能编写过以下内容：
+或者，如果你曾经对涉及[异步组件](https://v2.cn.vuejs.org/v2/guide/components-dynamic-async.html)的应用进行单元测试，那么你很可能编写过以下内容：
 
 ```js
 import { shallowMount } from '@vue/test-utils'
@@ -110,7 +110,7 @@ export function render() {
 有了全局 tree-shaking 后，用户只需为他们实际使用到的功能“买单”。更棒的是，因为可选特性不会增加未使用它们的应用的打包产物大小，以后在追加核心功能时，即使对框架大小有所顾虑，它也将不再那么重要了。
 
 :::warning 重要
-以上仅适用于 [ES 模块构建版本](/guide/installation.html#对不同构建版本的解释)，用于支持 tree-shaking 的打包工具——UMD 构建仍然包括所有特性，并暴露 Vue 全局变量上的所有内容 (编译器将生成适当的输出以从该全局变量上使用 API，而不是导入)。
+以上仅适用于 [ES 模块构建版本](https://github.com/vuejs/core/tree/master/packages/vue#which-dist-file-to-use)，用于支持 tree-shaking 的打包工具——UMD 构建仍然包括所有特性，并暴露 Vue 全局变量上的所有内容 (编译器将生成适当的输出以从该全局变量上使用 API，而不是导入)。
 :::
 
 ## 插件中的用法
diff --git a/src/zh/breaking-changes/global-api.md b/src/zh/breaking-changes/global-api.md
index 818f1f0..d904c8f 100644
--- a/src/zh/breaking-changes/global-api.md
+++ b/src/zh/breaking-changes/global-api.md
@@ -65,7 +65,7 @@ import { createApp } from 'vue'
 const app = createApp({})
 ```
 
-如果你使用的是 Vue 的 [CDN](/guide/installation.html#cdn) 构建版本，那么 `createApp` 将通过全局的 `Vue` 对象暴露。
+如果你使用的是 Vue 的 [CDN](./introduction.html#cdn) 构建版本，那么 `createApp` 将通过全局的 `Vue` 对象暴露。
 
 ```js
 const { createApp } = Vue
@@ -87,7 +87,7 @@ const app = createApp({})
 | Vue.prototype              | app.config.globalProperties ([见下方](#vue-prototype-替换为-config-globalproperties))                        |
 | Vue.extend                 | *移除* ([见下方](#vue-extend-移除))                                                                 |
 
-所有其他不全局改变行为的全局 API 现在都是具名导出，文档见[全局 API Treeshaking](/guide/migration/global-api-treeshaking.html)。
+所有其他不全局改变行为的全局 API 现在都是具名导出，文档见[全局 API Treeshaking](./global-api-treeshaking.html)。
 
 ### `config.productionTip` 移除
 
@@ -95,7 +95,7 @@ const app = createApp({})
 
 对于 ES 模块构建版本，由于它们是与打包器一起使用的，而且在大多数情况下，CLI 或脚手架已经正确地配置了生产环境，所以本提示将不再出现。
 
-[迁移构建开关：`CONFIG_PRODUCTION_TIP`](migration-build.html#兼容性配置)
+[迁移构建开关：`CONFIG_PRODUCTION_TIP`](../migration-build.html#兼容性配置)
 
 ### `config.ignoredElements` 替换为 `config.isCustomElement`
 
@@ -118,13 +118,13 @@ app.config.compilerOptions.isCustomElement = tag => tag.startsWith('ion-')
 - 这将是 Vue CLI 配置中新的顶层选项。
 :::
 
-[迁移构建开关：`CONFIG_IGNORED_ELEMENTS`](migration-build.html#兼容性配置)
+[迁移构建开关：`CONFIG_IGNORED_ELEMENTS`](../migration-build.html#兼容性配置)
 
 ### `Vue.prototype` 替换为 `config.globalProperties`
 
 在 Vue 2 中， `Vue.prototype` 通常用于添加所有组件都能访问的 property。
 
-在 Vue 3 中与之对应的是 [`config.globalProperties`](/api/application-config.html#globalproperties)。这些 property 将被复制到应用中，作为实例化组件的一部分。
+在 Vue 3 中与之对应的是 [`config.globalProperties`](https://cn.vuejs.org/api/application-config.html#globalproperties)。这些 property 将被复制到应用中，作为实例化组件的一部分。
 
 ```js
 // 之前 - Vue 2
@@ -139,7 +139,7 @@ app.config.globalProperties.$http = () => {}
 
 使用 `provide` ([稍后](#provide-inject)会讨论) 时，也应考虑作为 `globalProperties` 的替代品。
 
-[迁移构建开关：`GLOBAL_PROTOTYPE`](migration-build.html#兼容性配置)
+[迁移构建开关：`GLOBAL_PROTOTYPE`](../migration-build.html#兼容性配置)
 
 ### `Vue.extend` 移除
 
@@ -186,9 +186,9 @@ Vue.createApp(Profile).mount('#mount-point')
 
 #### 组件继承
 
-在 Vue 3 中，我们强烈建议使用 [组合式 API](/api/composition-api.html) 来替代继承与 mixin。如果因为某种原因仍然需要使用组件继承，你可以使用 [`extends` 选项](/api/options-composition.html#extends) 来代替 `Vue.extend`。
+在 Vue 3 中，我们强烈建议使用 [组合式 API](https://cn.vuejs.org/api/composition-api.html) 来替代继承与 mixin。如果因为某种原因仍然需要使用组件继承，你可以使用 [`extends` 选项](https://cn.vuejs.org/api/options-composition.html#extends) 来代替 `Vue.extend`。
 
-[迁移构建开关：`GLOBAL_EXTEND`](migration-build.html#兼容性配置)
+[迁移构建开关：`GLOBAL_EXTEND`](../migration-build.html#兼容性配置)
 
 ### 插件开发者须知
 
@@ -243,7 +243,7 @@ app.directive('focus', {
 app.mount('#app')
 ```
 
-[迁移构建开关：`GLOBAL_MOUNT`](migration-build.html#兼容性配置)
+[迁移构建开关：`GLOBAL_MOUNT`](../migration-build.html#兼容性配置)
 
 ## Provide / Inject
 
diff --git a/src/zh/breaking-changes/index.md b/src/zh/breaking-changes/index.md
index 67d1e8d..af41145 100644
--- a/src/zh/breaking-changes/index.md
+++ b/src/zh/breaking-changes/index.md
@@ -4,4 +4,68 @@
 
 虽然 Vue 看起来已经发生了很多变化，但您所了解和喜爱的 Vue 的很多东西仍然没有变；但我们希望尽可能完整的为每个记录的更改提供详细的解释和示例。
 
-<!-- TODO -->
\ No newline at end of file
+
+## 详情说明
+
+### 全局API
+
+- [全局 Vue API 更改为使用应用程序实例](./global-api.html)
+- [全局和内部 API 都经过了重构，现已支持 TreeShaking （摇树优化）](./global-api-treeshaking.html)
+
+
+
+### 模板指令
+
+- [`v-model` 指令在组件上的使用已经被重新设计，替换掉了  `v-bind.sync`](./v-model.html)
+- [在`<template v-for>`  和没有 `v-for` 的节点身上使用 `key` 发生了变化 ](./key-attribute.html)
+- [`v-if` and `v-for` 在同一个元素身上使用时的优先级发生了变化](./v-if-v-for.html)
+- [`v-bind="object"` 现在是顺序敏感的](./v-bind.html)
+- [`v-on:event.native` 事件修饰符已经被移除](./v-on-native-modifier-removed)
+
+
+
+### 组件
+
+- [函数式组件只能通过纯函数进行创建](./functional-components.html)
+- [单文件组件 (SFC) `<template>` 标签的  `functional` attribute 和函数式组件的 `functional` 选项已被移除](./functional-components.html)
+- [异步组件现在需要通过 `defineAsyncComponent` 方法进行创建](./async-components.html)
+- [组件事件现在应该使用 `emits` 选项进行声明](./emits-option.html)
+
+### 渲染函数
+
+- [渲染函数 API 更改](./render-function-api.html)
+- [`$scopedSlots` property 已移除，所有插槽都通过 `$slots` 作为函数暴露](./slots-unification.html)
+- [`$listeners` 被移除或整合到 `$attrs`](./listeners-removed)
+- [`$attrs` 现在包含 `class` 和 `style` attribute](./attrs-includes-class-style.md)
+
+### 自定义元素
+
+- [自定义元素检测现在在模板编译时执行](./custom-elements-interop.html)
+- [特殊的 `is` attribute 的使用被严格限制在被保留的 `<component>` 标签中](./custom-elements-interop.html#定制内置元素)
+
+### 其他小改变
+
+- `destroyed` 生命周期选项被重命名为 `unmounted`
+- `beforeDestroy` 生命周期选项被重命名为 `beforeUnmount`
+- [`default` prop 工厂函数不再可以访问 `this` 上下文](./props-default-this.html)
+- [自定义指令的 API 已更改为与组件生命周期一致，且 `binding.expression` 已移除](./custom-directives.html)
+- [`data` 选项应始终被声明为一个函数](./data-option.html)
+- [来自 mixin 的 `data` 选项现在为浅合并](./data-option.html#mixin-合并行为变更)
+- [Attribute 强制策略已更改](./attribute-coercion.html)
+- [一些过渡的 class 被重命名](./transition.html)
+- [`<TransitionGroup>` 不再默认渲染包裹元素](./transition-group.html)
+- [当侦听一个数组时，只有当数组被替换时，回调才会触发，如果需要在变更时触发，则必须指定 `deep` 选项](./watch.html)
+- 没有特殊指令的标记 (`v-if/else-if/else`、`v-for` 或 `v-slot`) 的 `<template>` 现在被视为普通元素，并将渲染为原生的 `<template>` 元素，而不是渲染其内部内容。
+- [已挂载的应用不会取代它所挂载的元素](./mount-changes.html)
+- [生命周期的 `hook:` 事件前缀改为 `vue:`](./vnode-lifecycle-events.html)
+
+### 被移除的 API
+
+- [`keyCode` 作为 `v-on` 修饰符的支持](./keycode-modifiers.html)
+- [$on、$off 和 $once 实例方法](./events-api.html)
+- [过滤器 (filter)](./filters.html)
+- [内联模板 attribute](./inline-template-attribute.html)
+- [`$children` 实例 property](./children.html)
+- [`propsData` 选项](./props-data.html)
+- `$destroy` 实例方法。用户不应再手动管理单个 Vue 组件的生命周期。
+- 全局函数 `set` 和 `delete` 以及实例方法 `$set` 和 `$delete`。基于代理的变化检测已经不再需要它们了。
diff --git a/src/zh/breaking-changes/inline-template-attribute.md b/src/zh/breaking-changes/inline-template-attribute.md
index 27a4c34..5692de5 100644
--- a/src/zh/breaking-changes/inline-template-attribute.md
+++ b/src/zh/breaking-changes/inline-template-attribute.md
@@ -30,7 +30,7 @@ badges:
 
 `inline-template` 的大多数用例都假设是在没有构建工具的环境中，也就是所有模板都直接写在 HTML 页面中。
 
-[迁移构建开关：`COMPILER_INLINE_TEMPLATE`](migration-build.html#兼容性配置)
+[迁移构建开关：`COMPILER_INLINE_TEMPLATE`](../migration-build.html#兼容性配置)
 
 ### 选项 #1：使用 `<script>` 标签
 
@@ -81,4 +81,4 @@ const MyComp = {
 </template>
 ```
 
-> - 提示：在 3.x 中，由于原生[片段](/guide/migration/fragments)的支持，插槽也可以渲染为根节点！
+> - 提示：在 3.x 中，由于原生[片段](../new/fragments)的支持，插槽也可以渲染为根节点！
diff --git a/src/zh/breaking-changes/introduction.md b/src/zh/breaking-changes/introduction.md
index 2e090db..104ecb6 100644
--- a/src/zh/breaking-changes/introduction.md
+++ b/src/zh/breaking-changes/introduction.md
@@ -149,9 +149,9 @@ Vue 3 中一些需要关注的新功能包括：
 
 <a href="https://www.npmjs.com/package/vue-router/v/next" target="_blank" noopener noreferrer><img src="https://img.shields.io/npm/v/vue-router/next.svg"></a>
 
-Vue Router 4.0 提供了 Vue 3 支持，并有许多非兼容的变更，详情见[迁移指南](https://next.router.vuejs.org/guide/migration/)。
+Vue Router 4.0 提供了 Vue 3 支持，并有许多非兼容的变更，详情见[迁移指南](https://router.vuejs.org/zh/guide/migration/)。
 
-- [文档](https://next.router.vuejs.org/)
+- [文档](https://router.vuejs.org/zh/)
 - [Github](https://github.com/vuejs/vue-router-next)
 - [RFCs](https://github.com/vuejs/rfcs/pulls?q=is%3Apr+is%3Amerged+label%3Arouter)
 
@@ -161,7 +161,7 @@ Vue Router 4.0 提供了 Vue 3 支持，并有许多非兼容的变更，详情
 
 Vuex 4.0 提供了 Vue 3 支持，其 API 与 3.x 基本相同。唯一的非兼容变更是[插件的安装方式](https://next.vuex.vuejs.org/guide/migrating-to-4-0-from-3-x.html#breaking-changes)。
 
-- [文档](https://next.vuex.vuejs.org/)
+- [文档](https://vuex.vuejs.org/zh/)
 - [Github](https://github.com/vuejs/vuex/tree/4.0)
 
 ### Devtools 扩展
diff --git a/src/zh/breaking-changes/key-attribute.md b/src/zh/breaking-changes/key-attribute.md
index 4b0b679..b05f0de 100644
--- a/src/zh/breaking-changes/key-attribute.md
+++ b/src/zh/breaking-changes/key-attribute.md
@@ -15,8 +15,8 @@ badges:
 
 特殊的 `key` attribute 被作为 Vue 的虚拟 DOM 算法的提示，以保持对节点身份的持续跟踪。这样 Vue 就可以知道何时能够重用和修补现有节点，以及何时需要对它们重新排序或重新创建。关于其它更多信息，可以查看以下章节：
 
-- [列表渲染：维护状态](/guide/list.html#%E7%BB%B4%E6%8A%A4%E7%8A%B6%E6%80%81)
-- [API 参考：特殊的 `key` attribute](/api/special-attributes.html#key)
+- [列表渲染：维护状态](https://cn.vuejs.org/guide/essentials/list.html#maintaining-state-with-key)
+- [API 参考：特殊的 `key` attribute](https://cn.vuejs.org/api/built-in-special-attributes.html#key)
 
 ## 在条件分支中
 
diff --git a/src/zh/breaking-changes/keycode-modifiers.md b/src/zh/breaking-changes/keycode-modifiers.md
index c8d927d..c3f3069 100644
--- a/src/zh/breaking-changes/keycode-modifiers.md
+++ b/src/zh/breaking-changes/keycode-modifiers.md
@@ -66,7 +66,7 @@ Vue.config.keyCodes = {
 
 语法的限制导致某些特定字符无法被匹配，比如 `"`、`'`、`/`、`=`、`>` 和 `.`。对于这些字符，你应该在监听器内使用 `event.key` 代替。
 
-[迁移构建开关：](migration-build.html#兼容性配置)
+[迁移构建开关：](../migration-build.html#兼容性配置)
 
 - `CONFIG_KEY_CODES`
 - `V_ON_KEYCODE_MODIFIER`
diff --git a/src/zh/breaking-changes/listeners-removed.md b/src/zh/breaking-changes/listeners-removed.md
index c18b03c..99d0a38 100644
--- a/src/zh/breaking-changes/listeners-removed.md
+++ b/src/zh/breaking-changes/listeners-removed.md
@@ -64,7 +64,7 @@ export default {
 
 删除所有的 `$listeners` 用法。
 
-[迁移构建开关：`INSTANCE_LISTENERS`](migration-build.html#兼容性配置)
+[迁移构建开关：`INSTANCE_LISTENERS`](../migration-build.html#兼容性配置)
 
 ## 参考
 
diff --git a/src/zh/breaking-changes/mount-changes.md b/src/zh/breaking-changes/mount-changes.md
index 1a9d2df..4ecc853 100644
--- a/src/zh/breaking-changes/mount-changes.md
+++ b/src/zh/breaking-changes/mount-changes.md
@@ -91,8 +91,8 @@ app.mount('#app')
 
 ## 迁移策略
 
-[迁移构建开关：`GLOBAL_MOUNT_CONTAINER`](migration-build.html#兼容性配置)
+[迁移构建开关：`GLOBAL_MOUNT_CONTAINER`](../migration-build.html#兼容性配置)
 
 ## 参考
 
-- [`mount` API](/api/application-api.html#mount)
+- [`mount` API](https://cn.vuejs.org/api/application.html#app-mount)
diff --git a/src/zh/breaking-changes/props-data.md b/src/zh/breaking-changes/props-data.md
index 46df038..5265f96 100644
--- a/src/zh/breaking-changes/props-data.md
+++ b/src/zh/breaking-changes/props-data.md
@@ -7,7 +7,7 @@ badges:
 
 ## 概述
 
-`propsData` 选项之前用于在创建 Vue 实例的过程中传入 prop，现在它被移除了。如果想为 Vue 3 应用的根组件传入 prop，请使用 [createApp](/api/global-api.html#createapp) 的第二个参数。
+`propsData` 选项之前用于在创建 Vue 实例的过程中传入 prop，现在它被移除了。如果想为 Vue 3 应用的根组件传入 prop，请使用 [createApp](https://cn.vuejs.org/api/application.html#createapp) 的第二个参数。
 
 ## 2.x 语法
 
diff --git a/src/zh/breaking-changes/props-default-this.md b/src/zh/breaking-changes/props-default-this.md
index cdfb997..4655d79 100644
--- a/src/zh/breaking-changes/props-default-this.md
+++ b/src/zh/breaking-changes/props-default-this.md
@@ -12,7 +12,7 @@ badges:
 
 - 组件接收到的原始 prop 将作为参数传递给默认函数；
 
-- [inject](../composition-api-provide-inject.md) API 可以在默认函数中使用。
+- [inject](https://cn.vuejs.org/api/composition-api-dependency-injection.html#inject) API 可以在默认函数中使用。
 
 ```js
 import { inject } from 'vue'
@@ -33,4 +33,4 @@ export default {
 
 ## 迁移策略
 
-[迁移构建开关：`PROPS_DEFAULT_THIS`](migration-build.html#兼容性配置)
+[迁移构建开关：`PROPS_DEFAULT_THIS`](../migration-build.html#兼容性配置)
diff --git a/src/zh/breaking-changes/render-function-api.md b/src/zh/breaking-changes/render-function-api.md
index 83903f8..2cc699a 100644
--- a/src/zh/breaking-changes/render-function-api.md
+++ b/src/zh/breaking-changes/render-function-api.md
@@ -46,53 +46,6 @@ export default {
 }
 ```
 
-## 渲染函数签名更改
-
-### 2.x 语法
-
-在 2.x 中，`render` 函数自动接收参数，如 `h` 函数。
-
-```js
-// Vue 2 渲染函数示例
-export default {
-  render(h) {
-    return h('div')
-  }
-}
-```
-
-### 3.x 语法
-
-在 3.x 中，由于 `render` 函数不再接收任何参数，它将主要在 `setup()` 函数内部使用。这还有一个好处：可以访问在作用域中声明的响应式状态和函数，以及传递给 `setup()` 的参数。
-
-```js
-import { h, reactive } from 'vue'
-
-export default {
-  setup(props, { slots, attrs, emit }) {
-    const state = reactive({
-      count: 0
-    })
-
-    function increment() {
-      state.count++
-    }
-
-    // 返回渲染函数
-    return () =>
-      h(
-        'div',
-        {
-          onClick: increment
-        },
-        state.count
-      )
-  }
-}
-```
-
-有关 `setup()` 如何工作的详细信息，请参考[组合式 API 指南](/guide/composition-api-introduction.html)。
-
 ## VNode Prop 格式化
 
 ### 2.x 语法
@@ -178,7 +131,7 @@ export default {
 
 ## 迁移策略
 
-[迁移构建开关：`RENDER_FUNCTION`](migration-build.html#兼容性配置)
+[迁移构建开关：`RENDER_FUNCTION`](../migration-build.html#兼容性配置)
 
 ### 工具库作者
 
@@ -190,4 +143,4 @@ export default {
 
 ## 下一步
 
-详细文档请参考 [Render 函数指南](/guide/render-function)！
+详细文档请参考 [Render 函数指南](https://cn.vuejs.org/guide/extras/render-function.html)！
diff --git a/src/zh/breaking-changes/slots-unification.md b/src/zh/breaking-changes/slots-unification.md
index 27daa7b..56b31db 100644
--- a/src/zh/breaking-changes/slots-unification.md
+++ b/src/zh/breaking-changes/slots-unification.md
@@ -64,4 +64,4 @@ this.$slots.header()
 1. 在 3.x 中，将所有 `this.$scopedSlots` 替换为 `this.$slots`。
 2. 将所有 `this.$slots.mySlot` 替换为 `this.$slots.mySlot()`。
 
-[迁移构建开关：`INSTANCE_SCOPED_SLOTS`](migration-build.html#兼容性配置)
+[迁移构建开关：`INSTANCE_SCOPED_SLOTS`](../migration-build.html#兼容性配置)
diff --git a/src/zh/breaking-changes/suspense.md b/src/zh/breaking-changes/suspense.md
index 851c1be..c34f72b 100644
--- a/src/zh/breaking-changes/suspense.md
+++ b/src/zh/breaking-changes/suspense.md
@@ -81,7 +81,7 @@ export default {
 
 将 `<suspense>` 跟 [`<transition>`](/api/built-in-components.html#transition) 和 [`<keep-alive>`](/api/built-in-components.html#keep-alive) 组件相结合是常见的情形。这些组件的嵌套顺序对于它们的正确工作很重要。
 
-额外的，这些组件经常用于衔接 [Vue Router](https://next.router.vuejs.org/zh/) 的 `<router-view>` 组件。
+额外的，这些组件经常用于衔接 [Vue Router](https://router.vuejs.org/zh/) 的 `<router-view>` 组件。
 
 以下示例展示了如何嵌套这些组件以让它们的表现符合预期。若要简化这个组合你可以移除不需要的组件：
 
@@ -104,4 +104,4 @@ export default {
 </router-view>
 ```
 
-Vue Router 有内置的基于动态导入的[组件懒加载](https://next.router.vuejs.org/zh/guide/advanced/lazy-loading.html)支持。它和异步组件有所区别，并且当前不会触发 `<suspense>`。不过它们仍然可以包含异步组件作为后代，这样它们还是可以正常触发 `<suspense>`。
+Vue Router 有内置的基于动态导入的[组件懒加载](https://router.vuejs.org/zh/guide/advanced/lazy-loading.html)支持。它和异步组件有所区别，并且当前不会触发 `<suspense>`。不过它们仍然可以包含异步组件作为后代，这样它们还是可以正常触发 `<suspense>`。
diff --git a/src/zh/breaking-changes/transition-as-root.md b/src/zh/breaking-changes/transition-as-root.md
index f5ebe32..5e31eb3 100644
--- a/src/zh/breaking-changes/transition-as-root.md
+++ b/src/zh/breaking-changes/transition-as-root.md
@@ -57,5 +57,5 @@ export default {
 
 ## 参考
 
-- [一些过渡的 class 被重命名](/guide/migration/transition.html)
-- [`<TransitionGroup>` 不再默认渲染根元素](/guide/migration/transition-group.html)
+- [一些过渡的 class 被重命名](./transition.html)
+- [`<TransitionGroup>` 不再默认渲染根元素](./transition-group.html)
diff --git a/src/zh/breaking-changes/transition-group.md b/src/zh/breaking-changes/transition-group.md
index 2c0ae5e..48bc097 100644
--- a/src/zh/breaking-changes/transition-group.md
+++ b/src/zh/breaking-changes/transition-group.md
@@ -24,7 +24,7 @@ badges:
 
 ## 3.x 语法
 
-在 Vue 3 中，我们有了[片段的支持](/guide/migration/fragments.html)，因此组件不再*需要*根节点。所以，`<transition-group>` 不再默认渲染根节点。
+在 Vue 3 中，我们有了[片段的支持](../new/fragments.html)，因此组件不再*需要*根节点。所以，`<transition-group>` 不再默认渲染根节点。
 
 - 如果像上面的示例一样，已经在 Vue 2 代码中定义了 `tag` attribute，那么一切都会和之前一样
 - 如果没有定义 `tag` attribute，*而且*样式或其它行为依赖于 `<span>` 根元素的存在才能正常工作，那么只需将 `tag="span"` 添加到 `<transition-group>`：
@@ -37,9 +37,9 @@ badges:
 
 ## 迁移策略
 
-[迁移构建开关：`TRANSITION_GROUP_ROOT`](migration-build.html#兼容性配置)
+[迁移构建开关：`TRANSITION_GROUP_ROOT`](../migration-build.html#兼容性配置)
 
 ## 参考
 
-- [过渡的 class 名更改](/guide/migration/transition.html)
-- [`<Transition>` 作为根元素不再从外界被切换](/guide/migration/transition-as-root.html)
+- [过渡的 class 名更改](./transition.html)
+- [`<Transition>` 作为根元素不再从外界被切换](./transition-as-root.html)
diff --git a/src/zh/breaking-changes/transition.md b/src/zh/breaking-changes/transition.md
index c8ce596..c071c58 100644
--- a/src/zh/breaking-changes/transition.md
+++ b/src/zh/breaking-changes/transition.md
@@ -63,5 +63,5 @@ badges:
 
 ## 参考
 
-- [`<Transition>` 作为根元素不再能够从外界被切换](/guide/migration/transition-as-root.html)
-- [`<TransitionGroup>` 现在默认不渲染包裹器元素](/guide/migration/transition-group.html)
+- [`<Transition>` 作为根元素不再能够从外界被切换](./transition-as-root.html)
+- [`<TransitionGroup>` 现在默认不渲染包裹器元素](./transition-group.html)
diff --git a/src/zh/breaking-changes/v-bind.md b/src/zh/breaking-changes/v-bind.md
index 5831590..ef2ac90 100644
--- a/src/zh/breaking-changes/v-bind.md
+++ b/src/zh/breaking-changes/v-bind.md
@@ -45,4 +45,4 @@ badges:
 
 如果你依赖 `v-bind` 的覆盖功能，目前的建议是确保在独立 attribute 之前定义 `v-bind` attribute。
 
-[迁移构建开关：`COMPILER_V_BIND_OBJECT_ORDER`](migration-build.html#兼容性配置)
+[迁移构建开关：`COMPILER_V_BIND_OBJECT_ORDER`](../migration-build.html#兼容性配置)
diff --git a/src/zh/breaking-changes/v-if-v-for.md b/src/zh/breaking-changes/v-if-v-for.md
index da65487..b063468 100644
--- a/src/zh/breaking-changes/v-if-v-for.md
+++ b/src/zh/breaking-changes/v-if-v-for.md
@@ -28,9 +28,9 @@ Vue.js 中使用最多的两个指令就是 `v-if` 和 `v-for`，因此开发者
 
 比起在模板层面管理相关逻辑，更好的办法是通过创建计算属性筛选出列表，并以此创建可见元素。
 
-[迁移构建开关：`COMPILER_V_IF_V_FOR_PRECEDENCE`](migration-build.html#兼容性配置)
+[迁移构建开关：`COMPILER_V_IF_V_FOR_PRECEDENCE`](../migration-build.html#兼容性配置)
 
 ## 参考
 
-- [列表渲染 - #显示过滤-排序后的结果](/guide/list.html#显示过滤-排序后的结果)
-- [列表渲染 - `v-for` 与 `v-if` 一同使用](/guide/list.html#v-for-与-v-if-一同使用)
+- [列表渲染 - #显示过滤-排序后的结果](https://cn.vuejs.org/guide/essentials/list.html#displaying-filtered-sorted-results)
+- [列表渲染 - `v-for` 与 `v-if` 一同使用](https://cn.vuejs.org/guide/essentials/list.html#v-for-with-v-if)
diff --git a/src/zh/breaking-changes/v-model.md b/src/zh/breaking-changes/v-model.md
index 0a72c25..42c45a6 100644
--- a/src/zh/breaking-changes/v-model.md
+++ b/src/zh/breaking-changes/v-model.md
@@ -144,7 +144,7 @@ this.$emit('update:title', newValue)
 <ChildComponent v-model.capitalize="pageTitle" />
 ```
 
-我们可以在 [Custom Events](../component-custom-events.html#处理-v-model-修饰符) 部分中了解有关自定义 `v-model` 修饰符的更多信息。
+我们可以在 [Custom Events](http://cn.vuejs.org/guide/components/events.html#usage-with-v-model) 部分中了解有关自定义 `v-model` 修饰符的更多信息。
 
 ## 迁移策略
 
@@ -182,7 +182,7 @@ this.$emit('update:title', newValue)
   }
   ```
 
-[迁移构建开关：](migration-build.html#兼容性配置)
+[迁移构建开关：](../migration-build.html#兼容性配置)
 
 - `COMPONENT_V_MODEL`
 - `COMPILER_V_BIND_SYNC`
@@ -191,6 +191,6 @@ this.$emit('update:title', newValue)
 
 更多新的 `v-model` 语法相关信息，请参考：
 
-- [在组件中使用 `v-model`](../component-basics.html#在组件上使用-v-model) 
-- [`v-model` 参数](../component-custom-events.html#v-model-参数)
-- [处理 `v-model` 修饰符](../component-custom-events.html#处理-v-model-修饰符)
+- [在组件中使用 `v-model`](https://cn.vuejs.org/guide/components/events.html#usage-with-v-model) 
+- [`v-model` 参数](https://cn.vuejs.org/guide/components/events.html#v-model-arguments)
+- [处理 `v-model` 修饰符](https://cn.vuejs.org/guide/components/events.html#usage-with-v-model)
diff --git a/src/zh/breaking-changes/v-on-native-modifier-removed.md b/src/zh/breaking-changes/v-on-native-modifier-removed.md
index cb51591..00a2746 100644
--- a/src/zh/breaking-changes/v-on-native-modifier-removed.md
+++ b/src/zh/breaking-changes/v-on-native-modifier-removed.md
@@ -49,7 +49,7 @@ badges:
 - 删除 `.native` 修饰符的所有实例。
 - 确保所有组件都使用 `emits` 选项记录其事件。
 
-[迁移构建开关：`COMPILER_V_ON_NATIVE`](migration-build.html#兼容性配置)
+[迁移构建开关：`COMPILER_V_ON_NATIVE`](../migration-build.html#兼容性配置)
 
 ## 参考
 
diff --git a/src/zh/breaking-changes/vnode-lifecycle-events.md b/src/zh/breaking-changes/vnode-lifecycle-events.md
index a3a4054..61c4232 100644
--- a/src/zh/breaking-changes/vnode-lifecycle-events.md
+++ b/src/zh/breaking-changes/vnode-lifecycle-events.md
@@ -9,7 +9,7 @@ badges:
 
 在 Vue 2 中，我们可以通过事件来监听组件生命周期中的关键阶段。这些事件名都是以 `hook:` 前缀开头，并跟随相应的生命周期钩子的名字。
 
-在 Vue 3 中，这个前缀已被更改为 `vnode-`。额外地，这些事件现在也可用于 HTML 元素，和在组件上的用法一样。
+在 Vue 3 中，这个前缀已被更改为 `vue:`。额外地，这些事件现在也可用于 HTML 元素，和在组件上的用法一样。
 
 ## 2.x 语法
 
@@ -23,19 +23,11 @@ badges:
 
 ## 3.x 语法
 
-在 Vue 3 中，事件名附带的是 `vnode-` 前缀：
+在 Vue 3 中，事件名附带的是 `vue:` 前缀：
 
 ```html
 <template>
-  <child-component @vnode-updated="onUpdated">
-</template>
-```
-
-或者在驼峰命名法的情况下附带前缀 `vnode`：
-
-```html
-<template>
-  <child-component @vnodeUpdated="onUpdated">
+  <child-component @vue:updated="onUpdated">
 </template>
 ```
 
@@ -43,8 +35,8 @@ badges:
 
 绝大多数情况下只需要修改前缀。生命周期钩子 `beforeDestroy` 和 `destroyed` 已经分别被重命名为 `beforeUnmount` 和 `unmounted`，所以相应的事件名也需要更新。
 
-[迁移构建开关：`INSTANCE_EVENT_HOOKS`](migration-build.html#兼容性配置)
+[迁移构建开关：`INSTANCE_EVENT_HOOKS`](../migration-build.html#兼容性配置)
 
 ## 参考
 
-- [迁移指南：事件 API](/guide/migration/events-api.html)
+- [迁移指南：事件 API](./events-api.html)
diff --git a/src/zh/breaking-changes/watch.md b/src/zh/breaking-changes/watch.md
index fa25309..5957f35 100644
--- a/src/zh/breaking-changes/watch.md
+++ b/src/zh/breaking-changes/watch.md
@@ -12,7 +12,7 @@ badges:
 
 ## 3.x 语法
 
-当使用 [`watch` 选项](/api/options-data.html#watch)侦听数组时，只有在数组被替换时才会触发回调。换句话说，在数组被改变时侦听回调将不再被触发。要想在数组被改变时触发侦听回调，必须指定 `deep` 选项。
+当使用 [`watch` 选项](https://cn.vuejs.org/api/options-state.html#watch)侦听数组时，只有在数组被替换时才会触发回调。换句话说，在数组被改变时侦听回调将不再被触发。要想在数组被改变时触发侦听回调，必须指定 `deep` 选项。
 
 ```js
 watch: {
@@ -29,4 +29,4 @@ watch: {
 
 如果你依赖于侦听数组的改变，添加 `deep` 选项以确保回调能被正确地触发。
 
-[迁移构建开关：`WATCH_ARRAY`](migration-build.html#兼容性配置)
+[迁移构建开关：`WATCH_ARRAY`](../migration-build.html#兼容性配置)
diff --git a/src/zh/index.md b/src/zh/index.md
index fc16ff3..8381554 100644
--- a/src/zh/index.md
+++ b/src/zh/index.md
@@ -1,6 +1,6 @@
 # Vue 3 迁移指南
 
-本指南主要针对有 Vue 2经验的用户，他们希望了解 Vue 2和 Vue 3之间的变化。**在使用 Vue 3之前，你不需要从头到尾阅读这篇文章**。学习 Vue 3的推荐方法是阅读[新的文档](https://cn.vuejs.org)。
+本指南主要针对有 Vue 2 经验的用户，他们希望了解 Vue 2 和 Vue 3 之间的变化。**在使用 Vue 3 之前，你不需要从头到尾阅读这篇文章**。学习 Vue 3 的推荐方法是阅读[新的文档](https://cn.vuejs.org)。
 
 <!-- VueMastery Start -->
 <style>
@@ -91,29 +91,29 @@
 
 ## 值得注意的新特性
 
-Vue 3中需要关注的一些新特性包括:
+Vue 3 中需要关注的一些新特性包括:
 
-- [组合式 API](https://vuejs.org/guide/extras/composition-api-faq.html)<span class="note">\*</span>
-- [单文件组件，组合式 API 语法糖 (`<script setup>`)](https://vuejs.org/api/sfc-script-setup.html)<span class="note">\*</span>
-- [Teleport 组件](https://vuejs.org/guide/built-ins/teleport.html)
-- [Fragments 片段](/new/fragments.html)
-- [Emits 组件选项](https://vuejs.org/api/options-state.html#emits)<span class="note">\*\*</span>
-- [`createRenderer` API from `@vue/runtime-core`](https://vuejs.org/api/custom-renderer.html) 用来创建自定义渲染函数
-- [单文件组件，状态绑定 CSS 变量(`v-bind` in `<style>`)](https://vuejs.org/api/sfc-css-features.html#v-bind-in-css)<span class="note">\*</span>
+- [组合式 API](https://cn.vuejs.org/guide/extras/composition-api-faq.html)<span class="note">\*</span>
+- [单文件组件，组合式 API 语法糖 (`<script setup>`)](https://cn.vuejs.org/api/sfc-script-setup.html)<span class="note">\*</span>
+- [Teleport 组件](https://cn.vuejs.org/guide/built-ins/teleport.html)
+- [Fragments 片段](./new/fragments.html)
+- [Emits 组件选项](https://cn.vuejs.org/api/options-state.html#emits)<span class="note">\*\*</span>
+- [`createRenderer` API from `@vue/runtime-core`](https://cn.vuejs.org/api/custom-renderer.html) 用来创建自定义渲染函数
+- [单文件组件，状态绑定 CSS 变量(`v-bind` in `<style>`)](https://cn.vuejs.org/api/sfc-css-features.html#v-bind-in-css)<span class="note">\*</span>
 - [SFC `<style scoped>` 新增全局规则和针对插槽内容规则](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0023-scoped-styles-changes.md)
-- [Suspense](https://vuejs.org/guide/built-ins/suspense.html) <sup class="warning">实验性</sup>
+- [Suspense](https://cn.vuejs.org/guide/built-ins/suspense.html) <sup class="warning">实验性</sup>
 
 <sub class="note"><b>\*</b> 现在也支持在 <a href="https://blog.vuejs.org/posts/vue-2-7-naruto.html" target="_blank">Vue 2.7</a></sub><br>
 <sub class="note"><b>\*\*</b> Vue 2.7 中支持, 但仅用于类型推断</sub>
 
 ## 非兼容性改变
 
-列出了Vue 2和Vue 3之间的非兼容性更改 [这里](/breaking-changes/)。
+列出了 Vue 2 和 Vue 3 之间的非兼容性更改 [这里](./breaking-changes/)。
 
 ## 新的框架级别推荐
 
-列出了新的框架级建议 [这里](/recommendations)。
+列出了新的框架级建议 [这里](./recommendations)。
 
 ## 迁移构建
 
-如果您有一个现有的Vue 2项目或库，并打算将其升级到 Vue 3，我们将提供一个 Vue 3的构建版本，它提供与 Vue 2兼容的 api。查看 [迁移构建](/migration-build) 页面了解更多细节。
\ No newline at end of file
+如果您有一个现有的 Vue 2 项目或库，并打算将其升级到 Vue 3，我们将提供一个 Vue 3 的构建版本，它提供与 Vue 2 兼容的 api。查看 [迁移构建](./migration-build) 页面了解更多细节。
\ No newline at end of file
diff --git a/src/zh/migration-build.md b/src/zh/migration-build.md
index 69ec6a7..f813cd0 100644
--- a/src/zh/migration-build.md
+++ b/src/zh/migration-build.md
@@ -163,6 +163,8 @@
      const Vue: CompatVue
      export default Vue
      export * from '@vue/runtime-dom'
+     const { configureCompat } = Vue
+     export { configureCompat }
    }
    ```
 
@@ -182,21 +184,21 @@
 
    - 如果你使用了 `vue-router`，请注意在升级至 `vue-router` v4 之前，`<transition>` 和 `<keep-alive>` 无法和 `<router-view>` 一起工作。
 
-7. 升级 [`<transition>` 类名](/guide/migration/transition.html)。这是唯一没有运行时警告的特性。你可以在整个项目范围内做一次 `.*-enter` 和 `.*-leave` CSS 类名的搜索。
+7. 升级 [`<transition>` 类名](./breaking-changes/transition.html)。这是唯一没有运行时警告的特性。你可以在整个项目范围内做一次 `.*-enter` 和 `.*-leave` CSS 类名的搜索。
 
    [示例提交](https://github.com/vuejs/vue-hackernews-2.0/commit/d300103ba622ae26ac26a82cd688e0f70b6c1d8f)
 
-8. 更新应用的入口以使用[新的全局挂载 API](https://v3.cn.vuejs.org/guide/migration/global-api.html#一个新的全局-api-createapp)。
+8. 更新应用的入口以使用[新的全局挂载 API](https://v3.cn.vuejs.org/zh/breaking-changes/global-api.html#一个新的全局-api-createapp)。
 
    [示例提交](https://github.com/vuejs/vue-hackernews-2.0/commit/a6e0c9ac7b1f4131908a4b1e43641f608593f714)
 
-9. [将 `vuex` 升级至 v4](https://next.vuex.vuejs.org/zh/guide/migrating-to-4-0-from-3-x.html)。
+9. [将 `vuex` 升级至 v4](https://vuex.vuejs.org/zh/guide/migrating-to-4-0-from-3-x.html)。
 
    [示例提交](https://github.com/vuejs/vue-hackernews-2.0/commit/5bfd4c61ee50f358cd5daebaa584f2c3f91e0205)
 
-10. [将 `vue-router` 升级至 v4](https://next.router.vuejs.org/zh/guide/migration/index.html)。如果你还使用了 `vuex-router-sync`，可以同时将其替换为一个 store getter。
+10. [将 `vue-router` 升级至 v4](https://router.vuejs.org/zh/guide/migration/index.html)。如果你还使用了 `vuex-router-sync`，可以同时将其替换为一个 store getter。
 
-    升级过后，同 `<router-view>` 一起使用 `<transition>` 和 `<keep-alive>` 就要求使用新的[基于作用域插槽的语法](https://next.router.vuejs.org/zh/guide/migration/index.html#router-view-、-keep-alive-和-transition)。
+    升级过后，同 `<router-view>` 一起使用 `<transition>` 和 `<keep-alive>` 就要求使用新的[基于作用域插槽的语法](https://router.vuejs.org/zh/guide/migration/index.html#router-view-、-keep-alive-和-transition)。
 
     [示例提交](https://github.com/vuejs/vue-hackernews-2.0/commit/758961e73ac4089890079d4ce14996741cf9344b)
 
@@ -270,72 +272,72 @@ export default {
 
 | ID | 类型 | 描述 | 文档 |
 | ---- | ---- | ---- | ---- |
-| GLOBAL_MOUNT_CONTAINER                | ⨂    | 被挂载的应用不会替换被挂载到的元素 | [链接](/guide/migration/mount-changes.html)                                                    |
+| GLOBAL_MOUNT_CONTAINER                | ⨂    | 被挂载的应用不会替换被挂载到的元素 | [链接](./breaking-changes/mount-changes.html)                                                    |
 | CONFIG_DEVTOOLS                       | ⨂    | 生产环境开发者工具现在是一个构建时的开关 | [链接](https://github.com/vuejs/vue-next/tree/master/packages/vue#bundler-build-feature-flags) |
-| COMPILER_V_IF_V_FOR_PRECEDENCE        | ⨂    | `v-if` 和 `v-for` 用在相同的元素上时的处理顺序发生了改变 | [链接](/guide/migration/v-if-v-for.html)                                                       |
-| COMPILER_V_IF_SAME_KEY                | ⨂    | `v-if` 分支不能再拥有相同的 key | [链接](/guide/migration/key-attribute.html#on-conditional-branches)                            |
-| COMPILER_V_FOR_TEMPLATE_KEY_PLACEMENT | ⨂    | `<template v-for>` key 现在应该被放在 `<template>` 上 | [链接](/guide/migration/key-attribute.html#with-template-v-for)                                |
-| COMPILER_SFC_FUNCTIONAL               | ⨂    | 单文件组件中不再支持 `<template functional>` | [链接](/guide/migration/functional-components.html#single-file-components-sfcs)                |
+| COMPILER_V_IF_V_FOR_PRECEDENCE        | ⨂    | `v-if` 和 `v-for` 用在相同的元素上时的处理顺序发生了改变 | [链接](./breaking-changes/v-if-v-for.html)                                                       |
+| COMPILER_V_IF_SAME_KEY                | ⨂    | `v-if` 分支不能再拥有相同的 key | [链接](./breaking-changes/key-attribute.html#on-conditional-branches)                            |
+| COMPILER_V_FOR_TEMPLATE_KEY_PLACEMENT | ⨂    | `<template v-for>` key 现在应该被放在 `<template>` 上 | [链接](./breaking-changes/key-attribute.html#with-template-v-for)                                |
+| COMPILER_SFC_FUNCTIONAL               | ⨂    | 单文件组件中不再支持 `<template functional>` | [链接](./breaking-changes/functional-components.html#single-file-components-sfcs)                |
 
 ### 部分兼容且附带注意事项
 
 | ID | 类型 | 描述 | 文档 |
 | ---- | ---- | ---- | ---- |
-| CONFIG_IGNORED_ELEMENTS  | ◐    | `config.ignoredElements` 现在改为了 `config.compilerOptions.isCustomElement` (只在浏览器编译器构建版本中)。如果使用了构建设置，`isCustomElement` 必须通过构建配置传入。 | [链接](/guide/migration/global-api.html#config-ignoredelements-替换为-config-iscustomelement) |
-| COMPILER_INLINE_TEMPLATE | ◐    | `inline-template` 被移除 (兼容模式只在浏览器编译器构建版本中支持) | [链接](/guide/migration/inline-template-attribute.html)                                                       |
-| PROPS_DEFAULT_THIS       | ◐    | prop 的默认工厂方法不再可以访问 `this` (在兼容模式下，`this` 不是一个真实的实例——它只暴露 prop、`$options` 和注入) | [链接](/guide/migration/props-default-this.html)                                                              |
+| CONFIG_IGNORED_ELEMENTS  | ◐    | `config.ignoredElements` 现在改为了 `config.compilerOptions.isCustomElement` (只在浏览器编译器构建版本中)。如果使用了构建设置，`isCustomElement` 必须通过构建配置传入。 | [链接](./breaking-changes/global-api.html#config-ignoredelements-替换为-config-iscustomelement) |
+| COMPILER_INLINE_TEMPLATE | ◐    | `inline-template` 被移除 (兼容模式只在浏览器编译器构建版本中支持) | [链接](./breaking-changes/inline-template-attribute.html)                                                       |
+| PROPS_DEFAULT_THIS       | ◐    | prop 的默认工厂方法不再可以访问 `this` (在兼容模式下，`this` 不是一个真实的实例——它只暴露 prop、`$options` 和注入) | [链接](./breaking-changes/props-default-this.html)                                                              |
 | INSTANCE_DESTROY         | ◐    | `$destroy` 实例方法被移除 (在兼容模式下，只在根实例下支持) | |
 | GLOBAL_PRIVATE_UTIL      | ◐    | `Vue.util` 是私有的，且不再可用 | |
-| CONFIG_PRODUCTION_TIP    | ◐    | 不再需要 `config.productionTip`  | [链接](/guide/migration/global-api.html#config-productiontip-移除) |
+| CONFIG_PRODUCTION_TIP    | ◐    | 不再需要 `config.productionTip`  | [链接](./breaking-changes/global-api.html#config-productiontip-移除) |
 | CONFIG_SILENT            | ◐    | `config.silent` 被移除 | |
 
 ### 仅兼容 (无告警)
 
 | ID | 类型 | 描述 | 文档 |
 | ---- | ---- | ---- | ---- |
-| TRANSITION_CLASSES | ⭘    | 过渡动画的进入/离开的 class 发生了变化 | [链接](/guide/migration/transition.html) |
+| TRANSITION_CLASSES | ⭘    | 过渡动画的进入/离开的 class 发生了变化 | [链接](./breaking-changes/transition.html) |
 
 ### 完全兼容
 
 | ID | 类型 | 描述 | 文档 |
 | ---- | ---- | ---- | ---- |
-| GLOBAL_MOUNT                 | ✔    | new Vue() -> createApp | [链接](/guide/migration/global-api.html#挂载-app-实例) |
-| GLOBAL_EXTEND                | ✔    | Vue.extend 被移除 (使用 `defineComponent` 或 `extends` 选项) | [链接](/guide/migration/global-api.html#vue-extend-移除) |
-| GLOBAL_PROTOTYPE             | ✔    | `Vue.prototype` -> `app.config.globalProperties` | [链接](/guide/migration/global-api.html#vue-prototype-替换为-config-globalproperties) |
+| GLOBAL_MOUNT                 | ✔    | new Vue() -> createApp | [链接](./breaking-changes/global-api.html#挂载-app-实例) |
+| GLOBAL_EXTEND                | ✔    | Vue.extend 被移除 (使用 `defineComponent` 或 `extends` 选项) | [链接](./breaking-changes/global-api.html#vue-extend-移除) |
+| GLOBAL_PROTOTYPE             | ✔    | `Vue.prototype` -> `app.config.globalProperties` | [链接](./breaking-changes/global-api.html#vue-prototype-替换为-config-globalproperties) |
 | GLOBAL_SET                   | ✔    | `Vue.set` 被移除 (不再需要) | |
 | GLOBAL_DELETE                | ✔    | `Vue.delete` 被移除 (不再需要) | |
-| GLOBAL_OBSERVABLE            | ✔    | `Vue.observable` 被移除 (使用 `reactive`) | [链接](/api/basic-reactivity.html) |
-| CONFIG_KEY_CODES             | ✔    | config.keyCodes 被移除 | [链接](/guide/migration/keycode-modifiers.html) |
+| GLOBAL_OBSERVABLE            | ✔    | `Vue.observable` 被移除 (使用 `reactive`) | [链接](https://cn.vuejs.org/api/reactivity-core.html#reactive) |
+| CONFIG_KEY_CODES             | ✔    | config.keyCodes 被移除 | [链接](./breaking-changes/keycode-modifiers.html) |
 | CONFIG_WHITESPACE            | ✔    | 在 Vue 3 中空格默认为 `"condense"` | |
 | INSTANCE_SET                 | ✔    | `vm.$set` 被移除 (不再需要) | |
 | INSTANCE_DELETE              | ✔    | `vm.$delete` 被移除 (不再需要) | |
-| INSTANCE_EVENT_EMITTER       | ✔    | `vm.$on`、`vm.$off`、`vm.$once` 被移除 | [链接](/guide/migration/events-api.html) |
-| INSTANCE_EVENT_HOOKS         | ✔    | 实例不再抛出 `hook:x` 事件 | [链接](/guide/migration/vnode-lifecycle-events.html) |
-| INSTANCE_CHILDREN            | ✔    | `vm.$children` 被移除 | [链接](/guide/migration/children.html) |
-| INSTANCE_LISTENERS           | ✔    | `vm.$listeners` 被移除 | [链接](/guide/migration/listeners-removed.html) |
-| INSTANCE_SCOPED_SLOTS        | ✔    | `vm.$scopedSlots` 被移除；`vm.$slots` 现在暴露函数 | [链接](/guide/migration/slots-unification.html) |
-| INSTANCE_ATTRS_CLASS_STYLE   | ✔    | `$attrs` 现在包含了 `class` 和 `style` | [链接](/guide/migration/attrs-includes-class-style.html) |
-| OPTIONS_DATA_FN              | ✔    | `data` 在所有情况下都必须是一个函数 | [链接](/guide/migration/data-option.html) |
-| OPTIONS_DATA_MERGE           | ✔    | 来自 mixin 或扩展的 `data` 现在都是浅合并 | [链接](/guide/migration/data-option.html) |
+| INSTANCE_EVENT_EMITTER       | ✔    | `vm.$on`、`vm.$off`、`vm.$once` 被移除 | [链接](./breaking-changes/events-api.html) |
+| INSTANCE_EVENT_HOOKS         | ✔    | 实例不再抛出 `hook:x` 事件 | [链接](./breaking-changes/vnode-lifecycle-events.html) |
+| INSTANCE_CHILDREN            | ✔    | `vm.$children` 被移除 | [链接](./breaking-changes/children.html) |
+| INSTANCE_LISTENERS           | ✔    | `vm.$listeners` 被移除 | [链接](./breaking-changes/listeners-removed.html) |
+| INSTANCE_SCOPED_SLOTS        | ✔    | `vm.$scopedSlots` 被移除；`vm.$slots` 现在暴露函数 | [链接](./breaking-changes/slots-unification.html) |
+| INSTANCE_ATTRS_CLASS_STYLE   | ✔    | `$attrs` 现在包含了 `class` 和 `style` | [链接](./breaking-changes/attrs-includes-class-style.html) |
+| OPTIONS_DATA_FN              | ✔    | `data` 在所有情况下都必须是一个函数 | [链接](./breaking-changes/data-option.html) |
+| OPTIONS_DATA_MERGE           | ✔    | 来自 mixin 或扩展的 `data` 现在都是浅合并 | [链接](./breaking-changes/data-option.html) |
 | OPTIONS_BEFORE_DESTROY       | ✔    | `beforeDestroy` -> `beforeUnmount` | |
 | OPTIONS_DESTROYED            | ✔    | `destroyed` -> `unmounted` | |
-| WATCH_ARRAY                  | ✔    | 对于一个数组的操作，侦听无法被触发了，除非使用了深度侦听 | [链接](/guide/migration/watch.html) |
-| V_FOR_REF                    | ✔    | `v-for` 内的 `ref` 不再注册 ref 数组 | [链接](/guide/migration/array-refs.html) |
-| V_ON_KEYCODE_MODIFIER        | ✔    | `v-on` 不再支持 keyCode 修饰符 | [链接](/guide/migration/keycode-modifiers.html) |
-| CUSTOM_DIR                   | ✔    | 自定义指令钩子命名变化 | [链接](/guide/migration/custom-directives.html) |
-| ATTR_FALSE_VALUE             | ✔    | attribute 的绑定值为布尔值 `false` 时不再将其移除 | [链接](/guide/migration/attribute-coercion.html) |
-| ATTR_ENUMERATED_COERCION     | ✔    | 不再特殊处理枚举类型 attribute | [链接](/guide/migration/attribute-coercion.html) |
-| TRANSITION_GROUP_ROOT        | ✔    | `<transition-group>` 不再默认渲染一个根元素 | [链接](/guide/migration/transition-group.html) |
-| COMPONENT_ASYNC              | ✔    | 异步组件 API 改变 (现在需要 `defineAsyncComponent`) | [链接](/guide/migration/async-components.html) |
-| COMPONENT_FUNCTIONAL         | ✔    | 函数式组件 API 改变 (现在必须只是一个普通函数) | [链接](/guide/migration/functional-components.html) |
-| COMPONENT_V_MODEL            | ✔    | 组件的 v-model 修改 | [链接](/guide/migration/v-model.html) |
-| RENDER_FUNCTION              | ✔    | 渲染函数 API 更改 | [链接](/guide/migration/render-function-api.html) |
-| FILTERS                      | ✔    | 过滤器被移除 (该选项只会影响运行时的过滤器 API) | [链接](/guide/migration/filters.html) |
-| COMPILER_IS_ON_ELEMENT       | ✔    | `is` 的使用现在被严格限制在 `<component>` 上 | [链接](/guide/migration/custom-elements-interop.html) |
-| COMPILER_V_BIND_SYNC         | ✔    | `v-bind.sync` 被替换为带参数的 `v-model` | [链接](/guide/migration/v-model.html) |
+| WATCH_ARRAY                  | ✔    | 对于一个数组的操作，侦听无法被触发了，除非使用了深度侦听 | [链接](./breaking-changes/watch.html) |
+| V_FOR_REF                    | ✔    | `v-for` 内的 `ref` 不再注册 ref 数组 | [链接](./breaking-changes/array-refs.html) |
+| V_ON_KEYCODE_MODIFIER        | ✔    | `v-on` 不再支持 keyCode 修饰符 | [链接](./breaking-changes/keycode-modifiers.html) |
+| CUSTOM_DIR                   | ✔    | 自定义指令钩子命名变化 | [链接](./breaking-changes/custom-directives.html) |
+| ATTR_FALSE_VALUE             | ✔    | attribute 的绑定值为布尔值 `false` 时不再将其移除 | [链接](./breaking-changes/attribute-coercion.html) |
+| ATTR_ENUMERATED_COERCION     | ✔    | 不再特殊处理枚举类型 attribute | [链接](./breaking-changes/attribute-coercion.html) |
+| TRANSITION_GROUP_ROOT        | ✔    | `<transition-group>` 不再默认渲染一个根元素 | [链接](./breaking-changes/transition-group.html) |
+| COMPONENT_ASYNC              | ✔    | 异步组件 API 改变 (现在需要 `defineAsyncComponent`) | [链接](./breaking-changes/async-components.html) |
+| COMPONENT_FUNCTIONAL         | ✔    | 函数式组件 API 改变 (现在必须只是一个普通函数) | [链接](./breaking-changes/functional-components.html) |
+| COMPONENT_V_MODEL            | ✔    | 组件的 v-model 修改 | [链接](./breaking-changes/v-model.html) |
+| RENDER_FUNCTION              | ✔    | 渲染函数 API 更改 | [链接](./breaking-changes/render-function-api.html) |
+| FILTERS                      | ✔    | 过滤器被移除 (该选项只会影响运行时的过滤器 API) | [链接](./breaking-changes/filters.html) |
+| COMPILER_IS_ON_ELEMENT       | ✔    | `is` 的使用现在被严格限制在 `<component>` 上 | [链接](./breaking-changes/custom-elements-interop.html) |
+| COMPILER_V_BIND_SYNC         | ✔    | `v-bind.sync` 被替换为带参数的 `v-model` | [链接](./breaking-changes/v-model.html) |
 | COMPILER_V_BIND_PROP         | ✔    | `v-bind.prop` 修饰符被移除 | |
-| COMPILER_V_BIND_OBJECT_ORDER | ✔    | `v-bind="object"` 现在是顺序敏感的 | [链接](/guide/migration/v-bind.html) |
-| COMPILER_V_ON_NATIVE         | ✔    | `v-on.native` 修饰符被移除 | [链接](/guide/migration/v-on-native-modifier-removed.html) |
+| COMPILER_V_BIND_OBJECT_ORDER | ✔    | `v-bind="object"` 现在是顺序敏感的 | [链接](./breaking-changes/v-bind.html) |
+| COMPILER_V_ON_NATIVE         | ✔    | `v-on.native` 修饰符被移除 | [链接](./breaking-changes/v-on-native-modifier-removed.html) |
 | COMPILER_V_FOR_REF           | ✔    | `v-for` 中的 `ref` (编译器支持)) | |
 | COMPILER_NATIVE_TEMPLATE     | ✔    | 没有特殊指令的 `<template>` 现在会被渲染为原生元素 | |
 | COMPILER_FILTERS             | ✔    | 过滤器 (编译器支持) | |
diff --git a/src/zh/new/fragments.md b/src/zh/new/fragments.md
index a333b3d..e800a7f 100644
--- a/src/zh/new/fragments.md
+++ b/src/zh/new/fragments.md
@@ -37,4 +37,4 @@ Vue 3 现在正式支持了多根节点的组件，也就是片段！
 </template>
 ```
 
-有关 attribute 继承如何工作的详细信息，见[非 Prop 的 Attribute](/guide/component-attrs.html)。
+有关 attribute 继承如何工作的详细信息，见[透传 Attributes](https://cn.vuejs.org/guide/components/attrs.html#fallthrough-attributes)。
diff --git a/src/zh/recommendations.md b/src/zh/recommendations.md
index c25876a..101eeb6 100644
--- a/src/zh/recommendations.md
+++ b/src/zh/recommendations.md
@@ -6,11 +6,9 @@ Vue 3 的支持库进行了重大更新。以下是新的默认建议的摘要:
 - 构建工具: Vue CLI -> [Vite](https://vitejs.dev/)
 - 状态管理: Vuex -> [Pinia](https://pinia.vuejs.org/)
 - IDE 插件支持: Vetur -> [Volar](https://marketplace.visualstudio.com/items?itemName=johnsoncodehk.volar)
-- 新的 TypeScript 命令行工具: [vue-tsc](https://github.com/johnsoncodehk/volar/tree/master/packages/vue-tsc)
+- 新的 TypeScript 命令行工具: [vue-tsc](https://github.com/johnsoncodehk/volar/tree/master/vue-language-tools/vue-tsc)
 - 静态网站生成: VuePress -> [VitePress](https://vitepress.vuejs.org/)
-- JSX: `@vue/babel-preset-jsx` -> [`@vue/babel-plugin-jsx`](https://github.com/vuejs/jsx-next)
-
-<!-- TODO -->
+- JSX: `@vue/babel-preset-jsx` -> [`@vue/babel-plugin-jsx`](https://github.com/vuejs/babel-plugin-jsx)
 
 ## 详情说明
 
@@ -69,7 +67,7 @@ devtools 扩展已收到重大更新（作为 v6 发布）以同时支持 Vue 2
 
 ### TypeScript 支持
 
-您现在可以使用 [vue-tsc](https://github.com/johnsoncodehk/volar/tree/master/packages/vue-tsc) 从命令行对 Vue SFC 进行类型检查和生成定义文件。
+您现在可以使用 [vue-tsc](https://github.com/johnsoncodehk/volar/tree/master/vue-language-tools/vue-tsc) 从命令行对 Vue SFC 进行类型检查和生成定义文件。
 或者您也可以参阅 [新文档中的 TypeScript 指南](https://cn.vuejs.org/guide/typescript/overview.html)。