@cogito.ai/cli 0.4.4 → 0.4.5

package/dist/index.js

@@ -868,7 +868,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@cogito.ai/cli",
-    version: "0.4.4",
+    version: "0.4.5",
     type: "module",
     description: "AgentDock CLI – scaffold projects for humans and AI agents",
     publishConfig: {

package/dist/templates/web-nextjs/apps/docs/.source/browser.ts

@@ -7,6 +7,6 @@ const create = browser<typeof Config, import("fumadocs-mdx/runtime/types").Inter
   }
 }>();
 const browserCollections = {
-  docs: create.doc("docs", {"index.mdx": () => import("../content/docs/index.mdx?collection=docs"), "changelog/index.mdx": () => import("../content/docs/changelog/index.mdx?collection=docs"), "features/auth.mdx": () => import("../content/docs/features/auth.mdx?collection=docs"), "features/hello.mdx": () => import("../content/docs/features/hello.mdx?collection=docs"), "decisions/turbo-package-manager.mdx": () => import("../content/docs/decisions/turbo-package-manager.mdx?collection=docs"), "roadmap/index.mdx": () => import("../content/docs/roadmap/index.mdx?collection=docs"), }),
+  docs: create.doc("docs", {"index.mdx": () => import("../content/docs/index.mdx?collection=docs"), "changelog/index.mdx": () => import("../content/docs/changelog/index.mdx?collection=docs"), "decisions/turbo-package-manager.mdx": () => import("../content/docs/decisions/turbo-package-manager.mdx?collection=docs"), "roadmap/index.mdx": () => import("../content/docs/roadmap/index.mdx?collection=docs"), "template/alipay.mdx": () => import("../content/docs/template/alipay.mdx?collection=docs"), "template/deployment.mdx": () => import("../content/docs/template/deployment.mdx?collection=docs"), "template/drizzle.mdx": () => import("../content/docs/template/drizzle.mdx?collection=docs"), "template/getting-started.mdx": () => import("../content/docs/template/getting-started.mdx?collection=docs"), "template/stripe.mdx": () => import("../content/docs/template/stripe.mdx?collection=docs"), "template/supabase.mdx": () => import("../content/docs/template/supabase.mdx?collection=docs"), "template/troubleshooting.mdx": () => import("../content/docs/template/troubleshooting.mdx?collection=docs"), "template/wechat-pay.mdx": () => import("../content/docs/template/wechat-pay.mdx?collection=docs"), "features/auth.mdx": () => import("../content/docs/features/auth.mdx?collection=docs"), "features/hello.mdx": () => import("../content/docs/features/hello.mdx?collection=docs"), }),
 };
 export default browserCollections;

package/dist/templates/web-nextjs/apps/docs/.source/server.ts

@@ -1,14 +1,23 @@
 // @ts-nocheck
-import * as __fd_glob_10 from "../content/docs/roadmap/index.mdx?collection=docs"
-import * as __fd_glob_9 from "../content/docs/decisions/turbo-package-manager.mdx?collection=docs"
-import * as __fd_glob_8 from "../content/docs/features/hello.mdx?collection=docs"
-import * as __fd_glob_7 from "../content/docs/features/auth.mdx?collection=docs"
-import * as __fd_glob_6 from "../content/docs/changelog/index.mdx?collection=docs"
-import * as __fd_glob_5 from "../content/docs/index.mdx?collection=docs"
-import { default as __fd_glob_4 } from "../content/docs/roadmap/meta.json?collection=docs"
-import { default as __fd_glob_3 } from "../content/docs/features/meta.json?collection=docs"
-import { default as __fd_glob_2 } from "../content/docs/decisions/meta.json?collection=docs"
-import { default as __fd_glob_1 } from "../content/docs/changelog/meta.json?collection=docs"
+import * as __fd_glob_19 from "../content/docs/features/hello.mdx?collection=docs"
+import * as __fd_glob_18 from "../content/docs/features/auth.mdx?collection=docs"
+import * as __fd_glob_17 from "../content/docs/template/wechat-pay.mdx?collection=docs"
+import * as __fd_glob_16 from "../content/docs/template/troubleshooting.mdx?collection=docs"
+import * as __fd_glob_15 from "../content/docs/template/supabase.mdx?collection=docs"
+import * as __fd_glob_14 from "../content/docs/template/stripe.mdx?collection=docs"
+import * as __fd_glob_13 from "../content/docs/template/getting-started.mdx?collection=docs"
+import * as __fd_glob_12 from "../content/docs/template/drizzle.mdx?collection=docs"
+import * as __fd_glob_11 from "../content/docs/template/deployment.mdx?collection=docs"
+import * as __fd_glob_10 from "../content/docs/template/alipay.mdx?collection=docs"
+import * as __fd_glob_9 from "../content/docs/roadmap/index.mdx?collection=docs"
+import * as __fd_glob_8 from "../content/docs/decisions/turbo-package-manager.mdx?collection=docs"
+import * as __fd_glob_7 from "../content/docs/changelog/index.mdx?collection=docs"
+import * as __fd_glob_6 from "../content/docs/index.mdx?collection=docs"
+import { default as __fd_glob_5 } from "../content/docs/roadmap/meta.json?collection=docs"
+import { default as __fd_glob_4 } from "../content/docs/template/meta.json?collection=docs"
+import { default as __fd_glob_3 } from "../content/docs/changelog/meta.json?collection=docs"
+import { default as __fd_glob_2 } from "../content/docs/features/meta.json?collection=docs"
+import { default as __fd_glob_1 } from "../content/docs/decisions/meta.json?collection=docs"
 import { default as __fd_glob_0 } from "../content/docs/meta.json?collection=docs"
 import { server } from 'fumadocs-mdx/runtime/server';
 import type * as Config from '../source.config';
