plugins/gitea
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

釋出 jsc-gitea 0.2.1：wiki 頁型別新增 MONITOR #42

Merged
admin merged 2 commits from feat/monitor-wiki-page-type/main into develop 2026-09-01 04:44:19 +00:00
Conversation 0 Commits 2 Files Changed 8
+12 -11
jiantw83 commented 2026-09-01 04:41:14 +00:00
Member
Copy Link
Copy Source

摘要

  • 需求描述：把 MONITOR wiki 頁型別的改動從功能主幹放行到 develop。這是跨 gitea、meta、hooks、assist 四個存放庫的同一批變更，本支是其中一個存放庫的部分。
  • 計畫名稱：無
  • 計畫頁：無
  • 分析頁：無

變更內容

各存放庫負責的那一段：

存放庫 這一批改了什麼
gitea 型別進 resolve_wiki_repo() 白名單與 check-wiki-rules.sh 的 TYPES，README 兩處型別列舉與環境變數表，wiki 技能的 allowed types 與 description，行為清單的呼叫端
meta 命名總表新增 MONITOR 一列，補雜湊來源與寫入語意說明，並修掉「CHECK 是唯一例外」這句不再成立的敘述
hooks comment-scope.sh 的 wiki 頁面編號偵測樣式補上 SKILLSET、TOOLING、MONITOR
assist 監控頁的目錄頁與內容頁兩份範本

設計重點

  • 這一級才會讓改動真的生效。 marketplace 與 version-guard.sh 都讀存放庫的預設分支，停在功能主幹的內容任何 CLI 都看不到。develop 之後還要再進 master 才算走完階梯。
  • 雜湊來源比照 CHECK，取主機名與登入帳號。助理巡檢的是一台機器，不是一個存放庫。刻意不帶工具名稱，這一點與 TOOLING 相反——TOOLING 一支 CLI 一頁，助理則是整台機器一份心跳、一本待辦簿。
  • 監控頁一律附加、不覆寫，與 TOOLING 內容頁「每次盤點覆寫整頁」相反。
  • hooks 那一段補的兩種型別是既有落差。 SKILLSET 與 TOOLING 長期不在偵測樣式裡，那兩種的頁面編號寫進程式碼註解一直攔不到，這次一併補齊。

測試結果

  • gitea.sh wiki-repo MONITOR：印出 knowledges/MONITOR，exit 0。改之前回 unknown wiki type: MONITOR、exit 2。
  • 跨型別代用的防護仍在：拿沒設定的型別去試照樣 exit 3，沒有因為新增型別而鬆掉。
  • check-wiki-rules.sh：exit 0，MONITOR 的三項檢查都涵蓋到。
  • comment-scope.sh 的偵測樣式實測三種型別各自都攔得下來，命中說明都正好是「jsc wiki 頁面編號」，不是旁邊那條前綴加流水號的樣式誤撿。
  • 四個存放庫各自的 lint-scripts.sh、lint-frontmatter.sh、check-behaviors.sh、ste100-lint.sh 都 exit 0（assist 的 lint-scripts.sh 是 exit 3，因為它確實沒有 tools/ 也沒有 hooks/）。
  • 各 CLI 的最小提示驗證尚未執行。 這一批走的是工作樹路線，改動要等併進預設分支並重新部署之後才驗得了。knowledges/MONITOR 的 wiki 目前還是空的，第一次 wiki-put 才會生出來。

前置 Push Request

  • 無
