fix: update comments and clean up unused code across multiple files

Author: Jerry-CodeHub

src/access.ts

@@ -1,6 +1,6 @@
+// 参考文档 https://umijs.org/docs/max/access
 export default (initialState: API.UserInfo) => {
-  // 在这里按照初始化数据定义项目中的权限，统一管理
-  // 参考文档 https://umijs.org/docs/max/access
+  // 'dontHaveAccess' 是约定的禁止访问标识符，由后端登录接口返回以拒绝特定用户进入管理后台
   const canSeeAdmin = !!(initialState && initialState.name !== 'dontHaveAccess');
   return {
     canSeeAdmin,

src/app.tsx

@@ -1,4 +1,3 @@
-// 运行时配置
 import ErrorBoundary from '@/components/ErrorBoundary';
 import RightContent from '@/layouts/RightContent';
 import { appList } from '@/layouts/_defaultProps';
@@ -7,41 +6,36 @@ import 'cesium/Build/Cesium/Widgets/widgets.css';
 import { getInitialState as libGetInitialState } from './utils/Auth/initalState';
 import { requestConfig } from './utils/requestConfig';
 
-// NOTE: cesium-heatmap 插件需要全局引入 Cesium 库
-// 声明全局 Cesium 类型
+// cesium-heatmap 等插件依赖全局 window.Cesium，需在此挂载
+// 同时声明类型以避免 TS 报错
 declare global {
   interface Window {
     Cesium: typeof import('cesium');
   }
 }
 
 import * as Cesium from 'cesium';
-// 仅在需要时挂载到 window，避免全局污染；同时统一初始化 Cesium Ion token
+// 防止 SSR 或模块重复加载时重复挂载，也避免覆盖已有实例
 if (typeof window !== 'undefined' && !window.Cesium) {
   window.Cesium = Cesium;
 }
+// CESIUM_ION_TOKEN 由构建时环境变量注入（见 config/config.ts define 配置）
 if (typeof CESIUM_ION_TOKEN !== 'undefined' && CESIUM_ION_TOKEN) {
   Cesium.Ion.defaultAccessToken = CESIUM_ION_TOKEN as string;
 }
 
-// NOTE:全局初始化数据配置，用于 Layout 用户信息和权限初始化
 // 更多信息见文档：https://umijs.org/docs/api/runtime-config#getinitialstate
 export async function getInitialState() {
-  // return { name: '@umijs/max' };
   return await libGetInitialState();
 }
 
-// NOTE: Request 运行时配置
 export const request: RequestConfig = requestConfig;
 
-// NOTE: Layout 运行时配置
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 export const layout: RunTimeLayoutConfig = (initialState) => {
   return {
     title: 'React Admin',
-    // logo: '/umi-react-admin/logo.svg',
     logo: '/logo.svg',
-    // 默认布局调整
     rightContentRender: () => <RightContent />,
     menuHeaderRender: undefined,
     appList,
@@ -50,27 +44,17 @@ export const layout: RunTimeLayoutConfig = (initialState) => {
     fixSiderbar: true,
     fixHeader: true,
     childrenRender: (children) => <ErrorBoundary>{children}</ErrorBoundary>,
-
-    // 其他属性见：https://procomponents.ant.design/components/layout#prolayout
+    // 更多 ProLayout 属性见：https://procomponents.ant.design/components/layout#prolayout
   };
 };
 
-// NOTE: Antd 运行时配置
 export const antd: RuntimeAntdConfig = (memo) => {
   memo.theme ??= {};
-  // 1, dark 算法
-  // 默认算法 theme.defaultAlgorithm
-  // 暗色算法 theme.darkAlgorithm
-  // 紧凑算法 theme.compactAlgorithm
-
-  // memo.theme.algorithm = theme.darkAlgorithm; // 配置 antd5 的预设 dark 算法
-
-  // 2. 组合使用暗色算法与紧凑算法
-  // algorithm: [theme.darkAlgorithm, theme.compactAlgorithm],
-
+  // 如需切换主题算法，取消对应行注释：
+  // theme.defaultAlgorithm（默认）/ theme.darkAlgorithm（暗色）/ theme.compactAlgorithm（紧凑）
+  // 也可组合使用：algorithm: [theme.darkAlgorithm, theme.compactAlgorithm]
   memo.appConfig = {
     message: {
-      // 配置 message 最大显示数，超过限制时，最早的消息会被自动关闭
       maxCount: 3,
     },
   };

src/components/Designable/index.tsx

@@ -1,5 +1,3 @@
-import { useMemo } from 'react';
-// import { createRoot } from 'react-dom/client'
 import { saveSchema } from '@/components/Designable/service';
 import {
   ActionsWidget,
@@ -29,6 +27,7 @@ import {
 } from '@pind/designable-react';
 import { SettingsForm, setNpmCDNRegistry } from '@pind/designable-react-settings-form';
 import { Alert } from 'antd';
+import { useMemo } from 'react';
 setNpmCDNRegistry('//unpkg.com');
 const { ErrorBoundary } = Alert;
 GlobalRegistry.registerDesignerLocales({
@@ -120,11 +119,3 @@ const Designables = () => {
 };
 
 export default Designables;
-
-// const container = document.getElementById('root')
-// if (container) {
-//   const root = createRoot(container)
-//   root.render(<App />)
-// } else {
-//   console.error('dom root is non-existent')
-// }

src/components/Designable/widgets/MarkupSchemaWidget.tsx

@@ -1,5 +1,4 @@
 // @ts-nocheck
-// 该文件不做 ESLint 检测
 /* eslint-disable */
 import { isEmpty, isPlainObj } from '@formily/shared';
 import { TreeNode } from '@pind/designable-core';

src/components/Guide/Guide.tsx

@@ -6,7 +6,6 @@ interface Props {
   name: string;
 }
 
-// 脚手架示例组件
 const Guide: React.FC<Props> = (props) => {
   const { name } = props;
   return (

src/layouts/RightContent.tsx

@@ -9,7 +9,6 @@ const safeLocalStorage = {
 
 const RightContent = () => {
   const [messageApi, contextHolder] = message.useMessage();
-  // NOTE: 多语言
   const intl = useIntl();
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
   const [localeType, setLocaleType] = useState(safeLocalStorage.getItem('umi_locale') || 'zh-CN');
@@ -46,7 +45,6 @@ const RightContent = () => {
   return (
     <>
       {contextHolder}
-      {/* NOTE: user */}
       <Popover
         title=""
         trigger="hover"
@@ -72,7 +70,6 @@ const RightContent = () => {
 
       <span className="mr-5 border-2 rounded-lg h-7" />
 
-      {/* NOTE: 换肤 */}
       <Popover
         trigger="hover"
         placement="bottom"
@@ -96,7 +93,6 @@ const RightContent = () => {
         <Button className="flex items-center justify-center" icon={<SkinOutlined />} />
       </Popover>
 
-      {/* NOTE: 多语言 */}
       <Popover
         className="mr-5 text-2xl"
         trigger="hover"
@@ -121,7 +117,6 @@ const RightContent = () => {
         <Button className="flex items-center justify-center" icon={<GlobalOutlined />} />
       </Popover>
 
-      {/* NOTE: GitHub 链接 */}
       <Button
         className="mr-6"
         icon={<GithubOutlined />}

src/models/global.ts

@@ -1,4 +1,3 @@
-// 全局共享数据示例
 import { DEFAULT_NAME } from '@/constants';
 import { useState } from 'react';
 

src/pages/Feature/FullCalendar/event-utils.tsx

@@ -1,7 +1,7 @@
 import { EventInput } from '@fullcalendar/core';
 
 let eventGuid = 0;
-let todayStr = new Date().toISOString().replace(/T.*$/, ''); // YYYY-MM-DD of today
+let todayStr = new Date().toISOString().replace(/T.*$/, '');
 
 export function createEventId() {
   return String(eventGuid++);

src/pages/Feature/FullCalendar/index.tsx

@@ -1,16 +1,8 @@
-/**
- * FullCalendar 日历 官网: https://fullcalendar.io/
- * dayGridPlugin 月视图
- * timeGridPlugin 周视图
- * interactionPlugin 交互
- * multiMonthPlugin 多月视图
- * zhLocale 语言
- */
 import { ProCard } from '@ant-design/pro-components';
 import { DateSelectArg, EventApi, EventClickArg, EventContentArg, formatDate } from '@fullcalendar/core';
 import zhLocale from '@fullcalendar/core/locales/zh-cn';
-import dayGridPlugin from '@fullcalendar/daygrid'; // a plugin!
-import interactionPlugin from '@fullcalendar/interaction'; // needed for dayClick
+import dayGridPlugin from '@fullcalendar/daygrid';
+import interactionPlugin from '@fullcalendar/interaction';
 import multiMonthPlugin from '@fullcalendar/multimonth';
 import FullCalendar from '@fullcalendar/react';
 import timeGridPlugin from '@fullcalendar/timegrid';
@@ -59,14 +51,10 @@ export default () => {
     return (
       <div className="demo-app-sidebar">
         <div className="demo-app-sidebar-section">
-          {/* <h2>Instructions</h2> */}
           <h2>说明: </h2>
           <ul>
-            {/* <li>Select dates and you will be prompted to create a new event</li> */}
             <li>选择日期，系统将提示您创建一个新事件</li>
-            {/* <li>Drag, drop, and resize events</li> */}
             <li>拖放和调整事件大小</li>
-            {/* <li>Click an event to delete it</li> */}
             <li>单击需要删除的事件</li>
           </ul>
         </div>
@@ -85,11 +73,11 @@ export default () => {
   };
 
   const handleDateSelect = (selectInfo: DateSelectArg) => {
-    // let title = prompt('Please enter a new title for your event');
     let title = prompt('请为您的活动输入一个新标题');
     let calendarApi = selectInfo.view.calendar;
 
-    calendarApi.unselect(); // clear date selection
+    // 清除日期选中状态，避免多次触发选中高亮
+    calendarApi.unselect();
 
     if (title) {
       calendarApi.addEvent({
@@ -103,12 +91,7 @@ export default () => {
   };
 
   const handleEventClick = (clickInfo: EventClickArg) => {
-    if (
-      confirm(
-        // `Are you sure you want to delete the event '${clickInfo.event.title}'`,
-        `您确定要删除事件吗 '${clickInfo.event.title}'`,
-      )
-    ) {
+    if (confirm(`您确定要删除事件吗 '${clickInfo.event.title}'`)) {
       clickInfo.event.remove();
     }
   };
@@ -124,43 +107,26 @@ export default () => {
     <ProCard className="shadow-2xl">
       <div className="demo-app">
         <FullCalendar
-          // 语言
           locale={zhLocale}
-          // 插件
           plugins={[dayGridPlugin, timeGridPlugin, interactionPlugin, multiMonthPlugin]}
           headerToolbar={{
             left: 'prev,next today',
             center: 'title',
             right: 'multiMonthYear,dayGridMonth,timeGridWeek,timeGridDay',
           }}
-          // 初始视图
           initialView="dayGridMonth"
           editable={true}
           selectable={true}
           selectMirror={true}
           dayMaxEvents={true}
-          // 日期
-          // weekends={false}
           weekends={state.weekendsVisible}
-          initialEvents={INITIAL_EVENTS} // 或者，使用' events '设置从提要中获取
+          // 使用静态初始事件；也可改为 events 属性从远程接口拉取
+          initialEvents={INITIAL_EVENTS}
           select={handleDateSelect}
-          eventContent={renderEventContent} // 自定义渲染功能
+          eventContent={renderEventContent}
           eventClick={handleEventClick}
-          eventsSet={handleEvents} // 在事件初始化/添加/更改/删除后调用
-          // 事件
-          // events={[
-          //   { title: 'event 1', date: '2023-08-15' },
-          //   { title: 'event 2', date: '2019-04-02' },
-          // ]}
-          // 点击日期
-          dateClick={(arg) => {
-            // alert(arg.dateStr)
-          }}
-          /* 你可以在这些触发时更新远程数据库:
-          eventAdd={function(){}}
-          eventChange={function(){}}
-          eventRemove={function(){}}
-        */
+          // 事件初始化/添加/更改/删除后均会触发，用于同步侧边栏事件列表
+          eventsSet={handleEvents}
         />
         <div className="shadow-2xl p-8 m-8">{renderSidebar()}</div>
       </div>

src/pages/Feature/Map/Cesium/Cesium.ts

@@ -1,18 +1,16 @@
 import * as Cesium from 'cesium';
 
-// NOTE: 这里的 CesiumMap 类是对 Cesium.Viewer 的封装，方便使用
 class CesiumMap {
-  private viewer: Cesium.Viewer; // Cesium.Viewer 实例
-  private cesiumContainer: string; // 容器 ID
+  private viewer: Cesium.Viewer;
+  private cesiumContainer: string;
 
-  // 构造函数
   constructor(cesiumContainer: string) {
     this.cesiumContainer = cesiumContainer;
     this.viewer = this.initViewer();
   }
 
-  // 初始化 Viewer
   private initViewer() {
+    // 每个 Viewer 实例需独立设置 token，确保在 app.tsx 全局初始化之外也能正常鉴权
     Cesium.Ion.defaultAccessToken = process.env.CESIUM_ION_TOKEN as string;
     return new Cesium.Viewer(this.cesiumContainer, {
       animation: false,
@@ -33,12 +31,10 @@ class CesiumMap {
     });
   }
 
-  // 获取 Viewer 实例
   public getViewer() {
     return this.viewer;
   }
 
-  // 销毁 Viewer
   public destroy() {
     this.viewer.destroy();
   }