@hlw-uni/mp-cli 1.0.13 → 1.0.15

package/package.json

@@ -1,38 +1,38 @@
 {
-    "name": "@hlw-uni/mp-cli",
-    "version": "1.0.13",
-    "description": "uniapp 小程序脚手架生成器",
-    "main": "bin/cli.js",
-    "bin": {
-        "hlw-uni-mp": "./bin/cli.js"
-    },
-    "scripts": {
-        "dev": "tsx bin/cli.ts",
-        "create": "tsx bin/cli.ts create",
-        "build": "esbuild bin/cli.ts --bundle --platform=node --outfile=bin/cli.js --format=cjs --external:fs-extra --external:inquirer --external:chalk --external:commander --external:ora --external:path --external:fs",
-        "prepublish": "pnpm build",
-        "postbuild": "node scripts/fix-templates-path.js"
-    },
-    "keywords": [
-        "uniapp",
-        "scaffold",
-        "weixin",
-        "toutiao",
-        "miniprogram"
-    ],
-    "author": "hlw2326",
-    "license": "MIT",
-    "dependencies": {
-        "chalk": "^4.1.2",
-        "commander": "^11.1.0",
-        "fs-extra": "^11.2.0",
-        "inquirer": "^8.2.7",
-        "ora": "^5.4.1"
-    },
-    "devDependencies": {
-        "@types/fs-extra": "^11.0.4",
-        "@types/node": "^20.11.0",
-        "esbuild": "^0.28.0",
-        "tsx": "^4.19.0"
-    }
-}
+  "name": "@hlw-uni/mp-cli",
+  "version": "1.0.15",
+  "description": "uniapp 小程序脚手架生成器",
+  "main": "bin/cli.js",
+  "bin": {
+    "hlw-uni-mp": "./bin/cli.js"
+  },
+  "keywords": [
+    "uniapp",
+    "scaffold",
+    "weixin",
+    "toutiao",
+    "miniprogram"
+  ],
+  "author": "hlw2326",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^8.2.7",
+    "ora": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.11.0",
+    "esbuild": "^0.28.0",
+    "tsx": "^4.19.0"
+  },
+  "scripts": {
+    "dev": "tsx bin/cli.ts",
+    "create": "tsx bin/cli.ts create",
+    "build": "esbuild bin/cli.ts --bundle --platform=node --outfile=bin/cli.js --format=cjs --external:fs-extra --external:inquirer --external:chalk --external:commander --external:ora --external:path --external:fs",
+    "prepublish": "pnpm build",
+    "postbuild": "node scripts/fix-templates-path.js"
+  }
+}

package/templates/mp-toutiao/base/.env.dev

@@ -1 +1,3 @@
 VITE_API_BASE_URL=http://localhost:3000/api
+VITE_SIG_SECRET=your-secret-key-here
+VITE_PLUGIN_NAME=plugin-qz

package/templates/mp-toutiao/base/.env.prod

@@ -1 +1,3 @@
 VITE_API_BASE_URL=https://api.example.com/api
+VITE_SIG_SECRET=your-production-secret-key-here
+VITE_PLUGIN_NAME=plugin-qz

package/templates/mp-toutiao/base/package.json

@@ -12,6 +12,7 @@
     "@dcloudio/uni-components": "3.0.0-4080420251103001",
     "@dcloudio/uni-mp-toutiao": "3.0.0-4080420251103001",
     "@hlw-uni/mp-core": "workspace:*",
+    "@hlw-uni/mp-vue": "^1.0.0",
     "@vueuse/core": "^10.9.0",
     "pinia": "^2.1.7",
     "pinia-plugin-unistorage": "^1.2.3",

package/templates/mp-toutiao/base/src/api/ad.ts

