@workfly/create-app 0.2.0

package/README.md

@@ -0,0 +1,43 @@
+# @workfly/create-app
+
+脚手架一个 WorkFly 小程序——**零仓库起步**。基于 Vite，框架无关。
+
+```bash
+npm create @workfly/app my-app      # 交互选模板；或 npx @workfly/create-app my-app
+
+cd my-app
+npm install
+npm run dev        # 本地调试：浏览器注入全局 wf + HMR
+npm run build      # 构建并打包成 my-app.wfapp.zip（拖进客户端安装 / 分发）
+```
+
+## 预置模板
+
+| 模板         | 说明               |
+| ------------ | ------------------ |
+| `vanilla`    | 纯 JS，零框架      |
+| `vanilla-ts` | TypeScript，零框架 |
+| `react-ts`   | React + TypeScript |
+| `vue-ts`     | Vue + TypeScript   |
+
+非交互直选：`npm create @workfly/app my-app -- --template react-ts --id com.acme.foo --name "Foo"`。
+
+| flag            | 说明                                 |
+| --------------- | ------------------------------------ |
+| `--template`    | 模板名（见上表），缺省交互选择       |
+| `--id <id>`     | 应用 id，缺省 `com.example.<目录名>` |
+| `--name <name>` | 展示名，缺省取目录名                 |
+
+## 它做了什么
+
+产出一个普通 **Vite** 工程：
+
+- 全部走 **sandbox 沙盒形态**（webview 进程级隔离）。`vite build` 经 [`@workfly/vite-plugin`](../vite-plugin) 校验 manifest、打包成带魔数的 `.wfapp.zip`。
+- `dev` 时插件注入全局 `wf`（对标微信 `wx.*`）+ 网络/RSA 代理 + 权限门控，等价客户端内的 preload 注入。
+- TS 模板通过 `@workfly/wf-types` 拿到全局 `wf` 类型。
+- 框架由开发者自己的 `@vitejs/plugin-react|vue` 处理——本工具链只管 WorkFly 特有的注入与打包。
+
+> 想要进程内高信任的 `bundle` 形态（深度集成、富交互）？需先与平台沟通授权，联系 <workfly@yonyou.com>。
+> 只是「调接口 + 把结构化数据渲染成卡片」的零代码场景？直接把需求告诉客户端里的 AI 助手，生成即装，无需脚手架。
+
+wf SDK 完整文档见发布站 `/api`，机器可读版 `/api/wf-api.json`。

