npm - cj-tauri - Versions diffs - 1.1.2 → 2.0.0 - Mend

cj-tauri 1.1.2 → 2.0.0

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 (101) hide show

package/README.md +64 -18
package/cjpm.toml +52 -52
package/cli/cjpm.toml +10 -1
package/cli/src/doctor.cj +4 -2
package/cli/src/main.cj +11 -3
package/cli/src/manifest.cj +558 -0
package/cli/src/project.cj +38 -22
package/cli/src/scaffold.cj +369 -361
package/cli/src/sync.cj +526 -0
package/cli/src/util.cj +168 -159
package/cli/templates/app/README.md +48 -80
package/cli/templates/app/{capabilities → assets/capabilities}/default.json +7 -7
package/cli/templates/app/{ui → assets/ui}/index.html +118 -118
package/cli/templates/app/cj-tauri.toml +22 -0
package/cli/templates/app/cjpm.toml +34 -17
package/cli/templates/app/src/main.cj +90 -88
package/cli/templates/app-react/README.md +56 -67
package/cli/templates/app-react/{capabilities → assets/capabilities}/default.json +7 -7
package/cli/templates/app-react/{ui → assets/ui}/package.json +19 -19
package/cli/templates/app-react/{ui → assets/ui}/src/main.jsx +6 -6
package/cli/templates/app-react/{ui → assets/ui}/vite.config.js +24 -24
package/cli/templates/app-react/cj-tauri.toml +23 -0
package/cli/templates/app-react/cjpm.toml +34 -17
package/cli/templates/app-react/src/main.cj +91 -102
package/cli/templates/app-vue/README.md +56 -60
package/cli/templates/app-vue/{capabilities → assets/capabilities}/default.json +7 -7
package/cli/templates/app-vue/{ui → assets/ui}/package.json +18 -18
package/cli/templates/app-vue/{ui → assets/ui}/src/main.js +4 -4
package/cli/templates/app-vue/{ui → assets/ui}/vite.config.js +24 -24
package/cli/templates/app-vue/cj-tauri.toml +23 -0
package/cli/templates/app-vue/cjpm.toml +34 -17
package/cli/templates/app-vue/src/main.cj +91 -102
package/cli/templates/{ohos-pc → ohos-skeleton}/AppScope/app.json5 +13 -13
package/cli/templates/{ohos-pc → ohos-skeleton}/AppScope/resources/base/element/string.json +8 -8
package/cli/templates/{ohos-pc → ohos-skeleton}/AppScope/resources/base/media/layered_image.json +6 -6
package/cli/templates/{ohos-pc → ohos-skeleton}/README.md +79 -79
package/cli/templates/{ohos-pc → ohos-skeleton}/build-profile.json5 +46 -46
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/build-profile.json5 +26 -26
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/cjpm.toml +43 -43
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/hvigorfile.ts +6 -6
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/oh-package.json5 +9 -9
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/cangjie/ability_stage.cj +17 -17
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/cangjie/app_host.cj +94 -94
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/cangjie/index.cj +167 -167
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/cangjie/main_ability.cj +139 -139
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/module.json5 +49 -49
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/resources/base/element/color.json +8 -8
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/resources/base/element/string.json +16 -16
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/resources/base/media/layered_image.json +6 -6
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/resources/base/profile/main_pages.json +2 -2
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/resources/rawfile/capabilities.json +6 -6
package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/resources/rawfile/index.html +92 -92
package/cli/templates/{ohos-pc → ohos-skeleton}/hvigor/hvigor-config.json5 +5 -5
package/cli/templates/{ohos-pc → ohos-skeleton}/hvigorfile.ts +6 -6
package/cli/templates/{ohos-pc → ohos-skeleton}/oh-package.json5 +10 -10
package/package.json +4 -2
package/prebuilt/win32-x64/cj-tauri.exe +0 -0
package/src/app.cj +49 -20
package/src/app_spec.cj +76 -0
package/src/arkweb_script.cj +142 -154
package/src/host.cj +20 -17
package/src/host_arkweb.cj +778 -740
package/src/host_webkit.cj +22 -0
package/src/host_webview2.cj +22 -0
package/src/launch.cj +62 -0
package/src/platform/platform_app_context.cj +77 -0
package/src/platform/platform_assets.cj +33 -0
package/src/platform/platform_discover.cj +176 -0
package/src/platform/platform_env.cj +29 -0
package/src/platform/platform_feature.cj +31 -0
package/src/platform/platform_page_source.cj +87 -0
package/src/platform/platform_target_info.cj +32 -0
package/src/platform_host_provider.cj +87 -0
package/src/plugin.cj +36 -2
package/src/plugins/clipboard/plugin_clipboard.cj +8 -0
package/src/plugins/menu/plugin_menu.cj +158 -150
package/src/plugins/notification/plugin_notification.cj +8 -0
package/src/plugins/serial/plugin_serial.cj +454 -442
package/src/plugins/serial/serial_bridge.cj +194 -186
package/src/plugins/serial/serial_ohos_stub.cj +61 -0
package/src/plugins/shell/plugin_shell.cj +258 -230
package/src/plugins/sqlite/plugin_sqlite.cj +710 -697
package/src/plugins/sqlite/sqlite_ffi.cj +211 -206
package/src/plugins/sqlite/sqlite_ohos_stub.cj +91 -0
package/src/tests/app_spec_test.cj +127 -0
package/src/tests/fake_host.cj +23 -8
package/src/tests/platform_contract_test.cj +251 -0
package/src/tests/plugin_test.cj +585 -542
package/src/version.cj +1 -1
package/src/host_factory.cj +0 -48
/package/cli/templates/app-react/{ui → assets/ui}/index.html +0 -0
/package/cli/templates/app-react/{ui → assets/ui}/src/App.css +0 -0
/package/cli/templates/app-react/{ui → assets/ui}/src/App.jsx +0 -0
/package/cli/templates/app-vue/{ui → assets/ui}/index.html +0 -0
/package/cli/templates/app-vue/{ui → assets/ui}/src/App.vue +0 -0
/package/cli/templates/{ohos-pc → ohos-skeleton}/AppScope/resources/base/media/background.png +0 -0
/package/cli/templates/{ohos-pc → ohos-skeleton}/AppScope/resources/base/media/foreground.png +0 -0
/package/cli/templates/{ohos-pc → ohos-skeleton}/build-hap.sh +0 -0
/package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/resources/base/media/background.png +0 -0
/package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/resources/base/media/foreground.png +0 -0
/package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/resources/base/media/startIcon.png +0 -0

