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

2026-09-02T06:30:10Z

jiantw83 commented

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

摘要

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

變更內容

檔案	為什麼改
doctor、setup 兩支的 `SKILL.md`	兩支都會寫體檢頁與目錄列
`templates/check-contents.md`	範本還在示範舊寫法
`references/behaviors.md`	隨上述變更對齊

設計重點

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

測試結果

check-link-format.sh（11 份文件）、check-behaviors.sh、ste100-lint.sh 全部結束碼 0。
tools/list-models.sh 與 tools/scan-config.sh 裡的雙括號是 shell 條件測試，一個字未動。

前置 Push Request

無

## 摘要 - 需求描述：連結加兩條限制。其一，文字加連結一律寫成 `[{文字}]({連結})`，取消 `[[...]]` 同 wiki 寫法。其二，連結先驗證連得到，才可以寫進文件。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | doctor、setup 兩支的 `SKILL.md` | 兩支都會寫體檢頁與目錄列 | | `templates/check-contents.md` | 範本還在示範舊寫法 | | `references/behaviors.md` | 隨上述變更對齊 | ## 設計重點 - 只留一種連結寫法。兩種寫法並存時，每寫一條連結都得判斷兩端各自解到哪一個存取庫；統一成絕對網址，這個判斷整個消失。 - 驗證走 API，不看網頁狀態碼。私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把好連結判成壞的。 - `link-check.sh` 的結束碼 7（認證失敗）與 1（有死連結）分開。金鑰失效時 Gitea 對私有存取庫的回應與「頁不存在」難以分辨，混用會讓一次金鑰過期把整批還在的頁判死，接著被當成壞連結刪掉或改寫。 - 文件裡為了說明「不准這樣寫」而出現的雙括號字面，包在行內程式碼裡，`check-link-format.sh` 會先剝掉再判定，不會誤判。 ## 測試結果 - `check-link-format.sh`（11 份文件）、`check-behaviors.sh`、`ste100-lint.sh` 全部結束碼 0。 - `tools/list-models.sh` 與 `tools/scan-config.sh` 裡的雙括號是 shell 條件測試，一個字未動。 ## 前置 Push Request - 無

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

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

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

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

chore(plugin 版本): 三份 manifest 升版至 0.2.9 9f4ed977b2

admin merged commit 936fc5cdaa into develop

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

admin deleted branch feat/link-verification/main

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

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/cli#56