@coboot/headless 0.2.2-rc.5 → 0.2.2-rc.6

package/README.md

@@ -6,7 +6,7 @@ Headless 业务运行时要求 Node.js 20+；当入口检测到 Node.js 18/19
 首次启动只需一次性设备 token：
 
 ```bash
-npx -y @coboot/headless@0.2.2-rc.5 '<device-token>'
+npx -y @coboot/headless@0.2.2-rc.6 '<device-token>'
 ```
 
 命令会把运行时安装到 `/data/coboot/.siboot`，在客户端鉴权和运行时初始化完成后启动
@@ -18,10 +18,10 @@ detached daemon 并退出。不需要设置 `BACKEND_URL`、`CLIENT_UID`。终
 并重新启动旧 client，不会让两个 Headless 进程争抢同一台物理机的 Driver 锁。
 
 ```bash
-npx -y @coboot/headless@0.2.2-rc.5 status
-npx -y @coboot/headless@0.2.2-rc.5 logs
-npx -y @coboot/headless@0.2.2-rc.5 restart
-npx -y @coboot/headless@0.2.2-rc.5 stop
+npx -y @coboot/headless@0.2.2-rc.6 status
+npx -y @coboot/headless@0.2.2-rc.6 logs
+npx -y @coboot/headless@0.2.2-rc.6 restart
+npx -y @coboot/headless@0.2.2-rc.6 stop
 ```
 
 更新到 npm `latest` 并重启：
@@ -45,13 +45,13 @@ Coboot daemon 默认禁用 updater 和浏览器预热，第一次调用 `browser
 
 ```bash
 HEADLESS_BROWSER_EXECUTABLE=/absolute/path/to/chrome \
-  npx -y @coboot/headless@0.2.2-rc.5 '<device-token>'
+  npx -y @coboot/headless@0.2.2-rc.6 '<device-token>'
 ```
 
 需要安装浏览器时，由用户执行：
 
 ```bash
-npx -y @coboot/headless@0.2.2-rc.5 install-browser
+npx -y @coboot/headless@0.2.2-rc.6 install-browser
 ```
 
 该命令不需要设备 token，也不要求 root。它会先检查现有浏览器并执行启动验证；浏览器已经可用时
@@ -89,7 +89,7 @@ dnf/yum 先试仓库中的 `chromium`，x86_64 回退到官方 RPM 并关闭 wea
 自动化或排障需要显式表达重新注册时，也可以使用：
 
 ```bash
-npx -y @coboot/headless@0.2.2-rc.5 --force-enroll '<device-token>'
+npx -y @coboot/headless@0.2.2-rc.6 --force-enroll '<device-token>'
 ```
 
 当本地已经存在设备身份时，该命令与再次传入 positional token 使用同一套事务式替换流程。
@@ -126,7 +126,7 @@ HTTP 与 WebSocket 必须同域并与设备 token 匹配：
 HEADLESS_ALLOW_ENDPOINT_OVERRIDE=1 \
 BACKEND_URL=https://example.com \
 WS_URL=wss://example.com/wsschat \
-npx -y @coboot/headless@0.2.2-rc.5 '<device-token>'
+npx -y @coboot/headless@0.2.2-rc.6 '<device-token>'
 ```
 
 WebSocket 覆盖变量名是 `WS_URL`，不是 `WSS_URL`。
@@ -140,7 +140,7 @@ endpoint 覆盖同样不会写入配置；后续执行 `restart` 时必须再次
 CU_EDITION=coboot \
 PKG_NAME=@coboot/headless \
 PKG_BIN_NAME=coboot-headless \
-PKG_VERSION=0.2.2-rc.5 \
+PKG_VERSION=0.2.2-rc.6 \
 pnpm build:headless:npm
 ```
 
@@ -148,8 +148,8 @@ pnpm build:headless:npm
 
 ```bash
 npm pack --dry-run --json ./dist-headless