## 摘要 - 需求描述：把 `MONITOR` wiki 頁型別的改動從功能主幹放行到 `develop`。這是跨 `gitea`、`meta`、`hooks`、`assist` 四個存放庫的同一批變更，本支是其中一個存放庫的部分。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 各存放庫負責的那一段： | 存放庫 | 這一批改了什麼 | | --- | --- | | `gitea` | 型別進 `resolve_wiki_repo()` 白名單與 `check-wiki-rules.sh` 的 `TYPES`，README 兩處型別列舉與環境變數表，`wiki` 技能的 allowed types 與 description，行為清單的呼叫端 | | `meta` | 命名總表新增 `MONITOR` 一列，補雜湊來源與寫入語意說明，並修掉「`CHECK` 是唯一例外」這句不再成立的敘述 | | `hooks` | `comment-scope.sh` 的 wiki 頁面編號偵測樣式補上 `SKILLSET`、`TOOLING`、`MONITOR` | | `assist` | 監控頁的目錄頁與內容頁兩份範本 | ## 設計重點 - **這一級才會讓改動真的生效。** marketplace 與 `version-guard.sh` 都讀存放庫的預設分支，停在功能主幹的內容任何 CLI 都看不到。`develop` 之後還要再進 `master` 才算走完階梯。 - **雜湊來源比照 `CHECK`**，取主機名與登入帳號。助理巡檢的是一台機器，不是一個存放庫。刻意不帶工具名稱，這一點與 `TOOLING` 相反——`TOOLING` 一支 CLI 一頁，助理則是整台機器一份心跳、一本待辦簿。 - **監控頁一律附加、不覆寫**，與 `TOOLING` 內容頁「每次盤點覆寫整頁」相反。 - **`hooks` 那一段補的兩種型別是既有落差。** `SKILLSET` 與 `TOOLING` 長期不在偵測樣式裡，那兩種的頁面編號寫進程式碼註解一直攔不到，這次一併補齊。 ## 測試結果 - `gitea.sh wiki-repo MONITOR`：印出 `knowledges/MONITOR`，exit 0。改之前回 `unknown wiki type: MONITOR`、exit 2。 - 跨型別代用的防護仍在：拿沒設定的型別去試照樣 exit 3，沒有因為新增型別而鬆掉。 - `check-wiki-rules.sh`：exit 0，`MONITOR` 的三項檢查都涵蓋到。 - `comment-scope.sh` 的偵測樣式**實測三種型別各自都攔得下來**，命中說明都正好是「jsc wiki 頁面編號」，不是旁邊那條前綴加流水號的樣式誤撿。 - 四個存放庫各自的 `lint-scripts.sh`、`lint-frontmatter.sh`、`check-behaviors.sh`、`ste100-lint.sh` 都 exit 0（`assist` 的 `lint-scripts.sh` 是 exit 3，因為它確實沒有 `tools/` 也沒有 `hooks/`）。 - **各 CLI 的最小提示驗證尚未執行。** 這一批走的是工作樹路線，改動要等併進預設分支並重新部署之後才驗得了。`knowledges/MONITOR` 的 wiki 目前還是空的，第一次 `wiki-put` 才會生出來。 ## 前置 Push Request - 無
jiantw83 added 2 commits 2026-09-01 04:41:14 +00:00
feat(wiki): 頁型別新增 MONITOR 8467b89a09 
What：
- resolve_wiki_repo 的型別白名單與檔頭註解加上 MONITOR，check-wiki-rules.sh 的 TYPES 一併加入。
- README 的兩處型別列舉加上 MONITOR，環境變數表補一列 JSC_WIKI_REPO_MONITOR。
- wiki 技能的 allowed types 與行為清單的呼叫端補上這個型別與它的擁有者。
- 三份 manifest 的版本一起提升。

Why：
- 技能助理要把巡檢結果寫進 wiki，落點就是監控頁。型別不在白名單裡，wiki-repo 會直接回「unknown wiki type」而拒絕解析，助理連寫都寫不出去。
- 型別串散在五個檔案，只改一處會讓解析通過但檢核工具漏掉，或反過來。所以一次改齊。

How：
- MONITOR 放在型別串尾端，接在 TOOLING 之後。既有順序是依用途分群，不是字母序，所以不重排。
- 環境變數的規則完全沿用既有型別：先讀 JSC_WIKI_REPO_MONITOR，再退回 JSC_WIKI_REPO，不得跨型別代用。這一條由 resolve_wiki_repo 統一處理，新型別自動繼承，不必另寫分支。
- 雜湊來源的規則不寫在這個存放庫。README 已載明雜湊規則的唯一來源是技能準則的命名總表，這裡不複述。
- wiki 技能的 description 原本逐一列舉呼叫端，已經接近長度上限。這次改成括號標注頁型的濃縮寫法，加了一個呼叫端之後整行反而變短，句數維持在上限內。

Who：
技能助理落地帶出來的頁型別需求，四個存放庫同一批改。
Merge pull request 'feat/monitor-wiki-page-type/resolve-and-check' (#41) from feat/monitor-wiki-page-type/resolve-and-check into feat/monitor-wiki-page-type/main 44797aae97 
Reviewed-on: #41
admin merged commit 5bba1f9576 into develop 2026-09-01 04:44:19 +00:00
admin deleted branch feat/monitor-wiki-page-type/main 2026-09-01 04:44:19 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin (系統管理員) jiantw83 (Jeffery)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: plugins/gitea#42