cj-tauri 1.1.1 → 2.0.0

package/cli/templates/app-react/{ui → assets/ui}/package.json

@@ -1,19 +1,19 @@
-{
-  "name": "cj-tauri-ui",
-  "private": true,
-  "version": "0.1.0",
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build"
-  },
-  "dependencies": {
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1"
-  },
-  "devDependencies": {
-    "@vitejs/plugin-react": "^4.3.4",
-    "vite": "^6.0.11",
-    "vite-plugin-singlefile": "^2.1.0"
-  }
-}
+{
+  "name": "cj-tauri-ui",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.3.4",
+    "vite": "^6.0.11",
+    "vite-plugin-singlefile": "^2.1.0"
+  }
+}

package/cli/templates/app-react/{ui → assets/ui}/src/main.jsx

@@ -1,6 +1,6 @@
-import { createRoot } from 'react-dom/client';
-import App from './App.jsx';
-
-// 这里不套 React.StrictMode：它在开发模式下会把 effect 跑两遍，
-// 而这个模板的 effect 里就要调 invoke / listen，双跑会让人误以为桥重复投递。
-createRoot(document.getElementById('root')).render(<App />);
+import { createRoot } from 'react-dom/client';
+import App from './App.jsx';
+
+// 这里不套 React.StrictMode：它在开发模式下会把 effect 跑两遍，
+// 而这个模板的 effect 里就要调 invoke / listen，双跑会让人误以为桥重复投递。
+createRoot(document.getElementById('root')).render(<App />);

package/cli/templates/app-react/{ui → assets/ui}/vite.config.js

@@ -1,24 +1,24 @@
-import { defineConfig } from 'vite';
-import react from '@vitejs/plugin-react';
-import { viteSingleFile } from 'vite-plugin-singlefile';
-
-// 两件事很重要：
-//   1) dev server 固定 127.0.0.1:5173 —— cj-tauri dev 就是按这个地址探活并注入 CJ_TAURI_DEV_URL 的；
-//      strictPort 让它端口被占时直接报错，而不是悄悄换一个导致应用连不上。
-//   2) 构建产物必须是**单个** index.html —— 后端用 File.readFrom 读它，与 app 模板的单文件模式一致；
-//      assetsInlineLimit 调大是为了让图片等资源也内联进 HTML。
-export default defineConfig({
-  plugins: [react(), viteSingleFile()],
-  base: './',
-  server: {
-    host: '127.0.0.1',
-    port: 5173,
-    strictPort: true
-  },
-  build: {
-    outDir: 'dist',
-    emptyOutDir: true,
-    cssCodeSplit: false,
-    assetsInlineLimit: 104857600
-  }
-});
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import { viteSingleFile } from 'vite-plugin-singlefile';
+
+// 两件事很重要：
+//   1) dev server 固定 127.0.0.1:5173 —— cj-tauri dev 就是按这个地址探活并注入 CJ_TAURI_DEV_URL 的；
+//      strictPort 让它端口被占时直接报错，而不是悄悄换一个导致应用连不上。
+//   2) 构建产物必须是**单个** index.html —— 后端用 File.readFrom 读它，与 app 模板的单文件模式一致；
+//      assetsInlineLimit 调大是为了让图片等资源也内联进 HTML。
+export default defineConfig({
+  plugins: [react(), viteSingleFile()],
+  base: './',
+  server: {
+    host: '127.0.0.1',
+    port: 5173,
+    strictPort: true
+  },
+  build: {
+    outDir: 'dist',
+    emptyOutDir: true,
+    cssCodeSplit: false,
+    assetsInlineLimit: 104857600
+  }
+});

package/cli/templates/app-react/cj-tauri.toml