@@ -18,4 +27,4 @@ const create = server<typeof Config, import("fumadocs-mdx/runtime/types").Intern
   }
 }>({"doc":{"passthroughs":["extractedReferences"]}});
 
-export const docs = await create.docs("docs", "content/docs", {"meta.json": __fd_glob_0, "changelog/meta.json": __fd_glob_1, "decisions/meta.json": __fd_glob_2, "features/meta.json": __fd_glob_3, "roadmap/meta.json": __fd_glob_4, }, {"index.mdx": __fd_glob_5, "changelog/index.mdx": __fd_glob_6, "features/auth.mdx": __fd_glob_7, "features/hello.mdx": __fd_glob_8, "decisions/turbo-package-manager.mdx": __fd_glob_9, "roadmap/index.mdx": __fd_glob_10, });
+export const docs = await create.docs("docs", "content/docs", {"meta.json": __fd_glob_0, "decisions/meta.json": __fd_glob_1, "features/meta.json": __fd_glob_2, "changelog/meta.json": __fd_glob_3, "template/meta.json": __fd_glob_4, "roadmap/meta.json": __fd_glob_5, }, {"index.mdx": __fd_glob_6, "changelog/index.mdx": __fd_glob_7, "decisions/turbo-package-manager.mdx": __fd_glob_8, "roadmap/index.mdx": __fd_glob_9, "template/alipay.mdx": __fd_glob_10, "template/deployment.mdx": __fd_glob_11, "template/drizzle.mdx": __fd_glob_12, "template/getting-started.mdx": __fd_glob_13, "template/stripe.mdx": __fd_glob_14, "template/supabase.mdx": __fd_glob_15, "template/troubleshooting.mdx": __fd_glob_16, "template/wechat-pay.mdx": __fd_glob_17, "features/auth.mdx": __fd_glob_18, "features/hello.mdx": __fd_glob_19, });

package/dist/templates/web-nextjs/apps/docs/content/docs/meta.json

@@ -1,4 +1,4 @@
 {
   "title": "Documentation",
-  "pages": ["features", "decisions", "changelog", "roadmap"]
+  "pages": ["template", "features", "decisions", "changelog", "roadmap"]
 }

package/dist/templates/web-nextjs/apps/docs/content/docs/template/alipay.mdx

