diff --git a/.githooks/plugin-shell-versions.txt b/.githooks/plugin-shell-versions.txt index 5704dad3..74dd7483 100644 --- a/.githooks/plugin-shell-versions.txt +++ b/.githooks/plugin-shell-versions.txt @@ -30,3 +30,5 @@ plugin 0.13.14 b5a6f4f73a785f17754cc039362a4b4bce4c406331ee6d91037c69e50835977a plugin 0.13.15 0d77d4d1b72078218157f378bc547ffc1472ef0238522c0f4a1feb60516ad10f plugin 0.13.16 acf8a5f6d54ff90ff76b324a5f9c408ab4bc38a38ff0fc9ce3ff5e5af1ef986b plugin 0.13.17 c598d9e016a84021f96c07bb95583fe23e13f333428e92ddd10b3b1aefca7150 +plugin 0.13.18 85e500da52faab6cf71c8bcc8f3ffa86024bd2607b44a46fb55c645ae7075ffb +plugins/akashic-discovery 0.2.18 afe7301483d7d1d470b5dd23b29ae7d87eb413139445300904a1a82f9f51917a diff --git a/.githooks/protected-ratchet.txt b/.githooks/protected-ratchet.txt index 2467bf06..3fb4daa2 100644 --- a/.githooks/protected-ratchet.txt +++ b/.githooks/protected-ratchet.txt @@ -66,6 +66,7 @@ docs/zero-instance-measurements.md mcpb/manifest.json plugin/.claude-plugin/plugin.json plugin/rules/assertions-must-be-measured.md +plugin/rules/site-knowledge-goes-back-into-the-plugin.md plugin/rules/source-of-truth-over-consent.md plugin/skills/akashic-promote-literals/SKILL.md plugins/akashic-discovery/.claude-plugin/plugin.json diff --git a/CLAUDE.md b/CLAUDE.md index fe27f901..856a35a6 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -113,11 +113,13 @@ Foresay 管**人機確認的格式與迴圈**,本 repo 的規則管**哪些寫 | [upstream-first-bibliographic-updates.md](.claude/rules/upstream-first-bibliographic-updates.md) | **文獻資料更新一律從上游 store 開始,交付層只投影不修正**——投影只能選欄、改名、剝除隱私、加標記欄,不得改變事實陳述;上游暫時修不了才可遮蔽,且必須開 issue 註明號碼、遮蔽是暫時的;反例是一次下游交付(R2)在交付層遮蔽離職博後被標現職等三個資料問題,之後才回頭修 store(#599)| > **plugin 另有自己的規則目錄。** `plugin/rules/` 隨 plugin 走(plugin 安裝到哪,規則就在哪), -> 由 skill 以相對路徑引用——**不像上表那樣自動注入**。目前兩條: +> 由 skill 以相對路徑引用——**不像上表那樣自動注入**。目前三條:前兩條是 > [`assertions-must-be-measured`](plugin/rules/assertions-must-be-measured.md),管「寫下一句可能是錯的話 > 之前先回答四個問題」(不是分類法——理由見該檔); > [`source-of-truth-over-consent`](plugin/rules/source-of-truth-over-consent.md),管「寫入的依據是 source of truth、 > 不是同意」——使用者要的與 source of truth 不符時改成正確的再寫,使用者可以提供證據、不能提供授權(#642)。 +> 第三條是 [`site-knowledge-goes-back-into-the-plugin`](plugin/rules/site-knowledge-goes-back-into-the-plugin.md),管「碰網站的 skill 量到的 +> 站別做法,在回報之前寫回 plugin;改動合併之後同一個工作階段更新安裝的 plugin 與 CLI」(#822)。 > 刻意不列進上表:那張表的語意是「自動注入的 repo 規則」, > 混進去會讓那個性質變成謊話(#407)。 > diff --git a/Sources/akashic-guards/AuditGuardsMutationsData.swift b/Sources/akashic-guards/AuditGuardsMutationsData.swift index 4a31a52f..5cab038c 100644 --- a/Sources/akashic-guards/AuditGuardsMutationsData.swift +++ b/Sources/akashic-guards/AuditGuardsMutationsData.swift @@ -59,6 +59,7 @@ let agmCases: [AGMCase] = [ // 「移植時的新舊差分(不在 repo)」,於是這條分支沒有任何東西釘住。刪光 `plugin/rules/` 底下的 `.md`(目錄還在)即得那個狀態。 AGMCase(desc: "coverage④:規則目錄在、一條 .md 規則都沒有(空集合不得冒充通過)", guardRel: "akashic-guards rule-coverage", edits: [ AGMEdit(path: "plugin/rules/assertions-must-be-measured.md", kind: "delete", a: "", b: ""), + AGMEdit(path: "plugin/rules/site-knowledge-goes-back-into-the-plugin.md", kind: "delete", a: "", b: ""), AGMEdit(path: "plugin/rules/source-of-truth-over-consent.md", kind: "delete", a: "", b: ""), ], expect: ["沒有任何 .md 規則檔"]), AGMCase(desc: "numbers:把某個數字唯一的行內時間錨拿掉", guardRel: "akashic-guards measured-numbers-audit", edits: [ diff --git a/changelog/2026-11-20-site-knowledge-rule-822.md b/changelog/2026-11-20-site-knowledge-rule-822.md new file mode 100644 index 00000000..3344f9a4 --- /dev/null +++ b/changelog/2026-11-20-site-knowledge-rule-822.md @@ -0,0 +1,29 @@ +# #822:量到的站別做法要寫回 plugin(plugin 殼 0.13.17 → 0.13.18,契約版本不變) + +使用者 2026-11-20 17:26(+08:00),正在用 `akashic-fetch-fulltext` 抓一批全文時:「akashic 的plugin要有一個rule是每次更新pdf取用方式都要更新到plugin上」。之後以選單問了三題,回答都是選單上的選項文字(#822 的兩則 Decision comment): + +| 問題 | 回答 | 是不是選單上標成建議的那一個 | +|---|---|---| +| 「更新到 plugin 上」是寫回檔案,還是發布到安裝的版本 | 兩者都要 | 是 | +| 什麼時候寫回 | 整批結束、回報之前 | 是 | +| 範圍 | 所有碰網站的 skill | 不是(建議的是只管取全文)| + +## 文件 + +- `plugin/rules/site-knowledge-goes-back-into-the-plugin.md`(新):六條。第 1、3、4 條是封閉列舉(什麼算要寫回的更新、寫到哪個檔、誰來寫);第 6 條是合併之後更新安裝的版本,只適用有原始碼 repo 的維護者,而且合併與更新各自仍要使用者確認。規則自己寫明三件做不到的事:它不自動載入(靠各 skill 引用,守衛只保證連結在)、一般安裝的使用者不送出就到不了 plugin、沒有檢查會發現「量到了卻沒寫」。 +- `plugin/skills/akashic-fetch-fulltext/SKILL.md`:第 7 步加「回報之前,把這一批量到的寫回 plugin」;〈相關〉加這條規則;`html-page` 一列括號裡 Wiley epdf 的例子改成兩次量測各自的結果。 +- `plugin/skills/akashic-bootstrap/references/web-access.md`:〈其他〉加一點,讓每一個照它取得的 skill 都讀得到這條義務。 +- 其餘九個 skill 的 `SKILL.md`:各加一行指向這條規則。規則覆蓋的守衛(`run-guards.sh` 的 rule coverage)要求每一條 plugin 規則都被每一個 skill 以可解析的相對路徑引用;第一次跑守衛時九個 skill 缺這個連結。`akashic-merge-twins`、`akashic-promote-literals`、`akashic-verify-work` 沒有自己的網頁取得步驟,那一行照實這樣寫。 +- `plugin/skills/akashic-fetch-fulltext/references/publishers.md`:新增〈2026-11-20 的實測〉一節(九篇、六個站,每一列只有表裡寫的篇數);規則表與先前各節裡被這一批推翻或補上的六處加註。 +- `CLAUDE.md`:plugin 規則的說明由兩條改成三條。 +- `plugins/akashic-discovery/.claude-plugin/plugin.json` 0.2.17 → 0.2.18 與 `.githooks/plugin-shell-versions.txt` 兩列:`akashic-discovery` 的 `rules/` 連到 `plugin/rules`,新規則讓它的殼內容變了;兩個殼都照 `akashic-guards plugin-shell-version` 印出的摘要接列。 + +## 這一批量到、但沒有因此改流程的事 + +- 視窗裡出現顯示 PDF 的分頁之後,`documents --json` 的 `blocking_dialog` 對整個視窗每一次都讀成 `unknown`/`incomplete`(PsychQuant/safari-browser#345,2026-11-20 的實測已補在那一張)。SKILL 第 3 步「按之前不是 `clear` 就不按、仍然 `unknown` 就停下整批」照這個觀察會在第一個 `pdf-shown` 之後擋下後面每一次按。那條規則沒有改:它是往停的方向定的,要不要放寬是使用者的裁決。 +- Safari 的下載位置設成固定資料夾時,下載鈕按下去不跳儲存面板。開始前提醒或檢查這個設定是 #823,使用者決定等 PsychQuant/safari-browser#388(讀出這個設定)落地再做,這一次沒有動。 +- 存進 store 的 provenance note 寫錯時沒有更正的入口:#824。 + +## 驗證 + +只改 Markdown 與 `plugin.json` 的版本號。釘住 SKILL 與 publishers.md 文字的測試與守衛的結果寫在 #822 的實作留言。 diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.json index 96918a9e..40098167 100644 --- a/plugin/.claude-plugin/plugin.json +++ b/plugin/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "akashic-mcp", - "version": "0.13.17", + "version": "0.13.18", "binary_version": "0.13.0", "description": "Akashic-Library MCP server — file-based canonical literature store: search, relations, graph, derived-layer writes (tags/status/links/person updates), person & organization resolution, divergence recording with judgement, resolution verdicts (confirm/reject with four-state counts incl. checked-undecided, no ratios), Zotero one-way pull, author-list replacement from a work's own full text. Store format 23.", "author": { diff --git a/plugin/CHANGELOG.md b/plugin/CHANGELOG.md index 42ef4933..3b73e4c7 100644 --- a/plugin/CHANGELOG.md +++ b/plugin/CHANGELOG.md @@ -1,5 +1,15 @@ # Changelog +## #822 — 量到的站別做法要寫回 plugin(2026-11-20):plugin 殼 0.13.17 → 0.13.18,契約版本不變(13) + +使用者 2026-11-20 的指示與三個選擇;細節在 `changelog/2026-11-20-site-knowledge-rule-822.md`。**只改文件,沒有改 `akashic` CLI**:SKILL 第 0 步要求的契約版本仍是 13。 + +- 新規則 `rules/site-knowledge-goes-back-into-the-plugin.md`:碰網站的 skill 在一批做完、回報之前,把量到的站別做法寫回 plugin(什麼算、寫到哪個檔、誰來寫、要帶哪些欄位都是封閉列舉);改動合併之後,同一個工作階段把安裝的 plugin 與 CLI 更新到合併後的版本。`akashic-fetch-fulltext` 第 7 步與 `akashic-bootstrap` 的 `web-access.md`〈其他〉引用它;其餘九個 skill 的 `SKILL.md` 各加一行指向它(規則覆蓋的守衛要求每一條 plugin 規則都被每一個 skill 引用),不自己讀網站的三個 skill 寫明這一點。 +- `akashic-fetch-fulltext` 的 `references/publishers.md` 新增〈2026-11-20 的實測〉:合併後的流程第一次用在真的出版商網站,九篇、六個站(SAGE、Wiley 的學會子網域、Cambridge Core、Taylor & Francis、Oxford Academic、SpringerLink),以及對話框探測在出現 PDF 分頁之後整個視窗讀成 `unknown` 的觀察(PsychQuant/safari-browser#345)。 +- 被這一批推翻的舊句加註、不刪:Wiley 的 epdf 閱讀器「讀不到任何下載鈕」(那一篇讀得到)、SAGE「每一篇最後都要使用者按一次儲存」(下載位置是固定資料夾時不必)。SKILL 的 `html-page` 一列括號裡的例子跟著改。 +- `akashic-discovery` 的殼 0.2.17 → 0.2.18:它的 `rules/` 是指向 `plugin/rules` 的連結,多了一條規則就是殼的內容變了(`akashic-guards plugin-shell-version` 要求升版),skill 本身沒有改。 +- **沒有改的**:按之前讀到 `unknown` 就停的那條處置規則。這一批的觀察顯示它會讓第一個 PDF 分頁之後需要按的每一篇都停下來,要不要改等使用者裁決。 + ## #772 — `fetch` 鎖在開頭選定的視窗,別的 profile 的視窗開著不再停(2026-11-19):plugin 殼維持 0.13.17(同一條分支、還沒推上 main),契約版本 11 → 12 使用者 2026-11-19 09:24、09:25 的決定;細節在 `changelog/2026-11-19-fetch-window-id-772.md`。**需要新的 `akashic` CLI 與 safari-browser 2.9.0 以上**:SKILL 第 0 步要求契約版本 12。 diff --git a/plugin/rules/site-knowledge-goes-back-into-the-plugin.md b/plugin/rules/site-knowledge-goes-back-into-the-plugin.md new file mode 100644 index 00000000..265190f6 --- /dev/null +++ b/plugin/rules/site-knowledge-goes-back-into-the-plugin.md @@ -0,0 +1,79 @@ +# 量到的站別做法要回到 plugin——不留在對話、暫存腳本或個人記憶裡 + +適用於本 plugin **每一個讀外部網頁或 web API 的 skill**(使用者 2026-11-20:範圍是所有碰網站的 skill,不只取全文)。 + +不適用於不碰網站的工作(只讀寫 store 的 skill 步驟),也不適用於「這一筆資料查到什麼」——那是 store 的內容,照 [`source-of-truth-over-consent`](source-of-truth-over-consent.md) 寫進 store,不是這條規則管的事。 + +## 規則 + +### 1. 什麼算要寫回的更新(封閉列舉,只有這三類,不得依性質相似類推第四類) + +| # | 類別 | 例子(2026-11-20 那一批) | +|---|---|---| +| 1 | 某個站量到了 plugin 還沒有紀錄的行為:哪個連結通到哪裡、工具的結束碼與交接原因、按了之後檔案落在哪裡、沒有權限時頁面上的字 | Cambridge Core 上的 Psychometrika:PDF 連結導航之後分頁不離開摘要頁,頁面寫「Get access」「Add article to cart」 | +| 2 | 量到的與 plugin 寫的不同 | Wiley 的 epdf 閱讀器:文字寫 `snapshot -i` 讀不到任何下載鈕,那一篇讀得到 | +| 3 | 流程照字面做不到,或照字面做會得到流程自己沒料到的結果 | 視窗裡出現顯示 PDF 的分頁之後,對話框探測把整個視窗讀成 `unknown`,後面每一下「按之前先看對話框」都會停 | + +你自己漏做一步(文字有寫、執行時沒照做)不屬於這三類:那一批的回報照實寫漏了什麼,不改 plugin。 + +### 2. 什麼時候寫 + +**一批做完、向使用者回報之前**(使用者 2026-11-20)。回報裡列出寫了什麼:哪個檔、加了或改了哪一列。批次中途不停下來改檔。 + +### 3. 寫到哪裡(封閉列舉) + +| 量到的是 | 寫進 | +|---|---| +| 出版商或網站的行為,由 `akashic-fetch-fulltext` 量到 | `skills/akashic-fetch-fulltext/references/publishers.md`:依日期開一節,一站一列 | +| Safari 或 safari-browser 本身的行為(分頁開在哪裡、對話框與面板讀起來是什麼) | `skills/akashic-fetch-fulltext/references/safari-measurements.md`;同時在 safari-browser 的 repo 查有沒有既有的 issue,有就把這次量到的補在那一張,沒有就照下面〈誰來寫〉的 (b) 處理 | +| 期刊網站的行為,由 `akashic-venue-works` 量到 | `skills/akashic-venue-works/references/site-access.md` | +| web API 或名冊、個人頁的行為,由其他經 `web-access.md` 取得的 skill 量到 | `skills/akashic-bootstrap/references/` 下講那個來源的檔(作品來源在 `work-sources.md`,人的來源在 `person-sources.md`,Semantic Scholar 在 `semantic-scholar.md`);取得程序本身的行為寫進 `web-access.md` | + +表裡沒有的組合,先在這張表加一列再寫,不要挑一個看起來相近的檔。 + +**與 `SKILL.md` 的句子不同時,同一個變更裡改那一句**,並寫明是哪一天的哪一次量測。舊的列與舊的句子加註、不刪:它們是當時量到的事實,被推翻的是「現在仍然如此」。 + +**會改變流程怎麼判的句子不在這條規則的授權內。** 量到的事實讓某條處置規則顯得不對時(例如第 1 條第 3 類的例子),寫下事實、指出它碰到哪一條,處置規則本身怎麼改交給使用者裁決。 + +### 4. 誰來寫(封閉列舉,依這個工作階段手上有什麼) + +| # | 情況 | 做法 | +|---|---|---| +| (a) | 這個工作階段讀得到 plugin 的原始碼 repo,而且使用者是它的維護者 | 在 repo 的功能分支上改檔、commit。推送、開 PR、合併各自照使用者自己的確認規則;本規則不授權其中任何一步 | +| (b) | 其他(一般安裝:只有 Claude Code 管理的 plugin 安裝目錄,不改它) | 把同樣的內容寫成回報裡的一節「要寫回 plugin 的觀察」,照第 5 條的欄位寫;問使用者要不要把它送到 plugin 的 repo(開 issue 是把內容送出這台機器,由使用者決定,內文先過隱私檢查) | + +### 5. 怎麼寫:證據範圍 + +每一列帶:日期、主機(學會或子刊的子網域照實寫,不寫成母站)、幾篇、工具的結果(結束碼、交接原因)、之後做了什麼與看到什麼、環境(safari-browser 版本、`akashic fulltext contract` 的值)。 + +- 量到一篇就寫一篇,不寫成「這一站都這樣」。 +- 原因是推論、或來自使用者的說明時,照實標明,並寫出沒有做的對照。 +- 權限因機構而異:「取得成功」「沒有權限」都只代表那個網路、那一天。 + +每一句都是關於世界的斷言,寫之前照 [`assertions-must-be-measured`](assertions-must-be-measured.md) 的四個問題過一次。 + +### 6. 寫進 repo 之後,要到達實際在用的版本(只適用第 4 條的 (a)) + +取得方式的改動合併進預設分支之後,**同一個工作階段**把這台機器上安裝的 plugin 與 `akashic` CLI 更新到合併後的版本,並確認:plugin 的版本號、`akashic fulltext contract` 印的值,都是合併後的。 + +- 合併與更新安裝的版本,各自要使用者確認;這一條規定的是「不要停在合併之前就當成做完」,不是讓它們自動發生。 +- 沒有更新完就結束時,回報寫明安裝的還是哪一版、差在哪幾項。 +- skill 的版本檢查擋下舊的 CLI 時,處置是更新 CLI;不請使用者配合舊版才有的限制。 + +## 為什麼(2026-11-20,同一天、同一個工作階段的兩種落差) + +**安裝的版本落後。** 安裝的 CLI 印 `fulltext-contract 10`,而「別的 profile 的視窗開著就停」這個限制在分支上已經依使用者前一天的裁決拿掉。舊的 `fetch` 仍然停下,Claude 因此請使用者去關視窗;使用者指出那個限制早就拿掉了,之後才合併、更新。第 6 條防的是這個。 + +**量到的沒有寫回去。** 更新之後在真的出版商網站上抓九篇全文,量到的事有三件與 plugin 的文字不同或 plugin 沒有(第 1 條表裡的三個例子),另外四個站的結果是 plugin 第一次有導航之後的實測。這些原本只在那個工作階段的對話與暫存腳本裡。使用者當場說: + +> 「akashic 的plugin要有一個rule是每次更新pdf取用方式都要更新到plugin上」 + +問他要的是「寫回檔案」還是「發布到安裝的版本」時,他選了兩者都要;範圍選了所有碰網站的 skill;時間點選了整批結束、回報之前(PsychQuant/Akashic-Library#822)。 + +**不寫回去的代價是下一次照舊的文字做。** 站別紀錄寫得比實際保守,能取得的全文會被列成「取不到」或多交給使用者一次;寫得比實際寬鬆,Claude 會照過時的步驟對網站動作。兩種都不會報錯。 + +## 這條規則做不到的事 + +- 它不讓規則自己被讀到:`plugin/rules/` 不自動載入,要靠各 skill 引用它。每個 skill 的 `SKILL.md` 都有一行指向本檔,repo 的守衛只檢查那個連結在、路徑解析得到;寫在回報步驟裡的只有 `akashic-fetch-fulltext` 第 7 步與 `web-access.md`〈其他〉。skill 執行時有沒有讀、有沒有照做,沒有東西檢查。 +- 第 4 條的 (b) 只做到把觀察交到使用者手上;他不送出,plugin 就不會知道。 +- 沒有檢查會發現「量到了卻沒寫」。 diff --git a/plugin/skills/akashic-bootstrap/SKILL.md b/plugin/skills/akashic-bootstrap/SKILL.md index 983885d7..b4c4a99b 100644 --- a/plugin/skills/akashic-bootstrap/SKILL.md +++ b/plugin/skills/akashic-bootstrap/SKILL.md @@ -200,6 +200,8 @@ DOI 識別「註冊的物件」,篇名識別「作品」,store 的 work 記 **寫入的依據是 source of truth,不是同意。** 使用者要求的值與作品本身、權威來源對不上時,改成正確的再寫,乾跑報告逐筆寫出「要求/依據/實際寫入」;查不到就不寫——見 [`source-of-truth-over-consent`](../../rules/source-of-truth-over-consent.md)。 +**量到的站別做法要寫回 plugin。** 一批做完、回報之前,把這一批量到的網站或 API 行為(plugin 還沒有紀錄的、與 plugin 寫的不同的、照字面做不到的一步)寫回 plugin,並在回報列出寫了什麼(#822)——見 [`site-knowledge-goes-back-into-the-plugin`](../../rules/site-knowledge-goes-back-into-the-plugin.md)。 + ## 常見情境 | 使用者說 | 路徑 | diff --git a/plugin/skills/akashic-bootstrap/references/web-access.md b/plugin/skills/akashic-bootstrap/references/web-access.md index 72c0d079..ab384b45 100644 --- a/plugin/skills/akashic-bootstrap/references/web-access.md +++ b/plugin/skills/akashic-bootstrap/references/web-access.md @@ -330,6 +330,7 @@ grep -q '[^[:space:]]' "/r-$K.txt" || { echo "empty read - read failed" >&2; - **持久狀態變更先問**:清 cache、註銷 service worker、改 cookie 或 storage,先說明意圖、取得同意再做。 - **不代按登入、授權、「接受」之類的按鈕**:那是使用者本人的操作。 +- **量到的站別做法要寫回 plugin**(使用者 2026-11-20,#822):一批做完、向使用者回報之前,這一批裡量到 plugin 還沒有紀錄的網站或 API 行為、與 plugin 寫的不同的行為、或本檔照字面做不到的一步,照 [`site-knowledge-goes-back-into-the-plugin`](../../../rules/site-knowledge-goes-back-into-the-plugin.md) 寫回去(寫到哪個檔、誰來寫、要帶哪些欄位都在那一條),並在回報列出寫了什麼。這一條對每一個照本檔取得的 skill 都適用。 - **用完的分頁**:整個 run **沒有**觸發中止條款時,用同一把鎖關掉自己開的分頁(每個站一個): ```bash diff --git a/plugin/skills/akashic-disambiguate/SKILL.md b/plugin/skills/akashic-disambiguate/SKILL.md index c9eab01c..c235b886 100644 --- a/plugin/skills/akashic-disambiguate/SKILL.md +++ b/plugin/skills/akashic-disambiguate/SKILL.md @@ -162,4 +162,5 @@ akashic record-divergence --question "…" --candidate "a:person" --candidate "b **此處刻意不重述它的判準**:重述過一次,被逐句比對後找出多處失真(漏掉一項證據、把明標的開放清單寫成封閉、整個識別碼例外沒提;型態的完整清單見 `../../rules/assertions-must-be-measured.md` 的失真表)。**確切數目不寫**——那個計數只存在於一則讀者多半取不到的 verify comment,而寫一個他無法重跑的數字正好違反那條規則的第 2 題。讀不到時的出路是**明說讀不到**、請讀得到的人補,不是憑印象補上 - [`assertions-must-be-measured`](../../rules/assertions-must-be-measured.md)——判定寫進 verdict 的理由是關於世界的斷言,先量過再寫 - [`source-of-truth-over-consent`](../../rules/source-of-truth-over-consent.md)——身分判定的依據是證據;使用者說「就歸給這個人」而沒有給出處時,那是線索、不是授權 +- [`site-knowledge-goes-back-into-the-plugin`](../../rules/site-knowledge-goes-back-into-the-plugin.md)——一批做完、回報之前,把這一批量到的網站或 API 行為(plugin 還沒有紀錄的、與 plugin 寫的不同的、照字面做不到的一步)寫回 plugin,並在回報列出寫了什麼(#822) - Akashic-Library#384(統計所 100 筆歧義的逐輪消歧,本 skill 的方法論來源)、#386(per-work 判定路徑)、#396(220 列非歧義候選) diff --git a/plugin/skills/akashic-fetch-fulltext/SKILL.md b/plugin/skills/akashic-fetch-fulltext/SKILL.md index 239459fb..5fd0d39a 100644 --- a/plugin/skills/akashic-fetch-fulltext/SKILL.md +++ b/plugin/skills/akashic-fetch-fulltext/SKILL.md @@ -257,7 +257,7 @@ akashic fulltext fetch --window [--expect-profile "<使用者自己的 profi | 原因 | 你做什麼 | |---|---| | `pdf-shown` | 分頁回報顯示 PDF(含顯示在**另一個主機**上:檔案放在 CDN 或儲存主機):先確認 `handover:` 印的網址是這一篇的(規則 1 的 (d)),再用 `safari-browser save-pdf`(見〈能做到哪裡〉)取那一份,交給第 4 步;`take` 會驗證是不是這篇(`%PDF-` 檔頭擋掉登入或驗證頁)。`save-pdf` 失敗(WebKit 不再持有、分頁其實不是 PDF)就是「取不到」,不重試、不重新載入。「顯示 PDF」的依據是分頁讀得到的 `document.contentType`,頁面腳本改得了它:取到的不是 PDF、或讀起來是登入、驗證、封鎖頁,照〈中止條款〉 | -| `html-page` | 頁面自己的 PDF 連結通到 HTML 頁(線上閱讀器、登入頁、無權限的外殼):照〈一層層按〉的第 1 步讀那一頁(你還沒按任何東西,所以這裡沒有落點表的第 9 種)——是落點表第 5–8 種就照那一列處理(寫著沒有權限是「取不到(無權限)」;要求登入是 (b):`html-page` 只在文章站上出現,所以這一頁在文章站本身);有這篇自己的下載鈕就照四步按(SAGE 閱讀頁的 `Download PDF`、AME 的 `Download` 實測);`snapshot -i` 讀不到任何這篇自己的下載元件(Wiley 的 epdf 閱讀器實測)是「取不到」 | +| `html-page` | 頁面自己的 PDF 連結通到 HTML 頁(線上閱讀器、登入頁、無權限的外殼):照〈一層層按〉的第 1 步讀那一頁(你還沒按任何東西,所以這裡沒有落點表的第 9 種)——是落點表第 5–8 種就照那一列處理(寫著沒有權限是「取不到(無權限)」;要求登入是 (b):`html-page` 只在文章站上出現,所以這一頁在文章站本身);有這篇自己的下載鈕就照四步按(SAGE 閱讀頁的 `Download PDF`、AME 的 `Download` 實測);`snapshot -i` 讀不到任何這篇自己的下載元件是「取不到」(Wiley 的 epdf 閱讀器 2026-11-10 那一篇是這樣;2026-11-20 學會子網域上的另一篇讀得到「Download PDF」、按成了,見 publishers.md——所以到了 epdf 閱讀器照樣先讀,不要憑站名判) | | `button` | 頁面的 PDF 下載是表單按鈕(Annual Reviews 型;`fetch` 已經記了一次嘗試):照〈一層層按〉按那個按鈕(**只按,不代填、不代送表單以外的東西**;按之前照常再記一次),按了之後由落點表決定(找新檔就是它的第 4 種;第 3 輪 verify 第 7 列:先前另外寫「照 `tab-unchanged` 那一列找新檔」,兩個說法對同一刻) | | `tab-unchanged` | 導航之後分頁沒有離開文章頁:連結多半直接開始下載了(MDPI 實測,2026-11-02)。在 Safari 的下載資料夾找比 `<暫存目錄>/.start` 新的 `*.pdf`(輪詢約 15 秒);找到就交給第 4 步,`acquisition=browser-download`。沒有新檔:先 `touch "<暫存目錄>/.clicked"`(`fetch` 的導航就是這一下,之後鎖對不到、`moved` 照按過之後處理),再跑〈一層層按〉的落點那一段(基準是起點那一段存的 `.before.json`,`.pos`、`.url` 也是它寫的;第 3 輪 verify 第 7 列:先前這時沒有基準檔,那一段會以讀頁面文字那一段的結束碼結束),照落點表判,「沒有變化」就照那一列處理(等一次,不再按);判到第 2 種(頁面換了、出現另一個這篇自己的下載元件)也不按,照那一列列入最後交給使用者的清單。這裡的〈落點〉那一段是單獨跑的,所以它看到視窗多了分頁就印 `grown`、停下整批:`fetch` 的導航沒有可以比對的連結——`fetch` 導航到這篇自己的 PDF 連結算第一下(等於按了那個連結),所以這裡不再按,不走〈一層層按〉(#781 起有意的改變:基底版本在這裡由使用者授權後再按一下;使用者 2026-11-10 10:39「不按第二次」;#781 verify 第 1 輪第 26 列要求寫明) | | `left-site` | 分頁到了**別的主機**,那一頁載完了、沒有命中驗證、封鎖或登入的封閉清單(跨主機的中繼頁、檔案主機、出版商換了網域——AME 的 `.com` → `.org` 實測)——**這不代表它不是登入頁**。照這個順序讀那一頁,第一個成立的就照它做(你還沒按任何東西,所以這裡沒有落點表的第 9 種;靜態、沒有連結的頁面只有一個結局,就是最後的「取不到」,第 4 輪 verify 第 9 列):先跑落點表第 1 種的探測(`fetch` 已經判過這個主機不是驗證服務、網址沒有登入頁的長相),顯示 PDF 就 `save-pdf`(規則 1 例外 (d) 收這個分頁);不是 PDF 就照〈一層層按〉的第 1 步讀——讀起來像被懷疑(`get text` 交給 `bot-signals`)是 (e);**要求登入、輸入帳密或選機構,或有登入頁的長相(〈整批暫停〉第三點),是 (e) 整批暫停**——這一頁在別的主機上,不是 (b)(基底版本就是中止條款;#781 verify 第 1 輪第 1 列恢復;別的主機上的 IdP 登入頁是 (e),使用者 2026-11-19 19:31 確認);有這篇自己的 PDF 或下載連結就照四步按;都不是就是「取不到」。不是 (e) 時**批次繼續** | @@ -550,6 +550,8 @@ CLI 是 `akashic update-entry --add-source `,加 `--apply` 另外列出:第 2 步查到的合法開放版本(位址,供使用者決定要不要改用)、留在 Safari 裡沒關的分頁、今天各站用掉幾次嘗試、當場停下過的每一次(第 3 步落點那一段印的 `grown …` 一行照抄:多出來的分頁在哪個位置、什麼主機,或多了幾個視窗;對話框只寫 `present` 或 `unknown`,訊息不寫)。整批暫停時先回報 (e):哪個站、哪個訊號、在哪一步、完成到哪一篇。**不寫「應該有權限」「大概是這篇」**——量到什麼寫什麼,見 [`assertions-must-be-measured`](../../rules/assertions-must-be-measured.md)。 +**回報之前,把這一批量到的寫回 plugin**(使用者 2026-11-20,#822):這一批裡量到 [publishers.md](references/publishers.md) 還沒有的站別行為、與它或本檔寫的不同的行為、或本檔照字面做不到的一步,就照 [`site-knowledge-goes-back-into-the-plugin`](../../rules/site-knowledge-goes-back-into-the-plugin.md) 寫回去——什麼算、寫到哪個檔、誰來寫(這個工作階段有 plugin 的原始碼 repo,或只有安裝的版本)、每一列要帶哪些欄位,都在那一條。回報裡加一節列出寫了什麼;什麼都沒量到新的,就寫一句「這一批沒有要寫回的觀察」。你自己漏做的一步(本檔有寫、執行時沒照做)不寫進 plugin,在回報照實寫。 + ### 8. 下一步:依全文核對書目 全文連回記錄之後,下一步是 [`akashic-verify-work`](../akashic-verify-work/SKILL.md):讀這份全文的 byline 與成員名單,與 store 裡的作者列、標題、卷期頁比對,乾跑給人看、人同意後以 `update-entry --replace-authors` 整組替換作者列並記下依據(#742)。回報裡對已連回記錄的每一篇,提示可以接著跑它;**不要自動接著跑**——那一步要人確認。 @@ -568,6 +570,7 @@ CLI 是 `akashic update-entry --add-source `,加 `--apply` - [`assertions-must-be-measured`](../../rules/assertions-must-be-measured.md)——回報與 publishers.md 的每條站點描述都是關於世界的斷言,帶觀察日期 - [`source-of-truth-over-consent`](../../rules/source-of-truth-over-consent.md)——存進 `sources/` 的全文要核對過就是這一篇;使用者指定的連結是線索,對不上就不存 +- [`site-knowledge-goes-back-into-the-plugin`](../../rules/site-knowledge-goes-back-into-the-plugin.md)——一批做完、回報之前,把量到的站別做法寫回 publishers.md 與本檔(#822) - akashic-bootstrap 的 work-sources.md——DOI 反查與 OpenAlex 的兩個陷阱 - [safari-measurements.md](references/safari-measurements.md)——2026-11-20 在真的 Safari 上的量測(M0–M8):第 3 步關於新分頁、新視窗與對話框的每一條規則都指到它的某一列,或寫明沒有量過 - #613(本 skill;2026-09-28「最高原則:跟真人一樣」、2026-10-01 兩則裁決)、#614(`akashic.sources` 寫入入口)、#781/#780(預設由 Claude 做、一層層按、`fulltext attempt`)、PsychQuant/safari-browser#210(存檔方式的比較與 pdf-cache)、#375(`pdf-cache` 不認 WebKitCache Version 18)、#358(儲存面板按不到;它開著時讀到的只有 `unknown`,2026-11-20 實測的 M6)、#182(`wait --jitter`)、#183(CLI 沒有下載指令) diff --git a/plugin/skills/akashic-fetch-fulltext/references/publishers.md b/plugin/skills/akashic-fetch-fulltext/references/publishers.md index a452f5b7..dfee1558 100644 --- a/plugin/skills/akashic-fetch-fulltext/references/publishers.md +++ b/plugin/skills/akashic-fetch-fulltext/references/publishers.md @@ -17,16 +17,16 @@ | 站 | 已知行為 | `fetch` 的處置/交給人之後 | 觀察 | |---|---|---|---| -| Taylor & Francis(tandfonline.com)| 跳轉中繼頁先回 `readyState=complete`,文章頁還沒載入,此時找不到 PDF 連結 | `fetch` 等 PDF 連結出現(45 秒);頁面的 `/doi/pdf/` 連結 | 2026-09-23,6 篇成功(頁內 fetch;導航未量)| +| Taylor & Francis(tandfonline.com)| 跳轉中繼頁先回 `readyState=complete`,文章頁還沒載入,此時找不到 PDF 連結 | `fetch` 等 PDF 連結出現(45 秒);頁面的 `/doi/pdf/` 連結 | 2026-09-23,6 篇成功(頁內 fetch);導航之後的結果 2026-11-20 量到一篇:`pdf-shown`,見〈2026-11-20 的實測〉| | SAGE(journals.sagepub.com)| `citation_pdf_url` 指向 `/doi/reader/`(HTML 線上閱讀器)| 導航後分頁是 HTML → 結束碼 7 `html-page`:閱讀器上這篇自己的下載鈕由 Claude 按(見下方〈2026-11-10、2026-11-19 的實測〉SAGE 兩列) | 2026-09-23,3 篇成功(當時以拼出來的 `?download=true` 頁內 fetch;#613 起不拼)| | SAGE | 頁面 60 秒內 `readyState` 未到 `complete` | `interactive` 即可繼續 | 2026-09-23,1 篇 | -| Wiley(onlinelibrary.wiley.com)| 頁面的 `/doi/pdf/` 通到 HTML 檢視器 | 導航後分頁是 HTML → 結束碼 7 `html-page`:`snapshot -i` 讀得到這篇自己的下載鈕就由 Claude 按;epdf 閱讀器讀不到任何下載鈕(見下方實測 Wiley 一列)→「取不到」 | 2026-09-23,2 篇成功(當時以拼出來的 `pdfdirect` 頁內 fetch;#613 起不拼)| +| Wiley(onlinelibrary.wiley.com)| 頁面的 `/doi/pdf/` 通到 HTML 檢視器 | 導航後分頁是 HTML → 結束碼 7 `html-page`:`snapshot -i` 讀得到這篇自己的下載鈕就由 Claude 按;epdf 閱讀器讀不到任何下載鈕(見下方實測 Wiley 一列)→「取不到」 | 2026-09-23,2 篇成功(當時以拼出來的 `pdfdirect` 頁內 fetch;#613 起不拼)。**「epdf 閱讀器讀不到任何下載鈕」是 2026-11-10 那一篇量到的;2026-11-20 在學會子網域上的另一篇讀得到、也按成了**,見〈2026-11-20 的實測〉。所以到了 epdf 閱讀器先照 SKILL 讀那一頁,讀不到才是「取不到」| | APA PsycNet(psycnet.apa.org)| 有權限時 DOI 跳到 `/fulltext/.html`;有時停在 `doiLanding?doi=…`、只有 `/record/` 連結 | 頁面沒有 `fetch` 認得的 PDF 連結時 → 結束碼 3。**不拼** `/fulltext/.pdf`;Claude 照〈一層層按〉在頁面上找這篇自己的 PDF 連結 | 2026-09-23,3 篇成功(拼網址+頁內 fetch)| | APA PsycNet 無權限 | 書目頁只有 Login/Get Access;`/fulltext/.pdf` 回 HTTP 200、約 8,028 bytes、內容「Loading…」 | 「沒有權限」,不是起疑:「取不到(無權限)」,或改走下方〈EBSCO APA PsycInfo〉 | 2026-09-23,6 篇;2026-09-28,1 篇(Luce & Edwards, 1958);2026-10-07,1 篇(Marsh et al., 2013;手動開書目頁只有 Get Access。同一篇用 #613 之前的舊 shell 腳本跑,在 `doiLanding` 停於結束碼 6 `cloudflare-challenge`,但訊號網址是 sciencedirect.com 的 `__cf_chl_rt_tk`、不是 psycnet——舊腳本讀到哪一頁未查證)| | Annual Reviews(annualreviews.org)| 「download PDF」是 `href="#"` 的按鈕,外層是 POST 表單 `form.ft-download-content__form--pdf`;第一個 `.pdf` 連結是**補充資料** | 結束碼 7 `button`:Claude 按那個下載按鈕(只按,不代填、不另外送表單;按之前先確認不是補充資料的連結);`take` 的驗證會擋下補充資料。**2026-11-19 起的分工,按這個按鈕之後的行為沒有實測過** | 2026-09-23,1 篇(當時以表單頁內送出)| | Oxford Academic(academic.oup.com)| 頁內 fetch PDF 回 403「Just a moment…」(Cloudflare)| Cloudflare「Just a moment」→ 結束碼 8 **等人驗證**(使用者 2026-09-28 裁決;挑戰頁以 403 回應也一樣);頁面同時有封鎖句時整批暫停(結束碼 6)。2026-09-23 當時是改找 PMC 作者稿繼續——那是在被懷疑之後換路,2026-09-24 起不再這樣做 | 2026-09-23,1 篇 | | PubMed Central(pmc.ncbi.nlm.nih.gov)| 頁內 fetch PDF 回約 1.8 KB 的防爬蟲驗證頁(「preparing to download」、proof of work) | 那個驗證頁是**整批暫停**(使用者 2026-10-01:下載前驗證頁不當成等人驗證)。#613 拿掉了 `--prime`:它只是為了讓之後的頁內 fetch 過得去,導航本來就像讀者點連結 | 2026-09-23,1 篇成功(`--prime`+頁內 fetch)| -| Springer(link.springer.com)| 頁面自己的 PDF 連結是 `/content/pdf/.pdf`;curl 取同一個網址回 HTML | `fetch` 照頁面的連結導航;導航後顯示 PDF → 結束碼 7 `pdf-shown` | 2026-09-28,1 篇成功(頁內 fetch;導航未量;bronze OA)| +| Springer(link.springer.com)| 頁面自己的 PDF 連結是 `/content/pdf/.pdf`;curl 取同一個網址回 HTML | `fetch` 照頁面的連結導航;導航後顯示 PDF → 結束碼 7 `pdf-shown` | 2026-09-28,1 篇成功(頁內 fetch;bronze OA);導航之後 `pdf-shown` 見下方各批的實測(2026-11-20 一篇書章)| | ScienceDirect(sciencedirect.com)| 「View PDF」連結有兩種形狀(`/science/article/pii//pdf?md5=…&pid=…` 與 `/pdfft?md5=…&pid=…`),頁面上還有推薦文章的 `pdfft` 連結;由 DOI 猜 PII 不可靠。點 View PDF 先到「**Preparing your download**」中介頁(`cra_js_challenge`),再跳到 `pdf.sciencedirectassets.com` 的 S3 簽章網址(`X-Amz-Expires=300`);對已顯示的 PDF 再發一次請求會觸發 CAPTCHA | 中介頁 → 結束碼 6 **整批暫停**(使用者 2026-10-01);文章站上的 CAPTCHA 頁(「Are you a robot?」)→ 結束碼 8(導航之後的驗證另印 `--resume-stage followed`;驗證完分頁到 `pdf.sciencedirectassets.com` 也接得住)。導航之後分頁跑到 `pdf.sciencedirectassets.com`(別的主機):顯示 PDF → 結束碼 7 `pdf-shown`(使用者 2026-10-02;先前是 6);**那個主機上出現 CAPTCHA 字樣**(2026-09-28 的第二次 CAPTCHA 就是那樣)→ 結束碼 6,因為它既不是文章站、也不在已知驗證服務清單裡(使用者 2026-10-02)。**這一站目前沒有自動走得完的路**;PDF 的網路快取也不留(safari-browser#210 比對 4/4 不在快取裡)| 2026-09-28,3 篇成功(導航到簽章網址後頁內 fetch);同晚 2 次 CAPTCHA,見 #613 | | Optica(opg.optica.org)| 導航之前先以 curl 打了 DOI 頁與 `viewmedia.cfm`(第二次回「Please wait...」),隨後 Safari 導航即被導到 `/captcha/` | CAPTCHA → 結束碼 8。**不要在 Safari 之外先碰這個站**(最高原則規則 1) | 2026-09-28,1 篇 | | OSF/PsyArXiv、機構典藏(UvA)| — | 2026-09-23 以一般 HTTP 下載成功;**這條路自 #634 起不是本 skill 的取得方式**(一律經 Safari),經 `fetch` 取這幾站沒有量過——遇到照結束碼處理,新量到的寫在這一列 | 2026-09-23,4 篇成功(一般 HTTP 下載)| @@ -85,7 +85,7 @@ | Nature(Sci Rep)| `pdf-shown`(`/articles/.pdf`),快取取得,結束碼 0 | 自動 | 1 篇成功 | | MDPI | 導航到 `/pdf` 之後分頁不變(`tab-unchanged`),Safari 直接下載 `---v.pdf` 到下載資料夾;article number 比不了頁碼 → 結束碼 5 | 下載資料夾取檔;Claude 讀首頁確認 | 2 篇成功 | | Wolters Kluwer(Neurosurgery)| DOI 轉到 `www.ovid.com/jnls/neurosurgery/fulltext/...`,找不到 PDF 連結(結束碼 3)| 列入「需要人」 | 1 篇未取得 | -| Wiley | `/doi/pdf/` 是 HTML 閱讀器(`html-page`);`snapshot -i` 讀不到任何下載鈕(閱讀器多半在框架裡)| 列入「需要人」 | 1 篇未取得 | +| Wiley | `/doi/pdf/` 是 HTML 閱讀器(`html-page`);`snapshot -i` 讀不到任何下載鈕(閱讀器多半在框架裡)| 列入「需要人」 | 1 篇未取得(2026-11-20 另一篇讀得到,見〈2026-11-20 的實測〉)| | AME(jss.amegroups.org)| `/article/view//pdf` 是 HTML(`html-page`);`#pdfDownloadLink`「Download」按下去跳出 Safari 的「要允許在『jss.amegroups.org』上下載嗎?」;`dialog dismiss` 回「無法在預算內檢查所有視窗」| 權限對話框交給使用者親手按 | 1 篇待使用者 | | J-STAGE | `pdf-shown`(`/_pdf`),快取取得;首頁沒有 DOI 與卷期,第 2 頁起的頁首有 → 結束碼 5 | Claude 確認(頁首)| 1 篇成功 | | AJNR | `pdf-shown`(`.full.pdf`),快取取得,結束碼 0 | 自動 | 1 篇成功 | @@ -101,11 +101,29 @@ | Ovid/LWW(`ovid.com/jnls/<刊>/fulltext/…`)| 結束碼 3 | 頁面有「View full text」與「Download PDF」;「Download PDF」是這篇自己的連結,後面才接推薦文章。按下去,同一個分頁導到 `/pdf/…`,`save-pdf` 取得 | 2026-11-10,2 篇成功 | | Ovid/LWW,沒有權限 | 沒有回報 | 分頁在 `/abstract/`(#780 沒有寫那是 `fetch` 落的還是按了之後到的;#781 第 4 輪 verify 第 26 列),頁面只有「Check Access」「Log in for access」:沒有權限 | 2026-11-10,1 篇未取得 | | SAGE(journals.sagepub.com)| 結束碼 1 `points off-site`:`citation_pdf_url` 指到 Google Scholar | 文章頁的「PDF/EPUB」連到 `/doi/epub/…` 閱讀頁,閱讀頁上再按 `#favourite-download`(#780 正文的寫法;href 與 aria-label 是 2026-11-19 那一次讀到的,見下一列)。沒有產生下載檔,最後由使用者自己存 | 2026-11-10,1 篇 | -| SAGE,同一條路 | 結束碼 1 `points off-site` | 同上兩下:文章頁的「PDF/EPUB」連結(href `/doi/reader/`),閱讀頁上的 `a#favourite-download`(aria-label「Download PDF」,href 的路徑是 `/doi/pdf/`)。第二下之後 `click` 結束碼 0、分頁網址不變、之後 18 秒下載資料夾沒有新檔:**Safari 掛著的是「儲存為」面板**(PsychQuant/safari-browser#358),不是下載權限提示;使用者按「儲存」之後檔案才寫入,`take` 結束碼 0(標題、PDF metadata 的 DOI、頁數都相符)。所以這一站目前每一篇最後都要使用者按一次「儲存」(SKILL.md〈人機分工〉的 (c))。當時沒有讀 `documents --json` 的 `blocking_dialog`;2026-11-20 在本機測試頁上量到儲存面板開著時它是 `unknown`([safari-measurements.md](safari-measurements.md) 的 M6),照現在的 SKILL,按了之後讀到 `unknown` 就當場停下請使用者看(落點表第 5 種)——這一站會不會每一篇都這樣停一次,是從 M6 推出來的,沒有在這一站量過。2026-11-10 那一次沒有下載檔可能是同一個面板在等——這是推測,沒有查證 | 2026-11-19,1 篇成功 | +| SAGE,同一條路 | 結束碼 1 `points off-site` | 同上兩下:文章頁的「PDF/EPUB」連結(href `/doi/reader/`),閱讀頁上的 `a#favourite-download`(aria-label「Download PDF」,href 的路徑是 `/doi/pdf/`)。第二下之後 `click` 結束碼 0、分頁網址不變、之後 18 秒下載資料夾沒有新檔:**Safari 掛著的是「儲存為」面板**(PsychQuant/safari-browser#358),不是下載權限提示;使用者按「儲存」之後檔案才寫入,`take` 結束碼 0(標題、PDF metadata 的 DOI、頁數都相符)。所以這一站目前每一篇最後都要使用者按一次「儲存」(SKILL.md〈人機分工〉的 (c))。(2026-11-20 補:Safari 的下載位置設成固定資料夾的那一批,同樣兩下之後沒有出現面板、檔案直接寫入,見〈2026-11-20 的實測〉;「每一篇都要按一次」只在會跳儲存面板的設定下成立。)當時沒有讀 `documents --json` 的 `blocking_dialog`;2026-11-20 在本機測試頁上量到儲存面板開著時它是 `unknown`([safari-measurements.md](safari-measurements.md) 的 M6),照現在的 SKILL,按了之後讀到 `unknown` 就當場停下請使用者看(落點表第 5 種)——這一站會不會每一篇都這樣停一次,是從 M6 推出來的,沒有在這一站量過。2026-11-10 那一次沒有下載檔可能是同一個面板在等——這是推測,沒有查證 | 2026-11-19,1 篇成功 | | AME(jss.amegroups)| `.com` 轉到 `.org`,結束碼 7 `left-site` | 文章頁 Article Options 的「PDF」連結(`a.pdf` → `/article/view//pdf`)開成新分頁(開在視窗的哪個位置當時沒有記);新分頁裡的 `#pdfDownloadLink`「Download」按下去跳出 Safari 的下載權限提示,那一步由使用者按(這個提示在 `documents --json` 裡是什麼樣子沒有量過:2026-11-20 的量測裡它沒有出現) | 2026-11-10,1 篇 | -| Wiley epdf 閱讀器 | — | `snapshot -i` 讀不到任何下載鈕,由使用者自己存 | 2026-11-10 | +| Wiley epdf 閱讀器 | — | `snapshot -i` 讀不到任何下載鈕,由使用者自己存 | 2026-11-10(2026-11-20 另一篇讀得到,見〈2026-11-20 的實測〉)| | Project Euclid | 結束碼 7 `pdf-shown`(PDF 在文章站本身)| `save-pdf` 以 `--url` 鎖 `fetch` 交接出來的分頁,取得(當時的鎖法;現在照 SKILL 第 3 步〈`fetch` 之後的鎖分頁〉,不用 `--url`) | 2026-11-19,2 篇成功 | | Oxford Academic | 結束碼 7 `pdf-shown`(PDF 在 `watermark02.silverchair.com`)| `save-pdf` 取得,27 頁 | 2026-11-19,1 篇成功 | | ScienceDirect | 結束碼 7 `pdf-shown`(PDF 在 `pdf.sciencedirectassets.com`)| `save-pdf` 取得,29 頁;中途兩次人工驗證(#819,處置待使用者裁決) | 2026-11-19,1 篇成功 | `pdf-cache`:2026-11-10 與 2026-11-19 各試一次,都以同一個錯誤停下——Safari 的網路快取是 WebKitCache Version 18,`safari-browser pdf-cache`(v2.9.0)只認 Version 17(PsychQuant/safari-browser#375)。上表的 `pdf-shown` 都是 `save-pdf` 取得的。2026-11-19 的四篇 `pdf-shown` 是 1970 到 1997 年的文章,首頁都沒有印 DOI,`take` 都回結束碼 5,由 Claude 讀首頁確認後存入(SKILL.md 第 6 步);當時 acquisition 記成 `browser-cache`,SAGE 那一篇記成 `browser-download`——`browser-save-pdf` 這個值是之後才定的。 + +## 2026-11-20 的實測(#822:合併後的流程第一次用在真的出版商網站) + +一批九篇,使用者自己的 Safari profile、機構網路、固定一個視窗(`fetch` 以 `--window-id` 鎖定);plugin 0.13.17、`akashic fulltext contract` 印 13、safari-browser v2.9.0。Safari 的檔案下載位置是固定的「下載項目」資料夾——這是使用者當場的說明,沒有從命令列讀到(讀出這個設定見 PsychQuant/safari-browser#388)。機器當時負載很高(load average 60–100)。**每一列都只有表裡寫的篇數**;「成功」「沒有權限」只代表那個機構那一天。 + +| 站 | `fetch` 的結果 | 之後做了什麼、看到什麼 | 觀察 | +|---|---|---|---| +| SAGE(`journals.sagepub.com`,APM 2014)| 結束碼 1 `points off-site`:`citation_pdf_url` 指到 `scholar.google.com` | 兩下,各記一次嘗試:文章頁的「PDF/EPUB」(分頁到 `/doi/epub/…` 閱讀頁),閱讀頁的「Download PDF」(href `/doi/pdf/?download=true`)。第二下之後分頁網址不變,檔案在約 15 秒內直接出現在下載資料夾,**沒有儲存面板,使用者沒有按任何東西**;`take` 結束碼 0,17 頁。與 2026-11-19 那一篇(等使用者按「儲存」)的差別,使用者的說明是下載位置改成了固定資料夾;11-19 當天的設定沒有記錄,所以這不是同一天改設定前後各量一次的對照 | 1 篇成功 | +| SAGE(同一站,EPM 2014)| 結束碼 7 `html-page`:頁面自己的 `/doi/pdf/` 通到 HTML 頁 | 那一頁寫「Restricted access」「Get full access to this article」「Purchase access」:沒有權限、頁面提供購買(落點表第 7 種的 (d))。沒有按 | 1 篇,留給使用者決定 | +| Wiley 的學會子網域(`bpspsychub.onlinelibrary.wiley.com`,BJMSP 2014)| 結束碼 1 `points off-site`:頁面給的 PDF 連結在 `onlinelibrary.wiley.com`(母站,與文章頁不同主機;同一個樣子見 #726)| 兩下,各記一次嘗試:文章頁上同主機的 PDF 連結(分頁到 `/doi/epdf/…` 閱讀器),**閱讀器上這篇自己的「Download PDF」`snapshot -i` 讀得到**(href `/doi/pdfdirect/?download=true`)。第二下之後檔案直接出現在下載資料夾,沒有儲存面板;21 頁。當時 `take` 沒有帶 `--pages`,結束碼 5、讀首頁確認後存入;事後帶上條目的頁碼重跑是結束碼 0 | 1 篇成功 | +| Cambridge Core(`www.cambridge.org`;Psychometrika 2016、1989、1983,DOI 仍是 `10.1007/…`)| 三篇都是結束碼 7 `tab-unchanged`:落地在 `/core/journals/psychometrika/article/abs/…`,頁面的 PDF 連結在 `/core/services/aop-cambridge-core/content/view/…/….pdf`,導航之後分頁沒有離開摘要頁 | 15 秒內下載資料夾沒有新檔;等一次之後落點仍然沒變;`save-pdf` 探測回「text/html, not a PDF」;`bot-signals` 沒有命中。頁面上是「Get access」「Access through your institution」「Log in to your personal account」與「Add article to cart」:沒有權限、頁面提供購買。沒有按。這裡的 `tab-unchanged` 不是「連結直接開始下載」,是沒有權限時被送回摘要頁——這是從頁面上的字推出來的,沒有看到轉址本身 | 3 篇,留給使用者決定 | +| Taylor & Francis(`www.tandfonline.com`,JASA 2001)| 結束碼 7 `pdf-shown`:分頁在 `/doi/pdf/` 直接顯示 PDF | `save-pdf` 取得 11 頁(出版商封面頁加正文 10 頁;條目的頁碼是 10 頁,帶 `--pages` 時 `take` 仍判頁數相符、結束碼 0)| 1 篇成功 | +| Oxford Academic(`academic.oup.com`,Biometrika 1967)| 結束碼 7 `pdf-shown`:PDF 顯示在 `watermark02.silverchair.com`,交接時記號還在 | `save-pdf` 取得 7 頁。首頁沒有印 DOI,`take` 結束碼 5(帶 `--pages` 也是:頁數相符但沒有 DOI 可比),讀首頁以刊名、年份、卷期、起始頁確認後存入 | 1 篇成功 | +| SpringerLink(`link.springer.com`,2026 年的書章)| 結束碼 7 `pdf-shown`:分頁在 `/content/pdf/.pdf` | `save-pdf` 取得 26 頁;帶 `--pages` 時 `take` 結束碼 0 | 1 篇成功 | + +**對話框探測在這一批讀起來的樣子**(Safari 本身的行為,不是哪一站的):視窗裡都是 HTML 分頁時,`documents --json` 的 `blocking_dialog` 多數是 `clear`,偶爾一次 `unknown`/`incomplete`,等一次再讀又是 `clear`。第一個顯示 PDF 的分頁出現之後(上表 Taylor & Francis 那一篇),之後每一次讀取整個視窗的每一個分頁都是 `unknown`/`incomplete`、沒有訊息;使用者看過那個視窗,回答畫面上什麼都沒有掛著。這與 PsychQuant/safari-browser#345 記的是同一個樣子。**它碰到 SKILL 第 3 步〈一層層按〉的一條規則**:按之前讀到的不是 `clear` 就不按、仍然是 `unknown` 就停下整批。照那條規則,一批裡第一個 `pdf-shown` 的分頁出現之後,同一個視窗後面需要按的每一篇都會停下來問。這一批沒有碰到,是因為需要按的兩篇剛好排在第一個 PDF 分頁之前;那條規則要不要改,沒有使用者的裁決(#822)。 + +這一批的 `acquisition`:下載資料夾取得的兩篇是 `browser-download`,`save-pdf` 取得的三篇是 `browser-save-pdf`。存進 store 的 note 有兩筆寫了「記錄沒有頁碼」,那是錯的(條目有頁碼,是執行時沒有帶 `--pages`);note 目前沒有更正的入口,見 #824。 diff --git a/plugin/skills/akashic-import-wos/SKILL.md b/plugin/skills/akashic-import-wos/SKILL.md index 300c06d1..e83c6626 100644 --- a/plugin/skills/akashic-import-wos/SKILL.md +++ b/plugin/skills/akashic-import-wos/SKILL.md @@ -105,3 +105,4 @@ link),絕不靜默丟列。確認後的交接是**檔案**,不是口頭: - [`akashic-bootstrap`](../akashic-bootstrap/SKILL.md)——逐筆實體的補完;本 skill 是它上游的清單層 QA 閘 - [`assertions-must-be-measured`](../../rules/assertions-must-be-measured.md)——**intake 報告裡的每個計數與每次 Crossref 判定都受它管**:查得到就寫查到什麼、查不到就寫「在哪些來源、以什麼查詢、哪一天查無」,不寫「應該是」。分母定案是人要照著行動的數字,過寬的斷言會直接流進下游統計 - [`source-of-truth-over-consent`](../../rules/source-of-truth-over-consent.md)——匯入檔與 Crossref 對不上的欄位列為歧異、不擅選;使用者同意匯入,不等於同意寫入錯的值 +- [`site-knowledge-goes-back-into-the-plugin`](../../rules/site-knowledge-goes-back-into-the-plugin.md)——一批做完、回報之前,把這一批量到的網站或 API 行為(plugin 還沒有紀錄的、與 plugin 寫的不同的、照字面做不到的一步)寫回 plugin,並在回報列出寫了什麼(#822) diff --git a/plugin/skills/akashic-merge-twins/SKILL.md b/plugin/skills/akashic-merge-twins/SKILL.md index 92ce2c79..fc23e188 100644 --- a/plugin/skills/akashic-merge-twins/SKILL.md +++ b/plugin/skills/akashic-merge-twins/SKILL.md @@ -100,6 +100,7 @@ pmid),每次都是閘對。**預掃模擬閘就要用閘的粒度**;預掃 「應該是」;見 [`assertions-must-be-measured`](../../rules/assertions-must-be-measured.md) - 合併的依據是「兩筆確實是同一件作品」的證據——使用者指定「這兩筆合併」而證據不支持時 不合併;見 [`source-of-truth-over-consent`](../../rules/source-of-truth-over-consent.md) +- 本檔沒有自己的網頁取得步驟;過程中若經別的 skill 去讀外部網站,量到的站別做法在回報之前寫回 plugin;見 [`site-knowledge-goes-back-into-the-plugin`](../../rules/site-knowledge-goes-back-into-the-plugin.md)(#822) - 乾跑報告先行(逐組 keeper/doomed/證據/判定),`store-source` 存證拿 digest, 該 digest 就是每筆 judgement 的 `--rests-on` - REFUTE 逐組附理由;差集裁決史(誰的 abstract 被丟、為什麼)記入 store commit 與 diff --git a/plugin/skills/akashic-promote-literals/SKILL.md b/plugin/skills/akashic-promote-literals/SKILL.md index 357a4814..2c44276a 100644 --- a/plugin/skills/akashic-promote-literals/SKILL.md +++ b/plugin/skills/akashic-promote-literals/SKILL.md @@ -195,3 +195,4 @@ ambiguities 帶 tier:`initials`/`reorder` 碰撞=縮寫/重排共鍵,* - `.claude/rules/disambiguate-before-irreversible-writes.md`(在 Akashic-Library repo 裡,plugin 安裝處讀不到)——**上面「建檔前先分組異寫」那一段的正典**。它管的是「已識別的歧義要在不可逆寫入之前消解」,而 `bootstrap-people` 的「寧可分割絕不合併」屬於它明寫的那個限定:安全預設是「**無法消歧時**往哪邊倒」,不是「**可以消歧卻不做**」的許可。判準可機械檢查:那個歧義在操作之前是不是已經識別得出來(分組清單算得出來 → 已識別)。上游是 Foresay(使用者的一個私有 repo,讀不到)的 `response_types`(`not_clear` 的終端是「先消歧,然後重跑乾跑」) - [`assertions-must-be-measured`](../../rules/assertions-must-be-measured.md)——**本 skill 寫的 verdict 與每輪落進 issue 的計數都受它管**。計數是人要照著決定批次與宣告 campaign 完成的數字;verdict 是身分判定,另有規定(見該檔第 5 節) - [`source-of-truth-over-consent`](../../rules/source-of-truth-over-consent.md)——升格是身分判定,依據是證據;批次核准不等於每一筆都對,判不出來的留 literal +- [`site-knowledge-goes-back-into-the-plugin`](../../rules/site-knowledge-goes-back-into-the-plugin.md)——本檔沒有自己的網頁取得步驟;過程中若經別的 skill 去讀外部網站,量到的站別做法照這一條在回報之前寫回 plugin(#822) diff --git a/plugin/skills/akashic-venue-works/SKILL.md b/plugin/skills/akashic-venue-works/SKILL.md index 5b53b62a..e0d71862 100644 --- a/plugin/skills/akashic-venue-works/SKILL.md +++ b/plugin/skills/akashic-venue-works/SKILL.md @@ -170,6 +170,7 @@ O(n) index rebuild → 全批 **O(n²)**(2026-09-01 實測每筆 2 → 6 秒 見 [`assertions-must-be-measured`](../../rules/assertions-must-be-measured.md) - 期刊目錄只收本 skill 的篩選規則選中的作品,使用者同意也不加規則外的——目錄收什麼由規則 決定、不由誰點頭決定;見 [`source-of-truth-over-consent`](../../rules/source-of-truth-over-consent.md) +- 一批做完、回報之前,把這一批量到的期刊網站行為(plugin 還沒有紀錄的、與 [site-access.md](references/site-access.md) 寫的不同的)寫回 plugin,並在回報列出寫了什麼;見 [`site-knowledge-goes-back-into-the-plugin`](../../rules/site-knowledge-goes-back-into-the-plugin.md)(#822) - 83/17 的摘要覆蓋、零歧義歸戶、攣生規模都是 Psychological Methods 的數字——**換一份刊 要重量**,不當通則 - 本次量測中 OpenAlex 的書目欄位(頁碼等)與 Crossref 一致可追溯——**這些欄位**不構成 diff --git a/plugin/skills/akashic-verify-person/SKILL.md b/plugin/skills/akashic-verify-person/SKILL.md index a549080f..1ff129ca 100644 --- a/plugin/skills/akashic-verify-person/SKILL.md +++ b/plugin/skills/akashic-verify-person/SKILL.md @@ -171,3 +171,4 @@ akashic_resolve_people reject:["::", …] # 查過 - [`akashic-disambiguate`](../akashic-disambiguate/SKILL.md)——歧義列的判定;它的第 3 步會回頭用本 skill - [`assertions-must-be-measured`](../../rules/assertions-must-be-measured.md)——**本 skill 產出的每一句關於世界的話都受它管**:查得到就寫查到什麼、查不到就寫「查不到」並列出查過的來源,不寫「應該是」 - [`source-of-truth-over-consent`](../../rules/source-of-truth-over-consent.md)——ORCID、任期、異名的依據是權威來源;使用者說「他那時候就在那裡」而沒有出處時,那是線索 +- [`site-knowledge-goes-back-into-the-plugin`](../../rules/site-knowledge-goes-back-into-the-plugin.md)——一批做完、回報之前,把這一批量到的網站或 API 行為(plugin 還沒有紀錄的、與 plugin 寫的不同的、照字面做不到的一步)寫回 plugin,並在回報列出寫了什麼(#822) diff --git a/plugin/skills/akashic-verify-venue/SKILL.md b/plugin/skills/akashic-verify-venue/SKILL.md index 58ac9000..e5f0fc46 100644 --- a/plugin/skills/akashic-verify-venue/SKILL.md +++ b/plugin/skills/akashic-verify-venue/SKILL.md @@ -155,3 +155,4 @@ EOF - [`akashic-verify-person`](../akashic-verify-person/SKILL.md)——同一套 literal→verdict 紀律,不同 entity 域與證據源 - [`assertions-must-be-measured`](../../rules/assertions-must-be-measured.md)——**刊名沿革的每一句斷言都受它管**:查到哪一年改名就寫哪一年、查不到就寫「查不到」並列出查過的來源,不寫「應該是那時候改的」 - [`source-of-truth-over-consent`](../../rules/source-of-truth-over-consent.md)——改名年份、ISSN 的依據是期刊自己的沿革頁與 ISSN 中心;使用者提供的年份去核對,不直接寫 +- [`site-knowledge-goes-back-into-the-plugin`](../../rules/site-knowledge-goes-back-into-the-plugin.md)——一批做完、回報之前,把這一批量到的網站或 API 行為(plugin 還沒有紀錄的、與 plugin 寫的不同的、照字面做不到的一步)寫回 plugin,並在回報列出寫了什麼(#822) diff --git a/plugin/skills/akashic-verify-work/SKILL.md b/plugin/skills/akashic-verify-work/SKILL.md index 06a6871b..ca7a1332 100644 --- a/plugin/skills/akashic-verify-work/SKILL.md +++ b/plugin/skills/akashic-verify-work/SKILL.md @@ -211,6 +211,7 @@ esac - [`source-of-truth-over-consent`](../../rules/source-of-truth-over-consent.md)——團體署名與成員名單的依據是作品本身;使用者的話是線索 - [`assertions-must-be-measured`](../../rules/assertions-must-be-measured.md)——回報裡的每一句都要量過;拿不準就標無法核對 +- [`site-knowledge-goes-back-into-the-plugin`](../../rules/site-knowledge-goes-back-into-the-plugin.md)——本檔沒有自己的網頁取得步驟;過程中若經別的 skill 去讀外部網站,量到的站別做法照這一條在回報之前寫回 plugin(#822) - akashic-fetch-fulltext——取得全文、存進 `sources/`、連回 work(本 skill 的前一步) - akashic-verify-person——「這個 literal 是不是這個人」的身分判定 - #742(本 skill 與替換腿;2026-10-21 四項裁決、2026-10-24 裁決 3 改判) diff --git a/plugins/akashic-discovery/.claude-plugin/plugin.json b/plugins/akashic-discovery/.claude-plugin/plugin.json index 37a32382..b5a173a2 100644 --- a/plugins/akashic-discovery/.claude-plugin/plugin.json +++ b/plugins/akashic-discovery/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "akashic-discovery", - "version": "0.2.17", + "version": "0.2.18", "description": "Akashic-Library 文獻探索 skills(引用追溯、被引、關聯、作者與期刊著作)——依賴 akashic-mcp 的 canonical store。目前有 akashic-work-references(往回追一篇論文的參考文獻,#617);其餘由後續 issue 各自加入。", "author": { "name": "Che Cheng" diff --git a/plugins/akashic-discovery/skills/akashic-work-references/SKILL.md b/plugins/akashic-discovery/skills/akashic-work-references/SKILL.md index 6d32cc7e..4e7d5e74 100644 --- a/plugins/akashic-discovery/skills/akashic-work-references/SKILL.md +++ b/plugins/akashic-discovery/skills/akashic-work-references/SKILL.md @@ -215,6 +215,8 @@ warnings: **寫入以 source of truth 為準**:`cites` 的依據是種子的參考文獻;library 成員的依據是那個 library 的規則(目錄)、那份文件的參考文獻(文件型),或使用者的選擇(主題型)。使用者要求的寫入對不上時,改成正確的再寫,乾跑逐筆寫出「要求/依據/實際寫入」——見 [`source-of-truth-over-consent`](../../rules/source-of-truth-over-consent.md)。 +**量到的站別做法要寫回 plugin**:一批做完、回報之前,把這一批量到的網站或 API 行為(plugin 還沒有紀錄的、與 plugin 寫的不同的、照字面做不到的一步)寫回 plugin,並在回報列出寫了什麼——見 [`site-knowledge-goes-back-into-the-plugin`](../../rules/site-knowledge-goes-back-into-the-plugin.md)(#822)。 + ## 已知限制 - **切分是啟發式的**:斷點(頁首、圖表、補充資料或致謝等結束標題)之後是否接續,是用「作者按字母順序接得上、年份括號後接標題」判定的。作者—年份格式以外的清單(例如 `[AB99]` 標籤制書目、年份不帶括號的書目)、條目沒有按作者排序的清單、嚴重的排版會切錯。`warnings` 與「只在 PDF/只在 OpenAlex」兩類就是讓這些誤差被看見的地方。