openxiangda 1.0.151 → 1.0.152

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/README.md +2 -0
  2. package/openxiangda-skills/SKILL.md +1 -0
  3. package/openxiangda-skills/references/component-guide.md +4 -0
  4. package/openxiangda-skills/references/pages/page-sdk.md +3 -2
  5. package/package.json +6 -2
  6. package/packages/sdk/dist/{ProcessPreview-BOCARAvP.d.mts → ProcessPreview-B_HqjU7v.d.mts} +4 -2
  7. package/packages/sdk/dist/{ProcessPreview-BOCARAvP.d.ts → ProcessPreview-B_HqjU7v.d.ts} +4 -2
  8. package/packages/sdk/dist/components/index.cjs +3488 -2270
  9. package/packages/sdk/dist/components/index.cjs.map +1 -1
  10. package/packages/sdk/dist/components/index.d.mts +145 -38
  11. package/packages/sdk/dist/components/index.d.ts +145 -38
  12. package/packages/sdk/dist/components/index.mjs +3240 -2017
  13. package/packages/sdk/dist/components/index.mjs.map +1 -1
  14. package/packages/sdk/dist/{dataManagementApi-CLMqf79O.d.mts → dataManagementApi-CEDsA3tT.d.ts} +2 -2
  15. package/packages/sdk/dist/{dataManagementApi-DhpRKmlp.d.ts → dataManagementApi-quq3Zhgo.d.mts} +2 -2
  16. package/packages/sdk/dist/runtime/index.cjs +3172 -2301
  17. package/packages/sdk/dist/runtime/index.cjs.map +1 -1
  18. package/packages/sdk/dist/runtime/index.d.mts +5 -4
  19. package/packages/sdk/dist/runtime/index.d.ts +5 -4
  20. package/packages/sdk/dist/runtime/index.mjs +3068 -2192
  21. package/packages/sdk/dist/runtime/index.mjs.map +1 -1
  22. package/packages/sdk/dist/runtime/react.cjs +2 -2
  23. package/packages/sdk/dist/runtime/react.cjs.map +1 -1
  24. package/packages/sdk/dist/runtime/react.d.mts +9 -4
  25. package/packages/sdk/dist/runtime/react.d.ts +9 -4
  26. package/packages/sdk/dist/runtime/react.mjs +2 -2
  27. package/packages/sdk/dist/runtime/react.mjs.map +1 -1
  28. package/templates/openxiangda-react-spa/AGENTS.md +2 -0
package/templates/openxiangda-react-spa/AGENTS.md CHANGED
@@ -128,6 +128,8 @@ import { PermissionBoundary, useAppMenus, useRuntimeBootstrap } from "openxiangd
128
128
 
129
129
  - 应用代码优先使用 `AttachmentField`，或通过 React SPA PageSdk（`usePageSdk()` 返回的 `sdk`）调用 `sdk.createFileAccessTicket(bucketName, objectName, fileName, "preview", { appType })` 获取 `previewPageUrl` 后打开。
130
130
  - `previewPageUrl` 是给用户打开的页面入口；`previewUrl` / `/service/file/preview-by-ticket/:ticket` 是文件内容流，只供预览页内部 iframe、PDF、图片或视频组件加载。
131
+ - 不要自行维护“可预览扩展名”列表。`AttachmentField` 会调用平台 capability API，只在服务端确认 `canPreview: true` 时展示预览；图片使用同组弹窗画廊，视频、音频和文档使用站内弹窗。
132
+ - 默认支持 PDF、常见图片/视频/音频、文本、DOCX 和 XLSX；DOC/XLS/PPT、ODF 等格式需要部署侧配置 ONLYOFFICE。文件过大时平台会按 `FILE_PREVIEW_*_MAX_*` 上限降级为仅下载。
131
133
  - 全局兼容入口 `/view/file-preview?ticket=...` 只有在后端能从 URL、ticket payload 或 `FILE_PREVIEW_APP_TYPE` 推导 appType 时才会被 React SPA runtime 接管。若响应头仍是 `X-OpenXiangda-Runtime-Mode: legacy`，检查 ticket 是否含 appType、URL 是否带 `appType`、runtime release 是否已激活、以及服务端兜底配置。
132
134
  - 需要自定义文件预览 UI 时，在 `src/runtime/default-page-overrides.tsx` 覆盖 `file-preview`；自定义组件仍应读取 ticket metadata 和 `/service/file/*` 接口，不要直接拼旧 view/workbench 参数。
133
135