@@ -0,0 +1,31 @@
+/**
+ * 广告配置接口
+ * 控制器：Ad (extends Base，无需登录)
+ */
+import { http } from "@hlw-uni/mp-core";
+import { v1 } from "./config";
+
+/** 广告单元 */
+export interface AdUnit {
+    id: number;
+    name: string;
+    unit_id: string;
+    ad_type: string;
+    position: string;
+}
+
+/** 广告配置响应 */
+export interface AdConfigResult {
+    list: AdUnit[];
+    map: Record<string, AdUnit>;
+}
+
+/**
+ * 获取广告配置
+ */
+export function getAdConfig() {
+    return http.request<AdConfigResult>({
+        url: v1("ad/config"),
+        method: "GET",
+    });
+}

package/templates/mp-toutiao/base/src/api/config.ts

@@ -0,0 +1,46 @@
+/**
+ * API 配置中心
+ *
+ * 后端 ThinkAdmin 插件路由规则：
+ *   /{plugin}/api.v{version}.{controller}/{method}
+ *
+ * 使用方式：
+ *   api("ad/config")           // => "/plugin-qz/api.v1.ad/config"  （默认版本）
+ *   api("ad/config", "v2")     // => "/plugin-qz/api.v2.ad/config"  （指定版本）
+ *   v1("ad/config")            // => "/plugin-qz/api.v1.ad/config"  （语法糖）
+ *   v2("ad/config")            // => "/plugin-qz/api.v2.ad/config"  （语法糖）
+ */
+
+/** 插件名称（从 .env 读取） */
+export const PLUGIN_NAME = import.meta.env.VITE_PLUGIN_NAME;
+if (!PLUGIN_NAME) throw new Error("[api] 请在 .env 中配置 VITE_PLUGIN_NAME");
+
+/** 默认 API 版本 */
+export const API_VERSION = "v1";
+
+/**
+ * 构建 API 请求路径
+ *
+ * @param path    "controller/method" 格式，如 "ad/config"、"feedback/my"
+ * @param version 可选版本号，默认使用 API_VERSION
+ *
+ * @example
+ * api("ad/config")          // => "/plugin-qz/api.v1.ad/config"
+ * api("help/list")          // => "/plugin-qz/api.v1.help/list"
+ * api("help/list", "v2")    // => "/plugin-qz/api.v2.help/list"
+ */
+export function api(path: string, version: string = API_VERSION): string {
+    const i = path.indexOf("/");
+    if (i === -1) throw new Error(`[api] path 格式错误，需含 "/": "${path}"`);
+    return `/${PLUGIN_NAME}/api.${version}.${path.slice(0, i)}/${path.slice(i + 1)}`;
+}
+
+/**
+ * 语法糖：固定版本的路径构建器
+ *
+ * @example
+ * v1("ad/config")   // => "/plugin-qz/api.v1.ad/config"
+ * v2("help/list")   // => "/plugin-qz/api.v2.help/list"
+ */
+export const v1 = (path: string) => api(path, "v1");
+export const v2 = (path: string) => api(path, "v2");

package/templates/mp-toutiao/base/src/api/feedback.ts

