jiantw83
7d803245a5
- What：worklog、learn、report 三支技能共六處讀取分流改寫，只有結束碼 4 才建新頁； 結束碼 7 與 8 一律中止，一個字都不寫。三份目錄頁樣板補上寫入語意，明寫禁止整頁覆蓋、 不得改動別人的列。usage-stats.sh 的參數護欄改成明確回傳結束碼 2。 - Why：原本把「讀失敗」與「頁面不存在」當成同一件事。金鑰失效時讀取回 7，技能卻讀成 「這頁還沒有」，於是照樣板建一份新頁蓋回去。整份工作日誌會被這一筆條目取代， 既有教訓會被清成空表，報表則產出一份說「這段期間沒有工作」的假數字。 這些內容只活在 wiki 上，蓋掉就救不回來，所以這是本輪最要緊的一項。 - How：每一處讀取都先看結束碼再決定動作，並在技能文件裡列成表格： 0 接在既有內容後面附加，4 才從樣板建頁，5 缺網址就中止，7 金鑰或權限問題就中止， 8 其他 API 失敗就中止。目錄頁一律先讀整頁再改那一列。 stats 也補上分流，參數錯誤不再被讀成「零次」。 - Who：worklog、learn、report、stats 四支技能的 wiki 讀寫與統計輸出。
10 lines
669 B
Markdown
10 lines
669 B
Markdown
# 教訓目錄
|
|
|
|
> 由 `jsc-log:learn` 維護。這是教訓目錄頁 `LEARN_CONTENTS`。每個存取庫一列；`LEARN_{HASH}` 的 `{HASH}` 依共用 wiki hash 規則產生：先取 `{owner}/{repo}` 的 SHA-1 前 8 碼並轉成大寫；首碼若是 `0-9`、`A`、`B`、`C`，改用 `H` 加上原前 7 碼，總長維持 8 碼。
|
|
> 寫入語意：一列代表一個存取庫。先讀整頁，找得到該存取庫既有的那一列就更新那一列，找不到才新增一列。
|
|
> 禁止整頁覆蓋，也不得改動別人的列。
|
|
|
|
| 存取庫名稱 | 教訓紀錄 | 最後更新時間 |
|
|
| --- | --- | --- |
|
|
| {owner}/{repo} | [[LEARN_{HASH}]] | {yyyy-MM-dd HH:mm} |
|