 jiantw83
|
369b327a4f
|
feat(report): 報表目錄頁改成一個報表頁一個大標題區塊
報表目錄頁的版面從 markdown 表格換成「大標題加條列」：一個報表頁一個大標題
區塊，也就是一個存取庫的一種期間一個區塊，標題就是那個報表頁的實際頁名，
期間、最新一期、期數這些欄位改成標題底下的一層條列。範本與 report 技能的
寫入敘述與退出碼說明一起跟上。
表格的欄位組合是整頁共用的，一頁上卻有很多報表頁各自的紀錄，每一輪只重寫
自己那一列。欄位一增減，舊列的格數與表頭就對不上，而目錄頁不能整頁覆蓋——
覆蓋等於刪掉別人的紀錄。條列一筆一個區塊，欄位各自獨立，加一條只動到自己
那一個區塊。
比對鍵從裸雜湊那一格改成大標題本身，標題寫成報表頁的實際頁名。頁名只由
存取庫的擁有者、名稱與期間決定，換主機位址或頁名編碼有差都動不到它；含
網址的那一條連結照樣留著給人點，但不當鍵。把報表存取庫改指別的庫是另一回
事：雜湊本身就取自那個庫，換庫等於換頁，四種期間會各多一個區塊，那是換庫
的本意，不是鍵失準，舊區塊請人工清掉。
範圍是工作報表的目錄頁與 report 技能。
|
2026-09-02 17:22:33 +08:00 |
|
|
jiantw83
|
2c085d68ef
|
feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到
取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上
看起來像普通文字或死連結，巡不到也修不了。
連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API，
不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把
好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁
整批判死。
|
2026-09-02 14:27:18 +08:00 |
|
|
jiantw83
|
aee17e45c7
|
feat(wiki): 三個目錄頁改走專用存取庫，比對鍵改用裸 HASH
What：LOG_CONTENTS、LEARN_CONTENTS、REPORT_CONTENTS 改由 wiki-repo CONTENTS
解析並透過 wiki-contents.sh upsert 寫入，內容頁仍各走自己的型別。LOG 與 REPORT
的目錄頁新增一欄裸 HASH 當比對鍵。
Why：比對鍵原本是含網址的儲存格，換主機、換存取庫或 URL 編碼有差就比對不到，
upsert 會走附加分支，同一頁多出第二列而舊列永遠不再更新。REPORT 更脆：存取庫一換，
雜湊與網址同時變，四個期間的列會一次全部重複。
How：worklog-pending.sh 的 valid_hash 放寬成 40 碼、8 碼與 H 加 7 碼三種形狀。
放寬的是長度不是字元集——先剝字元再比長度的順序保留，路徑穿越與換行注入照樣擋下。
年報不得沿用日誌存取庫那條規則收斂到內容頁，目錄頁同住一庫是另一回事。
Who：jsc-log
|
2026-09-02 11:02:21 +08:00 |
|
|
jiantw83
|
7d803245a5
|
fix(overwrite): 只有頁面真的不存在才建新頁
- 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 讀寫與統計輸出。
|
2026-08-31 11:07:16 +08:00 |
|
|
jiantw83
|
e6fafd4132
|
feat(report): 新增工作日誌總結技能
What: 新增 jsc-log:report，把工作日誌總結成年報、月報、週報或日報，寫進 wiki REPORT_{HASH}。另加 tools/report-range.sh 算期間、tools/report-template.sh 解析範本，以及四份報表範本與報表目錄範本。
Why: worklog 只記單筆工作，累積起來沒有工具看得出一週或一個月做了什麼、什麼在卡。要總結只能自己翻頁面加總。
How: 期間換算交給系統的 date，不自己算閏年與週界；週次採 ISO-8601。範本解析採工作目錄優先，.jsc/templates/report-{period}.md 蓋過技能自帶的那份，專案要換格式不必改技能。資料讀 LOG_CONTENTS 列出的所有日誌頁，取工作日期落在期間內的條目，只加總條目真的寫了的數字。
Who: 工作日誌的期間總結。
|
2026-08-26 10:47:07 +08:00 |
|