package/index.mjs

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+// @workfly/create-app —— 脚手架一个 WorkFly 小程序（Vite，框架无关）。
+//   npm create @workfly/app <dir> [--template vanilla|vanilla-ts|react-ts|vue-ts] [--id <id>] [--name <name>]
+//   npx @workfly/create-app <dir> ...
+// 产出一个普通 Vite 工程（依赖 @workfly/vite-plugin + @workfly/wf-types）：
+//   npm install → npm run dev（注入 wf + HMR）→ npm run build（出 .wfapp.zip）。
+import { readFileSync, writeFileSync, statSync, readdirSync, existsSync, mkdirSync } from 'node:fs'
+import { join, resolve, basename, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { createInterface } from 'node:readline/promises'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const TEMPLATES_DIR = join(here, 'templates')
+const TEMPLATES = [
+  { key: 'vanilla', label: 'Vanilla · 纯 JS' },
+  { key: 'vanilla-ts', label: 'Vanilla · TypeScript' },
+  { key: 'react-ts', label: 'React · TypeScript' },
+  { key: 'vue-ts', label: 'Vue · TypeScript' }
+]
+const DEFAULT_TEMPLATE = 'react-ts'
+const TEXT_EXT = new Set([
+  '.json',
+  '.html',
+  '.js',
+  '.ts',
+  '.tsx',
+  '.mts',
+  '.cts',
+  '.vue',
+  '.md',
+  '.css',
+  '.less'
+])
+
+/** 解析 `--key value`、`--key=value` 与布尔 `--flag`。 */
+function parseFlags(argv) {
+  const flags = {}
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i]
+    if (!a.startsWith('--')) continue
+    const eq = a.indexOf('=')
+    if (eq >= 0) {
+      flags[a.slice(2, eq)] = a.slice(eq + 1)
+      continue
+    }
+    const next = argv[i + 1]
+    if (next === undefined || next.startsWith('--')) flags[a.slice(2)] = true
+    else flags[a.slice(2)] = argv[++i]
+  }
+  return flags
+}
+
+/** 把目录名规整成 slug：小写、非字母数字转连字符。 */
+function slugify(s) {
+  return (
+    s
+      .toLowerCase()
+      .replace(/[^a-z0-9]+/g, '-')
+      .replace(/^-+|-+$/g, '') || 'app'
+  )
+}
+
+/** 递归复制模板目录，文本文件做 token 替换；_gitignore → .gitignore（绕开 npm 发布吞 .gitignore）。 */
+function copyTemplate(srcDir, dstDir, tokens) {
+  mkdirSync(dstDir, { recursive: true })
+  for (const name of readdirSync(srcDir)) {
+    const src = join(srcDir, name)
+    const dst = join(dstDir, name === '_gitignore' ? '.gitignore' : name)
+    if (statSync(src).isDirectory()) {
+      copyTemplate(src, dst, tokens)
+      continue
+    }
+    const ext = name.slice(name.lastIndexOf('.'))
+    if (TEXT_EXT.has(ext) || name === '_gitignore') {
+      let text = readFileSync(src, 'utf8')
+      for (const [k, v] of Object.entries(tokens)) text = text.replaceAll(k, v)
+      writeFileSync(dst, text)
+    } else {
+      writeFileSync(dst, readFileSync(src))
+    }
+  }
+}
+
+async function main() {
+  const argv = process.argv.slice(2)
+  const flags = parseFlags(argv)
+  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY)
+  let rl
+  const ask = async (q) => {
+    rl ??= createInterface({ input: process.stdin, output: process.stdout })
+    return (await rl.question(q)).trim()
+  }
+
+  // 目录
+  let dir = argv.find((a) => !a.startsWith('--'))
+  if (!dir) {
+    if (!interactive) {
+      console.error(
+        '用法: npm create @workfly/app <dir> [--template vanilla|vanilla-ts|react-ts|vue-ts] [--id <id>] [--name <name>]'
+      )
+      process.exit(1)
+    }
+    dir = (await ask('项目目录名: ')) || 'my-workfly-app'
+  }
+  const dst = resolve(dir)
+  if (existsSync(dst) && readdirSync(dst).length) {
+    console.error(`✗ 目标目录非空：${dst}`)
+    process.exit(1)
+  }
+
+  // 模板
+  let template = flags.template
+  if (template && !TEMPLATES.some((t) => t.key === template)) {
+    console.error(`✗ 未知模板 '${template}'，可用：${TEMPLATES.map((t) => t.key).join(' / ')}`)
+    process.exit(1)
+  }
+  if (!template) {
+    if (!interactive) {
+      template = DEFAULT_TEMPLATE
+    } else {
+      console.log('\n选择模板：')
+      TEMPLATES.forEach((t, i) => console.log(`  ${i + 1}) ${t.label}`))
+      const ans = await ask(
+        `输入序号 [${TEMPLATES.findIndex((t) => t.key === DEFAULT_TEMPLATE) + 1}]: `
+      )
+      template =
+        TEMPLATES[(Number(ans) || TEMPLATES.findIndex((t) => t.key === DEFAULT_TEMPLATE) + 1) - 1]
+          ?.key ?? DEFAULT_TEMPLATE
+    }
+  }
+  rl?.close()
+
+  const base = basename(dst)
+  const name = flags.name ?? base
+  const slug = slugify(base)
+  const id = flags.id ?? `com.example.${slug}`
+  const initial = [...name][0]?.toUpperCase() ?? 'A'
+  copyTemplate(join(TEMPLATES_DIR, template), dst, {
+    '{{ID}}': id,
+    '{{NAME}}': name,
+    '{{INITIAL}}': initial,
+    '{{SLUG}}': slug
+  })
+
+  console.log(`\n✓ 已创建 ${template} 小程序：${dst}`)
+  console.log(`  id=${id} · name=${name}\n`)
+  console.log('下一步：')
+  console.log(`  cd ${dir}`)
+  console.log('  npm install')
+  console.log('  npm run dev      # 本地调试（注入 wf + HMR）')
+  console.log('  npm run build    # 构建并打包成 .wfapp.zip')
+}
+
+main().catch((e) => {
+  console.error(e)
+  process.exit(1)
+})

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@workfly/create-app",
+  "version": "0.2.0",
+  "description": "脚手架一个 WorkFly 小程序（Vite，框架无关；预置 Vanilla / TS / React / Vue 模板），产出可独立开发并打包成 .wfapp.zip 的工程。",
+  "type": "module",
+  "bin": {
+    "create-app": "index.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "templates"
+  ],
+  "keywords": [
+    "workfly",
+    "miniapp",
+    "scaffold",
+    "create",
+    "vite"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT"
+}