@@ -0,0 +1,23 @@
+# cj-tauri 应用清单——整个工程的单一真相（RFC-002 §7）。
+# cj-tauri sync 从这里派生 targets/ 骨架（desktop/ohos）；cj-tauri check 校验它并检测骨架漂移。
+[app]
+  name = "{{PROJECT_NAME}}"
+  version = "0.1.0"
+  # 应用标识：桌面是安装 ID，鸿蒙直接是 bundleName（每段须字母开头、只含字母数字下划线）
+  id = "{{BUNDLE_NAME}}"
+  # 业务包名（cjpm 约束①：toml 模块名必须等于源包名）
+  package = "{{PACKAGE_NAME}}"
+
+[[windows]]
+  label = "main"
+  title = "{{PROJECT_NAME}}"
+  width = 1000
+  height = 700
+
+[assets]
+  # 骨架 launcher 加载的页面：Vite 打出来的单文件产物（vite-plugin-singlefile 内联 js/css）。
+  # dev 模式自动改写到 Vite dev server（热更新）；发布构建才用这个产物。
+  page = "ui/dist/index.html"
+
+[capabilities]
+  dir = "assets/capabilities"

package/cli/templates/app-react/cjpm.toml

@@ -1,17 +1,34 @@
-[package]
-  cjc-version = "{{CJC_VERSION}}"
-  name = "{{PACKAGE_NAME}}"
-  description = "{{PROJECT_NAME}} - cj-tauri 应用（Vue 3 + Vite 前端）"
-  version = "0.1.0"
-  target-dir = ""
-  output-type = "executable"
-  compile-option = ""
-  override-compile-option = ""
-  link-option = ""
-  package-configuration = {}
-
-[dependencies]
-  # cj-tauri 框架本体（由 cj-tauri create 写入的本机路径）
-  cjTauri = { path = "{{FRAMEWORK_ROOT_TOML}}" }
-
-{{TARGET_SECTION}}
+# 业务包：业务代码的唯一真相（RFC-002 §7.3——骨架永远是外壳，业务只有一份）。
+# output-type = "static"：桌面骨架（targets/desktop）与鸿蒙入口（targets/ohos/entry）
+# 都以 path 依赖引用本包——同一份业务代码，多个目标各编各的产物。
+[package]
+  cjc-version = "{{CJC_VERSION}}"
+  name = "{{PACKAGE_NAME}}"
+  description = "{{PROJECT_NAME}} - cj-tauri 业务包"
+  version = "0.1.0"
+  target-dir = ""
+  output-type = "static"
+  compile-option = ""
+  override-compile-option = ""
+  link-option = ""
+  package-configuration = {}
+
+[dependencies]
+  # cj-tauri 框架本体（由 cj-tauri create 写入的本机路径；换机器重跑 create 或手改）
+  cjTauri = { path = "{{FRAMEWORK_ROOT_TOML}}" }
+
+[target.x86_64-unknown-linux-gnu.bin-dependencies]
+    path-option = ["${CANGJIE_STDX}"]
+
+[target.x86_64-w64-mingw32.bin-dependencies]
+    path-option = ["${CANGJIE_STDX}"]
+
+[target.aarch64-linux-ohos]
+  # 鸿蒙目标：交叉编译工具链与 sysroot 由 DevEco 仓颉套件提供，路径全部走环境变量
+  # （与框架根 cjpm.toml 同口径；末尾 --dy-std 不可省，原因见框架根 toml 的鸿蒙段注释）
+  compile-option = "-B \"${DEVECO_CANGJIE_HOME}/build-tools/third_party/llvm/bin\" -B \"${DEVECO_OH_NATIVE_HOME}/sysroot/usr/lib/aarch64-linux-ohos\" -L \"${DEVECO_OH_NATIVE_HOME}/sysroot/usr/lib/aarch64-linux-ohos\" -L \"${DEVECO_OH_NATIVE_HOME}/llvm/lib/clang/15.0.4/lib/aarch64-linux-ohos\" -L \"${DEVECO_OH_NATIVE_HOME}/llvm/lib/aarch64-linux-ohos\" --sysroot \"${DEVECO_OH_NATIVE_HOME}/sysroot\" --dy-std"
+
+[target.aarch64-linux-ohos.bin-dependencies]
+    # stdx 必须用鸿蒙版（CANGJIE_STDX_OHOS，桌面版 ABI 不通）；CANGJIE_OHOS_LIBS 指 DevEco
+    # 套件的 api/lib/linux_ohos_aarch64_cjnative/ohos（仓颉标准库 + ohos API 绑定）
+    path-option = ["${CANGJIE_STDX_OHOS}", "${CANGJIE_OHOS_LIBS}", "${AARCH64_MACRO_LIBS}", "${AARCH64_KIT_LIBS}"]

