@yinsen/deveco-cli 1.3.1

package/dist/internal/telemetry-upload-background.js

@@ -0,0 +1,9 @@
+import Nt from"path";import*as S from"fs";import*as Y from"path";import{homedir as gt}from"os";import*as H from"fs";import*as m from"path";function J(r){let t=m.resolve(r),e=[],n=t;for(;;)try{let i=H.realpathSync(n);return e.length===0?i:m.join(i,...e.reverse())}catch(i){if(i.code!=="ENOENT")throw i;let o=m.dirname(n);if(o===n)return t;e.push(m.basename(n)),n=o}}function P(r){let t=r.trim();return(t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'"))&&(t=t.slice(1,-1).trim()),t}function K(r){let t=P(r);if(!t)throw new Error("Path must not be empty.");return J(t)}var ht="deveco-cli",W,N=class extends Error{constructor(t){super(t),this.name="CliDataDirError"}};function yt(){let r=process.env.DEVECO_CLI_DATA_DIR,e=(r===void 0||r===""?"":P(r))||Y.join(gt(),".local","share",ht);try{return K(e)}catch(n){throw new N(n instanceof Error?n.message:String(n))}}function X(){if(W!==void 0)return W;let r=yt();try{if(S.existsSync(r))return S.realpathSync(r)}catch{}return r}import mt from"crypto";import d from"fs";import z from"os";import y from"path";import St from"https";var q={devecoApiTraceUpload:"https://cn.devecostudio.huawei.com/codeGenie/cli/trace/upload"};var D=class r{static ENDPOINT=q.devecoApiTraceUpload;static SENDER="deveco-cli";async upload(t,e){let n={"Content-Type":"application/json",sender:r.SENDER,deviceid:e.replace(/-/g,""),"Content-Length":String(Buffer.byteLength(t,"utf8"))};try{let{body:i}=await this.httpPost(r.ENDPOINT,n,Buffer.from(t,"utf8"),6e4);return r.isSuccess(i)}catch{return!1}}static isSuccess(t){try{let e=JSON.parse(t),n=e?.code??e?.errorCode;return String(n)==="200"}catch{return!1}}async httpPost(t,e,n,i){let o=new URL(t);return new Promise((s,p)=>{let l=St.request({protocol:o.protocol,hostname:o.hostname,port:o.port||(o.protocol==="https:"?443:80),path:o.pathname+o.search,method:"POST",headers:e,timeout:i},v=>{let h=[];v.on("data",w=>h.push(w)),v.on("end",()=>{s({code:v.statusCode??0,body:Buffer.concat(h).toString("utf8")})})});l.on("timeout",()=>{l.destroy(new Error("request timeout"))}),l.on("error",p),l.write(n),l.end()})}};var G={identity:r=>r,camelCase:r=>r,snakeCase:r=>r.replace(/([a-z0-9])([A-Z])/g,"$1_$2").replace(/([A-Z]+)([A-Z][a-z])/g,"$1_$2").toLowerCase()},M=class{constructor(t={}){this.config=t}config;serialize(t){let e=this.transform(t);return this.config.pretty?JSON.stringify(e,null,2):JSON.stringify(e)}toObject(t){return this.transform(t)}transform(t){if(t==null)return t;if(Array.isArray(t))return t.map(o=>this.transform(o));if(typeof t!="object")return t;let e=this.config.namingStrategy??G.identity,n=this.config.fieldNames??{},i={};for(let[o,s]of Object.entries(t)){let p=n[o]??e(o);i[p]=this.transform(s)}return i}},Z=new M({namingStrategy:G.snakeCase,fieldNames:{}});import E from"crypto";import C from"fs";import Et from"path";var L="aes-256-gcm",xt=12,Tt="deveco-cli-trace-file",bt="trace-file-secret",tt=32;function Q(r){try{let t=C.readFileSync(r,"utf8").trim();return t&&Buffer.from(t,"base64").length===tt?t:null}catch{return null}}function et(r){let t=Et.join(r,bt),e=Q(t);if(e)return j(e);let n=E.randomBytes(tt).toString("base64");try{C.mkdirSync(r,{recursive:!0});try{C.writeFileSync(t,n,{flag:"wx"})}catch{let i=Q(t);if(i)return j(i);C.writeFileSync(t,n)}}catch{}return j(n)}function j(r){return E.createHash("sha256").update(Tt).update(r).digest()}function $(r,t){let e=E.randomBytes(xt),n=E.createCipheriv(L,t,e),i=Buffer.concat([n.update(r,"utf8"),n.final()]),o={version:1,algorithm:L,ciphertext:i.toString("base64"),iv:e.toString("base64"),authTag:n.getAuthTag().toString("base64")};return JSON.stringify(o)}function rt(r,t){let e;try{e=JSON.parse(r)}catch{return null}if(!wt(e))return r;try{let n=E.createDecipheriv(L,t,Buffer.from(e.iv,"base64"));return n.setAuthTag(Buffer.from(e.authTag,"base64")),Buffer.concat([n.update(Buffer.from(e.ciphertext,"base64")),n.final()]).toString("utf8")}catch{return null}}function wt(r){if(!r||typeof r!="object")return!1;let t=r;return t.version===1&&t.algorithm===L&&typeof t.ciphertext=="string"&&typeof t.iv=="string"&&typeof t.authTag=="string"}import*as a from"fs";import*as A from"path";import*as _ from"os";import*as g from"path";import ce from"json5";function nt(){if(process.platform==="win32"){let r=process.env.LOCALAPPDATA??g.join(_.homedir(),"AppData","Local");return g.join(r,"devecocli-mcp-server","logs")}return process.platform==="darwin"?g.join(_.homedir(),"Library","Logs","devecocli-mcp-server"):g.join(_.homedir(),".local","share","devecocli-mcp-server","logs")}var it="mcp-server.log",Dt="mcp-server",Ct={maxSize:10*1024*1024,maxFiles:4},B=class r{fd=null;logDir=null;currentLogFile=null;mode;rotationOptions;currentFileSize=0;currentDate="";isRotating=!1;minLevel;static LEVEL_ORDER={debug:0,info:1,warn:2,error:3};constructor(t,e){this.rotationOptions={...Ct,...e},this.minLevel=t?"debug":"info",t?(this.mode="console",this.logDir=null,this.currentLogFile=null):(this.mode="file",this.logDir=nt(),this.currentLogFile=A.join(this.logDir,it),a.existsSync(this.logDir)||a.mkdirSync(this.logDir,{recursive:!0}),this.cleanupOrphanLogFiles(),this.openLogFile())}getCurrentDateString(){let t=new Date,e=t.getFullYear(),n=String(t.getMonth()+1).padStart(2,"0"),i=String(t.getDate()).padStart(2,"0");return`${e}-${n}-${i}`}getRotatedFileName(t,e){return A.join(this.logDir,`${Dt}-${t}.log.${e}`)}fileExists(t){try{return a.accessSync(t,a.constants.F_OK),!0}catch{return!1}}cleanupOrphanLogFiles(){if(this.logDir)try{let t=a.readdirSync(this.logDir),e=[];for(let i of t)if(i===it||/^mcp-server-\d{4}-\d{2}-\d{2}\.log\.\d+$/.test(i)){let o=A.join(this.logDir,i),s=a.statSync(o);e.push({name:i,mtime:s.mtime,path:o})}e.sort((i,o)=>o.mtime.getTime()-i.mtime.getTime());let n=1+this.rotationOptions.maxFiles;for(let i=n;i<e.length;i++)try{a.unlinkSync(e[i].path)}catch{}}catch{}}rotateLog(){if(!(this.isRotating||!this.logDir||!this.currentLogFile)){this.isRotating=!0;try{if(this.closeLogFile(),!this.fileExists(this.currentLogFile)){this.isRotating=!1,this.openLogFile();return}let t=this.getCurrentDateString(),e=this.getRotatedFileName(t,this.rotationOptions.maxFiles);this.fileExists(e)&&a.unlinkSync(e);for(let i=this.rotationOptions.maxFiles-1;i>=1;i--){let o=this.getRotatedFileName(t,i),s=this.getRotatedFileName(t,i+1);this.fileExists(o)&&a.renameSync(o,s)}let n=this.getRotatedFileName(t,1);a.renameSync(this.currentLogFile,n),this.cleanupOrphanLogFiles(),this.openLogFile()}catch{this.openLogFile()}finally{this.isRotating=!1}}}openLogFile(){if(this.currentLogFile){this.currentDate=this.getCurrentDateString();try{if(this.fileExists(this.currentLogFile)){let t=a.statSync(this.currentLogFile);this.currentFileSize=t.size}else this.currentFileSize=0}catch{this.currentFileSize=0}try{this.fd=a.openSync(this.currentLogFile,"a")}catch{this.fd=null}}}closeLogFile(){if(this.fd!==null){try{a.closeSync(this.fd)}catch{}this.fd=null}}checkRotation(t){let e=this.getCurrentDateString();this.currentDate&&this.currentDate!==e&&(this.rotateLog(),this.currentDate=e),this.currentFileSize+=t,this.currentFileSize>=this.rotationOptions.maxSize&&this.rotateLog()}write(t,e,...n){if(this.mode==="silent"||r.LEVEL_ORDER[t]<r.LEVEL_ORDER[this.minLevel])return;let i=n.map(l=>l instanceof Error?`${l.name}: ${l.message}`:typeof l=="object"?JSON.stringify(l,null,2):String(l)).join(" "),o=i?`${e} ${i}`:e,p=`[${new Date().toLocaleString("sv-SE",{timeZone:"Asia/Shanghai",hour12:!1})+"."+String(new Date().getMilliseconds()).padStart(3,"0")}] [MCP/${t.toUpperCase()}] ${o}
+`;if(this.mode==="file"&&this.currentLogFile){if(this.fd===null&&this.openLogFile(),this.fd!==null)try{let l=Buffer.from(p);a.writeSync(this.fd,l),this.checkRotation(l.byteLength)}catch{this.closeLogFile(),this.openLogFile()}}else this.mode==="console"&&process.stderr.write(p)}debug(t,...e){this.write("debug",t,...e)}info(t,...e){this.write("info",t,...e)}warn(t,...e){this.write("warn",t,...e)}error(t,...e){this.write("error",t,...e)}dispose(){this.closeLogFile()}flush(){if(!(this.mode!=="file"||this.fd===null))try{a.fsyncSync(this.fd)}catch{}}getLogFilePath(){return this.currentLogFile}getLogDirectory(){return this.logDir}},x=null;function Lt(r=!1){x&&x.dispose(),x=new B(r)}function F(){return x||Lt(!1),x}var f={debug:(r,...t)=>F().debug(r,...t),info:(r,...t)=>F().info(r,...t),warn:(r,...t)=>F().warn(r,...t),error:(r,...t)=>F().error(r,...t)};import ot from"fs";import _t from"path";var O=300*1e3,R=3600*1e3,st=10080*60*1e3;function k(){let r=process.env.DEVECO_CLI_DISABLE_TELEMETRY;return r==="1"||r==="true"}var Ft="upload-state.json";function at(r){return _t.join(r,Ft)}function At(){return{firstEventAt:null,lastUploadAt:null,lastRetryAt:null}}function U(r){try{let t=ot.readFileSync(at(r),"utf8"),e=JSON.parse(t);return{firstEventAt:typeof e.firstEventAt=="number"?e.firstEventAt:null,lastUploadAt:typeof e.lastUploadAt=="number"?e.lastUploadAt:null,lastRetryAt:typeof e.lastRetryAt=="number"?e.lastRetryAt:null}}catch{return At()}}function V(r,t){try{ot.writeFileSync(at(r),JSON.stringify(t),"utf8")}catch{}}function lt(r){let t=U(r);t.firstEventAt===null&&(t.firstEventAt=Date.now(),V(r,t))}function ct(r){let t=U(r);t.lastUploadAt=Date.now(),t.firstEventAt=null,V(r,t)}function ut(r){let t=U(r);t.lastRetryAt=Date.now(),V(r,t)}function pt(r){let t=r.match(/^telemetry-(\d{4})-(\d{2})-(\d{2})\.txt$/);if(!t)return null;let e=Date.parse(`${t[1]}-${t[2]}-${t[3]}T00:00:00`);return Number.isFinite(e)?e:null}import Ot from"crypto";import I from"fs";import Rt from"path";var kt="install-id";function It(r){return Rt.join(r,kt)}function ft(r){try{let t=I.readFileSync(r,"utf8").trim();return Pt(t)?t:null}catch{return null}}function Pt(r){return/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(r)}function dt(r){let t=It(r),e=ft(t);if(e)return e;let n=Ot.randomUUID();try{I.mkdirSync(r,{recursive:!0});try{I.writeFileSync(t,n,{flag:"wx"})}catch{let i=ft(t);if(i)return i;I.writeFileSync(t,n)}}catch{}return n}var T=class r{static MAX_BATCH=200;static MAX_PAYLOAD_BYTES=Math.floor(1.7*1024*1024);static TRACE_OS_VERSION="1.0";static COUNTRY_CODE="CN";static EVENT_PREFIX="devecocli_";uploader=new D;storageDir="";failedDir="";installId="";disabled=k();traceFileKey=Buffer.alloc(0);sessionId=mt.randomUUID();cliVersion="";devecoStudioVersion=null;sourceType="";cltVersion=null;nodeVersion="";initialTimer=null;intervalTimer=null;retryInitialTimer=null;retryTimer=null;flushChain=Promise.resolve();constructor(){f.info(`[telemetry] instance created, sessionId=${this.sessionId}`)}init(t){this.storageDir=t,this.failedDir=y.join(t,"failed"),this.cliVersion="1.3.1",this.nodeVersion=process.version,this.installId=dt(t).replace(/-/g,""),this.traceFileKey=et(t),d.mkdirSync(t,{recursive:!0}),d.mkdirSync(this.failedDir,{recursive:!0}),f.info(`[telemetry] init: dir=${t}, failedDir=${this.failedDir}, cliVersion=${this.cliVersion}, os=${this.resolveOsName()}, arch=${this.resolveOsArch()}, node=${this.nodeVersion}`)}setStudioVersion(t){this.devecoStudioVersion=t,f.info(`[telemetry] studio version set: ${t}`)}setSourceType(t){this.sourceType=t,f.info(`[telemetry] sourceType set: ${t}`)}setCltVersion(t){this.cltVersion=t,f.info(`[telemetry] CLT version set: ${t}`)}async track(t,e){if(this.disabled)return typeof e=="function"?e():void 0;if(!this.storageDir)throw new Error("Telemetry not initialized. Call init() first.");if(!e){await this.record(t,0,!0,null);return}if(typeof e!="function"){let o=e;await this.record(t,o.duration_ms,o.success,o.error_code);return}let n=e,i=Date.now();try{let o=await n(),s=Date.now()-i;return await this.record(t,s,!0,null),o}catch(o){let s=Date.now()-i,p=this.toErrorCode(o);throw await this.record(t,s,!1,p),o}}async record(t,e,n,i){let o=this.buildTraceEvent(t,e,n,i);try{let s=$(JSON.stringify(o),this.traceFileKey);await d.promises.appendFile(this.currentFile(),s+`
+`,"utf8"),lt(this.storageDir)}catch{}}buildTraceEvent(t,e,n,i){let o=`${r.EVENT_PREFIX}${t.event}`,s=Z.toObject(t);return s&&typeof s=="object"&&delete s.event,{countryCode:r.COUNTRY_CODE,event:o,eventtime:String(Date.now()),properties:{uid:this.installId,trace_uuid:mt.randomUUID(),trace_os_version:r.TRACE_OS_VERSION,os_arch:this.resolveOsArch(),action:o,trace_os_name:this.resolveOsName(),version:`${this.cliVersion}_${this.resolveOsSuffix()}`,deveco_studio_version:this.formatVersion(this.devecoStudioVersion),command_line_version:this.formatVersion(this.cltVersion),source_type:this.sourceType,session_id:this.sessionId,node_version:this.nodeVersion,duration_ms:e,success:n,error_code:i,event_detail:s}}}toErrorCode(t){return t instanceof Error?t.code??t.name:"UnknownError"}resolveOsArch(){let t=z.arch();return t==="x64"?"amd64":t}resolveOsName(){switch(process.platform){case"win32":{let t=z.release().split(".");return(parseInt(t[t.length-1],10)||0)>=22e3?"Windows 11":"Windows 10"}case"darwin":return"macOS";case"linux":return"Linux";default:return process.platform}}resolveOsSuffix(){switch(process.platform){case"win32":return"windows";case"darwin":return z.arch()==="arm64"?"mac_arm":"mac";default:return"linux"}}formatVersion(t){return t?`${t}_${this.resolveOsSuffix()}`:""}dateString(){let t=new Date,e=String(t.getMonth()+1).padStart(2,"0"),n=String(t.getDate()).padStart(2,"0");return`${t.getFullYear()}-${e}-${n}`}currentFile(){return y.join(this.storageDir,`telemetry-${this.dateString()}.txt`)}startScheduler(){if(this.stopScheduler(),this.disabled){f.info("[telemetry] scheduler not started (telemetry disabled)");return}f.info(`[telemetry] scheduler started (flush every ${O/1e3}s, retry failed every ${R/1e3}s)`),this.initialTimer=setTimeout(()=>{this.flush().catch(()=>{}),this.intervalTimer=setInterval(()=>{this.flush().catch(()=>{})},O)},O),this.retryInitialTimer=setTimeout(()=>{this.retryFailed().catch(()=>{}),this.retryTimer=setInterval(()=>{this.retryFailed().catch(()=>{})},R)},R)}stopScheduler(){this.initialTimer&&(clearTimeout(this.initialTimer),this.initialTimer=null),this.intervalTimer&&(clearInterval(this.intervalTimer),this.intervalTimer=null),this.retryInitialTimer&&(clearTimeout(this.retryInitialTimer),this.retryInitialTimer=null),this.retryTimer&&(clearInterval(this.retryTimer),this.retryTimer=null),f.info("[telemetry] scheduler stopped")}async flush(){return this.disabled?!0:this.runExclusive(()=>this.performFlush())}async performFlush(){if(!this.storageDir)throw new Error("Telemetry not initialized. Call init() first.");let t=await this.listPendingFiles(),e=!0;for(let n of t)await this.flushFile(n)||(e=!1);return ct(this.storageDir),e}async retryFailed(){return this.disabled?!0:this.runExclusive(()=>this.performRetryFailed())}async performRetryFailed(){if(!this.storageDir)throw new Error("Telemetry not initialized. Call init() first.");let t=Date.now(),e;try{e=await d.promises.readdir(this.failedDir)}catch{return!0}let n=e.filter(o=>o.startsWith("telemetry-")&&o.endsWith(".txt")).map(o=>y.join(this.failedDir,o)),i=!0;for(let o of n){let s=y.basename(o),p=pt(s);if(p!==null){if(t-p>st){try{await d.promises.unlink(o)}catch{}continue}await this.flushFile(o)||(i=!1)}}return i||f.warn("[telemetry] retry failed"),ut(this.storageDir),i}runExclusive(t){let e=()=>t(),n=this.flushChain.then(e,e);return this.flushChain=n.then(()=>{},()=>{}),n}async listPendingFiles(){let t;try{t=await d.promises.readdir(this.storageDir)}catch{return[]}return t.filter(e=>e.startsWith("telemetry-")&&e.endsWith(".txt")).map(e=>y.join(this.storageDir,e)).sort()}async flushFile(t){let e=t+".pending";try{await d.promises.rename(t,e)}catch{return!1}let n;try{n=await d.promises.readFile(e,"utf8")}catch{return!1}let i=n.split(`
+`).map(s=>s.trim()).filter(Boolean),o=[];for(let s of i){let p=rt(s,this.traceFileKey);p!==null&&o.push(p)}if(o.length===0){try{await d.promises.unlink(e)}catch{}return!0}return this.uploadInBatches(e,o)}async uploadInBatches(t,e){let n=0;for(;n<e.length;){let i=n,o=[],s=16;for(;n<e.length&&o.length<r.MAX_BATCH;){let h=e[n],w=Buffer.byteLength(h,"utf8")+1;if(o.length>0&&s+w>r.MAX_PAYLOAD_BYTES)break;o.push(h),s+=w,n++}let p=this.buildPayloadItems(o),l=JSON.stringify(p),v=!1;try{v=await this.uploader.upload(l,this.installId)}catch{}if(!v){f.warn("[telemetry] upload failed");let h=e.slice(i).join(`
+`)+`
+`;return await this.moveToFailed(t,h),!1}}try{await d.promises.unlink(t)}catch{}return!0}buildPayloadItems(t){let e=[];for(let n of t)try{let i=JSON.parse(n);e.push({action:i.event,detail:JSON.stringify(i.properties),timestamp:Number(i.eventtime)||Date.now()})}catch{}return e}async moveToFailed(t,e){let n=y.basename(t,".pending"),i=y.join(this.failedDir,n);try{let o=e.split(`
+`).filter(Boolean).map(s=>$(s,this.traceFileKey)).join(`
+`)+`
+`;await d.promises.appendFile(i,o,"utf8")}catch{return}try{await d.promises.unlink(t)}catch{}}};var b=new T;import{spawn as Ve}from"child_process";import{existsSync as He}from"fs";import{dirname as Ke,join as We}from"path";import{fileURLToPath as Xe}from"url";var Mt=Nt.join(X(),"TraceLogData");b.init(Mt);(async()=>{try{await b.flush(),await b.retryFailed()}catch(r){f.warn("[telemetry] background upload error:",r),process.exit(1)}})();

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@yinsen/deveco-cli",
+  "version": "1.3.1",
+  "description": "HarmonyOS application development command line tool",
+  "license": "MIT",
+  "type": "module",
+  "bin": { "devecocli": "dist/cli.js" },
+  "files": [
+    "dist",
+    "templates",
+    "src/resources",
+    "THIRD-PARTY-LICENSES",
+    "SKILL.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx watch src/cli.ts",
+    "start": "tsx src/cli.ts",
+    "test": "vitest run",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write src",
+    "prepublishOnly": "npm run lint && npm run build"
+  },
+  "engines": { "node": ">=22" },
+  "keywords": ["harmonyos", "deveco", "cli"],
+  "dependencies": {
+    "@yinsen/deveco-cli-docs-zh": "^1.3.1-0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "adm-zip": "0.6.0",
+    "axios": "1.19.0",
+    "colorette": "^2.0.20",
+    "commander": "^13.1.0",
+    "execa": "^9.6.1",
+    "fs-extra": "^11.3.4",
+    "global-agent": "^4.1.3",
+    "json5": "^2.2.3",
+    "node-forge": "^1.4.0",
+    "ora": "^9.4.0",
+    "p-limit": "^5.0.0",
+    "proper-lockfile": "^4.1.2",
+    "regedit": "^5.1.4",
+    "semver": "^7.8.5",
+    "smol-toml": "^1.6.1",
+    "socket.io-client": "^4.7.5",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.8",
+    "@types/fs-extra": "^11.0.4",
+    "@types/global-agent": "^3.0.0",
+    "@types/node-forge": "^1.3.14",
+    "@types/proper-lockfile": "^4.1.4",
+    "@types/semver": "^7.7.1"
+  }
+}

package/src/resources/aclPermission/aclPermissionsInfo.json

@@ -0,0 +1,311 @@
+[
+  {
+    "permissionName": "ohos.permission.SYSTEM_FLOAT_WINDOW",
+    "permissionDisplayName": "SYSTEM_FLOAT_WINDOW",
+    "permissionHelpUrlKey": "acl.system.float.window.instead.url",
+    "permissionInsteadName": "acl.SYSTEM_FLOAT_WINDOW.instead.name",
+    "minSupportApiLevel": "9"
+  },
+  {
+    "permissionName": "ohos.permission.READ_CONTACTS",
+    "permissionDisplayName": "READ_CONTACTS",
+    "permissionHelpUrlKey": "acl.read.contacts.instead.url",
+    "permissionInsteadName": "acl.READ_CONTACTS.instead.name",
+    "minSupportApiLevel": "8"
+  },
+  {
+    "permissionName": "ohos.permission.WRITE_CONTACTS",
+    "permissionDisplayName": "WRITE_CONTACTS",
+    "minSupportApiLevel": "8"
+  },
+  {
+    "permissionName": "ohos.permission.READ_IMAGEVIDEO",
+    "permissionDisplayName": "READ_IMAGEVIDEO",
+    "permissionHelpUrlKey": "acl.read.image.video.instead.url",
+    "permissionInsteadName": "acl.READ_IMAGEVIDEO.instead.name",
+    "minSupportApiLevel": "9"
+  },
+  {
+    "permissionName": "ohos.permission.WRITE_IMAGEVIDEO",
+    "permissionDisplayName": "WRITE_IMAGEVIDEO",
+    "permissionHelpUrlKey": "acl.write.image.video.instead.url",
+    "permissionInsteadName": "acl.WRITE_IMAGEVIDEO.instead.name",
+    "minSupportApiLevel": "9"
+  },
+  {
+    "permissionName": "ohos.permission.READ_AUDIO",
+    "permissionDisplayName": "READ_AUDIO",
+    "permissionHelpUrlKey": "acl.read.audio.instead.url",
+    "permissionInsteadName": "acl.READ_AUDIO.instead.name",
+    "minSupportApiLevel": "9"
+  },
+  {
+    "permissionName": "ohos.permission.WRITE_AUDIO",
+    "permissionDisplayName": "WRITE_AUDIO",
+    "permissionHelpUrlKey": "acl.write.audio.instead.url",
+    "permissionInsteadName": "acl.WRITE_AUDIO.instead.name",
+    "minSupportApiLevel": "9"
+  },
+  {
+    "permissionName": "ohos.permission.READ_PASTEBOARD",
+    "permissionDisplayName": "READ_PASTEBOARD",
+    "permissionHelpUrlKey": "acl.read.pasteboard.instead.url",
+    "permissionInsteadName": "acl.READ_PASTEBOARD.instead.name",
+    "minSupportApiLevel": "11"
+  },
+  {
+    "permissionName": "ohos.permission.ACCESS_DDK_USB",
+    "permissionDisplayName": "ACCESS_DDK_USB",
+    "minSupportApiLevel": "11"
+  },
+  {
+    "permissionName": "ohos.permission.ACCESS_DDK_HID",
+    "permissionDisplayName": "ACCESS_DDK_HID",
+    "minSupportApiLevel": "11"
+  },
+  {
+    "permissionName": "ohos.permission.FILE_ACCESS_PERSIST",
+    "permissionDisplayName": "FILE_ACCESS_PERSIST",
+    "minSupportApiLevel": "11"
+  },
+  {
+    "permissionName": "ohos.permission.READ_WRITE_DOWNLOAD_DIRECTORY",
+    "permissionDisplayName": "READ_WRITE_DOWNLOAD_DIRECTORY",
+    "minSupportApiLevel": "11"
+  },
+  {
+    "permissionName": "ohos.permission.READ_WRITE_DESKTOP_DIRECTORY",
+    "permissionDisplayName": "READ_WRITE_DESKTOP_DIRECTORY",
+    "minSupportApiLevel": "11"
+  },
+  {
+    "permissionName": "ohos.permission.READ_WRITE_DOCUMENTS_DIRECTORY",
+    "permissionDisplayName": "READ_WRITE_DOCUMENTS_DIRECTORY",
+    "minSupportApiLevel": "11"
+  },
+  {
+    "permissionName": "ohos.permission.INPUT_MONITORING",
+    "permissionDisplayName": "INPUT_MONITORING",
+    "minSupportApiLevel": "12"
+  },
+  {
+    "permissionName": "ohos.permission.INTERCEPT_INPUT_EVENT",
+    "permissionDisplayName": "INTERCEPT_INPUT_EVENT",
+    "minSupportApiLevel": "12"
+  },
+  {
+    "permissionName": "ohos.permission.SHORT_TERM_WRITE_IMAGEVIDEO",
+    "permissionDisplayName": "SHORT_TERM_WRITE_IMAGEVIDEO",
+    "minSupportApiLevel": "12"
+  },
+  {
+    "permissionName": "ohos.permission.kernel.ALLOW_WRITABLE_CODE_MEMORY",
+    "permissionDisplayName": "ALLOW_WRITABLE_CODE_MEMORY",
+    "minSupportApiLevel": "14"
+  },
+  {
+    "permissionName": "ohos.permission.kernel.DISABLE_CODE_MEMORY_PROTECTION",
+    "permissionDisplayName": "DISABLE_CODE_MEMORY_PROTECTION",
+    "minSupportApiLevel": "14"
+  },
+  {
+    "permissionName": "ohos.permission.kernel.ALLOW_EXECUTABLE_FORT_MEMORY",
+    "permissionDisplayName": "ALLOW_EXECUTABLE_FORT_MEMORY",
+    "minSupportApiLevel": "14"
+  },
+  {
+    "permissionName": "ohos.permission.GET_WIFI_PEERS_MAC",
+    "permissionDisplayName": "GET_WIFI_PEERS_MAC",
+    "minSupportApiLevel": "8"
+  },
+  {
+    "permissionName": "ohos.permission.MANAGE_PASTEBOARD_APP_SHARE_OPTION",
+    "permissionDisplayName": "MANAGE_PASTEBOARD_APP_SHARE_OPTION",
+    "minSupportApiLevel": "14"
+  },
+  {
+    "permissionName": "ohos.permission.MANAGE_UDMF_APP_SHARE_OPTION",
+    "permissionDisplayName": "MANAGE_UDMF_APP_SHARE_OPTION",
+    "minSupportApiLevel": "14"
+  },
+  {
+    "permissionName": "ohos.permission.READ_WRITE_USER_FILE",
+    "permissionDisplayName": "READ_WRITE_USER_FILE",
+    "minSupportApiLevel": "13"
+  },
+  {
+    "permissionName": "ohos.permission.READ_WRITE_USB_DEV",
+    "permissionDisplayName": "READ_WRITE_USB_DEV",
+    "minSupportApiLevel": "13"
+  },
+  {
+    "permissionName": "ohos.permission.USE_FRAUD_CALL_LOG_PICKER",
+    "permissionDisplayName": "USE_FRAUD_CALL_LOG_PICKER",
+    "minSupportApiLevel": "15"
+  },
+  {
+    "permissionName": "ohos.permission.USE_FRAUD_MESSAGES_PICKER",
+    "permissionDisplayName": "USE_FRAUD_MESSAGES_PICKER",
+    "minSupportApiLevel": "15"
+  },
+  {
+    "permissionName": "ohos.permission.ACCESS_DISK_PHY_INFO",
+    "permissionDisplayName": "ACCESS_DISK_PHY_INFO",
+    "minSupportApiLevel": "15"
+  },
+  {
+    "permissionName": "ohos.permission.SET_PAC_URL",
+    "permissionDisplayName": "SET_PAC_URL",
+    "minSupportApiLevel": "15"
+  },
+  {
+    "permissionName": "ohos.permission.PERSONAL_MANAGE_RESTRICTIONS",
+    "permissionDisplayName": "PERSONAL_MANAGE_RESTRICTIONS",
+    "minSupportApiLevel": "15"
+  },
+  {
+    "permissionName": "ohos.permission.START_PROVISIONING_MESSAGE",
+    "permissionDisplayName": "START_PROVISIONING_MESSAGE",
+    "minSupportApiLevel": "15"
+  },
+  {
+    "permissionName": "ohos.permission.PRELOAD_FILE",
+    "permissionDisplayName": "PRELOAD_FILE",
+    "minSupportApiLevel": "15"
+  },
+  {
+    "permissionName": "ohos.permission.ACCESS_VIRTUAL_SCREEN",
+    "permissionDisplayName": "ACCESS_VIRTUAL_SCREEN",
+    "minSupportApiLevel": "16"
+  },
+  {
+    "permissionName": "ohos.permission.PERSISTENT_BLUETOOTH_PEERS_MAC",
+    "permissionDisplayName": "PERSISTENT_BLUETOOTH_PEERS_MAC",
+    "minSupportApiLevel": "16"
+  },
+  {
+    "permissionName": "ohos.permission.ACCESS_DDK_USB_SERIAL",
+    "permissionDisplayName": "ACCESS_DDK_USB_SERIAL",
+    "minSupportApiLevel": "18"
+  },
+  {
+    "permissionName": "ohos.permission.ACCESS_DDK_SCSI_PERIPHERAL",
+    "permissionDisplayName": "ACCESS_DDK_SCSI_PERIPHERAL",
+    "minSupportApiLevel": "18"
+  },
+  {
+    "permissionName": "ohos.permission.USE_FRAUD_APP_PICKER",
+    "permissionDisplayName": "USE_FRAUD_APP_PICKER",
+    "minSupportApiLevel": "18"
+  },
+  {
+  "permissionName": "ohos.permission.kernel.DISABLE_GOTPLT_RO_PROTECTION",
+  "permissionDisplayName": "DISABLE_GOTPLT_RO_PROTECTION",
+  "minSupportApiLevel": "17"
+  },
+  {
+    "permissionName": "ohos.permission.MANAGE_APN_SETTING",
+    "permissionDisplayName": "MANAGE_APN_SETTING",
+    "minSupportApiLevel": "16"
+  },
+  {
+    "permissionName": "ohos.permission.MANAGE_SCREEN_TIME_GUARD",
+    "permissionDisplayName": "MANAGE_SCREEN_TIME_GUARD",
+    "minSupportApiLevel": "20"
+  },
+  {
+    "permissionName": "ohos.permission.CUSTOMIZE_SAVE_BUTTON",
+    "permissionDisplayName": "CUSTOMIZE_SAVE_BUTTON",
+    "minSupportApiLevel": "20"
+  },
+  {
+    "permissionName": "ohos.permission.GET_ABILITY_INFO",
+    "permissionDisplayName": "GET_ABILITY_INFO",
+    "minSupportApiLevel": "20"
+  },
+  {
+    "permissionName": "ohos.permission.DLP_GET_HIDE_STATUS",
+    "permissionDisplayName": "DLP_GET_HIDE_STATUS",
+    "minSupportApiLevel": "20"
+  },
+  {
+    "permissionName": "ohos.permission.ACCESS_FIDO2_ONLINEAUTH",
+    "permissionDisplayName": "ACCESS_FIDO2_ONLINEAUTH",
+    "minSupportApiLevel": "20"
+  },
+  {
+    "permissionName": "ohos.permission.LINKTURBO",
+    "permissionDisplayName": "LINKTURBO",
+    "minSupportApiLevel": "20"
+  },
+  {
+    "permissionName": "ohos.permission.USE_FLOAT_BALL",
+    "permissionDisplayName": "USE_FLOAT_BALL",
+    "minSupportApiLevel": "20"
+  },
+  {
+    "permissionName": "ohos.permission.GET_ETHERNET_LOCAL_MAC",
+    "permissionDisplayName": "GET_ETHERNET_LOCAL_MAC",
+    "minSupportApiLevel": "20"
+  },
+  {
+    "permissionName": "ohos.permission.GET_WIFI_LOCAL_MAC",
+    "permissionDisplayName": "GET_WIFI_LOCAL_MAC",
+    "minSupportApiLevel": "20"
+  },
+  {
+    "permissionName": "ohos.permission.READ_LOCAL_DEVICE_NAME",
+    "permissionDisplayName": "READ_LOCAL_DEVICE_NAME",
+    "minSupportApiLevel": "20"
+  },
+  {
+    "permissionName": "ohos.permission.ACCESS_NET_TRACE_INFO",
+    "permissionDisplayName": "ACCESS_NET_TRACE_INFO",
+    "minSupportApiLevel": "20"
+  },
+  {
+    "permissionName": "ohos.permission.KEEP_BACKGROUND_RUNNING_SYSTEM",
+    "permissionDisplayName": "KEEP_BACKGROUND_RUNNING_SYSTEM",
+    "minSupportApiLevel": "20"
+  },
+  {
+    "permissionName": "ohos.permission.atomicService.MANAGE_STORAGE",
+    "permissionDisplayName": "MANAGE_STORAGE",
+    "minSupportApiLevel": "20"
+  },
+  {
+    "permissionName": "ohos.permission.WEB_NATIVE_MESSAGING",
+    "permissionDisplayName": "WEB_NATIVE_MESSAGING",
+    "minSupportApiLevel": "21"
+  },
+  {
+    "permissionName": "ohos.permission.HOOK_KEY_EVENT",
+    "permissionDisplayName": "HOOK_KEY_EVENT",
+    "minSupportApiLevel": "21"
+  },
+  {
+    "permissionName": "ohos.permission.SET_SYSTEMSHARE_APPLAUNCHTRUSTLIST",
+    "permissionDisplayName": "SET_SYSTEMSHARE_APPLAUNCHTRUSTLIST",
+    "minSupportApiLevel": "21"
+  },
+  {
+    "permissionName": "ohos.permission.SUBSCRIBE_NOTIFICATION",
+    "permissionDisplayName": "SUBSCRIBE_NOTIFICATION",
+    "minSupportApiLevel": "22"
+  },
+  {
+    "permissionName": "ohos.permission.ACCESS_USER_FULL_DISK",
+    "permissionDisplayName": "ACCESS_USER_FULL_DISK",
+    "minSupportApiLevel": "22"
+  },
+  {
+    "permissionName": "ohos.permission.CUSTOM_SCREEN_RECORDING",
+    "permissionDisplayName": "CUSTOM_SCREEN_RECORDING",
+    "minSupportApiLevel": "22"
+  },
+  {
+    "permissionName": "ohos.permission.GET_IP_MAC_INFO",
+    "permissionDisplayName": "GET_IP_MAC_INFO",
+    "minSupportApiLevel": "22"
+  }
+]

package/templates/application/AppScope/app.json5

@@ -0,0 +1,10 @@
+{
+  "app": {
+    "bundleName": "com.example.myapplication",
+    "vendor": "example",
+    "versionCode": 1000000,
+    "versionName": "1.0.0",
+    "icon": "$media:layered_image",
+    "label": "$string:app_name"
+  }
+}

package/templates/application/AppScope/resources/base/element/string.json

@@ -0,0 +1,8 @@
+{
+  "string": [
+    {
+      "name": "app_name",
+      "value": "MyApplication"
+    }
+  ]
+}

package/templates/application/AppScope/resources/base/media/layered_image.json

@@ -0,0 +1,7 @@
+{
+  "layered-image":
+  {
+    "background" : "$media:background",
+    "foreground" : "$media:foreground"
+  }
+}

package/templates/application/build-profile.json5

@@ -0,0 +1,42 @@
+{
+  "app": {
+    "signingConfigs": [],
+    "products": [
+      {
+        "name": "default",
+        "signingConfig": "default",
+        "targetSdkVersion": "6.0.2(22)",
+        "compatibleSdkVersion": "6.0.2(22)",
+        "runtimeOS": "HarmonyOS",
+        "buildOption": {
+          "strictMode": {
+            "caseSensitiveCheck": true,
+            "useNormalizedOHMUrl": true
+          }
+        }
+      }
+    ],
+    "buildModeSet": [
+      {
+        "name": "debug",
+      },
+      {
+        "name": "release"
+      }
+    ]
+  },
+  "modules": [
+    {
+      "name": "entry",
+      "srcPath": "./entry",
+      "targets": [
+        {
+          "name": "default",
+          "applyToProducts": [
+            "default"
+          ]
+        }
+      ]
+    }
+  ]
+}

package/templates/application/code-linter.json5

@@ -0,0 +1,32 @@
+{
+  "files": [
+    "**/*.ets"
+  ],
+  "ignore": [
+    "**/src/ohosTest/**/*",
+    "**/src/test/**/*",
+    "**/src/mock/**/*",
+    "**/node_modules/**/*",
+    "**/oh_modules/**/*",
+    "**/build/**/*",
+    "**/.preview/**/*"
+  ],
+  "ruleSet": [
+    "plugin:@performance/recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "rules": {
+    "@security/no-unsafe-aes": "error",
+    "@security/no-unsafe-hash": "error",
+    "@security/no-unsafe-mac": "warn",
+    "@security/no-unsafe-dh": "error",
+    "@security/no-unsafe-dsa": "error",
+    "@security/no-unsafe-ecdsa": "error",
+    "@security/no-unsafe-rsa-encrypt": "error",
+    "@security/no-unsafe-rsa-sign": "error",
+    "@security/no-unsafe-rsa-key": "error",
+    "@security/no-unsafe-dsa-key": "error",
+    "@security/no-unsafe-dh-key": "error",
+    "@security/no-unsafe-3des": "error"
+  }
+}

package/templates/application/entry/build-profile.json5

@@ -0,0 +1,33 @@
+{
+  "apiType": "stageMode",
+  "buildOption": {
+    "resOptions": {
+      "copyCodeResource": {
+        "enable": false
+      }
+    }
+  },
+  "buildOptionSet": [
+    {
+      "name": "release",
+      "arkOptions": {
+        "obfuscation": {
+          "ruleOptions": {
+            "enable": false,
+            "files": [
+              "./obfuscation-rules.txt"
+            ]
+          }
+        }
+      }
+    },
+  ],
+  "targets": [
+    {
+      "name": "default"
+    },
+    {
+      "name": "ohosTest",
+    }
+  ]
+}

package/templates/application/entry/gitignore.txt

@@ -0,0 +1,6 @@
+/node_modules
+/oh_modules
+/.preview
+/build
+/.cxx
+/.test

package/templates/application/entry/hvigorfile.ts

@@ -0,0 +1,7 @@
+// @ts-nocheck – Template file, only used when copied into a project directory
+import { hapTasks } from '@ohos/hvigor-ohos-plugin';
+
+export default {
+  system: hapTasks /* Built-in plugin of Hvigor. It cannot be modified. */,
+  plugins: [] /* Custom plugin to extend the functionality of Hvigor. */,
+};

package/templates/application/entry/obfuscation-rules.txt

@@ -0,0 +1,20 @@
+# Define project specific obfuscation rules here.
+# You can include the obfuscation configuration files in the current module's build-profile.json5.
+
+# Obfuscation options:
+# -disable-obfuscation: disable all obfuscations
+# -enable-property-obfuscation: obfuscate the property names
+# -enable-toplevel-obfuscation: obfuscate the names in the global scope
+# -compact: remove unnecessary blank spaces and all line feeds
+# -remove-log: remove all console.* statements
+# -print-namecache: print the name cache that contains the mapping from the old names to new names
+# -apply-namecache: reuse the given cache file
+
+# Keep options:
+# -keep-property-name: specifies property names that you want to keep
+# -keep-global-name: specifies names that you want to keep in the global scope
+
+-enable-property-obfuscation
+-enable-toplevel-obfuscation
+-enable-filename-obfuscation
+-enable-export-obfuscation

package/templates/application/entry/oh-package.json5

@@ -0,0 +1,10 @@
+{
+  "name": "entry",
+  "version": "1.0.0",
+  "description": "Please describe the basic information.",
+  "main": "",
+  "author": "",
+  "license": "",
+  "dependencies": {}
+}
+

package/templates/application/entry/src/main/ets/entryability/EntryAbility.ets

@@ -0,0 +1,63 @@
+/*
+ * Copyright (c) 2026 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { AbilityConstant, ConfigurationConstant, UIAbility, Want } from '@kit.AbilityKit';
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import { window } from '@kit.ArkUI';
+
+const DOMAIN = 0x0000;
+
+export default class EntryAbility extends UIAbility {
+  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
+    try {
+      this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
+    } catch (err) {
+      hilog.error(DOMAIN, 'testTag', 'Failed to set colorMode. Cause: %{public}s', JSON.stringify(err));
+    }
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');
+  }
+
+  onDestroy(): void {
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onDestroy');
+  }
+
+  onWindowStageCreate(windowStage: window.WindowStage): void {
+    // Main window is created, set main page for this ability
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
+
+    windowStage.loadContent('pages/Index', (err) => {
+      if (err.code) {
+        hilog.error(DOMAIN, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err));
+        return;
+      }
+      hilog.info(DOMAIN, 'testTag', 'Succeeded in loading the content.');
+    });
+  }
+
+  onWindowStageDestroy(): void {
+    // Main window is destroyed, release UI related resources
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageDestroy');
+  }
+
+  onForeground(): void {
+    // Ability has brought to foreground
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onForeground');
+  }
+
+  onBackground(): void {
+    // Ability has back to background
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onBackground');
+  }
+}