# 椤圭洰閿欓鏈? ## 2026-07-22 鈥?鎻掍欢 iframe 璧勬簮浠ょ墝瀵艰嚧椤甸潰绌虹櫧 - 闃舵锛氶儴缃?/ 鍔熻兘琛屼负 - 绫诲瀷锛氱幆澧?/ 鏋勫缓 / 鍔熻兘琛屼负 - 鐜拌薄锛氬湪 AstrBot 鎻掍欢椤靛仠鐣欎竴娈垫椂闂村悗锛岀偣鍑荤礌鏉愩€佽鑹层€佸浘搴撱€佽缃垨鏃ュ織锛屼富澹充粛鍦ㄤ絾椤甸潰鍐呭鍖哄煙娑堝け銆?- 鏍瑰洜锛氭彃浠堕〉杩愯鍦?sandbox iframe 涓紝涓€绾ч〉闈娇鐢ㄥ姩鎬佸垎鐗囧姞杞斤紱瀹夸富鍙戞斁鐨勮祫婧愪护鐗屾湁鏁堟湡杈冪煭锛屽垏椤垫椂 CSS/JS 鍒嗙墖璇锋眰鍙兘澶辨晥銆傞敊璇姞杞芥病鏈夌ǔ瀹氱殑椤甸潰绾у厹搴曪紝涓斾竴娆¢敊璇鐞嗗皾璇曡鍙?sandbox 绂佹璁块棶鐨?sessionStorage锛岃Е鍙?SecurityError銆?- 淇鎴栬閬匡細灏嗙礌鏉愩€佽鑹层€佸浘搴撱€佽缃€佹棩蹇椾簲涓竴绾ч〉闈㈡敼涓轰富鍖呭悓姝ュ姞杞斤紱淇濈暀宸ヤ綔娴佹绾х粍浠舵寜闇€鍔犺浇锛涘绱犳潗鍒嗙被鍜屾爣绛惧瓧娈靛鍔犲紓甯告暟鎹厹搴曘€?- 棰勯槻瑙勫垯锛欰strBot 鎻掍欢 iframe 涓笉瑕佹妸鏍稿績涓€绾ц矾鐢变緷璧栫煭鏃朵护鐗岀殑鍔ㄦ€佸垎鐗囷紱娴忚鍣ㄥ瓨鍌ㄨ闂繀椤诲寘鍦?try/catch 涓紝涓嶈兘璁╁彲閫夊亸濂介樆鏂〉闈㈡覆鏌撱€?- 楠岃瘉璇佹嵁锛氬墠绔被鍨嬫鏌ラ€氳繃锛涘墠绔绾︽祴璇?26/26 閫氳繃锛涙彃浠堕〉鍜岀嫭绔?Web 鐢熶骇鏋勫缓閫氳繃锛汵AS `astrbot-ops-pro` 閲嶅惎鍚庡叆鍙e垏鎹㈠埌鍚屾涓诲寘骞朵繚鐣?`plugin_data`銆? ## 2026-07-22 鈥?Windows 鍙戝竷鍖呬笉鑳戒娇鐢?zip 鍙嶅悜瑙e帇閮ㄧ讲 - 闃舵锛氶儴缃?- 绫诲瀷锛氱幆澧?/ 閮ㄧ讲 - 鐜拌薄锛歐indows `Compress-Archive` 鐢熸垚鐨?ZIP 鍦?NAS `unzip` 鏃跺嚭鐜板弽鏂滄潬璺緞璀﹀憡锛屾棤娉曚綔涓哄彲闈犳彃浠?staging 鍖呫€?- 鏍瑰洜锛歐indows ZIP 宸ュ叿鍐欏叆鐨勮矾寰勫垎闅旂涓?NAS 瑙e帇宸ュ叿鍏煎鎬т笉绋冲畾锛屼笖 NAS SSH 绂佺敤浜?SFTP锛屼笉鑳戒緷璧?scp 涓婁紶銆?- 淇鎴栬閬匡細鏀圭敤鏈湴 `tar.gz`锛岄€氳繃 SSH 鏍囧噯杈撳叆娴佷笂浼犲埌 NAS锛涘湪 NAS 涓存椂 staging 瑙e帇鍚庯紝浠呰鐩栨彃浠舵簮鐮佺洰褰曪紝涓嶈Е纰?`data/plugin_data`銆?- 棰勯槻瑙勫垯锛歂AS 閮ㄧ讲浼樺厛浣跨敤 `tar.gz + SSH cat`锛涢儴缃插墠鎵ц鍘嬬缉鍖呭垪琛ㄥ拰鍏抽敭鍏ュ彛鏂囦欢妫€鏌ワ紝瑕嗙洊鍓嶅垱寤?`plugin_backups` 澶囦唤銆?- 楠岃瘉璇佹嵁锛歂AS staging 鍙甯歌В鍘嬶紱`pages/imagestudio/index.html` 鎸囧悜鏂颁富鍖咃紱瀹瑰櫒閲嶅惎鍚?ImageStudio 閲嶆柊鍔犺浇銆? ## 2026-07-22 鈥?鎻掍欢鐩綍涓嶈兘閫掑綊鍒犻櫎缂撳瓨鏂囦欢 - 闃舵锛氶儴缃?- 绫诲瀷锛氱幆澧?/ 閮ㄧ讲 - 鐜拌薄锛氫互 `agent` 鐢ㄦ埛鏁翠綋鍒犻櫎 NAS 鎻掍欢鐩綍鏃讹紝瀹瑰櫒鐢熸垚鐨?`__pycache__/*.pyc` 鏂囦欢鍑虹幇鏉冮檺鎷掔粷銆?- 鏍瑰洜锛氶儴鍒嗚繍琛屾椂缂撳瓨鐢卞鍣?root 鐢ㄦ埛鍒涘缓锛屽涓?SSH 鐢ㄦ埛鏃犳潈鍒犻櫎锛涚洿鎺?`rm -rf` 浼氫腑鏂浛鎹㈡祦绋嬨€?- 淇鎴栬閬匡細淇濈暀鎻掍欢鐩綍骞朵娇鐢?staging 鍐呭瑕嗙洊锛涢儴缃插墠澶囦唤鏃ф彃浠剁洰褰曪紝閬垮厤鍒犻櫎杩愯鏃剁紦瀛樺拰鏁版嵁鐩綍銆?- 棰勯槻瑙勫垯锛氫笉瑕佸 NAS 鎻掍欢鐩綍鐩存帴 `rm -rf`锛涗娇鐢ㄦ潈闄愬彲琛岀殑瑕嗙洊寮忛儴缃诧紝蹇呰鏃惰瀹瑰櫒鍋滄鍚庣敱鍏峰鏉冮檺鐨勭淮鎶ゆ祦绋嬫竻鐞嗙紦瀛樸€?- 楠岃瘉璇佹嵁锛氳鐩栧紡閮ㄧ讲鎴愬姛锛屽鍣ㄩ噸鍚悗鎻掍欢姝e父鍔犺浇锛屾暟鎹簱鍜?`plugin_data` 鏈垹闄ゃ€? ## 2026-07-22 鈥?鍦ㄧ嚎鎭㈠涓嶈兘鐩存帴瑕嗙洊娲诲姩 SQLite 涓庡獟浣撶洰褰? - 闃舵锛氬彂甯冨墠鏈€缁堝璁?- 绫诲瀷锛氶儴缃?/ 鏁版嵁瀹夊叏 / 骞跺彂 - 鐜拌薄锛氬浠芥仮澶嶆帴鍙e彲鍦ㄦ彃浠舵甯歌繍琛屻€亀orker 鍜岃姹備粛鍙兘鍐欏簱鏃讹紝鐩存帴瑕嗙洊閰嶇疆涓?SQLite 鏂囦欢锛屽苟鎶婂獟浣撶洰褰曞悎骞跺埌鐜版湁鐩綍銆?- 鏍瑰洜锛氭仮澶嶆祦绋嬫病鏈夌淮鎶ゆā寮忋€佸啓鍏ラ殧绂汇€佸悓鐩?staging銆佸師瀛愬垏鎹㈠拰鍏ㄩ摼璺け璐ュ洖婊氾紝鎶婂涓湁鐘舵€佽祫婧愬綋鎴愭櫘閫氭枃浠堕€愪釜澶嶅埗銆?- 淇鎴栬閬匡細淇鍓嶇鐢ㄧ敓浜х幆澧冨湪绾挎仮澶嶏紱鎭㈠蹇呴』鍏堝仠姝㈠苟纭 worker 閫€鍑猴紝鎷掔粷鏂板啓鍏ワ紝瀹屾暣鎭㈠鍒?staging 骞舵牎楠屽悗鍘熷瓙鍒囨崲锛屽け璐ヨ嚜鍔ㄥ洖婊氥€?- 棰勯槻瑙勫垯锛氫换浣曟暟鎹簱銆侀厤缃拰濯掍綋鑱斿悎鎭㈠閮藉繀椤诲叿澶?quiesce銆乻taging銆乤tomic switch銆乺ollback 鍥涗釜闃舵锛屼笉鑳藉湪娲诲姩 SQLite 涓婃墽琛?`copy2`銆?- 楠岃瘉璇佹嵁锛氬璁″畾浣?`backend/services/data_backup_service.py` 鐨勬仮澶嶉摼璺紱鐜版湁娴嬭瘯闆嗘病鏈夊浠芥仮澶嶅苟鍙戝拰鏁呴殰娉ㄥ叆瑕嗙洊锛涘畬鏁村缓璁 `docs/final-release-audit-2026-07-22.md`銆? ## 2026-07-22 鈥?worker 瓒呮椂鍋滄鍚庝笉鑳戒涪寮冭繍琛屽疄渚? - 闃舵锛氬彂甯冨墠鏈€缁堝璁?- 绫诲瀷锛氬苟鍙?/ 鐢熷懡鍛ㄦ湡 / 鍔熻兘琛屼负 - 鐜拌薄锛氳繙绋?provider 璋冪敤瓒呰繃鍋滄绛夊緟鏃堕棿鏃讹紝`stop()` 鍙繑鍥炰粛鍦ㄨ繍琛岋紝浣嗘彃浠?`terminate()` 浠嶆竻绌?runtime 寮曠敤骞跺厑璁稿悗缁疄渚嬪惎鍔ㄦ柊 worker銆?- 鏍瑰洜锛歸orker 鍙湁鍋滄浜嬩欢锛屾棤娉曚腑鏂鍦ㄦ墽琛岀殑 handler锛涚粓姝㈤摼璺拷鐣?`running` 杩斿洖鍊硷紝娌℃湁鍙屽疄渚嬫爡鏍忓拰鏅氬埌缁撴灉淇濇姢銆?- 淇鎴栬閬匡細provider 璋冪敤蹇呴』鏈夊彲鎺?timeout/cancel锛涚粺涓€骞挎挱鍋滄骞剁‘璁ゅ叏閮ㄧ嚎绋嬮€€鍑猴紱浠嶅瓨娲绘椂闃绘閲嶆柊鍚姩 worker骞朵繚鐣?runtime 寮曠敤锛涚粓鎬佹洿鏂颁娇鐢ㄧ姸鎬佹潯浠朵繚鎶ゃ€?- 棰勯槻瑙勫垯锛氱敓鍛藉懆鏈熺粨鏉熷彧鏈夊湪鎵€鏈夊悗鍙版墽琛屽櫒纭鍋滄鍚庢墠鑳芥姤鍛婃垚鍔燂紱绂佹鈥渟top 瓒呮椂浣嗙户缁嵏杞解€濄€?- 楠岃瘉璇佹嵁锛氬璁″畾浣?`backend/services/worker_service.py` 鍜?`main.py`锛涚幇鏈?worker 娴嬭瘯鍙鐩栧彲鍙婃椂閫€鍑哄満鏅紝娌℃湁闃诲 handler 鐑噸杞芥祴璇曘€? ## 2026-07-22 鈥?鏈€缁堝璁¢獙璇佷笌娴嬭瘯涓存椂鐩綍闄烽槺 - 闃舵锛氬彂甯冨墠鏈€缁堝璁?- 绫诲瀷锛氭祴璇?/ 鐜 - 鐜拌薄锛氬鐢ㄥ浐瀹氫粨搴撳唴 `--basetemp` 杩愯鍏ㄥ娴嬭瘯鏃朵袱娆¤秴鏃朵笖娈嬬暀 pytest 杩涚▼锛涗笉鎸囧畾 basetemp 鍚庡叏濂楁甯稿畬鎴愩€?- 鏍瑰洜锛歐indows 鐜涓嬪浐瀹氫复鏃剁洰褰曚笌娈嬬暀娴嬭瘯杩涚▼/鏃х洰褰曠姸鎬佺浉浜掑奖鍝嶏紝涓斿畨闈欐ā寮忓湪闀挎祴璇曟湡闂寸己灏戣繘搴﹁緭鍑猴紝瀹规槗璇垽涓轰唬鐮佹閿併€?- 淇鎴栬閬匡細缁堟鏈疆娈嬬暀 pytest 杩涚▼锛屾敼鐢?pytest 榛樿鍞竴涓存椂鐩綍锛涘鎱㈡枃浠跺崟鐙獙璇佸悗閲嶈窇鍏ㄥ銆?- 棰勯槻瑙勫垯锛欳I 涓烘瘡娆¤繍琛岀敓鎴愬敮涓€ basetemp锛屽苟璁剧疆鍏ㄥ眬 timeout 鍜岃繘搴﹁緭鍑猴紱娴嬭瘯瓒呮椂鏃跺厛鏌ユ畫鐣欒繘绋嬪拰鍗曟枃浠惰€楁椂锛屼笉瑕佺洿鎺ュ垽瀹氫笟鍔℃閿併€?- 楠岃瘉璇佹嵁锛歚test_advanced_style_set_workflow.py` 46 passed in 31.39s锛涙渶缁?`python -m pytest -q` 260 passed in 178.03s锛涘墠绔?26 椤瑰绾︺€乼ypecheck 鍜屽弻鏋勫缓鍧囬€氳繃銆? ## 2026-07-23 鈥?鍏徃鐢佃剳缁?ZeroTier 璁块棶鍚庣瓒呮椂 - 闃舵锛氱綉缁滄帓闅?- 绫诲瀷锛氱幆澧?/ 缃戠粶 / 鍔熻兘琛屼负 - 鐜拌薄锛氬鐢ㄧ數鑴戣闂?ImageStudio 姝e父锛屽叕鍙哥數鑴戠粡 ZeroTier 璁块棶鏃跺嚭鐜扳€滃悗绔繛鎺?timeout鈥濄€?- 鏍瑰洜锛氬綋鍓嶅皻鏈嬁鍒板叕鍙哥數鑴戠殑瀹為檯璇锋眰澶辫触鍖咃紱鐜版湁璇佹嵁鎺掗櫎鈥淣AS 绔彛鏈洃鍚€濆拰鈥滄彃浠惰繘绋嬪畬鍏ㄦ湭鍚姩鈥濓紝浼樺厛鎬€鐤戝叕鍙哥綉缁滃埌 ZeroTier 缃戞鐨勮矾鐢便€乑eroTier flow rule/鎴愬憳鎺堟潈銆乄indows 闃茬伀澧欐垨瀹為檯璁块棶绔彛涓嶄竴鑷淬€傚簲鐢ㄤ晶棣栧睆 bootstrap 鍙瓑寰?6 绉掞紝鎻掍欢 bridge GET 绛夊緟 15 绉掞紝閾捐矾鏈変涪鍖?涓户寤惰繜鏃朵細琚墠绔〃鐜颁负鍚庣瓒呮椂銆?- 淇鎴栬閬匡細鍏堝湪鍏徃鐢佃剳楠岃瘉 ZeroTier IP 鍒板疄闄呮槧灏勭鍙?`26385` 鐨?TCP 杩為€氭€э紝骞剁‘璁ゆ祻瑙堝櫒璁块棶鐨勫湴鍧€涓嶆槸鏃х鍙?`6185`锛涜嫢 TCP 涓嶉€氾紝鏀捐鍏徃鐢佃剳鍒?NAS ZeroTier 鍦板潃 `10.147.17.231` 鎴?`172.24.141.75` 鐨勫搴旂鍙e苟妫€鏌?ZeroTier 鎺堟潈/Flow Rules锛涜嫢 TCP 閫氫絾椤甸潰浠嶈秴鏃讹紝鍐嶆鏌ユ祻瑙堝櫒寮€鍙戣€呭伐鍏蜂腑 `ui/bootstrap` 鐨勮姹傘€佽璇佷細璇濆拰鍝嶅簲鑰楁椂銆?- 棰勯槻瑙勫垯锛氫笉瑕佸彧鐢ㄢ€滈〉闈㈣兘鎵撳紑鈥濆垽鏂悗绔摼璺甯革紱蹇呴』鍒嗗埆楠岃瘉闈欐€佸叆鍙c€乣ui/bootstrap` API銆佸疄闄呭鍣ㄦ槧灏勭鍙e拰 ZeroTier path銆傚尯鍒?TCP timeout銆丠TTP 401/403銆丆ORS 鍜屽簲鐢?6 绉?bootstrap timeout 鍚庡啀鏀逛唬鐮併€?- 楠岃瘉璇佹嵁锛歂AS 璺敱瀛樺湪 `10.147.17.0/24` 涓?`172.24.0.0/16` ZeroTier 缃戞锛沗26385/26395/26399` 鐩戝惉鍦?`0.0.0.0`锛汵AS 鏈満閫氳繃 `127.0.0.1`銆乣192.168.31.210`銆乣10.147.17.231`銆乣172.24.141.75` 璁块棶 `26385` 鍧囪繑鍥?HTTP 200锛涙彃浠舵棩蹇楀彲瑙佹甯稿姞杞斤紝浣嗗綋鍓?NAS 鏃ュ織鐗堟湰涓?`1.0.66`銆傞」鐩唬鐮佷腑 bootstrap timeout 涓?6 绉掞紝bridge GET timeout 涓?15 绉掋€?## 2026-07-23 鈥?瑙掕壊鍒犻櫎琚ず渚嬫潵婧愬垽鏂潤榛樻嫤鎴? - 闃舵锛氬姛鑳戒慨澶?- 绫诲瀷锛氬姛鑳借涓?/ API濂戠害 - 鐜拌薄锛氳鑹茶鎯呴〉鐐瑰嚮鈥滃垹闄も€濇棤纭寮圭獥銆佹棤璇锋眰銆侀〉闈㈣鑹蹭笉娑堝け銆?- 鏍瑰洜锛氬墠绔垹闄ゅ嚱鏁伴澶栧垽鏂?`profile.metadata.source === "sample"` 鍚庣洿鎺ヨ繑鍥烇紱璇ュ垽鏂病鏈夐敊璇彁绀猴紝涔熶笌鍚庣宸叉巿鏉冭鑹茶蒋鍒犻櫎鎺ュ彛鐨勮兘鍔涜竟鐣屼笉涓€鑷达紝瀵艰嚧鐢ㄦ埛鍙瑙掕壊琚潤榛樺綋浣滀笉鍙垹闄ょず渚嬪鐞嗐€?- 淇鎴栬閬匡細鍒犻櫎娴佺▼鍙繚鐣欒鑹插瓨鍦ㄣ€佹湭澶勪簬鍒犻櫎涓拰鍚庣鍐欐潈闄愭鏌ワ紱绉婚櫎鍒犻櫎涓撶敤鐨?`sample` 闈欓粯鎷︽埅銆傜ず渚嬭鑹茬殑鐢熸垚銆佸伐浣滄祦鍜岀礌鏉愮紪杈戦檺鍒朵繚鎸佷笉鍙樸€?- 棰勯槻瑙勫垯锛氬墠绔姝㈡搷浣滃繀椤绘湁鏄庣‘ UI 鐘舵€佹垨閿欒鎻愮ず锛涗笉瑕佸湪鍗曚釜鎿嶄綔涓鐢ㄤ笌鍏朵粬鎿嶄綔涓嶅悓鐨?`sample` 淇濇姢鏉′欢锛屽厛瀵圭収鍚庣璺敱鏉冮檺鍜岃祫婧愮敓鍛藉懆鏈熴€?- 楠岃瘉璇佹嵁锛氬凡淇敼 `frontend/standalone-web/src/App.vue:6241`锛涘墠绔?`vue-tsc --noEmit` 閫氳繃锛涘绾︽祴璇?26/26 閫氳繃锛沗git diff --check` 閫氳繃銆? ## 2026-07-23 鈥?NAS 閮ㄧ讲璺緞涓庡鍣ㄩ噸鍚竟鐣? - 闃舵锛氶儴缃?- 绫诲瀷锛氶儴缃?/ 鐜 - 鐜拌薄锛氶娆¢儴缃叉牎楠屽け璐ユ槸鎻掍欢鐩綍鎷煎啓閿欒锛涢殢鍚庡湪瀹瑰櫒鍐呮墽琛?`docker restart` 瀵艰嚧鎵ц shell 琚?`context canceled` 缁堟锛屾棫 staging 鐩綍鐭殏鐣欏湪鎻掍欢鎵弿鐩綍骞惰 AstrBot 褰撲綔绗簩涓彃浠跺姞杞姐€?- 鏍瑰洜锛氬疄闄呯洰褰曟槸 `astrbot_plugin_imagestudio`锛屼笉鏄?`astrabot_plugin_imagestudio`锛涘鍣ㄥ唴閲嶅惎鑷韩浼氱珛鍗虫潃鎺夊綋鍓?exec锛汚strBot 浼氭壂鎻?`data/plugins` 涓嬫墍鏈夌洰褰曪紝鏃х洰褰曚笉鑳界敤鏀瑰悕鏂瑰紡鐣欏湪閭i噷銆?- 淇鎴栬閬匡細鏀圭敤姝g‘鐩綍鍚嶏紱鏃х洰褰曠Щ鍏?`/AstrBot/data/plugin_backups`锛涢噸鍚繀椤荤敱 NAS 瀹夸富鏈烘墽琛岋紱閮ㄧ讲鍖呭厛鍋?SHA-256 鏍¢獙鍐嶆浛鎹€?- 棰勯槻瑙勫垯锛氶儴缃茶剼鏈繀椤诲厛楠岃瘉鐩爣鐩綍瀛樺湪锛涚姝㈠湪鐩爣瀹瑰櫒鍐呴儴閲嶅惎鑷韩锛涙彃浠舵棫鐗堟湰鍙厑璁告斁鍦?`plugin_backups`锛屼笉寰楃暀鍦?`data/plugins`銆?- 楠岃瘉璇佹嵁锛歂AS 瀹瑰櫒 `Up`锛涙棩蹇楀彧鍔犺浇涓€涓?`astrbot_plugin_imagestudio (1.0.66)`锛涙彃浠?metadata 涓?`1.0.66`锛沗frontend/standalone-web/src/App.vue:6241` 鍒犻櫎淇鏍囪瀛樺湪锛涘鍣ㄧ姸鎬佷负宸茬煡鐨?`health: starting`銆?## 2026-07-23 鈥?鎻掍欢妗ユ帴涓嶆敮鎸佽鑹插垹闄?DELETE - 闃舵锛氬姛鑳戒慨澶?- 绫诲瀷锛欰PI濂戠害 / 鍔熻兘琛屼负 - 鐜拌薄锛氳鑹茶鎯呴〉鍒犻櫎鎸夐挳浠嶆棤鏁堬紱鍓嶇鍦ㄦ彃浠?iframe 涓皟鐢?DELETE锛屼絾閮ㄥ垎 AstrBot Plugin Page bridge 鍙毚闇?`apiPost`锛岃姹傚洖閫€鍒版湭娉ㄥ唽鐨?method override 璺緞銆?- 鏍瑰洜锛氬悗绔彧娉ㄥ唽 `DELETE profiles/{profile_id}`锛屾病鏈夌粰妗ユ帴灞傛彁渚涚ǔ瀹氱殑 POST 鍒犻櫎鍏ュ彛锛汥ELETE 鑳藉姏鏄惁鏆撮湶鍙栧喅浜?AstrBot 鐗堟湰鍜岃繍琛屾椂 bridge 瀹炵幇銆?- 淇鎴栬閬匡細鏂板 `POST profiles/{profile_id}/delete`锛屽鐢ㄥ師鏈夋墍鏈夎€呮牎楠屻€佽蒋鍒犻櫎鍜屽璁¢€昏緫锛涘墠绔鑹插垹闄ょ粺涓€璋冪敤璇?POST 鍏ュ彛锛屼繚鐣欏師 DELETE 鎺ュ彛鍏煎澶栭儴璋冪敤銆?- 棰勯槻瑙勫垯锛氭彃浠?iframe 鍐呯殑鍐欐搷浣滀紭鍏堟彁渚涙槑纭殑 POST 鍔ㄤ綔璺敱锛涗笉鑳藉亣瀹?`apiPut`銆乣apiPatch` 鎴?`apiDelete` 鍦ㄦ墍鏈?AstrBot 鐗堟湰閮藉瓨鍦ㄣ€?- 楠岃瘉璇佹嵁锛氬垹闄?POST 璺敱鍥炲綊娴嬭瘯閫氳繃锛涘墠绔被鍨嬫鏌ラ€氳繃锛涙彃浠堕〉涓?standalone web 鏋勫缓閫氳繃銆? ## 2026-07-23 鈥?鎻掍欢 iframe 鍘熺敓纭妗嗗悶鎺夊垹闄ゅ姩浣? - 闃舵锛氬姛鑳戒慨澶? - 绫诲瀷锛氬姛鑳借涓?/ 鐜 - 鐜拌薄锛氬垹闄ゆ寜閽偣鍑诲悗娌℃湁鍚庣瀹¤璁板綍锛岄〉闈篃娌℃湁鍒犻櫎缁撴灉銆? - 鏍瑰洜锛氳鑹插垹闄ゆ祦绋嬩緷璧?window.confirm锛汚strBot 鎻掍欢 iframe 鐨勫師鐢熺‘璁ゆ鍦ㄩ儴鍒嗚繍琛屾椂鍙兘涓嶆樉绀烘垨鐩存帴杩斿洖鍙栨秷锛屽鑷村嚱鏁板湪璇锋眰鍓嶉潤榛橀€€鍑恒€? - 淇鎴栬閬匡細鍒犻櫎鎿嶄綔涓嶅啀渚濊禆鍘熺敓纭妗嗭紝鐩存帴璋冪敤宸叉湁 POST profiles/{profile_id}/archive 杞垹闄ゆ帴鍙o紱鍚庣浠嶄繚鐣欐潈闄愩€佹墍鏈夎€呭拰瀹¤鏍¢獙銆? - 棰勯槻瑙勫垯锛氭彃浠?iframe 涓笉瑕佹妸鍏抽敭涓氬姟鍔ㄤ綔渚濊禆鍦?window.alert/confirm/prompt 涓婏紱闇€瑕佺‘璁ゆ椂浣跨敤搴旂敤鍐呭璇濇锛屾垨璁╁姩浣滃叿澶囨槑纭殑鍗曞嚮璇箟銆? - 楠岃瘉璇佹嵁锛歂AS 瀹¤鏌ヨ纭姝ゅ墠娌℃湁 delete_profile 鎴?update_profile 璁板綍锛涘墠绔慨鏀瑰悗闇€閲嶆柊鏋勫缓骞堕獙璇?POST 璇锋眰銆? ## 2026-07-23 鈥?鏂囨湰瑙掕壊瀵煎叆鍏ュ彛钘忓湪闂嵎澶栧眰 - 闃舵锛氬姛鑳戒紭鍖? - 绫诲瀷锛氬姛鑳借涓?/ UI - 鐜拌薄锛氬垱寤鸿鑹查棶鍗烽噷娌℃湁鐩存帴涓婁紶鏂囨湰璇嗗埆鍏ュ彛锛岀敤鎴峰彧鑳藉厛閫€鍑洪棶鍗峰啀浠庤鑹查〉瀵绘壘澶栭儴瑙掕壊鍗″鍏ャ€? - 鏍瑰洜锛氭枃鏈鍏ュ姛鑳藉凡瀹炵幇锛屼絾鍏ュ彛鍙斁鍦ㄥ伐浣滃彴鍔ㄤ綔鍗★紝鏈笌闂嵎濉啓娴佺▼鐩搁偦銆? - 淇鎴栬閬匡細鍦ㄩ棶鍗锋爣棰樻爮澧炲姞鈥滃鍏ユ枃鏈瘑鍒€濇寜閽紝澶嶇敤鐜版湁 `.txt/.md/.markdown` 涓婁紶銆佺矘璐淬€佹ā鍨嬭瘑鍒拰闂嵎鍥炲~娴佺▼銆? - 棰勯槻瑙勫垯锛氫笌褰撳墠缂栬緫琛ㄥ崟寮虹浉鍏崇殑瀵煎叆鑳藉姏搴旀斁鍦ㄨ〃鍗曟爣棰樻垨棣栧睆鎿嶄綔鍖猴紝涓嶅簲鍙緷璧栧灞傚伐浣滄祦鍗$墖銆? - 楠岃瘉璇佹嵁锛氬墠绔被鍨嬫鏌ュ拰鐢熶骇鏋勫缓閫氳繃鍚庯紝闇€纭鎸夐挳鎵撳紑澶栭儴瑙掕壊鍗¤瘑鍒眰骞惰嚜鍔ㄥ洖濉棶鍗枫€? ## 2026-07-24 鈥?闂嵎鏍囬鏍忔寜閽€夋嫨鍣ㄨ鍖归厤 - 闃舵锛氬姛鑳戒慨澶?- 绫诲瀷锛氱紪鐮?/ UI - 鐜拌薄锛氭柊澧炩€滃鍏ユ枃鏈瘑鍒€濆悗锛屾寜閽枃瀛楃珫鎺掑苟涓庡叧闂寜閽敊浣嶏紝娌℃湁鍑虹幇鍦ㄦ爣棰樻爮鍙充笂瑙掋€?- 鏍瑰洜锛歚.persona-questionnaire-card header > div` 鍚屾椂鍖归厤鏍囬鍐呭瀹瑰櫒鍜屽彸渚ф搷浣滃鍣紝瑕嗙洊浜嗘搷浣滃鍣ㄥ師鏈殑 `flex` 甯冨眬銆?- 淇鎴栬閬匡細灏嗘爣棰樺唴瀹归€夋嫨鍣ㄦ敹绐勪负 `.persona-questionnaire-card header > div:first-child`锛屼繚鐣欐搷浣滃鍣ㄧ殑妯悜 `flex` 甯冨眬銆?- 棰勯槻瑙勫垯锛氭柊澧炲祵濂楀竷灞€瀹瑰櫒鏃堕伩鍏嶄娇鐢ㄨ繃瀹界殑缁撴瀯閫夋嫨鍣紝妫€鏌ュ悓绾ф搷浣滃尯鏄惁琚户鎵垮竷灞€瑙勫垯瑕嗙洊銆?- 楠岃瘉璇佹嵁锛歚npm.cmd run typecheck`銆乣npm.cmd run build`銆乣git diff --check` 閫氳繃锛涙彁浜?`2dbf90b` 宸叉帹閫侊紱NAS 瀹瑰櫒鍔犺浇 `astrbot_plugin_imagestudio (1.0.66)`锛岃繙绔簮鐮佸寘鍚敹绐勫悗鐨勯€夋嫨鍣紝鏃ф彃浠跺凡澶囦唤銆? ## 2026-07-24 鈥?瀵煎叆鎸夐挳搴斾綅浜庨棶鍗峰簳閮ㄦ搷浣滃尯 - 闃舵锛氬姛鑳戒慨澶?- 绫诲瀷锛氬姛鑳借涓?/ UI - 鐜拌薄锛氭寜閽鏀惧湪闂嵎鏍囬鏍忓叧闂寜閽梺杈癸紝涓旂獎瀹藉害涓嬧€滃鍏ユ枃鏈瘑鍒€濈珫鎺掞紱鐢ㄦ埛瀹為檯闇€瑕佸畠浣嶄簬搴曢儴鈥滅畝鍗曢棶鍗?/ 澶嶆潅闂嵎鈥濇寜閽乏渚с€?- 鏍瑰洜锛氶娆″疄鐜板彧渚濇嵁鏍囬鏍忚涔夋斁缃寜閽紝娌℃湁瀵圭収闂嵎搴曢儴鎿嶄綔鍖虹殑瑙嗚鏍囪锛涙寜閽己灏戜笉鎹㈣鍜屾渶灏忓搴︾害鏉熴€?- 淇鎴栬閬匡細绉婚櫎鏍囬鏍忓鍏ユ寜閽紝灏嗗叾鏀惧叆 `.persona-questionnaire-footer-actions`锛岄『搴忎负瀵煎叆銆侀棶鍗锋ā寮忋€佺敓鎴愭。妗堬紝骞跺鍔?`white-space: nowrap` 涓?`min-width`銆?- 棰勯槻瑙勫垯锛氭秹鍙婃埅鍥惧畾浣嶇殑 UI 淇敼蹇呴』浠ョ敤鎴锋爣璁扮殑瀹為檯瀹瑰櫒涓哄噯锛屽苟鍦ㄦ闈笌绐勫睆甯冨眬妫€鏌ユ寜閽枃瀛楁槸鍚︽崲琛屻€?- 楠岃瘉璇佹嵁锛歚npm.cmd run typecheck`銆乣npm.cmd run build`銆乣git diff --check` 閫氳繃锛涙彁浜?`878f1f6` 宸叉帹閫侊紱NAS 瀹瑰櫒鍔犺浇 `1.0.66`锛岃繙绔簮鐮佺‘璁ゅ鍏ユ寜閽綅浜?footer锛屾爣棰樻爮浠呬繚鐣欏叧闂寜閽€? ## 2026-07-23 鈥?瑙掕壊宸ヤ綔娴佺粺璁″尯鎸ゅ崰鎷嗚В绌洪棿 - 闃舵锛氬姛鑳戒紭鍖?- 绫诲瀷锛歎I / 鍔熻兘琛屼负 - 鐜拌薄锛氳鑹插伐浣滄祦椤堕儴鍥涗釜缁熻鍗$墖鍗犳嵁鍨傜洿绌洪棿锛屾媶瑙h瀹氬尯鍩熷亸灏忥紱鎷嗚В瀛楁鍙兘鏌ョ湅锛岃皟鏁磋瀹氶渶瑕佸洖鍒板墠缃〃鍗曘€?- 鏍瑰洜锛氬伐浣滄祦妯℃澘灏嗛€氱敤 `generateStatusCards` 鍥哄畾娓叉煋鍦ㄨ鑹插伐浣滄祦涓婃柟锛涙媶瑙h妭鐐瑰瓧娈垫病鏈夋彁渚涚紪杈戞€佸拰鎸佷箙鍖栧叆鍙c€?- 淇鎴栬閬匡細绉婚櫎瑙掕壊宸ヤ綔娴侀《閮ㄧ粺璁″崱鐗囷紝澧炲ぇ涓诲伐浣滃尯楂樺害锛涙媶瑙e瓧娈靛鍔犲唴鑱旂紪杈戙€佷繚瀛?鍙栨秷锛屽苟灏嗘。妗堝瓧娈靛啓鍥?profile metadata锛岃妭鐐瑰瓧娈靛啓鍥炲伐浣滄祦鑺傜偣銆?- 棰勯槻瑙勫垯锛氬伐浣滄祦涓绘搷浣滃尯浼樺厛淇濋殰鍐呭缂栬緫绌洪棿锛涘睍绀哄瀷缁熻鍗$墖涓嶈兘鎸ゅ帇鏍稿績鑺傜偣鍐呭锛涚紪杈?UI 蹇呴』鍚屾椂鏄庣‘淇濆瓨鐩爣鍜屽洖鍐欏绾︺€?- 楠岃瘉璇佹嵁锛歚npm.cmd run typecheck`銆乣npm.cmd run build`銆乣git diff --check` 閫氳繃锛涘綋鍓嶅伐浣滄爲宸叉墦鍖呴儴缃?NAS锛屽鍣ㄥ姞杞?`astrbot_plugin_imagestudio (1.0.66)`锛岃繙绔‘璁ょ粺璁″崱鐗囦笉鍐嶆覆鏌撲笖鎷嗚В瀛楁缂栬緫閫昏緫瀛樺湪銆? ## 2026-07-24 — 工作流素材绑定入口未区分规划节点 - 阶段:功能修复 - 类型:功能行为 / UI - 现象:角色工作流的“参考素材绑定”节点点击右侧“素材”操作后,无法稳定打开素材库。 - 根因:操作卡片只依赖通用 `nav/module` 回退路径,没有声明工作流专用动作;同时当前 `material_bind` 是 `reference_binding` 规划节点,不能误走仅支持详细图像生成节点的节点素材抽屉接口。 - 修复或规避:新增 `workflowMaterialLibrary` 动作,点击后复用快速角色已有的分类素材卡片弹层并自动定位到风格卡片;图像生成节点仍保留节点素材抽屉路径。 - 预防规则:工作流操作卡片必须声明语义动作;规划节点与图像生成节点的素材入口不能共用未校验的抽屉接口。 - 验证证据:入口改为快速角色式弹层;待执行 `npm.cmd run typecheck`、`npm.cmd run build` 和 `git diff --check`。 ## 2026-07-24 — 素材类别弹层被卡片裁剪 - 阶段:功能修复 - 类型:UI / 功能行为 - 现象:点击风格、构图、服装、鞋袜或配饰卡片后,类别选择逻辑已触发但用户看不到素材选项。 - 根因:`workflow-material-bind-card` 使用 `overflow: hidden`,绝对定位的快速角色式素材选择弹层被父卡片裁剪;卡片之间也没有为打开中的弹层提升层级。 - 修复或规避:卡片改为允许溢出,打开中的卡片提升 `z-index`,工作流弹层改为在卡片下方展开,直接复用现有类别选择与保存逻辑。 - 预防规则:新增绝对定位弹层时必须同时检查所有祖先的 overflow、滚动容器边界和相邻卡片层级。 - 验证证据:待执行前端类型检查、生产构建、差异检查及 NAS 重启后的实际资源校验。 ## 2026-07-24 — 工作流素材弹层被相邻卡片遮挡 - 阶段:功能修复 - 类型:UI / 功能行为 - 现象:类别弹层虽然打开,但显示在下一张卡片上方,素材选项主体不可见。 - 根因:弹层仍处于工作流网格和滚动容器的定位上下文中,绝对定位内容受到网格相邻项和滚动边界影响。 - 修复或规避:工作流专用素材弹层改为固定定位并居中显示,提升到独立层级,保留快速角色的类别筛选、清空、选择和新增逻辑。 - 预防规则:跨卡片选择器不要依赖网格项内的绝对定位;需要完整显示时使用独立浮层定位。 - 验证证据:待执行前端类型检查、生产构建、差异检查及 NAS 重启后的资源校验。 ## 2026-07-24 — 素材弹层需要按视口智能换向 - 阶段:功能修复 - 类型:UI / 响应式布局 - 现象:统一向上展开时,顶部类别卡片的素材弹层会被工作流标题区遮挡。 - 根因:弹层方向固定,没有根据当前卡片在视口中的上下剩余空间选择展开方向。 - 修复或规避:点击时测量当前卡片上下空间;顶部或下方空间更充足时向下展开,底部空间不足时向上展开,并分别处理左右列对齐。 - 预防规则:浮层定位不能只按固定方向,必须根据触发元素的视口位置和可用空间动态决定。 - 验证证据:待执行前端类型检查、生产构建、差异检查及 NAS 重启后的资源校验。 ## 2026-07-24 — 生成入队后预览区空白 - 阶段:功能修复 - 类型:UI / 功能行为 - 现象:点击工作流生成后,右侧提示已加入队列,但中央预览区立即回到“等待节点结果”,用户无法判断任务是否仍在处理。 - 根因:`workflowNodeActionExecuting` 只覆盖提交请求本身;入队接口返回后该状态立即清零,而后台图片仍需异步生成,预览模板没有节点级 pending 状态。 - 修复或规避:新增 `workflowPendingGenerationByNodeId`;普通节点和轮次节点入队时置 pending,真实图片加载或明确失败/终态时清除;预览区优先显示带动效的“正在生成”占位图。 - 预防规则:异步生成 UI 不要把“提交请求完成”当作“媒体结果完成”;必须将提交、队列处理、结果可用拆成独立状态,并为失败终态提供收口路径。 - 验证证据:待执行前端类型检查、生产构建、差异检查及 NAS 部署后的资源字符串核验。 ## 2026-07-24 — LLM 调整未自动进入下一轮 - 阶段:功能修复 - 类型:功能行为 / API契约 - 现象:轮次反馈接口只保存 LLM 调整,用户还必须点击“开始下一轮”;当前轮次没有自动封存,下一批候选不会自动生成。 - 根因:前端对话入口和现有 `rounds/{round_id}/feedback`、`rounds/{round_id}/next` 接口是串行断开的;手动入口另有一套调用路径。 - 修复或规避:LLM 调整成功识别到喜欢候选后复用现有反馈接口和下一轮接口自动创建子轮次;后端创建子轮次后将父轮次标记为 `superseded`,前端自动切换并开始轮询子轮次。 - 预防规则:手动下一轮和自然语言调整必须复用同一轮次创建接口;父轮次只有在子轮次创建成功后才封存,重复提交必须使用稳定幂等键。 - 验证证据:轮次回归测试断言父轮次为 `superseded`;前端类型检查和构建待执行。 ## 2026-07-24 ? Workflow avatar preview and detail panel layout - Phase: feature fix - Type: UI / behavior - Symptom: The headshot node had four generated images but the main preview was empty; the right detail panel consumed space and the LLM adjustment window was not near the main preview. - Root cause: The non-round preview pool applied a second workflow_id filter to node images, while older API payloads could omit or mismatch workflow_id; the LLM component was outside the three-column workspace. - Fix or workaround: Resolve the preview pool from the selected node image cache; remove the right detail panel and place workflow actions plus the node-bound LLM window inside the main preview. - Prevention rule: Node-level result display should rely on the node_id result set and not re-filter on optional workflow_id; workflow controls should remain in the same visible area as their preview. - Validation evidence: npm.cmd run typecheck and git diff --check passed; NAS asset verification follows after build. ## 2026-07-24 ? Workflow seven-node layout and plugin media fallback - Phase: frontend restructure - Type: UI / media behavior - Symptom: The deployed workflow still presented an unclear three-column layout, while generated images and the node-bound LLM were not visible in the expected regions. - Root cause: The workflow grouped several major stages together, the action/detail/composer regions were not expressed as a stable layout contract, and plugin-page image rendering returned an empty source while signed media Blob resolution was pending. - Fix or workaround: Define seven major workflow groups, render explicit node-flow/main-preview/action/LLM/info regions, retain signed URLs during Blob resolution, and bind non-round previews to the selected node cache. - Prevention rule: Treat workflow regions as a layout contract and test plugin-page media rendering separately from direct standalone rendering. - Validation evidence: vue-tsc typecheck passed; build and NAS deployment follow in this phase. ## 2026-07-24 — 工作流图片与旧节点详情残留 - 阶段:功能开发 / 部署 - 类型:功能行为 / 环境 - 现象:插件页仍可能显示旧三栏工作流;生成结果使用 storage:// 或仅有 image_uri 时,候选卡片和主预览为空。 - 根因:浏览器缓存旧构建资源;前端只解析签名 URL,没有把存储 URI 统一签名并通过插件桥接转 Blob。 - 修复或规避:工作流改为七大节点、主预览下方固定 LLM、右侧只保留操作;图片解析覆盖 URI/签名/Blob 三种路径。 - 预防规则:每次前端修改递增插件版本并强制刷新;图片组件必须同时覆盖 *_url 和 *_uri。 - 验证证据:本地 typecheck/build 通过;NAS 已切换 1.0.69,容器重启后日志确认插件加载,备份目录已创建。 ## 2026-07-24 — 插件页工作流断点与 storage 图片回退 - 阶段:前端修复 / 部署 - 类型:编码 / UI / 媒体行为 - 现象:NAS 插件 iframe 误触发 900px 单列断点,三栏工作区被挤成纵向;候选审查弹窗仍可能直接收到 storage://,图片空白。 - 根因:插件 iframe 的 CSS viewport 与物理窗口宽度不同;审查弹窗没有复用父组件的 storage URI 解析结果。 - 修复或规避:将三栏布局断点下移到 760px,固定 nodes/main/side 区域;为审查候选增加统一 displayMediaUrl 映射,并过滤不可直接渲染的 storage://。 - 预防规则:插件页必须按 iframe viewport 验证响应式断点;所有图片组件同时覆盖 *_url、*_uri 和 Blob 解析完成前的空状态。 - 验证证据:frontend typecheck/build 通过;待部署后确认 NAS 加载 1.0.70 与新资源 hash。 ## 2026-07-24 — 1.0.70 三栏修复未覆盖响应式规则 - 阶段:部署复核 - 类型:UI / 部署 - 现象:NAS 已加载新资源 hash,但工作流截图仍是节点流独占一整行,主预览和操作区被推到下方。 - 根因:1.0.70 只调整了中间断点,后续响应式规则仍可将 workflow-layout 改成单列或两列;节点、主列、侧列也没有在基础样式中明确绑定 grid-area。 - 修复或规避:1.0.71 在样式末尾强制三列和 nodes/main/side 区域绑定,窄屏仅压缩列宽,不再切换为单列。 - 预防规则:工作流布局覆盖规则必须放在所有通用响应式规则之后,并用真实插件 iframe viewport 验证,而不是只看桌面物理宽度。 - 验证证据:1.0.71 typecheck/build 通过;NAS metadata、HTML hash、CSS 构建资源和 AstrBot 加载日志均已确认。 ## 2026-07-24 — 头像预览回退与阶段硬约束 - 阶段:前端 / 后端算法 - 类型:功能行为 / API契约 - 现象:头像节点显示 4 个候选计数但主预览为空,LLM 只剩底部细条;图库中的头像批次被模型生成成设定图构图。 - 根因:round 候选池条件成立但详情没有候选时,旧节点图片候选池被隐藏;LLM 容器没有最小高度;头像节点只继承通用提示词,没有服务端阶段边界。 - 修复或规避:无有效 round 候选时回退节点图片;主列和 LLM 设置最小高度;服务端对 headshot 追加头像专属正负约束和 1:1 约束。 - 预防规则:工作流每个阶段必须有“round 候选→节点图片→空状态”的明确回退链;视觉阶段约束必须在服务端提示词快照中追加,不能只依赖前端。 - 验证证据:新增 prompt expansion 单测;待 typecheck、pytest、build 和 NAS 1.0.72 验证。 ## 2026-07-27 — Frozen ApiError breaks context-manager error handling - 阶段:阶段 2 正确性与发布收口 - 类型:API契约 / 编码 - 现象:在 `@contextmanager` 中抛出 `ApiError` 时,Python 尝试回写异常链字段,原始错误被 `FrozenInstanceError` 替换,调用方丢失错误码和消息。 - 根因:`ApiError` 被声明为 frozen dataclass;异常对象并不适合冻结,因为运行时需要维护异常上下文。 - 修复或规避:解除 `ApiError` 的 frozen 限制,并修复 `str(exc)` 的元组表示。 - 预防规则:异常类型不得声明为 frozen;新增异常类型时必须覆盖直接抛出和 context-manager 传播两条路径。 - 验证证据:后端全量测试通过;配置写入与路由错误封装回归测试通过。 ## 2026-07-27 — PostgreSQL placeholder refactor missed list path - 阶段:阶段 2 正确性与发布收口 - 类型:编码 / 测试 - 现象:PostgreSQL `%` 占位符修复遗漏 `list_profiles` 的绑定,运行时会触发 `NameError`;既有测试未断言 `list()` 成功,且请求包装层曾吞掉底层异常。 - 根因:批量脚本化改写只覆盖了主查询路径,测试只验证错误信封而未验证仓储成功返回。 - 修复或规避:补齐 `list_profiles` 绑定,新增直接成功路径测试及所有同类插值点扫描测试。 - 预防规则:批量数据库方言改写后,必须枚举每个 CRUD 入口并同时测试成功结果和异常传播;不可只测试统一错误外壳。 - 验证证据:新增 PostgreSQL 字面量与请求异常回归测试通过,后端全量测试通过。 ## 2026-07-27 — Release archive must name and package the same ref - 阶段:阶段 0 泄漏止血与发布收口 - 类型:发布 / 环境 - 现象:打包脚本按 `$REF` 归档,却可能以当前 dirty HEAD 的描述命名,导致包名和包内容无法一一对应。 - 根因:`git describe` 未接收 `$REF`,并允许从含未提交 tracked 改动的 HEAD 发包。 - 修复或规避:版本描述改为从 `$REF` 推导;默认 HEAD 有 tracked 改动时拒绝打包,要求先提交或传入显式 SHA/tag。 - 预防规则:发布产物必须由精确 commit 或 tag 构造;产物名、审计记录和部署 SHA 必须相同。 - 验证证据:`scripts/package_plugin.sh` 使用 `git archive` 打包指定 ref,并保留秘密路径和必需前端入口断言。 ## 2026-07-27 — Git archive entry separators differ on Windows - 阶段:阶段 0 泄漏止血与发布收口 - 类型:发布 / 环境 - 现象:Windows 上从 Git Bash 生成的 tar.gz 实际包含必需入口,但脚本用正斜杠精确匹配时误判 `metadata.yaml` 缺失并删除归档。 - 根因:Git for Windows 在归档条目中使用反斜杠,而脚本的安全和必需文件断言只识别正斜杠。 - 修复或规避:在所有归档路径断言前统一把反斜杠转换为正斜杠;同一规范同时覆盖秘密路径和必需入口。 - 预防规则:跨平台归档校验必须在比较前规范化路径分隔符,并在 Windows Git Bash 与 POSIX shell 各执行一次。 - 验证证据:`v1.0.73` 归档通过必需入口、秘密路径和 SHA-256 检查。