package/cli/templates/app-react/src/main.cj

@@ -1,102 +1,91 @@
-package {{PACKAGE_NAME}}
-
-import cjTauri.*
-import stdx.encoding.json.*
-import std.fs.*
-import std.collection.*
-
-/**
- * greet 命令（对标 tauri command）
- * 前端：tauri.invoke("greet", { name: "..." })
- */
-public class GreetCommand <: CommandHandler {
-    public init() {}
-
-    public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
-        var name = "world"
-        if (let Some(n) <- args.get("name")) {
-            match (n.kind()) {
-                case JsonKind.JsString => name = n.asString().getValue()
-                case _ => ()
-            }
-        }
-        return JsonString("Hello, ${name}! 来自仓颉后端")
-    }
-}
-
-/**
- * 定时器命令：启动后台线程，每秒向后端推一个 tick 事件（验证 仓颉 → JS 通道）
- * 前端：tauri.listen("tick", cb) + tauri.invoke("timer")
- */
-public class TimerCommand <: CommandHandler {
-    private var counter: Int64 = 0
-    private var started: Bool = false
-
-    public init() {}
-
-    public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
-        if (!this.started) {
-            this.started = true
-            spawn {
-                while (true) {
-                    sleep(Duration.second)
-                    this.counter += 1
-                    var payload = JsonObject()
-                    payload.put("n", JsonInt(this.counter))
-                    ipc.emit("tick", payload)
-                }
-            }
-        }
-        return JsonString("timer started")
-    }
-}
-
-/**
- * 演示菜单：一个普通项 + 一个带勾选项的子菜单
- *
- * 两个方向都在页面上看得到：
- *   菜单 → 页面：点「打个招呼」，宿主把事件推给前端（页面 listen("menu:click") 显示 id）
- *   页面 → 菜单：勾选页面上的复选框，走 menu 插件改「侧边栏」这一项的勾选状态
- */
-func demoMenu(): MenuModel {
-    var view = ArrayList<MenuItem>()
-    view.add(MenuItem.checkbox("view.sidebar", "侧边栏", true))
-    var items = ArrayList<MenuItem>()
-    items.add(MenuItem.normal("file.hello", "打个招呼"))
-    items.add(MenuItem.submenu("视图", view))
-    return MenuModel(items)
-}
-
-main(): Int64 {
-    // 1) 装配应用（对标 tauri::Builder）：窗口配置 + 注册命令
-    //    能力清单由框架在 run() 时自动扫描 capabilities/ 目录（对标 Tauri 的 capabilities 目录）
-    let app = TauriApp()
-        .window(WindowConfig("{{PROJECT_NAME}}", 1000, 700))
-        .register("greet", GreetCommand())
-        .register("timer", TimerCommand())
-        // menu 插件：给前端挂 window.__CJ_TAURI__.menu.setEnabled / setChecked
-        // （插件只声明「我提供什么」，**不自动放行**——要能调，就在 capabilities 里引用
-        //   permissions: ["menu:state"]，或逐条写 commands）
-        .plugin(MenuPlugin())
-        // 菜单栏必须在 run() / runUrl() 之前挂：预置类宿主能力要赶在页面加载前定稿
-        .setMenu(demoMenu())
-
-    // 2) 页面来源二选一，对应本模板的两种跑法：
-    //    dev  : cj-tauri dev 起了 Vite dev server 并注入 CJ_TAURI_DEV_URL
-    //           → 页面来自真实 URL，改 .vue 保存即热更新，应用不用重启
-    //    发布 : 读 Vite 打出来的单文件 ui/dist/index.html（js/css 已内联，无外部依赖）
-    if (let Some(url) <- TauriApp.devUrl()) {
-        eprintln("[app] dev 模式，页面来自 ${url}")
-        app.runUrl(url)
-    } else {
-        let dist = "ui/dist/index.html"
-        if (!exists(dist)) {
-            eprintln("[app] 找不到 ${dist}")
-            eprintln("      开发: 在项目根跑 cj-tauri dev（会自动 npm install + 起 dev server）")
-            eprintln("      发布: cd ui && npm run build")
-            return 1
-        }
-        app.run(String.fromUtf8(File.readFrom(dist)))
-    }
-    return 0
-}
+package {{PACKAGE_NAME}}
+
+import cjTauri.*
+import cjTauri.plugins.menu.*
+import stdx.encoding.json.*
+import std.collection.*
+
+/**
+ * greet 命令（对标 tauri command）
+ * 前端：tauri.invoke("greet", { name: "..." })
+ */
+public class GreetCommand <: CommandHandler {
+    public init() {}
+
+    public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
+        var name = "world"
+        if (let Some(n) <- args.get("name")) {
+            match (n.kind()) {
+                case JsonKind.JsString => name = n.asString().getValue()
+                case _ => ()
+            }
+        }
+        return JsonString("Hello, ${name}! 来自仓颉后端")
+    }
+}
+
+/**
+ * 定时器命令：启动后台线程，每秒向前端推一个 tick 事件（验证 仓颉 → JS 通道）
+ * 前端：tauri.listen("tick", cb) + tauri.invoke("timer")
+ */
+public class TimerCommand <: CommandHandler {
+    private var counter: Int64 = 0
+    private var started: Bool = false
+
+    public init() {}
+
+    public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
+        if (!this.started) {
+            this.started = true
+            spawn {
+                while (true) {
+                    sleep(Duration.second)
+                    this.counter += 1
+                    var payload = JsonObject()
+                    payload.put("n", JsonInt(this.counter))
+                    ipc.emit("tick", payload)
+                }
+            }
+        }
+        return JsonString("timer started")
+    }
+}
+
+/**
+ * 演示菜单：一个普通项 + 一个带勾选项的子菜单
+ *
+ * 两个方向都在页面上看得到：
+ *   菜单 → 页面：点「打个招呼」，宿主把事件推给前端（页面 listen("menu:click") 显示 id）
+ *   页面 → 菜单：勾选页面上的复选框，走 menu 插件改「侧边栏」这一项的勾选状态
+ */
+func demoMenu(): MenuModel {
+    var view = ArrayList<MenuItem>()
+    view.add(MenuItem.checkbox("view.sidebar", "侧边栏", true))
+    var items = ArrayList<MenuItem>()
+    items.add(MenuItem.normal("file.hello", "打个招呼"))
+    items.add(MenuItem.submenu("视图", view))
+    return MenuModel(items)
+}
+
+/**
+ * 业务装配点（RFC-002 §4.1）：骨架的 launcher（targets/ 下各目标的 src）调用它取 AppSpec。
+ *
+ * 零平台知识：不碰宿主、不知道页面文件路径、不知道能力目录——那些由清单
+ * （cj-tauri.toml）决定，launcher 按清单覆盖（page/window/assets/capabilities）。
+ * dev 模式页面来自 Vite dev server（框架按 CJ_TAURI_DEV_URL 自动改写），
+ * 发布构建加载 assets/ui/dist 的单文件产物——两种跑法业务代码完全一致。
+ */
+public func build(): AppSpec {
+    return AppSpec()
+        .window(WindowConfig("{{PROJECT_NAME}}", 1000, 700))
+        // menu 插件：给前端挂 window.__CJ_TAURI__.menu.setEnabled / setChecked
+        // （插件只声明「我提供什么」，**不自动放行**——要能调，就在 capabilities 里引用
+        //   permissions: ["menu:state"]，或逐条写 commands）
+        .plugin(MenuPlugin())
+        .wire({ app =>
+            app.register("greet", GreetCommand())
+            app.register("timer", TimerCommand())
+            // 菜单栏必须在 run 之前挂：预置类宿主能力要赶在页面加载前定稿
+            app.setMenu(demoMenu())
+        })
+}

