@adep/cli 0.0.6 → 0.0.7

package/README.md

@@ -1,6 +1,6 @@
 # adep — AgentDeploy CLI
 
-> 面向终端开发者的 AgentDeploy 命令行工具：**登录 / 初始化 / 本地调试 / 部署 / 数据库维护 / 云存储 / 静态托管 / 微前端组件（widget）** 一站式闭环。
+> 面向终端开发者的 AgentDeploy 命令行工具：**登录 / 初始化 / 本地调试 / 部署 / 数据库维护 / 云存储 / 静态托管 / 全栈工程（functions/ + web/ 前端）** 一站式闭环。
 
 `adep` 让你在一个项目目录里完成从**脚手架 → 本地调试 → 部署上线 → 数据与资源运维**的完整流程。它复用平台运行时内核（`@adep/runtime`），本地与线上的执行语义一致，离线、不装 Docker 也能开发。
 
@@ -46,8 +46,6 @@
 
    - [`adep export`](#adep-export)
 
-   - [`adep widget`](#adep-widget)
-
 4. [配置](#配置)
 
    - [环境变量](#环境变量)
@@ -114,25 +112,24 @@ adep --json whoami
 
 ### `adep init`
 
-初始化项目（脚手架），模板支持生成**单个函数 / 单个 Widget / 单个 Page**：
+初始化项目（脚手架）。**默认 `fullstack` 模板**：生成与 Web IDE 项目**同一结构**的全栈骨架
+（`functions/` 云函数 + `web/` 标准 Vite 前端工程 + `database/schema.sql`）：
 
-| 模板       | 说明                                                          |
-| ---------- | ------------------------------------------------------------- |
-| `function` | 生成一个示例函数 `functions/hello.ts`（默认）                 |
-| `widget`   | 生成单个 Widget（微前端组件，落 `widgets/<name>/`）           |
-| `page`     | 生成单个 Page（静态页面，落 `web/index.html`）                |
-| `empty`    | 仅项目骨架（`adep.config.ts` + 类型提示入口，不生成示例产物） |
+| 模板        | 说明                                                                           |
+| ----------- | ------------------------------------------------------------------------------ |
+| `fullstack` | 全栈骨架：`functions/` + `web/`（Vite + Vue 3）+ `database/schema.sql`（默认） |
+| `function`  | 仅云函数：单个示例函数 `functions/hello.ts`                                    |
+| `empty`     | 仅项目骨架（`adep.config.ts` + 类型提示入口，不生成示例产物）                  |
 
 ```bash
-adep init my-app                      # 默认 function 模板（单个函数）
-adep init my-app -t widget            # 单个 Widget
-adep init my-app -t page              # 单个 Page
+adep init my-app                      # 默认 fullstack 模板（与 Web IDE 项目同构）
+adep init my-app -t function          # 仅云函数
 adep init my-app -t empty             # 空模板
 adep init --list                      # 从平台 GET /api/v1/templates 列出可用模板
 adep init --list -s https://platform.example.com
 ```
 
-产物结构（`function` 模板）：
+产物结构（`fullstack` 模板）：
 
 ```
 my-app/
@@ -142,10 +139,20 @@ my-app/
 ├── functions/
 │   ├── hello.ts        # 示例函数（deploy 后经 /hello 触发）
 │   └── README.md
+├── web/                # 前端工程（标准 Vite + Vue 3，与 Web IDE 项目同构）
+│   ├── index.html
+│   ├── package.json
+│   ├── vite.config.ts
+│   └── src/{main.ts, App.vue}
+├── database/
+│   └── schema.sql      # 数据库结构（占位；表由平台控制台 / adep db 管理）
 ├── README.md
 └── .gitignore          # 已忽略 node_modules/ data/ .adep/
 ```
 
+**web/ 前端工程**：与 Web IDE 内创建的项目完全同构（同一份模板真相源），可无缝在两端切换开发；
+本地跑前端：`cd web && npm install && npm run dev`，部署由 `adep deploy` 统一构建发布。
+
 **类型提示**：`adep init` 产出的项目自带 `tsconfig.json` 与 `adep.d.ts`，用 VSCode 打开即可在
 `functions/` 下获得 `AdepContext` / `ctx.cloud.*` 补全，无需本机安装 `@adep/types`。
 函数签名写 `export default async (ctx: AdepContext) => {...}` 即可。
@@ -357,40 +364,6 @@ adep export --out ./dist-export      # 指定输出目录（缺省 ./exports）
 
 - `--json` 输出单个结果信封；导出失败（长任务未产出 / 自检不过）以退出码 1 + `EXPORT_FAILED` 结束，不静默给半截产物。
 
-### `adep widget`
-
-微前端组件（widget）的子命令组：脚手架 / 本地沙箱 / 发布。
-
-#### `adep widget init`
-
-```bash
-adep widget init my-widget                 # 默认 vue3-ts 模板
-adep widget init my-widget -t react-ts     # 或 react-ts
-```
-
-widget 名称需以小写字母开头，仅含小写字母 / 数字 / 连字符。
-
-#### `adep widget dev`
-
-本地宿主沙箱：主题变量 + mock props + token 注入 + 热更新，默认 `http://127.0.0.1:8788`。
-
-```bash
-adep widget dev                  # 默认端口 8788
-adep widget dev -p 9000
-# 在浏览器打开 ?token=<...> 可注入鉴权 token
-```
-
-#### `adep widget publish`
-
-按框架构建 → 上传平台静态资源 → 版本化输出 URL：
-
-```bash
-adep widget publish -p my-app
-# → my-widget  v0.1.0  https://my-app.platform.example.com/widgets/my-widget/0.1.0/index.js
-```
-
-版本取自 widget `package.json` 的 `version`（缺省 `0.1.0`）；产物是单个 ESM 文件。
-
 ---
 
 ## 配置
@@ -417,7 +390,7 @@ export ADEP_HOME=~/.adep
 // adep 项目配置：CLI（dev / deploy）按 default export 读取（name / functionsDir）。
 export default {
   name: 'my-app', // 项目名（deploy 的默认 slug）
-  template: 'function', // 模板：empty | function | widget | page
+  template: 'fullstack', // 模板：empty | function | fullstack
 }
 ```
 
@@ -469,8 +442,8 @@ adep --json deploy -p my-app
 **Q：`adep deploy`** **显示** **`no changes`？**
 这是幂等设计：本地函数内容与已发布版本一致时复用当前版本，不产生新版本。想强制更新需修改函数内容。
 
-**Q：项目名 / widget 名的命名规则？**
-`init` 项目名：小写字母开头，仅含小写字母 / 数字 / 连字符（≤ 63 字符）。`widget init` 名称同规则。
+**Q：项目名的命名规则？**
+`init` 项目名：小写字母开头，仅含小写字母 / 数字 / 连字符（≤ 63 字符）。
 
 **Q：`adep db exec`** **的** **`--confirm-table`** **是做什么的？**
 写 / 破坏性语句（DELETE / DROP / ALTER…）服务端要求二次确认目标表名，`--confirm-table users` 即输入目标表名以放行；只读查询无需该参数。