chore: upgrade lint toolchain (#6901)

* fix: build docs * fix: deps

chore: upgrade lint toolchain (#6901)
* fix: build docs * fix: deps
f4e09007 · Ryo · GitHub · dffae73d · f4e09007 · f4e09007
Commit f4e09007 authored May 09, 2026 by Ryo Committed by GitHub May 09, 2026
13 changed files
--- a/.github/workflows/build-docs.yml
+++ b/.github/workflows/build-docs.yml
@@ -109,6 +109,9 @@ jobs:
          username: ${{ secrets.FASTGPT_ALI_IMAGE_USER }}
          password: ${{ secrets.FASTGPT_ALI_IMAGE_PSW }}
+      - name: Prepare Docker workspace catalog
+        run: cp pnpm-workspace.yaml document/pnpm-workspace.yaml
      - name: Build and push Docker images (CN)
        if: matrix.domain_config.suffix == 'cn'
        uses: docker/build-push-action@v5

--- a/.github/workflows/preview-docs-build.yml
+++ b/.github/workflows/preview-docs-build.yml
@@ -28,6 +28,9 @@ jobs:
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3
+      - name: Prepare Docker workspace catalog
+        run: cp pnpm-workspace.yaml document/pnpm-workspace.yaml
      - name: Build Docker image (no push)
        uses: docker/build-push-action@v6
        with:

--- a/document/.textlintignore
+++ b/document/.textlintignore
+content/**/*.en.mdx
--- a/document/.textlintrc.json
+++ b/document/.textlintrc.json
+{
+  "plugins": ["mdx"],
+  "rules": {
+    "preset-zh-technical-writing": true
+  }
+}
--- a/document/content/self-host/upgrading/4-15/4150.mdx
+++ b/document/content/self-host/upgrading/4-15/4150.mdx
@@ -70,7 +70,8 @@ FILE_TOKEN_KEY=
 ## 代码优化
-1. 重新调整代码结构，升级 nextjs 最新版，切换至 turbopack 构建，提高构建速度；升级容器默认 node 至 24。
+1. 重新调整代码结构，升级 Next.js 最新版，切换至 Turbopack 构建，提高构建速度；升级容器默认 Node.js 至 24。
 2. 优化 Agent tool 声明和运行，统一所有 tool 的声明和运行方式。
 3. 文件上传内容从 system prompt 中放到 user message 中，提高 cache 命中率。
-4. 服务端 env 加载全部使用`@t3-oss/env-core`，增加更多类型检查。其余服务，也采用集中导出 env 的方式进行环境变量使用。
+4. 服务端 env 加载全部使用 `@t3-oss/env-core`，增加更多类型检查。其余服务，也采用集中导出 env 的方式进行环境变量使用。
+5. 升级了项目工程化工具链版本，包括 ESLint、Prettier、textlint 和 lint-staged 工具。
--- a/document/package.json
+++ b/document/package.json
@@ -8,7 +8,8 @@
    "dev": "next dev --turbo",
    "start": "next start",
    "postinstall": "fumadocs-mdx",
-    "format-doc": "pnpx zhlint --dir ./ *.mdx --fix",
+    "format-doc": "pnpm exec textlint --fix \"content/**/*.mdx\" && pnpm exec prettier --config ../.prettierrc.js --write \"**/*.mdx\" && pnpm exec textlint \"content/**/*.mdx\"",
+    "lint-doc:text": "pnpm exec textlint \"content/**/*.mdx\"",
    "initDocTime": "node ./script/initDocTime.js",
    "initDocToc": "node ./script/generateToc.js",
    "checkDocRefs": "node ./script/checkDocRefs.js",
@@ -47,8 +48,10 @@
    "@types/react-dom": "^19.1.6",
    "postcss": "^8.5.10",
    "tailwindcss": "^4.1.11",
+    "textlint": "catalog:lint",
+    "textlint-plugin-mdx": "catalog:lint",
+    "textlint-rule-preset-zh-technical-writing": "catalog:lint",
    "typescript": "^5.8.3",
-    "zhlint": "^0.8.2",
    "zod": "^4.0.5"
  }
 }
--- a/lint-staged.config.mjs
+++ b/lint-staged.config.mjs
@@ -3,6 +3,30 @@ import path from 'node:path';
 const quoteFiles = (files) =>
  files.map((file) => JSON.stringify(path.relative(process.cwd(), file))).join(' ');
