@lark-apaas/coding-template-nestjs-react-fullstack 0.1.55-alpha.20261030035108 → 0.1.55-alpha.20261030085054

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-template-nestjs-react-fullstack",
-  "version": "0.1.55-alpha.20261030035108",
+  "version": "0.1.55-alpha.20261030085054",
   "description": "NestJS + React fullstack template for miaoda coding",
   "type": "module",
   "files": [

package/template/client/src/components/business-ui/README.md

@@ -522,7 +522,7 @@ function BasicExample() {
 
 `comment/comment-content.tsx` 提供不依赖 Tiptap 的只读展示，配合 `comment/mention-provider.tsx` 批量补全人员和文档信息。
 
-评论输入框已内置。从 `@/components/business-ui/comment/comment-input` 直接导入 `CommentInput`，组件提供 getContent/clear/setEditable/focus ref API 和 onSubmitRequest 快捷键回调，发送、取消按钮及请求状态由页面组合，首次激活时动态加载 div 编辑器；支持选择/粘贴图片并在正文下方展示附件，使用 getImages/clearImages 管理。只读 `CommentContent` 不依赖编辑器。作者、时间、线程与接口调用由消费页面组合。
+评论输入框已内置。从 `@/components/business-ui/comment/comment-input` 直接导入 `CommentInput`，组件提供 getContent/clear/setEditable/focus ref API 和 onSubmitRequest 快捷键回调，发送、取消按钮及请求状态由页面组合，首次激活时动态加载最小 Tiptap 编辑器。只读 `CommentContent` 不依赖编辑器。作者、时间、线程与接口调用由消费页面组合。
 
 数据源和真实服务的接入要求见 [CommentInput 使用说明](./comment/README.md)。输入与只读列表应共享同一 CommentProvider；CCM 的 Lark ID 与模板的 apaas ID 不能混用。
 

package/template/client/src/components/business-ui/comment/README.md

@@ -3,7 +3,7 @@
 面向 AI 生成的多维表格评论界面，只提供两个基础组件：
 
 - `CommentContent`：直接渲染 `reply.content`，内部补全人员与文档信息。
-- `CommentInput`：使用 contenteditable div 编辑文字、@人员与文档，支持独立图片附件区，暴露 ref API。按钮、请求、loading 和发送错误由页面组合。
+- `CommentInput`：编辑文字、@人员与文档，暴露 ref API。按钮、请求、loading 和发送错误由页面组合。
 
 作者、时间、评论线程、回复、分页和解决状态均由业务页面处理。组件不包含这些业务包装。
 
@@ -20,7 +20,7 @@ type CommentApiContent =
 
 userID 是妙搭用户 ID，与 UserDisplay 一致。缺失 userID 的历史 mention 显示“引用信息缺失”，读取时仍原样返回，是否提交由页面决定。数字 ID 不得静默舍入。
 
-文档通过 link(url) 提交，内部 token、类型、标题和图标不进入接口数据。识别出的飞书文档 URL 可按 token 补全元数据；其他 URL 显示为普通链接。图片是正文下方的独立附件，不混入这三个 content 类型；旧 CCM `<at>` 内容格式不在组件范围内。
+文档通过 link(url) 提交，内部 token、类型、标题和图标不进入接口数据。识别出的飞书文档 URL 可按 token 补全元数据；其他 URL 显示为普通链接。图片和旧 CCM `<at>` 内容格式不在组件范围内。
 
 ## 使用
 
@@ -73,13 +73,11 @@ export function CommentExample({ save }: { save: (body: CommentSubmitPayload) =>
 
 - `getContent()`：读取最新接口 content，不做发送状态校验；编辑器尚未加载时也可读取草稿。
 - `clear()`：普通的正文清空操作，保留撤销历史，不重建编辑会话。
-- `getImages()`：读取附件状态与上传结果的快照，不自动转换成多维表格图片协议。
-- `clearImages()`：删除全部附件并取消/忽略上传，释放本地预览地址。附件独立于正文撤销历史。
-- `setEditable(boolean)`：控制正文、上传按钮及附件删除/重试；disabled prop 是外部硬禁用。
+- `setEditable(boolean)`：控制编辑；disabled prop 是外部硬禁用。
 - `focus()`：聚焦输入框，必要时加载编辑器。
 - `onSubmitRequest`：Enter（或 submitMode="mod-enter"）通知页面；输入法确认和 @候选选择优先处理，未配置时 Enter 换行。
 
-入口动态 import div 编辑器，首次激活时挂载；不依赖 Tiptap/ProseMirror。加载失败可重试。popover 挂在 Dialog/Sheet 时可传 portalContainer。React 管理外框、候选面板与附件，正文 DOM 由 DivEditor 独立管理，避免受控回写破坏光标和输入法。
+入口动态 import 最小 Tiptap 3.20.0，首次激活时挂载编辑器；只读组件不导入 Tiptap。加载失败可重试。popover 挂在 Dialog/Sheet 时可传 portalContainer。
 
 ## 搜索与回显
 
@@ -109,31 +107,3 @@ const documents = createCcmDocumentSource({
 CommentContent 的 onMentionClick(ref, anchor) 仅透出人员点击，由消费页面复用 UserProfile。元数据加载前也可点击，回显更新保持锚点 DOM 稳定。
 
 在生成应用中运行 `npm run type:check:client` 和 `npm run build:client`；浏览器中另行验证中文输入法、键盘候选操作、撤销、回填和弹层位置。类型检查与构建不代表真实接口鉴权或视觉验收完成。
-
-## 图片附件与权限意图
-
-```tsx
-<CommentInput
-  ref={inputRef}
-  documentKey="new"
-  value={value}
-  onChange={setValue}
-  enableDocuments
-  enableImages
-  onImagesChange={setImages}
-  grantMentionAccess={grantMentionAccess}
-  onGrantMentionAccessChange={setGrantMentionAccess}
-/>
-```
-
-图片区按参考图排列在正文下方，64px 缩略图、圆角与右上角删除按钮；点击缩略图可预览。选择文件、粘贴或拖入正文均追加到附件区，不占正文光标位置。支持 PNG/JPEG/WebP/GIF/AVIF/BMP；默认最多 9 张、单张 10 MiB，通过 maxImages/maxImageSize 调整。最多 3 个并发上传，上传中显示加载状态，失败可重试。
-
-默认延迟导入模板已有的 api/files/service 上传到妙搭存储。可通过 uploadImage(file, { signal }) 注入自定义服务，返回 `{ id, url, filePath?, bucketId? }`。删除、clearImages、切换 documentKey、切换数据源作用域和卸载都会取消或忽略迟到的上传结果；默认 SDK 不支持真正取消网络请求。删除和卸载时释放 Object URL；失败文件仅保留到重试或删除。
-
-getImages 返回 `{ id, name, size, previewUrl, status, result?, error? }[]`：id 是本地附件 ID，result.id 才是服务端文件 ID；previewUrl 是临时 Blob URL，不能提交或持久化。页面通过 onImagesChange 判断是否仍有 uploading/error 状态，自行控制发送按钮，并把 result 映射到真实接口。当前未确认多维表格图片提交协议，因此 getContent 继续只返回 text/mention/link，CommentContent 继续只渲染正文。
-
-如需在发送成功后重置整个输入区，依次调用 clear() 与 clearImages()。这两个方法不执行发送校验，也不处理发送失败；失败时是否保留内容由页面决定。切换 documentKey 表示新会话，正文撤销和附件都重置。
-
-“授予提及的人阅读权限”仅在传入 onGrantMentionAccessChange 时显示，属于受控的业务意图，组件不直接调用文档授权接口。消费页面负责结合勾选值执行真实授权。
-
-正文使用统一的自有撤销历史，覆盖文字、引用插入/删除、粘贴和 clear。连续文字合并为一组，输入法组合输入作为一组；元数据回显不产生编辑历史，外部替换 value 会重置正文历史。保留旧结构转换函数供已有调用方过渡，新实现不使用它们。

package/template/client/src/components/business-ui/comment/comment-input.tsx

@@ -18,7 +18,11 @@ import type {
   CommentInputHandle,
   CommentEditorProps,
 } from './types';
-import { emptyComment, normalizeValue, readApiContent } from './content';
+import {
+  emptyComment,
+  normalizeValue,
+  readApiContent,
+} from './content';
 
 let modulePromise: Promise<typeof import('./editor')> | undefined;
 function loadEditor() {
@@ -32,7 +36,7 @@ export function preloadCommentEditor() {
   void loadEditor().catch(() => {});
 }
 
-/** Public entry keeps editing and uploads deferred. A session change resets all work. */
+/** Public entry contains no static import of Tiptap. A session change resets all work. */
 export function CommentInput(props: CommentInputProps) {
   const { store } = useMentionContext();
   try {
@@ -108,11 +112,6 @@ function InputSession(props: CommentInputProps) {
     () => ({
       getContent: () =>
         editorRef.current?.getContent() ?? readApiContent(latest.current.value),
-      getImages: () => editorRef.current?.getImages() ?? [],
-      clearImages() {
-        if (!alive.current) return;
-        editorRef.current?.clearImages();
-      },
       clear() {
         if (!alive.current) return;
         if (editorRef.current) editorRef.current.clear();
@@ -125,7 +124,7 @@ function InputSession(props: CommentInputProps) {
       setEditable(next) {
         if (!alive.current) return;
         editable.current = next;
-        editorRef.current?.setEditable(next);
+        editorRef.current?.setEditable(next && !latest.current.disabled);
         setEnabled(next);
       },
       focus() {

package/template/client/src/components/business-ui/comment/content.ts

@@ -155,7 +155,7 @@ export function mentionLabel(
   return (!strict && label) || (ref.kind === 'user' ? '用户' : '文档');
 }
 
-/** @deprecated Legacy structural conversion; the div editor uses CommentValue directly. */
+/** Deliberately structural: these utilities have no runtime or type import from Tiptap. */
 export interface EditorDocument {
   type?: string;
   text?: string;
@@ -163,7 +163,6 @@ export interface EditorDocument {
   content?: EditorDocument[];
 }
 
-/** @deprecated Retained for existing consumers; new code uses CommentValue directly. */
 export function toEditorDocument(value: CommentValue): EditorDocument {
   return {
     type: 'doc',
@@ -195,7 +194,6 @@ export function toEditorDocument(value: CommentValue): EditorDocument {
   };
 }
 
-/** @deprecated Retained for existing consumers; new code uses CommentValue directly. */
 export function fromEditorDocument(doc: EditorDocument): CommentValue {
   if (doc.type !== 'doc') throw new Error('无效的评论编辑文档');
   const content: CommentPart[] = [];