package/templates/react-ts/README.md

@@ -0,0 +1,15 @@
+# {{NAME}}
+
+一个 WorkFly 小程序（React · TypeScript，sandbox 沙盒形态）。
+
+```bash
+npm install
+npm run dev      # 本地调试：浏览器注入全局 wf + HMR
+npm run build    # 类型检查 + 构建并打包成 {{SLUG}}.wfapp.zip
+```
+
+- 全局 `wf` 的类型来自 `@workfly/wf-types`（见 `tsconfig.json` 的 `types`），直接调用无需 import。
+- `index.html` 含沙盒 CSP（页面不直连网络，全走 `wf.request`）。
+- 框架由 `@vitejs/plugin-react` 处理；`@workfly/vite-plugin` 负责 wf 注入与打包。
+
+wf SDK（对标微信 `wx.*`）完整文档见发布站 `/api`。

package/templates/react-ts/_gitignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+*.wfapp.zip
+*.local
+.DS_Store

package/templates/react-ts/index.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="utf-8" />
+    <meta
+      http-equiv="Content-Security-Policy"
+      content="default-src 'self' workfly-app:; script-src 'self' workfly-app:; style-src 'unsafe-inline'; img-src 'self' workfly-app: data: https:; font-src 'self' workfly-app: data:; connect-src 'none'"
+    />
+    <title>{{NAME}}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/react-ts/manifest.json

@@ -0,0 +1,17 @@
+{
+  "id": "{{ID}}",
+  "name": "{{NAME}}",
+  "version": "1.0.0",
+  "manifest": 1,
+  "wfSdk": "1.0.0",
+  "minClient": "0.10.0",
+  "description": "{{NAME}} · WorkFly 小程序",
+  "iconPlaceholder": { "initial": "{{INITIAL}}", "color": "#3461ff" },
+  "scope": "private",
+  "contains": ["ui"],
+  "ui": {
+    "standalone": { "enabled": true, "entry": "dist/index.html", "render": "sandbox", "layout": "full" }
+  },
+  "launchers": ["miniprogram_panel", "spotlight"],
+  "permissions": [{ "id": "net.fetch", "reason": "调用你填写的接口获取要展示的数据" }]
+}

package/templates/react-ts/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "{{SLUG}}",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc --noEmit && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^6.0.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "typescript": "^6.0.0",
+    "vite": "^8.0.0",
+    "@workfly/vite-plugin": "^0.1.0",
+    "@workfly/wf-types": "^0.1.0"
+  }
+}

package/templates/react-ts/src/App.tsx

@@ -0,0 +1,30 @@
+import { useState } from 'react'
+
+// 全局 wf 的类型来自 @workfly/wf-types（tsconfig types），直接调用、无需 import。
+const APP_NAME = '{{NAME}}'
+
+export default function App() {
+  const [out, setOut] = useState('就绪。')
+  const sys = wf.getSystemInfoSync()
+
+  async function go() {
+    try {
+      const res = await wf.request({ url: 'https://httpbin.org/get' })
+      setOut(JSON.stringify(res.data, null, 2).slice(0, 400))
+      await wf.showToast({ title: '已更新' })
+    } catch (e) {
+      setOut(String((e as Error)?.message ?? e))
+    }
+  }
+
+  return (
+    <main style={{ fontFamily: 'system-ui, sans-serif', padding: 24 }}>
+      <h1>{APP_NAME}</h1>
+      <p>
+        平台 {sys.platform} · 主题 {sys.theme}
+      </p>
+      <button onClick={go}>拉取数据</button>
+      <pre>{out}</pre>
+    </main>
+  )
+}

package/templates/react-ts/src/main.tsx

@@ -0,0 +1,9 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import App from './App'
+
+createRoot(document.getElementById('app')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>
+)

package/templates/react-ts/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": ["@workfly/wf-types"]
+  },
+  "include": ["src"]
+}

package/templates/react-ts/vite.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+import workfly from '@workfly/vite-plugin'
+
+// base:'./' 与 modulePreload.polyfill:false 是沙盒小程序的硬约束（勿改）。
+// 框架由 @vitejs/plugin-react 处理；workfly() 只管 wf 注入与打包。
+export default defineConfig({
+  base: './',
+  plugins: [react(), workfly()],
+  build: { modulePreload: { polyfill: false } }
+})

