create-react-admin-template 0.0.0-stage → 0.1.0

package/template/docs/query-data-conventions.md

@@ -0,0 +1,178 @@
+# Query Key 与 Mutation 一致性约定
+
+这份约定是脚手架内所有 Feature 使用 TanStack Query 的公共缓存契约。它解决同一浏览器
+会话中用户、租户、语言或工作空间切换后的数据隔离，以及 Mutation 成功、失败和并发时
+缓存如何收敛。它不包装 `useQuery`/`useMutation`，也不替代 Feature 自己的 DTO 映射、
+Repository 和权限规则。
+
+公共入口统一从 `@/api/query` 导入。主要消费者是 Feature 查询 Hook、
+路由 Loader 和 Mutation；枚举与全局参数拥有自己的目录级 Key，但仍遵循相同的租户、
+语言、授权版本和取消原则。
+
+## 缓存身份
+
+Feature 在 React 中调用 `useAppQueryScope()`，作用域由当前认证状态和 Locale 唯一来源
+派生，不允许页面自行传入另一个用户或租户：
+
+| 字段                 | 含义                                         | 变化后的行为                 |
+| -------------------- | -------------------------------------------- | ---------------------------- |
+| `strUserId`          | 当前稳定用户 ID；未登录统一为 `anonymous`    | 使用新 Key，旧会话缓存被清理 |
+| `strTenantId`        | 当前租户 ID；单租户系统省略                  | 使用新 Key，重新请求         |
+| `strLocale`          | 当前应用语言                                 | 使用新 Key，重新请求         |
+| `nSessionGeneration` | 登录、退出、角色、权限或租户变化后的会话版本 | 使用新 Key并重新校验权限     |
+| `strWorkspaceId`     | Feature 显式传入的工作空间；默认不启用       | 使用新 Key，重新请求         |
+
+作用域只能包含稳定标识，不能放入 Access Token、Refresh Token、Cookie、邮箱、手机号或
+其他凭据和个人信息。用户、租户或授权上下文变化时，认证生命周期还会清理 QueryClient，
+作为防止跨会话数据残留的第二道边界。
+
+React 外的路由 Loader 从认证状态取得用户与租户；需要工作空间隔离时，把所属 Feature 已
+校验的 `strWorkspaceId` 传给 `fnCreateAppQueryScope()`。项目启用 `tenantWorkspace` 可选能力
+后，也可以使用 `fnGetTenantWorkspaceCurrent()` 读取选择结果，但仍需显式传入查询作用域。
+切换顺序、失败恢复和 Adapter 接入见
+[`tenant-workspace-context.md`](tenant-workspace-context.md)。
+
+## Key 层级
+
+每个 Feature 使用 `fnCreateAppQueryKeys(strFeature, objScope)` 创建工厂，Key 固定为以下
+层级：
+
+```text
+appQuery
+└── feature
+    └── user + tenant + locale + session + workspace
+        └── resource
+            ├── list
+            │   └── filters + sort + page
+            └── detail
+                └── entityId
+```
+
+| 工厂成员                           | 用途                                      |
+| ---------------------------------- | ----------------------------------------- |
+| `arrAll`                           | 当前 Feature 的所有作用域，只用于清理诊断 |
+| `arrScope`                         | 当前身份作用域内该 Feature 的全部查询     |
+| `fnResource('records')`            | 当前资源的列表和详情根 Key                |
+| `fnLists('records')`               | 当前资源的全部列表                        |
+| `fnList('records', objParameters)` | 一个精确列表                              |
+| `fnDetails('records')`             | 当前资源的全部详情                        |
+| `fnDetail('records', strRecordId)` | 一个精确详情                              |
+
+列表参数必须是只读、JSON 可序列化的数据。日期先转为 ISO 字符串；省略未定义字段；不能传
+`Date`、函数、类实例、DOM、Signal 或 Token。分页、排序、筛选的服务端语义只要不同，就
+必须进入参数对象。顶层字段会按名称规范化，避免对象声明顺序制造重复缓存。
+
+Query Key 只标识服务端缓存，不负责浏览器刷新、分享或前进后退。AppTable 的查询、排序和
+分页参数应直接进入列表 Query Key；确实需要可分享 URL 时，由所属 Feature 的路由 Schema
+读写同一份已校验参数，不再引入全局页面筛选状态层。
+
+```tsx
+const objScope = useAppQueryScope()
+const objKeys = useMemo(
+  () => fnCreateAppQueryKeys('recordDirectory', objScope),
+  [objScope]
+)
+const objQuery = useQuery({
+  queryKey: objKeys.fnList('records', {
+    nPage: objSearch.nPage,
+    strKeyword: objSearch.strKeyword,
+  }),
+  queryFn: ({ signal: objSignal }) =>
+    objRecordRepository.fnList(objSearch, objSignal),
+})
+```
+
+Repository 的 connected Adapter 必须把 `objSignal` 继续传给 Swagger 生成客户端。用户
+离开页面、Key 变化或 Query 被替换时才能真正取消网络请求。服务端数据只保留在 Query
+缓存中，不复制到 Zustand。
+
+## Mutation 失效矩阵
+
+失效使用最小但完整的资源根 Key。`exact: true` 只用于确定的单条详情；省略 `exact` 时
+按前缀覆盖该根下的列表或详情。
+
+| Mutation 结果 | 成功后的缓存动作                                                |
+| ------------- | --------------------------------------------------------------- |
+| 创建          | 失效 `fnLists(resource)`                                        |
+| 更新          | 失效精确 `fnDetail(resource, id)`，同时失效 `fnLists(resource)` |
+| 删除          | 移除精确详情，再失效 `fnLists(resource)`                        |
+| 批量操作      | 失效 `fnResource(resource)`；部分成功时由返回结果决定更小范围   |
+| 关联资源变化  | 同时失效被当前 Mutation 实际改变的其他资源根 Key                |
+
+不要在 `onSuccess` 手工拼接 Key。成功后失效由服务器重新确认最终状态；请求失败时保留最后
+一次有效服务端数据。错误提示继续使用统一 `ApiError` 和请求关联 ID。
+
+## 乐观更新与回滚
+
+只有可逆、冲突边界明确且用户确实需要即时反馈的操作才做乐观更新。使用
+`fnApplyOptimisticQueryUpdate()` 会先取消同一精确 Query，再保存快照并写入乐观值；
+`onError` 使用 `fnRollbackOptimisticQueryUpdate()` 恢复旧值。原 Query 不存在时，回滚会
+删除临时缓存，而不是留下伪造的服务端数据。
+
+```tsx
+const objMutation = useMutation({
+  mutationFn: (objInput) =>
+    objRecordRepository.fnUpdate(strRecordId, objInput),
+  scope: fnCreateAppMutationScope(
+    objKeys.fnDetail('records', strRecordId)
+  ),
+  onMutate: (objInput) =>
+    fnApplyOptimisticQueryUpdate(
+      objQueryClient,
+      objKeys.fnDetail('records', strRecordId),
+      (objRecord) => ({ ...objRecord, ...objInput })
+    ),
+  onError: (_objError, _objInput, objSnapshot) => {
+    if (objSnapshot) {
+      fnRollbackOptimisticQueryUpdate(objQueryClient, objSnapshot)
+    }
+  },
+  onSettled: async () => {
+    await Promise.all([
+      objQueryClient.invalidateQueries({
+        exact: true,
+        queryKey: objKeys.fnDetail('records', strRecordId),
+      }),
+      objQueryClient.invalidateQueries({
+        queryKey: objKeys.fnLists('records'),
+      }),
+    ])
+  },
+})
+```
+
+按钮和路由使用前端权限系统控制可见性与可操作性；Mutation 仍直接调用生成客户端，
+最终授权由后端执行。后端返回的 `401/403` 通过统一 `ApiError` 进入回滚和错误反馈。
+
+删除、审批、付款、批量导入等不可逆或部分成功操作默认不做乐观更新。它们等待后端返回，
+展示明确提交状态，再按实际结果失效缓存。
+
+批量选择由 Table 提供，Feature 使用后端批量接口并组合权限、二次确认和幂等执行；不能在
+页面循环调用单条 Mutation。部分成功与失败明细按具体后端契约在 Feature 内展示。
+
+## 并发策略
+
+`fnCreateAppMutationScope()` 从资源或详情 Key 生成 TanStack Mutation `scope`。相同 scope
+串行执行，不同 scope 并行：
+
+- 绑定单个实体的编辑 Hook 使用 `fnDetail()`，只串行同一实体写入。
+- 通用创建或批量 Hook 使用 `fnResource()`，以资源级串行作为安全默认值。
+- 不要为所有 Feature 共用一个全局 scope，否则无关写入会互相阻塞。
+- Mutation 完成后仍执行失效；串行只能控制客户端顺序，不能替代后端版本检查、事务和
+  幂等约束。
+
+请求超时后的重复提交遵循
+[`mutation-idempotency.md`](mutation-idempotency.md) 的原键重试约定；在后端提供幂等协议前
+仍不能由 Query Key 伪装解决。遇到版本冲突时应展示服务端返回的冲突错误并重新获取数据，
+不能用本地乐观值覆盖较新的服务端事实。
+
+## 不支持范围
+
+- 不提供万能 CRUD Hook、全局 Repository 注册表或事件总线。
+- 不把生成 DTO 直接当作 Feature 领域模型；映射边界由 Feature 拥有。
+- 不用 Query 缓存替代后端授权、事务、审计或幂等。
+- 不自动持久化服务端缓存到 Local Storage。
+- 不强制枚举、参数等目录型基础设施迁移到 Feature Key 形状。
+
+新增 Feature 时应通过公共工厂创建所有 Key，并为至少一个列表失效、详情失效、错误回滚
+或并发场景补充行为测试。工具层 Feature 数据模板直接复用这份契约。