@@ -0,0 +1,120 @@
+/**
+ * 反馈建议接口
+ * 控制器：Feedback (extends Auth，需要登录)
+ */
+import { http } from "@hlw-uni/mp-core";
+import { v1 } from "./config";
+
+/** 反馈类型 */
+export interface FeedbackType {
+    id: number;
+    name: string;
+    code: string;
+    sort: number;
+    status: number;
+}
+
+/** 反馈项 */
+export interface FeedbackItem {
+    id: number;
+    user_id: string;
+    type: string;
+    type_name?: string;
+    content: string;
+    images: string[];
+    contact: string;
+    status: number;
+    status_label?: string;
+    create_at: string;
+}
+
+/** 反馈回复 */
+export interface FeedbackReply {
+    id: number;
+    feedback_id: number;
+    /** 0=用户 1=管理员 */
+    sender_type: number;
+    content: string;
+    create_at: string;
+}
+
+/** 反馈详情（含聊天记录） */
+export interface FeedbackDetail extends FeedbackItem {
+    replies: FeedbackReply[];
+}
+
+/** 反馈统计 */
+export interface FeedbackStats {
+    pending: number;
+    completed: number;
+    total: number;
+}
+
+/**
+ * 获取反馈类型列表
+ */
+export function getFeedbackTypes() {
+    return http.request<{ list: FeedbackType[] }>({
+        url: v1("feedback/types"),
+        method: "GET",
+    });
+}
+
+/**
+ * 提交反馈
+ */
+export function submitFeedback(data: {
+    type?: string;
+    content: string;
+    contact?: string;
+    images?: string[] | string;
+}) {
+    return http.request<{ id: number }>({
+        url: v1("feedback/submit"),
+        method: "POST",
+        data,
+    });
+}
+
+/**
+ * 获取我的反馈列表
+ */
+export function getMyFeedback(page = 1, limit = 20) {
+    return http.request<{ list: FeedbackItem[]; total: number; page: number; limit: number }>({
+        url: v1("feedback/my"),
+        method: "GET",
+        data: { page, limit },
+    });
+}
+
+/**
+ * 获取反馈详情（含聊天记录）
+ */
+export function getFeedbackDetail(id: number) {
+    return http.request<{ data: FeedbackDetail }>({
+        url: v1("feedback/detail"),
+        method: "GET",
+        data: { id },
+    });
+}
+
+/**
+ * 追加反馈内容
+ */
+export function appendFeedback(feedback_id: number, content: string) {
+    return http.request<{ time: string }>({
+        url: v1("feedback/append"),
+        method: "POST",
+        data: { feedback_id, content },
+    });
+}
+
+/**
+ * 获取反馈统计
+ */
+export function getFeedbackStats() {
+    return http.request<FeedbackStats>({
+        url: v1("feedback/stats"),
+        method: "GET",
+    });
+}

package/templates/mp-toutiao/base/src/api/help.ts

@@ -1,81 +1,60 @@
 /**
- * 帮助中心相关接口
+ * 帮助中心接口
+ * 控制器：Help (extends Base，无需登录)
  */
 import { http } from "@hlw-uni/mp-core";
-import type { PageResult } from "@hlw-uni/mp-core";
-
-/** 帮助文章 */
-export interface HelpArticle {
-    /** 文章 ID */
-    id: number;
-    /** 分类 ID */
-    category_id: number;
-    /** 标题 */
-    title: string;
-    /** 摘要 */
-    summary: string;
-    /** 正文（HTML） */
-    content: string;
-    /** 排序权重 */
-    sort: number;
-    /** 浏览量 */
-    views: number;
-    /** 创建时间 */
-    created_at: string;
-}
+import { v1 } from "./config";
 
 /** 帮助分类 */
 export interface HelpCategory {
-    /** 分类 ID */
     id: number;
-    /** 分类名称 */
     name: string;
-    /** 排序权重 */
     sort: number;
+    status: number;
 }
 