package/templates/vanilla/README.md

@@ -0,0 +1,15 @@
+# {{NAME}}
+
+一个 WorkFly 小程序（Vanilla · 纯 JS，sandbox 沙盒形态）。
+
+```bash
+npm install
+npm run dev      # 本地调试：浏览器注入全局 wf + HMR
+npm run build    # 构建并打包成 {{SLUG}}.wfapp.zip（可拖进客户端安装 / 分发）
+```
+
+- `manifest.json` —— 小程序元信息与能力声明（`permissions` 声明用到的能力，如 `net.fetch`）。
+- `index.html` —— 入口；含沙盒 CSP（页面不直连网络，全走 `wf.request`）。
+- `src/main.js` —— 业务逻辑，直接用注入的全局 `wf`。
+
+wf SDK（对标微信 `wx.*`）完整文档见发布站 `/api`。

package/templates/vanilla/_gitignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+*.wfapp.zip
+*.local
+.DS_Store

package/templates/vanilla/index.html

@@ -0,0 +1,17 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="utf-8" />
+    <!-- 沙盒形态：页面不直连网络，宿主能力全走注入的全局 wf；wf.request 经主进程代理。
+         CSP 不放开 script-src 'unsafe-inline'（Vite 内联脚本已由 build.modulePreload.polyfill:false 关闭）。 -->
+    <meta
+      http-equiv="Content-Security-Policy"
+      content="default-src 'self' workfly-app:; script-src 'self' workfly-app:; style-src 'unsafe-inline'; img-src 'self' workfly-app: data: https:; font-src 'self' workfly-app: data:; connect-src 'none'"
+    />
+    <title>{{NAME}}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.js"></script>
+  </body>
+</html>

package/templates/vanilla/manifest.json

@@ -0,0 +1,17 @@
+{
+  "id": "{{ID}}",
+  "name": "{{NAME}}",
+  "version": "1.0.0",
+  "manifest": 1,
+  "wfSdk": "1.0.0",
+  "minClient": "0.10.0",
+  "description": "{{NAME}} · WorkFly 小程序",
+  "iconPlaceholder": { "initial": "{{INITIAL}}", "color": "#3461ff" },
+  "scope": "private",
+  "contains": ["ui"],
+  "ui": {
+    "standalone": { "enabled": true, "entry": "dist/index.html", "render": "sandbox", "layout": "full" }
+  },
+  "launchers": ["miniprogram_panel", "spotlight"],
+  "permissions": [{ "id": "net.fetch", "reason": "调用你填写的接口获取要展示的数据" }]
+}

package/templates/vanilla/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "{{SLUG}}",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "@workfly/vite-plugin": "^0.1.0"
+  }
+}

package/templates/vanilla/src/main.js

@@ -0,0 +1,23 @@
+// 通过宿主注入的全局 wf 调用平台能力（网络 / 存储 / UI / 系统…）。
+// 完整 API 见发布站 /api，机器可读版 /api/wf-api.json。
+const APP_NAME = '{{NAME}}'
+const sys = wf.getSystemInfoSync()
+
+document.getElementById('app').innerHTML = `
+  <main style="font-family: system-ui, sans-serif; padding: 24px">
+    <h1>${APP_NAME}</h1>
+    <p>平台 ${sys.platform} · 主题 ${sys.theme}</p>
+    <button id="go">拉取数据</button>
+    <pre id="out">就绪。</pre>
+  </main>`
+
+document.getElementById('go').addEventListener('click', async () => {
+  const out = document.getElementById('out')
+  try {
+    const res = await wf.request({ url: 'https://httpbin.org/get' })
+    out.textContent = JSON.stringify(res.data, null, 2).slice(0, 400)
+    await wf.showToast({ title: '已更新' })
+  } catch (e) {
+    out.textContent = String(e?.message ?? e)
+  }
+})

package/templates/vanilla/vite.config.js

@@ -0,0 +1,10 @@
+import workfly from '@workfly/vite-plugin'
+
+// base:'./' 与 modulePreload.polyfill:false 是沙盒小程序的硬约束（勿改）：
+//  · 资源相对路径，适配宿主 workfly-app://<id>/ 加载
+//  · 关掉 Vite 内联 modulepreload polyfill，避免被沙盒 CSP（script-src 'self'）拦截导致白屏
+export default {
+  base: './',
+  plugins: [workfly()],
+  build: { modulePreload: { polyfill: false } }
+}