package/template/docs/realtime-collaboration.md

@@ -0,0 +1,140 @@
+# 实时协作接入
+
+`src/realtimeCollaboration` 提供厂商中立的文档协作会话边界。它负责
+连接竞态、状态订阅、成员列表、手动重连和路由卸载清理；不实现 CRDT、编辑器绑定、
+光标映射、离线合并或供应商协议。
+
+## 职责边界
+
+| 层级                        | 必须负责                                                  | 不负责内容                         |
+| --------------------------- | --------------------------------------------------------- | ---------------------------------- |
+| 业务后端                    | 文档级最终授权、短期会话票据、撤销、限流和审计            | 信任前端入口显隐                   |
+| 协作服务或供应商            | CRDT、WebSocket、重连、冲突收敛、光标和编辑器 Provider    | 应用路由和业务权限                 |
+| 项目 Adapter                | 请求短期票据、懒加载 SDK、建立连接并映射稳定事件          | 暴露 Token、管理密钥或原始文档内容 |
+| `src/realtimeCollaboration` | 会话生命周期、竞态取消、运行时校验、成员状态和 React Hook | 持久化服务端状态或实现协作算法     |
+| 文档 Feature                | 编辑器界面、在线成员展示、同步状态、错误和只读体验        | 直接持有全局 WebSocket             |
+
+协作权限必须由后端按当前身份、租户、工作空间、文档和请求模式重新判断。路由与按钮
+可以用前端权限系统改善体验，但 Hook 不重复执行客户端授权。
+
+## Adapter 与短期会话
+
+Adapter 是具体 SDK 的唯一入口。建议先使用 Swagger 生成客户端向业务后端申请一次性或
+短时协作票据，再动态加载供应商 SDK。浏览器不能持有供应商管理密钥，票据不能进入
+URL、日志、可观测性事件、全局 Store 或返回快照。
+
+```ts
+import type { ICollaborationAdapter } from '@/realtimeCollaboration'
+import { objGeneratedApi } from '@/api/generated/project'
+
+interface IEditorBinding {
+  readonly objProvider: VendorProvider
+  readonly objSharedText: VendorSharedText
+}
+
+export const objContractCollaborationAdapter: ICollaborationAdapter<
+  IEditorBinding
+> = {
+  async fnConnect(objRequest) {
+    const objSessionResponse = await objGeneratedApi.collaboration.open(
+      {
+        documentId: objRequest.strDocumentId,
+        documentType: objRequest.strDocumentType,
+        mode: objRequest.strMode,
+        workspaceId: objRequest.objScope.strWorkspaceId,
+      },
+      { signal: objRequest.objSignal }
+    )
+    const { fnConnectVendorDocument } = await import(
+      './vendorCollaborationAdapter'
+    )
+
+    return fnConnectVendorDocument({
+      objSignal: objRequest.objSignal,
+      strSessionTicket: objSessionResponse.data.sessionTicket,
+    })
+  },
+}
+```
+
+`fnConnectVendorDocument` 必须返回 `ICollaborationConnection<TBinding>`：
+
+- `objBinding` 是编辑器集成所需的项目强类型对象，基础层不会读取或持久化。
+- `arrParticipants` 和后续 `participantsChanged` 都是最新完整列表，不是增量事件。
+- `fnSubscribe` 返回解除全部监听器的清理函数。
+- `fnDisconnect` 关闭 Provider、WebSocket、Awareness、CRDT 文档和编辑器绑定，且可重复调用。
+- `connectionChanged` 表示 SDK 正在自动重连；无法恢复时发送 `sessionFailed`。
+- `sessionFailed.strReasonCode` 只能是稳定、非敏感原因码。
+
+Adapter 必须监听 `objSignal`。即使供应商初始化无法真正取消，也要在取消后立即释放
+迟到的连接；控制器只允许最后一次文档请求成为活动会话。
+
+## 路由级消费
+
+实时协作不能装到应用根 Provider，也不提供默认页面、路由或菜单。文档 Feature 应
+按路由懒加载编辑器、Adapter 和供应商 SDK：
+
+```tsx
+import { useRealtimeCollaboration } from '@/realtimeCollaboration'
+import { objContractCollaborationAdapter } from './collaborationAdapter'
+
+export function ContractEditor({ strDocumentId }: { strDocumentId: string }) {
+  const objCollaboration = useRealtimeCollaboration({
+    objAdapter: objContractCollaborationAdapter,
+    strDocumentId,
+    strDocumentType: 'contract',
+    strMode: 'edit',
+  })
+
+  if (objCollaboration.strStatus === 'connecting') {
+    return <p>正在连接协作文档…</p>
+  }
+  if (objCollaboration.strStatus === 'error') {
+    return (
+      <button onClick={objCollaboration.fnReconnect}>重新连接</button>
+    )
+  }
+  if (objCollaboration.strStatus !== 'active') return null
+
+  return <ContractEditorView objBinding={objCollaboration.objBinding} />
+}
+```
+
+身份、会话版本、租户、工作空间、语言、文档或模式变化时，Hook 会关闭旧会话再建立
+新会话。路由卸载、`bIsEnabled` 关闭或显式调用 `fnClose` 时会取消连接、退订事件并
+释放 SDK。`fnReconnect` 只用于致命失败后的用户重试；网络抖动的自动重连策略属于
+SDK，并通过 `strConnectionState: 'reconnecting'` 呈现。
+
+## 状态与用户体验
+
+- `idle`：未启用或已经关闭，不展示陈旧编辑器绑定。
+- `connecting`：申请票据或初始化 SDK，可展示可取消的连接反馈。
+- `active`：可读取 `objBinding`、成员列表、连接状态和同步状态。
+- `error`：连接失败或 SDK 状态无效，旧连接已经释放，可提供手动重连。
+
+编辑模式应同时检查 `strMode` 和编辑器自身只读状态。同步中不能虚构“已保存”；只有
+SDK 报告 `synced` 才能展示已同步。成员名称只作为 React 纯文本渲染，不允许作为
+HTML；脚手架只接受有界的名称、成员 ID、用户 ID 和 active/idle 状态，不提供任意
+成员元数据载荷。
+
+## 安全、隐私与运维
+
+- 票据必须短期有效、限定文档和模式，并支持权限撤销后断开现有连接。
+- WebSocket 鉴权、Origin 校验、消息大小、速率、最大成员数和租户隔离由服务端负责。
+- Token、Cookie、票据、文档正文、选区内容、DOM 节点和成员个人数据默认禁止采集。
+- CSP 的 `connect-src` 只放行选定协作域名；SDK 版本、许可证和供应链风险进入项目审查。
+- 通过 P2-02 Feature Flag/Kill Switch 控制入口和新建连接；后端仍需独立关闭能力。
+- 供应商故障时应允许安全只读、下载或稍后重试，具体降级由文档 Feature 决定。
+
+离线缓存、后台同步、权限过期后的本地数据清理和离线冲突交互属于 P2-08，不能因为
+SDK 默认能力而隐式开启。更换供应商前，应验证 Binding 隔离使编辑器 Feature 不依赖
+管理 API、内部事件名或票据格式。
+
+## 验收重点
+
+- 无权限时不会调用项目 Adapter，后端仍会对实际连接再次授权。
+- 快速切换文档时只有最后一次连接可见，迟到连接会立即释放。
+- 路由卸载会取消请求、解除订阅并断开协作资源。
+- 成员列表、状态值、重复 ID、最大成员数和安全原因码经过运行时校验。
+- 供应商异常事件会关闭当前会话，不泄漏底层异常、票据或文档内容。
+- 模块没有根 Provider、默认业务页面、供应商依赖或首屏静态导入。

