連結一律寫成 [文字](絕對網址)，並在寫入前驗證連得到 #58

2026-09-02T06:30:14Z

jiantw83 commented

2026-09-02 06:30:14 +00:00

摘要

需求描述：連結加兩條限制。其一，文字加連結一律寫成 [{文字}]({連結})，取消 [[...]] 同 wiki 寫法。其二，連結先驗證連得到，才可以寫進文件。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
四支階段技能的 `SKILL.md`	每一處寫 wiki 與更新目錄頁的步驟都要加入驗證
`tools/stage-report.sh`	真的呼叫驗證，不只寫註解。頁名先全解成網址再一次餵給檢查腳本，省掉逐頁往返
九份範本	寫法本來就是絕對網址，補上驗證要求；`analyze-page.md` 有殘留的舊敘述
`references/stage-report.md`、`README.md`、`references/behaviors.md`	隨上述變更對齊

設計重點

只留一種連結寫法。兩種寫法並存時，每寫一條連結都得判斷兩端各自解到哪一個存取庫；統一成絕對網址，這個判斷整個消失。
驗證走 API，不看網頁狀態碼。私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把好連結判成壞的。
link-check.sh 的結束碼 7（認證失敗）與 1（有死連結）分開。金鑰失效時 Gitea 對私有存取庫的回應與「頁不存在」難以分辨，混用會讓一次金鑰過期把整批還在的頁判死，接著被當成壞連結刪掉或改寫。
文件裡為了說明「不准這樣寫」而出現的雙括號字面，包在行內程式碼裡，check-link-format.sh 會先剝掉再判定，不會誤判。

測試結果

stage-report.sh 以假的相依腳本實跑四種情境：全綠回 0、有死連結標「連不到」並回 1、SKIP 標「無可查端點」不進警告、結束碼 7 標「未驗證」並回 0。
sh -n、check-link-format.sh（23 份文件）、check-behaviors.sh、lint-scripts.sh、ste100-lint.sh 全部結束碼 0。

前置 Push Request

無

## 摘要 - 需求描述：連結加兩條限制。其一，文字加連結一律寫成 `[{文字}]({連結})`，取消 `[[...]]` 同 wiki 寫法。其二，連結先驗證連得到，才可以寫進文件。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | 四支階段技能的 `SKILL.md` | 每一處寫 wiki 與更新目錄頁的步驟都要加入驗證 | | `tools/stage-report.sh` | 真的呼叫驗證，不只寫註解。頁名先全解成網址再一次餵給檢查腳本，省掉逐頁往返 | | 九份範本 | 寫法本來就是絕對網址，補上驗證要求；`analyze-page.md` 有殘留的舊敘述 | | `references/stage-report.md`、`README.md`、`references/behaviors.md` | 隨上述變更對齊 | ## 設計重點 - 只留一種連結寫法。兩種寫法並存時，每寫一條連結都得判斷兩端各自解到哪一個存取庫；統一成絕對網址，這個判斷整個消失。 - 驗證走 API，不看網頁狀態碼。私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把好連結判成壞的。 - `link-check.sh` 的結束碼 7（認證失敗）與 1（有死連結）分開。金鑰失效時 Gitea 對私有存取庫的回應與「頁不存在」難以分辨，混用會讓一次金鑰過期把整批還在的頁判死，接著被當成壞連結刪掉或改寫。 - 文件裡為了說明「不准這樣寫」而出現的雙括號字面，包在行內程式碼裡，`check-link-format.sh` 會先剝掉再判定，不會誤判。 ## 測試結果 - `stage-report.sh` 以假的相依腳本實跑四種情境：全綠回 0、有死連結標「連不到」並回 1、SKIP 標「無可查端點」不進警告、結束碼 7 標「未驗證」並回 0。 - `sh -n`、`check-link-format.sh`（23 份文件）、`check-behaviors.sh`、`lint-scripts.sh`、`ste100-lint.sh` 全部結束碼 0。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-09-02 06:30:14 +00:00

feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到 f4e489ceb4

取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上
看起來像普通文字或死連結，巡不到也修不了。

連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API，
不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把
好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁
整批判死。

chore(plugin 版本): 三份 manifest 升版至 0.3.0 4697bf433f

admin merged commit 0191e7ba8e into develop

2026-09-02 06:46:24 +00:00

admin deleted branch feat/link-verification/main

2026-09-02 06:46:24 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/sdlc#58