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

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

Merged
admin merged 3 commits from develop into master 2026-09-01 04:46:22 +00:00
Conversation 1 Commits 3 Files Changed 8
+12 -11
jiantw83 commented 2026-09-01 04:45:46 +00:00
Member
Copy Link
Copy Source

摘要

  • 需求描述：把 develop 併進預設分支，讓改動真的到各 CLI 手上。這是 PR 分支階梯的最後一級——marketplace 與 version-guard.sh 都讀預設分支，停在 develop 的內容 jsc-cli:deploy 看不到。
  • 計畫名稱：無
  • 計畫頁：無
  • 分析頁：無

變更內容

這一批的來源是助理 domain 落地與 MONITOR wiki 頁型別，跨四個存放庫：

存放庫 這一批改了什麼
assist 樣板改成獨立的 jsc-assist domain、唯讀技能 status、技能行為清單、監控頁兩份範本、marketplace 副本
gitea MONITOR 進 resolve_wiki_repo() 白名單與 check-wiki-rules.sh 的 TYPES，README、wiki 技能、行為清單一併更新
meta 命名總表新增 MONITOR 一列，補雜湊來源與寫入語意說明，修掉「CHECK 是唯一例外」這句不再成立的敘述
hooks comment-scope.sh 的頁面編號偵測補上 SKILLSET、TOOLING、MONITOR；另含已合併的 smoke 擋人斷言修正

設計重點

  • 合併順序要留意。 gitea 是型別的解析端。它沒跟上而其餘先進預設分支，會出現準則說有 MONITOR、註解掃描認得 MONITOR，但 gitea.sh wiki-repo MONITOR 仍回 unknown wiki type 的狀態。不會壞事，但那段期間型別還不能用。
  • assist 的版本會從預設分支上的數字往下走。 預設分支原本的號碼是樣板殘留，名稱還是 jsc-template，從沒以 jsc-assist 發佈過。合併後整份內容由 develop 取代，版本是這個 domain 的真實起算值。plugin 名不同，不會與任何已安裝的東西混淆。
  • 雜湊來源比照 CHECK 取主機名與登入帳號；監控頁一律附加、不覆寫。兩點都與 TOOLING 相反，準則裡各自寫明白了。

測試結果

  • 子功能與功能主幹兩級都跑過檢核，四個存放庫的 lint-scripts.sh、lint-frontmatter.sh、check-behaviors.sh、ste100-lint.sh 全綠（assist 的 lint-scripts.sh 是 exit 3，因為它確實沒有 tools/ 也沒有 hooks/）。
  • gitea.sh wiki-repo MONITOR 在工作樹上印出 knowledges/MONITOR；跨型別代用的防護仍在。
  • comment-scope.sh 的偵測樣式實測三種型別各自都攔得下來。
  • 五支 CLI 的 hook smoke 全部 status=ok。
  • 這一級合併之後才驗得了的兩件事：跑 /jsc-cli:deploy 更新，然後在新的工作階段叫 /jsc-assist:status（目前沒有心跳檔，預期輸出「助理未運行」而不是報錯）；以及實際往 knowledges/MONITOR 寫一頁，確認該存放庫的 wiki 功能是開的（目前 wiki-list 回 404，第一次寫入才會生出來）。

前置 Push Request

  • 無
## 摘要 - 需求描述：把 `develop` 併進預設分支，讓改動真的到各 CLI 手上。這是 PR 分支階梯的最後一級——marketplace 與 `version-guard.sh` 都讀預設分支，停在 `develop` 的內容 `jsc-cli:deploy` 看不到。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 這一批的來源是助理 domain 落地與 `MONITOR` wiki 頁型別，跨四個存放庫： | 存放庫 | 這一批改了什麼 | | --- | --- | | `assist` | 樣板改成獨立的 `jsc-assist` domain、唯讀技能 `status`、技能行為清單、監控頁兩份範本、marketplace 副本 | | `gitea` | `MONITOR` 進 `resolve_wiki_repo()` 白名單與 `check-wiki-rules.sh` 的 `TYPES`，README、`wiki` 技能、行為清單一併更新 | | `meta` | 命名總表新增 `MONITOR` 一列，補雜湊來源與寫入語意說明，修掉「`CHECK` 是唯一例外」這句不再成立的敘述 | | `hooks` | `comment-scope.sh` 的頁面編號偵測補上 `SKILLSET`、`TOOLING`、`MONITOR`；另含已合併的 smoke 擋人斷言修正 | ## 設計重點 - **合併順序要留意。** `gitea` 是型別的解析端。它沒跟上而其餘先進預設分支，會出現準則說有 `MONITOR`、註解掃描認得 `MONITOR`，但 `gitea.sh wiki-repo MONITOR` 仍回 `unknown wiki type` 的狀態。不會壞事，但那段期間型別還不能用。 - **`assist` 的版本會從預設分支上的數字往下走。** 預設分支原本的號碼是樣板殘留，名稱還是 `jsc-template`，從沒以 `jsc-assist` 發佈過。合併後整份內容由 `develop` 取代，版本是這個 domain 的真實起算值。plugin 名不同，不會與任何已安裝的東西混淆。 - 雜湊來源比照 `CHECK` 取主機名與登入帳號；監控頁一律附加、不覆寫。兩點都與 `TOOLING` 相反，準則裡各自寫明白了。 ## 測試結果 - 子功能與功能主幹兩級都跑過檢核，四個存放庫的 `lint-scripts.sh`、`lint-frontmatter.sh`、`check-behaviors.sh`、`ste100-lint.sh` 全綠（`assist` 的 `lint-scripts.sh` 是 exit 3，因為它確實沒有 `tools/` 也沒有 `hooks/`）。 - `gitea.sh wiki-repo MONITOR` 在工作樹上印出 `knowledges/MONITOR`；跨型別代用的防護仍在。 - `comment-scope.sh` 的偵測樣式實測三種型別各自都攔得下來。 - 五支 CLI 的 hook smoke 全部 `status=ok`。 - **這一級合併之後才驗得了的兩件事**：跑 `/jsc-cli:deploy` 更新，然後**在新的工作階段**叫 `/jsc-assist:status`（目前沒有心跳檔，預期輸出「助理未運行」而不是報錯）；以及實際往 `knowledges/MONITOR` 寫一頁，確認該存放庫的 wiki 功能是開的（目前 `wiki-list` 回 404，第一次寫入才會生出來）。 ## 前置 Push Request - 無
jiantw83 added 3 commits 2026-09-01 04:45:46 +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
Merge pull request '釋出 jsc-gitea 0.2.1：wiki 頁型別新增 MONITOR' (#42) from feat/monitor-wiki-page-type/main into develop 5bba1f9576 
Reviewed-on: #42
admin approved these changes 2026-09-01 04:46:20 +00:00
admin merged commit b2f13b0ce8 into master 2026-09-01 04:46:22 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
admin
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin (系統管理員) jiantw83 (Jeffery)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: plugins/gitea#43