package/templates/vanilla-ts/README.md

@@ -0,0 +1,14 @@
+# {{NAME}}
+
+一个 WorkFly 小程序（Vanilla · TypeScript，sandbox 沙盒形态）。
+
+```bash
+npm install
+npm run dev      # 本地调试：浏览器注入全局 wf + HMR
+npm run build    # 类型检查 + 构建并打包成 {{SLUG}}.wfapp.zip
+```
+
+- 全局 `wf` 的类型来自 `@workfly/wf-types`（见 `tsconfig.json` 的 `types`）。
+- `index.html` 含沙盒 CSP（页面不直连网络，全走 `wf.request`）。
+
+wf SDK（对标微信 `wx.*`）完整文档见发布站 `/api`。

package/templates/vanilla-ts/_gitignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+*.wfapp.zip
+*.local
+.DS_Store

package/templates/vanilla-ts/index.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="utf-8" />
+    <meta
+      http-equiv="Content-Security-Policy"
+      content="default-src 'self' workfly-app:; script-src 'self' workfly-app:; style-src 'unsafe-inline'; img-src 'self' workfly-app: data: https:; font-src 'self' workfly-app: data:; connect-src 'none'"
+    />
+    <title>{{NAME}}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/vanilla-ts/manifest.json

@@ -0,0 +1,17 @@
+{
+  "id": "{{ID}}",
+  "name": "{{NAME}}",
+  "version": "1.0.0",
+  "manifest": 1,
+  "wfSdk": "1.0.0",
+  "minClient": "0.10.0",
+  "description": "{{NAME}} · WorkFly 小程序",
+  "iconPlaceholder": { "initial": "{{INITIAL}}", "color": "#3461ff" },
+  "scope": "private",
+  "contains": ["ui"],
+  "ui": {
+    "standalone": { "enabled": true, "entry": "dist/index.html", "render": "sandbox", "layout": "full" }
+  },
+  "launchers": ["miniprogram_panel", "spotlight"],
+  "permissions": [{ "id": "net.fetch", "reason": "调用你填写的接口获取要展示的数据" }]
+}

package/templates/vanilla-ts/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "{{SLUG}}",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc --noEmit && vite build",
+    "preview": "vite preview"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.0",
+    "vite": "^8.0.0",
+    "@workfly/vite-plugin": "^0.1.0",
+    "@workfly/wf-types": "^0.1.0"
+  }
+}

package/templates/vanilla-ts/src/main.ts

@@ -0,0 +1,24 @@
+// 通过宿主注入的全局 wf 调用平台能力；类型来自 @workfly/wf-types（tsconfig types）。
+// 完整 API 见发布站 /api，机器可读版 /api/wf-api.json。
+const APP_NAME = '{{NAME}}'
+const sys = wf.getSystemInfoSync()
+
+const app = document.getElementById('app')!
+app.innerHTML = `
+  <main style="font-family: system-ui, sans-serif; padding: 24px">
+    <h1>${APP_NAME}</h1>
+    <p>平台 ${sys.platform} · 主题 ${sys.theme}</p>
+    <button id="go">拉取数据</button>
+    <pre id="out">就绪。</pre>
+  </main>`
+
+document.getElementById('go')!.addEventListener('click', async () => {
+  const out = document.getElementById('out')!
+  try {
+    const res = await wf.request({ url: 'https://httpbin.org/get' })
+    out.textContent = JSON.stringify(res.data, null, 2).slice(0, 400)
+    await wf.showToast({ title: '已更新' })
+  } catch (e) {
+    out.textContent = String((e as Error)?.message ?? e)
+  }
+})

package/templates/vanilla-ts/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": ["@workfly/wf-types"]
+  },
+  "include": ["src", "vite.config.ts"]
+}

package/templates/vanilla-ts/vite.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vite'
+import workfly from '@workfly/vite-plugin'
+
+// base:'./' 与 modulePreload.polyfill:false 是沙盒小程序的硬约束（勿改）。
+export default defineConfig({
+  base: './',
+  plugins: [workfly()],
+  build: { modulePreload: { polyfill: false } }
+})

package/templates/vue-ts/README.md

