tmui-cli 2.0.5 → 2.0.6

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xPdfS PDF/345/220/210/346/210/220.md"

@@ -68,6 +68,30 @@ imageTextToPdf({
 
 ## 更新日志
 
+### 0.1.25（2026-09-11）
+- **修「叠字整体往下掉、偏下约 3/4 个字高」**。落点原来算的是「检测框中心 ± 半个字号」：PDF 的 y 是从**页底往上**算的，而这一项按「y 向下」写成了 `框底 - 框高/2 + 字号/2`，等于把落点压到框底下面一截 —— 实测比正确基线低约 0.58 个字高，和真机上看到的「偏下 3/4 个字」一致。
+- 现在三端都优先钉在 **OCR 量出来的基线**上（`XPdfTextLine` 新增可选 `baseline` / `inkTop` / `inkH`，由 `x-correct-s` 的 OCR 结果透传）：基线是按**墨迹**算的，和检测框的位置无关，框偏下、框里混进上下标都不会带偏。没给基线才退回墨迹带底，最后才退回「按框居中」。
+  - 鸿蒙：`addTextObject` 直接吃基线（页底往上算）；
+  - Android：`Canvas.drawText` 的 baseline（视图坐标，从上往下算）；
+  - iOS：`NSString.draw(at:)` 的点是文字框左上角，所以从基线往上退一个 `ascender`；顺带修掉原来「从框顶再退 ascent」把字整体抬高的问题。
+- `XPdfTextLine` 去掉恒为空串的 `latex`（`x-correct-s` 的公式识别已下线，这个字段是它留下的空壳，本版起不再透传）。`kind` 保留。
+
+### 0.1.24（2026-09-11）
+- 叠字 PDF 的字号不再夹在 8–28 点，改成 `框高(图片像素) × fontScale × 图片到页面的缩放`，框越高字越大，和原图比例一致；预览叠字用同一个 0.85 系数，两边对得上。
+- 新增 `minFontPt`：等比换算后小于它才用它兜底，避免缩得太小看不清。默认 10pt，不影响坐标。
+- 新增 `textOnly`：纯文本模式不画底图，页面尺寸按图片比例（最长边 842pt）且不套页边距，文字按原图位置与大小等比输出。适合要「可选中纯文字、位置尺寸同图」的场合；此时 `paperSize` / `margin` / `imageOpacity` 不起作用。
+- 新增 `fontScale`：框高到字号的系数，默认 0.85，可 0.3–1.5 之间调。
+- 有坐标行的文字改为按框居中，框不够宽时整行横向压扁（先缩字号、再压字距），不再截断或溢出。
+- `XPdfTextLine` 增加 `kind` / `latex` 两个可选字段，供上层把行类型与公式原文一路带到 PDF 层（本版只透传，PDF 里画的仍是 `text`）。
+
+### 0.1.23（2026-09-09）
+- iOS 合成不再对相册 / 扫描的沙箱绝对路径走 `convert2AbsFullPath`，文件已存在就直接读。避免和安卓一样报「图片读取失败」。
+### 0.1.22（2026-09-09）
+- 安卓改为 Kotlin 后台线程合成：当前线程先 `JSON.stringify`，避免 UTS 对象在 IO dispatcher 里序列化卡死。PDF 固定写到应用 cacheDir。
+### 0.1.21（2026-09-08）
+- 安卓合成 / 删页 / 调序 / 合并改到 IO 线程，完成后再回主线程回调。避免挡住 `showLoading`，转圈不再假死。
+### 0.1.20（2026-09-08）
+- 安卓合成不再对相册 / 扫描的沙箱绝对路径走 `convert2AbsFullPath`，避免被当成包内相对路径拼坏后报「图片读取失败」。`file://` 会解码，`content://` 原样交给 BitmapFactory。大图按长边抽样，避免整图解码失败。
 ### 0.1.19（2026-08-20）
 - iOS 图文叠字不再把 `options` 强转成 `UTSJSONObject`。Options 是 Swift 类型，`as!` 会闪退。页面数组改为 `JSON.stringify` 后再按 JSON 读字段。
 ### 0.1.18（2026-08-20）

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xPdfU PDF/351/242/204/350/247/210.md"

@@ -30,7 +30,7 @@ pdf.value?.jumpTo(2)
 pdf.value?.print()
 ```
 
-App 端远程 http/https/ftp 会先下载再渲染；本地路径直接打开。
+App 端远程 http/https/ftp 会先下载再渲染。本地支持绝对路径、`file:///`、鸿蒙文档库授权 URI（`file://docs/...`）、Android `content://`、iOS `unifile://`；中文文件名的百分号编码会解开。
 
 ### 参数
 
@@ -44,6 +44,7 @@ App 端远程 http/https/ftp 会先下载再渲染；本地路径直接打开。
 | --- | --- | --- |
 | onInit | `{ page, pageCount }` | PDF 加载完成，`page` 从 0 开始 |
 | pageChange | `{ page, pageCount }` | 当前页变化 |
+| error | `{ errMsg }` | 文件不存在、下载失败或解析失败 |
 
 ### 方法
 
@@ -68,6 +69,12 @@ App 端远程 http/https/ftp 会先下载再渲染；本地路径直接打开。
 
 ## 更新日志
 
+### 1.0.9（2026-09-09）
+* 安卓已是沙箱绝对路径、`file://` 不再先 `convert2AbsFullPath`，避免合成后的 cache PDF 打不开。
+### 1.0.8（2026-09-08）
+* 全端补 `error` 事件（`{ errMsg }`）：文件不存在、路径无效、解析失败、远程下载失败都会回调，不再只打日志。
+### 1.0.7（2026-09-08）
+* 全端规范化本地文档路径：鸿蒙 `file://docs/...` 授权 URI 先落沙箱再打开（不再剥成 `docs/storage/...`）；Android 处理 `file://` / `content://` / `unifile://`；iOS 对齐 mime-s 解析 `file://` 与 `unifile://`；Web 解开 `file://` 百分号路径。
 ### 1.0.6（2026-08-18）
 * Android 预览在 scroll-view 内禁止父级拦截触摸，翻页/缩放只留在 PDF 内，不再穿透到页面。
 

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xPiniaS.md

@@ -0,0 +1,122 @@
+# x-pinia-s
+
+Pinia v3.0.4 单文件版 + 基于 uni 存储的持久化插件。去掉 `@vue/devtools-api` 依赖，适配 uni-app-x；自带 `createPersistPlugin`，用 `uni.setStorageSync` 保存 `store.$state`，下次启动自动还原。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 接入
+
+`main.uts` 中创建 Pinia 并挂载持久化插件：
+
+```ts
+// @ts-ignore
+import { createPinia } from '@/uni_modules/x-pinia-s/js_sdk/pinia'
+import { createPersistPlugin } from '@/uni_modules/x-pinia-s/js_sdk/piniaPersist'
+
+const pinia = createPinia()
+
+export function createApp() {
+  // @ts-ignore
+  const app = createSSRApp(App)
+
+  pinia.use(createPersistPlugin({
+    keyPrefix: 'pinia:',
+    includeStores: ['user'],
+    excludeStores: [],
+    serializer: null
+  }))
+  app.use(pinia)
+
+  return {
+    app
+  }
+}
+```
+
+### 定义 store
+
+```ts
+import { ref, computed } from 'vue'
+// @ts-ignore
+import { defineStore } from '@/uni_modules/x-pinia-s/js_sdk/pinia'
+
+export const useUserStore = defineStore('user', () => {
+  const token = ref<string | null>(null)
+  const isLogin = computed(() : boolean => token.value != null && token.value != '')
+
+  const setLogin = (newToken : string) => {
+    token.value = newToken
+  }
+
+  return {
+    token,
+    isLogin,
+    setLogin
+  }
+})
+```
+
+页面中使用：
+
+```ts
+import { useUserStore } from '@/store/useUserStore'
+import { storeToRefs } from '@/uni_modules/x-pinia-s/js_sdk/pinia'
+
+const store = useUserStore()
+const { token } = storeToRefs(store)
+store.setLogin('abc')
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| createPinia | 创建 Pinia 实例 |
+| defineStore | 定义 store，支持 options 与 setup 两种写法 |
+| storeToRefs | 解构 state / getters 并保持响应式 |
+| mapState / mapActions / mapStores / mapWritableState | Options API 辅助函数 |
+| acceptHMRUpdate | HMR 更新 |
+| setActivePinia / getActivePinia | SSR 或组件外手动切换活动实例 |
+| disposePinia | 销毁 Pinia 实例 |
+| skipHydrate / shouldHydrate | 控制 setup store 的 hydration |
+| createPersistPlugin | 持久化插件 |
+| clearPersistedState | 清除某个 store 的持久化数据 |
+
+### 持久化插件参数
+
+`createPersistPlugin(options)`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| keyPrefix | storage key 前缀，实际 key 为 `keyPrefix + store.$id` | `pinia:` |
+| includeStores | 白名单，`null` 表示全部持久化 | `null` |
+| excludeStores | 黑名单，优先级高于白名单 | `[]` |
+| serializer | 自定义序列化器 `{ serialize, deserialize }`，`null` 用 JSON | `null` |
+
+```ts
+import { clearPersistedState } from '@/uni_modules/x-pinia-s/js_sdk/piniaPersist'
+
+// 只清存储，不影响内存状态
+clearPersistedState('user', 'pinia:')
+```
+
+### 平台差异
+
+1. 单文件接入，去掉 `@vue/devtools-api`，uni-app-x 无 Vue DevTools。
+2. 持久化走 `uni.setStorageSync` / `uni.getStorageSync`，各端存储实现由 uni 提供。
+3. 白名单 / 黑名单按 `store.$id` 匹配；同时命中时黑名单优先。
+
+### 版本
+
+https://xui.tmui.design 下载归档。
+
+## 更新日志
+
+### 1.0.0（2026-08-24）
+* 接入 Pinia v3.0.4，单文件编译，去掉 @vue/devtools-api，适配 uni-app-x
+* 提供 createPersistPlugin 持久化插件，uni.setStorageSync 保存 store.$state，启动自动还原
+* 提供 clearPersistedState 清除单个 store 的持久化数据

package/data/tmui4x/60.AI/350/207/252/345/212/250/345/214/226/01./345/211/215/350/250/200.md

@@ -0,0 +1,20 @@
+# Agent Cli
+
+本系列文章以我目前所了解到的知识，引导你自行配置或者开发，或者使用再有AI对Uniapp,uniappx,uniapp vdom等项目
+实现自动构建流程，它可以让你在不碰代码的情况下自行完成更多的可能。
+
+
+```mermaid
+
+flowchart TB
+    HuilderX --> tmxUi组件包 --> 放置uni_modules目录内
+    HuilderX --> 选择性uni_modules下的插件 --> 放置uni_modules目录内
+	放置uni_modules目录内 --> 选择平台预览开发 --> andriod/ios --> 选择云原生APP打包 --> 选择自定义基座云证书
+	选择自定义基座云证书 --> 等待窗口显示打包完毕
+	等待窗口显示打包完毕 --> 运行到手机或模拟器 --> 选择你的真机或者模拟器运行 --> 编译运行提示第三方插件更新完成 --> 安卓同意安装完成
+	选择平台预览开发 --> web/h5 --> 运行到浏览器 --> chrome查看web预览
+	选择平台预览开发 --> 微信小程序 --> 运行到微信开发者工具 --> 待编译后自动打开工具
+	选择平台预览开发 --> 支付宝小程序 --> 运行到支付宝开发者工具 --> 待编译后自动打开工具
+	选择平台预览开发 --> 鸿蒙Next --> 配置相关证书及环境 --> 真机或者模拟器运行 --> 选择运行到鸿蒙
+
+```

package/data/tmui4x-doc-index.json

@@ -1,7 +1,7 @@
 {
-  "updatedAt": "2026-09-19T03:06:19.860Z",
+  "updatedAt": "2026-09-20T01:56:08.321Z",
   "source": "/Volumes/app/myProjects/tmui4xV2/doc/docs",
-  "count": 276,
+  "count": 279,
   "sections": [
     {
       "key": "01.教程",
@@ -11,7 +11,7 @@
     {
       "key": "10.插件库",
       "name": "插件库",
-      "count": 67
+      "count": 69
     },
     {
       "key": "30.组件库",
@@ -31,7 +31,7 @@
     {
       "key": "60.AI自动化",
       "name": "AI自动化",
-      "count": 4
+      "count": 5
     },
     {
       "key": "70.混合开发",
@@ -744,6 +744,20 @@
         "离线文档识别"
       ]
     },
+    {
+      "id": "10.插件库/xOfficeU Office 文档编辑",
+      "section": "插件库",
+      "sectionKey": "10.插件库",
+      "title": "x-office-u Office 文档编辑",
+      "file": "tmui4x/10.插件库/xOfficeU Office 文档编辑.md",
+      "aliases": [
+        "xOfficeU Office 文档编辑",
+        "xOfficeU",
+        "x-office-u",
+        "Office",
+        "文档编辑"
+      ]
+    },
     {
       "id": "10.插件库/xOnnxkitS 离线语音识别与合成",
       "section": "插件库",
@@ -822,6 +836,17 @@
         "图片水印"
       ]
     },
+    {
+      "id": "10.插件库/xPiniaS",
+      "section": "插件库",
+      "sectionKey": "10.插件库",
+      "title": "x-pinia-s",
+      "file": "tmui4x/10.插件库/xPiniaS.md",
+      "aliases": [
+        "xPiniaS",
+        "x-pinia-s"
+      ]
+    },
     {
       "id": "10.插件库/xPreviewMediaS 图片视频混合预览",
       "section": "插件库",
@@ -3305,6 +3330,17 @@
         "IQrcode"
       ]
     },
+    {
+      "id": "60.AI自动化/01.前言",
+      "section": "AI自动化",
+      "sectionKey": "60.AI自动化",
+      "title": "Agent Cli",
+      "file": "tmui4x/60.AI自动化/01.前言.md",
+      "aliases": [
+        "01.前言",
+        "前言"
+      ]
+    },
     {
       "id": "60.AI自动化/01.Agent",
       "section": "AI自动化",

package/data/uniappx-doc-index.json

@@ -1,5 +1,5 @@
 {
-  "updatedAt": "2026-09-19T03:06:24.832Z",
+  "updatedAt": "2026-09-20T01:56:13.187Z",
   "source": "/Volumes/app/myProjects/HBuilderProjects/tmui3.2/xui-cli/data/uni-app-x-docs",
   "count": 551,
   "components": [