@@ -0,0 +1,276 @@
+---
+title: 支付：支付宝
+description: 支付宝支付集成指南，包括架构、配置、安全和使用方法。
+---
+
+## 概述
+
+本项目集成了 **支付宝** 支付方式，支持电脑网站支付（PC Web）场景。
+
+## 技术架构
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        用户浏览器                              │
+│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐  │
+│  │   选择商品    │ -> │  创建订单     │ -> │  跳转支付     │  │
+│  └──────────────┘    └──────────────┘    └──────────────┘  │
+└─────────────────────────────────────────────────────────────┘
+                             │
+                             ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    Next.js 应用 (Server)                    │
+│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐  │
+│  │  /api/pay    │    │  签名/验签   │    │  回调处理     │  │
+│  │  /api/notify │    │              │    │              │  │
+│  └──────────────┘    └──────────────┘    └──────────────┘  │
+└─────────────────────────────────────────────────────────────┘
+                             │
+                             ▼
+                    ┌────────────────┐
+                    │   支付宝网关    │
+                    │  (openapi.alipay.com) │
+                    └────────────────┘
+```
+
+## 时序图
+
+```
+用户          前端页面         Next.js API      支付宝网关
+ │               │                  │                 │
+ │  1.选择商品   │                  │                 │
+ │─────────────>│                  │                 │
+ │               │  2.POST /create  │                 │
+ │               │─────────────────>│                 │
+ │               │                  │  3.创建订单      │
+ │               │                  │─────────────────>│
+ │               │                  │  4.返回支付链接   │
+ │               │                  │<─────────────────│
+ │  5.返回支付URL│                  │                 │
+ │<─────────────│                  │                 │
+ │  6.跳转支付宝 │                  │                 │
+ │─────────────────────────────────────────────────>│
+ │  7.完成支付   │                  │                 │
+ │<─────────────────────────────────────────────────│
+ │               │                  │  8.异步通知      │
+ │               │                  │<─────────────────│
+ │               │                  │  9.验签+更新状态 │
+ │               │                  │                 │
+ │  10.跳转成功页│                  │                 │
+ │<─────────────│                  │                 │
+```
+
+## 前置条件
+
+### 支付宝开放平台账号
+
+1. 注册 [支付宝开放平台](https://open.alipay.com/) 账号
+2. 创建应用，获取 **APPID**
+3. 生成并配置 **公钥和私钥**
+
+### 必要配置
+
+| 配置项 | 说明 | 获取位置 |
+|--------|------|----------|
+| `ALIPAY_APP_ID` | 应用 APPID | 支付宝开放平台 → 应用详情 |
+| `ALIPAY_PRIVATE_KEY` | 应用私钥 | 密钥工具生成 |
+| `ALIPAY_PUBLIC_KEY` | 应用公钥 | 密钥工具生成 |
+| `ALIPAY_GATEWAY_URL` | 网关地址 | `https://openapi.alipay.com/gateway.do` |
+
+## 开发环境配置
+
+### 1. 配置环境变量
+
+在 `.env.local` 中添加：
+
+```
+ALIPAY_APP_ID=your-app-id
+ALIPAY_PRIVATE_KEY=-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----
+ALIPAY_PUBLIC_KEY=-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----
+ALIPAY_GATEWAY_URL=https://openapi.alipay.com/gateway.do
+ALIPAY_NOTIFY_URL=https://your-domain.com/api/payments/alipay/notify
+ALIPAY_RETURN_URL=https://your-domain.com/payment/success
+```
+
+> **注意**: 私钥包含换行符，使用 `\n` 转义。
+
+### 2. 生成密钥对
+
+使用支付宝提供的 [密钥工具](https://opendocs.alipay.com/common/02khje) 生成 RSA2 密钥对：
+
+```bash
+# 工具下载
+https://ides.alipay.com/static/Alipaykeytool.dmg
+
+# 选择 "RSA2" 和 "PKCS1" 格式
+# 保存私钥和公钥
+```
+
+### 3. 配置支付宝公钥
+
+在支付宝开放平台 → 应用详情 → 开发设置 → 接口加签方式 中：
+
+1. 上传你的应用公钥
+2. 获取支付宝公钥（用于回调验签）
+
+## 生产环境配置
+
+### 服务器要求
+
+- 公网可访问的 HTTPS 地址
+- 支持接收 POST 请求的回调接口
+
+### 回调地址配置
+
+在支付宝开放平台 → 应用详情 → 开发设置 中配置：
+
+| 配置项 | 值 |
+|--------|-----|
+| 授权回调地址 | `https://your-domain.com/api/payments/alipay/return` |
+| 异步通知地址 | `https://your-domain.com/api/payments/alipay/notify` |
+
+## API 路由
+
+### 创建支付订单
+
+```http
+POST /api/payments/alipay/create
+Content-Type: application/json
+
+{
+  "orderId": "ORDER_123456",
+  "amount": 99.99,
+  "subject": "商品名称",
+  "body": "商品描述"
+}
+```
+
+**响应:**
+
+```json
+{
+  "success": true,
+  "data": {
+    "paymentUrl": "https://openapi.alipay.com/gateway.do?..."
+  }
+}
+```
+
+### 支付回调通知
+
+```http
+POST /api/payments/alipay/notify
+Content-Type: application/x-www-form-urlencoded
+```
+
+支付宝会发送以下参数：
+
+| 参数 | 说明 |
+|------|------|
+| `out_trade_no` | 商户订单号 |
+| `trade_no` | 支付宝交易号 |
+| `trade_status` | 交易状态（TRADE_SUCCESS 表示成功） |
+| `total_amount` | 订单金额 |
+| `sign` | 签名 |
+
+### 查询订单状态
+
+```http
+GET /api/payments/alipay/query?outTradeNo=ORDER_123456
+```
+
+## 安全注意事项
+
+### 签名验证
+
+**务必验证支付宝回调的签名**，防止伪造通知：
+
+```ts
+import { verifyAlipaySignature } from '@/lib/alipay'
+
+// 回调处理
+export async function POST(request: Request) {
+  const formData = await request.formData()
+  const params = Object.fromEntries(formData)
+  
+  // 1. 验证签名
+  const isValid = verifyAlipaySignature(params)
+  if (!isValid) {
+    return new Response('Invalid signature', { status: 400 })
+  }
+  
+  // 2. 更新订单状态
+  // ...
+}
+```
+
+### 安全最佳实践
+
+| 风险 | 防护措施 |
+|------|----------|
+| 回调伪造 | 严格验证签名 |
+| 金额篡改 | 比对数据库订单金额与回调金额 |
+| 重复通知 | 使用幂等性处理（out_trade_no 去重） |
+| 密钥泄露 | 私钥仅存储在服务器端，绝不暴露到客户端 |
+| 中间人攻击 | 使用 HTTPS 传输 |
+
+### 幂等性处理
+
+```ts
+// 使用数据库唯一约束防止重复处理
+await db.payments.updateOne(
+  { outTradeNo: params.out_trade_no, status: { $ne: 'PAID' } },
+  { $set: { status: 'PAID', tradeNo: params.trade_no } }
+)
+```
+
+## 开发环境调试
+
+### 沙箱环境
+
+支付宝提供沙箱环境用于开发测试：
+
+1. 登录 [支付宝开放平台](https://open.alipay.com/)
+2. 进入 **沙箱** 页面
+3. 获取沙箱 APPID 和密钥
+4. 修改环境变量为沙箱配置：
+
+```
+ALIPAY_GATEWAY_URL=https://openapi.alipaydev.com/gateway.do
+ALIPAY_APP_ID=your-sandbox-app-id
+```
+
+### 调试工具
+
+- [支付宝沙箱环境](https://open.alipay.com/platform/appDaily.htm?tab=account)
+- [在线签名校验工具](https://opendocs.alipay.com/common/02maie)
+
+## 支付宝支付 FAQs
+
+**Q: 支付回调收不到怎么办？**
+
+A: 检查以下几点：
+1. 服务器是否公网可访问
+2. 回调地址是否正确配置在支付宝开放平台
+3. 是否使用 HTTPS（支付宝要求）
+4. 服务器防火墙是否放行
+
+**Q: 签名验证失败？**
+
+A: 常见原因：
+1. 公私钥不匹配
+2. 编码格式错误（应为 UTF-8）
+3. 公钥/私钥格式错误（应为 PKCS1 格式）
+
+**Q: 如何测试支付流程？**
+
+A: 使用支付宝沙箱环境 + 沙箱账号登录 [沙箱版支付宝 APP](https://open.alipay.com/platform/appDaily.htm?tab=tool)。
+
+## 相关资源
+
+- [支付宝开放平台](https://open.alipay.com/)
+- [支付宝电脑网站支付文档](https://opendocs.alipay.com/open/270/105899)
+- [支付宝沙箱环境](https://open.alipay.com/platform/appDaily.htm)
+- [密钥工具下载](https://opendocs.alipay.com/common/02khje)
+- [签名校验工具](https://opendocs.alipay.com/common/02maie)
+- [异步通知说明](https://opendocs.alipay.com/open/270/105902)

package/dist/templates/web-nextjs/apps/docs/content/docs/template/deployment.mdx

@@ -0,0 +1,32 @@
+---
+title: 项目部署
+description: 如何将 web-nextjs 模板项目部署到生产环境。
+---
+
+## 概述
+
+本章将介绍如何将 web-nextjs 模板项目部署到生产环境。
+
+> **占位章节**。后续我们会结合 CLI 部署到我们自己的部署平台 Dokploy。
+
+## 部署选项
+
+### 1. Vercel
+
+Vercel 是 Next.js 的原生部署平台，支持一键部署。
+
+### 2. Dokploy
+
+我们将通过 AgentDock CLI 集成 Dokploy 平台，实现一键部署。
+
+## 环境变量
+
+生产环境需要配置以下环境变量：
+
+- `NEXT_PUBLIC_SUPABASE_URL`
+- `NEXT_PUBLIC_SUPABASE_ANON_KEY`
+- `SUPABASE_SERVICE_ROLE_KEY`
+
+## 即将推出
+
+本章内容正在完善中，敬请期待。

package/dist/templates/web-nextjs/apps/docs/content/docs/template/drizzle.mdx

@@ -0,0 +1,18 @@
+---
+title: 数据层：Drizzle
+description: ORM 和数据库迁移管理。
+---
+
+## 概述
+
+本章将介绍如何使用 Drizzle ORM 管理数据库模式和查询。
+
+> **占位章节**。内容正在完善中。
+
+## 即将推出
+
+本章内容正在编写中，敬请期待。
+
+## 相关资源
+
+- [Drizzle ORM 官方文档](https://orm.drizzle.team/)

package/dist/templates/web-nextjs/apps/docs/content/docs/template/getting-started.mdx

@@ -0,0 +1,98 @@
+---
+title: 开始使用
+description: 如何初始化、开发和部署 web-nextjs 模板项目。
+---
+
+## 环境要求
+
+- **Node.js**: >= 18
+- **pnpm**: >= 9
+- **Git**
+
+## 通过 CLI 初始化项目
+
+使用 AgentDock CLI 创建新项目：
+
+```bash
+npx @cogito.ai/agentdock-cli create my-project
+```
+
+选择 **web-nextjs** 模板，CLI 会自动完成以下操作：
+
+1. 克隆模板代码
+2. 安装依赖 (`pnpm install`)
+3. 复制环境变量配置文件 (`.env.local`)
+
+## 本地开发
+
+### 安装依赖
+
+```bash
+pnpm install
+```
+
+### 启动开发服务器
+
+```bash
+pnpm dev
+```
+
+这会同时启动：
+- **Web 应用**: http://localhost:3000
+- **文档站点**: http://localhost:3001
+
+### 构建生产版本
+
+```bash
+pnpm build
+```
+
+### 运行测试
+
+```bash
+pnpm test          # 运行单元测试
+pnpm check-types   # TypeScript 类型检查
+pnpm lint          # ESLint 代码检查
+```
+
+## 项目结构
+
+```
+my-project/
+├── apps/
+│   ├── web/          # Next.js 主应用
+│   └── docs/         # Fumadocs 文档站点
+├── packages/         # 共享包
+├── supabase/         # 数据库迁移
+└── scripts/          # 自动化脚本
+```
+
+## 关键配置
+
+### 环境变量
+
+复制 `.env.local.example` 到 `.env.local`，并填写以下配置：
+
+| 变量 | 说明 | 获取方式 |
+|------|------|----------|
+| `NEXT_PUBLIC_SUPABASE_URL` | Supabase 项目 URL | Supabase Dashboard → Project Settings → API |
+| `NEXT_PUBLIC_SUPABASE_ANON_KEY` | Supabase 匿名密钥 | Supabase Dashboard → Project Settings → API |
+| `SUPABASE_SERVICE_ROLE_KEY` | Supabase 服务角色密钥 | Supabase Dashboard → Project Settings → API |
+
+### pnpm 工作区
+
+项目使用 pnpm workspace 管理 monorepo：
+
+```yaml
+# pnpm-workspace.yaml
+packages:
+  - 'apps/*'
+  - 'packages/*'
+```
+
+## 下一步
+
+- [数据层：Supabase](/docs/template/supabase)
+- [数据层：Drizzle](/docs/template/drizzle)
+- [支付：支付宝](/docs/template/alipay)
+- [支付：微信支付](/docs/template/wechat-pay)

package/dist/templates/web-nextjs/apps/docs/content/docs/template/meta.json

@@ -0,0 +1,13 @@
+{
+  "title": "web-nextjs 模板",
+  "pages": [
+    "getting-started",
+    "deployment",
+    "supabase",
+    "drizzle",
+    "alipay",
+    "wechat-pay",
+    "stripe",
+    "troubleshooting"
+  ]
+}

package/dist/templates/web-nextjs/apps/docs/content/docs/template/stripe.mdx

@@ -0,0 +1,18 @@
+---
+title: 支付：Stripe
+description: Stripe 支付集成指南。
+---
+
+## 概述
+
+本章将介绍如何集成 Stripe 支付。
+
+> **占位章节**。内容正在完善中。
+
+## 即将推出
+
+本章内容正在编写中，敬请期待。
+
+## 相关资源
+
+- [Stripe 官方文档](https://stripe.com/docs)

package/dist/templates/web-nextjs/apps/docs/content/docs/template/supabase.mdx

@@ -0,0 +1,130 @@
+---
+title: 数据层：Supabase
+description: 如何在开发环境和生产环境中使用 Supabase，包括数据表设计、类型安全和最佳实践。
+---
+
+## 概述
+
+本项目使用 **Supabase** 作为后端数据库和身份验证服务。Supabase 提供了 PostgreSQL 数据库、自动生成的 REST API、实时订阅和身份验证功能。
+
+## 开发环境配置
+
+### 本地 Supabase CLI
+
+1. **安装 Supabase CLI**
+
+```bash
+pnpm add -g supabase
+```
+
+2. **登录 Supabase**
+
+```bash
+supabase login
+```
+
+3. **启动本地 Supabase 实例**
+
+```bash
+supabase start
+```
+
+本地开发时，Supabase 服务运行在：
+- **Studio UI**: http://localhost:54323
+- **API URL**: http://localhost:54321
+- **数据库**: postgresql://postgres:postgres@localhost:54322/postgres
+
+### 环境变量
+
+在 `.env.local` 中配置本地 Supabase：
+
+```
+NEXT_PUBLIC_SUPABASE_URL=http://localhost:54321
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your-local-anon-key
+SUPABASE_SERVICE_ROLE_KEY=your-local-service-role-key
+```
+
+> 运行 `supabase status` 获取本地密钥。
+
+## 生产环境配置
+
+1. 在 [Supabase Dashboard](https://supabase.com/dashboard) 创建新项目
+2. 获取项目 URL 和 API 密钥
+3. 更新生产环境变量
+
+## 数据表设计
+
+项目包含以下核心数据表（通过迁移脚本管理）：
+
+| 表名 | 说明 |
+|------|------|
+| `profiles` | 用户资料扩展 |
+| `subscriptions` | 订阅信息 |
+| `payments` | 支付记录 |
+
+### 运行迁移
+
+```bash
+# 本地
+supabase migration up
+
+# 生产
+supabase migration up --linked
+```
+
+## 类型安全
+
+项目使用 **Supabase 类型生成** 确保数据库查询的类型安全：
+
+```ts
+import { createClient } from '@supabase/supabase-js'
+import type { Database } from './supabase/types'
+
+const supabase = createClient<Database>(url, key)
+```
+
+运行以下命令生成类型：
+
+```bash
+supabase gen types typescript --project-id your-project-id --schema public > src/lib/supabase/types.ts
+```
+
+## 安全最佳实践
+
+### 行级安全策略 (RLS)
+
+所有表默认启用 RLS，确保用户只能访问自己的数据：
+
+```sql
+CREATE POLICY "Users can only access their own data"
+ON profiles FOR ALL
+TO authenticated
+USING (auth.uid() = user_id);
+```
+
+### 服务角色密钥
+
+- **仅在服务器端**使用 `SUPABASE_SERVICE_ROLE_KEY`
+- **绝不在客户端**暴露服务角色密钥
+- 使用 `@supabase/ssr` 包管理会话
+
+## 开发调试
+
+### 查看数据库
+
+通过 Supabase Studio 访问本地数据库：
+
+```bash
+supabase studio
+```
+
+### 日志和监控
+
+- 本地：http://localhost:54323/project/default/logs/explorer
+- 生产：Supabase Dashboard → Logs
+
+## 相关资源
+
+- [Supabase 官方文档](https://supabase.com/docs)
+- [Supabase JavaScript 客户端](https://supabase.com/docs/reference/javascript)
+- [PostgreSQL 文档](https://www.postgresql.org/docs/)

package/dist/templates/web-nextjs/apps/docs/content/docs/template/troubleshooting.mdx

@@ -0,0 +1,87 @@
+---
+title: 故障排查
+description: 常见问题及解决方案。
+---
+
+## 常见问题
+
+### pnpm install 失败
+
+**问题**: 运行 `pnpm install` 时出现 `ERR_PNPM_IGNORED_BUILDS` 错误。
+
+**解决方案**: 
+- 运行 `pnpm approve-builds` 批准构建脚本
+- 或者检查 `pnpm-workspace.yaml` 中的 `onlyBuiltDependencies` 配置
+
+### 类型检查失败
+
+**问题**: `pnpm check-types` 报错。
+
+**解决方案**: 
+- 确保 `.env.local` 文件存在
+- 运行 `pnpm build` 更新 `.source/` 文件
+
+### 文档站点 404
+
+**问题**: 访问 `/docs` 返回 404。
+
+**解决方案**: 
+- 确保 docs 应用已启动（`pnpm --filter @cogito.ai/docs dev`）
+- 检查 `.source/` 文件是否已生成
+
+### 支付回调收不到
+
+**问题**: 支付宝/微信支付回调通知收不到。
+
+**解决方案**: 
+- 确保服务器公网可访问
+- 检查回调地址配置是否正确
+- 确认使用 HTTPS 协议
+- 查看服务器防火墙设置
+
+### 数据库连接失败
+
+**问题**: 无法连接 Supabase 数据库。
+
+**解决方案**: 
+- 检查 `.env.local` 中的 Supabase URL 和密钥
+- 确保本地 Supabase 实例已启动（`supabase start`）
+- 验证网络连接
+
+## 调试技巧
+
+### 查看日志
+
+```bash
+# Web 应用日志
+pnpm --filter @cogito.ai/web dev
+
+# 文档站点日志
+pnpm --filter @cogito.ai/docs dev
+```
+
+### 清理缓存
+
+```bash
+# 删除 node_modules 和 lockfile
+rm -rf node_modules pnpm-lock.yaml
+
+# 重新安装依赖
+pnpm install
+```
+
+### 检查环境变量
+
+```bash
+# 确认 .env.local 存在
+cat .env.local
+
+# 确认变量已加载
+node -e "console.log(process.env.NEXT_PUBLIC_SUPABASE_URL)"
+```
+
+## 获取帮助
+
+- [AgentDock GitHub Issues](https://github.com/your-org/agentdock/issues)
+- [Next.js 文档](https://nextjs.org/docs)
+- [Supabase 文档](https://supabase.com/docs)

package/dist/templates/web-nextjs/apps/docs/content/docs/template/wechat-pay.mdx

@@ -0,0 +1,318 @@
+---
+title: 支付：微信支付
+description: 微信支付集成指南，包括架构、配置、安全和使用方法。
+---
+
+## 概述
+
+本项目集成了 **微信支付**（WeChat Pay），支持 Native 支付（扫码支付）和 JSAPI 支付（公众号/小程序内支付）场景。
+
+## 技术架构
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        用户浏览器                              │
+│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐  │
+│  │   选择商品    │ -> │  创建订单     │ -> │  扫码/调起支付 │  │
+│  └──────────────┘    └──────────────┘    └──────────────┘  │
+└─────────────────────────────────────────────────────────────┘
+                             │
+                             ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    Next.js 应用 (Server)                    │
+│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐  │
+│  │  /api/pay    │    │  签名/验签   │    │  回调处理     │  │
+│  │  /api/notify │    │              │    │              │  │
+│  └──────────────┘    └──────────────┘    └──────────────┘  │
+└─────────────────────────────────────────────────────────────┘
+                             │
+                             ▼
+                    ┌────────────────┐
+                    │   微信支付网关  │
+                    │  (api.mch.weixin.qq.com) │
+                    └────────────────┘
+```
+
+## 时序图
+
+```
+用户          前端页面         Next.js API      微信支付网关
+ │               │                  │                 │
+ │  1.选择商品   │                  │                 │
+ │─────────────>│                  │                 │
+ │               │  2.POST /create  │                 │
+ │               │─────────────────>│                 │
+ │               │                  │  3.统一下单      │
+ │               │                  │─────────────────>│
+ │               │                  │  4.返回 prepay_id│
+ │               │                  │<─────────────────│
+ │  5.返回支付参数│                  │                 │
+ │<─────────────│                  │                 │
+ │  6.调起微信支付│                  │                 │
+ │─────────────────────────────────────────────────>│
+ │  7.支付成功   │                  │                 │
+ │<─────────────────────────────────────────────────│
+ │               │                  │  8.异步通知      │
+ │               │                  │<─────────────────│
+ │               │                  │  9.验签+更新状态 │
+ │               │                  │                 │
+ │  10.跳转成功页│                  │                 │
+ │<─────────────│                  │                 │
+```
+
+## 前置条件
+
+### 微信支付商户账号
+
+1. 注册 [微信支付商户平台](https://pay.weixin.qq.com/) 账号
+2. 完成商户认证，获取 **商户号 (mch_id)**
+3. 申请 **API 证书** 和 **APIv3 密钥**
+
+### 必要配置
+
+| 配置项 | 说明 | 获取位置 |
+|--------|------|----------|
+| `WECHAT_PAY_MCH_ID` | 商户号 | 微信支付商户平台 → 账户中心 |
+| `WECHAT_PAY_APP_ID` | 应用 APPID | 微信开放平台/公众号平台 |
+| `WECHAT_PAY_API_V3_KEY` | APIv3 密钥 | 微信支付商户平台 → 账户中心 → API安全 |
+| `WECHAT_PAY_CERT_SERIAL_NO` | 证书序列号 | 商户平台 → API安全 → 管理证书 |
+| `WECHAT_PAY_PRIVATE_KEY` | 商户私钥 | 下载的 apiclient_key.pem |
+
+## 开发环境配置
+
+### 1. 配置环境变量
+
+在 `.env.local` 中添加：
+
+```
+WECHAT_PAY_MCH_ID=your-mch-id
+WECHAT_PAY_APP_ID=your-app-id
+WECHAT_PAY_API_V3_KEY=your-api-v3-key
+WECHAT_PAY_CERT_SERIAL_NO=your-cert-serial-no
+WECHAT_PAY_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----
+WECHAT_PAY_NOTIFY_URL=https://your-domain.com/api/payments/wechat/notify
+```
+
+> **注意**: 私钥包含换行符，使用 `\n` 转义。
+
+### 2. 下载 API 证书
+
+1. 登录 [微信支付商户平台](https://pay.weixin.qq.com/)
+2. 进入 **账户中心 → API安全 → 申请API证书**
+3. 下载证书文件（`apiclient_cert.pem` 和 `apiclient_key.pem`）
+
+### 3. 设置 APIv3 密钥
+
+在商户平台 → 账户中心 → API安全 → 设置 APIv3 密钥：
+
+1. 点击"设置密钥"
+2. 使用随机字符串生成器生成 32 位密钥
+3. 保存密钥（只会显示一次）
+
+## 生产环境配置
+
+### 服务器要求
+
+- 公网可访问的 HTTPS 地址
+- 支持接收 POST 请求的回调接口
+- 服务器时间与微信服务器时间误差不超过 5 分钟
+
+### 回调地址配置
+
+在商户平台 → 产品中心 → 开发配置 中配置：
+
+| 配置项 | 值 |
+|--------|-----|
+| 回调通知地址 | `https://your-domain.com/api/payments/wechat/notify` |
+
+## API 路由
+
+### 创建支付订单
+
+```http
+POST /api/payments/wechat/create
+Content-Type: application/json
+
+{
+  "orderId": "ORDER_123456",
+  "amount": 99.99,
+  "description": "商品描述",
+  "openid": "user-openid"  // JSAPI 支付需要
+}
+```
+
+**响应:**
+
+```json
+{
+  "success": true,
+  "data": {
+    "prepayId": "wx20240101120000...",
+    "appId": "wx...",
+    "timeStamp": "1704096000",
+    "nonceStr": "...",
+    "package": "prepay_id=wx...",
+    "signType": "RSA",
+    "paySign": "..."
+  }
+}
+```
+
+### 支付回调通知
+
+```http
+POST /api/payments/wechat/notify
+Content-Type: application/json
+```
+
+微信支付回调请求头包含 `Wechatpay-Serial` 和 `Wechatpay-Signature`：
+
+```ts
+export async function POST(request: Request) {
+  const body = await request.text()
+  const signature = request.headers.get('Wechatpay-Signature')
+  const serial = request.headers.get('Wechatpay-Serial')
+  
+  // 1. 验证签名
+  const isValid = await verifyWechatSignature(body, signature, serial)
+  if (!isValid) {
+    return new Response('Invalid signature', { status: 400 })
+  }
+  
+  // 2. 解密回调数据
+  const data = JSON.parse(body)
+  const decrypted = await decryptWechatPayload(data)
+  
+  // 3. 更新订单状态
+  // ...
+}
+```
+
+### 查询订单状态
+
+```http
+GET /api/payments/wechat/query?outTradeNo=ORDER_123456
+```
+
+## 安全注意事项
+
+### 签名验证
+
+微信支付使用 **RSA 签名** 和 **AES 加密**，必须严格验证：
+
+```ts
+import { verifyWechatSignature, decryptWechatPayload } from '@/lib/wechat-pay'
+
+export async function POST(request: Request) {
+  const body = await request.text()
+  const signature = request.headers.get('Wechatpay-Signature')
+  
+  // 1. 验证签名
+  const isValid = await verifyWechatSignature(body, signature)
+  if (!isValid) {
+    return new Response('Invalid signature', { status: 400 })
+  }
+  
+  // 2. 解密回调数据
+  const data = JSON.parse(body)
+  const decrypted = await decryptWechatPayload(data)
+  
+  // 3. 验证金额（防止篡改）
+  const order = await db.payments.findOne({ outTradeNo: decrypted.out_trade_no })
+  if (order.amount !== decrypted.amount.total) {
+    return new Response('Amount mismatch', { status: 400 })
+  }
+  
+  // 4. 更新订单状态
+  // ...
+}
+```
+
+### 安全最佳实践
+
+| 风险 | 防护措施 |
+|------|----------|
+| 回调伪造 | 严格验证签名和证书序列号 |
+| 金额篡改 | 比对数据库订单金额与回调金额 |
+| 重复通知 | 使用幂等性处理（out_trade_no 去重） |
+| 密钥泄露 | 私钥仅存储在服务器端 |
+| 中间人攻击 | 使用 HTTPS 传输 |
+| 时间戳重放 | 检查时间戳是否在合理范围内（5分钟） |
+
+### 幂等性处理
+
+```ts
+// 使用数据库唯一约束防止重复处理
+await db.payments.updateOne(
+  { outTradeNo: decrypted.out_trade_no, status: { $ne: 'PAID' } },
+  { 
+    $set: { 
+      status: 'PAID', 
+      transactionId: decrypted.transaction_id 
+    } 
+  }
+)
+```
+
+## 开发环境调试
+
+### 沙箱环境
+
+微信支付提供沙箱环境用于开发测试：
+
+1. 登录 [微信支付商户平台](https://pay.weixin.qq.com/)
+2. 进入 **产品中心 → 开发配置 → 沙箱**
+3. 获取沙箱 API 密钥
+4. 修改环境变量为沙箱配置：
+
+```
+WECHAT_PAY_GATEWAY_URL=https://api.mch.weixin.qq.com/sandboxnew
+```
+
+### 调试工具
+
+- [微信支付开发者工具](https://pay.weixin.qq.com/wiki/doc/apiv3/open/pay/Android_JDk.html)
+- [签名调试工具](https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay6_0.shtml)
+
+## 微信支付 FAQs
+
+**Q: 回调通知收不到？**
+
+A: 检查以下几点：
+1. 服务器是否公网可访问
+2. 回调地址是否正确配置在商户平台
+3. 是否使用 HTTPS（微信要求）
+4. 服务器时间是否准确（误差不超过5分钟）
+5. 防火墙是否放行
+
+**Q: 签名验证失败？**
+
+A: 常见原因：
+1. APIv3 密钥错误
+2. 私钥格式错误（应为 PKCS#8 格式）
+3. 时间戳误差超过 5 分钟
+4. 请求体编码错误（应为 UTF-8）
+
+**Q: 如何测试支付流程？**
+
+A: 使用微信支付沙箱环境：
+1. 在商户平台启用沙箱模式
+2. 使用沙箱 API 密钥
+3. 使用 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html) 模拟支付
+
+**Q: 如何获取用户的 OpenID？**
+
+A: 对于 JSAPI 支付，需要通过 OAuth 授权获取用户 OpenID：
+1. 引导用户访问微信 OAuth 授权链接
+2. 用户授权后，微信会重定向到回调地址并附带 `code`
+3. 使用 `code` 换取 `openid`
+
+## 相关资源
+
+- [微信支付商户平台](https://pay.weixin.qq.com/)
+- [微信支付开发文档](https://pay.weixin.qq.com/wiki/doc/apiv3/index.shtml)
+- [Native 支付文档](https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_4_1.shtml)
+- [JSAPI 支付文档](https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_1.shtml)
+- [微信支付沙箱环境](https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay7_0.shtml)
+- [APIv3 签名指南](https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay4_0.shtml)
+- [回调通知说明](https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay4_1.shtml)

package/dist/templates/web-nextjs/apps/web/src/app/[locale]/layout.tsx

@@ -4,7 +4,7 @@ import { NextIntlClientProvider } from 'next-intl'
 import { getMessages } from 'next-intl/server'
 import { notFound } from 'next/navigation'
 import { Toaster } from '@/components/ui/sonner'
-import { ThemeProvider } from 'next-themes'
+import { ThemeProvider } from '@/components/providers/theme-provider'
 import { isLocale } from '@/i18n/config'
 import './globals.css'
 

package/dist/templates/web-nextjs/apps/web/src/app/docs/page.tsx

@@ -0,0 +1,5 @@
+import { redirect } from 'next/navigation'
+
+export default function DocsPage() {
+  redirect('http://localhost:3001/docs')
+}

package/dist/templates/web-nextjs/pnpm-workspace.yaml

@@ -8,11 +8,10 @@ allowBuilds:
   esbuild: set this to true or false
   msw: set this to true or false
   sharp: set this to true or false
-pnpm:
-  onlyBuiltDependencies:
-    - '@fission-ai/openspec'
-    - '@parcel/watcher'
-    - '@swc/core'
-    - esbuild
-    - msw
-    - sharp
+onlyBuiltDependencies:
+  - '@fission-ai/openspec'
+  - '@parcel/watcher'
+  - '@swc/core'
+  - esbuild
+  - msw
+  - sharp

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cogito.ai/cli",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "type": "module",
   "description": "AgentDock CLI – scaffold projects for humans and AI agents",
   "publishConfig": {