feat：项目初始化

LICENSE

+MIT License
+
+Copyright (c) 2021 Haixiang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

-# wecom-sidebar
+# wecom-sidebar-react-tpl
 
+企业微信侧边栏前端开发模板
+
+## 功能
+
+- [x] 一份 [企业侧边栏客户端](https://open.work.weixin.qq.com/api/doc/90001/90144/90545) 模板
+- [x] `wx.agentConfig`, `wx.config`, `wx.invoke` 函数封装
+- [x] 侧边栏重定向获取用户身份 `checkRedirect`，以及 JsSDK 的初始化步骤 `initSdk`
+- [x] Mock 侧边栏 JsSdk，**使其可以在浏览器上直接调试！**
+- [X] TS 支持
+- [x] React Router 的示例
+
+## 基础配置
+
+启动项目需要用到 `agentId` 和 `corpId`，需要创建 `src/_config.ts`（目前已隐藏），示例
+
+```ts
+// src/_config.ts
+
+const config = {
+  // 在 https://work.weixin.qq.com/wework_admin/frame#profile 这里可以找到
+  corpId: '你的企业ID',
+  // 在 https://work.weixin.qq.com/wework_admin/frame#apps 里的自建应用里可以找到
+  agentId: '自建应用的AgentId'
+}
+
+export default config
+```
+
+## 代理配置
+
+代理配置这里需要用到 [Whistle](https://wproxy.org/whistle/) 这个代理工具，请在 [这篇教程](https://wproxy.org/whistle/install.html) 里先安装 Whistle，
+然后再在 [这篇教程](http://wproxy.org/whistle/webui/https.html) 中正确安装 HTTPS 证书（用于代理 HTTPS 流量），两个步骤请一定要正确执行！
+
+然后在 whistle 中添加以下的代理配置，将后端路由传向本地
+
+```
+# 代理前端（侧边栏页面代理到本地的 3000 端口），这里要改为你自己配置H5的地址就好
+//service-xxx-yyy.gz.apigw.tencentcs.com http://127.0.0.1:3000
+
+# 代理后端（后端模板的 baseURL 该模板写死为 backend.com，这里代理到本地的 5000 端口）
+//backend.com http://127.0.0.1:5000
+```
+
+## Mock
+
+**此功能可以使得你在浏览器上直接调试侧边栏应用！**
+
+**在浏览器模式下，会 Mock `jsSdk`，默认回调为空函数，并打上对应日志。你也可以在 `src/mock.ts` 下可以添加对 `wx.fn` 和 `wx.invoke` 这些函数的 Mock 值以及 Mock 函数。**
+
+**如果你不想将 Mock 写死在项目上，你也可以利用 [Whistle 预先注入全局 JS](https://wproxy.org/whistle/rules/jsPrepend.html)，以此在全局注入对应的 Mock 值和回调函数。**
+
+Whistle 的 `Rules` 可以写成：
+
+```
+# 代理前端（侧边栏页面代理到本地的 3000 端口），这里要改为你自己配置H5的地址就好
+//service-xxx-yyy.gz.apigw.tencentcs.com http://127.0.0.1:3000
+
+# 代理后端（后端模板的 baseURL 该模板写死为 backend.com，这里代理到本地的 5000 端口）
+//backend.com http://127.0.0.1:5000
+
+# 全局注入 mock.js
+//service-xxx-yyy.gz.apigw.tencentcs.com  jsPrepend://{mock.js}
+```
+
+然后在 Whistle 页面的 `Values` (输入 http://127.0.0.1:8899/#values 可见) 中会自动生成一个 `mock.js`，再在里面添加如下代码：
+
+```js
+// Mock 当前用户 Id
+window.mockUserId = 'xxx'
+
+// 可在这里自由 mock wx.invoke 的内容
+window.invokeResMock = {
+  'getCurExternalContact': {
+    userId: 'xxxxx'
+  },
+}
+
+// 可在这里自由 wx.fn 的内容
+window.wxResMock = {
+  'agentConfig': () => {
+    console.log('mock agent config')
+  },
+}
+```
+
+这里对应的 Mock 关系 Mapper 有 `wxResMock` 和 `invokeResMock` 分别对 `wx.fn` 和 `wx.invoke('api', callback')` 两种调用方式进行 Mock。
+
+## 启动
+
+启动项目
+
+```bash
+npm run start
+```
+
+## 更多
+
+* 侧边栏的 Node 端开发模板（Express）可以看 [wecom-sidebar-express-tpl](https://github.com/wecom-sidebar/wecom-sidebar-express-tpl)
+* 侧边栏的微前端开发模式（Qiankun）可以看 [weccom-sidebar-qiankun-tpl](https://github.com/wecom-sidebar/wecom-sidebar-qiankun-tpl)

config/env.js

+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const paths = require('./paths');
+
+// Make sure that including paths.js after env.js will read .env variables.
+delete require.cache[require.resolve('./paths')];
+
+const NODE_ENV = process.env.NODE_ENV;
+if (!NODE_ENV) {
+  throw new Error(
+    'The NODE_ENV environment variable is required but was not specified.'
+  );
+}
+
+// https://github.com/bkeepers/dotenv#what-other-env-files-can-i-use
+const dotenvFiles = [
+  `${paths.dotenv}.${NODE_ENV}.local`,
+  // Don't include `.env.local` for `test` environment
+  // since normally you expect tests to produce the same
+  // results for everyone
+  NODE_ENV !== 'test' && `${paths.dotenv}.local`,
+  `${paths.dotenv}.${NODE_ENV}`,
+  paths.dotenv,
+].filter(Boolean);
+
+// Load environment variables from .env* files. Suppress warnings using silent
+// if this file is missing. dotenv will never modify any environment variables
+// that have already been set.  Variable expansion is supported in .env files.
+// https://github.com/motdotla/dotenv
+// https://github.com/motdotla/dotenv-expand
+dotenvFiles.forEach(dotenvFile => {
+  if (fs.existsSync(dotenvFile)) {
+    require('dotenv-expand')(
+      require('dotenv').config({
+        path: dotenvFile,
+      })
+    );
+  }
+});
+
+// We support resolving modules according to `NODE_PATH`.
+// This lets you use absolute paths in imports inside large monorepos:
+// https://github.com/facebook/create-react-app/issues/253.
+// It works similar to `NODE_PATH` in Node itself:
+// https://nodejs.org/api/modules.html#modules_loading_from_the_global_folders
+// Note that unlike in Node, only *relative* paths from `NODE_PATH` are honored.
+// Otherwise, we risk importing Node.js core modules into an app instead of webpack shims.
+// https://github.com/facebook/create-react-app/issues/1023#issuecomment-265344421
+// We also resolve them to make sure all tools using them work consistently.
+const appDirectory = fs.realpathSync(process.cwd());
+process.env.NODE_PATH = (process.env.NODE_PATH || '')
+  .split(path.delimiter)
+  .filter(folder => folder && !path.isAbsolute(folder))
+  .map(folder => path.resolve(appDirectory, folder))
+  .join(path.delimiter);
+
+// Grab NODE_ENV and REACT_APP_* environment variables and prepare them to be
+// injected into the application via DefinePlugin in webpack configuration.
+const REACT_APP = /^REACT_APP_/i;
+
+function getClientEnvironment(publicUrl) {
+  const raw = Object.keys(process.env)
+    .filter(key => REACT_APP.test(key))
+    .reduce(
+      (env, key) => {
+        env[key] = process.env[key];
+        return env;
+      },
+      {
+        // Useful for determining whether we’re running in production mode.
+        // Most importantly, it switches React into the correct mode.
+        NODE_ENV: process.env.NODE_ENV || 'development',
+        // Useful for resolving the correct path to static assets in `public`.
+        // For example, <img src={process.env.PUBLIC_URL + '/img/logo.png'} />.
+        // This should only be used as an escape hatch. Normally you would put
+        // images into the `src` and `import` them in code to get their paths.
+        PUBLIC_URL: publicUrl,
+        // We support configuring the sockjs pathname during development.
+        // These settings let a developer run multiple simultaneous projects.
+        // They are used as the connection `hostname`, `pathname` and `port`
+        // in webpackHotDevClient. They are used as the `sockHost`, `sockPath`
+        // and `sockPort` options in webpack-dev-server.
+        WDS_SOCKET_HOST: process.env.WDS_SOCKET_HOST,
+        WDS_SOCKET_PATH: process.env.WDS_SOCKET_PATH,
+        WDS_SOCKET_PORT: process.env.WDS_SOCKET_PORT,
+        // Whether or not react-refresh is enabled.
+        // react-refresh is not 100% stable at this time,
+        // which is why it's disabled by default.
+        // It is defined here so it is available in the webpackHotDevClient.
+        FAST_REFRESH: process.env.FAST_REFRESH !== 'false',
+      }
+    );
+  // Stringify all values so we can feed into webpack DefinePlugin
+  const stringified = {
+    'process.env': Object.keys(raw).reduce((env, key) => {
+      env[key] = JSON.stringify(raw[key]);
+      return env;
+    }, {}),
+  };
+
+  return { raw, stringified };
+}
+
+module.exports = getClientEnvironment;

config/getHttpsConfig.js

+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+const chalk = require('react-dev-utils/chalk');
+const paths = require('./paths');
+
+// Ensure the certificate and key provided are valid and if not
+// throw an easy to debug error
+function validateKeyAndCerts({ cert, key, keyFile, crtFile }) {
+  let encrypted;
+  try {
+    // publicEncrypt will throw an error with an invalid cert
+    encrypted = crypto.publicEncrypt(cert, Buffer.from('test'));
+  } catch (err) {
+    throw new Error(
+      `The certificate "${chalk.yellow(crtFile)}" is invalid.\n${err.message}`
+    );
+  }
+
+  try {
+    // privateDecrypt will throw an error with an invalid key
+    crypto.privateDecrypt(key, encrypted);
+  } catch (err) {
+    throw new Error(
+      `The certificate key "${chalk.yellow(keyFile)}" is invalid.\n${
+        err.message
+      }`
+    );
+  }
+}
+
+// Read file and throw an error if it doesn't exist
+function readEnvFile(file, type) {
+  if (!fs.existsSync(file)) {
+    throw new Error(
+      `You specified ${chalk.cyan(
+        type
+      )} in your env, but the file "${chalk.yellow(file)}" can't be found.`
+    );
+  }
+  return fs.readFileSync(file);
+}
+
+// Get the https config
+// Return cert files if provided in env, otherwise just true or false
+function getHttpsConfig() {
+  const { SSL_CRT_FILE, SSL_KEY_FILE, HTTPS } = process.env;
+  const isHttps = HTTPS === 'true';
+
+  if (isHttps && SSL_CRT_FILE && SSL_KEY_FILE) {
+    const crtFile = path.resolve(paths.appPath, SSL_CRT_FILE);
+    const keyFile = path.resolve(paths.appPath, SSL_KEY_FILE);
+    const config = {
+      cert: readEnvFile(crtFile, 'SSL_CRT_FILE'),
+      key: readEnvFile(keyFile, 'SSL_KEY_FILE'),
+    };
+
+    validateKeyAndCerts({ ...config, keyFile, crtFile });
+    return config;
+  }
+  return isHttps;
+}
+
+module.exports = getHttpsConfig;

config/jest/babelTransform.js

+'use strict';
+
+const babelJest = require('babel-jest');
+
+const hasJsxRuntime = (() => {
+  if (process.env.DISABLE_NEW_JSX_TRANSFORM === 'true') {
+    return false;
+  }
+
+  try {
+    require.resolve('react/jsx-runtime');
+    return true;
+  } catch (e) {
+    return false;
+  }
+})();
+
+module.exports = babelJest.createTransformer({
+  presets: [
+    [
+      require.resolve('babel-preset-react-app'),
+      {
+        runtime: hasJsxRuntime ? 'automatic' : 'classic',
+      },
+    ],
+  ],
+  babelrc: false,
+  configFile: false,
+});

config/jest/cssTransform.js

+'use strict';
+
+// This is a custom Jest transformer turning style imports into empty objects.
+// http://facebook.github.io/jest/docs/en/webpack.html
+
+module.exports = {
+  process() {
+    return 'module.exports = {};';
+  },
+  getCacheKey() {
+    // The output is always the same.
+    return 'cssTransform';
+  },
+};

config/jest/fileTransform.js

+'use strict';
+
+const path = require('path');
+const camelcase = require('camelcase');
+
+// This is a custom Jest transformer turning file imports into filenames.
+// http://facebook.github.io/jest/docs/en/webpack.html
+
+module.exports = {
+  process(src, filename) {
+    const assetFilename = JSON.stringify(path.basename(filename));
+
+    if (filename.match(/\.svg$/)) {
+      // Based on how SVGR generates a component name:
+      // https://github.com/smooth-code/svgr/blob/01b194cf967347d43d4cbe6b434404731b87cf27/packages/core/src/state.js#L6
+      const pascalCaseFilename = camelcase(path.parse(filename).name, {
+        pascalCase: true,
+      });
+      const componentName = `Svg${pascalCaseFilename}`;
+      return `const React = require('react');
+      module.exports = {
+        __esModule: true,
+        default: ${assetFilename},
+        ReactComponent: React.forwardRef(function ${componentName}(props, ref) {
+          return {
+            $$typeof: Symbol.for('react.element'),
+            type: 'svg',
+            ref: ref,
+            key: null,
+            props: Object.assign({}, props, {
+              children: ${assetFilename}
+            })
+          };
+        }),
+      };`;
+    }
+
+    return `module.exports = ${assetFilename};`;
+  },
+};

config/modules.js

+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const paths = require('./paths');
+const chalk = require('react-dev-utils/chalk');
+const resolve = require('resolve');
+
+/**
+ * Get additional module paths based on the baseUrl of a compilerOptions object.
+ *
+ * @param {Object} options
+ */
+function getAdditionalModulePaths(options = {}) {
+  const baseUrl = options.baseUrl;
+
+  if (!baseUrl) {
+    return '';
+  }
+
+  const baseUrlResolved = path.resolve(paths.appPath, baseUrl);
+
+  // We don't need to do anything if `baseUrl` is set to `node_modules`. This is
+  // the default behavior.
+  if (path.relative(paths.appNodeModules, baseUrlResolved) === '') {
+    return null;
+  }
+
+  // Allow the user set the `baseUrl` to `appSrc`.
+  if (path.relative(paths.appSrc, baseUrlResolved) === '') {
+    return [paths.appSrc];
+  }
+
+  // If the path is equal to the root directory we ignore it here.
+  // We don't want to allow importing from the root directly as source files are
+  // not transpiled outside of `src`. We do allow importing them with the
+  // absolute path (e.g. `src/Components/Button.js`) but we set that up with
+  // an alias.
+  if (path.relative(paths.appPath, baseUrlResolved) === '') {
+    return null;
+  }
+
+  // Otherwise, throw an error.
+  throw new Error(
+    chalk.red.bold(
+      "Your project's `baseUrl` can only be set to `src` or `node_modules`." +
+        ' Create React App does not support other values at this time.'
+    )
+  );
+}
+
+/**
+ * Get webpack aliases based on the baseUrl of a compilerOptions object.
+ *
+ * @param {*} options
+ */
+function getWebpackAliases(options = {}) {
+  const baseUrl = options.baseUrl;
+
+  if (!baseUrl) {
+    return {};
+  }
+
+  const baseUrlResolved = path.resolve(paths.appPath, baseUrl);
+
+  if (path.relative(paths.appPath, baseUrlResolved) === '') {
+    return {
+      src: paths.appSrc,
+    };
+  }
+}
+
+/**
+ * Get jest aliases based on the baseUrl of a compilerOptions object.
+ *
+ * @param {*} options
+ */
+function getJestAliases(options = {}) {
+  const baseUrl = options.baseUrl;
+
+  if (!baseUrl) {
+    return {};
+  }
+
+  const baseUrlResolved = path.resolve(paths.appPath, baseUrl);
+
+  if (path.relative(paths.appPath, baseUrlResolved) === '') {
+    return {
+      '^src/(.*)$': '<rootDir>/src/$1',
+    };
+  }
+}
+
+function getModules() {
+  // Check if TypeScript is setup
+  const hasTsConfig = fs.existsSync(paths.appTsConfig);
+  const hasJsConfig = fs.existsSync(paths.appJsConfig);
+
+  if (hasTsConfig && hasJsConfig) {
+    throw new Error(
+      'You have both a tsconfig.json and a jsconfig.json. If you are using TypeScript please remove your jsconfig.json file.'
+    );
+  }
+
+  let config;
+
+  // If there's a tsconfig.json we assume it's a
+  // TypeScript project and set up the config
+  // based on tsconfig.json
+  if (hasTsConfig) {
+    const ts = require(resolve.sync('typescript', {
+      basedir: paths.appNodeModules,
+    }));
+    config = ts.readConfigFile(paths.appTsConfig, ts.sys.readFile).config;
+    // Otherwise we'll check if there is jsconfig.json
+    // for non TS projects.
+  } else if (hasJsConfig) {
+    config = require(paths.appJsConfig);
+  }
+
+  config = config || {};
+  const options = config.compilerOptions || {};
+
+  const additionalModulePaths = getAdditionalModulePaths(options);
+
+  return {
+    additionalModulePaths: additionalModulePaths,
+    webpackAliases: getWebpackAliases(options),
+    jestAliases: getJestAliases(options),
+    hasTsConfig,
+  };
+}
+
+module.exports = getModules();

config/paths.js

+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+const getPublicUrlOrPath = require('react-dev-utils/getPublicUrlOrPath');
+
+// Make sure any symlinks in the project folder are resolved:
+// https://github.com/facebook/create-react-app/issues/637
+const appDirectory = fs.realpathSync(process.cwd());
+const resolveApp = relativePath => path.resolve(appDirectory, relativePath);
+
+// We use `PUBLIC_URL` environment variable or "homepage" field to infer
+// "public path" at which the app is served.
+// webpack needs to know it to put the right <script> hrefs into HTML even in
+// single-page apps that may serve index.html for nested URLs like /todos/42.
+// We can't use a relative path in HTML because we don't want to load something
+// like /todos/42/static/js/bundle.7289d.js. We have to know the root.
+const publicUrlOrPath = getPublicUrlOrPath(
+  process.env.NODE_ENV === 'development',
+  require(resolveApp('package.json')).homepage,
+  process.env.PUBLIC_URL
+);
+
+const buildPath = process.env.BUILD_PATH || 'build';
+
+const moduleFileExtensions = [
+  'web.mjs',
+  'mjs',
+  'web.js',
+  'js',
+  'web.ts',
+  'ts',
+  'web.tsx',
+  'tsx',
+  'json',
+  'web.jsx',
+  'jsx',
+];
+
+// Resolve file paths in the same order as webpack
+const resolveModule = (resolveFn, filePath) => {
+  const extension = moduleFileExtensions.find(extension =>
+    fs.existsSync(resolveFn(`${filePath}.${extension}`))
+  );
+
+  if (extension) {
+    return resolveFn(`${filePath}.${extension}`);
+  }
+
+  return resolveFn(`${filePath}.js`);
+};
+
+// config after eject: we're in ./config/
+module.exports = {
+  dotenv: resolveApp('.env'),
+  appPath: resolveApp('.'),
+  appBuild: resolveApp(buildPath),
+  appPublic: resolveApp('public'),
+  appHtml: resolveApp('public/index.html'),
+  appIndexJs: resolveModule(resolveApp, 'src/index'),
+  appPackageJson: resolveApp('package.json'),
+  appSrc: resolveApp('src'),
+  appTsConfig: resolveApp('tsconfig.json'),
+  appJsConfig: resolveApp('jsconfig.json'),
+  yarnLockFile: resolveApp('yarn.lock'),
+  testsSetup: resolveModule(resolveApp, 'src/setupTests'),
+  proxySetup: resolveApp('src/setupProxy.js'),
+  appNodeModules: resolveApp('node_modules'),
+  swSrc: resolveModule(resolveApp, 'src/service-worker'),
+  publicUrlOrPath,
+};
+
+
+
+module.exports.moduleFileExtensions = moduleFileExtensions;

config/pnpTs.js

+'use strict';
+
+const { resolveModuleName } = require('ts-pnp');
+
+exports.resolveModuleName = (
+  typescript,
+  moduleName,
+  containingFile,
+  compilerOptions,
+  resolutionHost
+) => {
+  return resolveModuleName(
+    moduleName,
+    containingFile,
+    compilerOptions,
+    resolutionHost,
+    typescript.resolveModuleName
+  );
+};
+
+exports.resolveTypeReferenceDirective = (
+  typescript,
+  moduleName,
+  containingFile,
+  compilerOptions,
+  resolutionHost
+) => {
+  return resolveModuleName(
+    moduleName,
+    containingFile,
+    compilerOptions,
+    resolutionHost,
+    typescript.resolveTypeReferenceDirective
+  );
+};

config/webpackDevServer.config.js

+'use strict';
+
+const fs = require('fs');
+const errorOverlayMiddleware = require('react-dev-utils/errorOverlayMiddleware');
+const evalSourceMapMiddleware = require('react-dev-utils/evalSourceMapMiddleware');
+const noopServiceWorkerMiddleware = require('react-dev-utils/noopServiceWorkerMiddleware');
+const ignoredFiles = require('react-dev-utils/ignoredFiles');
+const redirectServedPath = require('react-dev-utils/redirectServedPathMiddleware');
+const paths = require('./paths');
+const getHttpsConfig = require('./getHttpsConfig');
+
+const host = process.env.HOST || '0.0.0.0';
+const sockHost = process.env.WDS_SOCKET_HOST;
+const sockPath = process.env.WDS_SOCKET_PATH; // default: '/sockjs-node'
+const sockPort = process.env.WDS_SOCKET_PORT;
+
+module.exports = function (proxy, allowedHost) {
+  return {
+    // WebpackDevServer 2.4.3 introduced a security fix that prevents remote
+    // websites from potentially accessing local content through DNS rebinding:
+    // https://github.com/webpack/webpack-dev-server/issues/887
+    // https://medium.com/webpack/webpack-dev-server-middleware-security-issues-1489d950874a
+    // However, it made several existing use cases such as development in cloud
+    // environment or subdomains in development significantly more complicated:
+    // https://github.com/facebook/create-react-app/issues/2271
+    // https://github.com/facebook/create-react-app/issues/2233
+    // While we're investigating better solutions, for now we will take a
+    // compromise. Since our WDS configuration only serves files in the `public`
+    // folder we won't consider accessing them a vulnerability. However, if you
+    // use the `proxy` feature, it gets more dangerous because it can expose
+    // remote code execution vulnerabilities in backends like Django and Rails.
+    // So we will disable the host check normally, but enable it if you have
+    // specified the `proxy` setting. Finally, we let you override it if you
+    // really know what you're doing with a special environment variable.
+    disableHostCheck:
+      !proxy || process.env.DANGEROUSLY_DISABLE_HOST_CHECK === 'true',
+    // Enable gzip compression of generated files.
+    compress: true,
+    // Silence WebpackDevServer's own logs since they're generally not useful.
+    // It will still show compile warnings and errors with this setting.
+    clientLogLevel: 'none',
+    // By default WebpackDevServer serves physical files from current directory
+    // in addition to all the virtual build products that it serves from memory.
+    // This is confusing because those files won’t automatically be available in
+    // production build folder unless we copy them. However, copying the whole
+    // project directory is dangerous because we may expose sensitive files.
+    // Instead, we establish a convention that only files in `public` directory
+    // get served. Our build script will copy `public` into the `build` folder.
+    // In `index.html`, you can get URL of `public` folder with %PUBLIC_URL%:
+    // <link rel="icon" href="%PUBLIC_URL%/favicon.ico">
+    // In JavaScript code, you can access it with `process.env.PUBLIC_URL`.
+    // Note that we only recommend to use `public` folder as an escape hatch
+    // for files like `favicon.ico`, `manifest.json`, and libraries that are
+    // for some reason broken when imported through webpack. If you just want to
+    // use an image, put it in `src` and `import` it from JavaScript instead.
+    contentBase: paths.appPublic,
+    contentBasePublicPath: paths.publicUrlOrPath,
+    // By default files from `contentBase` will not trigger a page reload.
+    watchContentBase: true,
+    // Enable hot reloading server. It will provide WDS_SOCKET_PATH endpoint
+    // for the WebpackDevServer client so it can learn when the files were
+    // updated. The WebpackDevServer client is included as an entry point
+    // in the webpack development configuration. Note that only changes
+    // to CSS are currently hot reloaded. JS changes will refresh the browser.
+    hot: true,
+    // Use 'ws' instead of 'sockjs-node' on server since we're using native
+    // websockets in `webpackHotDevClient`.
+    transportMode: 'ws',
+    // Prevent a WS client from getting injected as we're already including
+    // `webpackHotDevClient`.
+    injectClient: false,
+    // Enable custom sockjs pathname for websocket connection to hot reloading server.
+    // Enable custom sockjs hostname, pathname and port for websocket connection
+    // to hot reloading server.
+    sockHost,
+    sockPath,
+    sockPort,
+    // It is important to tell WebpackDevServer to use the same "publicPath" path as
+    // we specified in the webpack config. When homepage is '.', default to serving
+    // from the root.
+    // remove last slash so user can land on `/test` instead of `/test/`
+    publicPath: paths.publicUrlOrPath.slice(0, -1),
+    // WebpackDevServer is noisy by default so we emit custom message instead
+    // by listening to the compiler events with `compiler.hooks[...].tap` calls above.
+    quiet: true,
+    // Reportedly, this avoids CPU overload on some systems.
+    // https://github.com/facebook/create-react-app/issues/293
+    // src/node_modules is not ignored to support absolute imports
+    // https://github.com/facebook/create-react-app/issues/1065
+    watchOptions: {
+      ignored: ignoredFiles(paths.appSrc),
+    },
+    https: getHttpsConfig(),
+    host,
+    overlay: false,
+    historyApiFallback: {
+      // Paths with dots should still use the history fallback.
+      // See https://github.com/facebook/create-react-app/issues/387.
+      disableDotRule: true,
+      index: paths.publicUrlOrPath,
+    },
+    public: allowedHost,
+    // `proxy` is run between `before` and `after` `webpack-dev-server` hooks
+    proxy,
+    before(app, server) {
+      // Keep `evalSourceMapMiddleware` and `errorOverlayMiddleware`
+      // middlewares before `redirectServedPath` otherwise will not have any effect
+      // This lets us fetch source contents from webpack for the error overlay
+      app.use(evalSourceMapMiddleware(server));
+      // This lets us open files from the runtime error overlay.
+      app.use(errorOverlayMiddleware());
+
+      if (fs.existsSync(paths.proxySetup)) {
+        // This registers user provided middleware for proxy reasons
+        require(paths.proxySetup)(app);
+      }
+    },
+    after(app) {
+      // Redirect to `PUBLIC_URL` or `homepage` from `package.json` if url not match
+      app.use(redirectServedPath(paths.publicUrlOrPath));
+
+      // This service worker file is effectively a 'no-op' that will reset any
+      // previous service worker registered for the same host:port combination.
+      // We do this in development to avoid hitting the production cache if
+      // it used the same host and port.
+      // https://github.com/facebook/create-react-app/issues/2272#issuecomment-302832432
+      app.use(noopServiceWorkerMiddleware(paths.publicUrlOrPath));
+    },
+  };
+};

package.json

+{
+  "name": "wecom-sidebar",
+  "version": "0.1.0",
+  "private": true,
+  "dependencies": {
+    "@ant-design/icons": "^4.7.0",
+    "@babel/core": "7.12.3",
+    "@pmmmwh/react-refresh-webpack-plugin": "0.4.3",
+    "@svgr/webpack": "5.5.0",
+    "@testing-library/jest-dom": "^5.11.9",
+    "@testing-library/react": "^11.2.5",
+    "@testing-library/user-event": "^12.8.1",
+    "@types/jest": "^26.0.20",
+    "@types/node": "^12.20.4",
+    "@types/react": "^17.0.3",
+    "@types/react-dom": "^17.0.2",
+    "@typescript-eslint/eslint-plugin": "^4.5.0",
+    "@typescript-eslint/parser": "^4.5.0",
+    "antd": "^4.16.13",
+    "axios": "^0.21.1",
+    "babel-eslint": "^10.1.0",
+    "babel-jest": "^26.6.0",
+    "babel-loader": "8.1.0",
+    "babel-plugin-named-asset-import": "^0.3.7",
+    "babel-preset-react-app": "^10.0.0",
+    "bfj": "^7.0.2",
+    "camelcase": "^6.1.0",
+    "case-sensitive-paths-webpack-plugin": "2.3.0",
+    "compare-versions": "^3.6.0",
+    "css-loader": "4.3.0",
+    "dotenv": "8.2.0",
+    "dotenv-expand": "5.1.0",
+    "eslint": "^7.11.0",
+    "eslint-config-react-app": "^6.0.0",
+    "eslint-plugin-flowtype": "^5.2.0",
+    "eslint-plugin-import": "^2.22.1",
+    "eslint-plugin-jest": "^24.1.0",
+    "eslint-plugin-jsx-a11y": "^6.3.1",
+    "eslint-plugin-react": "^7.21.5",
+    "eslint-plugin-react-hooks": "^4.2.0",
+    "eslint-plugin-testing-library": "^3.9.2",
+    "eslint-webpack-plugin": "^2.5.2",
+    "file-loader": "6.1.1",
+    "fs-extra": "^9.0.1",
+    "html-webpack-plugin": "4.5.0",
+    "identity-obj-proxy": "3.0.0",
+    "jest": "26.6.0",
+    "jest-circus": "26.6.0",
+    "jest-resolve": "26.6.0",
+    "jest-watch-typeahead": "0.6.1",
+    "js-cookie": "^2.2.1",
+    "mini-css-extract-plugin": "0.11.3",
+    "optimize-css-assets-webpack-plugin": "5.0.4",
+    "pnp-webpack-plugin": "1.6.4",
+    "postcss-flexbugs-fixes": "4.2.1",
+    "postcss-loader": "3.0.0",
+    "postcss-normalize": "8.0.1",
+    "postcss-preset-env": "6.7.0",
+    "postcss-safe-parser": "5.0.2",
+    "prompts": "2.4.0",
+    "qs": "^6.9.6",
+    "react": "^17.0.1",
+    "react-app-polyfill": "^2.0.0",
+    "react-dev-utils": "^11.0.3",
+    "react-dom": "^17.0.1",
+    "react-refresh": "^0.8.3",
+    "react-router-dom": "^5.3.0",
+    "resolve": "1.18.1",
+    "resolve-url-loader": "^3.1.2",
+    "sass-loader": "^10.0.5",
+    "semver": "7.3.2",
+    "style-loader": "1.3.0",
+    "terser-webpack-plugin": "4.2.3",
+    "ts-pnp": "1.2.0",
+    "typescript": "^4.2.3",
+    "url-loader": "4.1.1",
+    "webpack": "4.44.2",
+    "webpack-dev-server": "3.11.1",
+    "webpack-manifest-plugin": "2.2.0",
+    "workbox-webpack-plugin": "5.1.4"
+  },
+  "scripts": {
+    "start": "BROWSER=none node scripts/start.js",
+    "build": "node scripts/build.js",
+    "test": "node scripts/test.js"
+  },
+  "eslintConfig": {
+    "extends": [
+      "react-app",
+      "react-app/jest"
+    ],
+    "rules":{
+      "jsx-a11y/anchor-is-valid":"off"
+    }
+  },
+  "browserslist": {
+    "production": [
+      ">0.2%",
+      "not dead",
+      "not op_mini all"
+    ],
+    "development": [
+      "last 1 chrome version",
+      "last 1 firefox version",
+      "last 1 safari version"
+    ]
+  },
+  "devDependencies": {
+    "@types/js-cookie": "^2.2.6",
+    "@types/qs": "^6.9.6",
+    "@types/react-router-dom": "^5.3.1",
+    "@types/sha1": "^1.1.2"
+  },
+  "jest": {
+    "roots": [
+      "<rootDir>/src"
+    ],
+    "collectCoverageFrom": [
+      "src/**/*.{js,jsx,ts,tsx}",
+      "!src/**/*.d.ts"
+    ],
+    "setupFiles": [
+      "react-app-polyfill/jsdom"
+    ],
+    "setupFilesAfterEnv": [],
+    "testMatch": [
+      "<rootDir>/src/**/__tests__/**/*.{js,jsx,ts,tsx}",
+      "<rootDir>/src/**/*.{spec,test}.{js,jsx,ts,tsx}"
+    ],
+    "testEnvironment": "jsdom",
+    "testRunner": "/Users/mac/work/wecom-sidebar-react-tpl-main/node_modules/jest-circus/runner.js",
+    "transform": {
+      "^.+\\.(js|jsx|mjs|cjs|ts|tsx)$": "<rootDir>/config/jest/babelTransform.js",
+      "^.+\\.css$": "<rootDir>/config/jest/cssTransform.js",
+      "^(?!.*\\.(js|jsx|mjs|cjs|ts|tsx|css|json)$)": "<rootDir>/config/jest/fileTransform.js"
+    },
+    "transformIgnorePatterns": [
+      "[/\\\\]node_modules[/\\\\].+\\.(js|jsx|mjs|cjs|ts|tsx)$",
+      "^.+\\.module\\.(css|sass|scss)$"
+    ],
+    "modulePaths": [],
+    "moduleNameMapper": {
+      "^react-native$": "react-native-web",
+      "^.+\\.module\\.(css|sass|scss)$": "identity-obj-proxy"
+    },
+    "moduleFileExtensions": [
+      "web.js",
+      "js",
+      "web.ts",
+      "ts",
+      "web.tsx",
+      "tsx",
+      "json",
+      "web.jsx",
+      "jsx",
+      "node"
+    ],
+    "watchPlugins": [
+      "jest-watch-typeahead/filename",
+      "jest-watch-typeahead/testname"
+    ],
+    "resetMocks": true
+  },
+  "babel": {
+    "presets": [
+      "react-app"
+    ]
+  }
+}

public/index.html

+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <link rel="icon" href="%PUBLIC_URL%/favicon.ico" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <meta name="theme-color" content="#000000" />
+  <meta
+    name="description"
+    content="Web site created using create-react-app"
+  />
+  <link rel="apple-touch-icon" href="%PUBLIC_URL%/logo192.png" />
+  <!--
+    manifest.json provides metadata used when your web app is installed on a
+    user's mobile device or desktop. See https://developers.google.com/web/fundamentals/web-app-manifest/
+  -->
+  <link rel="manifest" href="%PUBLIC_URL%/manifest.json" />
+  <!--
+    Notice the use of %PUBLIC_URL% in the tags above.
+    It will be replaced with the URL of the `public` folder during the build.
+    Only files inside the `public` folder can be referenced from the HTML.
+
+    Unlike "/favicon.ico" or "favicon.ico", "%PUBLIC_URL%/favicon.ico" will
+    work correctly both with client-side routing and a non-root public URL.
+    Learn how to configure a non-root public URL by running `npm run build`.
+  -->
+  <title>企业微信侧边栏开发模板</title>
+
+  <script src="https://res.wx.qq.com/open/js/jweixin-1.2.0.js"></script>
+  <script src="https://open.work.weixin.qq.com/wwopen/js/jwxwork-1.0.0.js"></script>
+</head>
+<body>
+<noscript>You need to enable JavaScript to run this app.</noscript>
+<div id="root"></div>
+<!--
+  This HTML file is a template.
+  If you open it directly in the browser, you will see an empty page.
+
+  You can add webfonts, meta tags, or analytics to this file.
+  The build step will place the bundled scripts into the <body> tag.
+
+  To begin the development, run `npm start` or `yarn start`.
+  To create a production bundle, use `npm run build` or `yarn build`.
+-->
+</body>
+</html>

public/manifest.json

+{
+  "short_name": "React App",
+  "name": "Create React App Sample",
+  "icons": [
+    {
+      "src": "favicon.ico",
+      "sizes": "64x64 32x32 24x24 16x16",
+      "type": "image/x-icon"
+    },
+    {
+      "src": "logo192.png",
+      "type": "image/png",
+      "sizes": "192x192"
+    },
+    {
+      "src": "logo512.png",
+      "type": "image/png",
+      "sizes": "512x512"
+    }
+  ],
+  "start_url": ".",
+  "display": "standalone",
+  "theme_color": "#000000",
+  "background_color": "#ffffff"
+}

public/robots.txt

+# https://www.robotstxt.org/robotstxt.html
+User-agent: *
+Disallow:

scripts/build.js

+'use strict';
+
+// Do this as the first thing so that any code reading it knows the right env.
+process.env.BABEL_ENV = 'production';
+process.env.NODE_ENV = 'production';
+
+// Makes the script crash on unhandled rejections instead of silently
+// ignoring them. In the future, promise rejections that are not handled will
+// terminate the Node.js process with a non-zero exit code.
+process.on('unhandledRejection', err => {
+  throw err;
+});
+
+// Ensure environment variables are read.
+require('../config/env');
+
+
+const path = require('path');
+const chalk = require('react-dev-utils/chalk');
+const fs = require('fs-extra');
+const bfj = require('bfj');
+const webpack = require('webpack');
+const configFactory = require('../config/webpack.config');
+const paths = require('../config/paths');
+const checkRequiredFiles = require('react-dev-utils/checkRequiredFiles');
+const formatWebpackMessages = require('react-dev-utils/formatWebpackMessages');
+const printHostingInstructions = require('react-dev-utils/printHostingInstructions');
+const FileSizeReporter = require('react-dev-utils/FileSizeReporter');
+const printBuildError = require('react-dev-utils/printBuildError');
+
+const measureFileSizesBeforeBuild =
+  FileSizeReporter.measureFileSizesBeforeBuild;
+const printFileSizesAfterBuild = FileSizeReporter.printFileSizesAfterBuild;
+const useYarn = fs.existsSync(paths.yarnLockFile);
+
+// These sizes are pretty large. We'll warn for bundles exceeding them.
+const WARN_AFTER_BUNDLE_GZIP_SIZE = 512 * 1024;
+const WARN_AFTER_CHUNK_GZIP_SIZE = 1024 * 1024;
+
+const isInteractive = process.stdout.isTTY;
+
+// Warn and crash if required files are missing
+if (!checkRequiredFiles([paths.appHtml, paths.appIndexJs])) {
+  process.exit(1);
+}
+
+const argv = process.argv.slice(2);
+const writeStatsJson = argv.indexOf('--stats') !== -1;
+
+// Generate configuration
+const config = configFactory('production');
+
+// We require that you explicitly set browsers and do not fall back to
+// browserslist defaults.
+const { checkBrowsers } = require('react-dev-utils/browsersHelper');
+checkBrowsers(paths.appPath, isInteractive)
+  .then(() => {
+    // First, read the current file sizes in build directory.
+    // This lets us display how much they changed later.
+    return measureFileSizesBeforeBuild(paths.appBuild);
+  })
+  .then(previousFileSizes => {
+    // Remove all content but keep the directory so that
+    // if you're in it, you don't end up in Trash
+    fs.emptyDirSync(paths.appBuild);
+    // Merge with the public folder
+    copyPublicFolder();
+    // Start the webpack build
+    return build(previousFileSizes);
+  })
+  .then(
+    ({ stats, previousFileSizes, warnings }) => {
+      if (warnings.length) {
+        console.log(chalk.yellow('Compiled with warnings.\n'));
+        console.log(warnings.join('\n\n'));
+        console.log(
+          '\nSearch for the ' +
+            chalk.underline(chalk.yellow('keywords')) +
+            ' to learn more about each warning.'
+        );
+        console.log(
+          'To ignore, add ' +
+            chalk.cyan('// eslint-disable-next-line') +
+            ' to the line before.\n'
+        );
+      } else {
+        console.log(chalk.green('Compiled successfully.\n'));
+      }
+
+      console.log('File sizes after gzip:\n');
+      printFileSizesAfterBuild(
+        stats,
+        previousFileSizes,
+        paths.appBuild,
+        WARN_AFTER_BUNDLE_GZIP_SIZE,
+        WARN_AFTER_CHUNK_GZIP_SIZE
+      );
+      console.log();
+
+      const appPackage = require(paths.appPackageJson);
+      const publicUrl = paths.publicUrlOrPath;
+      const publicPath = config.output.publicPath;
+      const buildFolder = path.relative(process.cwd(), paths.appBuild);
+      printHostingInstructions(
+        appPackage,
+        publicUrl,
+        publicPath,
+        buildFolder,
+        useYarn
+      );
+    },
+    err => {
+      const tscCompileOnError = process.env.TSC_COMPILE_ON_ERROR === 'true';
+      if (tscCompileOnError) {
+        console.log(
+          chalk.yellow(
+            'Compiled with the following type errors (you may want to check these before deploying your app):\n'
+          )
+        );
+        printBuildError(err);
+      } else {
+        console.log(chalk.red('Failed to compile.\n'));
+        printBuildError(err);
+        process.exit(1);
+      }
+    }
+  )
+  .catch(err => {
+    if (err && err.message) {
+      console.log(err.message);
+    }
+    process.exit(1);
+  });
+
+// Create the production build and print the deployment instructions.
+function build(previousFileSizes) {
+  console.log('Creating an optimized production build...');
+
+  const compiler = webpack(config);
+  return new Promise((resolve, reject) => {
+    compiler.run((err, stats) => {
+      let messages;
+      if (err) {
+        if (!err.message) {
+          return reject(err);
+        }
+
+        let errMessage = err.message;
+
+        // Add additional information for postcss errors
+        if (Object.prototype.hasOwnProperty.call(err, 'postcssNode')) {
+          errMessage +=
+            '\nCompileError: Begins at CSS selector ' +
+            err['postcssNode'].selector;
+        }
+
+        messages = formatWebpackMessages({
+          errors: [errMessage],
+          warnings: [],
+        });
+      } else {
+        messages = formatWebpackMessages(
+          stats.toJson({ all: false, warnings: true, errors: true })
+        );
+      }
+      if (messages.errors.length) {
+        // Only keep the first error. Others are often indicative
+        // of the same problem, but confuse the reader with noise.
+        if (messages.errors.length > 1) {
+          messages.errors.length = 1;
+        }
+        return reject(new Error(messages.errors.join('\n\n')));
+      }
+      if (
+        process.env.CI &&
+        (typeof process.env.CI !== 'string' ||
+          process.env.CI.toLowerCase() !== 'false') &&
+        messages.warnings.length
+      ) {
+        console.log(
+          chalk.yellow(
+            '\nTreating warnings as errors because process.env.CI = true.\n' +
+              'Most CI servers set it automatically.\n'
+          )
+        );
+        return reject(new Error(messages.warnings.join('\n\n')));
+      }
+
+      const resolveArgs = {
+        stats,
+        previousFileSizes,
+        warnings: messages.warnings,
+      };
+
+      if (writeStatsJson) {
+        return bfj
+          .write(paths.appBuild + '/bundle-stats.json', stats.toJson())
+          .then(() => resolve(resolveArgs))
+          .catch(error => reject(new Error(error)));
+      }
+
+      return resolve(resolveArgs);
+    });
+  });
+}
+
+function copyPublicFolder() {
+  fs.copySync(paths.appPublic, paths.appBuild, {
+    dereference: true,
+    filter: file => file !== paths.appHtml,
+  });
+}

scripts/start.js

+'use strict';
+
+// Do this as the first thing so that any code reading it knows the right env.
+process.env.BABEL_ENV = 'development';
+process.env.NODE_ENV = 'development';
+
+// Makes the script crash on unhandled rejections instead of silently
+// ignoring them. In the future, promise rejections that are not handled will
+// terminate the Node.js process with a non-zero exit code.
+process.on('unhandledRejection', err => {
+  throw err;
+});
+
+// Ensure environment variables are read.
+require('../config/env');
+
+
+const fs = require('fs');
+const chalk = require('react-dev-utils/chalk');
+const webpack = require('webpack');
+const WebpackDevServer = require('webpack-dev-server');
+const clearConsole = require('react-dev-utils/clearConsole');
+const checkRequiredFiles = require('react-dev-utils/checkRequiredFiles');
+const {
+  choosePort,
+  createCompiler,
+  prepareProxy,
+  prepareUrls,
+} = require('react-dev-utils/WebpackDevServerUtils');
+const openBrowser = require('react-dev-utils/openBrowser');
+const semver = require('semver');
+const paths = require('../config/paths');
+const configFactory = require('../config/webpack.config');
+const createDevServerConfig = require('../config/webpackDevServer.config');
+const getClientEnvironment = require('../config/env');
+const react = require(require.resolve('react', { paths: [paths.appPath] }));
+
+const env = getClientEnvironment(paths.publicUrlOrPath.slice(0, -1));
+const useYarn = fs.existsSync(paths.yarnLockFile);
+const isInteractive = process.stdout.isTTY;
+
+// Warn and crash if required files are missing
+if (!checkRequiredFiles([paths.appHtml, paths.appIndexJs])) {
+  process.exit(1);
+}
+
+// Tools like Cloud9 rely on this.
+const DEFAULT_PORT = parseInt(process.env.PORT, 10) || 3000;
+const HOST = process.env.HOST || '0.0.0.0';
+
+if (process.env.HOST) {
+  console.log(
+    chalk.cyan(
+      `Attempting to bind to HOST environment variable: ${chalk.yellow(
+        chalk.bold(process.env.HOST)
+      )}`
+    )
+  );
+  console.log(
+    `If this was unintentional, check that you haven't mistakenly set it in your shell.`
+  );
+  console.log(
+    `Learn more here: ${chalk.yellow('https://cra.link/advanced-config')}`
+  );
+  console.log();
+}
+
+// We require that you explicitly set browsers and do not fall back to
+// browserslist defaults.
+const { checkBrowsers } = require('react-dev-utils/browsersHelper');
+checkBrowsers(paths.appPath, isInteractive)
+  .then(() => {
+    // We attempt to use the default port but if it is busy, we offer the user to
+    // run on a different port. `choosePort()` Promise resolves to the next free port.
+    return choosePort(HOST, DEFAULT_PORT);
+  })
+  .then(port => {
+    if (port == null) {
+      // We have not found a port.
+      return;
+    }
+
+    const config = configFactory('development');
+    const protocol = process.env.HTTPS === 'true' ? 'https' : 'http';
+    const appName = require(paths.appPackageJson).name;
+
+    const useTypeScript = fs.existsSync(paths.appTsConfig);
+    const tscCompileOnError = process.env.TSC_COMPILE_ON_ERROR === 'true';
+    const urls = prepareUrls(
+      protocol,
+      HOST,
+      port,
+      paths.publicUrlOrPath.slice(0, -1)
+    );
+    const devSocket = {
+      warnings: warnings =>
+        devServer.sockWrite(devServer.sockets, 'warnings', warnings),
+      errors: errors =>
+        devServer.sockWrite(devServer.sockets, 'errors', errors),
+    };
+    // Create a webpack compiler that is configured with custom messages.
+    const compiler = createCompiler({
+      appName,
+      config,
+      devSocket,
+      urls,
+      useYarn,
+      useTypeScript,
+      tscCompileOnError,
+      webpack,
+    });
+    // Load proxy config
+    const proxySetting = require(paths.appPackageJson).proxy;
+    const proxyConfig = prepareProxy(
+      proxySetting,
+      paths.appPublic,
+      paths.publicUrlOrPath
+    );
+    // Serve webpack assets generated by the compiler over a web server.
+    const serverConfig = createDevServerConfig(
+      proxyConfig,
+      urls.lanUrlForConfig
+    );
+    const devServer = new WebpackDevServer(compiler, serverConfig);
+    // Launch WebpackDevServer.
+    devServer.listen(port, HOST, err => {
+      if (err) {
+        return console.log(err);
+      }
+      if (isInteractive) {
+        clearConsole();
+      }
+
+      if (env.raw.FAST_REFRESH && semver.lt(react.version, '16.10.0')) {
+        console.log(
+          chalk.yellow(
+            `Fast Refresh requires React 16.10 or higher. You are using React ${react.version}.`
+          )
+        );
+      }
+
+      console.log(chalk.cyan('Starting the development server...\n'));
+      openBrowser(urls.localUrlForBrowser);
+    });
+
+    ['SIGINT', 'SIGTERM'].forEach(function (sig) {
+      process.on(sig, function () {
+        devServer.close();
+        process.exit();
+      });
+    });
+
+    if (process.env.CI !== 'true') {
+      // Gracefully exit when stdin ends
+      process.stdin.on('end', function () {
+        devServer.close();
+        process.exit();
+      });
+    }
+  })
+  .catch(err => {
+    if (err && err.message) {
+      console.log(err.message);
+    }
+    process.exit(1);
+  });

scripts/test.js

+'use strict';
+
+// Do this as the first thing so that any code reading it knows the right env.
+process.env.BABEL_ENV = 'test';
+process.env.NODE_ENV = 'test';
+process.env.PUBLIC_URL = '';
+
+// Makes the script crash on unhandled rejections instead of silently
+// ignoring them. In the future, promise rejections that are not handled will
+// terminate the Node.js process with a non-zero exit code.
+process.on('unhandledRejection', err => {
+  throw err;
+});
+
+// Ensure environment variables are read.
+require('../config/env');
+
+
+const jest = require('jest');
+const execSync = require('child_process').execSync;
+let argv = process.argv.slice(2);
+
+function isInGitRepository() {
+  try {
+    execSync('git rev-parse --is-inside-work-tree', { stdio: 'ignore' });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+function isInMercurialRepository() {
+  try {
+    execSync('hg --cwd . root', { stdio: 'ignore' });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+// Watch unless on CI or explicitly running all tests
+if (
+  !process.env.CI &&
+  argv.indexOf('--watchAll') === -1 &&
+  argv.indexOf('--watchAll=false') === -1
+) {
+  // https://github.com/facebook/create-react-app/issues/5210
+  const hasSourceControl = isInGitRepository() || isInMercurialRepository();
+  argv.push(hasSourceControl ? '--watch' : '--watchAll');
+}
+
+
+jest.run(argv);

src/App.tsx

+import React, {FC} from 'react'
+import {HashRouter} from "react-router-dom";
+import Nav from "./components/Nav";
+import RouterConfig from "./components/RouterConfig";
+
+const App: FC = () => {
+  return (
+    <HashRouter>
+      <Nav/>
+      <RouterConfig />
+    </HashRouter>
+  );
+}
+
+export default App;

src/api/api.d.ts

+interface Response {
+  errcode: number; // 错误码
+  errmsg: string; // 错误信息
+}
+
+interface UserResponse extends Response {
+  userid: string; // 成员UserID
+  name: string; // 成员名称
+  gender: 0 | 1 | 2; // 性别。0表示未定义，1表示男性，2表示女性
+  qr_code: string; // 员工个人二维码，扫描可添加为外部联系人
+  thumb_avatar: string; // 头像缩略图url
+}
+
+interface ExternalUserResponse extends Response {
+  external_contact: {
+    external_userid: string // 外部联系人 Id
+    name: string // 名字
+    avatar: string // 头像
+    corp_name: string // 公司名
+    corp_full_name: string // 公司全名
+    type: 1 | 2, // 外部联系人的类型，1表示该外部联系人是微信用户，2表示该外部联系人是企业微信用户
+    gender: 0 | 1 | 2 // 性别。0表示未定义，1表示男性，2表示女性
+  }
+}
+
+interface AuthResponse extends Response {
+  UserId: string // 自己 userId
+  DeviceId: string
+}
+
+interface TicketRes {
+  meta: {
+    nonceStr: string,
+    timestamp: number,
+    url: string,
+  },
+  app: {
+    ticket: string,
+    expires: number,
+    signature: string,
+  },
+  corp: {
+    ticket: string,
+    expires: number,
+    signature: string,
+  },
+}
+
+interface Member {
+  userid: string // 成员 userId
+  type: 1 | 2 // 外部联系人的类型，1表示该外部联系人是微信用户，2表示该外部联系人是企业微信用户
+  join_time: number // 加群时间
+  join_scene: 1 | 2 | 3 // 怎么加群的
+}
+
+interface ExternalChatResponse extends Response {
+  group_chat: {
+    chat_id: string // 群 Id
+    name: string // 群名
+    owner: string // 群主 userId
+    create_time: number // 创建时间
+    notice: string // 公告
+    member_list: Member[] // 成员列表
+  }
+}

src/api/index.ts

+import axios from 'axios'
+
+// 后端地址
+// const baseURL = 'http://192.168.30.239:5000'
+const baseURL = 'https://base.exploring.cn/wecom-server'
+
+// 创建 axios 实例
+const api = axios.create({
+  baseURL,
+  proxy: false,
+})
+
+// 根据 userId 获取 user 信息
+export const fetchUser = async (userId: string) => {
+  const response = await api.get<UserResponse>('/api/qywx-proxy/user/get', {
+    params: {
+      userid: userId,
+    }
+  });
+
+  return response.data
+}
+
+// 根据 externalUserId 获取 externalUser 信息
+export const fetchExternalUser = async (externalUserId: string, cursor?: string) => {
+  const response = await api.get<ExternalUserResponse>('/api/qywx-proxy/externalcontact/get', {
+    params: {
+      external_userid: externalUserId,
+      cursor
+    }
+  })
+
+  return response.data.external_contact
+}
+
+// 根据 externalChatId 获取 chat 信息
+export const fetchExternalChat = async (externalChatId: string) => {
+  const response = await api.get<ExternalChatResponse>('/api/qywx-proxy/externalcontact/groupchat/get', {
+    params: {
+      chat_id: externalChatId,
+      need_name : 1
+    }
+  })
+
+  return response.data.group_chat
+}
+
+// 根据 code 换取 userId，作为用户身份验证
+export const fetchUserId = async (code: string) => {
+  const response = await api.get<AuthResponse>('/api/qywx-proxy/user/getuserinfo', {
+    params: {
+      code
+    }
+  })
+
+  return response.data.UserId;
+}
+
+// 获取签名
+export const fetchSignatures = async () => {
+  const response = await api.get<TicketRes>('/api/qywx-utils/signatures', {
+    params: {
+      url: window.location.href
+    }
+  })
+
+  return response.data;
+}
+
+export default api

src/components/Nav.tsx

+import React, {FC} from "react";
+import {Menu} from "antd";
+import {HomeOutlined, SettingOutlined, UsergroupAddOutlined, UserOutlined} from "@ant-design/icons";
+import {Link} from "react-router-dom";
+
+const Nav: FC = () => {
+  return (
+    <Menu mode="horizontal">
+      <Menu.Item key="home" icon={<HomeOutlined/>}>
+        <Link to="/">首页</Link>
+      </Menu.Item>
+      <Menu.Item key="actions" icon={<SettingOutlined/>}>
+        <Link to="/actions">操作</Link>
+      </Menu.Item>
+      <Menu.Item key="externalUser" icon={<UserOutlined />}>
+        <Link to="/external-user">人</Link>
+      </Menu.Item>
+      <Menu.Item key="externalChat" icon={<UsergroupAddOutlined />}>
+        <Link to="/external-chat">群</Link>
+      </Menu.Item>
+    </Menu>
+  )
+}
+
+export default Nav;

src/components/RouterConfig.tsx

+import React, {FC} from "react";
+import {Route, Switch} from "react-router-dom";
+import Home from "../pages/Home";
+import Actions from "../pages/Actions";
+import ExternalUser from "../pages/ExternalUser";
+import ExternalChat from "../pages/ExternalChat";
+
+const RouterConfig: FC = () => {
+  return (
+    <Switch>
+      <Route exact path="/">
+        <Home/>
+      </Route>
+      <Route path="/actions">
+        <Actions/>
+      </Route>
+      <Route path="/external-user">
+        <ExternalUser/>
+      </Route>
+      <Route path="/external-chat">
+        <ExternalChat/>
+      </Route>
+    </Switch>
+  )
+}
+
+export default RouterConfig;

src/index.tsx

+import React from 'react'
+import ReactDOM from 'react-dom'
+import { ConfigProvider} from 'antd';
+// 由于 antd 组件的默认文案是英文，所以需要修改为中文
+import zhCN from 'antd/lib/locale/zh_CN';
+import App from './App'
+import {fetchUserId, fetchSignatures} from './api'
+import config from './_config'
+import {invokeResMock, mockUserId, wxResMock} from "./mock";
+import {checkRedirect, createJsSdk, initSdk} from "./lib";
+
+import 'antd/dist/antd.css';
+
+export const jsSdk = createJsSdk(wxResMock, invokeResMock);
+
+const AppWrapper = (
+  <ConfigProvider locale={zhCN}>
+    <App />
+  </ConfigProvider>
+)
+// ReactDOM.render(AppWrapper, document.getElementById('root'))
+checkRedirect(config, fetchUserId, mockUserId)
+  .then(() => initSdk(config, fetchSignatures))
+  .then(() => ReactDOM.render(AppWrapper, document.getElementById('root')))

src/lib/index.ts

+import checkRedirect from "./utils/checkRedirect";
+import initSdk from "./utils/initSdk";
+import createJsSdk from "./utils/createJsSdk";
+
+export {
+  createJsSdk,
+  checkRedirect,
+  initSdk,
+}

src/lib/jsSdk/apis.ts

+const apis: wx.Api[] = [
+  'sendChatMessage',
+  'onMenuShareAppMessage',
+  'onMenuShareWechat',
+  'onMenuShareTimeline',
+  'startRecord',
+  'stopRecord',
+  'onVoiceRecordEnd',
+  'playVoice',
+  'pauseVoice',
+  'stopVoice',
+  'onVoicePlayEnd',
+  'uploadVoice',
+  'downloadVoice',
+  'previewImage',
+  'uploadImage',
+  'downloadImage',
+  'getLocalImgData',
+  'getNetworkType',
+  'onNetworkStatusChange',
+  'openLocation',
+  'getLocation',
+  'startAutoLBS',
+  'stopAutoLBS',
+  'onLocationChange',
+  'onHistoryBack',
+  'hideOptionMenu',
+  'showOptionMenu',
+  'hideMenuItems',
+  'showMenuItems',
+  'hideAllNonBaseMenuItem',
+  'showAllNonBaseMenuItem',
+  'openDefaultBrowser',
+  'scanQRCode',
+  'selectEnterpriseContact',
+  'openEnterpriseChat',
+  'selectExternalContact',
+  'getCurExternalContact',
+  'openUserProfile',
+  'shareAppMessage',
+  'shareWechatMessage',
+  'startWifi',
+  'stopWifi',
+  'connectWifi',
+  'getWifiList',
+  'onGetWifiList',
+  'onWifiConnected',
+  'getConnectedWifi',
+  'setClipboardData',
+  'wwapp.getOpenData',
+  'wwapp.initWwOpenData',
+  'getCurExternalChat',
+];
+
+export default apis;

src/lib/jsSdk/index.ts

+import compareVersions from 'compare-versions'
+
+/**
+ * jssdk 的 config 函数的封装
+ * @param setting
+ */
+const config = (setting: wx.ConfigParams): Promise<wx.WxFnCallbackRes | null> => {
+  return new Promise((resolve) => {
+    wx.config({ ...setting });
+    wx.ready(() => resolve(null));
+  });
+};
+
+/**
+ * jssdk 的 agentConfig 函数封装
+ * @param agentSetting
+ */
+const agentConfig = (agentSetting: Omit<wx.AgentConfigParams, 'success' | 'fail'>): Promise<wx.WxFnCallbackRes> => {
+  return new Promise((resolve, reject) => {
+    wx.agentConfig({
+      ...agentSetting,
+      success: resolve,
+      fail: reject,
+    });
+  });
+};
+
+/**
+ * 根据 userAgent 检查当前企业微信版本号是否 < 3.0.24
+ */
+const checkDeprecated = async (): Promise<boolean> => {
+  const DEPRECATED_VERSION = '3.0.24'
+
+  const versionRegexp = /wxwork\/([\d.]+)/;
+  const versionResult = navigator.userAgent.match(versionRegexp);
+
+  if (!versionResult || versionResult.length < 2) {
+    return true;
+  }
+
+  const [, version] = versionResult;
+
+  // version < DEPRECATED_VERSION ?
+  return compareVersions(version, DEPRECATED_VERSION) === -1
+};
+
+/**
+ * 通用调用企业微信 SDK 的函数
+ * @param apiName api 名称
+ * @param params 传入参数
+ */
+const invoke = <Res = { hasError: boolean }>(apiName: wx.Api, params = {}) => {
+  return new Promise<wx.WxInvokeCallbackRes & Res>((resolve) => {
+    wx.invoke<Res>(apiName, params, res => {
+      const hasError = res.err_msg !== `${apiName}:ok`
+
+      if (hasError) {
+        // 错误日志
+        console.error(apiName, params, res);
+      }
+
+      resolve({ ...res, hasError })
+    });
+  });
+};
+
+const _jsSdk = {
+  checkDeprecated,
+  config,
+  agentConfig,
+  invoke,
+};
+
+export type JsSDK = typeof _jsSdk;
+
+export default _jsSdk;

src/lib/jsSdk/utils.ts

+import {JsSDK} from "./index";
+
+// 假值
+const fakeValue: Record<string, any> = {
+  number: 0,
+  string: '',
+  object: {},
+};
+
+// 根据外部判断是否为 mock 环境
+const isWindowMock = window.isMock === true;
+// 根据宿主环境判断是否要 mock
+const isHostMock = navigator.userAgent.toLowerCase().includes('chrome')
+  && !navigator.userAgent.toLowerCase().includes('wxwork')
+// 是否为 mock 环境
+export const isMock = isWindowMock || isHostMock;
+
+/**
+ * 生成 mock 函数
+ * @param apiName api 调用名
+ * @param mockMap mock 的映射关系表
+ */
+const createMockFn = (apiName: keyof JsSDK, mockMap: any) => {
+  return async (...args: any) => {
+    const isInvoke = apiName === 'invoke';
+
+    // 获取对应的 mock 返回
+    const mockRes = isInvoke ? mockMap[args[0]] : mockMap[apiName];
+    // 生成 mock 返回
+    const result = typeof mockRes === 'function' ? mockRes(...args) : mockRes
+
+    // 日志
+    if (apiName === 'invoke') {
+      console.log('wx.invoke 调用', args[0], '参数', args[1], '返回值', result);
+    } else {
+      console.log('JSSDK调用', apiName, '参数', args, '返回值', result);
+    }
+
+    return result;
+  }
+}
+
+/**
+ * Mock企业微信 SDK，可以在浏览器下不调用 Sdk
+ */
+export const mockJsSdk = (originalJsSdk: JsSDK, wxResMock: Partial<JsSDK>, invokeMockRes: any) => {
+  // @ts-ignore 这里要生成 JsSDK 所以要 ignore ts 的报错
+  const newJsSdk: JsSDK = {};
+
+  Object.entries(originalJsSdk).forEach(entry => {
+    const [key, originalValue] = entry as [keyof JsSDK, any];
+
+    const originalValueType = typeof originalValue;
+    const mockRes = wxResMock[key];
+
+    // 特殊处理 invoke
+    if (key === 'invoke') {
+      newJsSdk.invoke = createMockFn(key, invokeMockRes)
+      return;
+    }
+
+    if (originalValueType === 'function') {
+      // mock 函数
+      newJsSdk[key] = createMockFn(key, wxResMock);
+    } else {
+      // 使用 mock 值
+      newJsSdk[key] = mockRes || fakeValue[originalValueType] || null;
+    }
+  });
+
+  return newJsSdk;
+};

src/lib/utils/checkRedirect.ts

+import Cookies from 'js-cookie'
+import qs from 'qs'
+import {Config} from "./initSdk"
+import {isMock} from "../jsSdk/utils";
+
+type GetUserId = (code: string) => Promise<string>
+
+/**
+ * 获取重定位的 OAuth 路径
+ * @returns {string}
+ */
+const generateOAuthUrl = (config: Config) => {
+  const [redirectUri] = window.location.href.split('#');
+
+  const searchObj = {
+    appid: config.corpId,
+    redirect_uri: encodeURIComponent(redirectUri),
+    response_type: 'code',
+    scope: 'snsapi_base',
+    agentid: config.agentId,
+    state: 'A1',
+  };
+
+  const search = Object.entries(searchObj)
+    .map(entry => {
+      const [key, value] = entry;
+      return `${key}=${value}`;
+    })
+    .join('&');
+
+  return `https://open.weixin.qq.com/connect/oauth2/authorize?${search}#wechat_redirect`;
+};
+
+/**
+ * 判断当前网页是否需要重定向
+ */
+const checkRedirect = async (config: Config, getUserId: GetUserId, mockUserId?: string) => {
+  if (isMock) {
+    // 使用 mock 的 userId
+    if (mockUserId) {
+      Cookies.set('userId', mockUserId);
+    }
+    return ;
+  }
+
+  const userId = Cookies.get('userId')
+
+  const unAuth = !userId || userId === 'undefined' || userId === 'null'
+
+  const codeExist = window.location.search.includes('code');
+
+  // 判断是否需要重定向
+  if (unAuth && !codeExist) {
+    window.location.replace(generateOAuthUrl(config));
+  }
+
+  // 判断是否需要重新获取 userId
+  if (unAuth) {
+    const code = qs.parse(window.location.search.slice(1)).code as string
+
+    const newUserId = await getUserId(code)
+
+    Cookies.set('userId', newUserId)
+  }
+};
+
+export default checkRedirect

src/lib/utils/createJsSdk.ts

+import {isMock, mockJsSdk} from "../jsSdk/utils";
+import _jsSdk from "../jsSdk";
+
+/**
+ * 生成 jssdk 的函数
+ * @param wxResMock wx.fn 的 mock 映射关系
+ * @param invokeResMock wx.invoke 的 mock 映射关系
+ */
+const createJsSdk = (wxResMock?: Record<string, any>, invokeResMock?: Record<string, any>) => {
+  return isMock ? mockJsSdk(_jsSdk, wxResMock || {}, invokeResMock || {}) : _jsSdk;
+}
+
+export default createJsSdk

src/lib/utils/initSdk.ts

+import apis from '../jsSdk/apis';
+import {jsSdk} from "../../index";
+
+export interface Config {
+  corpId: string;
+  agentId: string;
+}
+
+export type GetSignatures = () => Promise<TicketRes>
+
+/**
+ * 初始化企业微信 SDK 库
+ * config: 基础信息配置
+ * getSignatures: 获取签名函数
+ */
+const initSdk = async (config: Config, getSignatures: GetSignatures) => {
+  const { corpId, agentId } = config;
+
+  // 获取 ticket
+  const signaturesRes = await getSignatures();
+
+  const agentConfigRes = await jsSdk.agentConfig({
+    corpid: corpId,
+    agentid: agentId,
+    timestamp: signaturesRes.meta.timestamp,
+    nonceStr: signaturesRes.meta.nonceStr,
+    signature: signaturesRes.app.signature,
+    jsApiList: apis,
+  }).catch(e => {
+    console.error(e)
+  });
+
+  console.log('agentConfig res', agentConfigRes);
+
+  wx.error(console.error);
+};
+
+export default initSdk

src/mock.ts

+// Mock 当前用户 Id
+export const mockUserId = window.mockUserId || 'YanHaiXiang';
+
+// 可在这里自由 mock wx.invoke 的内容
+export const invokeResMock: Record<string, any> = window.invokeResMock || {
+  'getCurExternalContact': {
+    userId: 'wmuUG7CQAAOrCCMkA8cqcCm1wJrJAD6A'
+  },
+}
+
+// 可在这里自由 wx.fn 的内容
+export const wxResMock: Record<string, any> = window.wxResMock || {
+  'agentConfig': () => {
+    console.log('mock agent config')
+  },
+}

src/pages/Actions.tsx

+import * as React from 'react'
+import {useCallback, useState} from 'react'
+import {jsSdk} from "../index";
+import {Button, Input} from "antd";
+
+const {TextArea} = Input
+
+const Actions: React.FC = () => {
+  const [msg, setMsg] = useState<string>('')
+
+  const sendMsg = useCallback(async () => {
+    if (!msg) alert('消息不能为空')
+
+    await jsSdk.invoke('sendChatMessage', {
+      msgtype: 'text',
+      text: {
+        content: msg
+      }
+    });
+  }, [msg])
+
+  return (
+    <div>
+      <h2>功能</h2>
+
+      <TextArea style={{width: '100%', marginBottom: 8}} value={msg} onChange={e => setMsg(e.target.value)}/>
+
+      <Button block type="primary" onClick={sendMsg}>
+        发送
+      </Button>
+    </div>
+  )
+}
+
+export default Actions

src/pages/ExternalChat.tsx

+import * as React from 'react'
+import {useEffect, useState} from 'react'
+import {fetchExternalChat} from '../api'
+import {jsSdk} from "../index";
+import {Spin} from "antd";
+
+const ExternalChat: React.FC = () => {
+  const [loading, setLoading] = useState<boolean>()
+  const [externalChat, setExternalChat] = useState<ExternalChatResponse['group_chat'] | void>()
+
+  const getExternalChatInfo = async () => {
+    const res = await jsSdk.invoke<{chatId?: string}>('getCurExternalChat', {})
+
+    if (!res || !res.chatId) return
+
+    console.log('外部联系群 ID', res.chatId);
+
+    const chatInfo = await fetchExternalChat(res.chatId || '').catch(e => console.error(e))
+
+    setExternalChat(chatInfo)
+  }
+
+  useEffect(() => {
+    getExternalChatInfo()
+      .finally(() => setLoading(false))
+  }, [])
+
+  const openUserProfile = (userId: string, type: 1 | 2) => {
+    return jsSdk.invoke('openUserProfile', {
+      userid: userId,
+      type,
+    })
+  }
+
+  return (
+    <Spin spinning={loading}>
+      <div>
+        <h2>外部联系群</h2>
+        {externalChat ? (
+          <div>
+            <p>群名: {externalChat.name}</p>
+            <p>群主: {externalChat.owner}</p>
+            <p>群公告: {externalChat.notice}</p>
+            <p>群成员: </p>
+            <ul>
+              {externalChat.member_list.map(m => (
+                <li key={m.userid}>
+                  <a href="" onClick={() => openUserProfile(m.userid, m.type)}>
+                    {m.userid}
+                  </a>
+                </li>
+              ))}
+            </ul>
+          </div>
+        ) : <p>找不到外部联系群</p>}
+      </div>
+    </Spin>
+  )
+}
+
+export default ExternalChat

src/pages/ExternalUser.tsx

+import * as React from 'react'
+import {useEffect, useState} from 'react'
+import {fetchExternalUser} from '../api'
+import {jsSdk} from "../index";
+import {Button, message, Spin} from "antd";
+
+// 性别Map
+const genderMap = ['未定义', '男', '女']
+
+const ExternalUser: React.FC = () => {
+  const [loading, setLoading] = useState<boolean>(true)
+  const [externalUser, setExternalUser] = useState<ExternalUserResponse['external_contact'] | void>()
+
+  const getExternalUserInfo = async () => {
+    const res = await jsSdk.invoke<{ userId?: string }>('getCurExternalContact', {})
+
+    if (!res || !res.userId) return
+
+    console.log('外部联系人 ID', res.userId);
+
+    const userInfo = await fetchExternalUser(res.userId).catch(e => console.error(e))
+
+    setExternalUser(userInfo)
+  }
+
+  useEffect(() => {
+    getExternalUserInfo()
+      .finally(() => setLoading(false))
+  }, [])
+
+  const openUserProfile = () => {
+    if (!externalUser) {
+      return message.warn('找不到外部联系人');
+    }
+
+    return jsSdk.invoke('openUserProfile', {
+      userid: externalUser.external_userid,
+      type: externalUser.type
+    })
+  }
+
+  return (
+    <Spin spinning={loading}>
+      <div>
+        <h2>外部联系人</h2>
+        {externalUser ? (
+          <div>
+            <img width="48" src={externalUser.avatar} alt="头像"/>
+            <p>ID: {externalUser.external_userid}</p>
+            <p>姓名: {externalUser.name}@{externalUser.corp_name}</p>
+            <p>姓别: {genderMap[externalUser.gender]}</p>
+            <Button type="primary" size="small" onClick={openUserProfile}>
+              查看详情
+            </Button>
+          </div>
+        ) : <p>找不到外部联系人</p>}
+      </div>
+    </Spin>
+  )
+}
+
+export default ExternalUser

src/pages/Home.tsx

+import React, {FC, useEffect, useState} from "react";
+import Cookies from "js-cookie";
+import {fetchUser} from "../api";
+import {Spin} from "antd";
+
+const Home: FC = () => {
+  const [loading, setLoading] = useState<boolean>(false);
+  const [user, setUser] = useState<UserResponse>();
+
+  // 获取当前外部联系人信息
+  const getUserInfo = async () => {
+    setLoading(true);
+    const userId = Cookies.get('userId')
+
+    const userInfo = await fetchUser(userId || '')
+
+    setUser(userInfo)
+    setLoading(false)
+  }
+
+  useEffect(() => {
+    getUserInfo().then()
+  }, [])
+
+  return (
+    <Spin spinning={loading}>
+      <div>
+        <h1>欢迎回来，{user ? user.name : ''}</h1>
+      </div>
+    </Spin>
+  )
+}
+
+export default Home;

src/react-app-env.d.ts

+/// <reference types="node" />
+/// <reference types="react" />
+/// <reference types="react-dom" />
+
+declare namespace NodeJS {
+  interface ProcessEnv {
+    readonly NODE_ENV: 'development' | 'production' | 'test';
+    readonly PUBLIC_URL: string;
+  }
+}
+
+declare module '*.avif' {
+  const src: string;
+  export default src;
+}
+
+declare module '*.bmp' {
+  const src: string;
+  export default src;
+}
+
+declare module '*.gif' {
+  const src: string;
+  export default src;
+}
+
+declare module '*.jpg' {
+  const src: string;
+  export default src;
+}
+
+declare module '*.jpeg' {
+  const src: string;
+  export default src;
+}
+
+declare module '*.png' {
+  const src: string;
+  export default src;
+}
+
+declare module '*.webp' {
+    const src: string;
+    export default src;
+}
+
+declare module '*.svg' {
+  import * as React from 'react';
+
+  export const ReactComponent: React.FunctionComponent<React.SVGProps<
+    SVGSVGElement
+  > & { title?: string }>;
+
+  const src: string;
+  export default src;
+}
+
+declare module '*.module.css' {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}
+
+declare module '*.module.scss' {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}
+
+declare module '*.module.sass' {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}
+
+import {JsSDK} from "./lib/jsSdk";
+
+declare global {
+  interface Window {
+    // 外部控制是否为 mock
+    isMock?: boolean;
+    // mock userId
+    mockUserId: string,
+    // wx.invoke 里的 Mock 关系表，apiName -> result
+    invokeResMock?: Partial<JsSDK>;
+    // 企业微信的 JsSdk 的 Mock 关系表，fnName -> result
+    wxResMock?: Partial<JsSDK>;
+  }
+}

tsconfig.json

+{
+  "compilerOptions": {
+    "target": "es5",
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "noFallthroughCasesInSwitch": true,
+    "module": "esnext",
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx"
+  },
+  "include": [
+    "src"
+  ]
+}