@adep/cli 0.0.5 → 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,32 +112,51 @@ adep --json whoami
 
 ### `adep init`
 
-初始化项目（脚手架），模板二选一：
+初始化项目（脚手架）。**默认 `fullstack` 模板**：生成与 Web IDE 项目**同一结构**的全栈骨架
+（`functions/` 云函数 + `web/` 标准 Vite 前端工程 + `database/schema.sql`）：
 
-| 模板       | 说明                                          |
-| ---------- | --------------------------------------------- |
-| `empty`    | 仅 `adep.config.ts` + 空入口，不生成示例函数  |
-| `function` | 生成一个示例函数 `functions/hello.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 empty        # 空模板
-adep init --list                 # 从平台 GET /api/v1/templates 列出可用模板
+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/
 ├── adep.config.ts      # 项目标识（dev / deploy 按此识别）
+├── tsconfig.json       # 云函数 TypeScript 编辑器配置（strict + noEmit）
+├── adep.d.ts           # 云函数上下文环境类型声明（ctx: AdepContext 补全）
 ├── 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) => {...}` 即可。
+
 > 目录已存在时会拒绝覆盖（fail loud），不会静默改写你的代码。
 
 ### `adep dev`
@@ -182,6 +199,7 @@ adep serve --static web          # 指定静态托管目录（缺省 public/）
 ```
 
 - 缺省值优先级为「命令行旗标 > 环境变量（`PORT` / `HOST` / `ADEP_SERVE_STATIC_DIR`）> 内置缺省」，容器编排注入的 `PORT` / `HOST` 不会被命令行缺省盖掉。
+
 - 绑定非回环地址时给出对外暴露警告（它不带生产级加固）。
 
 ### `adep deploy`
@@ -219,7 +237,9 @@ adep projects info game-arcade              # id \t slug \t name \t url
 ```
 
 - `--name` 缺省取 slug：一行命令即可建项目。
+
 - 目标 slug 已占用 → 平台返回 `PROJECT_SLUG_TAKEN`，CLI 原样透传并退出码 1。
+
 - 未登录 / 会话失效 → 打印错误后附带 `提示：先执行 adep login`。
 
 ### `adep functions`
@@ -234,6 +254,7 @@ adep functions logs hello -p my-app --tail 50
 ```
 
 - `deploy` 与 `adep deploy` 共用同一执行体，输出逐字一致（两个入口各写一遍迟早只有一处有汇总行）。
+
 - 日志缓冲在平台进程内（环形），**未执行过的函数为空**——命令会如实说明而非报错。
 
 ### `adep mcp`
@@ -249,8 +270,11 @@ adep mcp list                                        # 打印端点地址 + 已
 ```
 
 - `--function` 是**函数名**，`--name` 是可选的**注册 Tool 名**（缺省取函数名）；目标项目缺省取 `adep.config.ts` 的 `name`，也可用 `-p <slug>` 指定。
+
 - 服务端错误原样透出：函数入参无法映射为 JSON Schema 时返回 `MCP_SCHEMA_UNSERIALIZABLE` 并以退出码 1 结束（CLI 不改写、不兜底，原因由服务端指出）。
-- `mcp list` 读的是**项目 `/mcp` 端点的 `tools/list`**（与外部 Agent 同一条路径）：项目 MCP 鉴权模式为 `public` 时可直接读取；为 `api-key` 时未带 Key 会返回 `MCP_UNAUTHORIZED`。
+
+- `mcp list` 读的是**项目** **`/mcp`** **端点的** **`tools/list`**（与外部 Agent 同一条路径）：项目 MCP 鉴权模式为 `public` 时可直接读取；为 `api-key` 时未带 Key 会返回 `MCP_UNAUTHORIZED`。
+
 - `unpublish` 默认按函数名移除；若曾以别名发布，需加 `--name <tool>` 指向该别名。取消一个不存在的工具会如实说明、不报成功也不报错。
 
 ### `adep doctor`
@@ -263,7 +287,9 @@ adep doctor --json    # { server, credentials, network, serverHealth, offlineCom
 ```
 
 - 已登录时体检的是**凭据里记录的那个平台**（`login --server` 可指到任意环境），未登录才回退 `ADEP_SERVER` 缺省。
+
 - 平台可达性 = 对 `GET /api/v1/health` 的一次真实探测；拿到任何 HTTP 应答都算可达。
+
 - 凭据文件权限宽于 `0600` 会给告警；命令本身**不因体检结论失败**（它是诊断，不是门）。
 
 ### `adep db`
@@ -335,41 +361,8 @@ adep export --out ./dist-export      # 指定输出目录（缺省 ./exports）
 ```
 
 - `--with-data` 附带行数据，`--with-source` 附带函数源码（平台缺省已含，显式给出不改变默认）。
-- `--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 文件。
+- `--json` 输出单个结果信封；导出失败（长任务未产出 / 自检不过）以退出码 1 + `EXPORT_FAILED` 结束，不静默给半截产物。
 
 ---
 
@@ -397,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
+  template: 'fullstack', // 模板：empty | function | fullstack
 }
 ```
 
@@ -449,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` 即输入目标表名以放行；只读查询无需该参数。
@@ -469,3 +462,5 @@ adep --json deploy -p my-app
 ## 相关
 
 - `@adep/runtime` —— 平台运行时内核（执行器 + 本地模拟运行时 + 能力装配），`adep dev` 复用其保证本地/线上语义一致。
+
+<br />