package/cli/templates/app-vue/README.md

@@ -1,60 +1,56 @@
-# {{PROJECT_NAME}}
-
-`cj-tauri create {{PROJECT_NAME}} --template vue` 生成的工程：**仓颉后端 + Vue 3 / Vite 前端**。
-
-目录结构：
-
-```
-{{PROJECT_NAME}}/
-  src/main.cj            后端入口（窗口 + 命令注册 + 页面来源选择）
-  capabilities/          能力清单（哪些命令 / 事件允许被前端调用）
-  ui/                    前端工程（Vite + Vue 3）
-    index.html
-    vite.config.js
-    src/App.vue
-    src/main.js
-  cjpm.toml              仓颉包配置（cjTauri 依赖路径由 create 写入本机绝对路径）
-```
-
-## 开发：`cj-tauri dev`（热重载）
-
-```bash
-cj-tauri dev
-```
-
-`dev` 依次做：桥已构建则跳过 → 若 `ui/node_modules` 不存在则 `npm install` → 后台起 Vite dev server
-（`127.0.0.1:5173`）→ 探活 → 以环境变量 `CJ_TAURI_DEV_URL` 启动应用。页面来自真实 URL，所以：
-
-- 改 `ui/src/**.vue` / `.js`：保存后页面自己更新，**应用不重启**（Vite HMR）；
-- 改后端 `src/*.cj`：需要重新 `cj-tauri dev`（框架不承诺后端进程内热替换）；
-- 应用窗口关闭后会一并收掉 dev server。
-
-想手动控制前端时，也可以自己起 dev server 再启动应用：
-
-```bash
-cd ui && npm run dev            # 另一个终端
-CJ_TAURI_DEV_URL=http://127.0.0.1:5173/ cj-tauri run
-```
-
-## 发布：打成一个 HTML 文件
-
-```bash
-cd ui && npm install && npm run build   # 产出 ui/dist/index.html（js/css/图片全内联）
-cd .. && cj-tauri build                 # 构建桥 + cjpm build
-cj-tauri run                            # 没有 CJ_TAURI_DEV_URL 时读 ui/dist/index.html
-```
-
-`vite-plugin-singlefile` 保证产物就是**一个** `index.html`，与 `app` 模板的单文件模式等价。
-
-## 前后端怎么通信
-
-前端拿到的是 `window.__CJ_TAURI__`（与 Tauri 的 `@tauri-apps/api` 同形）：
-
-```js
-window.__CJ_TAURI__.invoke('greet', { name: '仓颉' });   // → Promise
-window.__CJ_TAURI__.listen('tick', (payload) => { /* ... */ });
-window.__CJ_TAURI__.reload();                            // 整页刷新
-```
-
-能调哪些命令、能收哪些事件，由 `capabilities/default.json` 决定；没声明的命令一律被拒
-（`command not allowed: xxx`）。
+# {{PROJECT_NAME}}
+
+基于 [cj-tauri]({{FRAMEWORK_ROOT}})（仓颉版 Tauri）+ Vue 3 + Vite 的应用：**仓颉后端 + 系统 WebView 前端**，
+通过 `window.__CJ_TAURI__` 做 invoke/listen 双向 IPC，并由 capabilities 清单做最小权限管控。
+
+## 目录结构（一份业务代码，骨架按目标派生）
+
+```
+{{PROJECT_NAME}}/
+├── cj-tauri.toml           # 应用清单——单一真相（id/version/窗口/资产/能力目录）
+├── cjpm.toml               # 业务包（static 库；骨架以 path 依赖引用）
+├── src/main.cj             # 业务装配点 build(): AppSpec（零平台知识）
+├── assets/
+│   ├── ui/                 # Vue 3 + Vite 前端工程（package.json / vite.config.js / src/）
+│   └── capabilities/default.json   # 能力白名单（命令 / 事件 / 权限集）
+└── targets/                # cj-tauri sync 生成的骨架（勿手改；check 判漂移）
+    ├── desktop/            #   桌面可执行（launcher 调 build()）
+    └── ohos/               #   鸿蒙 hap 工程（DevEco + build-hap.sh）
+```
+
+## 首次运行（dev，热更新）
+
+```bash
+cd assets/ui && npm install    # 前端依赖（需要 Node.js）
+cd ../.. && cj-tauri sync      # 派生 targets/ 骨架
+cj-tauri dev                   # 起 Vite dev server（改 .vue 保存即刷新）+ 编译 + 启动窗口
+```
+
+## 发布构建
+
+```bash
+cj-tauri build                 # 先在 assets/ui 跑 npm run build，再编后端
+cj-tauri run
+```
+
+`vite.config.js` 用 vite-plugin-singlefile：产物是 `assets/ui/dist/index.html`
+（js/css 内联、无外部依赖）——正是清单 `[assets] page` 指向的页面。
+
+## 鸿蒙端（PC / 2in1）
+
+```bash
+export CANGJIE_STDX_OHOS=<鸿蒙版 stdx>/linux_ohos_aarch64_cjnative/dynamic/stdx
+cd targets/ohos && bash build-hap.sh            # 编 hap
+cd targets/ohos && bash build-hap.sh --install  # 编完装到设备并拉起
+```
+
+提示：模板不带签名证书——首次在 DevEco 里 File → Project Structure → Signing Configs
+勾「Automatically generate signature」（要登录华为账号）；不签名只能编出
+*-unsigned.hap，装不进设备。
+
+## 命令与能力
+
+命令在 `src/main.cj`（`greet` / `timer` + 演示菜单），白名单在 `assets/capabilities/default.json`——
+两边必须对齐：`cj-tauri check` 的三方比对会交叉核对「能力声明 × 插件自描述 × 实际装配」。
+插件在某端没有实现时（如 shell/sqlite 在鸿蒙端），骨架照样编得过，运行期调用得到
+可照做的「端不支持」错误（RFC-002 §4.6.4 的 P-1 桩）。