+const toAbsolutePath = (file) => (path.isAbsolute(file) ? file : path.resolve(process.cwd(), file));
+const quoteDocumentFiles = (files) =>
+  files
+    .map((file) =>
+      JSON.stringify(path.relative(path.join(process.cwd(), 'document'), toAbsolutePath(file)))
+    )
+    .join(' ');
+const quoteDocumentArtifactPaths = () =>
+  [
+    'document/data/doc-last-modified.json',
+    'document/content/toc.mdx',
+    'document/content/toc.en.mdx'
+  ]
+    .map((file) => JSON.stringify(file))
+    .join(' ');
+const withoutTranslatedDocumentFiles = (files) =>
+  files.filter((file) => {
+    const documentPath = path.relative(path.join(process.cwd(), 'document'), toAbsolutePath(file));
+    return !/\.[a-z]{2}\.mdx$/.test(documentPath);
+  });
 const withoutIgnoredPaths = (files) =>
  files.filter((file) => {
    const relativePath = path.relative(process.cwd(), file);
@@ -17,17 +41,29 @@ const withoutIgnoredPaths = (files) =>
  });
 export default {
-  './document/**/**/*.mdx': (files) =>
+  './document/**/**/*.mdx': (files) => {
-    files.length === 0
+    if (files.length === 0) return [];
-      ? []
-      : [
+    const filenames = quoteDocumentFiles(files);
-        'pnpm -C ./document run format-doc',
+    const textlintFiles = withoutTranslatedDocumentFiles(files);
+    const textlintFilenames = quoteDocumentFiles(textlintFiles);
+    return [
+      ...(textlintFiles.length > 0
+        ? [`pnpm -C ./document exec textlint --fix ${textlintFilenames}`]
+        : []),
+      `pnpm -C ./document exec prettier --config ../.prettierrc.js --write ${filenames}`,
+      ...(textlintFiles.length > 0
+        ? [`pnpm -C ./document exec textlint ${textlintFilenames}`]
+        : []),
      'pnpm -C ./document run initDocTime',
      'pnpm -C ./document run initDocToc',
      'pnpm -C ./document run checkDocRefs',
      'pnpm -C ./document run removeInvalidImg',
-        'git add .'
+      `git add -- ${quoteDocumentArtifactPaths()}`,
-      ],
+      'git add -u -- document/public/imgs'
+    ];
+  },
  '**/*.{ts,tsx}': (files) => {
    const lintFiles = withoutIgnoredPaths(files);
    if (lintFiles.length === 0) return [];

--- a/package.json
+++ b/package.json
@@ -28,18 +28,18 @@
  "devDependencies": {
    "@chakra-ui/cli": "^2.4.1",
    "@vitest/coverage-v8": "catalog:",
-    "eslint": "catalog:eslint",
+    "eslint": "catalog:lint",
-    "eslint-config-next": "catalog:eslint",
+    "eslint-config-next": "catalog:lint",
    "husky": "^8.0.3",
    "i18next": "catalog:",
    "js-yaml": "catalog:",
-    "lint-staged": "catalog:",
+    "lint-staged": "catalog:lint",
    "mongodb-memory-server": "catalog:",
    "next-i18next": "catalog:",
-    "prettier": "catalog:",
+    "prettier": "catalog:lint",
    "react-i18next": "catalog:",
    "turbo": "2.9.9",
-    "typescript-eslint": "catalog:eslint",
+    "typescript-eslint": "catalog:lint",
    "typescript": "catalog:",
    "vitest": "catalog:"
  },

--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -50,7 +50,6 @@ catalog:
  js-yaml: ^4.1.1
  jsonwebtoken: ^9.0.3
  json5: ^2.2.3
-  lint-staged: ^16.4.0
  lodash: 4.17.23
  mime: ^4.1.0
  mime-types: 3.0.2
@@ -60,7 +59,6 @@ catalog:
  nanoid: ^5.1.3
  next: 16.2.4
  next-i18next: 15.4.2
-  prettier: 3.8.3
  proxy-addr: 2.0.7
  proxy-agent: ^6
  react: ^18
@@ -78,9 +76,14 @@ catalog:
  zod: ^4
 catalogs:
-  eslint:
+  lint:
    eslint: ^9
    eslint-config-next: 16.2.4
+    lint-staged: ^16.4.0
+    prettier: 3.8.3
+    textlint: 12.6.1
+    textlint-plugin-mdx: ^1.1.0
+    textlint-rule-preset-zh-technical-writing: ^0.0.3
    typescript-eslint: ^8
 onlyBuiltDependencies:

--- a/pro @ 26ee8980
+++ b/pro @ 26ee8980
-Subproject commit 958c6c7b27f6e3b8d04213b60e41d7ac75a605c7
+Subproject commit 26ee89803dc551ad77bd34ac8fdfd6103c1b626c
--- a/projects/app/package.json
+++ b/projects/app/package.json
@@ -113,11 +113,11 @@
    "@types/react": "catalog:",
    "@types/react-dom": "catalog:",
    "@types/react-syntax-highlighter": "^15.5.6",
-    "eslint": "catalog:eslint",
+    "eslint": "catalog:lint",
-    "eslint-config-next": "catalog:eslint",
+    "eslint-config-next": "catalog:lint",
    "tailwindcss": "^3",
    "tsx": "catalog:",
-    "typescript-eslint": "catalog:eslint",
+    "typescript-eslint": "catalog:lint",
    "typescript": "catalog:",
    "vitest": "catalog:"
  }

--- a/projects/marketplace/package.json
+++ b/projects/marketplace/package.json
@@ -38,8 +38,8 @@
    "@types/node": "catalog:",
    "@types/react": "catalog:",
    "@types/react-dom": "catalog:",
-    "eslint": "catalog:eslint",
+    "eslint": "catalog:lint",
-    "eslint-config-next": "catalog:eslint",
+    "eslint-config-next": "catalog:lint",
    "postcss": "^8",
    "tailwindcss": "^3.4.1",
    "typescript": "catalog:"