@giteeteam/apps-cli 1.0.1 → 1.1.1

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-"use strict";var fr=Object.create;var pe=Object.defineProperty;var dr=Object.getOwnPropertyDescriptor;var gr=Object.getOwnPropertyNames;var yr=Object.getPrototypeOf,hr=Object.prototype.hasOwnProperty;var vr=(e,t)=>()=>(e&&(t=e(e=0)),t);var wr=(e,t)=>{for(var r in t)pe(e,r,{get:t[r],enumerable:!0})},br=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of gr(t))!hr.call(e,o)&&o!==r&&pe(e,o,{get:()=>t[o],enumerable:!(n=dr(t,o))||n.enumerable});return e};var c=(e,t,r)=>(r=e!=null?fr(yr(e)):{},br(t||!e||!e.__esModule?pe(r,"default",{value:e,enumerable:!0}):r,e));var We={};wr(We,{default:()=>Sr});function Sr({environment:e,appKey:t,distOutputPath:r="dist"}){let n=e==="production",o=e==="development",s=Tr(),i=Ve.default.existsSync(R.default.resolve("locales")),a=D=>D?{filename:"js/[name].[chunkhash].min.js",path:R.default.resolve(r),publicPath:"./",library:{type:"umd",name:t},clean:!0}:{filename:"main.js",path:R.default.resolve(r),publicPath:"/",library:{type:"umd",name:t}},p=({resourcePath:D},U,w)=>w===t||/\.global\.(css|less)$/.test(D)||/node_modules/.test(D)?w:`${w}__${(0,He.default)(`${D}${w}`,{algorithm:"md5"}).slice(0,8)}`,m={loader:"@ecomfe/class-names-loader",options:{classNamesModule:require.resolve("classnames")}},l=n?L.rspack.CssExtractRspackPlugin.loader:"style-loader",u={loader:"postcss-loader",options:{postcssOptions:{plugins:[ze.default]}}},g={loader:"css-loader",options:{modules:{getLocalIdent:p},importLoaders:1}},v={loader:"less-loader",options:{lessOptions:{javascriptEnabled:!0,modifyVars:{"ant-prefix":t}}}};return{mode:e,entry:"./src/index.tsx",output:a(n),devtool:n?!1:"source-map",resolve:{alias:{"@":R.default.join(process.cwd(),"src/")},extensions:[".js",".ts",".jsx",".tsx",".css",".less"]},optimization:{minimize:n},plugins:[new L.rspack.DefinePlugin({"process.env":JSON.stringify(process.env),"process.env.appKey":JSON.stringify(t)}),new L.rspack.HtmlRspackPlugin({template:R.default.resolve("public/index.html"),filename:"index.html",inject:!0,appKey:t}),n&&new L.rspack.CssExtractRspackPlugin({filename:"[name].[contenthash].css",chunkFilename:"[name].[contenthash].chunk.css"}),o&&new L.rspack.HotModuleReplacementPlugin,o&&new qe.default({overlay:!1})].filter(Boolean),module:{rules:[{oneOf:[{test:/\.(js|mjs|jsx|ts|tsx)$/,exclude:/node_modules/,loader:"builtin:swc-loader",options:{sourceMaps:Or,jsc:{parser:{syntax:"typescript",tsx:!0},transform:{react:{runtime:"automatic",development:!n,refresh:!n}}},env:{targets:"chrome >= 72",mode:"usage",coreJs:"3.38"}},type:"javascript/auto"},s&&i&&{test:/locales/,loader:s,include:[R.default.resolve("locales")]},{test:/\.css$/,use:[m,l,"css-loader",u]},{test:/\.less$/,use:[m,l,g,u,v]},{test:/\.(png|jpg|gif)$/i,type:"asset",parser:{dataUrlCondition:{maxSize:2400}},generator:{filename:"[name]_[hash][ext]"}},{test:/\.svg$/i,use:["@svgr/webpack"]}]}]}}}var Ve,R,L,qe,ze,He,Or,Tr,Je=vr(()=>{"use strict";Ve=c(require("fs")),R=c(require("path")),L=require("@rspack/core"),qe=c(require("@rspack/plugin-react-refresh")),ze=c(require("autoprefixer")),He=c(require("hasha")),Or=process.env.GENERATE_SOURCEMAP==="true",Tr=()=>{try{return require.resolve("@alienfast/i18next-loader")}catch{return null}}});var ys=require("dotenv/config"),Te=c(require("chalk")),cr=require("commander");var E="1.0.1";var de=c(require("path"));var B=["manifest.yml","locales"],je=Buffer.from(process.env.ONE_AUTH_IV||"ABCDEFGHIJKLM_iv","utf-8"),_e=Buffer.from(process.env.ONE_AUTH_SECRET_KEY||"ABCDEFGHIJKL_key","utf-8"),Le=process.env.ONE_AUTH_ALGORITHM||"aes-128-cbc";var H=c(require("chalk")),at=c(require("fs-extra"));var Ie=c(require("fs")),me=c(require("path")),Me=c(require("@rollup/plugin-commonjs")),Fe=require("rollup");var _=require("fs"),b=require("path"),$e=require("esbuild"),Pr={treeShaking:!0,format:"esm",loader:"tsx"};var xr=({source:e,dirPath:t,mode:r})=>{let n="";if(r==="development")try{return n=require.resolve(e+"/src/index.ts",{paths:[t]}),n}catch{}try{return n=require.resolve(e,{paths:[t]}),n}catch{}return n};function le({mode:e,...t}){return t={...Pr,...t},{name:"esbuild",resolveId(r,n,o){if(!n)return r;let s=(0,b.dirname)(n),i;if((0,_.existsSync)(i=(0,b.resolve)(s,r,"index.ts")))return i;if((0,_.existsSync)(i=(0,b.resolve)(s,r,"index.tsx")))return i;if((0,_.existsSync)(i=(0,b.resolve)(s,r+".ts")))return i;if((0,_.existsSync)(i=(0,b.resolve)(s,r+".tsx")))return i;{let a=xr({source:r,dirPath:s,mode:e});if((0,_.existsSync)(a))return a;throw console.error({source:r,importer:n,options:o}),i=(0,b.relative)(".",(0,b.resolve)(n,r)),new Error(`ENOENT: ${i.replace(/\\/g,"/")}`)}},async transform(r,n){t.sourcefile=n,t.loader=n.endsWith(".json")?"json":t.loader;let{code:o,map:s}=await(0,$e.transform)(r,t);return s?{code:o,map:s}:o}}}function Er(e,t,r="development"){let n=[(0,Me.default)()];n.push(le({mode:r,sourcemap:r==="development",minify:r!=="development",target:"es2018",jsx:"transform",jsxFactory:"AppsUI.createElement",jsxFragment:"AppsUI.Fragment"}));let o={input:e,plugins:n},s={file:t,format:"es",sourcemap:r==="development"};return{inputOptions:o,outputOptions:s}}async function G(e){let{fileName:t,inputDir:r,outputDir:n,mode:o="development"}=e,s=me.default.join(r,`${t}.ts`);try{await Ie.default.promises.access(s)}catch{console.error(`${s} is not exist`);return}let i=me.default.join(n,`${t}.js`),{inputOptions:a,outputOptions:p}=Er(s,i,o);await(await(0,Fe.rollup)(a)).write(p)}var Ue=c(require("ora")),d=async(e,t)=>{var n,o;let r=(0,Ue.default)(e.start).start();try{let s=await t();return r.succeed(e.succeed),s}catch(s){throw r.fail(`${e.error}: ${((o=(n=s==null?void 0:s.response)==null?void 0:n.data)==null?void 0:o.message)||s.message}`),s}};var Ke=c(require("path")),Be=require("@giteeteam/apps-manifest"),Ge=c(require("fs-extra")),O=async()=>{let e=Ke.default.resolve("manifest.yml"),t=await Ge.default.readFile(e);return new Be.Manifest(t.toString())};var Ye=c(require("path")),Xe=require("@rspack/core");var V=async()=>(await Promise.resolve().then(()=>(Je(),We))).default;var Qe=e=>Object.prototype.toString.call(e)==="[object Object]",I=(e,t)=>{if(t===void 0)return e;if(Array.isArray(e)&&Array.isArray(t))return[...e,...t];if(Qe(e)&&Qe(t)){let r={...e};for(let[n,o]of Object.entries(t))r[n]=n in r?I(r[n],o):o;return r}return t};var Ze=async({appKey:e,rspackConfig:t})=>{let r=await V();return new Promise((n,o)=>{let s=r({environment:"production",appKey:e});if(t){let a=require(Ye.default.resolve(t));s=I(s,a)}(0,Xe.rspack)(s).run((a,p)=>{if(a)return console.error(a),o(a);if(console.info(p==null?void 0:p.toString()),p!=null&&p.hasErrors())return o(new Error("build-ui-error"));n()})})};var et=c(require("path")),tt=c(require("archiver")),ue=c(require("fs-extra")),rt=async(e,t)=>{let r=et.default.resolve(t);return await ue.default.remove(r),new Promise((n,o)=>{let s=ue.default.createWriteStream(r),i=(0,tt.default)("zip",{zlib:{level:9}});s.on("close",function(){n()}),i.on("warning",function(a){console.info(a),a.code==="ENOENT"||o(a)}),i.on("error",function(a){console.info(a),o(a)}),i.pipe(s),i.directory(e,!1),i.finalize()})};var nt=async e=>{let{manifest:t,mode:r,outputDir:n,inputDir:o}=e,i=t.getFunctionFiles().map(async a=>{await G({inputDir:o,fileName:a,outputDir:n,mode:r})});await Promise.all(i)};var z=c(require("path")),st=c(require("fs-extra"));var fe=c(require("path")),ot=c(require("fs-extra")),q=async(e,t)=>{for(let r of t)try{let n=fe.default.resolve(r),o=fe.default.join(e,r);await ot.default.copy(n,o)}catch(n){if(n.code==="ENOENT"&&r==="locales")continue;throw n}};var it=async({outputDir:e,manifest:t,filesToCopy:r})=>{let{resources:n}=t;if(n)for(let{key:o,path:s}of n){let i=z.default.resolve(z.default.join("./",s)),a=z.default.join(e,o);await st.default.copy(i,a)}await q(e,r)};var ct=async({outputDir:e,inputDir:t,prod:r,filesToCopy:n,zip:o,ui:s,rspackConfig:i})=>{let a=await O(),{version:p,key:m}=a.app;if(!m){console.error("manifest app key is required");return}if(!p){console.error("manifest app version is required");return}console.info(`App key: ${H.default.bold.green(m)}`),console.info(`App version: ${H.default.bold.green(p)} 
+"use strict";var fr=Object.create;var pe=Object.defineProperty;var dr=Object.getOwnPropertyDescriptor;var gr=Object.getOwnPropertyNames;var yr=Object.getPrototypeOf,hr=Object.prototype.hasOwnProperty;var vr=(e,t)=>()=>(e&&(t=e(e=0)),t);var wr=(e,t)=>{for(var r in t)pe(e,r,{get:t[r],enumerable:!0})},br=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of gr(t))!hr.call(e,o)&&o!==r&&pe(e,o,{get:()=>t[o],enumerable:!(n=dr(t,o))||n.enumerable});return e};var c=(e,t,r)=>(r=e!=null?fr(yr(e)):{},br(t||!e||!e.__esModule?pe(r,"default",{value:e,enumerable:!0}):r,e));var We={};wr(We,{default:()=>Sr});function Sr({environment:e,appKey:t,distOutputPath:r="dist"}){let n=e==="production",o=e==="development",s=Tr(),i=Ve.default.existsSync(R.default.resolve("locales")),a=D=>D?{filename:"js/[name].[chunkhash].min.js",path:R.default.resolve(r),publicPath:"./",library:{type:"umd",name:t},clean:!0}:{filename:"main.js",path:R.default.resolve(r),publicPath:"/",library:{type:"umd",name:t}},p=({resourcePath:D},U,w)=>w===t||/\.global\.(css|less)$/.test(D)||/node_modules/.test(D)?w:`${w}__${(0,He.default)(`${D}${w}`,{algorithm:"md5"}).slice(0,8)}`,m={loader:"@ecomfe/class-names-loader",options:{classNamesModule:require.resolve("classnames")}},l=n?L.rspack.CssExtractRspackPlugin.loader:"style-loader",u={loader:"postcss-loader",options:{postcssOptions:{plugins:[ze.default]}}},g={loader:"css-loader",options:{modules:{getLocalIdent:p},importLoaders:1}},v={loader:"less-loader",options:{lessOptions:{javascriptEnabled:!0,modifyVars:{"ant-prefix":t}}}};return{mode:e,entry:"./src/index.tsx",output:a(n),devtool:n?!1:"source-map",resolve:{alias:{"@":R.default.join(process.cwd(),"src/")},extensions:[".js",".ts",".jsx",".tsx",".css",".less"]},optimization:{minimize:n},plugins:[new L.rspack.DefinePlugin({"process.env":JSON.stringify(process.env),"process.env.appKey":JSON.stringify(t)}),new L.rspack.HtmlRspackPlugin({template:R.default.resolve("public/index.html"),filename:"index.html",inject:!0,appKey:t}),n&&new L.rspack.CssExtractRspackPlugin({filename:"[name].[contenthash].css",chunkFilename:"[name].[contenthash].chunk.css"}),o&&new L.rspack.HotModuleReplacementPlugin,o&&new qe.default({overlay:!1})].filter(Boolean),module:{rules:[{oneOf:[{test:/\.(js|mjs|jsx|ts|tsx)$/,exclude:/node_modules/,loader:"builtin:swc-loader",options:{sourceMaps:Or,jsc:{parser:{syntax:"typescript",tsx:!0},transform:{react:{runtime:"automatic",development:!n,refresh:!n}}},env:{targets:"chrome >= 72",mode:"usage",coreJs:"3.38"}},type:"javascript/auto"},s&&i&&{test:/locales/,loader:s,include:[R.default.resolve("locales")]},{test:/\.css$/,use:[m,l,"css-loader",u]},{test:/\.less$/,use:[m,l,g,u,v]},{test:/\.(png|jpg|gif)$/i,type:"asset",parser:{dataUrlCondition:{maxSize:2400}},generator:{filename:"[name]_[hash][ext]"}},{test:/\.svg$/i,use:["@svgr/webpack"]}]}]}}}var Ve,R,L,qe,ze,He,Or,Tr,Je=vr(()=>{"use strict";Ve=c(require("fs")),R=c(require("path")),L=require("@rspack/core"),qe=c(require("@rspack/plugin-react-refresh")),ze=c(require("autoprefixer")),He=c(require("hasha")),Or=process.env.GENERATE_SOURCEMAP==="true",Tr=()=>{try{return require.resolve("@alienfast/i18next-loader")}catch{return null}}});var ys=require("dotenv/config"),Te=c(require("chalk")),cr=require("commander");var E="1.1.1";var de=c(require("path"));var B=["manifest.yml","locales"],je=Buffer.from(process.env.ONE_AUTH_IV||"ABCDEFGHIJKLM_iv","utf-8"),_e=Buffer.from(process.env.ONE_AUTH_SECRET_KEY||"ABCDEFGHIJKL_key","utf-8"),Le=process.env.ONE_AUTH_ALGORITHM||"aes-128-cbc";var H=c(require("chalk")),at=c(require("fs-extra"));var Ie=c(require("fs")),me=c(require("path")),Me=c(require("@rollup/plugin-commonjs")),Fe=require("rollup");var _=require("fs"),b=require("path"),$e=require("esbuild"),Pr={treeShaking:!0,format:"esm",loader:"tsx"};var xr=({source:e,dirPath:t,mode:r})=>{let n="";if(r==="development")try{return n=require.resolve(e+"/src/index.ts",{paths:[t]}),n}catch{}try{return n=require.resolve(e,{paths:[t]}),n}catch{}return n};function le({mode:e,...t}){return t={...Pr,...t},{name:"esbuild",resolveId(r,n,o){if(!n)return r;let s=(0,b.dirname)(n),i;if((0,_.existsSync)(i=(0,b.resolve)(s,r,"index.ts")))return i;if((0,_.existsSync)(i=(0,b.resolve)(s,r,"index.tsx")))return i;if((0,_.existsSync)(i=(0,b.resolve)(s,r+".ts")))return i;if((0,_.existsSync)(i=(0,b.resolve)(s,r+".tsx")))return i;{let a=xr({source:r,dirPath:s,mode:e});if((0,_.existsSync)(a))return a;throw console.error({source:r,importer:n,options:o}),i=(0,b.relative)(".",(0,b.resolve)(n,r)),new Error(`ENOENT: ${i.replace(/\\/g,"/")}`)}},async transform(r,n){t.sourcefile=n,t.loader=n.endsWith(".json")?"json":t.loader;let{code:o,map:s}=await(0,$e.transform)(r,t);return s?{code:o,map:s}:o}}}function Er(e,t,r="development"){let n=[(0,Me.default)()];n.push(le({mode:r,sourcemap:r==="development",minify:r!=="development",target:"es2018",jsx:"transform",jsxFactory:"AppsUI.createElement",jsxFragment:"AppsUI.Fragment"}));let o={input:e,plugins:n},s={file:t,format:"es",sourcemap:r==="development"};return{inputOptions:o,outputOptions:s}}async function G(e){let{fileName:t,inputDir:r,outputDir:n,mode:o="development"}=e,s=me.default.join(r,`${t}.ts`);try{await Ie.default.promises.access(s)}catch{console.error(`${s} is not exist`);return}let i=me.default.join(n,`${t}.js`),{inputOptions:a,outputOptions:p}=Er(s,i,o);await(await(0,Fe.rollup)(a)).write(p)}var Ue=c(require("ora")),d=async(e,t)=>{var n,o;let r=(0,Ue.default)(e.start).start();try{let s=await t();return r.succeed(e.succeed),s}catch(s){throw r.fail(`${e.error}: ${((o=(n=s==null?void 0:s.response)==null?void 0:n.data)==null?void 0:o.message)||s.message}`),s}};var Ke=c(require("path")),Be=require("@giteeteam/apps-manifest"),Ge=c(require("fs-extra")),O=async()=>{let e=Ke.default.resolve("manifest.yml"),t=await Ge.default.readFile(e);return new Be.Manifest(t.toString())};var Ye=c(require("path")),Xe=require("@rspack/core");var V=async()=>(await Promise.resolve().then(()=>(Je(),We))).default;var Qe=e=>Object.prototype.toString.call(e)==="[object Object]",I=(e,t)=>{if(t===void 0)return e;if(Array.isArray(e)&&Array.isArray(t))return[...e,...t];if(Qe(e)&&Qe(t)){let r={...e};for(let[n,o]of Object.entries(t))r[n]=n in r?I(r[n],o):o;return r}return t};var Ze=async({appKey:e,rspackConfig:t})=>{let r=await V();return new Promise((n,o)=>{let s=r({environment:"production",appKey:e});if(t){let a=require(Ye.default.resolve(t));s=I(s,a)}(0,Xe.rspack)(s).run((a,p)=>{if(a)return console.error(a),o(a);if(console.info(p==null?void 0:p.toString()),p!=null&&p.hasErrors())return o(new Error("build-ui-error"));n()})})};var et=c(require("path")),tt=c(require("archiver")),ue=c(require("fs-extra")),rt=async(e,t)=>{let r=et.default.resolve(t);return await ue.default.remove(r),new Promise((n,o)=>{let s=ue.default.createWriteStream(r),i=(0,tt.default)("zip",{zlib:{level:9}});s.on("close",function(){n()}),i.on("warning",function(a){console.info(a),a.code==="ENOENT"||o(a)}),i.on("error",function(a){console.info(a),o(a)}),i.pipe(s),i.directory(e,!1),i.finalize()})};var nt=async e=>{let{manifest:t,mode:r,outputDir:n,inputDir:o}=e,i=t.getFunctionFiles().map(async a=>{await G({inputDir:o,fileName:a,outputDir:n,mode:r})});await Promise.all(i)};var z=c(require("path")),st=c(require("fs-extra"));var fe=c(require("path")),ot=c(require("fs-extra")),q=async(e,t)=>{for(let r of t)try{let n=fe.default.resolve(r),o=fe.default.join(e,r);await ot.default.copy(n,o)}catch(n){if(n.code==="ENOENT"&&r==="locales")continue;throw n}};var it=async({outputDir:e,manifest:t,filesToCopy:r})=>{let{resources:n}=t;if(n)for(let{key:o,path:s}of n){let i=z.default.resolve(z.default.join("./",s)),a=z.default.join(e,o);await st.default.copy(i,a)}await q(e,r)};var ct=async({outputDir:e,inputDir:t,prod:r,filesToCopy:n,zip:o,ui:s,rspackConfig:i})=>{let a=await O(),{version:p,key:m}=a.app;if(!m){console.error("manifest app key is required");return}if(!p){console.error("manifest app version is required");return}console.info(`App key: ${H.default.bold.green(m)}`),console.info(`App version: ${H.default.bold.green(p)} 
 `);let{pass:l,errors:u}=a.validate();if(!l){if(u!=null&&u.length){let{message:g,path:v}=u[0];console.error(`Manifest valid error: Path '${v}', ${g}`)}else console.error("Manifest valid error");return}if(await at.default.emptyDir(e),s&&await d({start:"start build ui",error:"build ui failed",succeed:"build ui success"},()=>Ze({appKey:m,rspackConfig:i})),await d({start:"start bundle",error:"bundle failed",succeed:"bundle success"},()=>nt({outputDir:e,inputDir:t,manifest:a,mode:r?"production":"development"})),await d({start:"start package",error:"package failed",succeed:"package success"},()=>it({outputDir:e,manifest:a,filesToCopy:n})),o){let g=`${m}_${p}.zip`;await d({start:"start archive",error:"archive failed",succeed:"archive success"},()=>rt(e,g)),console.info(`
 The output file of the build is ${H.default.bold.green(g)}`)}};var pt=async e=>{let{input:t="functions",output:r="package",prod:n,dev:o,copy:s=[],zip:i,ui:a,rspack:p}=e;await ct({outputDir:de.default.resolve(r),inputDir:de.default.resolve(t),prod:n??!o,filesToCopy:[...B,...s],zip:i,ui:!!a,rspackConfig:p}).catch(()=>{})};var bt=c(require("fs")),kt=c(require("path")),J=c(require("chalk"));var lt=c(require("path")),mt=c(require("lowdb")),ut=c(require("lowdb/adapters/FileSync"));var ge,ye=()=>{if(!ge){let e=lt.default.join(__dirname,"user.json"),t=new ut.default(e);ge=(0,mt.default)(t)}return ge},ft=()=>{let e=ye(),t=e.get("version").value();(!t||t!==E)&&e.defaults({version:E,user:{}}).write()},he=e=>{ft(),ye().set("user",e).write()},T=()=>(ft(),ye().get("user").value());var gt=c(require("fs")),yt=c(require("path")),ht=c(require("form-data"));var dt=c(require("axios"));var k={GET:"GET",POST:"POST",PUT:"PUT",DELETE:"DELETE"},S=async({url:e,method:t,data:r,headers:n})=>{let{domain:o,cookie:s}=T();return(await(0,dt.default)({method:t,baseURL:o,url:e,data:r,headers:{...n,cookie:s}})).data};var vt=async(e,t)=>{let r=new ht.default;return r.append("environmentKey",t),r.append("package",gt.default.createReadStream(yt.default.resolve(e))),S({method:k.POST,url:"/apps/api/v1/apps/deploy",data:r,headers:{...r.getHeaders()}})},W=async({tenants:e,environmentKey:t,appKey:r,versionKey:n})=>S({method:k.POST,url:"/apps/api/v1/apps/install/batch",data:{tenants:e,environmentKey:t,appKey:r,versionKey:n,subscriptionSource:"manual"}});var wt=c(require("chalk")),Dr=wt.default.bold.red,f={error:e=>{console.info(Dr(e))}};var Q=(n=>(n.DEVELOPMENT="development",n.STAGING="staging",n.PRODUCTION="production",n))(Q||{}),Cr=e=>e?(Array.isArray(e)?e:[e]).flatMap(r=>r.split(",")).map(r=>r.trim()).filter(Boolean):[],Rr=e=>{let t=kt.default.basename(e,".zip"),r=t.lastIndexOf("_");return r<=0||r===t.length-1?null:{appKey:t.slice(0,r),versionKey:t.slice(r+1)}},Pt=async(e,t)=>{let{domain:r}=T(),{environment:n="development",subscribe:o,appKey:s,versionKey:i}=t,a=Cr(o);if(!Object.values(Q).includes(n)){f.error("Only support development, staging, production environment.");return}if(!r){f.error("Please login in first!");return}if(!bt.default.existsSync(e)){f.error(`File:${e} is not exist`);return}if(console.info(`Deploying to ${J.default.bold.green(r)}`),await d({start:"start deploy",error:"deploy failed",succeed:"deploy success"},()=>vt(e,n)).catch(()=>{}),a.length===0)return;let p=Rr(e),m=s||(p==null?void 0:p.appKey),l=i||(p==null?void 0:p.versionKey);if(!m||!l){f.error("subscribe needs appKey and versionKey. please pass --app-key and --version-key, or use zip name <appKey>_<versionKey>.zip");return}console.info(`Subscribing app ${J.default.bold.green(m)}:${J.default.bold.green(l)}`),await d({start:"start subscribe",error:"subscribe failed",succeed:"subscribe success"},()=>W({tenants:a,environmentKey:n,appKey:m,versionKey:l})).catch(()=>{})};var N=c(require("path")),M=c(require("fs-extra")),ke=c(require("inquirer"));var xt=c(require("readline")),Et=require("chalk"),Ot=c(require("execa")),Ar=e=>{if(!Et.supportsColor){e.write("\r");return}xt.default.cursorTo(e,0)},jr=(e,t)=>{let r=Math.min(Math.max(e/t,0),1),n=` ${e}/${t}`,o=Math.max(0,process.stderr.columns-n.length-3),s=Math.min(t,o),i=Math.round(s*r),a="#".repeat(i),p="-".repeat(s-i);Ar(process.stderr),process.stderr.write(`[${a}${p}]${n}`)},_r=(e,t,r,n)=>new Promise((o,s)=>{var a;let i=(0,Ot.default)(e,t,{cwd:r,stdio:["inherit","inherit","pipe"],env:n});(a=i.stderr)==null||a.on("data",p=>{let m=p.toString();if(/warning/.test(m))return;let l=m.match(/\[.*] (\d+)\/(\d+)/);if(l){jr(parseFloat(l[1]),parseFloat(l[2]));return}process.stderr.write(p)}),i.on("close",p=>{if(p!==0){s(new Error(`command failed: ${e} ${t.join(" ")}`));return}o()})}),Tt={executeCommand:_r};var ve=c(require("fs-extra")),we=c(require("simple-git")),St=async e=>{await(0,we.default)(e).init()},Y=async(e,t,r)=>{await ve.default.pathExists(t)||await ve.default.mkdir(t);let n=(0,we.default)(t),o=[];r!=null&&r.branch&&o.push("--branch",r.branch),r!=null&&r.singleBranch&&o.push("--single-branch"),await n.clone(e,t,o)};var P=c(require("path")),A=c(require("fs-extra"));var X=c(require("fs-extra")),Dt=process.env.APPS_TEMPLATE_REPO||"https://github.com/moriahq/apps-template.git",be=(r=>(r.micro="micro",r.uikit="uikit",r))(be||{}),Z=async(e,t)=>{if(!await X.default.pathExists(e))return;let r=await X.default.readFile(e,{encoding:"utf-8"});await X.default.writeFile(e,r.replace(/{{(\w+)}}/g,(n,o)=>typeof t[o]=="string"?t[o]:n))};var $r=async()=>{let e=[P.default.resolve(__dirname,"templates/skill"),P.default.resolve(__dirname,"../templates/skill")];for(let t of e)if(await A.default.pathExists(t))return t;return""},Ct=async(e,t)=>{let r=await A.default.readdir(e,{withFileTypes:!0});return(await Promise.all(r.map(async o=>{let s=P.default.join(e,o.name);return o.isDirectory()?Ct(s,t):o.isFile()?[P.default.relative(t,s)]:[]}))).flat()},$=async(e,t)=>{let{appName:r,appKey:n,overwrite:o=!1}=t,s=await $r();if(!s||!await A.default.pathExists(s))throw new Error(`skill templates not found: ${s}`);let i=await Ct(s,s);for(let a of i){let p=P.default.join(s,a),m=a==="SKILL.md"||a.startsWith("skill/")?a:P.default.join("skill",a),l=P.default.join(e,m);!o&&await A.default.pathExists(l)||(await A.default.ensureDir(P.default.dirname(l)),await A.default.copy(p,l),l.endsWith(".md")&&await Z(l,{appName:r,appKey:n}))}};var Nr=async()=>(await ke.default.createPromptModule()({type:"input",name:"App Name",message:"Please enter an app name",validate:r=>!!r}))["App Name"],Ir=async()=>(await ke.default.createPromptModule()({type:"input",name:"App key",message:"Please enter a valid app key",validate:r=>/^[a-z][a-z0-9_]*$/.test(r)?!0:(console.info(""),console.info("only supports letters, numbers, underscores and starts with letters"),!1)}))["App key"],Mr=()=>{if(Number(E.split(".")[0])>=1)return"v1"},Fr=async(e,t)=>{let r=Mr();if(!r){await d({start:"Start clone repository",error:"Clone repository failed!",succeed:"Clone repository success!"},()=>Y(e,t));return}try{await d({start:`Start clone repository (branch: ${r})`,error:"Clone repository failed!",succeed:"Clone repository success!"},()=>Y(e,t,{branch:r,singleBranch:!0}))}catch{console.info(`Template branch '${r}' not found, fallback to default branch.`),await d({start:"Start clone repository (default branch)",error:"Clone repository failed!",succeed:"Clone repository success!"},()=>Y(e,t))}},Ur=async e=>{await d({start:"Start install dependencies",error:"Install dependencies failed!",succeed:"Install dependencies success!"},()=>Tt.executeCommand("pnpm",["install"],e))},Rt=async e=>{let{cwd:t}=e,r="micro",n=await Nr(),o=await Ir(),s=N.default.join(t,o);if(await M.default.pathExists(s)){console.error(`Project path already exists: ${s}`);return}await Fr(Dt,s),await M.default.copy(N.default.join(s,r),s),await Promise.all(Object.values(be).map(a=>M.default.remove(N.default.join(s,a)))),await M.default.remove(N.default.join(s,"./.git"));let i=["./manifest.yml","./package.json","./rspack.config.js","./public/index.html","./src/App.tsx","./src/index.tsx","./static/App.tsx","./static/index.tsx","./SKILL.md"];await Promise.all(i.map(a=>Z(N.default.join(s,a),{appName:n,appKey:o}))),await $(s,{appName:n,appKey:o}),await Ur(s),await St(s),console.info("Project init success!"),console.info("Project path:"+s)};var At=async()=>{let e=process.cwd();await Rt({cwd:e})};var ee=c(require("inquirer"));var Pe=c(require("axios"));var jt=["/api/gateway/login","/login"],Kr=e=>{var n;let t=(n=e==null?void 0:e.response)==null?void 0:n.status,r=e==null?void 0:e.code;return[404,405,502,503,504].includes(t)||["ECONNREFUSED","ENOTFOUND","ECONNABORTED"].includes(r)},_t=async({baseUrl:e,username:t,password:r})=>{var o;let n;for(let s of jt)try{let i=await(0,Pe.default)({method:k.POST,url:`${e}${s}`,data:{username:t,password:r}});return console.info(`Login endpoint: ${s}`),{cookie:(o=i.headers)==null?void 0:o["set-cookie"]}}catch(i){if(n=i,!Kr(i))return console.error(`Login error (${s}):`,i==null?void 0:i.message),{cookie:""}}return console.error(`Login error: all endpoints failed (${jt.join(", ")})`,(n==null?void 0:n.message)||""),{cookie:""}},Lt=async e=>{try{return await(0,Pe.default)({method:k.GET,url:`${e}/apps/api/v1/tenants`}),!1}catch{return!0}};var $t=e=>{try{return new URL(e).origin}catch{return e}};var Nt=c(require("crypto"));var It=e=>{try{let t=Nt.default.createCipheriv(Le,_e,je),r=t.update(e,"utf8","base64");return r+=t.final("base64"),r.toString()}catch(t){return console.error(`Encryption error: ${t}`),null}};var Br=async()=>(await ee.default.createPromptModule()({type:"input",name:"Domain",message:"Please enter the domain address",validate:r=>{try{return new URL(r),!0}catch{return"Please enter a valid domain name"}}})).Domain,Gr=async()=>(await ee.default.createPromptModule()({type:"input",name:"Username",message:"Please enter username",validate:r=>!!r})).Username,Vr=async()=>(await ee.default.createPromptModule()({type:"password",name:"Password",message:"Please enter password",validate:r=>!!r})).Password,Mt=async({domain:e,username:t,password:r})=>{if(e||(e=await Br()),e=$t(e),await Lt(e)){t||(t=await Gr()),r||(r=await Vr());let{cookie:o}=await _t({baseUrl:e,username:t,password:It(r)||r});o?(he({domain:e,username:t,cookie:o}),console.info("Login success!")):console.error("Login failed!")}else he({domain:e}),console.info("Login success!")};var Ft=async e=>{await Mt(e)};var Ut=c(require("chalk"));var qr=e=>e?(Array.isArray(e)?e:[e]).flatMap(r=>r.split(",")).map(r=>r.trim()).filter(Boolean):[],Kt=async(e,t,r)=>{let{domain:n}=T(),{environment:o="development",tenants:s}=r,i=qr(s);if(!n){f.error("Please login in first!");return}if(!Object.values(Q).includes(o)){f.error("Only support development, staging, production environment.");return}if(!e||!t){f.error("Please provide appKey and versionKey.");return}if(i.length===0){f.error("Please provide subscribe tenants by -t/--tenants.");return}console.info(`Subscribing to ${Ut.default.bold.green(n)}`),await d({start:"start subscribe",error:"subscribe failed",succeed:"subscribe success"},()=>W({tenants:i,environmentKey:o,appKey:e,versionKey:t})).catch(()=>{})};var te=c(require("path")),re=c(require("fs-extra"));var zr=async e=>{var a,p,m,l;let t=te.default.join(e,"manifest.yml"),r=te.default.basename(e),n=r;if(!await re.default.pathExists(t))return{appName:r,appKey:n};let o=await re.default.readFile(t,"utf8"),s=((p=(a=o.match(/^\s*name:\s*(.+)\s*$/m))==null?void 0:a[1])==null?void 0:p.trim())||r,i=((l=(m=o.match(/^\s*key:\s*(.+)\s*$/m))==null?void 0:m[1])==null?void 0:l.trim())||n;return{appName:s,appKey:i}},Bt=async e=>{let t=te.default.resolve(e||process.cwd());if(!await re.default.pathExists(t)){f.error(`project path not found: ${t}`);return}let{appName:r,appKey:n}=await zr(t);await $(t,{appName:r,appKey:n,overwrite:!0}),console.info("sync-skill finished."),console.info(`Project path: ${t}`)};var ie=c(require("path"));var tr=c(require("path")),se=c(require("chalk")),rr=c(require("debug")),Ee=c(require("fs-extra"));var Gt=async()=>{var t;return((t=(await S({method:k.GET,url:"/apps/api/v1/config"}).catch(r=>{var n,o;console.info(`getRuntimeConfig error ${((o=(n=r==null?void 0:r.response)==null?void 0:n.data)==null?void 0:o.message)||(r==null?void 0:r.message)}`)})).data)==null?void 0:t.runtime)||{}};var ne=require("child_process"),F=class{constructor(t,r){this.imageName=t,this.containerName=r}async downloadImage(){console.info(`Downloading image(${this.imageName}) ...`),await this.execPromise(`docker pull ${this.imageName}`),console.info(`Download image(${this.imageName}) success!`)}async runContainer({port:t,env:r,volume:n=[]}){await this.removeContainer();let o=Object.keys(r).filter(a=>r[a]!==void 0).map(a=>`-e ${a}=${r[a]}`).join(" "),s=n==null?void 0:n.map(a=>`-v ${a}`).join(" "),i=`docker run -d -p ${t}:${t} ${o} ${s} --name ${this.containerName} ${this.imageName}`;await this.execPromise(i)}async removeContainer(){await this.execPromise(`docker rm -f ${this.containerName}`).catch(()=>{})}logs(){let t=(0,ne.spawn)("docker",["logs","-f",this.containerName]);t.stdout.on("data",r=>{console.info(`${r}`)}),t.stderr.on("data",r=>{console.info(`${r}`)})}execPromise(t){return new Promise((r,n)=>{(0,ne.exec)(t,(o,s,i)=>{if(o)return n(o);r({stdout:s,stderr:i})})})}};var Vt=c(require("localtunnel"));var qt=async({appKey:e,runtimeHost:t,resources:r,resourcePort:n})=>{r!=null&&r.length&&r.forEach(o=>{o.path=`http://127.0.0.1:${n}`}),await S({method:k.POST,url:`/apps/api/v1/apps/tunnel/${e}`,data:{resources:r,runtimeHost:t}}).catch(o=>{var s,i;console.info(`addTunnel error ${((i=(s=o==null?void 0:o.response)==null?void 0:s.data)==null?void 0:i.message)||(o==null?void 0:o.message)}`)})},zt=async e=>{await S({method:"DELETE",url:`/apps/api/v1/apps/tunnel/${e}`}).catch(()=>{})},Ht=async e=>{var t,r;try{return(await(0,Vt.default)({port:e,host:((t=process.env)==null?void 0:t.TUNNEL_HOST)==="OFFICIAL"?void 0:((r=process.env)==null?void 0:r.TUNNEL_HOST)||"http://tunnel.gitee.work:1777"})).url}catch(n){return console.info("runTunnel error",n==null?void 0:n.message),""}};var xe=c(require("path")),Wt=require("@rspack/core"),Jt=require("@rspack/dev-middleware"),Qt=c(require("cors")),Yt=c(require("express"));var oe=async({appKey:e,rspackConfig:t})=>{let n=(await V())({environment:"development",appKey:e});if(t){let p=require(xe.default.resolve(t));n=I(n,p)}let o=(0,Wt.rspack)(n),s=(0,Yt.default)(),i=Number(process.env.UI_PORT)||8e3,a=(0,Jt.devMiddleware)(o);s.use((0,Qt.default)()),s.use(a),s.get("*",(p,m)=>{var l,u;(u=o.outputFileSystem)==null||u.readFile(xe.default.join(((l=n.output)==null?void 0:l.path)||"","index.html"),(g,v)=>{if(g||!v){m.sendStatus(404);return}m.send(v.toString())})}),s.listen(i,"0.0.0.0",()=>{console.info(`The React app is listening on port ${i}!
 `)})};var Zt=c(require("chokidar"));var Xt=(e,t,r)=>{for(let n of e)G({inputDir:t,outputDir:r,fileName:n,mode:"development"})},er=async e=>{let{inputDir:t,outputDir:r,watchFilePaths:n}=e,s=(await O()).getFunctionFiles();Xt(s,t,r);let i,a=[t,...n],p=Zt.default.watch(a);console.info(`watch: ${a.join(", ")}`),p.on("change",m=>{clearTimeout(i),i=setTimeout(()=>{console.info(`${m} has change`),Xt(s,t,r)},1e3)})};var Hr=(0,rr.default)("cli:tunnel"),Wr=async()=>{let e=await Gt(),t=process.env.RUNTIME_IMAGE||e.image||"docker-hub.gitee.work/gitee-prod/proxima-apps-runtime-server:4.4.0-alpha-86",r=Number(process.env.CONTAINER_PORT)||8455,n=process.env.CONTAINER_NAME||"cli-dev-apps-runtime-server",o=process.env.PULL_IMAGE!=="false",s={PORT:r,APPS_DIR:"/usr/src/app/apps",LRU_TTL:1,FS_MODE:"local",DEBUG:process.env.DEBUG||"runtime*",LOG_LEVEL:process.env.LOG_LEVEL,APPS_DEFAULT_LOCALE:process.env.APPS_DEFAULT_LOCALE||"zh-CN",PARSE_PUBLIC_SERVER_URL:process.env.PARSE_PUBLIC_SERVER_URL||e.parsePublicServerUrl,PARSE_SERVER_MASTER_KEY:process.env.PARSE_SERVER_MASTER_KEY||e.parseServerMasterKey,PROXIMA_CORE_URL:process.env.PROXIMA_CORE_URL||e.proximaCoreUrl,APPS_SERVER_URL:process.env.APPS_SERVER_URL||e.appsServerUrl,APPS_PARSE_SERVER_URL:process.env.APPS_PARSE_SERVER_URL||e.appsParseServerUrl,PGSQL_CLIENT_HOST:process.env.PGSQL_CLIENT_HOST,PGSQL_CLIENT_PORT:process.env.PGSQL_CLIENT_PORT,PGSQL_CLIENT_USER:process.env.PGSQL_CLIENT_USER,PGSQL_CLIENT_PASSWORD:process.env.PGSQL_CLIENT_PASSWORD,APPS_RUNTIME_IOREDIS_OPTIONS:process.env.APPS_RUNTIME_IOREDIS_OPTIONS?`'${process.env.APPS_RUNTIME_IOREDIS_OPTIONS}'`:void 0};return{runtimeImage:t,containerPort:r,containerName:n,containerEnv:s,pullImage:o}},nr=async e=>{var Ce,Re,Ae;let{inputDir:t,outputDir:r,server:n,filesToCopy:o,resourcePort:s,ui:i,rspackConfig:a,noProxy:p,watchFilePaths:m=[]}=e;await Ee.default.emptyDir(r);let l=await O(),u=l.app.key,g=l.app.version,v=l.getFunctionFiles(),D=l.resources||[];if(!u){f.error("appKey is required!");return}if(!g){f.error("version is required!");return}console.info(`App key: ${se.default.bold.green(u)}`),console.info(`App version: ${se.default.bold.green(g)} 

package/dist/templates/skill/guides/01-overview.md

@@ -14,6 +14,7 @@
 - 前端：`React + React Router + Ant Design`
 - 后端：`trigger/*.ts` 与 `functions/*.ts` 按 manifest 声明
 - 构建：`giteeteam-apps` + `rspack`（通过 `rspack.config.js` 扩展）
+- 发布：有代码改动并准备发布时，先递增 `manifest.app.version`
 
 ## 标准执行流程
 

package/dist/templates/skill/guides/02-extension-points.md

@@ -23,9 +23,53 @@
 6. 修改模块定义后，优先执行构建并检查 manifest 校验报错。
 7. 对已发布应用，禁止直接修改已有字段类型；使用新增字段 + 数据迁移方式演进。
 
+## invoke 关键约束（Micro）
+
+1. `Micro` 前端使用 `invoke` 时，SDK 会读取 `module.resolver.function` 来定位后端函数 key。
+2. 因此页面模块必须写成：
+
+```yaml
+resolver:
+  function: <resolver-function-key>
+```
+
+3. 如果只写顶层 `function: xxx`（未配置 `resolver`），常见报错：
+   `Cannot read properties of undefined (reading 'function')`。
+
 ## 常见自检
 
 1. 页面模块是否有对应资源声明。
 2. resolver 的 function key 与 `modules.function` 是否一致。
 3. trigger/webtrigger 的入参与返回结构是否和调用方约定一致。
 4. 表结构是否包含查询高频字段的索引。
+5. 若 `invoke` 报 `reading 'function'`，优先检查当前页面模块是否配置了 `resolver.function`。
+
+## item 接入点弹层挂载（共性问题）
+
+`itemPanel` 场景中，`Select/DatePicker/Cascader` 等弹层组件经常被父容器裁剪，表现为下拉显示不全或被遮挡。  
+这是弹层挂载容器与 item 详情容器层级不一致导致的共性问题。
+
+建议在弹窗或表单内显式指定 `getPopupContainer`，挂载到当前弹窗内的独立 DOM 节点，而不是依赖默认挂载：
+
+```tsx
+const popupRef = useRef<HTMLDivElement | null>(null);
+const getPopupContainer = useCallback(() => popupRef.current || document.body, []);
+
+<Modal
+  open={open}
+  modalRender={node => (
+    <div>
+      {node}
+      <div ref={popupRef} />
+    </div>
+  )}
+>
+  <Select getPopupContainer={getPopupContainer} />
+</Modal>
+```
+
+自检顺序建议：
+
+1. 先确认数据是否已正确拉取（排除“无数据”误判为“下拉显示不全”）。
+2. 再确认弹层是否挂在当前 `itemPanel` 可视容器内。
+3. 若仍异常，检查父容器是否存在 `overflow: hidden`、`transform`、`z-index` 冲突。

package/dist/templates/skill/guides/03-api-routing-rules.md

@@ -54,6 +54,12 @@ export const isInOne = (gateway: string): boolean => {
 };
 ```
 
+示例输入：
+
+- `https://osc.gitee.work/api/team` => `true`（集成环境）
+- `https://osc.gitee.work` => `false`（开发环境）
+- `''` 或非法 URL => `false`
+
 ## 统一约束
 
 1. 不要在前端直接请求裸 `/forge/*`。

package/dist/templates/skill/guides/04-deploy-and-subscribe.md

@@ -10,6 +10,14 @@ giteeteam-apps login --domain http://<host> -u <username> -p <password>
 
 ## 1) 构建产物
 
+先更新版本号（必须）：
+
+```yaml
+# manifest.yml
+app:
+  version: '<new-version>'
+```
+
 ```bash
 giteeteam-apps build --prod
 ```
@@ -22,6 +30,26 @@ giteeteam-apps deploy <zip-file> -e production
 
 常见环境值：`development`、`staging`、`production`（默认 `development`）。
 
+在当前仓库建议使用显式命令（避免 `package.json` 中未传文件名导致失败）：
+
+```bash
+pnpm exec giteeteam-apps deploy <appKey>_<versionKey>.zip -e development
+```
+
+如果发布/订阅请求失败，可按以下顺序重试：
+
+1. 先正常执行命令。
+2. 失败后使用提权执行（允许无沙箱网络）。
+3. 提权后仍失败，再补全 `NO_PROXY/no_proxy` 重试。
+
+`NO_PROXY/no_proxy` 示例：
+
+```bash
+NO_PROXY=localhost,127.0.0.1,<domain>,<target-host> \
+no_proxy=localhost,127.0.0.1,<domain>,<target-host> \
+pnpm exec giteeteam-apps deploy <zip-file> -e <environment>
+```
+
 ## 3) 订阅到租户
 
 方式 A：独立订阅
@@ -42,6 +70,8 @@ giteeteam-apps deploy <zip-file> -e production --subscribe osc --app-key <appKey
 2. `-t/--tenants` 与 `--subscribe` 支持逗号分隔，例如 `osc,test`。
 3. 若 zip 命名为 `<appKey>_<versionKey>.zip`，`deploy --subscribe` 可省略 `--app-key/--version-key`。
 4. 发布订阅流程不需要再手动调用 `curl`。
+5. 有代码改动并准备发布时，必须递增 `manifest.yml` 中的 `app.version`。
+6. 默认重试顺序：正常请求 -> 提权请求 -> 提权 + `NO_PROXY/no_proxy`。
 
 ## 故障排查
 

package/dist/templates/skill/guides/05-agent-prompt-template.md

@@ -20,7 +20,10 @@
 - 默认采用 `manifest.tables + getParseQuery/getParseObject`；`storage.entities` 仅用于 Storage API
 - 已发布应用禁止直接修改已有字段类型；只能新增字段并给出迁移方案
 - `manifest.yml` 定义完整且可校验
+- Micro 页面若使用 `invoke`，对应模块必须配置 `resolver.function`（不能只写顶层 `function`）
+- 需要发布时必须递增 `manifest.app.version`
 - trigger 与 webtrigger 的 function 声明完整
+- 发布/订阅失败时按顺序处理：先正常请求，再提权，最后提权 + `NO_PROXY/no_proxy`
 
 输出要求：
 - 列出修改文件

package/dist/templates/skill/guides/06-data-access-and-tables.md

@@ -23,6 +23,7 @@
 2. 应用发布后，不直接修改已有字段 `type`。
 3. 字段演进采用“新增字段 + 数据迁移 + 切换读写”。
 4. 变更说明必须包含迁移方案、回滚方案和影响范围。
+5. Team 应用中心没有“洗表/重建历史数据”的能力，改类型会带来兼容风险和历史数据不可用风险。
 
 ## 表定义建议（资源负载场景）
 
@@ -56,3 +57,4 @@
 2. 未声明 `manifest.tables` 就访问插件表，导致运行期风险。
 3. 发布时 `deploy` 未传 zip 文件名导致命令失败。
 4. 部署返回 `503` 或 `socket hang up` 时，优先排查环境状态，不要先改表结构。
+5. 环境不可用时至少完成两项本地验证：构建通过 + lint 通过，确保 manifest 与代码链路可构建。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giteeteam/apps-cli",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "Giteeteam Apps cli",
   "keywords": [
     "typescript",

package/templates/skill/guides/01-overview.md

@@ -14,6 +14,7 @@
 - 前端：`React + React Router + Ant Design`
 - 后端：`trigger/*.ts` 与 `functions/*.ts` 按 manifest 声明
 - 构建：`giteeteam-apps` + `rspack`（通过 `rspack.config.js` 扩展）
+- 发布：有代码改动并准备发布时，先递增 `manifest.app.version`
 
 ## 标准执行流程
 

package/templates/skill/guides/02-extension-points.md

@@ -23,9 +23,53 @@
 6. 修改模块定义后，优先执行构建并检查 manifest 校验报错。
 7. 对已发布应用，禁止直接修改已有字段类型；使用新增字段 + 数据迁移方式演进。
 
+## invoke 关键约束（Micro）
+
+1. `Micro` 前端使用 `invoke` 时，SDK 会读取 `module.resolver.function` 来定位后端函数 key。
+2. 因此页面模块必须写成：
+
+```yaml
+resolver:
+  function: <resolver-function-key>
+```
+
+3. 如果只写顶层 `function: xxx`（未配置 `resolver`），常见报错：
+   `Cannot read properties of undefined (reading 'function')`。
+
 ## 常见自检
 
 1. 页面模块是否有对应资源声明。
 2. resolver 的 function key 与 `modules.function` 是否一致。
 3. trigger/webtrigger 的入参与返回结构是否和调用方约定一致。
 4. 表结构是否包含查询高频字段的索引。
+5. 若 `invoke` 报 `reading 'function'`，优先检查当前页面模块是否配置了 `resolver.function`。
+
+## item 接入点弹层挂载（共性问题）
+
+`itemPanel` 场景中，`Select/DatePicker/Cascader` 等弹层组件经常被父容器裁剪，表现为下拉显示不全或被遮挡。  
+这是弹层挂载容器与 item 详情容器层级不一致导致的共性问题。
+
+建议在弹窗或表单内显式指定 `getPopupContainer`，挂载到当前弹窗内的独立 DOM 节点，而不是依赖默认挂载：
+
+```tsx
+const popupRef = useRef<HTMLDivElement | null>(null);
+const getPopupContainer = useCallback(() => popupRef.current || document.body, []);
+
+<Modal
+  open={open}
+  modalRender={node => (
+    <div>
+      {node}
+      <div ref={popupRef} />
+    </div>
+  )}
+>
+  <Select getPopupContainer={getPopupContainer} />
+</Modal>
+```
+
+自检顺序建议：
+
+1. 先确认数据是否已正确拉取（排除“无数据”误判为“下拉显示不全”）。
+2. 再确认弹层是否挂在当前 `itemPanel` 可视容器内。
+3. 若仍异常，检查父容器是否存在 `overflow: hidden`、`transform`、`z-index` 冲突。

package/templates/skill/guides/03-api-routing-rules.md

@@ -54,6 +54,12 @@ export const isInOne = (gateway: string): boolean => {
 };
 ```
 
+示例输入：
+
+- `https://osc.gitee.work/api/team` => `true`（集成环境）
+- `https://osc.gitee.work` => `false`（开发环境）
+- `''` 或非法 URL => `false`
+
 ## 统一约束
 
 1. 不要在前端直接请求裸 `/forge/*`。

package/templates/skill/guides/04-deploy-and-subscribe.md

@@ -10,6 +10,14 @@ giteeteam-apps login --domain http://<host> -u <username> -p <password>
 
 ## 1) 构建产物
 
+先更新版本号（必须）：
+
+```yaml
+# manifest.yml
+app:
+  version: '<new-version>'
+```
+
 ```bash
 giteeteam-apps build --prod
 ```
@@ -22,6 +30,26 @@ giteeteam-apps deploy <zip-file> -e production
 
 常见环境值：`development`、`staging`、`production`（默认 `development`）。
 
+在当前仓库建议使用显式命令（避免 `package.json` 中未传文件名导致失败）：
+
+```bash
+pnpm exec giteeteam-apps deploy <appKey>_<versionKey>.zip -e development
+```
+
+如果发布/订阅请求失败，可按以下顺序重试：
+
+1. 先正常执行命令。
+2. 失败后使用提权执行（允许无沙箱网络）。
+3. 提权后仍失败，再补全 `NO_PROXY/no_proxy` 重试。
+
+`NO_PROXY/no_proxy` 示例：
+
+```bash
+NO_PROXY=localhost,127.0.0.1,<domain>,<target-host> \
+no_proxy=localhost,127.0.0.1,<domain>,<target-host> \
+pnpm exec giteeteam-apps deploy <zip-file> -e <environment>
+```
+
 ## 3) 订阅到租户
 
 方式 A：独立订阅
@@ -42,6 +70,8 @@ giteeteam-apps deploy <zip-file> -e production --subscribe osc --app-key <appKey
 2. `-t/--tenants` 与 `--subscribe` 支持逗号分隔，例如 `osc,test`。
 3. 若 zip 命名为 `<appKey>_<versionKey>.zip`，`deploy --subscribe` 可省略 `--app-key/--version-key`。
 4. 发布订阅流程不需要再手动调用 `curl`。
+5. 有代码改动并准备发布时，必须递增 `manifest.yml` 中的 `app.version`。
+6. 默认重试顺序：正常请求 -> 提权请求 -> 提权 + `NO_PROXY/no_proxy`。
 
 ## 故障排查
 

package/templates/skill/guides/05-agent-prompt-template.md

@@ -20,7 +20,10 @@
 - 默认采用 `manifest.tables + getParseQuery/getParseObject`；`storage.entities` 仅用于 Storage API
 - 已发布应用禁止直接修改已有字段类型；只能新增字段并给出迁移方案
 - `manifest.yml` 定义完整且可校验
+- Micro 页面若使用 `invoke`，对应模块必须配置 `resolver.function`（不能只写顶层 `function`）
+- 需要发布时必须递增 `manifest.app.version`
 - trigger 与 webtrigger 的 function 声明完整
+- 发布/订阅失败时按顺序处理：先正常请求，再提权，最后提权 + `NO_PROXY/no_proxy`
 
 输出要求：
 - 列出修改文件

package/templates/skill/guides/06-data-access-and-tables.md

@@ -23,6 +23,7 @@
 2. 应用发布后，不直接修改已有字段 `type`。
 3. 字段演进采用“新增字段 + 数据迁移 + 切换读写”。
 4. 变更说明必须包含迁移方案、回滚方案和影响范围。
+5. Team 应用中心没有“洗表/重建历史数据”的能力，改类型会带来兼容风险和历史数据不可用风险。
 
 ## 表定义建议（资源负载场景）
 
@@ -56,3 +57,4 @@
 2. 未声明 `manifest.tables` 就访问插件表，导致运行期风险。
 3. 发布时 `deploy` 未传 zip 文件名导致命令失败。
 4. 部署返回 `503` 或 `socket hang up` 时，优先排查环境状态，不要先改表结构。
+5. 环境不可用时至少完成两项本地验证：构建通过 + lint 通过，确保 manifest 与代码链路可构建。