package/cli/templates/app-vue/{capabilities → assets/capabilities}/default.json

@@ -1,7 +1,7 @@
-{
-  "identifier": "default",
-  "windows": ["main"],
-  "commands": ["greet", "timer", "system:version", "system:ping", "system:echo", "system:devtools"],
-  "permissions": ["menu:state"],
-  "events": ["tick", "menu:click"]
-}
+{
+  "identifier": "default",
+  "windows": ["main"],
+  "commands": ["greet", "timer", "system:version", "system:ping", "system:echo", "system:devtools"],
+  "permissions": ["menu:state"],
+  "events": ["tick", "menu:click"]
+}

package/cli/templates/app-vue/{ui → assets/ui}/package.json

@@ -1,18 +1,18 @@
-{
-  "name": "cj-tauri-ui",
-  "private": true,
-  "version": "0.1.0",
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build"
-  },
-  "dependencies": {
-    "vue": "^3.5.13"
-  },
-  "devDependencies": {
-    "@vitejs/plugin-vue": "^5.2.1",
-    "vite": "^6.0.11",
-    "vite-plugin-singlefile": "^2.1.0"
-  }
-}
+{
+  "name": "cj-tauri-ui",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build"
+  },
+  "dependencies": {
+    "vue": "^3.5.13"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-vue": "^5.2.1",
+    "vite": "^6.0.11",
+    "vite-plugin-singlefile": "^2.1.0"
+  }
+}