package/cli/templates/app/{ui → assets/ui}/index.html RENAMED Viewed

@@ -1,118 +1,118 @@
-<!DOCTYPE html>
-<html>
-<head>
-<meta charset="utf-8">
-<title>{{PROJECT_NAME}}</title>
-<style>
-  :root { color-scheme: dark; }
-  body { font-family: system-ui, -apple-system, "Segoe UI", sans-serif; background: #16161d;
-         color: #e6e6e6; margin: 0; min-height: 100vh;
-         display: flex; flex-direction: column; align-items: center; justify-content: center; }
-  .card { background: #1f2029; border: 1px solid #2e3140; border-radius: 14px;
-          padding: 28px 32px; width: min(460px, 86vw);
-          box-shadow: 0 12px 32px rgba(0,0,0,.45); }
-  h1 { margin: 0 0 4px; font-size: 22px; color: #7ce7ff; }
-  .sub { margin: 0 0 20px; font-size: 13px; color: #9aa0b4; }
-  .row { display: flex; gap: 8px; margin: 14px 0; }
-  input, button { font-size: 15px; padding: 9px 12px; border-radius: 9px; border: 1px solid transparent; }
-  input { flex: 1; background: #141821; color: #e6e6e6; border-color: #2e3140; }
-  input:focus { outline: none; border-color: #4a7fd4; }
-  button { background: #e94560; color: #fff; cursor: pointer; font-weight: 600; }
-  button:hover { opacity: .88; }
-  button.ghost { background: #2b3040; }
-  .result { margin-top: 6px; min-height: 24px; font-size: 15px; color: #50fa7b; word-break: break-all; }
-  .tick { margin-top: 10px; font-size: 13px; color: #8be9fd; min-height: 18px; }
-  .chk { margin-top: 12px; font-size: 13px; color: #9aa0b4;
-         display: flex; align-items: center; gap: 6px; }
-  .chk input { flex: none; }
-  .foot { margin-top: 18px; font-size: 12px; color: #6b7186; }
-</style>
-</head>
-<body>
-  <div class="card">
-    <h1>{{PROJECT_NAME}}</h1>
-    <p class="sub">仓颉后端 + 系统 WebView 前端 &nbsp;·&nbsp; invoke / listen 双向 IPC &nbsp;·&nbsp; capability 安全模型</p>
-    <div class="row">
-      <input id="name" placeholder="输入名字" value="world">
-      <button id="greet">greet</button>
-    </div>
-    <div class="row">
-      <button id="timer" class="ghost">启动后端事件推送</button>
-      <button id="version" class="ghost">system:version</button>
-    </div>
-    <div class="chk">
-      <input type="checkbox" id="sidebar" checked>
-      <label for="sidebar">侧边栏（对应原生菜单「视图 → 侧边栏」）</label>
-    </div>
-    <div id="result" class="result">等待 invoke…</div>
-    <div id="tick" class="tick"></div>
-    <div id="menu" class="tick"></div>
-    <div class="foot">越权命令（未在 capabilities/default.json 声明）会被后端拒绝</div>
-  </div>
-  <script>
-    // 注入的桥（对标 @tauri-apps/api）：window.__CJ_TAURI__
-    function withBridge(cb) {
-      if (window.__CJ_TAURI__) { cb(window.__CJ_TAURI__); return; }
-      setTimeout(function () { withBridge(cb); }, 50);
-    }
-    withBridge(function (tauri) {
-      var result = document.getElementById('result');
-      var tick = document.getElementById('tick');
-      function show(text, ok) {
-        result.textContent = text;
-        result.style.color = ok === false ? '#ff6b81' : '#50fa7b';
-      }
-      // JS → 仓颉
-      document.getElementById('greet').onclick = function () {
-        var name = document.getElementById('name').value || 'world';
-        tauri.invoke('greet', { name: name })
-          .then(function (data) { show('invoke OK: ' + data); })
-          .catch(function (err) { show('invoke FAIL: ' + err.message, false); });
-      };
-      document.getElementById('version').onclick = function () {
-        tauri.invoke('system:version')
-          .then(function (data) { show('system:version -> ' + JSON.stringify(data)); })
-          .catch(function (err) { show('system:version FAIL: ' + err.message, false); });
-      };
-      // 仓颉 → JS（事件推送）
-      document.getElementById('timer').onclick = function () {
-        tauri.invoke('timer')
-          .then(function (d) { show('后端: ' + d); })
-          .catch(function (err) { show('timer FAIL: ' + err.message, false); });
-      };
-      tauri.listen('tick', function (payload) {
-        tick.textContent = '收到后端事件 tick #' + payload.n;
-      });
-      // 原生菜单 → 页面：菜单被点后宿主推事件过来（capabilities 里要声明 menu:click）
-      var menuLine = document.getElementById('menu');
-      tauri.listen('menu:click', function (payload) {
-        menuLine.textContent = '菜单被点: ' + payload.id +
-          '（enabled=' + payload.enabled + ', checked=' + payload.checked + '）';
-      });
-      // 页面 → 原生菜单：menu 插件的前端 shim（window.__CJ_TAURI__.menu，注入在 document start）
-      document.getElementById('sidebar').onchange = function (e) {
-        if (!tauri.menu) {
-          show('未注入 menu 插件 shim（页面来自 runUrl 时插件 JS 不在本进程）', false);
-          return;
-        }
-        var checked = e.target.checked;
-        tauri.menu.setChecked({ id: 'view.sidebar', checked: checked })
-          .then(function () { show('原生菜单「侧边栏」已同步为 ' + checked); })
-          .catch(function (err) { show('menu.setChecked FAIL: ' + err.message, false); });
-      };
-    });
-  </script>
-</body>
-</html>
+<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<title>{{PROJECT_NAME}}</title>
+<style>
+  :root { color-scheme: dark; }
+  body { font-family: system-ui, -apple-system, "Segoe UI", sans-serif; background: #16161d;
+         color: #e6e6e6; margin: 0; min-height: 100vh;
+         display: flex; flex-direction: column; align-items: center; justify-content: center; }
+  .card { background: #1f2029; border: 1px solid #2e3140; border-radius: 14px;
+          padding: 28px 32px; width: min(460px, 86vw);
+          box-shadow: 0 12px 32px rgba(0,0,0,.45); }
+  h1 { margin: 0 0 4px; font-size: 22px; color: #7ce7ff; }
+  .sub { margin: 0 0 20px; font-size: 13px; color: #9aa0b4; }
+  .row { display: flex; gap: 8px; margin: 14px 0; }
+  input, button { font-size: 15px; padding: 9px 12px; border-radius: 9px; border: 1px solid transparent; }
+  input { flex: 1; background: #141821; color: #e6e6e6; border-color: #2e3140; }
+  input:focus { outline: none; border-color: #4a7fd4; }
+  button { background: #e94560; color: #fff; cursor: pointer; font-weight: 600; }
+  button:hover { opacity: .88; }
+  button.ghost { background: #2b3040; }
+  .result { margin-top: 6px; min-height: 24px; font-size: 15px; color: #50fa7b; word-break: break-all; }
+  .tick { margin-top: 10px; font-size: 13px; color: #8be9fd; min-height: 18px; }
+  .chk { margin-top: 12px; font-size: 13px; color: #9aa0b4;
+         display: flex; align-items: center; gap: 6px; }
+  .chk input { flex: none; }
+  .foot { margin-top: 18px; font-size: 12px; color: #6b7186; }
+</style>
+</head>
+<body>
+  <div class="card">
+    <h1>{{PROJECT_NAME}}</h1>
+    <p class="sub">仓颉后端 + 系统 WebView 前端 &nbsp;·&nbsp; invoke / listen 双向 IPC &nbsp;·&nbsp; capability 安全模型</p>
+    <div class="row">
+      <input id="name" placeholder="输入名字" value="world">
+      <button id="greet">greet</button>
+    </div>
+    <div class="row">
+      <button id="timer" class="ghost">启动后端事件推送</button>
+      <button id="version" class="ghost">system:version</button>
+    </div>
+    <div class="chk">
+      <input type="checkbox" id="sidebar" checked>
+      <label for="sidebar">侧边栏（对应原生菜单「视图 → 侧边栏」）</label>
+    </div>
+    <div id="result" class="result">等待 invoke…</div>
+    <div id="tick" class="tick"></div>
+    <div id="menu" class="tick"></div>
+    <div class="foot">越权命令（未在 capabilities/default.json 声明）会被后端拒绝</div>
+  </div>
+  <script>
+    // 注入的桥（对标 @tauri-apps/api）：window.__CJ_TAURI__
+    function withBridge(cb) {
+      if (window.__CJ_TAURI__) { cb(window.__CJ_TAURI__); return; }
+      setTimeout(function () { withBridge(cb); }, 50);
+    }
+    withBridge(function (tauri) {
+      var result = document.getElementById('result');
+      var tick = document.getElementById('tick');
+      function show(text, ok) {
+        result.textContent = text;
+        result.style.color = ok === false ? '#ff6b81' : '#50fa7b';
+      }
+      // JS → 仓颉
+      document.getElementById('greet').onclick = function () {
+        var name = document.getElementById('name').value || 'world';
+        tauri.invoke('greet', { name: name })
+          .then(function (data) { show('invoke OK: ' + data); })
+          .catch(function (err) { show('invoke FAIL: ' + err.message, false); });
+      };
+      document.getElementById('version').onclick = function () {
+        tauri.invoke('system:version')
+          .then(function (data) { show('system:version -> ' + JSON.stringify(data)); })
+          .catch(function (err) { show('system:version FAIL: ' + err.message, false); });
+      };
+      // 仓颉 → JS（事件推送）
+      document.getElementById('timer').onclick = function () {
+        tauri.invoke('timer')
+          .then(function (d) { show('后端: ' + d); })
+          .catch(function (err) { show('timer FAIL: ' + err.message, false); });
+      };
+      tauri.listen('tick', function (payload) {
+        tick.textContent = '收到后端事件 tick #' + payload.n;
+      });
+      // 原生菜单 → 页面：菜单被点后宿主推事件过来（capabilities 里要声明 menu:click）
+      var menuLine = document.getElementById('menu');
+      tauri.listen('menu:click', function (payload) {
+        menuLine.textContent = '菜单被点: ' + payload.id +
+          '（enabled=' + payload.enabled + ', checked=' + payload.checked + '）';
+      });
+      // 页面 → 原生菜单：menu 插件的前端 shim（window.__CJ_TAURI__.menu，注入在 document start）
+      document.getElementById('sidebar').onchange = function (e) {
+        if (!tauri.menu) {
+          show('未注入 menu 插件 shim（页面来自 runUrl 时插件 JS 不在本进程）', false);
+          return;
+        }
+        var checked = e.target.checked;
+        tauri.menu.setChecked({ id: 'view.sidebar', checked: checked })
+          .then(function () { show('原生菜单「侧边栏」已同步为 ' + checked); })
+          .catch(function (err) { show('menu.setChecked FAIL: ' + err.message, false); });
+      };
+    });
+  </script>
+</body>
+</html>

package/cli/templates/app/cj-tauri.toml ADDED Viewed

@@ -0,0 +1,22 @@
+# 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 加载的页面（相对资产根 assets/）；dev 模式自动改写到 Vite dev server
+  page = "ui/index.html"
+[capabilities]
+  dir = "assets/capabilities"

package/cli/templates/app/cjpm.toml CHANGED Viewed

@@ -1,17 +1,34 @@
-[package]
-  cjc-version = "{{CJC_VERSION}}"
-  name = "{{PACKAGE_NAME}}"
-  description = "{{PROJECT_NAME}} - cj-tauri 应用"
-  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/src/main.cj CHANGED Viewed

@@ -1,88 +1,90 @@
-package {{PACKAGE_NAME}}
-import cjTauri.*
-import stdx.encoding.json.*
-import std.fs.File
-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("cj-tauri 应用", 1000, 700))
-        .register("greet", GreetCommand())
-        .register("timer", TimerCommand())
-        // menu 插件：给前端挂 window.__CJ_TAURI__.menu.setEnabled / setChecked
-        // （插件只声明「我提供什么」，**不自动放行**——要能调，就在 capabilities 里引用
-        //   permissions: ["menu:state"]，或逐条写 commands）
-        .plugin(MenuPlugin())
-        // 菜单栏必须在 run() 之前挂：预置类宿主能力要赶在页面加载前定稿
-        .setMenu(demoMenu())
-    // 2) 载入前端页面并启动（阻塞至窗口关闭）
-    let html = String.fromUtf8(File.readFrom("ui/index.html"))
-    app.run(html)
-    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）。
+ * build() 负责业务自己的部分：命令注册、菜单、插件。
+ */
+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-react/README.md CHANGED Viewed

@@ -1,67 +1,56 @@
-# {{PROJECT_NAME}}
-`cj-tauri create {{PROJECT_NAME}} --template react` 生成的工程：**仓颉后端 + React 18 / Vite 前端**。
-目录结构：
-```
-{{PROJECT_NAME}}/
-  src/main.cj            后端入口（窗口 + 命令注册 + 页面来源选择）
-  capabilities/          能力清单（哪些命令 / 事件允许被前端调用）
-  ui/                    前端工程（Vite + React）
-    index.html
-    vite.config.js
-    src/App.jsx
-    src/main.jsx
-  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/**.jsx` / `.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`）。
-## 和 vue 模板的差别
-只有 `ui/` 里换成了 React：`@vitejs/plugin-react` 替掉 `@vitejs/plugin-vue`，入口是 `src/main.jsx`、
-根组件是 `src/App.jsx`；Vite 配置、`src/main.cj`、能力清单、`cj-tauri dev` 的用法完全一致。
-`src/main.jsx` 里**没有**用 `React.StrictMode`：开发模式下它会把 effect 跑两遍，
-而这个模板的 effect 里要调 `invoke` / `listen`，双跑容易让人误以为桥重复投递。
+# {{PROJECT_NAME}}
+基于 [cj-tauri]({{FRAMEWORK_ROOT}})（仓颉版 Tauri）+ React 18 + 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/                 # React 18 + 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（改 .jsx 保存即刷新）+ 编译 + 启动窗口
+```
+## 发布构建
+```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-react/{capabilities → assets/capabilities}/default.json RENAMED Viewed

@@ -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"]
+}