package/template/docs/reporting-printing-templates.md

@@ -0,0 +1,156 @@
+# 报表、打印和模板接入
+
+`src/reporting` 提供模板目录、服务端报表生成和当前路由打印的厂商中立边界。它复用
+`src/files` 的任务生命周期与受保护下载能力，不包含模板设计器、通用参数表单、PDF
+引擎、Office SDK 或具体业务报表。
+
+## 能力边界
+
+| 场景          | 脚手架负责                                     | 项目或后端负责                               |
+| ------------- | ---------------------------------------------- | -------------------------------------------- |
+| AppTable 导出 | 已有当前页/选择/全部、CSV/XLSX 和异步任务能力  | 具体字段、权限、行数和后端导出               |
+| 模板目录      | 身份作用域缓存、运行时校验和失效               | 模板制作、版本发布、授权和参数 DTO           |
+| 报表生成      | 取消、重试、轮询、进度、格式/MIME/文件身份校验 | 数据查询、渲染、资源限制、文件存储和最终授权 |
+| 浏览器打印    | 调用当前路由的原生打印                         | 入口权限、打印版式、分页和浏览器兼容性       |
+| 生成文件消费  | 复用文件下载和预览边界                         | 按 `fileId` 重新授权并返回真实文件           |
+
+普通表格导出继续使用 `AppTable.exportOptions`，不要为了名称统一迁移到本模块。复杂 PDF、
+固定格式合同、凭证、标签、套打和跨数据源汇总才使用服务端模板报表。
+
+## 模板目录
+
+模板目录必须来自后端接口，并且只返回当前用户在当前租户和工作空间有权使用的模板。
+`fnCreateReportTemplateSource` 用于把 Swagger 生成客户端包装成经过校验的数据源：
+
+```ts
+import { fnCreateReportTemplateSource } from '@/reporting'
+import { objGeneratedApi } from '@/api/generated/project'
+
+export const objReportTemplateSource = fnCreateReportTemplateSource(
+  async ({ objSignal }) => {
+    const objResponse = await objGeneratedApi.reportTemplates.list({
+      signal: objSignal,
+    })
+    return {
+      arrTemplates: objResponse.data.items.map((objTemplate) => ({
+        arrFormats: objTemplate.formats,
+        strDescription: objTemplate.description,
+        strTemplateId: objTemplate.id,
+        strTemplateName: objTemplate.name,
+        strTemplateVersion: objTemplate.version,
+      })),
+      strCatalogVersion: objResponse.data.version,
+    }
+  }
+)
+```
+
+Feature 使用 `useReportTemplates` 获取目录。缓存 Key 自动包含用户、会话版本、租户、
+工作空间和语言；后端发布、停用模板或权限变更后可调用
+`fnInvalidateReportTemplates`。目录最多 200 项，拒绝重复模板 ID、重复格式和未知格式。
+
+目录只包含 ID、名称、说明、不可变版本和输出格式，不接受 HTML、模板正文、任意配置
+对象或供应商内部表达式。参数控件由具体 Feature 使用 `AppPageForm` 和 Swagger DTO
+声明，脚手架不会根据任意 JSON Schema 生成万能业务表单。
+
+## 服务端报表生成
+
+`useReportGeneration<TParameters>` 复用 `useFileTask` 的 `starting`、`queued`、
+`running`、`success`、`error` 和 `canceled` 状态。`TParameters` 应直接使用生成客户端的
+请求 DTO 或 Feature 明确映射后的类型：
+
+```tsx
+import { useReportGeneration } from '@/reporting'
+import type { ContractReportRequest } from '@/api/generated/project'
+
+const objReportTask = useReportGeneration<ContractReportRequest>({
+  objSource: {
+    async fnStartReport({ objRequest, objScope, objSignal }) {
+      const objResponse = await objGeneratedApi.reports.create(
+        {
+          format: objRequest.strFormat,
+          parameters: objRequest.objParameters,
+          templateId: objRequest.strTemplateId,
+          templateVersion: objRequest.strTemplateVersion,
+          workspaceId: objScope.strWorkspaceId,
+        },
+        { signal: objSignal }
+      )
+      return objResponse.data.completed
+        ? {
+            strMode: 'completed',
+            objResult: fnMapReportOutput(objResponse.data),
+          }
+        : {
+            strMode: 'background',
+            strTaskId: objResponse.data.taskId,
+          }
+    },
+    async fnPollReport({ objSignal, strTaskId }) {
+      const objResponse = await objGeneratedApi.reports.detail(strTaskId, {
+        signal: objSignal,
+      })
+      return fnMapReportTask(objResponse.data)
+    },
+  },
+})
+
+await objReportTask.fnRun({
+  objParameters: { contractId: strContractId },
+  strFormat: 'pdf',
+  strTemplateId: objTemplate.strTemplateId,
+  strTemplateVersion: objTemplate.strTemplateVersion,
+})
+```
+
+生成结果只允许返回 `reportId`、`fileId`、清理后的文件名、格式和对应 MIME，不允许
+返回 Blob、任意 URL 或模板 HTML。支持 PDF、DOCX、XLSX 和 CSV；文件名扩展名会与
+格式对齐，格式替换、HTML MIME、无效进度和未知任务状态都会失败。
+
+任务成功后，Feature 使用 `fnDownloadFile` 携带 `fileId` 调用受保护下载接口；预览 PDF
+时复用 `FilePreview`。下载接口必须重新确认用户、租户、文件归属和有效期，不能因为
+生成请求曾经成功就永久公开文件。
+
+## 当前路由打印
+
+简单详情页、凭证或已经安全渲染的报表页面可使用原生浏览器打印：
+
+```tsx
+import { fnPrintCurrentDocument } from '@/reporting'
+
+<button
+  type='button'
+  onClick={() => fnPrintCurrentDocument()}
+>
+  打印
+</button>
+```
+
+打印函数不接收 HTML 字符串或 URL，只打印当前受控路由。Feature 使用语义化 HTML 和
+局部 `@media print` 样式隐藏导航、操作区并定义分页；不要用 `document.write`、
+`innerHTML` 或弹出窗口拼接模板。浏览器 API 无法可靠区分用户打印、另存 PDF 或取消，
+因此不能仅根据 `window.print()` 返回值记录“打印成功”的权威审计事实。
+
+需要像素级套打、批量打印、可信页码、服务器字体、电子签章或可重复归档时，应由后端
+生成 PDF，再走受保护文件预览/下载。浏览器打印不能作为合规归档结果。
+
+## 安全与服务端要求
+
+- 服务端按当前身份、租户、工作空间、模板、版本、参数和数据范围执行最终授权。
+- 参数 DTO、最大时间范围、最大行数、并发任务、执行时长和文件大小必须有硬限制。
+- 模板发布采用不可变版本；旧版本撤销后，服务端拒绝新的生成请求。
+- 模板表达式和辅助函数采用白名单沙箱，禁止文件系统、网络、进程和任意代码执行。
+- CSV/XLSX 生成必须防止公式注入；PDF/DOCX 资源地址必须经过协议与 Origin 控制。
+- 文件元数据、模板内容、业务参数、报表正文、Token 和签名 URL 不进入前端日志。
+- 生成、下载和高风险打印入口应产生后端审计事实，并支持 P2-02 Kill Switch。
+- 外部 PDF/Office 服务或字体 CDN 必须经过许可证、数据合规、CSP 和退出策略审查。
+
+## 按需加载和验收
+
+报表路由应懒加载报表 Feature、模板参数表单和任何项目选定的渲染 SDK。本模块不接入
+应用根 Provider、默认路由或菜单；Knip 入口只声明它是脚手架的可选公共能力，不会让
+代码进入生产首屏模块图。
+
+验收至少覆盖：后端 `401/403` 错误反馈、模板目录隔离身份作用域、任务取消与重试、同步
+和后台结果、格式/MIME 替换、恶意文件名、模板版本失效、受保护下载，以及主要目标
+浏览器的分页、长表格、中文字体和打印预览。