-tar -xOf dist-headless/coboot-headless-0.2.2-rc.5.tgz package/package.json
-sha256sum dist-headless/coboot-headless-0.2.2-rc.5.tgz
+tar -xOf dist-headless/coboot-headless-0.2.2-rc.6.tgz package/package.json
+sha256sum dist-headless/coboot-headless-0.2.2-rc.6.tgz
 ```
 
 

package/daemon.mjs

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import r from"fs";import V from"net";import b from"os";import i from"path";import{spawn as B}from"child_process";var _=process.env.SIBOOT_BASE_DIR,E=i.join(_,"current"),N=process.env.WORKSPACE||"/data/siboot/workspace",S=i.join(_,"run"),f=i.join(_,"logs"),I=i.join(E,"entry.mjs"),m=i.join(_,"scripts","updater.mjs"),F=i.join(S,"daemon.pid"),h=i.join(S,"node.pid"),$=i.join(S,"updater.pid"),G=i.join(S,"status.json"),Y=73,H=5e3,K=3e4,k=Number.parseInt(process.env.ANYDEV_CLIENT_RESTART_DELAY_MS||"1000",10),J=Number.parseInt(process.env.ANYDEV_UPDATER_RESTART_DELAY_MS||"10000",10),A=Number.parseInt(process.env.ANYDEV_LOG_RETENTION_DAYS||"4",10),s=null,d=null,u=!1,L=0,v=0,T=!1,D=null,y=null,p=0,g=null,W=new Date().toISOString();async function X(){let e=V.createServer(n=>n.destroy()),t=process.platform==="linux"?{path:"\0siboot-anydev-daemon-v1"}:{host:"127.0.0.1",port:43880,exclusive:!0};await new Promise((n,c)=>{e.once("error",c),e.listen(t,()=>{e.removeListener("error",c),n()})})}function q(){for(let e of[S,N,i.join(f,"daemon"),i.join(f,"client"),i.join(f,"update")])r.mkdirSync(e,{recursive:!0})}function Q(){return new Date().toISOString().slice(0,10)}function M(e){return i.join(f,e,`${Q()}.log`)}function o(e,t){let n=`${new Date().toISOString()} [${e}] ${t}
-`;r.appendFile(M(e),n,()=>{}),e==="daemon"&&process.stdout.write(n)}function z(e){try{return JSON.parse(r.readFileSync(e,"utf8"))}catch{return null}}function Z(e,t){r.mkdirSync(i.dirname(e),{recursive:!0}),r.writeFileSync(e,JSON.stringify(t,null,2),"utf8")}function ee(e){try{r.unlinkSync(e)}catch{}}function w(e,t){if(t)try{r.readFileSync(e,"utf8").trim()===String(t)&&r.unlinkSync(e)}catch(n){n.code!=="ENOENT"&&o("daemon",`pid cleanup failed file=${e} error=${n.message}`)}}function O(){let e=z(i.join(E,"manifest.json"));if(typeof e?.version=="string"&&e.version.trim())return e.version.trim();try{return i.basename(r.realpathSync(E))}catch{return process.env.APP_VERSION||"unknown"}}function ne(){let e=process.env.HEADLESS_DEVICE_CREDENTIAL_PATH||process.env.SIBOOT_DEVICE_CREDENTIAL_PATH;if(e&&e.trim())return i.resolve(e.trim());let t=process.env.HEADLESS_DATA_DIR||process.env.SIBOOT_DATA_DIR||i.join(b.homedir(),".siboot");return i.join(t,"headless-device-credential.json")}function te(){try{return r.existsSync(ne())}catch{return!1}}function l(e={}){Z(G,{pid:process.pid,client_pid:s?.pid||null,updater_pid:d?.pid||null,client_ready:T,client_ready_at:D,client_version:y,client_lock_conflict_count:p,client_retry_at:g,client_start_count:L,updater_start_count:v,version:O(),current_dir:E,state:u?"stopping":p>0?"client_lock_conflict":"running",started_at:W,updated_at:new Date().toISOString(),...e})}function ie(e,t){let n=c=>{let a=Buffer.from(c);r.appendFile(M(t),a,()=>{})};e.stdout?.on("data",n),e.stderr?.on("data",n)}function P(){if(!Number.isFinite(A)||A<=0)return;let e=Date.now();for(let t of["daemon","client","update"]){let n=i.join(f,t);if(r.existsSync(n))for(let c of r.readdirSync(n)){let a=i.join(n,c),R=null;try{R=r.statSync(a)}catch{continue}if(!R.isFile())continue;e-R.mtimeMs>A*24*60*60*1e3&&ee(a)}}}function C(){if(u||s)return;if(!r.existsSync(I)){o("daemon",`client entry missing entry=${I}`),l({state:"client_entry_missing"}),setTimeout(C,k).unref?.();return}L+=1,T=!1,D=null,y=O(),g=null;let e={...process.env,APP_VERSION:y,CLIENT_TYPE:process.env.CLIENT_TYPE||"anydev",SIBOOT_BASE_DIR:_,SIBOOT_CURRENT_DIR:E,SIBOOT_RUN_DIR:S,SIBOOT_LOG_DIR:f};te()&&(delete e.HEADLESS_DEVICE_TOKEN,delete process.env.HEADLESS_DEVICE_TOKEN),o("daemon",`starting client entry=${I} cwd=${N} version=${O()} start_count=${L}`),s=B(process.execPath,[I],{cwd:N,env:e,stdio:["ignore","pipe","pipe","ipc"]});let t=s;r.writeFileSync(h,String(s.pid)),ie(s,"client"),l(),s.on("message",n=>{n?.type!=="headless-client-ready"||s!==t||(p>0&&o("daemon",`client lock recovered conflicts=${p} pid=${t.pid}`),p=0,T=!0,D=new Date().toISOString(),l(),o("daemon",`client ready pid=${s?.pid||""}`))}),s.on("error",n=>{o("daemon",`client spawn error error=${n.message}`)}),s.on("exit",(n,c)=>{o("daemon",`client exited pid=${s?.pid||""} code=${n} signal=${c}`),s=null,T=!1,D=null,y=null,w(h,t.pid);let a=re(n);g=u?null:new Date(Date.now()+a).toISOString(),l({client_exit_code:n,client_exit_signal:c}),u||setTimeout(C,a).unref?.()})}function re(e){return e!==Y?k:(p+=1,p===1&&o("daemon","client lock conflict; retrying with bounded backoff"),Math.min(H*2**Math.min(p-1,3),K))}function U(){if(u||d||process.env.ANYDEV_UPDATE_ENABLED==="0")return;if(!r.existsSync(m)){o("daemon",`updater entry missing entry=${m}`);return}v+=1,o("daemon",`starting updater entry=${m} start_count=${v}`),d=B(process.execPath,[m],{cwd:_,env:{...process.env,CLIENT_TYPE:"anydev",SIBOOT_BASE_DIR:_,SIBOOT_CURRENT_DIR:E,SIBOOT_RUN_DIR:S,SIBOOT_LOG_DIR:f},stdio:["ignore","inherit","inherit"]});let e=d;r.writeFileSync($,String(d.pid)),l(),d.on("error",t=>{o("daemon",`updater spawn error error=${t.message}`)}),d.on("exit",(t,n)=>{o("daemon",`updater exited pid=${d?.pid||""} code=${t} signal=${n}`),d=null,w($,e.pid),l({updater_exit_code:t,updater_exit_signal:n}),u||setTimeout(U,J).unref?.()})}function j(e,t){return e?.pid?(o("daemon",`stopping ${t} pid=${e.pid}`),new Promise(n=>{let c=!1,a=()=>{c||(c=!0,n())};e.once("exit",a);try{e.kill("SIGTERM")}catch{a();return}setTimeout(()=>{if(!c){try{e.kill("SIGKILL")}catch{}a()}},5e3).unref?.()})):Promise.resolve()}async function x(e){u||(u=!0,o("daemon",`shutdown signal=${e}`),l({state:"stopping",signal:e}),await Promise.all([j(d,"updater"),j(s,"client")]),w(F,process.pid),l({state:"stopped",signal:e}),process.exit(0))}async function oe(){await X(),q(),r.writeFileSync(F,String(process.pid)),process.on("SIGTERM",()=>{x("SIGTERM")}),process.on("SIGINT",()=>{x("SIGINT")}),o("daemon",`started base=${_} version=${O()}`),l({state:"starting"}),P(),C(),U(),setInterval(P,3600*1e3)}oe().catch(e=>{let t=e.code==="EADDRINUSE";process.stderr.write(`[daemon] ${t?"another daemon is already running":e.message}
-`),process.exit(t?Y:1)});
+import o from"fs";import W from"net";import q from"os";import r from"path";import{spawn as h}from"child_process";var l=process.env.SIBOOT_BASE_DIR,_=r.join(l,"current"),N=process.env.WORKSPACE||"/data/siboot/workspace",f=r.join(l,"run"),p=r.join(l,"logs"),m=r.join(_,"entry.mjs"),A=r.join(l,"electron-headless-host"),B=r.join(l,"scripts","fetch-electron-headless-host.sh"),O=r.join(l,"scripts","updater.mjs"),F=r.join(f,"daemon.pid"),H=r.join(f,"node.pid"),b=r.join(f,"updater.pid"),Q=r.join(f,"status.json"),k=73,z=5e3,Z=3e4,V=Number.parseInt(process.env.ANYDEV_CLIENT_RESTART_DELAY_MS||"1000",10),ee=Number.parseInt(process.env.ANYDEV_UPDATER_RESTART_DELAY_MS||"10000",10),L=Number.parseInt(process.env.ANYDEV_LOG_RETENTION_DAYS||"4",10),a=null,u=null,T=null,E=!1,w=0,g=0,R=!1,D=null,y=null,S=0,P=null,ne=new Date().toISOString();async function te(){let e=W.createServer(t=>t.destroy()),n=process.platform==="linux"?{path:"\0siboot-anydev-daemon-v1"}:{host:"127.0.0.1",port:43880,exclusive:!0};await new Promise((t,s)=>{e.once("error",s),e.listen(n,()=>{e.removeListener("error",s),t()})})}function re(){for(let e of[f,N,r.join(p,"daemon"),r.join(p,"client"),r.join(p,"update")])o.mkdirSync(e,{recursive:!0})}function oe(){return new Date().toISOString().slice(0,10)}function G(e){return r.join(p,e,`${oe()}.log`)}function i(e,n){let t=`${new Date().toISOString()} [${e}] ${n}
+`;o.appendFile(G(e),t,()=>{}),e==="daemon"&&process.stdout.write(t)}function K(e){try{return JSON.parse(o.readFileSync(e,"utf8"))}catch{return null}}function ie(e,n){o.mkdirSync(r.dirname(e),{recursive:!0}),o.writeFileSync(e,JSON.stringify(n,null,2),"utf8")}function se(e){try{o.unlinkSync(e)}catch{}}function $(e,n){if(n)try{o.readFileSync(e,"utf8").trim()===String(n)&&o.unlinkSync(e)}catch(t){t.code!=="ENOENT"&&i("daemon",`pid cleanup failed file=${e} error=${t.message}`)}}function I(){let e=K(r.join(_,"manifest.json"));if(typeof e?.version=="string"&&e.version.trim())return e.version.trim();try{return r.basename(o.realpathSync(_))}catch{return process.env.APP_VERSION||"unknown"}}function ce(){let e=process.env.HEADLESS_DEVICE_CREDENTIAL_PATH||process.env.SIBOOT_DEVICE_CREDENTIAL_PATH;if(e&&e.trim())return r.resolve(e.trim());let n=process.env.HEADLESS_DATA_DIR||process.env.SIBOOT_DATA_DIR||r.join(q.homedir(),".siboot");return r.join(n,"headless-device-credential.json")}function ae(){try{return o.existsSync(ce())}catch{return!1}}function d(e={}){ie(Q,{pid:process.pid,client_pid:a?.pid||null,updater_pid:u?.pid||null,client_ready:R,client_ready_at:D,client_version:y,client_lock_conflict_count:S,client_retry_at:P,client_start_count:w,updater_start_count:g,version:I(),current_dir:_,state:E?"stopping":S>0?"client_lock_conflict":"running",started_at:ne,updated_at:new Date().toISOString(),...e})}function x(e,n){let t=s=>{let c=Buffer.from(s);o.appendFile(G(n),c,()=>{})};e.stdout?.on("data",t),e.stderr?.on("data",t)}function U(){if(!Number.isFinite(L)||L<=0)return;let e=Date.now();for(let n of["daemon","client","update"]){let t=r.join(p,n);if(o.existsSync(t))for(let s of o.readdirSync(t)){let c=r.join(t,s),C=null;try{C=o.statSync(c)}catch{continue}if(!C.isFile())continue;e-C.mtimeMs>L*24*60*60*1e3&&se(c)}}}function J(){let e=r.join(A,"electron-headless-host"),n=o.existsSync(r.join(e,"electron-host-app","main","entry.js"))?e:_,t=r.join(n,"electron-host-app","main","entry.js"),s=r.join(n,"patches","electron","v32.3.3","runtime.json"),c={CU_ELECTRON_RUNTIME_CACHE:process.env.CU_ELECTRON_RUNTIME_CACHE||r.join(l,"electron-runtime"),HEADLESS:process.env.HEADLESS||"true"};return process.platform==="linux"&&(process.getuid?.()===0||process.env.ELECTRON_NO_SANDBOX==="1")&&(c.ELECTRON_NO_SANDBOX="1"),o.existsSync(s)&&(c.CU_APP_DESKTOP_ROOT=n),o.existsSync(t)&&(c.ELECTRON_HEADLESS_APP_PATH=t),c}function le(){let e=K(r.join(_,"manifest.json"));return String(process.env.ELECTRON_HOST_CDN_BASE||e?.electron_host_cdn_base||"").trim()}function M(){return o.existsSync(r.join(A,"electron-headless-host","electron-host-app","main","entry.js"))&&o.existsSync(r.join(A,"electron-headless-host","patches","electron","v32.3.3","runtime.json"))}async function ue(){if(M())return!0;let e=le();return!e||!o.existsSync(B)?(i("daemon","electron host bundle is not configured; browser tools may be unavailable"),!1):(i("daemon",`downloading electron host bundle base=${e}`),await new Promise((n,t)=>{let s=h("bash",[B],{env:{...process.env,ELECTRON_HOST_CDN_BASE:e,ELECTRON_HOST_FETCH_DIR:A},stdio:["ignore","pipe","pipe"]});x(s,"electron-host"),s.once("error",t),s.once("exit",c=>{c===0?n():t(new Error(`electron host bundle fetch exited with code=${c}`))})}),M())}function de(e){T||process.env.HEADLESS_PREWARM_ELECTRON_RUNTIME==="0"||!o.existsSync(m)||!e.ELECTRON_HEADLESS_APP_PATH||e.CU_APP_DESKTOP_ROOT&&(i("daemon",`prewarming patched electron runtime entry=${m}`),T=h(process.execPath,[m,"--prewarm-electron-runtime"],{cwd:N,env:e,stdio:["ignore","pipe","pipe"]}),x(T,"client"),T.on("exit",(n,t)=>{i("daemon",`electron runtime prewarm exited code=${n} signal=${t}`),T=null}))}function j(){if(E||a)return;if(!o.existsSync(m)){i("daemon",`client entry missing entry=${m}`),d({state:"client_entry_missing"}),setTimeout(j,V).unref?.();return}w+=1,R=!1,D=null,y=I(),P=null;let e={...process.env,...J(),APP_VERSION:y,CLIENT_TYPE:process.env.CLIENT_TYPE||"anydev",SIBOOT_BASE_DIR:l,SIBOOT_CURRENT_DIR:_,SIBOOT_RUN_DIR:f,SIBOOT_LOG_DIR:p};ae()&&(delete e.HEADLESS_DEVICE_TOKEN,delete process.env.HEADLESS_DEVICE_TOKEN),i("daemon",`starting client entry=${m} cwd=${N} version=${I()} start_count=${w}`),a=h(process.execPath,[m],{cwd:N,env:e,stdio:["ignore","pipe","pipe","ipc"]});let n=a;o.writeFileSync(H,String(a.pid)),x(a,"client"),d(),a.on("message",t=>{t?.type!=="headless-client-ready"||a!==n||(S>0&&i("daemon",`client lock recovered conflicts=${S} pid=${n.pid}`),S=0,R=!0,D=new Date().toISOString(),d(),i("daemon",`client ready pid=${a?.pid||""}`))}),a.on("error",t=>{i("daemon",`client spawn error error=${t.message}`)}),a.on("exit",(t,s)=>{i("daemon",`client exited pid=${a?.pid||""} code=${t} signal=${s}`),a=null,R=!1,D=null,y=null,$(H,n.pid);let c=_e(t);P=E?null:new Date(Date.now()+c).toISOString(),d({client_exit_code:t,client_exit_signal:s}),E||setTimeout(j,c).unref?.()})}function _e(e){return e!==k?V:(S+=1,S===1&&i("daemon","client lock conflict; retrying with bounded backoff"),Math.min(z*2**Math.min(S-1,3),Z))}function X(){if(E||u||process.env.ANYDEV_UPDATE_ENABLED==="0")return;if(!o.existsSync(O)){i("daemon",`updater entry missing entry=${O}`);return}g+=1,i("daemon",`starting updater entry=${O} start_count=${g}`),u=h(process.execPath,[O],{cwd:l,env:{...process.env,CLIENT_TYPE:"anydev",SIBOOT_BASE_DIR:l,SIBOOT_CURRENT_DIR:_,SIBOOT_RUN_DIR:f,SIBOOT_LOG_DIR:p},stdio:["ignore","inherit","inherit"]});let e=u;o.writeFileSync(b,String(u.pid)),d(),u.on("error",n=>{i("daemon",`updater spawn error error=${n.message}`)}),u.on("exit",(n,t)=>{i("daemon",`updater exited pid=${u?.pid||""} code=${n} signal=${t}`),u=null,$(b,e.pid),d({updater_exit_code:n,updater_exit_signal:t}),E||setTimeout(X,ee).unref?.()})}function v(e,n){return e?.pid?(i("daemon",`stopping ${n} pid=${e.pid}`),new Promise(t=>{let s=!1,c=()=>{s||(s=!0,t())};e.once("exit",c);try{e.kill("SIGTERM")}catch{c();return}setTimeout(()=>{if(!s){try{e.kill("SIGKILL")}catch{}c()}},5e3).unref?.()})):Promise.resolve()}async function Y(e){E||(E=!0,i("daemon",`shutdown signal=${e}`),d({state:"stopping",signal:e}),await Promise.all([v(u,"updater"),v(a,"client"),v(T,"electron-runtime-prewarm")]),$(F,process.pid),d({state:"stopped",signal:e}),process.exit(0))}async function pe(){await te(),re(),o.writeFileSync(F,String(process.pid)),process.on("SIGTERM",()=>{Y("SIGTERM")}),process.on("SIGINT",()=>{Y("SIGINT")}),i("daemon",`started base=${l} version=${I()}`),d({state:"starting"}),U();try{await ue()||i("daemon","electron host bundle is not ready; continuing without browser host")}catch(n){i("daemon",`electron host bundle fetch failed: ${n.message}`)}let e={...process.env,...J(),APP_VERSION:I(),CLIENT_TYPE:process.env.CLIENT_TYPE||"anydev",SIBOOT_BASE_DIR:l,SIBOOT_CURRENT_DIR:_,SIBOOT_RUN_DIR:f,SIBOOT_LOG_DIR:p};de(e),j(),X(),setInterval(U,3600*1e3)}pe().catch(e=>{let n=e.code==="EADDRINUSE";process.stderr.write(`[daemon] ${n?"another daemon is already running":e.message}
+`),process.exit(n?k:1)});