package/cli/templates/app-vue/{ui → assets/ui}/src/main.js

@@ -1,4 +1,4 @@
-import { createApp } from 'vue';
-import App from './App.vue';
-
-createApp(App).mount('#app');
+import { createApp } from 'vue';
+import App from './App.vue';
+
+createApp(App).mount('#app');

package/cli/templates/app-vue/{ui → assets/ui}/vite.config.js

@@ -1,24 +1,24 @@
-import { defineConfig } from 'vite';
-import vue from '@vitejs/plugin-vue';
-import { viteSingleFile } from 'vite-plugin-singlefile';
-
-// 两件事很重要：
-//   1) dev server 固定 127.0.0.1:5173 —— cj-tauri dev 就是按这个地址探活并注入 CJ_TAURI_DEV_URL 的；
-//      strictPort 让它端口被占时直接报错，而不是悄悄换一个导致应用连不上。
-//   2) 构建产物必须是**单个** index.html —— 后端用 File.readFrom 读它，与 app 模板的单文件模式一致；
-//      assetsInlineLimit 调大是为了让图片等资源也内联进 HTML。
-export default defineConfig({
-  plugins: [vue(), viteSingleFile()],
-  base: './',
-  server: {
-    host: '127.0.0.1',
-    port: 5173,
-    strictPort: true
-  },
-  build: {
-    outDir: 'dist',
-    emptyOutDir: true,
-    cssCodeSplit: false,
-    assetsInlineLimit: 104857600
-  }
-});
+import { defineConfig } from 'vite';
+import vue from '@vitejs/plugin-vue';
+import { viteSingleFile } from 'vite-plugin-singlefile';
+
+// 两件事很重要：
+//   1) dev server 固定 127.0.0.1:5173 —— cj-tauri dev 就是按这个地址探活并注入 CJ_TAURI_DEV_URL 的；
+//      strictPort 让它端口被占时直接报错，而不是悄悄换一个导致应用连不上。
+//   2) 构建产物必须是**单个** index.html —— 后端用 File.readFrom 读它，与 app 模板的单文件模式一致；
+//      assetsInlineLimit 调大是为了让图片等资源也内联进 HTML。
+export default defineConfig({
+  plugins: [vue(), viteSingleFile()],
+  base: './',
+  server: {
+    host: '127.0.0.1',
+    port: 5173,
+    strictPort: true
+  },
+  build: {
+    outDir: 'dist',
+    emptyOutDir: true,
+    cssCodeSplit: false,
+    assetsInlineLimit: 104857600
+  }
+});

package/cli/templates/app-vue/cj-tauri.toml

@@ -0,0 +1,23 @@
+# cj-tauri 应用清单——整个工程的单一真相（RFC-002 §7）。
+# cj-tauri sync 从这里派生 targets/ 骨架（desktop/ohos）；cj-tauri check 校验它并检测骨架漂移。
+[app]
+  name = "{{PROJECT_NAME}}"
+  version = "0.1.0"
+  # 应用标识：桌面是安装 ID，鸿蒙直接是 bundleName（每段须字母开头、只含字母数字下划线）
+  id = "{{BUNDLE_NAME}}"
+  # 业务包名（cjpm 约束①：toml 模块名必须等于源包名）
+  package = "{{PACKAGE_NAME}}"
+
+[[windows]]
+  label = "main"
+  title = "{{PROJECT_NAME}}"
+  width = 1000
+  height = 700
+
+[assets]
+  # 骨架 launcher 加载的页面：Vite 打出来的单文件产物（vite-plugin-singlefile 内联 js/css）。
+  # dev 模式自动改写到 Vite dev server（热更新）；发布构建才用这个产物。
+  page = "ui/dist/index.html"
+
+[capabilities]
+  dir = "assets/capabilities"