-/** 帮助列表查询参数 */
-export interface HelpListParams {
-    /** 页码 */
-    page?: number;
-    /** 每页条数 */
-    pageSize?: number;
-    /** 分类 ID */
-    category_id?: number;
-    /** 关键词搜索 */
-    keyword?: string;
+/** 帮助文章 */
+export interface HelpArticle {
+    id: number;
+    cate_id: number;
+    title: string;
+    content: string;
+    sort: number;
+    view_count: number;
+    status: number;
+    create_at: string;
 }
 
 /**
- * 获取帮助文章列表
- * @param params 分页 + 筛选参数
+ * 获取帮助分类列表
  */
-export function getHelpList(params?: HelpListParams) {
-    return http.request<PageResult<HelpArticle>>({
-        url: "/help/list",
+export function getHelpCates() {
+    return http.request<{ list: HelpCategory[] }>({
+        url: v1("help/cates"),
         method: "GET",
-        data: params,
     });
 }
 
 /**
- * 获取帮助文章详情
- * @param id 文章 ID
+ * 获取帮助文章列表
+ * @param cate_id 分类 ID（可选）
  */
-export function getHelpDetail(id: number) {
-    return http.request<HelpArticle>({
-        url: `/help/detail`,
+export function getHelpList(cate_id?: number) {
+    return http.request<{ list: HelpArticle[] }>({
+        url: v1("help/list"),
         method: "GET",
-        data: { id },
+        data: cate_id ? { cate_id } : undefined,
     });
 }
 
 /**
- * 获取帮助分类列表
+ * 获取帮助文章详情
+ * @param id 文章 ID
  */
-export function getHelpCategories() {
-    return http.request<HelpCategory[]>({
-        url: "/help/categories",
+export function getHelpDetail(id: number) {
+    return http.request<{ data: HelpArticle }>({
+        url: v1("help/detail"),
         method: "GET",
+        data: { id },
     });
 }

package/templates/mp-toutiao/base/src/api/index.ts

@@ -1,6 +1,14 @@
 /**
  * API 接口统一导出
+ *
+ * URL 规则：/{plugin}/api.v{version}.{controller}/{method}
+ * 配置：./config.ts
  */
-export * from "./auth";
+export { api, PLUGIN_NAME, API_VERSION } from "./config";
+export * from "./login";
 export * from "./user";
+export * from "./ad";
 export * from "./help";
+export * from "./tools";
+export * from "./notice";
+export * from "./feedback";

package/templates/mp-toutiao/base/src/api/login.ts

@@ -0,0 +1,45 @@
+/**
+ * 登录相关接口
+ * 控制器：Login (extends Base，无需登录)
+ */
+import { http } from "@hlw-uni/mp-core";
+import type { UserInfo } from "./user";
+import { v1 } from "./config";
+
+/** 登录响应数据 */
+export interface LoginResult {
+    token: string;
+    user: Pick<UserInfo, "uid" | "nickname" | "avatar_url" | "phone" | "score" | "vip_time">;
+}
+
+/**
+ * 小程序登录
+ * @param code wx.login 获取的 code
+ */
+export function login(code: string, nickname?: string, avatar_url?: string) {
+    return http.request<LoginResult>({
+        url: v1("login/in"),
+        method: "POST",
+        data: { code, nickname, avatar_url },
+    });
+}
+
+/**
+ * 封装微信登录流程：wx.login → 调用后端
+ */
+export function wxLogin(nickname?: string, avatar_url?: string) {
+    return new Promise<LoginResult>((resolve, reject) => {
+        uni.login({
+            provider: "toutiao",
+            success: async (loginRes) => {
+                try {
+                    const res = await login(loginRes.code, nickname, avatar_url);
+                    resolve(res.data);
+                } catch (e) {
+                    reject(e);
+                }
+            },
+            fail: (err) => reject(new Error(err.errMsg || "微信登录失败")),
+        });
+    });
+}

package/templates/mp-toutiao/base/src/api/notice.ts

@@ -0,0 +1,30 @@
+/**
+ * 通知公告接口
+ * 控制器：Notice (extends Base，无需登录)
+ */
+import { http } from "@hlw-uni/mp-core";
+import { v1 } from "./config";
+
+/** 通知公告 */
+export interface NoticeItem {
+    id: number;
+    appid: string;
+    title: string;
+    content: string;
+    type: string;
+    sort: number;
+    status: number;
+    create_at: string;
+}
+
+/**
+ * 获取通知列表
+ * @param type 通知类型（可选）
+ */
+export function getNoticeList(type?: string) {
+    return http.request<{ list: NoticeItem[] }>({
+        url: v1("notice/list"),
+        method: "GET",
+        data: type ? { type } : undefined,
+    });
+}

package/templates/mp-toutiao/base/src/api/tools.ts

@@ -0,0 +1,71 @@
+/**
+ * 工具箱接口
+ * 控制器：Tools (extends Base，无需登录)
+ */
+import { http } from "@hlw-uni/mp-core";
+import { v1 } from "./config";
+
+/** 工具分类 */
+export interface ToolsCategory {
+    id: number;
+    name: string;
+    sort: number;
+    status: number;
+}
+
+/** 工具项 */
+export interface ToolItem {
+    id: number;
+    cate_id: number;
+    name: string;
+    icon: string;
+    desc: string;
+    path: string;
+    sort: number;
+    click_count: number;
+    status: number;
+}
+
+/**
+ * 获取工具分类列表
+ */
+export function getToolsCates() {
+    return http.request<{ list: ToolsCategory[] }>({
+        url: v1("tools/cates"),
+        method: "GET",
+    });
+}
+
+/**
+ * 获取工具列表（按分类筛选）
+ * @param cate_id 分类 ID（可选）
+ */
+export function getToolsList(cate_id?: number) {
+    return http.request<{ list: ToolItem[] }>({
+        url: v1("tools/list"),
+        method: "GET",
+        data: cate_id ? { cate_id } : undefined,
+    });
+}
+
+/**
+ * 获取全部工具（不分类）
+ */
+export function getToolsAll() {
+    return http.request<{ list: ToolItem[] }>({
+        url: v1("tools/all"),
+        method: "GET",
+    });
+}
+
+/**
+ * 记录工具点击
+ * @param id 工具 ID
+ */
+export function recordToolClick(id: number) {
+    return http.request<null>({
+        url: v1("tools/click"),
+        method: "GET",
+        data: { id },
+    });
+}

package/templates/mp-toutiao/base/src/api/user.ts

@@ -1,49 +1,27 @@
 /**
  * 用户相关接口
+ * 控制器：User (extends Auth，需要登录)
  */
 import { http } from "@hlw-uni/mp-core";
-import type { UserInfo } from "@/stores/user";
+import { v1 } from "./config";
 
-/**
- * 获取当前用户信息
- */
-export function getUserInfo() {
-    return http.request<UserInfo>({
-        url: "/user/info",
-        method: "GET",
-    });
-}
-
-/** 更新用户信息参数 */
-export interface UpdateUserParams {
-    /** 昵称 */
-    nickname?: string;
-    /** 头像 URL */
-    avatar_url?: string;
-    /** 手机号 */
-    phone?: string;
+/** 后端返回的完整用户实体类型 */
+export interface UserInfo {
+    uid: string;
+    nickname: string;
+    avatar_url: string;
+    phone: string;
+    score: number;
+    vip_time: number;
 }
 
 /**
- * 更新用户信息
- * @param params 需要更新的字段
+ * 获取或刷新当前登录用户信息 (预留)
+ * GET plugin-qz/api.v1.user/info
  */
-export function updateUserInfo(params: UpdateUserParams) {
-    return http.request<UserInfo>({
-        url: "/user/update",
-        method: "POST",
-        data: params,
-    });
-}
-
-/**
- * 绑定手机号（微信小程序获取手机号后调用）
- * @param code 手机号授权 code
- */
-export function bindPhone(code: string) {
-    return http.request<UserInfo>({
-        url: "/user/bindPhone",
-        method: "POST",
-        data: { code },
+export function getUserInfo() {
+    return http.request<{ data: UserInfo }>({
+        url: v1("user/info"),
+        method: "GET",
     });
 }

package/templates/mp-toutiao/base/src/env.d.ts

@@ -5,6 +5,7 @@
 interface ImportMetaEnv {
     readonly VITE_API_BASE_URL: string;
     readonly VITE_SIG_SECRET: string;
+    readonly VITE_PLUGIN_NAME: string;
 }
 
 interface ImportMeta {

package/templates/mp-toutiao/base/src/pages.json

@@ -3,7 +3,7 @@
         "autoscan": true,
         "regular": {
             "^u-(.*)": "@/components/u-$1/u-$1.vue",
-            "^hlw-(.*)": "@hlw-uni-mp/core/components/$1.vue"
+            "^hlw-(.*)": "@hlw-uni/mp-vue/src/components/hlw-$1/index.vue"
         }
     },
     "pages": [