釋出：人在現場那一路的根目錄解析帶上文件記載的預設值 #23

2026-09-04T03:55:28Z

jiantw83 commented

2026-09-04 03:55:28 +00:00

摘要

需求描述：把 develop 累積的變更釋出到 master。deploy.sh clone 的是預設分支，沒進 master 的東西這台機器一輪都用不到。這一批只有一件事：人在現場那一路的根目錄解析帶上文件記載的預設值。
計畫名稱：無
計畫頁：無
分析頁：無

這一批的內容

技能只有一條路讓人在現場的叫用取得工具根目錄，而那一行讀的是一個沒設就展開成錯誤路徑的變數。旁邊那句話說它涵蓋了文件記載的家目錄退讓——殼並不知道那個變數的文件預設值是什麼，所以那個退讓從來沒有發生過。

解析式現在自己帶預設，退讓才真的成立。

版號 0.2.0 到 0.2.1。

為什麼要緊

這台機器從頭到尾沒設過那個變數，.bashrc 裡也沒有。所以每一次人在現場叫用，操作都停在第 0 步。

而且守衛開的藥方指錯方向：它報「根目錄不見了、去跑部署」，但根目錄好好的，連結農場十一條齊全。一條不能信的解析式，長得跟一個不存在的根目錄一模一樣。

排程那一路不受影響——條目自己帶著變數值，也自己帶著根目錄。

兩處刻意不動

目錄檢查留著。 帶了預設之後變數沒設不再解錯，但交出一條看起來合理卻不存在的路徑，成因不只一種：變數指到已經刪掉的目錄、精簡環境裡連家目錄都沒設、連結農場根本還沒部署。三種都一樣過得了前三道關。這三種寫進本文了，免得下一輪有人看到「預設值已經涵蓋了」就把檢查刪掉。

實測表那一列不動。 那是量到的結果，不改寫。新寫法一樣帶變數、無人值守一樣被擋，所以結論相同。表下面加了一段講明：預設值改的是解析出哪一條路徑，不是誰可以跑它。

兩份文件本來就不一致

行為清單的關鍵步驟早就寫著帶預設值的形狀，是技能本文漂走了——而會被執行的是漂走的那一份。這一次把兩份對齊，並把行為清單裡的事故記述改成過去式，免得下一輪有人照它重寫回錯的形狀。

測試結果

三種環境各驗一次：變數沒設、設成正確值，兩種都解出同一條真實路徑；設成不存在的路徑，被目錄檢查擋下。

lint-scripts.sh、check-behaviors.sh、ste100-lint.sh 三支都回結束碼 0。
check-skill-paths.sh 零缺失。
全文掃過一次，除了實測表那一列，不帶預設值的解析式一處都不剩。

這件事是怎麼被發現的

跑真機的第一次啟動踩到的。那一次的內建項對齊有跑完、種入十六筆，巡檢因為上一輪還持著鎖而讓開——但在那之前，第 0 步就已經先停過一次了。

前置 Push Request

無

## 摘要 - 需求描述：把 develop 累積的變更釋出到 master。`deploy.sh` clone 的是預設分支，沒進 master 的東西這台機器一輪都用不到。這一批只有一件事：人在現場那一路的根目錄解析帶上文件記載的預設值。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 這一批的內容技能只有一條路讓人在現場的叫用取得工具根目錄，而那一行讀的是一個沒設就展開成錯誤路徑的變數。旁邊那句話說它涵蓋了文件記載的家目錄退讓——**殼並不知道那個變數的文件預設值是什麼**，所以那個退讓從來沒有發生過。解析式現在自己帶預設，退讓才真的成立。版號 0.2.0 到 0.2.1。 ## 為什麼要緊這台機器從頭到尾沒設過那個變數，`.bashrc` 裡也沒有。所以每一次人在現場叫用，操作都停在第 0 步。而且守衛開的藥方指錯方向：它報「根目錄不見了、去跑部署」，但根目錄好好的，連結農場十一條齊全。**一條不能信的解析式，長得跟一個不存在的根目錄一模一樣。** 排程那一路不受影響——條目自己帶著變數值，也自己帶著根目錄。 ## 兩處刻意不動 **目錄檢查留著。** 帶了預設之後變數沒設不再解錯，但交出一條看起來合理卻不存在的路徑，成因不只一種：變數指到已經刪掉的目錄、精簡環境裡連家目錄都沒設、連結農場根本還沒部署。三種都一樣過得了前三道關。這三種寫進本文了，免得下一輪有人看到「預設值已經涵蓋了」就把檢查刪掉。 **實測表那一列不動。** 那是量到的結果，不改寫。新寫法一樣帶變數、無人值守一樣被擋，所以結論相同。表下面加了一段講明：預設值改的是解析出哪一條路徑，不是誰可以跑它。 ## 兩份文件本來就不一致行為清單的關鍵步驟早就寫著帶預設值的形狀，是技能本文漂走了——而會被執行的是漂走的那一份。這一次把兩份對齊，並把行為清單裡的事故記述改成過去式，免得下一輪有人照它重寫回錯的形狀。 ## 測試結果三種環境各驗一次：變數沒設、設成正確值，兩種都解出同一條真實路徑；設成不存在的路徑，被目錄檢查擋下。 - `lint-scripts.sh`、`check-behaviors.sh`、`ste100-lint.sh` 三支都回結束碼 0。 - `check-skill-paths.sh` 零缺失。 - 全文掃過一次，除了實測表那一列，不帶預設值的解析式一處都不剩。 ## 這件事是怎麼被發現的跑真機的第一次啟動踩到的。那一次的內建項對齊有跑完、種入十六筆，巡檢因為上一輪還持著鎖而讓開——但在那之前，第 0 步就已經先停過一次了。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-09-04 03:55:28 +00:00

fix(assistant): 人在現場那一路的根目錄解析帶上文件記載的預設值 85a0ce9e10

技能本文寫著那一行「涵蓋了文件記載的 ~/.jsc 退讓」，實際上沒有。JSC_HOME
沒設時 $JSC_HOME/current 展開成 /current，不是退讓到任何地方——殼並不知道
那個變數的文件預設值是什麼。解析式現在自己帶預設，退讓才真的發生。

這台機器從頭到尾沒設過那個變數，所以每一次人在現場叫用都停在第 0 步，而且
守衛開的藥方指向不相干的地方：它說根目錄不見了、叫人跑部署，但根目錄好好
的，壞的是解析式自己。排程那一路不受影響，條目自己帶著變數值。

目錄檢查留著，理由改寫進本文：解析式交出一條看起來合理卻不存在的路徑，
不是只有變數沒設一種成因——變數指到已經刪掉的目錄、精簡環境裡連家目錄都
沒設、連結農場根本還沒部署，三種都一樣過得了前三道關。

行為清單那一份早就寫對了，是技能本文漂走。這一次把兩份對齊，並把事故記述
改成過去式，免得下一輪有人照著它重寫回錯的形狀。

實測表第四列不動：那是量到的結果，而且新寫法一樣帶變數、無人值守一樣被擋，
另外加一段講明預設值改的是解析出哪條路徑，不是誰可以跑它。

三份 manifest 版號 0.2.0 升到 0.2.1。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Merge pull request '人在現場那一路的根目錄解析帶上文件記載的預設值' (#22 ) from fix/attended-root-resolve-carries-its-default into develop eade09bf62

Reviewed-on: #22

admin approved these changes 2026-09-04 03:56:47 +00:00

admin merged commit e782bee616 into master

2026-09-04 03:56:49 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/assist#23