@@ -0,0 +1,15 @@
+# {{NAME}}
+
+一个 WorkFly 小程序（Vue · TypeScript，sandbox 沙盒形态）。
+
+```bash
+npm install
+npm run dev      # 本地调试：浏览器注入全局 wf + HMR
+npm run build    # 类型检查 + 构建并打包成 {{SLUG}}.wfapp.zip
+```
+
+- 全局 `wf` 的类型来自 `@workfly/wf-types`（见 `tsconfig.json` 的 `types`），在 `<script setup>` 里直接调用。
+- `index.html` 含沙盒 CSP（页面不直连网络，全走 `wf.request`）。
+- 框架由 `@vitejs/plugin-vue` 处理；`@workfly/vite-plugin` 负责 wf 注入与打包。
+
+wf SDK（对标微信 `wx.*`）完整文档见发布站 `/api`。

package/templates/vue-ts/_gitignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+*.wfapp.zip
+*.local
+.DS_Store

package/templates/vue-ts/index.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="utf-8" />
+    <meta
+      http-equiv="Content-Security-Policy"
+      content="default-src 'self' workfly-app:; script-src 'self' workfly-app:; style-src 'unsafe-inline'; img-src 'self' workfly-app: data: https:; font-src 'self' workfly-app: data:; connect-src 'none'"
+    />
+    <title>{{NAME}}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/vue-ts/manifest.json

@@ -0,0 +1,17 @@
+{
+  "id": "{{ID}}",
+  "name": "{{NAME}}",
+  "version": "1.0.0",
+  "manifest": 1,
+  "wfSdk": "1.0.0",
+  "minClient": "0.10.0",
+  "description": "{{NAME}} · WorkFly 小程序",
+  "iconPlaceholder": { "initial": "{{INITIAL}}", "color": "#3461ff" },
+  "scope": "private",
+  "contains": ["ui"],
+  "ui": {
+    "standalone": { "enabled": true, "entry": "dist/index.html", "render": "sandbox", "layout": "full" }
+  },
+  "launchers": ["miniprogram_panel", "spotlight"],
+  "permissions": [{ "id": "net.fetch", "reason": "调用你填写的接口获取要展示的数据" }]
+}

package/templates/vue-ts/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "{{SLUG}}",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vue-tsc --noEmit && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "vue": "^3.5.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-vue": "^6.0.0",
+    "typescript": "^6.0.0",
+    "vue-tsc": "^3.0.0",
+    "vite": "^8.0.0",
+    "@workfly/vite-plugin": "^0.1.0",
+    "@workfly/wf-types": "^0.1.0"
+  }
+}

package/templates/vue-ts/src/App.vue

@@ -0,0 +1,27 @@
+<script setup lang="ts">
+// 全局 wf 的类型来自 @workfly/wf-types（tsconfig types），直接调用、无需 import。
+import { ref } from 'vue'
+
+const APP_NAME = '{{NAME}}'
+const sys = wf.getSystemInfoSync()
+const out = ref('就绪。')
+
+async function go() {
+  try {
+    const res = await wf.request({ url: 'https://httpbin.org/get' })
+    out.value = JSON.stringify(res.data, null, 2).slice(0, 400)
+    await wf.showToast({ title: '已更新' })
+  } catch (e) {
+    out.value = String((e as Error)?.message ?? e)
+  }
+}
+</script>
+
+<template>
+  <main style="font-family: system-ui, sans-serif; padding: 24px">
+    <h1>{{ APP_NAME }}</h1>
+    <p>平台 {{ sys.platform }} · 主题 {{ sys.theme }}</p>
+    <button @click="go">拉取数据</button>
+    <pre>{{ out }}</pre>
+  </main>
+</template>

package/templates/vue-ts/src/main.ts

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

package/templates/vue-ts/src/shims-vue.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="vite/client" />
+declare module '*.vue' {
+  import type { DefineComponent } from 'vue'
+  const component: DefineComponent<Record<string, never>, Record<string, never>, unknown>
+  export default component
+}

package/templates/vue-ts/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "preserve",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": ["@workfly/wf-types"]
+  },
+  "include": ["src"]
+}

package/templates/vue-ts/vite.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import workfly from '@workfly/vite-plugin'
+
+// base:'./' 与 modulePreload.polyfill:false 是沙盒小程序的硬约束（勿改）。
+// 框架由 @vitejs/plugin-vue 处理；workfly() 只管 wf 注入与打包。
+export default defineConfig({
+  base: './',
+  plugins: [vue(), workfly()],
+  build: { modulePreload: { polyfill: false } }
+})