Skip to content

知らない分野を、原文にたどりつくまで芋づる式に掘る Claude Code のスキル

Python

2.0: 人間が読む・見返す側を強化(ヘルプ・文書の見た目・README・CHANGELOG)と脆弱性レビューの直し

MaryCache65aecf21d563
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..8984604
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,102 @@
+# 変更履歴
+
+imozuruの版ごとの変更を記録します。
+書式は [Keep a Changelog](https://keepachangelog.com/ja/1.1.0/) に、版の番号は [セマンティック バージョニング](https://semver.org/lang/ja/) に沿っています。
+
+プラグインの `plugin.json` には版の番号を書いていません。
+mainにコミットが入るたびに、使っている人へ更新が届きます。
+版の番号はまとまった変更の区切りを示すために、この変更履歴とgitのタグ(`v2.0.0` など)だけに付けます。
+
+## [未公開]
+
+## [2.0.0] - リリース前
+
+1.0のimozuruは原文を集め、抜き書きとして見せるところまでを受け持っていました。
+AIの判断能力は、形式知・ノウハウを収集することで強化されます。
+原文に書かれた形式知・ノウハウを集めて、AIの判断の材料にすることが、1.0までの主な目的でした。
+
+2.0のメジャーアップデートでは受け持つ範囲を広げ、人間が見ることに重点を置いて強化しました。
+
+### 2.0の要点
+
+- **人間が読んで理解する**: 詳細レポートが調べた分野を読み手の水準に合わせた3編の解説にします。解説の1文ごとに原文の根拠が付きます。
+- **人間が見返す**: 調査記録のダッシュボードがすべてのトピックの進み具合と終了理由を1枚のページに並べます。
+- **どこからでも見る**: ダッシュボードをスマホから閲覧できます。
+- **同じ見た目で読む**: 抜き書き・詳細レポート・map.md・log.mdを、ダッシュボードと同じ見た目で表示します。
+
+### 追加
+
+- **詳細レポート**(`digest.py`・`digest.html`)
+ - 調べ終えたあとに、前提知識の違う読み手ごとに3編の解説を書きます(Lv1は前提知識の無い人、Lv2は近い分野を知っている人、Lv3は専門の人)。
+ - 解説の1文ごとに原文の引用を付け、引用が原文に在るかを機械で照合します。照合に通らない文が1つでもあれば、ページを作りません。
+ - 各編の末尾に、理解を確認する問いを置きます。
+ - 検索の全記録(検索語ごとのヒットの全件と、保存・取得失敗・未取得の区別)を、サイトごとの集計と一緒に載せます。
+- **検索の記録**(`queries.jsonl`)
+ - `digest.py add` と `chain.py --log` が検索語ごとのヒットを全件残します。
+- **調査記録のダッシュボード**(`dashboard.py`)
+ - 調査の置き場(既定 `~/research`)を読み、トピックごとの記録を1枚のページにまとめます。
+ - ホームに、終了理由・原文の取得元・周回数の集計を並べます。
+ - サイドバーからトピックを選ぶと、トピック詳細(論点・周回数・原文・文書)が開きます。
+ - 詳細レポートや抜き書きは、ダッシュボードの枠の中で開きます。
+ - サイドバーの検索は題名・疑問・用語・人物・媒体を対象にします。ひらがな・ローマ字・変換途中の入力でも一致します。
+ - サイドバーは画面に収まる分ずつページで送ります(ボタン・ホイール・上下のスワイプ)。
+ - スマホでは横のスワイプでサイドバーを開閉し、画面の最上部で下へ引くと記録を再読み込みします。
+ - ヘルプに、スマホとパソコンの画面の図と各部の説明を載せています。
+- **ダッシュボードの配信**(`dashboard.py --serve`)
+ - 127.0.0.1で、合言葉付きのURLとして配信します。Tailscaleなどで中継すれば、スマホから閲覧できます。
+ - 受け付けるHostは `127.0.0.1`・`localhost`・`*.ts.net` と、環境変数 `IMOZURU_SERVE_HOSTS` に並べた名前だけです(DNS rebindingへの備え)。
+ - `IMOZURU_SERVE_TOKEN` で固定する合言葉は16文字以上にします。短いと起動しません。
+ - 調査のフォルダや文書がシンボリックリンクなら、一覧にも配信にも書き出しにも入れません。
+ - ホーム画面に追加したときのアイコンと、ブラウザのタブのアイコンを付けました。
+- **文書だけの書き出し**(`dashboard.py --bundle`)
+ - ページと、各トピックの詳細レポート・抜き書き・map.md・log.mdだけを別の場所へ書き出します。原文(`sources/`)は含めません。
+- **PMCの記事の全文**(`fetch.py`・#12、@hattorimayumi0105 さん)
+ - PMCの記事のURLは、確認画面で止まるため、Europe PMCの全文XMLから取って見出し・段落ごとの .md にします。
+ - XMLの実体の宣言は文字コードに関係なく断り、要素の数と入れ子の深さに上限を設けています。
+- **map.mdの「題:」と「読み:」**
+ - 「題:」はサイドバーとトピック詳細の見出しに使う短い題名です(20字まで)。
+ - 「読み:」は、検索で漢字の語をひらがなやローマ字でも一致させるための読みです。
+- **文書の共通の見た目**(`skin.py`・`palette.py`)
+ - 抜き書き・詳細レポート・map.md・log.mdを、ダッシュボードと同じ見た目で表示します。
+ - map.mdとlog.mdは、見出し・箇条書き・表に組んで表示します。
+
+### 変更
+
+- 文書とダッシュボードで内部の呼び名を使っていた所を、読み手に通じる言葉へ置き換えました。
+ - 要る主張 → 調査の論点
+ - 付いた・一部だけ・付かなかった → 根拠あり・一部のみ・根拠なし
+ - 場 → 媒体
+ - 古い言葉で書いた `extracts.json` もそのまま読めます。
+- 全角の「#」「:」などを含む壊れたURLが1本あっても、ダッシュボード・詳細レポート・md の表示と取得が止まらないようにしました。
+- 原文のリンクは、HTMLでもPMCのXMLでも http(s) のものだけを残します。
+- 原文の保存がPDFと文字起こしの2つ目で失敗したときは、前の原文に戻します。
+- ページの書き出しの一時ファイルを、毎回別の名前で作るようにしました。
+- 抜き書きのページで、英語の引用に英語の言語指定を付けました。読み上げと書体の選択が英語として行われます。
+- 抜き書きのページと詳細レポートから、ページの作りを説明する前置きの文(「ここに並ぶ引用は、すべて原文をそのまま切り出したもの」など)を削りました。
+
+## [1.0.0] - 2026-10-21
+
+原文を集め、抜き書きとして見せる版です。
+形式知・ノウハウを収集して、AIの判断能力を強化することを目的にしています。
+最初の公開版(2026-10-13)から、利用者のイシューと外部のレビューで直した分までをまとめて1.0.0とします。
+
+### 主な内容
+
+- 知らない分野を、言葉・人・媒体から原文までたどる手順(SKILL.md)と、止めどきの判断(論点の全部に原文が付く・飽和・周回の上限・ログインか有料で取れない・依頼の時間や回数の上限)。
+- 原文の取得(`fetch.py`)、引用と著者の追跡(`chain.py`)、新着の見張り(`watch.py`)、抜き書きのページ(`report.py`)。
+- Claude Codeのプラグインとして導入できる形。
+
+### 1.0.0までに直したもの
+
+- 取り直しに失敗しても、保存済みの原文を残す(#1・#2)。
+- Windows(cp932)とPython 3.10で止まらない(#3)。
+- Shift_JIS・EUC-JPのページを、宣言された文字コードで読む。
+- YouTubeの自動字幕は動画の元の言語のものだけを取る(#6)。
+- http(s) 以外のURLを取りに行かない(#10)。
+- 日本語の字を含むURLと、Wで始まる題名で落ちない(#7・#9)。
+- 検索結果から来るURL・本文・フィードを、他人が細工したものとして扱う。
+- 文字の層が無いPDFのOCRで、言語データから言語を選び、意味をなさない読み取りを失敗として扱う(#11)。
+
+[未公開]: https://github.com/MaryCache/imozuru/compare/v2.0.0...HEAD
+[2.0.0]: https://github.com/MaryCache/imozuru/compare/v1.0.0...v2.0.0
+[1.0.0]: https://github.com/MaryCache/imozuru/releases/tag/v1.0.0
diff --git a/README.en.md b/README.en.md
index b314591..9678c7d 100644
--- a/README.en.md
+++ b/README.en.md
@@ -10,21 +10,27 @@
imozuru is a Claude Code skill that digs into an unfamiliar field, pulling one lead after another until it reaches the original sources.
It applies ideas from information-seeking research in library and information science, such as Bates's berrypicking, Ellis's model of information-seeking behaviour, and Kuhlthau's Information Search Process.
+An AI judges better in a field once it has collected that field's explicit knowledge and know-how.
+Gathering the explicit knowledge and know-how written in original sources, as material for the AI's judgement, has been imozuru's role from the start.
+The 2.0 major update puts the weight on what people read.
+It adds a detailed report that explains the field at the reader's level, and a dashboard that shows every investigation on one page.
+Changes by version are listed in [CHANGELOG.md](CHANGELOG.md) (in Japanese).
+
The name comes from *imozuru-shiki* (芋づる式), the Japanese idiom for things coming up one after another, like sweet potatoes pulled up on a single vine.
> **Language note**: The skill's instructions (`SKILL.md`), the messages from its scripts, and the labels on the extract page are in Japanese. Claude reads the instructions in any language, but this skill has only been tried with requests written in Japanese.
-## How it differs from just asking
+## How it differs from existing AI research methods
-Ask an LLM to "look into" something without a skill, and it reads the top few search results and returns a summary.
+Ask an LLM to "look into" something without a skill, and it tends to read the top few search results and return a summary.
A summary is quick to read, but the details users need for their own judgement tend to drop out.
-And while users don't know the field's terms they can't choose good search words, so they never get past the words they first thought of.
+And while users don't know the field's terms they can't choose good search words, so the search ends up staying within the words they first thought of.
-imozuru first finds the field's terms, its central people, and the venues where knowledge collects, then follows citations, links, and authors from there to gather original sources.
+imozuru first finds *the field's terms, its central people, and the venues where knowledge collects*, then follows citations, links, and authors from there to gather original sources.
It saves them without summarising and goes only as far as pointing, for each point the answer needs, to "which file, which lines".
-Reading the sources and making the judgement is up to the user.
+The AI uses the gathered sources as material for its judgement, and the user can read the sources at the locations given to check what that judgement rests on.
-## How it works
+## The skill's flow
```mermaid
flowchart LR
@@ -34,6 +40,8 @@ flowchart LR
D --> E{Does every point<br>have a source?}
E -- not yet --> C
E -- yes, or saturated --> F[Build the<br>extract page]
+ F --> G[Build the<br>detailed report]
+ G --> H[Look back on the<br>dashboard]
```
Claude first writes down the question and the 3 to 6 points needed to answer it.
@@ -43,9 +51,10 @@ In fields without papers, it follows links inside articles and notes such as "I
Sources it finds are saved to `sources/`, and 404 pages and login walls are dropped after checking their content.
When every point has a source, or no new sources turn up, the search stops.
-Finally, it builds a page that lists passages cut from the sources, point by point (the extract page).
+Finally, it builds a page that lists passages cut from the sources, point by point (the extract page), and an explanation of the field (the detailed report).
-In watch mode, it collects new posts from the venues a dig turned up (Qiita and Zenn tags, note, YouTube, blogs, arXiv) via RSS and lists them.
+Watch mode (`/imozuru watch <topic>`) runs separately from the investigation flow above.
+It collects new posts from the venues a dig turned up (Qiita and Zenn tags, note, YouTube, blogs, arXiv) via RSS and lists them.
## Install
@@ -107,7 +116,7 @@ Gaussian Splatting ってよく聞くけど全然わからない。論文とか
Results are saved to `~/research/<topic>/` in this form.
```
-map.md question, research points, terms, people, venues, source table, next leads
+map.md question, short title, research points, terms, people, venues, source table, next leads
log.md per round: what was searched, what turned up, decisions and why
sources/ saved sources
extracts.json extracts
@@ -118,14 +127,62 @@ digest.json explanation for the detailed report
digest.html detailed report (explanations at Lv1 to Lv3, plus the full search record)
```
-Running `python3 skills/imozuru/scripts/dashboard.py ~/research` builds a page that brings every investigation together (`~/research/index.html`).
+## Reading and looking back
+
+The sources are shown in forms a person can read and judge for themselves.
+
+### Extract page
-A sample extract page is in `examples/demo/`, and this command tries the script on its own.
+A page that lists passages cut from the sources, point by point.
+A sample is in `examples/demo/`, and this command tries the script on its own.
```sh
python3 skills/imozuru/scripts/report.py examples/demo
```
+Why the passages are checked by machine is explained under "Why extracts are checked by machine" below.
+
+### Detailed report
+
+A page that explains the field in three versions for readers with different background knowledge.
+Every sentence carries a quotation from a source as its evidence, and the full record of what was searched and what turned up comes with it.
+Claude writes the explanation once the search has stopped, and `digest.py` checks every quotation against the sources before building the page.
+Why it has two layers, explanation and record, is explained under "The two layers of the detailed report" below.
+
+### Research dashboard
+
+<img src="assets/screenshots/dashboard.webp" alt="The research dashboard. Topics are listed in the sidebar on the left, and the details of the selected topic are open on the right" width="720">
+
+This page was added in 2.0.
+The dashboard brings every investigation in the research folder (by default `~/research`) together on one page, one topic each.
+A topic is one question and everything gathered for it, which is one folder inside `~/research`.
+
+```sh
+python3 skills/imozuru/scripts/dashboard.py ~/research
+```
+
+This writes `~/research/index.html`.
+The home view summarises why each investigation stopped, where the sources came from, and how many rounds of following citations and links it took.
+Choosing a topic in the sidebar opens its details: research points, rounds, sources, and documents; the detailed report and the extract page open inside the same view.
+The sidebar search covers titles, questions, terms, people, and venues, and also matches hiragana and romaji.
+The "?" button at the top right opens the help, which explains each part of the screen.
+The dashboard's labels are in Japanese.
+
+### On a phone
+
+Serving the dashboard lets you open it in a phone's browser.
+
+```sh
+IMOZURU_SERVE_TOKEN=<passphrase> python3 skills/imozuru/scripts/dashboard.py ~/research --serve 8765
+tailscale serve --bg 8765
+```
+
+The server listens only inside the PC (127.0.0.1), and a page opens only with the passphrase in its URL.
+From the phone, relay it to your own devices with Tailscale and open `https://<pc-name>.<tailnet>.ts.net/?k=<passphrase>`.
+`<tailnet>` is the network name shown in the Tailscale admin console.
+The environment variable `IMOZURU_SERVE_TOKEN` fixes the passphrase (16 characters or more).
+Without it, the passphrase changes on every start, and an icon added to the home screen stops opening the page.
+
## Design
### Why it does not summarise
@@ -138,10 +195,10 @@ Explanation is written only after the stop decision, in the detailed report.
There are two conditions.
The first is that every point has a location in a source, following HALT by Roh and Han (2026), which decides when to stop by whether the evidence is in.
-To keep the points from being too easy, at least one carries a condition from the request's own wording, and more than half cannot be answered without reading a source.
+To keep the points from all being answerable without reading a source, at least one carries a condition from the request's own wording, and more than half cannot be answered without reading a source.
The second is saturation: if 70% or more of the sources the two searchers list are already on the map, the search stops.
-This borrows the idea of estimating a total from the overlap between two independent searches (Kastner 2007), and the 70% is a provisional threshold set while trying the skill out.
+This borrows the idea of estimating a total from the overlap between two independent searches (Kastner 2007), and the 70% is a provisional threshold set through trial runs.
### Why it does not commit to one direction
@@ -163,14 +220,19 @@ imozuru follows those the same way it follows papers, so each saved source gets
Dozens of saved sources leave the user with no idea where to start.
So, following extracting from Ellis's model, the skill builds a page that cuts the relevant passage from a source for each point.
-`report.py` checks that each extract appears verbatim at the given lines of its source, and if even one word differs, it does not build the page.
+So that no paraphrase slips in when Claude cuts out the passages, `report.py` checks that each extract appears verbatim at the given lines of its source, and if even one word differs, it does not build the page.
### The two layers of the detailed report
+The detailed report was added in 2.0.
Extracts alone do not tell a newcomer what the terms mean or what to read first.
So after stopping, the skill builds a detailed report with two layers: explanation and record.
The explanation comes in three levels.
-Lv1 tells readers with no background what happens, Lv2 explains the mechanism to readers who know a neighbouring field, and Lv3 tells specialists where the standard account has been revised and what is still open.
+
+- Lv1: what happens, for readers with no background.
+- Lv2: the mechanism, for readers who know a neighbouring field.
+- Lv3: where the standard account has been revised and what is still open, for specialists.
+
At every level, each sentence carries a verbatim quote from a source as its evidence.
`digest.py` checks those quotes the same way as the extracts, and refuses to build the page if any sentence lacks one.
The record is assembled by machine from every hit of every query and from the fetch results, so it shows everything that was searched and found, including queries that found nothing.
diff --git a/README.md b/README.md
index 9302b2d..8ac9cc6 100644
--- a/README.md
+++ b/README.md
@@ -7,29 +7,38 @@
日本語 | [English](README.en.md)
-imozuruは、知らない分野を、原文にたどりつくまで芋づる式に掘るClaude Codeのスキルです。
-Batesのberrypicking、Ellisの探索行動のモデル、Kuhlthauの探索過程の研究など、図書館情報学の情報探索の研究から、考え方を応用しています。
+imozuruは知らない分野を原文にたどりつくまで芋づる式に掘るClaude Codeのスキルです。
+Batesのberrypicking、Ellisの探索行動のモデル、Kuhlthauの探索過程の研究など、図書館情報学の情報探索の研究から考え方を応用しています。
-## ふつうに頼んだときとの違い
+AIの判断能力は、形式知・ノウハウを収集することで強化されます。
+原文に書かれた形式知・ノウハウを集めて、AIの判断の材料にすることが、imozuruの元からの役割です。
-スキルなしで「調べて」と頼むと、LLMは検索上位の数件を読んで要約を返します。
-要約はすぐに読めますが、判断に必要な細部が落ちやすい欠点を抱えています。
-分野の用語を知らないうちは検索語も選べないため、最初に思いついた言葉の範囲から先へ進めません。
+2.0のメジャーアップデートでは、人間が読むことに重点を置いて強化しました。
+調べた分野を読み手の水準に合わせて解説する詳細レポートと、すべての調査を1枚で見返せるダッシュボードを追加しています。
+版ごとの変更は [CHANGELOG.md](CHANGELOG.md) に記載しています。
-imozuruはまず分野の用語、中心にいる人、知見が集まる媒体を押さえ、そこから引用やリンク、著者をたどって原文を集めます。
-集めた原文は要約せずに保存し、答えに必要な論点ごとに「どのファイルの何行目か」を示すに留まります。
-原文を読んで判断するのは、ユーザー自身です。
+## 既存のAI調査手法との差別化点
-## 動き方
+スキルなしで「調べて」と頼むと、LLMは検索上位の数件を読んで要約を返しがちです。
+要約はすぐに読めますが、判断に必要な細部が抜け落ちやすくなります。
+分野の用語を知らないうちは検索語も選べないため、検索は最初に思いついた言葉の範囲にとどまってしまいます。
+
+imozuruはまず『分野の用語・中心にいる人・知見が集まる媒体』を押さえ、そこから引用やリンク、著者をたどって原文を集めます。
+集めた原文は要約せずに保存し、答えに必要な論点ごとに「どのファイルの何行目か」を示すところまでにとどめます。
+AIは集めた原文を材料に判断し、ユーザーは示された場所の原文を読んで、その判断の根拠を確認できます。
+
+## スキルのフロー
```mermaid
flowchart LR
A[問いと<br>調査の論点を書く] --> B[地図づくり<br>用語・人・媒体]
B --> C[たどる<br>引用・リンク・著者]
- C --> D[原文を落とす]
+ C --> D[原文を保存する]
D --> E{調査の論点に<br>原文が付いた?}
E -- まだ --> C
E -- 付いた・飽和した --> F[抜き書きの<br>ページを作る]
+ F --> G[詳細レポートを<br>作る]
+ G --> H[ダッシュボードで<br>見返す]
```
Claudeはまず、問いと、答えるために必要な論点を3〜6個書き出します。
@@ -39,9 +48,10 @@ Claudeはまず、問いと、答えるために必要な論点を3〜6個書き
見つけた原文は `sources/` に保存し、404やログインを求めるページは中身を見て除きます。
すべての論点に原文が付くか、新しい資料が出てこなくなったら探すのをやめます。
-最後に、原文から切り出した文を論点ごとに並べたページ(抜き書きのページ)を作ります。
+最後に、原文から切り出した文を論点ごとに並べたページ(抜き書きのページ)と、その分野の解説(詳細レポート)を作ります。
-見張りのモードでは、掘って見つけた媒体(QiitaやZennのタグ、note、YouTube、ブログ、arXiv)の新着をRSSで集めて並べます。
+見張りのモード(`/imozuru watch <話題>`)は、ここまでの調査の流れとは別に動きます。
+掘って見つけた媒体(QiitaやZennのタグ、note、YouTube、ブログ、arXiv)の新着をRSSで集めて並べます。
## 入れ方
@@ -56,7 +66,7 @@ Claudeはまず、問いと、答えるために必要な論点を3〜6個書き
プラグインには版の番号を付けていないので、main にコミットが入るたびに新しい版として扱われます。
自動で最新にしたいときは、`/plugin` のマーケットプレイスの画面で imozuru の自動更新を入れてください。
-手で更新するときは `claude plugin marketplace update imozuru` を流します。
+手で更新するときは `claude plugin marketplace update imozuru` を実行します。
### skills のCLI
@@ -101,9 +111,9 @@ Gaussian Splattingってよく聞くけど全然わからない。論文とか
結果は `~/research/<話題>/` に、次の形で保存されます。
```
-map.md 問い・調査の論点・用語・人・媒体・原文の表・次の手がかり
+map.md 問い・題・調査の論点・用語・人・媒体・原文の表・次の手がかり
log.md 周ごとに、何を探して何が出たか・判断とその理由
-sources/ 落とした原文
+sources/ 保存した原文
extracts.json 抜き書き
report.html 抜き書きのページ
queries.jsonl 検索語ごとのヒットの全件
@@ -112,14 +122,64 @@ digest.json 詳細レポートの解説
digest.html 詳細レポート(Lv1〜Lv3 の解説と、検索の全記録)
```
-`python3 skills/imozuru/scripts/dashboard.py ~/research` を回すと、すべての調査をまとめて見返すページ(`~/research/index.html`)ができます。
+## 人間が読む・見返す
+
+集めた原文は、人間が読んで判断できる形で見せます。
+
+### 抜き書きのページ
-抜き書きのページの見本は `examples/demo/` にあり、次のコマンドでスクリプトだけを試せます。
+原文から切り出した文を、調査の論点ごとに並べたページです。
+見本は `examples/demo/` にあり、次のコマンドでスクリプトだけを試せます。
```sh
python3 skills/imozuru/scripts/report.py examples/demo
```
+切り出した文を機械で照合する理由は、下の「抜き書きを機械で照合する理由」に書いています。
+
+### 詳細レポート
+
+調べた分野を、前提知識の違う読み手ごとに3編で解説するページです。
+解説の1文ごとに原文の引用が根拠として付き、何を探して何が出たかの全記録も一緒に載ります。
+
+調べ終えたあとにClaudeが解説を書き、`digest.py` が引用を原文と照合してからページにします。
+解説と記録の2層に分けた理由は下の「詳細レポートの2層」に書いています。
+
+### 調査記録のダッシュボード
+
+<img src="assets/screenshots/dashboard.webp" alt="調査記録のダッシュボード。左のサイドバーにトピックが並び、右に選んだトピックの詳細が開いている" width="720">
+
+2.0で追加したページです。
+調査の置き場(既定 `~/research`)にあるすべての調査を、トピックごとに1枚のページへまとめます。
+トピックは1つの問いを調べたひとまとまりで、`~/research` の中のフォルダ1つに当たります。
+
+```sh
+python3 skills/imozuru/scripts/dashboard.py ~/research
+```
+
+`~/research/index.html` ができます。
+
+ホームには、調べるのをやめた理由(終了理由)・原文の取得元・引用やリンクをたどった回数(周回数)の集計が並びます。
+左のサイドバーからトピックを選ぶと、調査の論点・周回数・原文・文書をまとめたトピック詳細が開き、詳細レポートや抜き書きもその中で読めます。
+サイドバーの検索は題名・疑問・用語・人物・媒体を対象にし、ひらがなやローマ字でも一致します。
+画面の使い方は右上の「?」から開くヘルプにまとめています。
+
+### スマホで見る
+
+ダッシュボードを配信すると、スマホのブラウザからも閲覧できます。
+
+```sh
+IMOZURU_SERVE_TOKEN=<合言葉> python3 skills/imozuru/scripts/dashboard.py ~/research --serve 8765
+tailscale serve --bg 8765
+```
+
+配信はPCの中(127.0.0.1)だけで待ち受け、合言葉の付いたURLでしか開けません。
+スマホからはTailscaleで自分の機器にだけ中継して、`https://<PCの名前>.<tailnet>.ts.net/?k=<合言葉>` を開きます。
+`<tailnet>` は、Tailscaleの管理画面に出るネットワークの名前です。
+
+合言葉は環境変数 `IMOZURU_SERVE_TOKEN` で固定できます(16文字以上)。
+固定しないと起動のたびに変わり、ホーム画面に追加したアイコンから開けなくなります。
+
## 設計の考え方
### 要約しない理由
@@ -132,14 +192,14 @@ Kuhlthau(1991)は、調べ始めの混乱した段階で詳しくまとめ
止める条件は2つです。
1つ目は、すべての論点に原文の場所が付くことで、証拠がそろったかで止めどきを決めるRohとHan(2026)のHALTにならいました。
-論点が甘くならないよう、少なくとも1つは依頼の言葉の条件をそのまま含め、半分以上は原文を読まないと答えられない形にしています。
+論点が原文を読まずに答えられる形ばかりにならないよう、少なくとも1つは依頼の言葉の条件をそのまま含め、半分以上は原文を読まないと答えられない形にしています。
2つ目は飽和で、2本の検索役が挙げた資料の7割以上がすでに地図にあれば止めます。
-独立した2回の探索の重なりから全体の数を見積もる考え方(Kastner 2007)を借りたもので、7割は試しながら決めた仮の目安です。
+独立した2回の探索の重なりから全体の数を見積もる考え方(Kastner 2007)を借りたもので、7割は試行で決めた仮の目安です。
### 方向を1つに決めない理由
-Zhouら(2026)のHypoSearchによると、AIの検索は方向がいくつもありうる段階で1つを選び、後の検索でもその道を選び続けて失敗しがちです。
+Zhouら(2026)のHypoSearchによると、AIの検索は方向がいくつもありうる段階で1つを選び、後の検索も同じ方向へ重ねて失敗しがちです。
そこで迷ったときは、別の仮説を持たせた検索役を2本並べ、結果を比べてから進みます。
### 論文のない分野の扱い
@@ -157,17 +217,22 @@ imozuruはそうした記事も論文と同じようにたどるので、保存
原文を何十本も保存しただけでは、どこから読めばよいか分かりません。
そこでEllisのモデルにある抜き書き(extracting)にならい、論点ごとに原文の該当部分を切り出したページを作ります。
-`report.py` は、切り出した文が原文の指定の行にそのまま在るかを照合し、1語でも違えばページを作りません。
+Claudeが切り出すときに言い換えが紛れ込まないよう、`report.py` は、切り出した文が原文の指定の行にそのまま在るかを照合し、1語でも違えばページを作りません。
### 詳細レポートの2層
+詳細レポートは2.0で追加した文書です。
抜き書きだけでは、その分野を知らない人には言葉の意味も読む順も分かりません。
そこで止めたあとに、解説と記録の2層からなる詳細レポートを作ります。
解説は読み手の水準で3編に分けます。
-Lv1は前提知識の無い人向けに何が起きているかを、Lv2は近い分野を知っている人向けに仕組みを、Lv3はその分野の専門の人向けに通説の修正や未決着の点を書きます。
-どの編も、1文ごとに原文からの引用を根拠として付けます。
+
+- Lv1:前提知識の無い人向けに、何が起きているかを書きます。
+- Lv2:近い分野を知っている人向けに、仕組みを書きます。
+- Lv3:その分野の専門の人向けに、通説の修正や未決着の点を書きます。
+
+どの編も1文ごとに原文からの引用を根拠として付けます。
`digest.py` は抜き書きと同じ方法で引用を照合し、根拠の無い文が1つでもあればページを作りません。
-記録は、検索語ごとのヒットの全件と取得の結果から機械で組むので、空振りの検索語も含めて、何を探して何が出たかがそのまま見えます。
+記録は検索語ごとのヒットの全件と取得の結果から機械で組むので、空振りの検索語も含めて、何を探して何が出たかがそのまま見えます。
## 決まりの出典
diff --git a/assets/screenshots/dashboard.webp b/assets/screenshots/dashboard.webp
new file mode 100644
index 0000000..d3cac39
Binary files /dev/null and b/assets/screenshots/dashboard.webp differ
diff --git a/skills/imozuru/SKILL.md b/skills/imozuru/SKILL.md
index 9df94a2..5830f58 100644
--- a/skills/imozuru/SKILL.md
+++ b/skills/imozuru/SKILL.md
@@ -216,6 +216,8 @@ map.md を下の書式で作り、**問い**と、答えるのに要る**論点*
# map: <話題>
問い: <1〜2行>
+題: <履歴のページの一覧と見出しに出す短い名前。20字まで>
+読み: <問いの中の漢字の語の読み。ひらがなで、空白で区切る>
最初の検索語: <最初に使った言葉>
## 調査の論点
@@ -238,6 +240,8 @@ map.md を下の書式で作り、**問い**と、答えるのに要る**論点*
- <まだたどっていないもの> — <なぜたどる価値がありそうか>
```
+「読み:」は、履歴のページの一覧の検索で、漢字の語をひらがなやローマ字でも当てるためのもの(夕焼け を ゆうやけ・yuuyake で)。カタカナと英字の語は書かなくても当たる。読みの辞書は外部のデータしか無く、標準ライブラリだけでは付けられないので、問いを書くときに一緒に書く。
+
節の順番は変えない。追記は各節の末尾に足す(周をまたいで表が散らばるのを防ぐ)。原文の表は1論文1行で、PDF と .txt、抄録の .md のように複数のファイルがあれば同じ行に並べる。検索役由来で原文を開いていない行には(未確認)を付ける。
原文の表の「論文・資料」の欄には、頭に**種類の印**を1つ付ける。点数はつけない。どれを信じるかはユーザーが原文を読んで決める。
@@ -268,6 +272,7 @@ map.md を下の書式で作り、**問い**と、答えるのに要る**論点*
- `scripts/report.py <topic_dir> [--check]` — extracts.json の抜き書きを原文と照合し、合えば report.html にする。`--check` は照合だけ
- `scripts/digest.py add <topic_dir> [--round N] [--by 誰]` — 標準入力の JSON(検索語ごとのヒット)を queries.jsonl に足す。`scripts/digest.py <topic_dir> [--check]` — digest.json の解説の引用を原文と照合し、合えば検索の記録と合わせて digest.html にする
- `scripts/dashboard.py [research_dir] [--runs runs.md]` — 調査の置き場(既定 `~/research`)を走査して、調べものの履歴のページ `index.html` を作る。ホームに区切った理由・原文を取得した媒体・たどった周の数の集計、左の一覧から各調査の詳細(論点・周・原文・文書へのリンク)。数字はフォルダの記録から数え、記録の無い所は「記録なし」と出す
+- `scripts/dashboard.py [research_dir] --bundle <dir>` — 履歴のページと各調査の文書(詳細レポート・抜書き・map.md・log.md)だけを `<dir>` に写す。原文(sources/)は写さない。入れたファイルの一覧を出す。束には原文からの引用が入るので、公開の場所へは置かない。スマホで見る載せ方は検討中(下書き)
- `scripts/watch.py add|list|check` — 見張り。RSS / Atom を引いて前回からの新着を出す。検索を使わないので費用はかからず結果も揺れない。DOCTYPE・ENTITY を含むフィードは安全のため読まない。フィードの場所にタブや改行が入っていたら足さない
- `scripts/chain.py find|refs|cites|author [--log <topic_dir> --round N]` — OpenAlex で引用と著者をたどる。`--log` を付けると出した一覧を queries.jsonl に足す。1日 1,000 回まで無料の枠で、プリペイド残高が 0 なら超えても止まるだけ。**API キーや支払いの登録はしない**。古めの論文に強く、新しい論文と同名の多い著者に弱い(author は名前の検索の1位を使うので、同名の別人の論文を返すことがある。出力の「# 別の候補」に別人の ID が並ぶので、所属と論文数で確かめ、違えば `chain.py author A…` で引き直す。ただし OpenAlex の著者の記録は、古い論文ほど当てにならない。著者の欄に ID が無い論文や、同名の何人もの論文を1人にまとめた記録がある(試行では、情報探索の Ellis の 1989 年の論文には ID が無く、1993 年の論文は所属が国際ポテトセンターで論文289本の記録に入っていた)。著者で追うときは、所属先や本人のページにある論文の一覧を検索役に探させ、chain.py author の結果はその一覧と突き合わせる)
- ファイル名は `<著者>-<年>-<短い題>`、arXiv は `arxiv-<番号>-<短い題>`
diff --git a/skills/imozuru/assets/apple-touch-icon.png b/skills/imozuru/assets/apple-touch-icon.png
new file mode 100644
index 0000000..7684ca8
Binary files /dev/null and b/skills/imozuru/assets/apple-touch-icon.png differ
diff --git a/skills/imozuru/assets/cork.png b/skills/imozuru/assets/cork.png
new file mode 100644
index 0000000..961da39
Binary files /dev/null and b/skills/imozuru/assets/cork.png differ
diff --git a/skills/imozuru/assets/favicon.png b/skills/imozuru/assets/favicon.png
new file mode 100644
index 0000000..783c062
Binary files /dev/null and b/skills/imozuru/assets/favicon.png differ
diff --git a/skills/imozuru/assets/guide-pc-doc.webp b/skills/imozuru/assets/guide-pc-doc.webp
new file mode 100644
index 0000000..3feac95
Binary files /dev/null and b/skills/imozuru/assets/guide-pc-doc.webp differ
diff --git a/skills/imozuru/assets/guide-pc-home.webp b/skills/imozuru/assets/guide-pc-home.webp
new file mode 100644
index 0000000..d1d4a97
Binary files /dev/null and b/skills/imozuru/assets/guide-pc-home.webp differ
diff --git a/skills/imozuru/assets/guide-pc-side.webp b/skills/imozuru/assets/guide-pc-side.webp
new file mode 100644
index 0000000..5146465
Binary files /dev/null and b/skills/imozuru/assets/guide-pc-side.webp differ
diff --git a/skills/imozuru/assets/guide-pc-topic.webp b/skills/imozuru/assets/guide-pc-topic.webp
new file mode 100644
index 0000000..a2235d6
Binary files /dev/null and b/skills/imozuru/assets/guide-pc-topic.webp differ
diff --git a/skills/imozuru/assets/guide-sp-doc.webp b/skills/imozuru/assets/guide-sp-doc.webp
new file mode 100644
index 0000000..0998ef7
Binary files /dev/null and b/skills/imozuru/assets/guide-sp-doc.webp differ
diff --git a/skills/imozuru/assets/guide-sp-home.webp b/skills/imozuru/assets/guide-sp-home.webp
new file mode 100644
index 0000000..19c81ab
Binary files /dev/null and b/skills/imozuru/assets/guide-sp-home.webp differ
diff --git a/skills/imozuru/assets/guide-sp-side.webp b/skills/imozuru/assets/guide-sp-side.webp
new file mode 100644
index 0000000..c093e05
Binary files /dev/null and b/skills/imozuru/assets/guide-sp-side.webp differ
diff --git a/skills/imozuru/assets/guide-sp-topic.webp b/skills/imozuru/assets/guide-sp-topic.webp
new file mode 100644
index 0000000..0486b68
Binary files /dev/null and b/skills/imozuru/assets/guide-sp-topic.webp differ
diff --git a/skills/imozuru/assets/paper.png b/skills/imozuru/assets/paper.png
new file mode 100644
index 0000000..76b0e4e
Binary files /dev/null and b/skills/imozuru/assets/paper.png differ
diff --git a/skills/imozuru/scripts/chain.py b/skills/imozuru/scripts/chain.py
index 44560d3..7d2e5f1 100755
--- a/skills/imozuru/scripts/chain.py
+++ b/skills/imozuru/scripts/chain.py
@@ -225,18 +225,29 @@ def log(topic: str, round_: int, cmd: str, key: str, works: list[dict]) -> None:
from pathlib import Path
sys.path.insert(0, str(Path(__file__).resolve().parent))
import digest # 同じフォルダ。--log を使うときだけ読む
+
+ def http_url(u):
+ if not isinstance(u, str):
+ return False
+ try:
+ return urllib.parse.urlsplit(u).scheme in ("http", "https")
+ except ValueError:
+ return False
+
hits = []
for w in works:
- oa = (w.get("best_oa_location") or {}).get("pdf_url")
- url = w.get("doi") or w.get("id") or ""
+ location = w.get("best_oa_location")
+ oa = location.get("pdf_url") if isinstance(location, dict) else None
+ url = next((u for u in (w.get("doi"), w.get("id")) if http_url(u)), None)
if not url:
continue
hit = {"title": clean(w.get("display_name") or ""), "url": url}
- if oa:
+ if http_url(oa):
hit["also"] = [oa]
hits.append(hit)
- digest.append_records(Path(topic).expanduser(), [{
- "round": round_, "by": "chain.py", "method": cmd, "query": key, "hits": hits}])
+ record = digest.normalize_record({
+ "round": round_, "by": "chain.py", "method": cmd, "query": key, "hits": hits}, None, None)
+ digest.append_records(Path(topic).expanduser(), [record])
if __name__ == "__main__":
diff --git a/skills/imozuru/scripts/dashboard.py b/skills/imozuru/scripts/dashboard.py
index f8fb905..7e8a2a8 100644
--- a/skills/imozuru/scripts/dashboard.py
+++ b/skills/imozuru/scripts/dashboard.py
@@ -12,6 +12,10 @@
research_dir … 調査の置き場(既定 ~/research)。直下のフォルダを1件の調査として読む
--runs … 回した記録の台帳(任意)。「調査を区切った理由」「感覚と合った?」の列を読む
--out … 書き出す先(既定 <research_dir>/index.html)
+ --bundle DIR … ページと各調査の文書(詳細レポート・抜書き・map.md・log.md)だけを DIR に写す。
+ 原文(sources/)は写さない。スマホで見るためにどこかへ載せる束で、入れたファイルの一覧を出す
+ --serve [PORT] … ページと文書を 127.0.0.1:PORT(既定 8765)で配る。読み取り専用で、合言葉つきの URL を出す。
+ 合言葉は IMOZURU_SERVE_TOKEN で固定できる(スマホのブックマークを保つため)
"""
import base64
@@ -20,24 +24,32 @@ import html
import json
import os
import re
+import shutil
import sys
+import tempfile
from collections import Counter
from pathlib import Path
from urllib.parse import urlsplit
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import palette # noqa: E402
+from palette import THEMES # noqa: E402
+import skin # noqa: E402 文書(md の表示)の見た目
+
esc = lambda s: html.escape(str(s), quote=True) # noqa: E731
# 区切った理由の自動分類。記録の文は書き手ごとに違うので、語で振り分ける。上から順に最初に当たったもの。
# 分類はページで「自動分類」と明示し、元の文を必ず並べて見せる(分類の誤りを読み手が確かめられるように)
-# 区切った理由の分類ごとの標本の色(.rc1〜.rc4)。記録なしは色を付けず破線
-REASON_COLOR = {"論点に根拠がそろった": 1, "一部の論点を残して区切った": 2, "約束で打ち切り": 3, "取得の壁": 4}
+# 区切った理由の分類ごとの標本の色(.rc1〜.rc4)。記録欠落は色を付けず破線
+# 分類名は4字の熟語にそろえる(2026-10-21 かしぇ「長くてAIっぽくて統一感がなくて冗長」)
+REASON_COLOR = {"論点充足": 1, "一部充足": 2, "期限到達": 3, "取得不可": 4}
REASON_RULES = (
- ("約束で打ち切り", ("約束", "打ち切", "試験運転", "上限")),
- ("取得の壁", ("ログイン", "有料", "壁", "ボット", "CAPTCHA", "取れない", "取得できな", "購読")),
- ("飽和", ("飽和",)),
- ("4周の上限", ("4周",)),
- ("論点に根拠がそろった", ("被覆", "根拠あり", "全部に原文", "全部付いた", "原文が付いた", "原文の場所が付いた")),
- ("一部の論点を残して区切った", ("一部", "区切", "停止", "まで", "打ち止め", "判断")),
+ ("期限到達", ("約束", "打ち切", "試験運転", "上限")),
+ ("取得不可", ("ログイン", "有料", "壁", "ボット", "CAPTCHA", "取れない", "取得できな", "購読")),
+ ("情報飽和", ("飽和",)),
+ ("周回上限", ("4周",)),
+ ("論点充足", ("被覆", "根拠あり", "全部に原文", "全部付いた", "原文が付いた", "原文の場所が付いた")),
+ ("一部充足", ("一部", "区切", "停止", "まで", "打ち止め", "判断")),
)
# 「論点6/6に原文」のように分子と分母が同じなら、全部そろったとみなす
ALL_ATTACHED = re.compile(r"(\d+)\s*/\s*\1\s*に原文")
@@ -45,11 +57,13 @@ ROUND_HEAD = re.compile(r"^#{2,4}\s*(\d+)\s*周目", re.M)
CHECK_ITEM = re.compile(r"^\s*-\s*\[([ xX])\]\s*(.+)$", re.M)
SOURCE_ROW = re.compile(r"^\|(.+)\|\s*$", re.M)
URL = re.compile(r"https?://[^\s|)>\]]+")
+# 日本語のフォルダ名を残しつつ、CSS の構文になる文字を一覧に入れない(2026-10-22 脆弱性レビュー)
+SLUG = re.compile(r"[\w-]+")
def classify(reason: str) -> str:
if ALL_ATTACHED.search(reason) and not any(w in reason for w in REASON_RULES[0][1] + REASON_RULES[1][1]):
- return "論点に根拠がそろった"
+ return "論点充足"
for label, words in REASON_RULES:
if any(w in reason for w in words):
return label
@@ -66,9 +80,48 @@ def section(text: str, heading: str) -> str:
return rest[:n.start()] if n else rest
+def section_prefix(text: str, heading: str) -> str:
+ """section() の、見出しの後ろに「(説明)」が付いていても拾う版。古い map.md は「## 場(学会・雑誌…)」と書いた"""
+ m = re.search(rf"^##\s*{re.escape(heading)}\s*(?:[((].*)?$", text, re.M)
+ if not m:
+ return ""
+ rest = text[m.end():]
+ n = re.search(r"^##\s", rest, re.M)
+ return rest[:n.start()] if n else rest
+
+
+# 一覧の検索で探す map.md の節。古い map.md は媒体を「場」と書いた
+WORD_SECTIONS = (("用語", ("用語",)), ("人", ("人",)), ("媒体", ("媒体", "場")))
+TITLE_MAX = 20 # 題の字数。スマホの一覧で1行に収まる長さ。超えたら作るときに警告する(切りはしない)
+WORD_MAX = 120 # 1項目の長さ。説明の続きや場所の注記まで入れると、関係の無い語にも当たる
+
+
+def map_words(map_text: str) -> list[tuple[str, str]]:
+ """map.md の用語・人・媒体の箇条を(種類, 文)で返す。文は「 — 」より前(場所の注記は外す)"""
+ words = []
+ for kind, headings in WORD_SECTIONS:
+ body = next((s for h in headings if (s := section_prefix(map_text, h))), "")
+ for line in re.findall(r"^\s*-\s+(.+)$", body, re.M):
+ head = re.split(r"\s+—\s*|\s*—\s+", line, maxsplit=1)[0].strip()
+ if head:
+ words.append((kind, head[:WORD_MAX]))
+ return words
+
+
+def topic_file(path: Path) -> bool:
+ # 記録も文書も置き場の外を読ませない。内向きでもリンクは配らない(2026-10-22 脆弱性レビュー)
+ try:
+ if path.is_symlink() or path.parent.is_symlink():
+ return False
+ path.resolve().relative_to(path.parent.resolve())
+ return path.is_file()
+ except (OSError, ValueError, RuntimeError):
+ return False
+
+
def read(path: Path) -> str:
try:
- return path.read_text(encoding="utf-8", errors="replace")
+ return path.read_text(encoding="utf-8", errors="replace") if topic_file(path) else ""
except OSError:
return ""
@@ -128,7 +181,13 @@ def source_hosts(map_text: str) -> list[str]:
continue
m = URL.search(row)
if m:
- hosts.append((urlsplit(m.group(0)).hostname or "?").removeprefix("www."))
+ # 外部由来の壊れた URL で、ほかの調査まで表示不能にしない(2026-10-22 脆弱性レビュー)
+ try:
+ host = urlsplit(m.group(0)).hostname
+ except ValueError:
+ continue
+ if host:
+ hosts.append(host.removeprefix("www."))
return hosts
@@ -137,6 +196,14 @@ def topic_info(d: Path, runs: list[dict]) -> dict:
info: dict = {"slug": d.name, "has_map": bool(map_text)}
q = re.search(r"^問い[::]\s*(.+)$", map_text, re.M)
info["question"] = q.group(1).strip() if q else ""
+ # 一覧の検索で、漢字の語をひらがなやローマ字でも当てるための読み。調べるときに問いの主な語の読みを書く。
+ # 読みの辞書は外部のデータしか無く(Migemo も Sudachi も)、標準ライブラリだけでは付けられない(2026-10-22 かしぇ「map.md に読みを書く」)
+ r = re.search(r"^読み[::]\s*(.+)$", map_text, re.M)
+ info["reading"] = r.group(1).strip() if r else ""
+ # 一覧と詳細の見出しに出す短い題。問いは調べる範囲を決める文で長くなるので、見出しは別に持つ
+ # (2026-10-22 かしぇ「タイトルに文字数制限つけるか」→ 問いは縛らず、20字までの「題:」を足す)
+ ti = re.search(r"^題[::]\s*(.+)$", map_text, re.M)
+ info["title"] = ti.group(1).strip() if ti else ""
date = re.search(r"(20\d\d-\d\d-\d\d)", log_text) or re.search(r"(20\d\d-\d\d-\d\d)", map_text)
info["date"] = date.group(1) if date else ""
rounds = [int(n) for n in ROUND_HEAD.findall(log_text)]
@@ -148,6 +215,7 @@ def topic_info(d: Path, runs: list[dict]) -> dict:
info["rounds"] = len({r for r in rounds if r >= 1}) if rounds else None
info["sources"] = count_sources(d / "sources")
info["hosts"] = source_hosts(map_text)
+ info["words"] = map_words(map_text)
claims = []
for path in (d / "digest.json", d / "extracts.json"):
@@ -169,7 +237,7 @@ def topic_info(d: Path, runs: list[dict]) -> dict:
info["run"] = run
reason = (run or {}).get("調査を区切った理由") or info.get("stopped") or ""
info["reason"] = reason
- info["reason_class"] = classify(reason) if reason else "記録なし"
+ info["reason_class"] = classify(reason) if reason else "記録欠落"
info["searches"] = len(records) if records else None
info["hits"] = sum(len(r.get("hits", [])) for r in records) if records else None
@@ -178,12 +246,177 @@ def topic_info(d: Path, runs: list[dict]) -> dict:
info["fetch_ng"] = sum(1 for f in fetches if f.get("status") == "FAIL") if fetches else None
info["docs"] = [(name, label) for name, label in (("digest.html", "詳細レポート"), ("report.html", "抜書き"),
("map.md", "map.md"), ("log.md", "log.md"))
- if (d / name).is_file()]
+ if topic_file(d / name)]
return info
+def write_bundle(topics: list[dict], root: Path, dest: Path) -> int:
+ """ページと文書だけを dest に写す。文書の中の相対リンクは同じ並びのまま動く。
+ 束は調査の中身そのもの(原文からの引用を含む)なので、何を入れたかを1件ずつ出す(2026-10-21 council の Critic)"""
+ # 途中まで書いてからリンクに気付くと、既存の束も壊すので先に全出力先を調べる(2026-10-22 脆弱性レビュー)
+ paths = [dest / "index.html", dest / ICON.name]
+ paths += [dest / t["slug"] for t in topics]
+ paths += [dest / t["slug"] / name for t in topics for name, _ in t["docs"]]
+ for path in paths:
+ for p in (path, *path.parents):
+ if p.is_symlink():
+ raise ValueError(f"束の出力先にシンボリックリンクは使えない: {p}")
+ if dest.resolve() == root.resolve() or root.resolve() in dest.resolve().parents:
+ print(f"束の置き場は調査の置き場の外にする: {dest}", file=sys.stderr)
+ return 2
+ dest.mkdir(parents=True, exist_ok=True)
+ (dest / "index.html").write_text(render(topics, root), encoding="utf-8")
+ files = ["index.html"]
+ if ICON.is_file():
+ shutil.copyfile(ICON, dest / ICON.name)
+ files.append(ICON.name)
+ for t in topics:
+ for name, _ in t["docs"]:
+ (dest / t["slug"]).mkdir(exist_ok=True)
+ src = root / t["slug"] / name
+ if not topic_file(src):
+ continue
+ if name.endswith(".html"):
+ (dest / t["slug"] / name).write_bytes(with_back(name, src.read_bytes(), t["slug"]))
+ else:
+ shutil.copyfile(src, dest / t["slug"] / name)
+ files.append(f'{t["slug"]}/{name}')
+ size = sum((dest / f).stat().st_size for f in files)
+ for f in files:
+ print(f)
+ print(f"→ {dest}({len(files)} ファイル・{size / 1e6:.1f} MB。原文は入れていない)")
+ print("注意: 詳細レポートと抜書きには原文からの引用が入る。束を人に渡すときや公開の場所へ置くときは中身を確かめる")
+ return 0
+
+
+# 戻るボタンの色は palette.HUD_LIGHT・HUD_DARK。文書の地(象牙の紙・暗い設定では胡桃材)の明暗の反対側を当てる
+HUD_ICON = ('<svg viewBox="0 0 24 24" width="22" height="22" aria-hidden="true" fill="none" stroke="currentColor" '
+ 'stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M15 5l-7 7 7 7"/></svg>')
+
+
+def hud_css(scheme: str) -> str:
+ """scheme は "auto"(文書の明暗の切り替えに合わせる)か "dark"(暗い地に固定したページ)"""
+ def vars_(k):
+ return palette.css_vars(palette.HUD_DARK if k == "dark" else palette.HUD_LIGHT)
+ css = (f'.imz-hud{{{vars_("dark" if scheme == "dark" else "light")};position:fixed;z-index:2147483647;'
+ 'left:max(14px,env(safe-area-inset-left));bottom:max(14px,env(safe-area-inset-bottom));'
+ 'width:46px;height:46px;border-radius:50%;display:grid;place-items:center;'
+ 'background:var(--hud-bg);color:var(--hud-fg);box-shadow:0 0 0 1px color-mix(in oklch,var(--hud-fg) 35%,transparent),0 6px 16px -6px color-mix(in oklch,var(--hud-umbra) 60%,transparent);'
+ 'transition:transform .15s}.imz-hud:active{transform:scale(.92)}'
+ '.imz-hud:focus-visible{outline:2px solid var(--hud-fg);outline-offset:3px}')
+ if scheme == "auto":
+ css += f'@media (prefers-color-scheme:dark){{.imz-hud{{{vars_("dark")}}}}}'
+ return css
+
+
+def with_back(name: str, data: bytes, slug: str, hud: bool = True) -> bytes:
+ """文書は単体で書き出されていて、ダッシュボードへ戻る導線を持たない。配るときに左下へ戻るボタンを足す。
+ map.md・log.md は文字のまま返すとボタンを置けないので、ダッシュボードと同じ胡桃材の地のページに包む。
+ 戻り先は相対(../index.html)にして、配る窓口でも束でも同じに動かす"""
+ md = name.endswith(".md")
+ # 文書はどれもダッシュボードと同じコルク板の暗い地に置く(skin.py)ので、戻るボタンは暗い地用の象牙色。
+ # ダッシュボードの本体の枠(iframe)に出すときは、ヘッダーと一覧が残るので戻るボタンは要らない(hud=False・窓口の ?embed=1)。
+ # 束を枠に出したときは消せないので、押したら枠ではなく画面全体を戻す(target=_top)
+ hud = (f'<style>{hud_css("dark")}</style>'
+ f'<a class="imz-hud" href="../index.html#t-{esc(slug)}" target="_top" aria-label="調査記録へ戻る">{HUD_ICON}</a>') if hud else ""
+ text = data.decode("utf-8", errors="replace")
+ if md:
+ # map.md・log.md は、見出し・箇条書き・表などに組んで象牙の紙に載せる(2026-10-22 かしぇ「mdはちゃんとプレビューするようにしたい」)。
+ # 中身は他人が書いた文を含むので、skin.md_html が全部エスケープしてから組む
+ body = f'<article class="sheet md">{skin.md_html(text)}</article>{hud}'
+ return skin.page(f"{slug} {name}", body, extra_head=f"<style>{skin.CSS}</style>").encode()
+ i = text.lower().rfind("</body>")
+ return (text[:i] + hud + text[i:] if i >= 0 else text + hud).encode()
+
+
+def make_handler(root: Path, runs: list[dict], token: str):
+ """ページと文書だけを返す読み取り専用の窓口。返す先は collect() の文書の一覧に在るものに限る=
+ パスを組み立てて開かないので、sources/ や置き場の外へは届かない。
+ 合言葉は最初に ?k= で受け取り、以後は cookie で通す(Tailscale の外へ出す道具で開いたときの最後の鍵)"""
+ import secrets
+ from http.server import BaseHTTPRequestHandler
+ from urllib.parse import parse_qs, unquote
+
+ extra_hosts = {h.strip().lower() for h in os.environ.get("IMOZURU_SERVE_HOSTS", "").split(",") if h.strip()}
+
+ class Handler(BaseHTTPRequestHandler):
+ def do_GET(self):
+ # DNS rebinding で敵のドメインを 127.0.0.1 に向けさせない。鍵があっても、cookie を持つブラウザの入口を制限する(2026-10-22 脆弱性レビュー)
+ host = self.headers.get("Host", "").lower()
+ if not (re.fullmatch(r"[a-z0-9_.-]+(?::[0-9]+)?", host) and (
+ host in (f"127.0.0.1:{self.server.server_port}", f"localhost:{self.server.server_port}")
+ or host.partition(":")[0].endswith(".ts.net")
+ or host in extra_hosts or host.partition(":")[0] in extra_hosts)):
+ return self.reply(403, "text/plain; charset=utf-8", "許可されていない Host".encode())
+ path, _, query = self.path.partition("?")
+ # 日本語名も一覧と照合できるよう復号する。復号した文字列からファイルを開かない(2026-10-22 脆弱性レビュー)
+ path = unquote(path)
+ # ホーム画面のアイコンは合言葉なしで返す。iPhone はアイコンを取りに来るときに cookie を送らないことがある。
+ # 中身はロゴの紋だけで、調査の中身は含まない
+ if path in ("/apple-touch-icon.png", "/apple-touch-icon-precomposed.png") and ICON.is_file():
+ return self.reply(200, "image/png", ICON.read_bytes())
+ given = parse_qs(query).get("k", [""])[0]
+ cookie = dict(c.strip().split("=", 1) for c in self.headers.get("Cookie", "").split(";") if "=" in c)
+ # 非 ASCII の鍵も認証失敗として返し、比較の例外で接続を落とさない(2026-10-22 脆弱性レビュー)
+ if token and not any(secrets.compare_digest(token.encode("utf-8", errors="surrogateescape"),
+ s.encode("utf-8", errors="surrogateescape"))
+ for s in (given, cookie.get("imozuru", ""))):
+ return self.reply(403, "text/plain; charset=utf-8", "合言葉が要る(起動したときに出た URL で開く)".encode())
+ topics = collect(root, runs)
+ if path in ("/", "/index.html"):
+ body = render(topics, root).encode()
+ ctype = "text/html; charset=utf-8"
+ else:
+ slug, _, name = path.strip("/").partition("/")
+ docs = {(t["slug"], n): root / t["slug"] / n for t in topics for n, _ in t["docs"]}
+ src = docs.get((slug, name))
+ if src is None or not topic_file(src):
+ return self.reply(404, "text/plain; charset=utf-8", "無い".encode())
+ body = with_back(name, src.read_bytes(), slug, hud="embed" not in parse_qs(query))
+ ctype = "text/html; charset=utf-8"
+ extra = {"Set-Cookie": f"imozuru={token}; Path=/; HttpOnly; SameSite=Strict"} if token and given else {}
+ self.reply(200, ctype, body, extra)
+
+ def reply(self, code, ctype, body, extra=None):
+ self.send_response(code)
+ for k, v in {"Content-Type": ctype, "Cache-Control": "no-store", "X-Content-Type-Options": "nosniff",
+ "Referrer-Policy": "no-referrer", **(extra or {})}.items():
+ self.send_header(k, v)
+ self.send_header("Content-Length", str(len(body)))
+ self.end_headers()
+ self.wfile.write(body)
+
+ def log_message(self, fmt, *a):
+ # 既定の記録は ?k= の合言葉ごと URL を書き出す
+ print(f"{getattr(self, 'command', '-')} {getattr(self, 'path', '').split('?')[0]} → {a[1] if len(a) > 1 else ''}", file=sys.stderr)
+
+ return Handler
+
+
+def serve(root: Path, runs: list[dict], port: int) -> int:
+ """自分の PC の中(127.0.0.1)だけで開く。スマホへは Tailscale serve などで中継する。
+ 開くたびに置き場を読み直すので、調べものが増えても立て直さなくてよい"""
+ import secrets
+ from http.server import ThreadingHTTPServer
+ token = os.environ.get("IMOZURU_SERVE_TOKEN")
+ # 固定の短い鍵は総当たりできるので、生成する鍵と同様に十分な長さを求める(2026-10-22 脆弱性レビュー)
+ if token is not None and len(token) < 16:
+ print("IMOZURU_SERVE_TOKEN は16文字以上にしてください", file=sys.stderr)
+ return 2
+ token = token if token is not None else secrets.token_urlsafe(16)
+ server = ThreadingHTTPServer(("127.0.0.1", port), make_handler(root, runs, token))
+ print(f"→ http://127.0.0.1:{port}/?k={token}", flush=True)
+ print("この PC の中だけで開いている。スマホへは Tailscale serve で中継する(SKILL.md)。止めるときは Ctrl+C", flush=True)
+ try:
+ server.serve_forever()
+ except KeyboardInterrupt:
+ pass
+ return 0
+
+
def collect(root: Path, runs: list[dict]) -> list[dict]:
- topics = [topic_info(d, runs) for d in sorted(root.iterdir()) if d.is_dir() and not d.name.startswith(".")]
+ topics = [topic_info(d, runs) for d in sorted(root.iterdir())
+ if not d.is_symlink() and d.is_dir() and SLUG.fullmatch(d.name)]
return sorted(topics, key=lambda t: (t["date"] or "0000", t["slug"]), reverse=True)
@@ -198,22 +431,45 @@ def main() -> int:
i = args.index("--out")
out = Path(args[i + 1]).expanduser()
del args[i:i + 2]
+ bundle = None
+ if "--bundle" in args:
+ i = args.index("--bundle")
+ bundle = Path(args[i + 1]).expanduser()
+ del args[i:i + 2]
root = Path(args[0] if args else "~/research").expanduser()
if not root.is_dir():
print(f"調査の置き場が無い: {root}", file=sys.stderr)
return 2
topics = collect(root, load_runs(runs_path))
+ for t in topics:
+ if len(t["title"]) > TITLE_MAX:
+ print(f"題が長い({len(t['title'])}字・{TITLE_MAX}字まで): {t['slug']}/map.md「{t['title']}」", file=sys.stderr)
if "--dump" in args:
for t in topics:
print("\t".join(str(x) for x in (t["slug"], t["date"], t["rounds"], t["sources"], len(t["hosts"]),
t["reason_class"], (t["run"] or {}).get("周", "-"),
(t["run"] or {}).get("原文", "-"))))
return 0
- page = render(topics, root)
+ if bundle:
+ try:
+ return write_bundle(topics, root, bundle)
+ except (OSError, ValueError) as e:
+ print(f"束を書き出せない: {e}", file=sys.stderr)
+ return 2
+ if "--serve" in args:
+ i = args.index("--serve")
+ port = int(args[i + 1]) if i + 1 < len(args) and args[i + 1].isdigit() else 8765
+ return serve(root, load_runs(runs_path), port)
out = out or root / "index.html"
- tmp = out.with_name("." + out.name + ".tmp")
- tmp.write_text(page, encoding="utf-8")
- os.replace(tmp, out)
+ # 固定名では事前に置かれたリンクを踏む。同じディレクトリなら置換も一度で済む(2026-10-22 脆弱性レビュー)
+ fd, tmp = tempfile.mkstemp(dir=out.parent, prefix="." + out.name + ".", suffix=".tmp")
+ try:
+ with os.fdopen(fd, "w", encoding="utf-8") as f:
+ f.write(render(topics, root))
+ os.replace(tmp, out)
+ except BaseException:
+ Path(tmp).unlink(missing_ok=True)
+ raise
print(f"→ {out}(調査 {len(topics)}件)")
return 0
@@ -222,33 +478,158 @@ LOGO = Path(__file__).resolve().parent.parent / "assets" / "logo.svg"
SHOWN_HOSTS = 12
LOGO_LIGHT = LOGO.with_name("logo-light.svg")
+# ホーム画面に追加したときのアイコン(ロゴの紋を胡桃材の地に置いた 180px 角)。make_textures.py が作る
+ICON = LOGO.with_name("apple-touch-icon.png")
-# 外観は「昆虫の標本箱」(2026-10-21 かしぇが3つの棚の見本から A を選んだ)。胡桃材の濃い地にガラス越しの面、
-# 標本の色を点で入れる。色はすべて OKLCH。標本の4色は dataviz の validate_palette.js を、
-# 暗い面 oklch(0.33 0.035 58) の上で全組み合わせ通した(色覚の差は注意の範囲=文字ラベルを必ず添える)。
-# 案1・案2 はキーカラーとキーフォントだけを変えた見比べ用。決まったら1つにする
-THEMES = {
- "1": {"bar": "oklch(0.62 0.13 75)", "src": "oklch(0.66 0.15 150)",
- "r1": "oklch(0.62 0.14 245)", "r2": "oklch(0.66 0.15 150)", "r3": "oklch(0.62 0.13 75)", "r4": "oklch(0.56 0.17 345)",
- "head": '"Shippori Mincho"', "font": "Shippori+Mincho:wght@500;700"},
- "2": {"bar": "oklch(0.66 0.13 85)", "src": "oklch(0.6 0.15 350)",
- "r1": "oklch(0.6 0.13 250)", "r2": "oklch(0.64 0.13 160)", "r3": "oklch(0.66 0.13 85)", "r4": "oklch(0.6 0.15 350)",
- "head": '"Zen Old Mincho"', "font": "Zen+Old+Mincho:wght@500;700"},
-}
+# 色はすべて palette.py に置く。ここでは役割の名前(CSS の変数)だけを使う
THEME = THEMES[os.environ.get("IMOZURU_DASH_THEME", "1")]
+# 引っぱって更新の札。弧(pathLength=1 で描いた量を CSS の dashoffset で決める)と、描き上がったときに付く矢じり。
+# 矢じりは弧の終わり (4.4,9.5) を先端に、時計回りの接線の逆向きへ ±40° で開く(make の計算: 中心 (12,12)・長さ 3.4)
+PTR_ICON = ('<div class="ptr" aria-hidden="true"><svg viewBox="0 0 24 24" width="22" height="22" fill="none" stroke="currentColor" '
+ 'stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path class="arc" pathLength="1" d="M12 4a8 8 0 1 1-7.6 5.5"/>'
+ '<path class="head" d="M1.5 11.3L4.4 9.5L5.7 12.7"/></svg></div>')
+HELP_ICON = ('<svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" fill="none" stroke="currentColor" '
+ 'stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9.2 9a2.9 2.9 0 0 1 5.6 1c0 2-2.8 2.6-2.8 4.3"/>'
+ '<circle cx="12" cy="18" r=".6" fill="currentColor"/></svg>')
+
+
+def cork_svg() -> str:
+ """コルクの粒を SVG のノイズで作り、地の色に掛け合わせるタイル(design-library knowledge/color/texture.md の「ノイズ+照明」)。
+ 光だけで凹凸を出すと、しわの寄った革か紙に見えた。コルクは明るさの違う粒がまだらに詰まり、小さな穴が点々とあるので、
+ 粗いノイズ(.16)を段に切って粒の明暗にし、細かいノイズ(.75)のまれな値だけを暗い穴にする。粒には弱い光で凹凸を足す。
+ 光の向きは札の影と揃えて左上(azimuth 235)。出力は黒の透けだけで、地の色は palette の cork が決める。
+ はじめは灰色の絵を background-blend-mode で地に掛け合わせたが、iPhone の Safari では掛け合わせが効かず、
+ 灰色がそのまま乗って地が白っぽく見えた(2026-10-22 かしぇ)。透けの絵を普通に重ねれば、掛け合わせに頼らずに済む"""
+ gray ="1 0 0 0 0 1 0 0 0 0 1 0 0 0 0 0 0 0 0 1"
+
+ def steps(values):
+ return "".join(f"<feFunc{c} type='discrete' tableValues='{values}'/>" for c in "RGB")
+ svg = ("<svg xmlns='http://www.w3.org/2000/svg' width='240' height='240'>"
+ "<filter id='c' x='0' y='0' width='100%' height='100%' color-interpolation-filters='sRGB'>"
+ "<feTurbulence type='fractalNoise' baseFrequency='.16' numOctaves='2' seed='3' stitchTiles='stitch'/>"
+ f"<feColorMatrix type='matrix' values='{gray}'/>"
+ f"<feComponentTransfer result='g'>{steps('.62 .8 .95 1 .88 .72')}</feComponentTransfer>"
+ "<feTurbulence type='fractalNoise' baseFrequency='.75' numOctaves='1' seed='11' stitchTiles='stitch'/>"
+ f"<feColorMatrix type='matrix' values='{gray}'/>"
+ f"<feComponentTransfer result='p'>{steps('1 1 1 1 1 1 1 1 .5')}</feComponentTransfer>"
+ "<feBlend in='g' in2='p' mode='multiply' result='m'/>"
+ "<feDiffuseLighting in='g' lighting-color='white' surfaceScale='1.4' result='l'><feDistantLight azimuth='235' elevation='65'/></feDiffuseLighting>"
+ "<feBlend in='m' in2='l' mode='multiply' result='t'/>"
+ # 明るさを透けに直す: 黒の上の不透明度=1−明るさ。黒を透けで重ねるのは掛け合わせと同じ見た目になる
+ "<feColorMatrix in='t' type='matrix' values='0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 -1 0 0 0 1'/>"
+ "</filter><rect width='100%' height='100%' filter='url(#c)'/></svg>")
+ return svg
+
+
+def paper_svg() -> str:
+ """象牙の台紙の繊維。横に長いノイズで紙の筋を出し、焦げ茶をごく薄く透かす"""
+ return ("<svg xmlns='http://www.w3.org/2000/svg' width='180' height='180'><filter id='f'>"
+ "<feTurbulence type='fractalNoise' baseFrequency='.012 .55' numOctaves='3' seed='9'/>"
+ "<feColorMatrix values='0 0 0 0 .35 0 0 0 0 .27 0 0 0 0 .18 0 0 0 .08 0'/></filter>"
+ "<rect width='100%' height='100%' filter='url(#f)'/></svg>")
+
+
+# 質感の絵は make_textures.py が SVG から一度だけ描いた PNG(2倍の解像度)を埋め込む。
+# SVG のフィルタのままだと、スマホで一覧を開くたびに本体が動き出す所でブラウザが絵を計算し直し、
+# 一瞬だけ質感の無い面が見えてチラついた(2026-10-22 かしぇ)。PNG が無いときだけ SVG をそのまま使う
+TEXTURES = {"cork": (LOGO.with_name("cork.png"), cork_svg, 240), "paper": (LOGO.with_name("paper.png"), paper_svg, 180)}
+
+
+def texture_url(name: str) -> str:
+ png, svg, _ = TEXTURES[name]
+ if png.is_file():
+ return 'url("data:image/png;base64,' + base64.b64encode(png.read_bytes()).decode() + '")'
+ from urllib.parse import quote
+ return "url(\"data:image/svg+xml," + quote(svg(), safe="/:=' ") + "\")"
+
+
+# 本体の地はコルク板、グラフと詳細は象牙の台紙に載せる(2026-10-22 かしぇ「本体画面のグラデがダサい テクスチャがほしい」
+# 「その上に地でグラフとかおいてるのもなんかな」→「コルク板+象牙の台紙」)。上からの光のグラデーションはやめた
+CORK_CSS = f"""
+/* 一番外側は本文と同じ地で塗る。塗らないと枠が足した上下の余白に後ろの画面が透け、
+ 頭の帯の色で塗ると本文の下に暗い帯が出た(2026-10-21 かしぇ「塗られるの回避出来てない」) */
+html{{background:var(--cork)}}
+body,main{{background-color:var(--cork);background-image:{texture_url("cork")};background-size:240px 240px;background-repeat:repeat}}
+/* 台紙の中は象牙の上の文字の色に切り替え、標本の色も台紙用の濃い組(p-)にする */
+.topic,.home .card{{--ink:var(--ivory-ink);--sub:var(--ivory-sub);--line:var(--ivory-line);
+--r1:var(--p-r1);--r2:var(--p-r2);--r3:var(--p-r3);--r4:var(--p-r4);--bar:var(--p-bar);--src:var(--p-src)}}
+.home .card{{margin:0 0 28px;padding:24px 28px 18px}}
+.home .card>h3{{margin-top:0}}
+.home .card summary{{color:var(--ivory-sub)}}
+/* 総数の札。数字は欧文の EB Garamond で大きく、見出しと単位は小さく添える。2つの数は縦の線で分ける */
+.home .tally{{margin:0 0 28px;padding:18px 28px 20px}}
+/* 札の名前は標本箱の名札。小さく字間を広くとり、細い線で下の数と分ける。いちばん大きいのは数のまま */
+.tally .plate-name{{margin:0 0 16px;padding-bottom:10px;border-bottom:1px solid var(--line);font-family:var(--head);
+font-size:13px;font-weight:500;letter-spacing:.24em;color:var(--sub)}}
+.plate-name span{{font-family:"EB Garamond",serif;font-size:15px;letter-spacing:.08em;margin-right:.3em}}
+.tally dl{{display:grid;grid-template-columns:1fr 1fr;margin:0}}
+.tally dl>div+div{{border-left:1px solid var(--line);padding-left:28px}}
+.tally dt{{font-family:var(--head);font-size:15px;letter-spacing:.12em;color:var(--sub)}}
+.tally dd{{margin:4px 0 0;font-family:var(--head);font-size:16px;color:var(--sub)}}
+.tally b{{font-family:"EB Garamond",serif;font-weight:500;font-size:clamp(44px,5vw,64px);line-height:1;color:var(--ink);
+font-variant-numeric:lining-nums tabular-nums;margin-right:6px}}
+@media (max-width:760px){{.home .tally{{padding:14px 16px 14px}}.tally dl>div+div{{padding-left:16px}}.tally .plate-name{{margin-bottom:12px}}}}
+/* 一覧のスクロールバーは細くし、地の色に沈める。触れているときだけ少し明るくする(2026-10-22 かしぇ「ブラウザ標準のものを使っていてダサい」)。
+ 一覧の端まで来たあとのスクロールは本文へ渡さない(同「本文側がスクロールされるバグ」) */
+aside{{overscroll-behavior:contain;scrollbar-width:thin;scrollbar-color:{palette.mix("sub", 30)} transparent}}
+aside:hover{{scrollbar-color:{palette.mix("sub", 60)} transparent}}
+aside::-webkit-scrollbar{{width:8px}}
+aside::-webkit-scrollbar-track{{background:transparent}}
+aside::-webkit-scrollbar-thumb{{background:{palette.mix("sub", 30)};border-radius:4px;border:2px solid transparent;background-clip:padding-box}}
+aside:hover::-webkit-scrollbar-thumb{{background-color:{palette.mix("sub", 60)}}}
+/* 説明のボタンは画面の右上に固定し、スクロールしても見えるようにする(2026-10-22 かしぇ「スクロールで隠れる位置にあるのよくない」) */
+.help{{position:fixed;z-index:6;top:max(14px,env(safe-area-inset-top,0px));right:max(16px,env(safe-area-inset-right,0px));
+width:40px;height:40px;border-radius:50%;display:grid;place-items:center;text-decoration:none;
+background:var(--ivory);color:var(--ivory-ink);box-shadow:0 0 0 1px var(--ivory-line),0 6px 14px -6px {palette.mix("umbra", 70)};
+transition:transform .15s,opacity .2s}}
+.help:hover{{color:var(--brass-dark)}}
+.help:active{{transform:scale(.94)}}
+.help:focus-visible{{outline:2px solid var(--ivory);outline-offset:3px}}
+body.open .help{{opacity:0;pointer-events:none}}
+@media (max-width:760px){{.home .card{{padding:18px 14px 14px}}
+ /* スマホの本体は中でスクロールする箱。既定では地の模様が箱に貼りついて札だけが滑るので、模様も一緒に動かす(札はコルク板に留めた標本) */
+ main{{background-attachment:local}}
+ /* スマホでは帯と一緒に右へずらす。画面に残したまま薄くすると、帯から取り残されて見えた(2026-10-22 かしぇ「ヘルプボタンがズレてた」) */
+ .help{{top:max(10px,env(safe-area-inset-top,0px));transform:translateX(var(--x,0px));transition:transform .25s cubic-bezier(.2,.8,.2,1)}}
+ body.open .help{{opacity:1}}
+ body.dragging .help{{transition:none}}
+ .help:active{{transform:translateX(var(--x,0px)) scale(.94)}}}}
+/* 一覧の幅を変えるつまみは、標本箱の蝶番のような真鍮の金具。ねじ頭を2つ打つ */
+@media (min-width:761px){{
+ .grip::after{{content:"";position:absolute;top:50%;left:1px;width:10px;height:46px;margin-top:-23px;border-radius:3px;
+ background:radial-gradient(circle at 50% 9px,var(--brass-dark) 1.5px,transparent 2.2px),
+ radial-gradient(circle at 50% 37px,var(--brass-dark) 1.5px,transparent 2.2px),var(--brass);
+ box-shadow:inset 0 0 0 1px var(--brass-dark),0 2px 4px {palette.mix("umbra", 60)}}}
+ .grip:hover::after,body.dragging .grip::after{{filter:brightness(1.08)}}
+}}
+/* PC の文字の大きさ。スマホに合わせた小さな字(11〜13px)が、PC の距離では読みにくかった(2026-10-22 かしぇ)。
+ 明朝の和文は細いので、補助の文字でも 13px を下限にし、本文は 17px に上げる */
+@media (min-width:761px){{
+ body{{font-size:17px}}
+ aside .q{{font-size:15.5px}}
+ aside .m,aside .m .chip{{font-size:13px}}
+ .chip,.st{{font-size:12.5px;padding:.05em .6em}}
+ thead th{{font-size:13.5px}}
+ td.lbl,td.n,.topic td{{font-size:15.5px}}
+ .hosts span{{font-size:13.5px}}
+ dl.facts dt,.topic .note,summary{{font-size:14.5px}}
+ .topic .docs a{{font-size:15px}}
+ .topic .card>h3{{font-size:18px}}
+}}
+"""
+
CSS = """
-:root{--paper:oklch(0.27 0.035 55);--paper2:oklch(0.21 0.03 50);--ink:oklch(0.93 0.02 85);--sub:oklch(0.76 0.03 80);
---line:oklch(0.42 0.04 60);--card:oklch(0.32 0.035 58);--card2:oklch(0.36 0.035 60);
+:root{@@DASH_VARS@@
--serif:"Noto Serif JP","Hiragino Mincho ProN","Yu Mincho",serif;--latin:"EB Garamond",Georgia,serif;color-scheme:dark}
*{box-sizing:border-box}
html,body{overflow-x:clip}
body{margin:0;background:var(--paper);color:var(--ink);font-family:var(--serif);font-size:16px;line-height:1.7}
a{color:var(--ink)}
header{display:flex;align-items:center;gap:16px;flex-wrap:wrap;padding:16px max(16px,env(safe-area-inset-right,0px)) 12px max(16px,env(safe-area-inset-left,0px));border-bottom:1px solid var(--line);background:var(--paper2)}
-header svg{height:40px;width:auto;flex:none}
header .ttl{font-family:var(--head);font-weight:500;letter-spacing:.04em;font-size:1.15rem}
-header .sum{color:var(--sub);font-size:.85rem;margin-left:auto}
+header .help{flex:none;width:30px;height:30px;border:1px solid var(--line);border-radius:50%;display:grid;place-items:center;color:var(--sub);text-decoration:none;font-size:.85rem}
+header .help:hover,header .help:focus-visible{color:var(--ink);border-color:var(--sub)}
header .menu{display:none;position:relative;width:40px;height:40px;flex:none;border:1px solid var(--line);background:var(--card);border-radius:8px;padding:0;cursor:pointer}
/* 2本線が開くと X に変わる(design-library の menu-cross-morph・makery: translateY+rotate、0.2s ease-out) */
header .menu span,header .menu span::before{position:absolute;left:11px;width:18px;height:2px;border-radius:1px;background:var(--ink)}
@@ -287,17 +668,49 @@ main h3{font-family:var(--head);font-weight:500;font-size:1.05rem;letter-spacing
table{border-collapse:collapse;width:100%;font-size:.88rem;font-variant-numeric:tabular-nums}
th,td{padding:5px 8px;text-align:left;vertical-align:middle}
thead th{font-weight:400;color:var(--sub);border-bottom:1px solid var(--line);font-size:.78rem}
-td.n{text-align:right;width:3.5em;white-space:nowrap}
+td.n,th.n{text-align:right;width:3.5em;white-space:nowrap}
td.bar{width:45%;min-width:5rem}
td.bar span{display:block;height:10px;background:var(--bar);border-radius:0 4px 4px 0}
td.bar.src span{background:var(--src)}
td.lbl{overflow-wrap:anywhere}
.topic{display:none}
+/* #t-… の札へ飛ぶときは、本体の一番上に着地させる(着地点を札の上端より上にずらすと、0 で止まる)。
+ 札の上端へ合わせると、札の頭が固定した頭の帯の裏に隠れた */
+.topic{scroll-margin-top:100vh}
.topic:target{display:block}
main:has(.topic:target) .home{display:none}
-.back{display:inline-block;margin-bottom:12px;font-size:.85rem}
-dl.facts{display:grid;grid-template-columns:minmax(0,9rem) minmax(0,1fr);gap:6px 16px;margin:16px 0}
-dl.facts dt{color:var(--sub);font-size:.85rem}
+/* スクリプトが動くとき(body.js)は、出す札を # ではなく印(.on)で決める。iPhone の録画で、札を切り替えるときに
+ 一瞬ホームが映った(2026-10-22 かしぇ)。# の書き換えの途中で、どの札も :target でないコマが描かれたと見ている。
+ 印は # の書き換えと同じ処理の中で付け替えるので、札の無いコマが描かれない。スクリプトが動かないときは # のまま */
+body.js .topic:target{display:none}
+body.js .topic.on{display:block}
+body.js main:has(.topic:target) .home{display:block}
+body.js main:has(.topic.on) .home{display:none}
+/* 文書の枠。本体の頭の余白から下を、文書の枠でちょうど埋める。文書は枠の中でスクロールする */
+.docview{display:none}
+body.js .docview.on{display:block}
+body.js main:has(.docview.on) .home{display:none}
+.docview iframe{display:block;width:100%;border:0;background:transparent}
+/* 文書の戻るボタン(形と色は文書の側の .imz-hud と同じ)。文書を開いている間だけ出し、一覧を開いている間は本体と一緒に退いて消える */
+.dochud{display:none!important}
+body.doc .dochud{display:grid!important;transform:translateX(var(--x,0px));transition:transform .25s cubic-bezier(.2,.8,.2,1),opacity .25s}
+body.doc.open .dochud,body.doc.dragging .dochud{opacity:0;pointer-events:none}
+body.dragging .dochud{transition:none}
+/* パソコンではサイドバーが左に出たままなので、戻るボタンを紙面の左下(サイドバーの右)に置く。
+ 画面の左下のままだと、サイドバーの底のページ送りに重なった(2026-10-22 説明の図を撮って見つけた) */
+@media (min-width:761px){body.doc .dochud{left:calc(var(--side,18rem) + 18px)}body.doc.collapsed .dochud{left:18px}}
+/* スマホの本文(.view)は引っぱって更新のために transform を持ち、枠の位置の基準になる。高さを本体いっぱいにしておく */
+@media (max-width:760px){body.doc main{padding:0;overflow:hidden}body.doc .view{height:100%}
+ /* 枠(iframe)は上下の位置だけでは伸びない(既定の 150px のままだった)ので、高さを指定する */
+ .docview iframe{position:absolute;left:0;right:0;top:calc(max(10px,env(safe-area-inset-top,0px)) + 51px);
+ height:calc(100% - max(10px,env(safe-area-inset-top,0px)) - 51px)}}
+@media (min-width:761px){body.doc main{padding:0;height:100vh;overflow:hidden}body.doc .view{max-width:none}.docview iframe{height:100vh}}
+/* 項目ごとに下へ細い罫を引いて、行の区切りを見せる(2026-10-22 かしぇ「区分けとかなく並べられてて読みづらい」)。
+ 罫が項目名と値の間で切れないよう、列の隙間は 0 にして項目名の右の余白で空ける */
+dl.facts{display:grid;grid-template-columns:minmax(0,9rem) minmax(0,1fr);gap:0;margin:8px 0}
+dl.facts dt,dl.facts dd{padding:9px 0;border-bottom:1px solid var(--line)}
+dl.facts dt:last-of-type,dl.facts dd:last-of-type{border-bottom:0}
+dl.facts dt{color:var(--sub);font-size:.85rem;padding-right:16px}
dl.facts dd{margin:0;overflow-wrap:anywhere}
ul.claims{list-style:none;padding:0;margin:8px 0}
ul.claims li{display:flex;gap:8px;align-items:baseline;margin:6px 0}
@@ -318,54 +731,207 @@ footer{color:var(--sub);font-size:.78rem;margin-top:48px;border-top:1px solid va
/* Discord 型(takubase の OverlappingPanes に合わせた)。一覧は下に敷き、頭と本文が右へ退いて見せる */
/* 上下は画面の安全域(ノッチ・下のバー)の内側に合わせる。Artifact などの枠は :root に安全域ぶんの余白を足すので、
一覧だけ端まで伸びると本文より上下に大きく見えた(2026-10-21 かしぇ) */
- .side{position:fixed;left:0;top:env(safe-area-inset-top,0px);bottom:env(safe-area-inset-bottom,0px);height:calc(100dvh - env(safe-area-inset-top,0px) - env(safe-area-inset-bottom,0px));align-self:stretch;width:84vw;z-index:0;border-right:none}
+ /* 下端は画面の下まで伸ばす。本文は下の安全域の奥まで続くので、一覧だけ手前で切ると隙間に後ろの地が見えた */
+ .side{position:fixed;left:0;top:env(safe-area-inset-top,0px);bottom:0;height:auto;align-self:stretch;width:84vw;z-index:0;border-right:none}
/* グリッドの子なので、パソコン用の align-self:start が固定配置にも効き、中身の高さ(24px)まで縮んだ。伸ばす指定に戻す */
- header,main{position:relative;z-index:1;transform:translateX(var(--x,0px));transition:transform .25s cubic-bezier(.2,.8,.2,1)}
- main{background:var(--paper);min-height:100dvh}
+ header,main{position:relative;z-index:1;transform:translateX(var(--x,0px));transition:transform .25s cubic-bezier(.2,.8,.2,1),border-radius .25s cubic-bezier(.2,.8,.2,1)}
+ /* 頭の帯は画面の上に固定する。流れのままだと、下へ読んだあと一覧を開くボタンまで戻らないといけなかった(2026-10-22 かしぇ)。
+ 固定すると高さを取るので、ボタンと件数を1段に並べる。右端は固定した説明のボタンの分だけ空ける。
+ 重なりは本体の縁の影の板(.frame・4)より上の 5。板の内側の影が帯の左端にかかって暗くなり、帯の色がずれて見えた
+ (2026-10-22 かしぇ「ヘッダーは暗くならないようにしたい 色がずれるから」)。説明のボタン(6)はさらに上 */
+ header{position:fixed;top:0;left:0;right:0;z-index:5;flex-wrap:nowrap;
+ padding:max(10px,env(safe-area-inset-top,0px)) 68px 10px max(16px,env(safe-area-inset-left,0px))}
+ /* 文書はスクロールさせず、本体を画面いっぱいの箱にして中でスクロールさせる(2026-10-22 レビュー: 両者の推奨)。
+ 前は文書のスクロールのまま、開くたびに body を固定し直し、ページの高さの本体を画面の座標で切り抜いていた。
+ iPhone の Safari で、閉じた直後の約0.3秒、本体と一覧の上半分が描かれず黒く見えた(ops/reviews/2026-10-22-imozuru-dash-mobile-pane.md)。
+ 箱にすると、開閉でスクロール位置に触れず、角丸も箱の border-radius で切れる。代わりに Safari のツールバーはスクロールで縮まない。
+ 開いている間のスクロールは、本体を覆う暗い面(touch-action:none)が受け止める */
+ /* 文書がずれる余地を残さない。iPhone の Safari は body の overflow:hidden では指のスクロールを止めず、
+ 外枠(.layout)の min-height(100vh はツールバーを畳んだ大きいほうの高さ)が見えている範囲より長いぶん、ページ全体が上へずれて
+ ロゴが切れ、下にコルクの帯が出た(2026-10-22 かしぇの実機スクショ)。body は開閉にかかわらず常に画面へ固定し、バウンドも止める */
+ html,body{height:100%;overflow:hidden;overscroll-behavior:none}
+ body{position:fixed;inset:0}
+ .layout{min-height:0}
+ /* 端を越えて弾ませない。弾むと箱の外の描かれていない所が黒く見えた(2026-10-22 かしぇ「黒い見切れ」)。
+ 上端で下へ引いたときは、弾みの代わりに下の「引っぱって更新」を出す */
+ main{position:fixed;inset:0;overflow-y:auto;overscroll-behavior:none}
+ /* 引っぱって更新。--pull は本文を下げる量、--pp は進み具合(0〜1)。弧が描き上がると矢じりが付き、離せば読み込み直す */
+ .view{transform:translateY(var(--pull,0px));transition:transform .3s cubic-bezier(.2,.8,.2,1)}
+ body.pulling .view{transition:none}
+ /* 重なりは 本体(1) < この札(2) < 帯(5)。札は帯の下から本体の上へ降りてくる */
+ .ptr{display:grid;place-items:center;position:fixed;z-index:2;left:50%;top:calc(max(10px,env(safe-area-inset-top,0px)) + 62px);
+ width:40px;height:40px;margin-left:-20px;border-radius:50%;background:var(--ivory);color:var(--ivory-ink);
+ box-shadow:0 0 0 1px var(--ivory-line),0 6px 14px -6px color-mix(in oklch,var(--umbra) 70%,transparent);pointer-events:none;
+ opacity:var(--pp,0);transform:translateX(var(--x,0px)) translateY(calc(var(--pull,0px) - 52px)) scale(calc(.6 + var(--pp,0) * .4));
+ transition:opacity .3s,transform .3s cubic-bezier(.2,.8,.2,1)}
+ body.pulling .ptr{transition:none}
+ .ptr svg{transform:rotate(calc(var(--pp,0) * 270deg))}
+ .ptr .arc{stroke-dasharray:1;stroke-dashoffset:calc(1 - var(--pp,0))}
+ .ptr .head{opacity:0;transition:opacity .12s}
+ body.ready .ptr .head{opacity:1}
+ body.ready .ptr{color:var(--brass-dark)}
+ body.refreshing .ptr svg{animation:ptr-spin .8s linear infinite}
+ @keyframes ptr-spin{to{rotate:360deg}}
+ /* 角丸は開いている間ずっと付け、閉じるときだけ四角へ動かす。開くときに動かすと角が徐々に丸くなって見え(2026-10-21 かしぇ「ずっと角丸にできない?」)、
+ 閉じるときに一度に外すと戻った瞬間に角が切り替わって見えた(同「ダサい」)。遷移は行き先の状態の指定が使われるので、開いた側から border-radius を外す */
+ body.open main,body.dragging main{border-radius:34px 0 0 34px;transition-property:transform}
+ body.open header,body.dragging header{border-top-left-radius:34px;transition-property:transform}
/* 縦にスクロールする要素には、その要素自身に pan-y を宣言する。ブラウザは触れた所から最寄りの
スクロールする祖先までしか touch-action を見ず、無いと横の操作をブラウザが取って中断する(takubase の規約) */
html,body,header,main,aside,.tablewrap,pre{touch-action:pan-y}
/* 表の箱は、はみ出していなくても横にスクロールする箱として扱われ、横の操作をブラウザが取った(20px で中断)。
本当にはみ出す表だけスクリプトが横スクロールを戻し、そこから始めた操作は表に譲る */
body.dragging header,body.dragging main,body.dragging .shade{transition:none}
- body.open{--x:84vw;overflow:hidden}
+ /* --p は開き具合(0〜1)。ドラッグ中はスクリプトが指の位置から入れ、暗い面と角丸がそれに合わせて濃くなる。
+ 開いた瞬間に暗さが最大まで跳ぶと、動きが途切れて見えた(2026-10-21 かしぇ「一瞬で暗くなる」) */
+ body.open{--x:84vw;--p:1;overflow:hidden}
body.collapsed .layout,.layout{grid-template-columns:minmax(0,1fr)}
- body.collapsed aside{visibility:visible}
+ body.collapsed aside{visibility:inherit}
+ /* 閉じている間は一覧を隠す。本文がページの下端で終わると、その下に一覧が透けて見えた(2026-10-21 かしぇ)。
+ 隠すのは閉じる動きが終わってから(遅らせないと、本体が戻る途中で一覧が消える) */
+ .side{visibility:hidden;transition:visibility 0s .3s}
+ body.open .side,body.dragging .side{visibility:visible;transition-delay:0s}
+ /* 一覧の中身は、開くと奥から手前へ来る(少し小さく・ぼけて・薄い状態から、元の大きさでくっきり)。閉じると奥へ下がりながらぼける
+ (2026-10-22 かしぇ「奥からぼかしを解除しながら出てくる 退場時に奥にぼけていく」)。
+ 開き具合 --p(0〜1)につなぐので、指で引いている途中も同じ変化が途中まで進む。
+ 動かすのは中身の包み(.side-in)1つだけ。ロゴの帯と一覧を別々に縮めると、それぞれの中心へ寄ってばらばらに動いて見えた
+ (同日かしぇ「要素がばらついて縮小拡大しちゃう 全体をってことできない?」)。1つにまとめると、ぼかしの描き直しも1枚で済む。
+ 開くときは長め(0.34秒・減速)、閉じるときは短く(0.22秒・加速) */
+ .side-in{opacity:var(--p,0);filter:blur(calc((1 - var(--p,0)) * 6px));transform:scale(calc(.94 + var(--p,0) * .06));transform-origin:30% 45%;
+ transition:opacity .22s cubic-bezier(.4,0,1,1),filter .22s cubic-bezier(.4,0,1,1),transform .22s cubic-bezier(.4,0,1,1)}
+ body.open .side-in{transition-duration:.34s;transition-timing-function:cubic-bezier(.2,.8,.2,1)}
+ body.dragging .side-in{transition:none}
+ @media (prefers-reduced-motion:reduce){.side-in{filter:none;transform:none;transition:none}}
.grip{display:none}
- .shade{display:block;position:fixed;inset:0;z-index:2;background:rgba(72,36,4,.25);transform:translateX(var(--x,0px));transition:transform .25s cubic-bezier(.2,.8,.2,1),opacity .25s;opacity:0;pointer-events:none;border:0;padding:0}
- body.open .shade,body.dragging .shade{opacity:1;pointer-events:auto}
- body.open header{z-index:3}
+ .shade{display:block;position:fixed;inset:0;z-index:2;touch-action:none;background:rgba(72,36,4,.25);transform:translateX(var(--x,0px));transition:transform .25s cubic-bezier(.2,.8,.2,1),opacity .25s cubic-bezier(.2,.8,.2,1);opacity:var(--p,0);pointer-events:none;border:0;padding:0}
+ body.open .shade,body.dragging .shade{pointer-events:auto}
header .menu{display:inline-block}
@media (prefers-reduced-motion:reduce){header .menu span,header .menu span::before{transition:none}}
- header{gap:10px 12px;padding-top:10px;padding-bottom:10px}
- header svg{height:30px}
- header .ttl{display:none}
+ header{gap:10px 12px;padding-bottom:10px}
td.bar{width:35%}
- main{padding:16px max(16px,env(safe-area-inset-right,0px)) 48px max(16px,env(safe-area-inset-left,0px))}
- header .sum{margin-left:0;width:100%}
- dl.facts{grid-template-columns:minmax(0,6.5rem) minmax(0,1fr);gap:6px 10px}
+ main{padding:calc(66px + max(10px,env(safe-area-inset-top,0px))) max(16px,env(safe-area-inset-right,0px)) calc(48px + env(safe-area-inset-bottom,0px)) max(16px,env(safe-area-inset-left,0px))}
+ dl.facts{grid-template-columns:minmax(0,7.8rem) minmax(0,1fr)} /* 「ユーザーの反応」が1行に収まる幅 */
+ dl.facts dt{padding-right:10px}
main h2{font-size:1.15rem}
}
-@media (prefers-reduced-motion:reduce){header,main,.shade{transition:none!important}}
+@media (prefers-reduced-motion:reduce){header,main,.shade,.view,.ptr{transition:none!important}body.refreshing .ptr svg{animation:none}}
/* --- 標本箱(2026-10-21 協議: カードの一式をやめ、大胆さは詳細の紙面1か所に集める) --- */
-/* 一番外側も塗る。塗らないと、枠が足した上下の余白に後ろの画面が透ける */
-html{background:var(--paper2)}
-:root{--ivory:oklch(0.94 0.025 85);--ivory-ink:oklch(0.3 0.03 55);--ivory-sub:oklch(0.44 0.03 60);--ivory-line:oklch(0.82 0.03 80)}
-/* 地は無地の胡桃材に、上から電灯を当てたような減光(色の転び・周辺減光)。縦縞の木目は作り物に見えたのでやめた。
- スマホでは本文が下の一覧を隠す不透明な板なので、本文にも同じ地を敷く */
-body,main{background-color:var(--paper);background-image:radial-gradient(120% 90% at 35% -10%,oklch(0.34 0.045 62),transparent 60%),radial-gradient(140% 120% at 50% 50%,transparent 55%,oklch(0.17 0.025 50 / .7))}
+/* ロゴは一覧の頭に固定し、項目はその下へ流れて消える(2026-10-21 かしぇ「ロゴの下をぼけながらフェードアウト」)。
+ ロゴの面は一覧の上に重ね、背景のぼかしと地の色を下へ向けて薄くする。一覧はロゴの高さぶん下から始める */
+.brand{position:absolute;top:0;left:0;right:0;height:var(--brand-h);z-index:2;pointer-events:none;display:flex;flex-direction:column;align-items:flex-start;padding:18px 18px 0}
+/* ロゴの帯の下端のぼかしと薄れは外した。一覧がスクロールしていた頃、ロゴの下へ流れ込む項目を薄く見せるためのものだった。
+ ページ送りになって項目はロゴの下へ入らなくなり、薄れだけが一覧の先頭に影のようにかかった(2026-10-22 かしぇ「不要な影が一覧の先頭にかかってる」) */
+/* 一覧の検索。打つたびに一覧を絞る。iPhone は 16px 未満の入力欄に触れると画面を拡大するので、スマホでは 16px にする */
+.find{position:relative;display:flex;align-items:center;align-self:stretch;margin-top:12px;pointer-events:auto}
+.find .lens{position:absolute;left:11px;color:var(--sub);pointer-events:none}
+.find input{width:100%;height:38px;margin:0;padding:0 34px;border:1px solid var(--line);border-radius:8px;
+background:color-mix(in oklch,var(--glass) 6%,transparent);color:var(--ink);font:inherit;font-size:14.5px;-webkit-appearance:none;appearance:none}
+.find input::placeholder{color:var(--sub);opacity:.85}
+.find input:focus{outline:none;border-color:var(--sub);background:color-mix(in oklch,var(--glass) 10%,transparent)}
+.find input::-webkit-search-cancel-button{-webkit-appearance:none;display:none}
+.find .clear{position:absolute;right:4px;width:30px;height:30px;padding:0;border:0;border-radius:6px;background:none;color:var(--sub);cursor:pointer;display:none;place-items:center}
+.find.has .clear{display:grid}
+.find .clear:hover,.find .clear:focus-visible{color:var(--ink)}
+@media (max-width:760px){.find input{font-size:16px}}
+/* 当たった用語・人・媒体は、項目の下に1行で添える。題名で当たったときは出さない */
+aside .hit{display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;font-size:.74rem;line-height:1.5;color:var(--sub);margin-top:2px}
+aside .hit b{font-weight:600;color:var(--ink);margin-right:.6em}
+aside li.off{display:none}
+.find-none{margin:12px 10px 0 16px;color:var(--ink);font-size:.88rem}
+.find-none[hidden]{display:none}
+.find-none p{margin:0 0 4px}.find-none .where{color:var(--sub);font-size:.78rem}
+.find-none button{margin-top:10px;padding:6px 12px;border:1px solid var(--line);border-radius:8px;background:var(--card2);color:var(--ink);font:inherit;font-size:.82rem;cursor:pointer}
+.find-none button:focus-visible{outline:2px solid var(--src);outline-offset:2px}
+/* 当たった文字の印。デジタル庁のデザインシステムの検索ハイライト(薄い地+濃い縁)に合わせ、色は標本の琥珀から取る */
+aside mark{background:color-mix(in oklch,var(--bar) 30%,transparent);color:inherit;border-radius:2px;box-shadow:inset 0 -2px 0 color-mix(in oklch,var(--bar) 85%,transparent)}
+.sr{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%);white-space:nowrap}
+/* ページ送り。一覧は画面に収まる分ずつ見せ、中ではスクロールさせない(2026-10-22 かしぇ「多くなってくると画面絶対重くなる」)。
+ PC は一覧の底に、上のロゴの帯と対になる帯を置いて横に並べる。スマホは開いた一覧の右に残る本体の帯へ、× の下に縦に並べる */
+.pager{display:flex;align-items:center;gap:6px;color:var(--sub);font-family:var(--latin);font-variant-numeric:lining-nums tabular-nums}
+.pager button{width:36px;height:36px;display:grid;place-items:center;padding:0;border:1px solid var(--line);border-radius:8px;background:var(--card2);color:var(--ink);cursor:pointer}
+.pager button:disabled{opacity:.35;cursor:default}
+.pager button:focus-visible,.pager input:focus-visible{outline:2px solid var(--src);outline-offset:2px}
+.pager input{width:2.4em;height:34px;margin:0;padding:0;text-align:center;border:1px solid transparent;border-radius:6px;background:none;color:var(--ink);font:inherit;font-size:18px}
+.pager input:focus{outline:none;border-color:var(--sub);background:color-mix(in oklch,var(--glass) 8%,transparent)}
+.pager .t{font-size:16px}
+.pager.sp{display:none}
+.pager.pc{position:absolute;left:0;right:0;bottom:0;height:64px;justify-content:center;z-index:2;padding-top:8px}
+aside{padding-bottom:66px}
+body.collapsed .pager.pc{visibility:hidden}
+body.pg-one .pager{display:none}
+@media (max-width:760px){
+ .pager.pc{display:none}
+ aside{padding-bottom:calc(12px + env(safe-area-inset-bottom,0px))}
+ /* 頭の帯の子にして、本体と一緒に右へ退かせる。暗い面(z-index 2)より上の帯(3)に乗るので押せる */
+ /* 帯の下は本体の札の上なので、頭の帯と同じ地の細長い板に載せる。板が無いと数字が札の文字と重なって読めなかった */
+ .pager.sp{display:flex;flex-direction:column;gap:2px;position:absolute;left:max(16px,env(safe-area-inset-left,0px));top:calc(100% + 12px);width:40px;
+ padding:0 0 2px;border:1px solid var(--line);border-radius:10px;background:var(--paper2);
+ box-shadow:0 8px 18px -8px color-mix(in oklch,var(--umbra) 80%,transparent);opacity:0;pointer-events:none;transition:opacity .2s}
+ .pager.sp button{border:0;background:none}
+ body.open .pager.sp{opacity:1;pointer-events:auto}
+ body.open.pg-one .pager.sp{display:none}
+ .pager.sp button{width:40px;height:40px}
+ .pager.sp input{width:40px}
+ .pager.sp .rule{width:16px;height:1px;background:var(--sub)}
+}
+@media (prefers-reduced-motion:reduce){.pager.sp{transition:none}}
+.brand .home-link>svg{height:58px;width:auto;max-width:100%;pointer-events:auto}
+/* ロゴを押すとホームへ戻る(2026-10-22 かしぇ)。面は下の一覧を通すので、リンクだけ押せるようにする */
+.brand .home-link{pointer-events:auto;display:inline-flex;border-radius:6px}
+.brand .home-link:focus-visible{outline:2px solid var(--src);outline-offset:4px}
+.brand .ttl{font-family:var(--head);font-size:1.5rem;letter-spacing:.06em;display:block}
+aside{padding-top:calc(var(--brand-h) - 22px)}
+body.collapsed .brand{visibility:hidden}
+@media (max-width:760px){body.collapsed .brand{visibility:inherit}}
+/* スマホでは一覧の地を右へ 48px 延ばす。本体の角を丸く切った外側は一覧の幅より右にあり、
+ 延ばさないとそこだけページの地の色が見えた(2026-10-21 かしぇ「角丸の部分の背景色がわかたれて」) */
+@media (max-width:760px){.side{box-shadow:48px 0 0 var(--side-bg)}}
+/* head には、ホーム画面の中での見え方を変える指定(apple-mobile-web-app-capable・status-bar-style・theme-color)を置かない。
+ 2026-10-22 に時刻の帯の色を合わせようとして足したところ、ホーム画面から開くと下に帯が出て本体が下まで届かなくなった。
+ 足す前は下まで伸びていた(かしぇ「サイドバー上部いじる前は下まで伸びてた」)ので、足したものを外して元に戻した。
+ ホーム画面のアイコンは追加したときの指定を覚えているらしく、指定を変えたら追加し直す。
+ 安全域があるとき(横向き・ブラウザの全画面)に備え、一覧は上端から敷き、ロゴは安全域の下に置く */
+@media (max-width:760px){.side{top:0;padding-top:env(safe-area-inset-top,0px)}}
+/* 中身の包み。一覧の地(.side)の内側いっぱいに置き、ロゴの帯の基準にする。安全域の分は .side の上の余白で下がる */
+.side-in{position:relative;height:100%}
+/* ホーム画面から開いたとき(body.app・スクリプトが付ける)だけの指定。ブラウザで開いたときの見た目は変えない
+ (2026-10-22 かしぇ「ブラウザで開いたときの見た目には影響しなくてほしくて」)。
+ 判定は display-mode の媒体指定ではなく navigator.standalone で行う。iPhone の実機で display-mode:standalone が当たらなかった(同日のスクショ) */
+@media (max-width:760px){
+ /* 一覧を時刻の帯の下へ沈んだ板に見せる。左端と上端は画面の端に付けたまま、左上をおよそ半径 47px(iPhone の画面の角と同じくらい)に丸め、
+ 左と上の内側に、ほんの少しだけぼかした影を落とす(かしぇ「左上を角丸に」「沈み込むような段差」「左のラインってのはあくまで左端に接地」
+ 「しずみこみはハードな影で描写するのみ」「ほんのちょっとだけぼかしいれて」)。
+ 角の外にはページの地が見えるので、本体の頭の帯と同じ色にする(かしぇ「左上に出てるコルクは本体画面のヘッダーの色にする」)。
+ 角で中身(ロゴの帯の地)がはみ出さないよう、板の外へ出る中身は切る。右へ延ばした地(box-shadow)は切られない */
+ :root:has(body.app),body.app{background:var(--paper2)}
+ body.app .side{border-top-left-radius:47px;overflow:hidden}
+ body.app .side::before{content:"";position:absolute;inset:0;z-index:3;border-radius:inherit;pointer-events:none;
+ box-shadow:inset 6px 6px 3px color-mix(in oklch,var(--umbra) 85%,transparent)}
+}
+/* 一覧は頭の帯より一段暗い地に置く。本体と一覧の境が見分けやすくなる(2026-10-21 かしぇ「もっと暗い色に」) */
+.side{background:var(--side-bg)}
+:root{--brand-h:172px;}
+/* 折りたたみの中身は、高さと透明度を動かして開閉する(スクリプトが付ける) */
+details.more>.more-body{overflow:hidden}
+/* 折りたたみの三角は自前で描き、開閉に合わせて回す。閉じる動きの間(.closing)は、もう閉じた向きへ戻す */
+summary{list-style:none;cursor:pointer}summary::-webkit-details-marker{display:none}
+summary::before{content:"";display:inline-block;width:0;height:0;margin-right:.5em;vertical-align:.08em;border-style:solid;
+border-width:.32em 0 .32em .5em;border-color:transparent transparent transparent currentColor;transition:transform .25s cubic-bezier(.2,.8,.2,1)}
+details[open]:not(.closing)>summary::before{transform:rotate(90deg)}
+@media (prefers-reduced-motion:reduce){summary::before{transition:none}}
header{background:var(--paper2);border-bottom:1px solid var(--line)}
-header .ttl{display:none}
main h2,main h3,aside h2{font-family:var(--head);font-weight:700}
summary,.note{color:var(--sub)}
a{color:var(--ink)}
/* 一覧: カードをやめて、罫線で区切った密な目録。左端の太い帯が区切った理由の色=色で探せる */
aside ol{gap:0}
-aside a{background:none;border:0;border-bottom:1px solid var(--line);border-radius:0;box-shadow:none;padding:9px 10px 9px 16px;position:relative}
+aside a{background:none;border:0;border-radius:0;box-shadow:none;padding:9px 10px 9px 16px;position:relative}
+/* 区切りの罫線は途中から右へ薄れて消える(2026-10-21 かしぇ) */
+aside a::after{content:"";position:absolute;left:0;right:0;bottom:0;height:1px;background:linear-gradient(90deg,var(--line) 40%,transparent)}
aside a::before{content:"";position:absolute;left:2px;top:9px;bottom:9px;width:5px;border-radius:3px;background:var(--c,transparent);box-shadow:0 0 8px -1px var(--c,transparent)}
aside a.none::before{background:none;border:1px dashed var(--line);width:3px}
-aside a:hover,aside a:focus-visible{background:oklch(1 0 0 / .05)}
+aside a:hover,aside a:focus-visible{background:color-mix(in oklch,var(--glass) 5%,transparent)}
aside .m .chip{border:0;background:none;padding:0;color:var(--sub)}
aside .m .chip::before{display:none}
@@ -379,56 +945,115 @@ td.bar.rc1 span,td.bar.rc2 span,td.bar.rc3 span,td.bar.rc4 span{background:var(-
thead th{border-bottom-color:var(--line)}
/* チップ: 文字は墨のまま、標本の色は点で(文字を系列の色にしない) */
-.chip,.st{border:1px solid var(--line);color:var(--ink);background:oklch(0.2 0.03 50 / .45)}
+.chip,.st{border:1px solid var(--line);color:var(--ink);background:color-mix(in oklch,var(--paper2) 45%,transparent)}
.chip::before,.st::before{content:"";display:inline-block;width:.6em;height:.6em;border-radius:50%;margin-right:.35em;vertical-align:.02em;background:var(--c,var(--sub))}
.chip.none,.st.no{border-style:dashed;color:var(--sub)}
.rc1{--c:var(--r1)}.rc2{--c:var(--r2)}.rc3{--c:var(--r3)}.rc4{--c:var(--r4)}
.st{--c:var(--r1)}.st.part{--c:var(--r3);border-style:solid}.st.no{--c:transparent}
-/* 詳細: 胡桃材にピンで留めた象牙色の紙面。ページの中で一番大きく、一番明るい面=大胆さはここだけ。
- 紙の繊維は SVG のノイズを一度だけ絵にして敷く(スクロールのたびに計算させない) */
-.topic{position:relative;background-color:var(--ivory);color:var(--ivory-ink);border-radius:3px;padding:30px 30px 24px;margin-top:8px;
-background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='180' height='180'%3E%3Cfilter id='f'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.012 .55' numOctaves='3' seed='9'/%3E%3CfeColorMatrix values='0 0 0 0 .35 0 0 0 0 .27 0 0 0 0 .18 0 0 0 .08 0'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23f)'/%3E%3C/svg%3E");
-box-shadow:0 1px 0 oklch(1 0 0 / .5) inset,0 2px 0 oklch(0.2 0.03 50 / .35),0 26px 44px -20px oklch(0.08 0.02 50 / .95)}
-.topic::before{content:"";position:absolute;top:-7px;left:50%;width:16px;height:16px;margin-left:-8px;border-radius:50%;
-background:radial-gradient(circle at 35% 30%,oklch(1 0 0 / .8),var(--c,var(--ivory-sub)) 45%,oklch(0.2 0.03 50) 100%);box-shadow:0 3px 4px oklch(0.1 0.02 50 / .6)}
+/* 詳細とホームの札: コルク板にピンで留めた象牙色の紙。ページの中で一番明るい面=大胆さはここだけ。
+ 紙の繊維は SVG のノイズを一度だけ絵にして敷く(スクロールのたびに計算させない)。
+ 紙は板に貼り付いているので、大きくぼけた落ち影は付けない。前は板から浮いて見えた(2026-10-22 かしぇ「コルクにたいしてカードが浮いて影ついてるの意味わかんない」)。
+ 影は、紙の縁が板に触れる所の細い影と、下の両角が少し反った所の影(::after)だけにする */
+.topic,.home .card{position:relative;background-color:var(--ivory);color:var(--ivory-ink);border-radius:3px;padding:30px 30px 24px;margin-top:8px;
+background-image:@@PAPER@@;
+box-shadow:0 1px 0 color-mix(in oklch,var(--glass) 50%,transparent) inset,0 0 0 1px color-mix(in oklch,var(--umbra) 16%,transparent),0 1px 2px color-mix(in oklch,var(--umbra) 45%,transparent)}
+/* ピンは上の真ん中に1本。頭は紙の内側に刺さっている位置に置き、右下へ小さな影を落とす。詳細は区切った理由の色、ホームの札は真鍮 */
+.home .card{--c:var(--brass)}
+.topic::before,.home .card::before{content:"";position:absolute;top:8px;left:50%;width:16px;height:16px;margin-left:-8px;border-radius:50%;z-index:1;
+background:radial-gradient(circle at 35% 30%,color-mix(in oklch,var(--glass) 80%,transparent),var(--c,var(--ivory-sub)) 45%,var(--paper2) 100%);
+box-shadow:1px 2px 2px color-mix(in oklch,var(--umbra) 55%,transparent)}
+/* 下の両角が板から少し反った影。札のすぐ下に、左右の端だけ濃く、内側へ向けて消える細い帯を置く */
+.topic::after,.home .card::after{content:"";position:absolute;left:3px;right:3px;top:100%;height:9px;pointer-events:none;
+background:radial-gradient(farthest-side at 0 0,color-mix(in oklch,var(--umbra) 50%,transparent),transparent) left top/44px 9px no-repeat,
+radial-gradient(farthest-side at 100% 0,color-mix(in oklch,var(--umbra) 50%,transparent),transparent) right top/44px 9px no-repeat}
.topic h2,.topic a{color:var(--ivory-ink)}
+/* 題の下の問いの全文。見出しより一段小さく、本文と同じ墨で */
+.topic .question{margin:.1rem 0 .3rem;font-size:.95rem;line-height:1.75;color:var(--ivory-ink)}
.topic .note,.topic dt,.topic summary{color:var(--ivory-sub)}
.topic .card{background:none;border:0;box-shadow:none;padding:0;margin:22px 0 0}
.topic .card>h3{border-bottom-color:var(--ivory-line);font-size:1.02rem}
-.topic .chip,.topic .st{border-color:var(--ivory-line);color:var(--ivory-ink);background:oklch(1 0 0 / .45)}
-.topic .docs a{background:oklch(1 0 0 / .5);border:1px solid var(--ivory-line);color:var(--ivory-ink)}
+.topic .chip,.topic .st{border-color:var(--ivory-line);color:var(--ivory-ink);background:color-mix(in oklch,var(--glass) 45%,transparent)}
+.topic .docs a{background:color-mix(in oklch,var(--glass) 50%,transparent);border:1px solid var(--ivory-line);color:var(--ivory-ink)}
.topic .docs a:hover,.topic .docs a:focus-visible{border-color:var(--ivory-ink)}
-.topic .hosts span{border-color:var(--ivory-line);background:oklch(1 0 0 / .4)}
+.topic .hosts span{border-color:var(--ivory-line);background:color-mix(in oklch,var(--glass) 40%,transparent)}
.topic .hosts b{color:var(--ivory-sub)}
-/* 切り替えは View Transitions でつなぐ。一覧の題名が紙面の見出しまで移って大きくなり、ほかは重ねて入れ替わる。
- 対応しないブラウザと、動きを減らす設定では即座に切り替わる(下の留まる動きだけ残る) */
-::view-transition-old(root),::view-transition-new(root){animation-duration:.32s;animation-timing-function:cubic-bezier(.2,.8,.2,1)}
-::view-transition-group(specimen){animation-duration:.38s;animation-timing-function:cubic-bezier(.2,.8,.2,1)}
-::view-transition-old(specimen),::view-transition-new(specimen){height:100%;object-fit:none;object-position:left top}
-html.vt .topic:target{animation:none!important}
-/* 選んだときの動きは1つだけ: 紙面が上から留まる */
-@media (prefers-reduced-motion:no-preference){.topic:target{animation:pinned .32s cubic-bezier(.2,.8,.2,1)}
-@keyframes pinned{from{opacity:0;transform:translateY(-12px) rotate(-.5deg)}to{opacity:1;transform:none}}}
+/* 画面の切り替えの動きはスクリプトが本文(.view)にだけ付ける。説明の表の分類名は折り返さない */
+.guide td{vertical-align:top;padding:6px 8px;border-bottom:1px solid var(--ivory-line)}.guide td:first-child{white-space:nowrap}
+.guide p,.guide li{line-height:1.8}.guide table{font-size:.85rem}.topic.guide::before{display:none}
+/* 説明の節。流れの各段の下に、それが出る画面の項目を小さく添える。畳んだ中身は札の中で一段下げる */
+.guide .lead{font-size:1.06rem;margin:6px 0 4px}
+/* スキルのフローは段を1つずつ枠で囲み、番号を枠の左に置く(2026-10-22 かしぇ「一個ごとに囲って見やすくする」)。
+ 番号は SKILL.md の段と同じく0から数える */
+.guide ol.flow{list-style:none;padding:0;margin:12px 0 4px;counter-reset:step -1}
+.guide ol.flow li{counter-increment:step;display:grid;grid-template-columns:auto minmax(0,1fr);gap:12px;align-items:start;
+ margin:8px 0;padding:11px 14px 12px 12px;border:1px solid var(--ivory-line);border-radius:10px;
+ background:color-mix(in oklch,var(--glass) 30%,transparent)}
+.guide ol.flow li::before{content:counter(step);width:1.7em;height:1.7em;border-radius:50%;display:grid;place-items:center;margin-top:.1em;
+ font:700 .85rem/1 var(--head),serif;color:var(--ivory);background:var(--ivory-ink)}
+.guide ol.flow .to{display:block;margin-top:4px;font-size:.84rem;color:var(--sub)}.guide ol.flow .to::before{content:"→ "}
+.guide ul.parts{list-style:none;padding:0}.guide ul.parts li{margin:.35em 0}
+.guide ul.parts b{display:inline-block;min-width:3.2em;margin-right:.6em;font-family:var(--head)}
+.guide details.more{margin-top:10px}.guide details.more .more-body{padding:4px 0 2px 1.1em}
+.guide code{overflow-wrap:anywhere}
+/* 行き先を data-href へ移したリンクにも、押せる印の指の形を出す */
+a[data-href]{cursor:pointer}
+/* ?のボタンは、パソコンでマウスを乗せると「ヘルプ」の札を下に出す(2026-10-22 かしぇ)。触る画面には乗せる動作が無いので出さない */
+@media (hover:hover){.help::after{content:attr(data-tip);position:absolute;top:calc(100% + 8px);right:0;white-space:nowrap;
+ padding:4px 10px;border-radius:6px;background:var(--side-bg);color:var(--ivory);font:500 12.5px/1.5 var(--head),serif;letter-spacing:.08em;
+ box-shadow:0 4px 12px -4px color-mix(in oklch,var(--umbra) 70%,transparent);opacity:0;transform:translateY(-3px);
+ transition:opacity .15s,transform .15s;pointer-events:none}
+ .help:hover::after,.help:focus-visible::after{opacity:1;transform:none}}
+/* 画面の図。スマホの図は紙の幅いっぱいでも 340px まで(PC で大きく出しすぎない)。番号の丸は絵の中の印と同じ紅紫 */
+.guide figure.shot{margin:14px 0 18px}.guide figure.shot img{display:block;width:auto;max-width:min(100%,560px);max-height:560px;height:auto;border-radius:8px;
+ box-shadow:0 0 0 1px var(--ivory-line),0 4px 10px -6px color-mix(in oklch,var(--umbra) 60%,transparent)}
+.guide figure.shot figcaption{margin:0 0 8px;font-family:var(--head);font-weight:700;font-size:1.12rem;letter-spacing:.06em}
+.guide figure.shot img{margin-bottom:8px}
+.guide ol.legend{list-style:none;padding:0;margin:0}.guide ol.legend li{display:flex;gap:8px;align-items:baseline;margin:.3em 0}
+.guide ol.legend .n{flex:none;width:1.45em;height:1.45em;border-radius:50%;background:var(--beni);color:var(--glass);font:700 .78rem/1.45em system-ui,sans-serif;text-align:center}
+.guide ol.legend .n.only{background:none;color:var(--beni);box-shadow:inset 0 0 0 1.5px var(--beni)}
.grip{background:var(--paper2);border-color:var(--line)}
.grip::before{border-color:var(--sub)}
header .menu{background:var(--card2);border-color:var(--line)}
-.shade{background:oklch(0.1 0.02 50 / .55)!important}
+.shade{background:color-mix(in oklch,var(--umbra) 38%,transparent)!important}
+/* 暗い面も本体と同じ角丸にする。四角のままだと、丸く切った角の外の一覧まで暗くなった(2026-10-21 かしぇ「影が角丸の外にもない?」) */
+@media (max-width:760px){.shade{border-radius:34px 0 0 34px}}
/* 一覧を開くと、退いた本体の四隅をスマホの画面と同じ角丸に見せる(2026-10-21 かしぇ)。
- 頭と本文は別の要素なので、本体の四隅に一覧の地の色の扇形を重ねて丸く見せる。本体と一緒に動く */
+ 角は頭と本文の border-radius で丸く切り、外側には後ろの一覧がそのまま見える。
+ この面は角丸に沿った内側の影だけを持つ。本体と一緒に動く */
.frame{display:none}
+/* 引っぱって更新はスマホだけ。スマホ用の指定より後ろにあるので、幅で絞って上書きしないようにする */
+@media (min-width:761px){.ptr{display:none}}
@media (max-width:760px){
.frame{display:block;position:fixed;inset:0;z-index:4;pointer-events:none;opacity:0;transform:translateX(var(--x,0px));
- transition:transform .25s cubic-bezier(.2,.8,.2,1),opacity .2s;border-radius:34px;
- /* 角丸の外側を一覧の地の色の輪で覆い、内側の左の縁に影を入れて本体を一段手前に見せる。
- 同じ色の扇形を四隅に置くだけだと、同じ色の頭の帯の上で角丸が見えなかった */
- box-shadow:0 0 0 30px var(--paper2),inset 14px 0 22px -14px oklch(0.06 0.02 50 / .9),inset 0 0 0 1px oklch(1 0 0 / .08)}
+ transition:transform .25s cubic-bezier(.2,.8,.2,1),opacity .25s cubic-bezier(.2,.8,.2,1);border-radius:34px 0 0 34px;
+ /* 角の外側を色で塗ると、その下の一覧の文字が隠れた(2026-10-21 かしぇ「そっちこそ透けて欲しい」)。
+ 外へ広がる輪は、一覧の上にはみ出して縁取りに見えた。影は内側だけにする(かしぇ「いい感じだった影」) */
+ box-shadow:inset 14px 0 22px -14px color-mix(in oklch,var(--umbra) 90%,transparent)}
+ /* 角丸と影は引き始めから出しきる。引いた距離に合わせて出すと、角が徐々に丸くなるように見えた(2026-10-21 かしぇ「ずっと角丸にできない?」) */
body.open .frame,body.dragging .frame{opacity:1}
body.dragging .frame{transition:none}
}
@media (max-width:760px){.topic{padding:24px 16px 18px}.topic h2{font-size:1.05rem;font-weight:600;line-height:1.55}}
+/* PC では一覧を画面の上端から下端まで通し、頭の帯は出さない(中身の一覧を開くボタンはスマホだけ)。説明のボタンは画面の右上に固定する。
+ 帯を全幅に渡すと、一覧のロゴの上に何も無い段ができた。本文の地は右端まで敷き、読む幅だけ .view で絞って中央に置く
+ (main に最大幅を付けると、その右に別の地が縦の帯になって見えた・2026-10-22 かしぇ「PC 側の UI が終わってる」) */
+@media (min-width:761px){
+ header{display:none}
+ .layout{min-height:100vh}
+ main{max-width:none;padding:74px 28px 64px 24px}
+ .view{max-width:60rem;margin-inline:auto}
+ /* 幅を変えるつまみは境の線そのものにする。触れたときだけ線が明るくなる。線の中ほどに真鍮の金具を付け、畳んだときも左端に金具が残る */
+ .grip{top:0;right:-6px;transform:none;width:12px;height:100%;border:0;border-radius:0;background:none}
+ .grip::before{left:5px;top:0;bottom:0;width:0;border:0;border-left:2px solid transparent;transition:border-color .15s}
+ .grip:hover::before,.grip:focus-visible::before,body.dragging .grip::before{border-left-color:var(--sub)}
+ body.collapsed .grip{right:-14px}
+}
"""
+CSS = CSS.replace("@@DASH_VARS@@", palette.css_vars(palette.DASH))
+CSS += CORK_CSS
+CSS = CSS.replace("@@PAPER@@", texture_url("paper"))
# 一覧の開閉。広い画面は一覧の右端のつまみをドラッグして幅を変える・畳む(押すだけでも開閉)。
@@ -440,57 +1065,122 @@ header .menu{background:var(--card2);border-color:var(--line)}
# - 開くと履歴を1つ積み、端末の戻るで閉じる。開いている間は本文に暗い面をかけ、押すと閉じる
# 幅と開閉は localStorage に覚える。スクリプトが動かなくても一覧は CSS だけで出ている
SIDE_JS = """(function(){var b=document.body,s=document.getElementById('side'),g=s.querySelector('.grip'),
+// ホーム画面から開いたか。iPhone は navigator.standalone、ほかは display-mode で見る(CSS の body.app の指定が使う)
+app=b.classList.toggle('app',navigator.standalone===true||matchMedia('(display-mode: standalone)').matches),
m=matchMedia('(max-width:760px)'),K='imozuru-side',LOCK=15,RATIO=1.5,EDGE=24,FLICK=0.3,COMMIT=72,last=288,pushed=false;
function st(v){try{localStorage.setItem(K,v)}catch(e){}}
try{var v=localStorage.getItem(K);if(v==='0')b.classList.add('collapsed');else if(v){last=+v;b.style.setProperty('--side',v+'px')}}catch(e){}
function W(){return s.getBoundingClientRect().width}
-var mb=document.querySelector('header .menu');
+var mb=document.querySelector('header .menu'),mn=document.querySelector('main');
+// スマホでは本体が画面いっぱいの箱で、その中がスクロールする。開閉は class を付け替えるだけで、スクロール位置にも角にも触れない
+// (角丸と動きは CSS。前の body の固定と clip-path の切り抜きは、iPhone で閉じた直後に黒い帯を出した)
+// 一覧を開くと履歴を1つ積み、閉じると戻る。iPhone は履歴を戻ったとき、#t-… の札の位置まで本体を自分でスクロールし直し、
+// どこまで読んでいても同じ位置へ飛んだ(2026-10-22 かしぇ「サイドバーから復帰するときのスクロール位置が固定されちゃってて そこにすっとぶ」)。
+// ブラウザの位置の復元を止め、開いたときの読む位置を覚えておき、同じ札のまま閉じたらそこへ戻す。
+// 戻る操作の popstate はあとから届くので、閉じた直後の popstate でも戻し、さらに2コマ後にもう一度戻す
+try{history.scrollRestoration='manual'}catch(x){}
+var keep=null;function hold(){if(!keep||keep.h!==location.hash)return;var y=keep.y;mn.scrollTop=y;
+requestAnimationFrame(function(){requestAnimationFrame(function(){mn.scrollTop=y})})}
function setOpen(o,fromPop){if(o===b.classList.contains('open'))return;b.classList.toggle('open',o);mb.setAttribute('aria-expanded',String(o));
-if(o){history.pushState({imozuruPane:1},'');pushed=true}else if(pushed&&!fromPop){pushed=false;history.back()}else pushed=false}
-addEventListener('popstate',function(){if(b.classList.contains('open'))setOpen(false,true)});
+if(o){keep=m.matches?{h:location.hash,y:mn.scrollTop,t:0}:null;history.pushState({imozuruPane:1},'');pushed=true}
+else{if(keep){keep.t=Date.now();hold()}if(pushed&&!fromPop){pushed=false;history.back()}else pushed=false}}
+addEventListener('popstate',function(){if(b.classList.contains('open'))setOpen(false,true);else if(keep&&Date.now()-keep.t<800)hold()});
+// 引っぱって更新(スマホ・本体の上端で下へ引いたとき)。本体の弾みは止めてあるので、自前で引く量を出す。
+// 指の動きは pointer ではなく touch で受ける(縦の操作はブラウザがスクロールとして握り、pointer は途中で中断される)。
+// 10px までは向きを決めず、横か上向きなら引かない(一覧を開く横のドラッグと分ける)。引く量は指の半分にして重さを出す
+var PULL=64,pl=null;function pset(d){b.style.setProperty('--pull',d+'px');b.style.setProperty('--pp',Math.min(1,d/PULL).toFixed(3));b.classList.toggle('ready',d>=PULL)}
+function pclear(){b.classList.remove('pulling','ready');b.style.removeProperty('--pull');b.style.removeProperty('--pp')}
+mn.addEventListener('touchstart',function(e){pl=null;if(!m.matches||b.classList.contains('open')||b.classList.contains('refreshing')||mn.scrollTop>0||e.touches.length!==1)return;
+pl={x:e.touches[0].clientX,y:e.touches[0].clientY,d:0,on:false}},{passive:true});
+mn.addEventListener('touchmove',function(e){if(!pl)return;var dx=e.touches[0].clientX-pl.x,dy=e.touches[0].clientY-pl.y;
+if(!pl.on){if(Math.hypot(dx,dy)<10)return;if(dy<=0||Math.abs(dx)>=Math.abs(dy)||mn.scrollTop>0){pl=null;return}pl.on=true;pl.y0=pl.y+dy;b.classList.add('pulling')}
+if(e.cancelable)e.preventDefault();pl.d=Math.max(0,Math.min(PULL*1.6,(e.touches[0].clientY-pl.y0)*.5));pset(pl.d)},{passive:false});
+function pend(){if(!pl)return;var g2=pl;pl=null;if(!g2.on)return;b.classList.remove('pulling');
+if(g2.d>=PULL){b.classList.add('refreshing');pset(PULL);setTimeout(function(){location.reload()},450)}else pclear()}
+mn.addEventListener('touchend',pend);mn.addEventListener('touchcancel',pend);
+// 開いたまま幅 760px を越えたら閉じる(横向きにしたときなど)。PC の配置に開いた状態が残らないように
+m.addEventListener('change',function(e){if(!e.matches&&b.classList.contains('open'))setOpen(false)});
document.querySelector('header .menu').addEventListener('click',function(){setOpen(!b.classList.contains('open'))});
document.querySelector('.shade').addEventListener('click',function(e){if(e.detail>0&&e.timeStamp-endAt<250)return;setOpen(false)});
-s.querySelectorAll('aside a').forEach(function(a){a.addEventListener('click',function(){
-if(m.matches&&b.classList.contains('open')){pushed=false;b.classList.remove('open');mb.setAttribute('aria-expanded','false')}})});
-// 一覧の調査を選ぶ・ホームへ戻るを View Transitions でつなぐ。選んだ題名と紙面の見出しに同じ名前を付け替えて、
-// 古い画面の題名から新しい画面の見出しへ移す(同じ名前が2つあると動かないので、更新の中で付け替える)
-var VT=!!document.startViewTransition&&!matchMedia('(prefers-reduced-motion:reduce)').matches;
-if(VT)document.documentElement.classList.add('vt');
-function vt(from,toSel,hash){var go=function(){location.hash=hash};if(!VT){go();return}
-if(from)from.style.viewTransitionName='specimen';
-document.startViewTransition(function(){if(from)from.style.viewTransitionName='';go();
-var to=toSel&&document.querySelector(toSel);if(to&&from)to.style.viewTransitionName='specimen'}).finished.then(function(){
-var to=toSel&&document.querySelector(toSel);if(to)to.style.viewTransitionName=''})}
-s.querySelectorAll('aside a').forEach(function(a){a.addEventListener('click',function(e){if(e.defaultPrevented||!VT)return;e.preventDefault();
-var id=a.getAttribute('href');var q=m.matches?null:a.querySelector('.q');vt(q,id+' h2',id.slice(1))})});
-document.querySelectorAll('.topic .back').forEach(function(a){a.addEventListener('click',function(e){if(!VT)return;e.preventDefault();vt(null,null,'')})});
+// 画面の切り替え(ホーム・各調査・説明)は、どれも同じ1枚の中の節を出し分ける。# に合わせて show() が節に印(.on)を付ける。ページの読み込みは起きない。
+// 動きは1種類にそろえる: 本文(.view)だけを短く薄くしてから差し替え、先頭へ戻して、上から留まるように出す。
+// ページ全体の重ね合わせ(View Transitions)は、一覧が戻る動きと重なって変に見えたのでやめた(2026-10-21 かしぇ)
+var vw=document.querySelector('.view'),RM=matchMedia('(prefers-reduced-motion:reduce)').matches,busy=null,ours=false;
+function top0(){if(m.matches)mn.scrollTop=0;else scrollTo(0,0)}
+function enter(){if(!RM&&vw.animate)vw.animate([{opacity:0,transform:'translateY(-8px)'},{opacity:1,transform:'none'}],{duration:240,easing:'cubic-bezier(.2,.8,.2,1)'})}
+// 出す札に印(.on)を付ける。# の書き換えと同じ処理の中で呼び、札の無いコマを描かせない
+// #doc/<調査>/<文書> は、文書を本体の枠(iframe)に開く。ヘッダーと一覧を残したまま読める(2026-10-22 かしぇ「ヘッダーとサイドバー外して 戻るHUD入れる意味ある?」)。
+// 開ける文書は、詳細の札の文書のボタン(data-doc)に在るものだけ。窓口(http)のときは ?embed=1 で戻るボタンを外してもらう
+// 枠の中身を差し替えるときは location.replace で読む。src を書き換えると履歴が1つ積まれ、端末の戻るで枠の中だけが戻った
+var dv=document.getElementById('docview'),fr=dv.querySelector('iframe'),cur='';
+// ページの中を移るリンク(調査・ヘルプ・ホーム・文書)は、行き先を data-href へ移して href を外す。href があると、
+// マウスを乗せたときにブラウザが左下に行き先を出し、そこに合言葉つきの URL も見えた(2026-10-22 かしぇ「offれない?」)。
+// スクリプトが動かないときは href のまま普通のリンクとして動く。外したリンクはキーボードで選べるよう tabindex を付ける
+document.querySelectorAll('a[href^="#"],a[data-doc]').forEach(function(a){a.setAttribute('data-href',a.getAttribute('href'));a.removeAttribute('href');
+a.setAttribute('role','link');a.tabIndex=0});
+document.addEventListener('keydown',function(e){var a=e.target.closest&&e.target.closest('a[data-href]');if(a&&e.key==='Enter'){e.preventDefault();a.click()}});
+function show(){var h=location.hash,el=null,doc=null;
+if(h.indexOf('#doc/')===0){doc=decodeURIComponent(h.slice(5));if(!document.querySelector('a[data-doc="'+CSS.escape(doc)+'"]'))doc=null}
+else el=h.length>1&&document.getElementById(decodeURIComponent(h.slice(1)));
+document.querySelectorAll('.topic.on').forEach(function(t){if(t!==el)t.classList.remove('on')});if(el&&el.classList.contains('topic'))el.classList.add('on');
+dv.classList.toggle('on',!!doc);b.classList.toggle('doc',!!doc);
+if(doc)document.querySelector('.dochud').setAttribute('data-href','#t-'+doc.split('/')[0]);
+if(doc){var u=doc+(location.protocol.indexOf('http')===0?'?embed=1':'');if(u!==cur){try{if(cur)fr.contentWindow.location.replace(u);else fr.src=u}catch(x){fr.src=u}cur=u}}}
+b.classList.add('js');show();
+function swap(hash,after){var apply=function(){if(location.hash!==hash){ours=true;location.hash=hash}show();top0();marks();if(after)after();enter()};
+if(RM||!vw.animate){apply();return}if(busy)busy.cancel();
+busy=vw.animate([{opacity:1},{opacity:0}],{duration:110,easing:'ease-in',fill:'forwards'});busy.onfinish=function(){busy.cancel();busy=null;apply()}}
+// スマホで開いた一覧から選んだときは、Discord と同じく中身を差し替えてから本体を戻す
+document.addEventListener('click',function(e){var a=e.target.closest&&e.target.closest('a[data-href]');if(!a||e.defaultPrevented)return;
+var h=a.hasAttribute('data-doc')?'#doc/'+a.getAttribute('data-doc'):a.getAttribute('data-href');if(h==='#')h='';e.preventDefault();var closing=m.matches&&b.classList.contains('open');
+swap(h,closing?function(){pushed=false;setOpen(false)}:null)});
+// ブラウザは hash の節へのスクロールを後から行うので、hashchange でもう一度先頭へ戻す。
+// 端末の戻る・進むで変わったときも、先頭へ戻して同じ動きで出す
+addEventListener('hashchange',function(){show();top0();if(ours){ours=false;return}enter()});
+// 文書の戻るボタンなど、#t-… つきで開いたときも、ブラウザが節の位置まで送るので読み込み後に先頭へ戻す。
+// スマホでは送る先が本体の箱になり、送るのが load の後のコマになったので、2コマ後にもう一度戻す
+addEventListener('load',function(){if(!location.hash)return;top0();requestAnimationFrame(function(){requestAnimationFrame(top0)})});
var t=null,endAt=-1e9;
function wide(el){var w=el&&el.closest&&el.closest('.tablewrap,pre');return w&&w.scrollWidth>w.clientWidth}
function marks(){document.querySelectorAll('.tablewrap,pre').forEach(function(w){w.style.touchAction=w.scrollWidth>w.clientWidth?'auto':''})}
marks();addEventListener('resize',marks);addEventListener('hashchange',marks);document.addEventListener('toggle',marks,true);
-document.addEventListener('pointerdown',function(e){if(!m.matches||e.button>0)return;
+function pdown(e){if(!m.matches||e.button>0)return;
// リンクの上から始めた操作も受ける(開いた一覧の項目の上から閉じられるように)。ドラッグの直後のクリックは下で止める
-if(e.target.closest&&e.target.closest('header .menu,summary,input'))return;
+if(e.target.closest&&e.target.closest('header .menu,summary,input,.pager,.find'))return;
// 横にスクロールできる表の上で始めた操作は、表のスクロールに譲る
if(wide(e.target))return;
var open=b.classList.contains('open');if(!open&&(e.clientX<EDGE||e.clientX>innerWidth-EDGE))return;
var f=open?W():0;t={id:e.pointerId,x:e.clientX,y:e.clientY,axis:'p',v:null,lx:e.clientX,lt:e.timeStamp,from:f,cur:f};
-if(e.pointerType==='mouse')e.preventDefault()});
-addEventListener('pointermove',function(e){if(!t||e.pointerId!==t.id)return;var dx=e.clientX-t.x,dy=e.clientY-t.y;
+if(e.pointerType==='mouse')e.preventDefault()}
+document.addEventListener('pointerdown',pdown);
+function pmove(e){if(!t||e.pointerId!==t.id)return;var dx=e.clientX-t.x,dy=e.clientY-t.y;
if(t.axis==='p'){if(Math.hypot(dx,dy)<LOCK)return;var ax=Math.abs(dx),ay=Math.abs(dy);
t.axis=ay>=RATIO*ax?'y':(ax>ay?'x':'p');if(t.axis==='y'){t=null;return}if(t.axis!=='x')return;
// 横に決まったら指の追跡をページが握る(指が要素の外へ出ても動きを拾い続ける)
try{b.setPointerCapture(t.id)}catch(x){}b.classList.add('dragging');t.kx=e.clientX;t.kt=e.timeStamp}
var dt=e.timeStamp-t.lt;if(dt>0){var inst=(e.clientX-t.lx)/dt;t.v=t.v===null?inst:0.5*inst+0.5*t.v}t.lx=e.clientX;t.lt=e.timeStamp;
-t.cur=Math.min(W(),Math.max(0,t.from+dx));b.style.setProperty('--x',t.cur+'px')});
+t.cur=Math.min(W(),Math.max(0,t.from+dx));b.style.setProperty('--x',t.cur+'px');b.style.setProperty('--p',(t.cur/W()).toFixed(3))}
+addEventListener('pointermove',pmove);
// iOS では指のドラッグが「放した」ではなく「中断」や「握りを失った」で終わることが多い。
// 軸が横に決まった後なら、終わり方によらず最後の位置と速さで開閉を決める(中断を「元に戻す」と読むと、放した瞬間に戻る)
function end(e){if(!t||e.pointerId!==t.id)return;var g0=t;t=null;if(g0.axis!=='x')return;
-b.classList.remove('dragging');b.style.removeProperty('--x');endAt=e.timeStamp;
+b.classList.remove('dragging');b.style.removeProperty('--x');b.style.removeProperty('--p');endAt=e.timeStamp;
var moved=g0.cur-g0.from,v=g0.v,open;
if(v===null)v=(g0.lx-g0.kx)/Math.max(1,g0.lt-g0.kt);
if(Math.abs(v)>=FLICK)open=v>0;else open=g0.from>0?moved>-COMMIT:moved>=COMMIT;setOpen(open)}
addEventListener('pointerup',end);addEventListener('pointercancel',end);
+// 文書の枠(iframe)の上の指の動きは枠の中の文書が受け取り、ここへは届かない。文書(skin.FRAME_JS)が送ってくる
+// 指の位置を、本体の上の指の動きとして同じ処理に渡す。これで枠の上でも横に引いて一覧を開閉できる
+// (2026-10-22 かしぇ「サイドバー引っ張って開けないのは結構きつい」)。送り主は今の枠の中の文書だけを受ける
+addEventListener('message',function(e){var d=e.data;if(e.source!==fr.contentWindow||!d||d.imz!=='touch')return;var r=fr.getBoundingClientRect();
+var ev={pointerId:'frame',pointerType:'touch',button:0,target:fr,timeStamp:performance.now(),clientX:r.left+d.x,clientY:r.top+d.y,preventDefault:function(){}};
+if(d.type==='down')pdown(ev);else if(d.type==='move')pmove(ev);
+// 文書の一番上から下へ引いた量(pull)は、本体の引っぱって更新と同じ札と重さで見せ、離したら同じ基準で読み込み直す
+else if(d.type==='pull'){if(!m.matches||b.classList.contains('open')||b.classList.contains('refreshing'))return;
+b.classList.add('pulling');fp=Math.max(0,Math.min(PULL*1.6,d.dy*.5));pset(fp)}
+else if(d.type==='pullend'){if(!b.classList.contains('pulling'))return;b.classList.remove('pulling');
+if(fp>=PULL){b.classList.add('refreshing');pset(PULL);setTimeout(function(){location.reload()},450)}else pclear();fp=0}
+else end(ev)});var fp=0;
// 横にドラッグした直後のクリック(指を放した所のリンクや暗い面)は、押したことにしない
document.addEventListener('click',function(e){if(e.detail>0&&e.timeStamp-endAt<250){e.preventDefault();e.stopPropagation()}},true);
// 握りを失った合図は、ページが握っていたときだけ終了と読む。子の要素から出た合図で終えると、握った直後に自分で止まる
@@ -504,6 +1194,144 @@ if(!g1.mv){if(b.classList.toggle('collapsed'))st('0');else{b.style.setProperty('
var close=g1.w===0?dx<COMMIT:(w<120||(dx<=-COMMIT&&w<200));
if(close){b.classList.add('collapsed');b.style.removeProperty('--side');st('0')}
else{w=Math.max(200,w);last=w;b.style.setProperty('--side',w+'px');st(String(w))}});
+// 折りたたみ(details.more)の開閉を、中身の高さと透明度の動きでつなぐ。details は既定では一瞬で開閉する。
+// 札の高さは動かさず、開いたらすぐ最終の高さにして、中身を切り抜きの範囲で上から見せていく。
+// 高さを動かすと、Safari は札の影をコマごとに描き直す。「ほか N 媒体」は画面の10倍ほどの高さがあり、
+// 1コマに約0.36秒かかって、一瞬で切り替わって見えた(2026-10-22 かしぇ「一瞬できりかわるように見えてる」)。
+// 見せていくのは画面に見えている範囲だけ。閉じるときも同じ範囲を下から消し、終わってから open を外す
+// 説明の節の画面の図は、見ている端末(760px を境にスマホとパソコン)の組だけを開いたまま残し、もう一方は畳む
+document.querySelectorAll('#guide details[data-dev]').forEach(function(d){if(d.getAttribute('data-dev')!==(matchMedia('(max-width:760px)').matches?'sp':'pc'))d.open=false});
+document.querySelectorAll('details.more').forEach(function(dt){var sm=dt.querySelector('summary'),bd=dt.querySelector('.more-body'),an=null;
+function visible(){return Math.max(1,Math.min(bd.offsetHeight,innerHeight-bd.getBoundingClientRect().top))}
+function clip(px){return 'inset(0 0 '+Math.max(0,bd.offsetHeight-px)+'px 0)'}
+sm.addEventListener('click',function(e){if(matchMedia('(prefers-reduced-motion:reduce)').matches||!bd.animate)return;e.preventDefault();
+var opening=!dt.open||dt.classList.contains('closing');if(an)an.cancel();
+if(opening){dt.classList.remove('closing');dt.open=true;var v=visible();
+an=bd.animate([{clipPath:clip(0),opacity:0,transform:'translateY(-6px)'},{opacity:1,offset:.5},{clipPath:clip(v),opacity:1,transform:'none'}],
+{duration:520,easing:'cubic-bezier(.33,1,.68,1)'});an.onfinish=function(){an=null}}
+else{dt.classList.add('closing');var v=visible();
+an=bd.animate([{clipPath:clip(v),opacity:1},{clipPath:clip(0),opacity:0}],{duration:340,easing:'cubic-bezier(.65,0,.35,1)',fill:'forwards'});
+an.onfinish=function(){if(dt.classList.contains('closing')){dt.open=false;dt.classList.remove('closing')}an.cancel();an=null}}})});
+// 一覧の検索とページ送り。項目は消さずに class(.off)で隠す(選んでいる調査の印は :has() で項目を名指ししている)。
+// 検索語は空白で区切り、全部の語がどこかに入っている調査を残す。探す先は 題名 → 題名の側(slug・日付・媒体のホスト)→ 読み(map.md の「読み:」)→ 用語・人・媒体。
+// 題名で当たった所は光らせ、読み・用語・人・媒体で当たったら、その文を項目の下に1行添える(NN/g: 途中で当たる候補は、打った文字のほうを強調する)。
+// 根拠は ~/research/ja-incremental-search(2026-10-22)。1ページの件数は決めず、一覧の高さに収まるまで項目の実際の高さを積んで区切る
+var as=s.querySelector('aside'),ol=as.querySelector('ol'),fi=document.getElementById('find'),fl=fi.parentNode,
+none=as.querySelector('.find-none'),live=document.getElementById('find-n'),pgs=[].slice.call(document.querySelectorAll('.pager'));
+// 文字の畳み方。大文字小文字・カタカナとひらがな・全角と半角の英数を同じにする。1文字を1文字に直すので、当たった位置がそのまま元の文の位置になる
+function fold(v){v=String(v).toLowerCase();var o='';for(var i=0;i<v.length;i++){var c=v.charCodeAt(i);
+if(c>=0x30a1&&c<=0x30f6)c-=0x60;else if(c>=0xff01&&c<=0xff5e)c-=0xfee0;o+=String.fromCharCode(c)}return o}
+// ローマ字の表。ヘボン式・訓令式・IME の打ち方(Google 日本語入力・MS-IME)を同じかなへ寄せる(Migemo もヘボン式と訓令式の両方を展開する)
+var RK={};("a:あ i:い u:う e:え o:お ka:か ki:き ku:く ke:け ko:こ ca:か cu:く co:こ sa:さ si:し shi:し su:す se:せ so:そ ta:た ti:ち chi:ち tu:つ tsu:つ te:て to:と "+
+"na:な ni:に nu:ぬ ne:ね no:の ha:は hi:ひ hu:ふ fu:ふ he:へ ho:ほ ma:ま mi:み mu:む me:め mo:も ya:や yu:ゆ yo:よ ra:ら ri:り ru:る re:れ ro:ろ "+
+"wa:わ wi:うぃ we:うぇ wo:を ga:が gi:ぎ gu:ぐ ge:げ go:ご za:ざ zi:じ ji:じ zu:ず ze:ぜ zo:ぞ da:だ di:ぢ du:づ de:で do:ど "+
+"ba:ば bi:び bu:ぶ be:べ bo:ぼ pa:ぱ pi:ぴ pu:ぷ pe:ぺ po:ぽ kya:きゃ kyu:きゅ kyo:きょ sya:しゃ sha:しゃ syu:しゅ shu:しゅ syo:しょ sho:しょ she:しぇ "+
+"tya:ちゃ cha:ちゃ cya:ちゃ tyu:ちゅ chu:ちゅ cyu:ちゅ tyo:ちょ cho:ちょ cyo:ちょ che:ちぇ nya:にゃ nyu:にゅ nyo:にょ hya:ひゃ hyu:ひゅ hyo:ひょ "+
+"mya:みゃ myu:みゅ myo:みょ rya:りゃ ryu:りゅ ryo:りょ gya:ぎゃ gyu:ぎゅ gyo:ぎょ zya:じゃ ja:じゃ jya:じゃ zyu:じゅ ju:じゅ jyu:じゅ zyo:じょ jo:じょ jyo:じょ "+
+"je:じぇ dya:ぢゃ dyu:ぢゅ dyo:ぢょ bya:びゃ byu:びゅ byo:びょ pya:ぴゃ pyu:ぴゅ pyo:ぴょ fa:ふぁ fi:ふぃ fe:ふぇ fo:ふぉ va:ゔぁ vi:ゔぃ vu:ゔ ve:ゔぇ vo:ゔぉ "+
+"thi:てぃ dhi:でぃ twu:とぅ xa:ぁ la:ぁ xi:ぃ li:ぃ xu:ぅ lu:ぅ xe:ぇ le:ぇ xo:ぉ lo:ぉ xya:ゃ lya:ゃ xyu:ゅ lyu:ゅ xyo:ょ lyo:ょ "+
+"xtu:っ ltu:っ xtsu:っ ltsu:っ xwa:ゎ lwa:ゎ nn:ん xn:ん").split(' ').forEach(function(p){var i=p.indexOf(':');RK[p.slice(0,i)]=p.slice(i+1)});
+// 打ちかけ(「yuuy」の「y」)を、続きうるかなの候補へ広げる表と、かなの母音(長音の揺れを畳むのに使う)
+var ALT={},VOW={'ゃ':'a','ゅ':'u','ょ':'o'};Object.keys(RK).forEach(function(k){for(var l=1;l<k.length;l++){var p=k.slice(0,l);(ALT[p]=ALT[p]||[]).push(RK[k])}
+var v=k.charAt(k.length-1);if(RK[k].length===1&&'aiueo'.indexOf(v)>=0)VOW[RK[k]]=v});
+// ローマ字をかなへ。促音(kk→っ)と「ん」(子音の前の n)も扱う。末尾が打ちかけなら p に残す。英字が無ければ null
+function kana(q){var out='',i=0,lat=false;while(i<q.length){var c=q.charAt(i),c2=q.charAt(i+1);
+if(c<'a'||c>'z'){out+=c==='-'?'ー':c;i++;continue}lat=true;
+if(c==='n'&&c2&&((c2<'a'||c2>'z')||"aiueoyn".indexOf(c2)<0)){out+='ん';i++;continue}
+// 「konnichiha」の nn の後ろが母音なら「ん」+な行に読む(探すときは打ち方の差を広く拾う)
+var c3=q.charAt(i+2);if(c==='n'&&c2==='n'&&c3&&"aiueoy".indexOf(c3)>=0){out+='ん';i++;continue}
+if(c===c2&&'aiueon'.indexOf(c)<0){out+='っ';i++;continue}
+var L=4,hit=false;for(;L>0;L--){var key=q.substr(i,L);if(RK[key]){out+=RK[key];i+=L;hit=true;break}}if(hit)continue;
+var rest=q.slice(i);if(ALT[rest])return {k:out,p:rest};out+=c;i++}return lat?{k:out,p:''}:null}
+// 長音の揺れを畳む。「ゆうやけ」と「yuyake」、「とうきょう」と「tokyo」を同じにする(ヘボン式は長音を書かないことがある)。位置は保てないので光らせない
+function flat(v){var o='';for(var i=0;i<v.length;i++){var c=v.charAt(i),pv=VOW[o.charAt(o.length-1)];if(c==='ー'||(c==='う'&&(pv==='u'||pv==='o'))||(c==='お'&&pv==='o'))continue;o+=c}return o}
+// 1語を1つの文の中で探す。当たれば [位置, 長さ](位置 -1 は長音を畳んで当たった=光らせない)。変換前の字のままで当たらなければ、かなに直して探す
+function find(h,k,kv){var i=h.indexOf(k);if(i>=0)return [i,k.length];if(!kv||!kv.k)return null;
+var al=kv.p?ALT[kv.p]:[''];for(var j=0;j<al.length;j++){i=h.indexOf(kv.k+al[j]);if(i>=0)return [i,kv.k.length+al[j].length]}
+var fh=flat(h);for(j=0;j<al.length;j++){var fk=flat(kv.k+al[j]);if(fk.length>1&&fh.indexOf(fk)>=0)return [-1,0]}return null}
+var items=[].slice.call(ol.children).map(function(li){var w=[];try{w=JSON.parse(li.getAttribute('data-w')||'[]')}catch(x){}
+var q=li.querySelector('.q'),t=q.textContent,r=li.getAttribute('data-r')||'';
+return {li:li,a:li.querySelector('a'),q:q,t:t,f:fold(t),s:fold(li.getAttribute('data-s')||''),r:r,rf:fold(r),
+w:w.map(function(p){return [p[0],p[1],fold(p[1])]})}}),shown=items,pages=[items],pi=0,seq=0,running=[];
+// 題名を、当たった範囲に印(mark)を付けて組み直す
+function mark(el,txt,rs){el.textContent='';rs.sort(function(x,y){return x[0]-y[0]});var at=0;rs.forEach(function(r){if(r[0]<at)return;
+if(r[0]>at)el.appendChild(document.createTextNode(txt.slice(at,r[0])));var m=document.createElement('mark');m.textContent=txt.slice(r[0],r[0]+r[1]);el.appendChild(m);at=r[0]+r[1]});
+if(at<txt.length)el.appendChild(document.createTextNode(txt.slice(at)))}
+// 項目の下の1行。長い文は当たった所が見えるように、手前を「…」で詰める
+function setHit(it,h){var el=it.a.querySelector('.hit');if(!h){if(el)el.remove();return}
+if(!el){el=document.createElement('span');el.className='hit';it.a.appendChild(el)}
+var txt=h[1],at=h[2],len=h[3];if(at>16){txt='…'+txt.slice(at-8);at=9}
+el.textContent='';var k=document.createElement('b');k.textContent=h[0];el.appendChild(k);var body=document.createElement('span');el.appendChild(body);
+mark(body,txt,at>=0&&len?[[at,len]]:[])}
+function filter(){var q=fold(fi.value.normalize('NFKC')).split(' ').filter(Boolean);shown=[];
+items.forEach(function(it){var hit=null,rs=[],ok=q.every(function(k){var kv=kana(k),m=find(it.f,k,kv);if(m){if(m[0]>=0)rs.push(m);return true}
+if(find(it.s,k,kv))return true;
+m=find(it.rf,k,kv);if(m){if(!hit)hit=['読み',it.r,m[0],m[1]];return true}
+for(var i=0;i<it.w.length;i++){m=find(it.w[i][2],k,kv);if(m){if(!hit)hit=[it.w[i][0],it.w[i][1],m[0],m[1]];return true}}return false});
+// 題名は1行で切れるので、後ろのほうで当たった印は見えない。そのときは当たった前後を下の1行に出す
+if(ok&&!hit&&rs.length){rs.sort(function(x,y){return x[0]-y[0]});if(rs[0][0]>16)hit=['題名',it.t,rs[0][0],rs[0][1]]}
+mark(it.q,it.t,ok?rs:[]);setHit(it,ok&&hit);if(ok)shown.push(it)});
+none.hidden=shown.length>0;none.querySelector('.nq').textContent=fi.value;live.textContent=q.length?shown.length+'件':'';fl.classList.toggle('has',fi.value!=='')}
+function room(){var cs=getComputedStyle(as);return as.clientHeight-parseFloat(cs.paddingTop)-parseFloat(cs.paddingBottom)}
+// 区切り直す。keep に渡した項目が載るページを開く。畳んだ一覧(幅がほぼ0)は測れないので、開いたときに測り直す
+function paginate(keep){if(as.clientWidth<120)return;var H=room(),hide={};stop();
+items.forEach(function(it){it.li.classList.add('off')});shown.forEach(function(it){it.li.classList.remove('off')});
+// 高さは端数まで測る。offsetHeight は整数に丸めるので、11件で合計が 2px 足りず、一覧がはみ出した
+// スマホの一覧は閉じている間、奥へ下がった形(縮小)で置いてある。測った高さを縮小の分だけ戻す(transform は offsetHeight に効かない)
+var sc=as.getBoundingClientRect().height/(as.offsetHeight||1)||1;
+pages=[[]];var h=0;shown.forEach(function(it){var x=it.li.getBoundingClientRect().height/sc;if(h+x>H&&pages[pages.length-1].length){pages.push([]);h=0}pages[pages.length-1].push(it);h+=x});
+if(keep)pages.forEach(function(p,i){if(p.indexOf(keep)>=0)pi=i});pi=Math.min(pi,pages.length-1);place();bar()}
+function place(){items.forEach(function(it){it.li.classList.add('off')});pages[pi].forEach(function(it){it.li.classList.remove('off')})}
+function bar(){b.classList.toggle('pg-one',pages.length<2);pgs.forEach(function(p){var n=p.querySelector('.pg-n');
+if(document.activeElement!==n)n.value=pi+1;p.querySelector('.pg-t').textContent=pages.length;
+p.querySelector('[data-step="-1"]').disabled=pi<=0;p.querySelector('[data-step="1"]').disabled=pi>=pages.length-1})}
+function stop(){running.forEach(function(a){a.cancel()});running=[]}
+// めくる動き。次へは今の項目が上へ薄れて退き、次の項目が下から順に留まる。前へは逆向き。
+// 退場は短く(0.16秒・加速)、登場は長め(0.38秒・減速)にして、新しい項目に目が行くようにする。ずらしは1件 0.014〜0.022 秒で、8件で頭打ち
+// 動きの途中でまためくったら、前の動きは終わった形(行き先のページ)に置いてから始める
+function go(n,dir){n=Math.max(0,Math.min(pages.length-1,n));if(running.length){seq++;stop();place()}if(n===pi){bar();return}
+var my=++seq,old=pages[pi]||[];
+if(RM||!ol.animate||!dir){pi=n;place();bar();return}
+var out=old.map(function(it,i){return it.li.animate([{opacity:1,transform:'none'},{opacity:0,transform:'translateY('+(-dir*14)+'px)'}],
+{duration:160,delay:Math.min(i,8)*14,easing:'cubic-bezier(.4,0,1,1)',fill:'forwards'})});running=out.slice();pi=n;bar();
+Promise.all(out.map(function(a){return a.finished})).then(function(){if(my!==seq)return;stop();place();
+running=pages[pi].map(function(it,i){return it.li.animate([{opacity:0,transform:'translateY('+(dir*18)+'px)'},{opacity:1,transform:'none'}],
+{duration:380,delay:Math.min(i,8)*22,easing:'cubic-bezier(.33,1,.68,1)',fill:'backwards'})})},function(){})}
+// 絞り込み直したときは向きが無いので、1ページ目を短く出すだけにする
+function refilter(){filter();pi=0;paginate();if(!RM&&ol.animate)running=pages[0].map(function(it,i){return it.li.animate([{opacity:0,transform:'translateY(6px)'},{opacity:1,transform:'none'}],
+{duration:220,delay:Math.min(i,8)*12,easing:'cubic-bezier(.33,1,.68,1)',fill:'backwards'})})}
+// 変換中も打つたびに絞る(欄の打ちかけのローマ字は kana() が続きの候補へ広げる)。Firefox は確定の input を compositionend より先に出すので、確定でも絞り直す
+fi.addEventListener('input',refilter);fi.addEventListener('compositionend',refilter);
+// Enter で先頭の調査を開き、Esc で検索語を消す。ただし変換中の Enter と Esc は IME のもの(確定・取り消し)なので触らない。
+// Obsidian で、変換を確定する Enter が先頭の候補を開く不具合があった(ja-incremental-search の obsidian-ime-search.md)。Safari は keyCode 229 で見分ける
+fi.addEventListener('keydown',function(e){if(e.isComposing||e.keyCode===229)return;
+if(e.key==='Enter'&&shown.length){e.preventDefault();fi.blur();shown[0].a.click()}
+else if(e.key==='Escape'&&fi.value){fi.value='';refilter()}});
+function clearFind(){fi.value='';refilter();fi.focus()}
+fl.querySelector('.clear').addEventListener('click',clearFind);none.querySelector('button').addEventListener('click',clearFind);
+pgs.forEach(function(p){var n=p.querySelector('.pg-n');
+p.addEventListener('click',function(e){var bt=e.target.closest('[data-step]');if(bt&&!bt.disabled){var d=+bt.getAttribute('data-step');go(pi+d,d)}});
+// 番号は押すと全部選んだ状態になり、そのまま打ち替えられる。範囲の外の数は端のページに丸める
+n.addEventListener('focus',function(){n.select()});
+n.addEventListener('keydown',function(e){if(e.key==='Enter'){e.preventDefault();n.blur()}else if(e.key==='Escape'){n.value=pi+1;n.blur()}});
+n.addEventListener('change',function(){var v=parseInt(String(n.value).normalize('NFKC'),10);if(isNaN(v)){n.value=pi+1;return}
+var to=Math.max(0,Math.min(pages.length-1,v-1));go(to,to>pi?1:to<pi?-1:0);n.value=to+1});
+n.addEventListener('blur',function(){n.value=pi+1})});
+// PC は一覧の上のホイールでめくる(一覧はもうスクロールしないので、ホイールが本文へ渡らないようにもする)
+var wacc=0,wat=0;as.addEventListener('wheel',function(e){if(m.matches)return;e.preventDefault();if(e.timeStamp-wat<350)return;
+wacc+=e.deltaY;if(Math.abs(wacc)<40)return;var d=wacc>0?1:-1;wacc=0;wat=e.timeStamp;go(pi+d,d)},{passive:false});
+// スマホは開いた一覧を縦に払ってめくる(上へ払うと次)。横の払いは一覧の開閉のほうが受ける
+var sw=null;as.addEventListener('touchstart',function(e){sw=e.touches.length===1?{x:e.touches[0].clientX,y:e.touches[0].clientY}:null},{passive:true});
+as.addEventListener('touchend',function(e){if(!sw||!m.matches)return;var c=e.changedTouches[0],dx=c.clientX-sw.x,dy=c.clientY-sw.y;sw=null;
+if(Math.abs(dy)>48&&Math.abs(dy)>1.5*Math.abs(dx)){var d=dy<0?1:-1;go(pi+d,d)}});
+function current(){var h=location.hash;for(var i=0;i<shown.length;i++)if(shown[i].a.getAttribute('data-href')===h)return shown[i];return null}
+// 選んでいる調査が今のページに無いとき(直接 #t-… で開いた・戻るで戻った)は、それが載るページへ移る
+function follow(){var c=current();if(!c||pages[pi].indexOf(c)>=0)return;for(var i=0;i<pages.length;i++)if(pages[i].indexOf(c)>=0){go(i,i>pi?1:-1);return}}
+addEventListener('hashchange',follow);
+// 一覧の高さが変わったら(画面の回転・PC の窓の大きさ・畳んだ一覧を開いた)区切り直す。今のページの先頭の項目を保つ
+filter();paginate(current());
+if(window.ResizeObserver)new ResizeObserver(function(){var k=current()||(pages[pi]||[])[0];paginate(k)}).observe(as);
+if(document.fonts&&document.fonts.ready)document.fonts.ready.then(function(){paginate(current()||(pages[pi]||[])[0])});
})();"""
@@ -531,110 +1359,322 @@ def status_chip(status: str) -> str:
def title_of(t: dict) -> str:
- return t["question"] or t["slug"]
+ """一覧と詳細の見出しに出す名前。map.md の「題:」、無ければ問い、それも無ければ slug"""
+ return t.get("title") or t["question"] or t["slug"]
def topic_html(t: dict) -> str:
run = t["run"] or {}
rounds = "記録なし" if t["rounds"] is None else f"{t['rounds']} 周"
- if run.get("周"):
- rounds += f'<span class="note">(台帳の記載: {esc(run["周"])})</span>'
- facts = [("日付", esc(t["date"] or "記録なし")), ("たどった周", rounds),
- ("原文", f"{t['sources']} 本" + (f'<span class="note">(台帳の記載: {esc(run["原文"])})</span>' if run.get("原文") else "")),
- ("調査を区切った理由", (f'<span class="chip {reason_cls(t)}">{esc(t["reason_class"])}</span> '
+ # 台帳の値は、数えた値と食い違うときだけ短く添える(説明は #guide の節に置く)。
+ # 台帳は「2周」「原文32本」のように単位つきで書かれることがあるので、最初の数どうしで比べる
+ def differs(ledger: str, counted) -> bool:
+ m = re.search(r"\d+", ledger)
+ return not m or int(m.group()) != counted
+ if run.get("周") and differs(run["周"], t["rounds"]):
+ rounds += f'<span class="note">(台帳 {esc(run["周"])})</span>'
+ srcs = f"{t['sources']} 本"
+ if run.get("原文") and differs(run["原文"], t["sources"]):
+ srcs += f'<span class="note">(台帳 {esc(run["原文"])})</span>'
+ facts = [("日付", esc(t["date"] or "記録なし")), ("周回数", rounds), ("原文", srcs),
+ ("終了理由", (f'<span class="chip {reason_cls(t)}">{esc(t["reason_class"])}</span> '
+ esc(t["reason"])) if t["reason"] else "記録なし")]
+ # 台帳の列名は「感覚と合った?」のまま。画面では誰の答えかが分かる名前で出す(2026-10-22 かしぇ)
if run.get("感覚と合った?"):
- facts.append(("感覚と合った?", esc(run["感覚と合った?"])))
+ facts.append(("ユーザーの反応", esc(run["感覚と合った?"])))
if t["searches"] is not None:
line = f"検索 {t['searches']} 本・ヒット {t['hits']} 件"
if t["fetch_ok"] is not None:
line += f"・保存 {t['fetch_ok']}・取得失敗 {t['fetch_ng']}"
facts.append(("検索と取得", line))
else:
- facts.append(("検索と取得", '記録なし<span class="note">(検索の記録を残す前の調査)</span>'))
+ facts.append(("検索と取得", "記録なし"))
+ # 紙面の「← ホームへ」は置かない。ホームへはロゴで戻る(2026-10-22 かしぇ「ホームへ のリンク廃止」)
out = [f'<section class="topic {reason_cls(t)}" id="t-{esc(t["slug"])}">',
- '<a class="back" href="#">← ホームへ</a>',
f"<h2>{esc(title_of(t))}</h2>",
+ # 題を見出しにしたときは、問いの全文を見出しのすぐ下に出す(問いは調べる範囲を決める文なので削らない)
+ *([f'<p class="question">{esc(t["question"])}</p>'] if t.get("title") and t["question"] and t["question"] != t["title"] else []),
f'<p class="note">{esc(t["slug"])}</p>',
'<div class="card"><dl class="facts">' + "".join(f"<dt>{k}</dt><dd>{v}</dd>" for k, v in facts) + "</dl></div>"]
if t["docs"]:
out.append('<div class="card"><h3>文書</h3><div class="docs">'
- + "".join(f'<a href="{esc(t["slug"])}/{esc(name)}">{esc(label)}</a>' for name, label in t["docs"]) + "</div></div>")
+ # data-doc があれば、スクリプトがダッシュボードの本体の枠に開く。動かないときは href の別ページで開く
+ + "".join(f'<a href="{esc(t["slug"])}/{esc(name)}" data-doc="{esc(t["slug"])}/{esc(name)}">{esc(label)}</a>'
+ for name, label in t["docs"]) + "</div></div>")
if t["claims"]:
out.append('<div class="card"><h3>調査の論点</h3><ul class="claims">'
+ "".join(f"<li>{status_chip(s)}<span>{esc(c)}</span></li>" for c, s in t["claims"]) + "</ul></div>")
if t["hosts"]:
- out.append('<div class="card"><h3>原文を取得した媒体</h3><div class="hosts">'
+ out.append('<div class="card"><h3>取得元</h3><div class="hosts">'
+ "".join(f"<span>{esc(h)}<b>{n}</b></span>" for h, n in Counter(t["hosts"]).most_common()) + "</div></div>")
out.append("</section>")
return "\n".join(out)
-def home_html(topics: list[dict]) -> str:
+# 説明の節に載せる画面の図(make_guide_shots.py が架空の調査を撮って作る)。
+# 番号は絵の中の印と同じ。意味は絵のすぐ下に文字で書く(絵と説明を離すと、見比べる手間が増える)
+# 説明の節に載せる画面の図の、画面ごとの部品・番号・説明。スマホとパソコンの図はどちらもこの表から作る
+# (make_guide_shots.py が架空の調査を撮り、ここの部品に印を重ねる)。端末ごとに書き分けると、
+# 指す部品と番号がずれた(2026-10-22 かしぇ「スマホとPCで解説している内容がバラついてるのがやばい」)。
+# 両方の端末にある部品は数字(4つ目の欄が空)で、どちらの組にも同じ番号と説明で載る。
+# 片方の端末にしか無い部品(スマホの ☰ と ×、パソコンのつまみ)は、その端末の組にだけ A・B の文字で載せる
+# (同「スマホの=と×の説明はあるべき そこは臨機応変でしょ」)。
+# 画面名は、名前だけで何の画面かが分かる語にする(同「画面名は 自己紹介でなくてはならない」で紙面→トピック詳細)。
+# 部品は CSS のセレクタで、{dev} は端末(sp・pc)、{t} は撮るトピック詳細に置き換える
+GUIDE_SCREENS = [
+ ("home", "ホーム", [(".help", "1", "ヘルプを表示", ""),
+ (".card.tally", "2", "全トピックの集計。下方に終了理由・原文の取得元・周回数の内訳が続きます", ""),
+ (".menu", "A", "サイドバーを表示", "sp")]),
+ ("side", "サイドバー", [(".home-link", "3", "ロゴ。押すとホームへ移動します", ""), (".find", "4", "検索欄", ""),
+ (".pager.{dev}", "5", "ページ送り", ""),
+ ("aside li:first-child a", "6", "トピック1件。題名と日付。左端の色は終了理由の分類", ""),
+ (".menu", "B", "サイドバーを閉じる", "sp"),
+ (".grip", "A", "サイドバーの幅を調整するつまみ。押すと折り畳みます", "pc")]),
+ ("topic", "トピック詳細", [("{t} dl.facts", "7", "トピックの記録", ""), ("{t} .docs", "8", "文書。選択すると、この枠内に表示します", ""),
+ ("{t} ul.claims", "9", "調査の論点と、原文の有無を示す印", "")]),
+ ("doc", "文書閲覧", [(".docview iframe", "10", "表示中の文書", ""), (".dochud", "11", "トピック詳細へ戻る", "")]),
+]
+
+
+def screen_parts(legend: list[tuple[str, str, str, str]], dev: str) -> list[tuple[str, str, str, str]]:
+ """画面の部品のうち、その端末の図に載るもの(両方にある部品と、その端末にだけある部品)"""
+ return [x for x in legend if x[3] in ("", dev)]
+
+
+def shot_html(name: str, caption: str, legend: list[tuple[str, str, str, str]]) -> str:
+ """図を1枚、番号の説明と一緒に出す。絵が無ければ(make_guide_shots.py を回す前など)何も出さない"""
+ png = LOGO.with_name(name)
+ if not png.is_file():
+ return ""
+ src = "data:image/webp;base64," + base64.b64encode(png.read_bytes()).decode()
+ items = "".join(f'<li><span class="n{"" if n.isdigit() else " only"}">{esc(n)}</span>{esc(t)}</li>' for _, n, t, _ in legend)
+ # 題 → 図 → 番号の説明の順。何の画面かを先に読んでから図を見る(2026-10-22 かしぇ「ガメンタイトル→スクショ→解説がいいな」)
+ return (f'<figure class="shot"><figcaption>{esc(caption)}</figcaption>'
+ f'<img src="{src}" alt="{esc(caption)}。番号の印は下の説明と対応しています" loading="lazy"><ol class="legend">{items}</ol></figure>')
+
+
+# 分類の意味。画面には名前だけを出し、意味は説明のページに置く
+REASON_MEANING = {
+ "論点充足": "全論点に原文が付いて終了",
+ "一部充足": "一部の論点を残して終了",
+ "期限到達": "依頼の時間・回数の上限に到達して終了",
+ "取得不可": "残りの原文がログイン・有料・ボット対策の先にあり、取得できずに終了",
+ "情報飽和": "新規に挙がる人物・資料の大半が、既に地図に存在",
+ "周回上限": "4周追跡して終了",
+}
+
+
+def sentence_lines(markup: str) -> str:
+ """説明の文の形をそろえる。項目の最後の文に句点が無ければ付け(同「。をさいごにつけてない部分はつける」)、
+ 文の終わり(。)ごとに改行を入れて1文ずつ行に分ける(同「ヘルプ画面の改行が もっとしていいとおもう」・ja-writing の改行の段)。
+ タグの中(画像の alt など)と、図の番号の説明(ol.legend)には改行を入れない。番号1つの説明は短く、
+ 途中で折ると番号との対応が崩れて見えた(同「同じ数字の中なら改行しない」)"""
+ markup = re.sub(r"([^。>\s])</li>", r"\1。</li>", markup)
+ out, skip = [], False
+ for part in re.split(r"(<[^>]+>)", markup):
+ if part.startswith("<"):
+ skip = True if part.startswith('<ol class="legend"') else False if part == "</ol>" and skip else skip
+ out.append(part)
+ else:
+ out.append(part if skip else re.sub(r"。(?=\S)", "。<br>", part))
+ return "".join(out)
+
+
+def guide_html(topics: list[dict]) -> str:
+ """画面の説明(同じページの #guide の節)。数え方・分類の規則・操作をここに集め、ほかの画面には書かない。
+ 別のファイルにするとページの読み込みで画面が一瞬白くなったので、同じページの中に置く(2026-10-21 かしぇ)。
+
+ 上から読めば、この画面が何のためにあるかから分かるように、全体から詳細へ並べる
+ (2026-10-22 かしぇ「そもそもこのアプリはなんなのか というところから」「ただし認知負荷は削減」)。
+ 開いたまま読むのは、何の画面か・スキルのフロー・画面構成まで。操作・分類の表・集計方法は畳み、
+ 要る人だけが開く(慣れた人には要らない説明を押しつけない・~/research/cognitive-load-dataviz)。
+ 用語はスキルのフローの各段に「画面のどの項目に出るか」として添え、別の用語集は作らない(同じ説明を2か所に置かない)。
+ imozuru そのものの説明は置かない。この画面を開く人は imozuru を使っている(同日かしぇ「要らない」)。
+ 文は「です・ます」で、和語に開いた言い方は熟語にする(同日かしぇ「日本語的に開かれた表現は積極的に熟語にする」)"""
n = len(topics)
- with_reason = [t for t in topics if t["reason_class"] != "記録なし"]
- reasons = Counter(t["reason_class"] for t in with_reason).most_common()
- hosts = Counter(h for t in topics for h in t["hosts"])
+ with_reason = sum(1 for t in topics if t["reason_class"] != "記録欠落")
with_hosts = sum(1 for t in topics if t["hosts"])
+ with_rounds = sum(1 for t in topics if t["rounds"] is not None)
fetch_topics = [t for t in topics if t["fetch_ok"] is not None]
+ # 分類と状態は、画面に出ているのと同じ札(.chip・status_chip)で見せる。名前の文字だけだと、画面のどれのことか照らし合わせにくい
+ # (2026-10-22 かしぇ「表示してるコンポーネントつかったほうがわかりやすくていい」)
+ def reason_chip(label: str) -> str:
+ return f'<span class="chip {reason_cls({"reason_class": label})}">{esc(label)}</span>'
+ rules = "".join(f"<tr><td>{reason_chip(label)}</td><td>{esc(REASON_MEANING.get(label, ''))}</td><td>{esc('・'.join(words))}</td></tr>"
+ for label, words in REASON_RULES)
+ rules += f"<tr><td>{reason_chip('記録欠落')}</td><td>台帳に記録が無い</td><td>—</td></tr>"
+ fetch = (f"取得の成否の記録は {len(fetch_topics)}件にあります。" if fetch_topics else "取得の成否の記録があるトピックはまだありません。")
+
+ # 画面構成は、図があれば図で見せる。図が無いときだけ文字の3行で書く。
+ # スマホとパソコンの図を1組ずつ畳みに入れる。両方とも開いた状態で書き、スクリプトが見ている端末の組だけを開いたまま残す
+ # (スクリプトが動かないときは両方開いたまま)。見ていない端末の図まで読ませない
+ shots_sp, shots_pc = ("".join(shot_html(f"guide-{dev}-{key}.webp", title, screen_parts(legend, dev)) for key, title, legend in GUIDE_SCREENS)
+ for dev in ("sp", "pc"))
+ shots = "".join(f'<details class="more" data-dev="{dev}" open><summary>{label}</summary><div class="more-body">{html_}</div></details>'
+ for dev, label, html_ in (("sp", "スマホの画面", shots_sp), ("pc", "パソコンの画面", shots_pc)) if html_)
+ parts = ('<ul class="parts"><li><b>ホーム</b>最初に表示される画面です。全トピックの集計として、終了理由・原文の取得元・周回数の内訳を並べます</li>'
+ '<li><b>サイドバー</b>トピックを新しい順に並べます。パソコンでは常に表示し、スマホでは左上のボタンで表示します。左端の色の帯は終了理由の分類です</li>'
+ '<li><b>トピック詳細</b>サイドバーで選択したトピックの記録と文書です</li></ul>')
+
+ def more(summary: str, body: str) -> str:
+ return f'<details class="more"><summary>{summary}</summary><div class="more-body">{body}</div></details>'
+
+ # 段は SKILL.md の「流れ」の 0〜4 と同じ番号と順にする。あとで SKILL.md を読む人が対応を取れるように
+ # (2026-10-22 かしぇ「調べものの流れ ←スキルのフロー とか がいいかも」)
+ flow = "".join(f"<li><div class=\"flow-step\">{esc(step)}。<span class=\"to\">{esc(item)}</span></div></li>" for step, item in (
+ ("調査する疑問と、回答に必要な論点を3〜6個決定します。論点は「定番の手法は何か」「どこで失敗するか」のように、疑問を分割した小さな設問です", "調査の論点"),
+ ("その分野の用語・人物・媒体を探索し、地図(map.md)に記録します。ここまでを0周目と呼びます", "文書の map.md"),
+ ("引用・リンク・著者を追跡して原文を保存し、地図に追記します。一巡を1周と数えます", "周回数・原文・取得元"),
+ ("各周の終了時に、継続か終了かを判断します。全論点に原文が付く、新規の資料が出現しなくなる、などの条件で終了します", "終了理由"),
+ ("原文の抜き書きと、解説付きの詳細レポートを作成して提出し、結果が感覚と合致したかを依頼者に確認します", "文書・ユーザーの反応")))
+ ops_sp = ("<li>サイドバーは、左上のボタンを押すか、本文を右へスワイプすると表示されます。左へスワイプするか、暗転した本文を押すと閉じます</li>"
+ "<li>サイドバー上部の検索欄は、題名・疑問・用語・人物・媒体を対象に検索します。ひらがなやローマ字でも一致します</li>"
+ "<li>サイドバーのページは、サイドバー表示中の右端の帯にある、× の下のボタンで送ります。サイドバーを上下にスワイプしても送れます(上へスワイプで次のページ)。番号を押すと直接入力できます</li>"
+ "<li>画面の最上部で下へ引くと、記録を再読み込みします</li>"
+ "<li>文書はトピック詳細の枠内に表示されます。左下のボタンでトピック詳細へ戻ります</li>")
+ ops_pc = ("<li>サイドバー右端のつまみをドラッグすると幅を調整でき、押すと折り畳みます</li>"
+ "<li>サイドバーのページは、サイドバー下端のボタンか、サイドバーの上でのホイール操作で送ります。番号を押すと直接入力できます</li>"
+ "<li>サイドバー上部のロゴを押すと、ホームへ移動します</li>")
+ phone = ("<ol><li>PC で <code>dashboard.py --serve</code> を実行します。合言葉付きの URL が表示されます</li>"
+ "<li>PC とスマホに Tailscale(自分の機器同士だけを接続する VPN)を導入して同じアカウントで接続し、PC で <code>tailscale serve --bg 8765</code> を実行します</li>"
+ "<li>スマホで <code>https://&lt;PC の名前&gt;.&lt;tailnet&gt;.ts.net/?k=&lt;合言葉&gt;</code> を開きます</li>"
+ "<li>Safari の共有メニューから「ホーム画面に追加」すると、ロゴのアイコンから起動できます</li></ol>"
+ "<p>配信用の窓口は PC 内部(127.0.0.1)でのみ待ち受け、Tailscale が自分の機器にだけ中継します。"
+ "合言葉は <code>IMOZURU_SERVE_TOKEN</code> で固定できます。固定しないと起動ごとに変化し、ホーム画面のアイコンから開けなくなります。</p>")
+ claims = '<ul class="claims">' + "".join(f"<li>{status_chip(st)}<span>{esc(text)}</span></li>" for st, text in (
+ ("根拠あり", "論点に原文の所在が付いています。"), ("一部のみ", "論点の一部にのみ原文が付いています。"),
+ ("根拠なし", "探索したものの、原文が付いていません。"), ("未確認", "抜き書きが未作成のトピックで、地図の論点にまだ印がありません。"))) + "</ul>"
+ counts = (f"<ul><li>トピック: 調査の保存先(既定 <code>~/research</code>)直下のフォルダ1つを1件と数えます</li>"
+ f"<li>原文: <code>sources/</code> のファイルを、拡張子を除いた名前で集計します(PDF とその文字起こしは1本)</li>"
+ f"<li>周回数: <code>log.md</code> の「N周目」の見出しと検索の記録から集計します。0周目(地図作成)は含みません。{n}件中 {with_rounds}件に記録があります</li>"
+ f"<li>取得元: <code>map.md</code> の原文の表の URL を、媒体ごとに集計します。ホームには上位{SHOWN_HOSTS}件を表示します。{n}件中 {with_hosts}件に記録があります</li>"
+ f"<li>検索と取得: <code>queries.jsonl</code> と <code>fetch-log.jsonl</code> から集計します。{fetch}</li>"
+ f"<li>終了理由・ユーザーの反応: 台帳(<code>--runs</code> で指定する <code>evals/runs.md</code>)から読み取ります。台帳に無いトピックは「記録欠落」「記録なし」となります。{n}件中 {with_reason}件に記録があります</li>"
+ "<li>台帳記載の周回数・原文数が集計値と異なる場合のみ、括弧で台帳の値を併記します</li>"
+ "<li>「記録なし」は、0 と区別するための表示です</li></ul>")
+ return sentence_lines(f"""<h2><span lang="en">imozuru</span> 調査記録とは</h2>
+<p class="lead">imozuru で行った調査を、トピックごとに並べたダッシュボードです。トピックは、1つの疑問について調べたひとまとまりのことを指します。過去のトピックとその文書を探し出し、それぞれがどこまで進んでどう終わったかを見比べられます。</p>
+<div class="card"><h3>スキルのフロー</h3>
+<p>imozuru は1つのトピックを、次の段の順に進めます。各段の下の名前は、その結果が出る画面の項目です。</p>
+<ol class="flow" start="0">{flow}</ol></div>
+<div class="card"><h3>画面構成</h3>
+{shots or parts}
+{more("スマホでの操作", f"<ul>{ops_sp}</ul>")}
+{more("パソコンでの操作", f"<ul>{ops_pc}</ul>")}</div>
+<div class="card"><h3>スマホでの閲覧</h3>
+<p>PC で配信した画面を、スマホのブラウザで閲覧できます。</p>
+{more("手順", phone)}</div>
+<div class="card"><h3>分類と状態</h3>
+{more("終了理由の分類", f'<p>imozuru はトピックごとに、終了理由などを台帳(<code>evals/runs.md</code>)へ1行記録します。その「調査を区切った理由」の文に「判定語」のいずれかが含まれれば、その分類とします。上の行ほど優先して判定します。元の文は各トピック詳細に掲載しています。</p><div class="tablewrap"><table><thead><tr><th>分類</th><th>意味</th><th>判定語</th></tr></thead><tbody>{rules}</tbody></table></div>')}
+{more("調査の論点の状態", "<p>トピック詳細の「調査の論点」で、各論点の先頭に付く印です。</p>" + claims)}</div>
+<div class="card"><h3>集計方法</h3>
+<p>数値はすべて、各トピックのフォルダの記録から機械的に集計しています。</p>
+{more("項目別の集計方法", counts)}</div>""")
+
+
+def home_html(topics: list[dict]) -> str:
+ reasons = Counter(t["reason_class"] for t in topics if t["reason_class"] != "記録欠落").most_common()
+ hosts = Counter(h for t in topics for h in t["hosts"])
by_date = [t for t in topics if t["rounds"] is not None]
- rules = "".join(f"<li>{esc(label)}: {esc('・'.join(words))}</li>" for label, words in REASON_RULES)
+ # 見出しは短い熟語にする(2026-10-21 かしぇ「画面に出すタイトルとしては冗長」)。
+ # 画面には数字と見出しだけを置き、数え方や分類の規則は #guide の節に書く(2026-10-21 かしぇ「長々と注釈や操作案内を書きたくない」)
+ # 調査と原文の総数は、ホームの最初の札に大きく置く(2026-10-22 かしぇ「ダッシュボード上の最初の大きな要素にする」)。
+ # 前は頭の帯の小さな文字だった
+ total_sources = sum(t["sources"] for t in topics)
out = ['<section class="home">',
- f'<p class="note">一覧から調査を選ぶと詳細が開く。数字はすべて各調査のフォルダの記録から機械で数えた。</p>',
- '<div class="card"><h3>調査を区切った理由</h3>',
- f'<p class="note">自動分類。{n}件中 {len(with_reason)}件に記録がある。元の文は各調査の詳細にある。</p>',
- bars(reasons, head="分類", unit="件", colors=REASON_COLOR),
- f"<details><summary>分類の規則(記録の文にこの語があれば、上から順に当てはめる)</summary><ul>{rules}</ul></details></div>",
- '<div class="card"><h3>原文を取得した媒体</h3>',
- f'<p class="note">map.md の原文の表の URL から数えた。{n}件中 {with_hosts}件に記録がある。上位{SHOWN_HOSTS}件。</p>',
+ # 札の頭に画面の名前を置く。ロゴは一覧の上にしかなく、スマホでは一覧を開くまで何の画面か分からない
+ # (2026-10-22 かしぇ「この画面が何であるかを知らせるため」)
+ '<div class="card tally"><h1 class="plate-name"><span lang="en">imozuru</span> 調査記録</h1>'
+ f'<dl><div><dt>トピック</dt><dd><b>{len(topics)}</b>件</dd></div>'
+ f'<div><dt>原文</dt><dd><b>{total_sources}</b>本</dd></div></dl></div>',
+ '<div class="card"><h3>終了理由</h3>',
+ bars(reasons, head="分類", unit="件", colors=REASON_COLOR), "</div>",
+ '<div class="card"><h3>取得元</h3>',
bars(hosts.most_common(SHOWN_HOSTS), cls="src", head="媒体", unit="本")]
if len(hosts) > SHOWN_HOSTS:
- out.append(f"<details><summary>ほか {len(hosts) - SHOWN_HOSTS} 媒体</summary>"
- + bars(hosts.most_common()[SHOWN_HOSTS:], cls="src", head="媒体", unit="本") + "</details>")
- if fetch_topics:
- ok = sum(t["fetch_ok"] for t in fetch_topics)
- ng = sum(t["fetch_ng"] for t in fetch_topics)
- out.append(f'<p class="note">取得の成否の記録は {len(fetch_topics)}件の調査にだけある(保存 {ok}・取得失敗 {ng})。</p>')
+ out.append(f'<details class="more"><summary>ほか {len(hosts) - SHOWN_HOSTS} 媒体</summary><div class="more-body">'
+ + bars(hosts.most_common()[SHOWN_HOSTS:], cls="src", head="媒体", unit="本") + "</div></details>")
out.append("</div>")
- out += ['<div class="card"><h3>たどった周の数</h3>',
- f'<p class="note">1周目以降にたどった周の数。0周目(地図づくり)は数えない。{n}件中 {len(by_date)}件に記録がある。</p>',
+ out += ['<div class="card"><h3>周回数</h3>',
bars(sorted(Counter(f"{t['rounds']} 周" for t in by_date).items(), key=lambda kv: int(kv[0].split()[0])),
head="周", unit="件"),
"</div></section>"]
return "\n".join(out)
+def chevron(d: str) -> str:
+ """ページ送りの矢印。d は SVG の線の形"""
+ return (f'<svg viewBox="0 0 24 24" width="18" height="18" aria-hidden="true" fill="none" stroke="currentColor" '
+ f'stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="{d}"/></svg>')
+
+
+FIND_HTML = ('<label class="find"><svg class="lens" viewBox="0 0 24 24" width="16" height="16" aria-hidden="true" fill="none" '
+ 'stroke="currentColor" stroke-width="2" stroke-linecap="round"><circle cx="11" cy="11" r="6.5"/><path d="M16 16l4.5 4.5"/></svg>'
+ '<input type="search" id="find" placeholder="トピック・用語・人・媒体" aria-label="サイドバーを検索" autocomplete="off" '
+ 'enterkeyhint="search" spellcheck="false">'
+ f'<button type="button" class="clear" aria-label="検索語を消す">{chevron("M7 7l10 10M17 7L7 17")}</button></label>')
+
+
+# 0件のとき。無かったことと打った語をはっきり出し、次の一手(語を消す)を添える。どこを探したかも書く
+# (NN/g 2014「Clearly explain that there are no matching results」・ビービット 2007「次にどういうアクションを取ればよいか」)
+FIND_NONE = ('<div class="find-none" hidden><p>「<b class="nq"></b>」に当てはまるトピックはない</p>'
+ '<p class="where">題名・読み・用語・人・媒体から探した</p><button type="button">検索語を消す</button></div>')
+
+
+def pager_html(kind: str) -> str:
+ """一覧のページ送り。PC は一覧の底に横並び(‹ 2 / 4 ›)、スマホは開いた一覧の右の細い帯に、
+ × の下へ縦に並べる(2026-10-22 かしぇ)。番号は押すと打ち込める。中身はスクリプトが入れる"""
+ prev, nxt = ("M15 6l-6 6 6 6", "M9 6l6 6-6 6") if kind == "pc" else ("M6 15l6-6 6 6", "M6 9l6 6 6-6")
+ sep = '<span class="t">/ <span class="pg-t">1</span></span>' if kind == "pc" else '<span class="rule"></span><span class="t pg-t">1</span>'
+ return (f'<nav class="pager {kind}" aria-label="サイドバーのページ"><button type="button" data-step="-1" aria-label="前のページ">{chevron(prev)}</button>'
+ '<input class="pg-n" type="text" inputmode="numeric" aria-label="ページ番号" value="1" autocomplete="off">'
+ f'{sep}<button type="button" data-step="1" aria-label="次のページ">{chevron(nxt)}</button></nav>')
+
+
def render(topics: list[dict], root: Path) -> str:
try:
logo = (LOGO_LIGHT if LOGO_LIGHT.is_file() else LOGO).read_text(encoding="utf-8")
logo = logo.replace("<svg ", '<svg role="img" aria-label="imozuru" ', 1)
except OSError:
logo = '<span class="ttl">imozuru</span>' # 公開版の外で動かしたときなど、ロゴが無ければ文字で出す
- total_sources = sum(t["sources"] for t in topics)
+ # 検索の索引は項目ごとの属性に持たせる。data-s は題名の側(問い・slug・日付・理由・媒体のホスト)、
+ # data-w は map.md の用語・人・媒体の箇条(当たったときに項目の下へ何で当たったかを出す)。map.md の文は他人が書いたものなので必ず esc を通す
items = "".join(
- f'<li><a class="{reason_cls(t)}" href="#t-{esc(t["slug"])}"><span class="q">{esc(title_of(t))}</span>'
+ f'<li data-s="{esc(" ".join([t["slug"], title_of(t), t["question"], t["date"], t["reason_class"], *sorted(set(t["hosts"]))]))}" '
+ f'data-w="{esc(json.dumps(t.get("words", []), ensure_ascii=False))}" data-r="{esc(t.get("reading", ""))}">'
+ f'<a class="{reason_cls(t)}" href="#t-{esc(t["slug"])}"><span class="q">{esc(title_of(t))}</span>'
f'<span class="m">{esc(t["date"] or "日付なし")}<span class="chip {reason_cls(t)}">'
f'{esc(t["reason_class"])}</span></span></a></li>' for t in topics)
- # 選んでいる調査を一覧で示す。スクリプトを使わず、:target を :has() で一覧へ伝える
- current = "".join(f'.layout:has(#t-{t["slug"]}:target) aside a[href="#t-{t["slug"]}"]'
- "{background:oklch(1 0 0 / .09)}" for t in topics)
- body = [f'<header><button class="menu" type="button" aria-controls="side" aria-expanded="false" aria-label="調査の一覧"><span></span></button>{logo}'
- f'<span class="sum">調査 {len(topics)} 件・原文 {total_sources} 本</span></header>',
+ # 選んでいる調査を一覧で示す。開いている札(スクリプトが動くときは印 .on、動かないときは :target)を :has() で一覧へ伝える
+ current = "".join(f'body:not(.js) .layout:has(#t-{t["slug"]}:target) aside a[href="#t-{t["slug"]}"],'
+ f'body.js .layout:has(#t-{t["slug"]}.on) aside a[data-href="#t-{t["slug"]}"]'
+ "{background:color-mix(in oklch,var(--glass) 9%,transparent)}" for t in topics if SLUG.fullmatch(t["slug"]))
+ body = [f'<header><button class="menu" type="button" aria-controls="side" aria-expanded="false" aria-label="サイドバー"><span></span></button>'
+ f'{pager_html("sp")}</header>', f'<a class="help" href="#guide" aria-label="ヘルプ" data-tip="ヘルプ">{HELP_ICON}</a>',
+ # 文書を本体の枠に開いているときだけ出す戻るボタン。行き先(その文書の調査の札)はスクリプトが入れる
+ # (2026-10-22 かしぇ「戻るHUDは要るね そのレポートの所属する項目に戻りたい時が絶対ある」)
+ f'<a class="imz-hud dochud" href="#" aria-label="このトピックの記録へ戻る">{HUD_ICON}</a>', PTR_ICON,
'<div class="layout">',
- f'<div class="side" id="side"><aside><h2>調査(新しい順)</h2><ol>{items}</ol></aside>'
- '<button class="grip" type="button" aria-label="調査の一覧を開く・閉じる(ドラッグでも動く)"></button></div>',
- '<button class="shade" type="button" aria-label="一覧を閉じる" tabindex="-1"></button><div class="frame" aria-hidden="true"></div>',
- "<main>", home_html(topics), *[topic_html(t) for t in topics],
- '<footer>imozuru の dashboard.py が生成。文書へのリンクは、このページと同じ場所にある調査のフォルダを指す。</footer>',
- "</main></div>"]
+ # ロゴの帯と一覧は .side-in で包む。スマホで開閉するとき、中身を1つの塊として奥へ下げ・手前へ出す
+ f'<div class="side" id="side"><div class="side-in"><div class="brand"><a class="home-link" href="#" aria-label="ホームへ">{logo}</a>{FIND_HTML}</div>'
+ f'<aside><ol>{items}</ol>{FIND_NONE}<p class="sr" id="find-n" aria-live="polite"></p></aside></div>'
+ f'{pager_html("pc")}<button class="grip" type="button" aria-label="サイドバーを開く・閉じる(ドラッグでも動く)"></button></div>',
+ '<button class="shade" type="button" aria-label="サイドバーを閉じる" tabindex="-1"></button><div class="frame" aria-hidden="true"></div>',
+ '<main><div class="view">', home_html(topics), *[topic_html(t) for t in topics],
+ f'<section class="topic guide" id="guide">{guide_html(topics)}</section>',
+ '<section class="docview" id="docview" aria-label="文書"><iframe title="文書"></iframe></section>',
+ "</div></main></div>"]
# スクリプトは中身のハッシュで許可する。'unsafe-inline' にすると、調査の記録から紛れ込んだ文字列も動きうる
script_hash = base64.b64encode(hashlib.sha256(SIDE_JS.encode()).digest()).decode()
+ # ホーム画面のアイコン。画面の高さの数え方を変える apple-mobile-web-app-* の指定とは別物で、見た目の大きさには触れない
+ # (apple-mobile-web-app-capable などを足したら、ホーム画面から開いたとき下に帯が出た・2026-10-22)
+ icon_link = '<link rel="apple-touch-icon" href="apple-touch-icon.png">' if ICON.is_file() else ""
return f"""<!doctype html>
<html lang="ja"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover">
-<meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline' https://fonts.googleapis.com; font-src https://fonts.gstatic.com; img-src data:; script-src 'sha256-{script_hash}'">
-<title>imozuru 調べものの記録</title>
+<meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline' https://fonts.googleapis.com; font-src https://fonts.gstatic.com; img-src data:; frame-src 'self' file:; script-src 'sha256-{script_hash}'">
+<title>imozuru 調査記録</title>{skin.HEAD_META}{icon_link}
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=EB+Garamond:wght@400;500&family=Noto+Serif+JP:wght@400;600&family={THEME["font"]}&display=swap">
-<style>{CSS}:root{{--bar:{THEME["bar"]};--src:{THEME["src"]};--r1:{THEME["r1"]};--r2:{THEME["r2"]};--r3:{THEME["r3"]};--r4:{THEME["r4"]};--head:{THEME["head"]},"Hiragino Mincho ProN","Yu Mincho",serif}}{current}</style></head>
+<style>{CSS}{hud_css("dark")}:root{{--bar:{THEME["bar"]};--src:{THEME["src"]};--r1:{THEME["r1"]};--r2:{THEME["r2"]};--r3:{THEME["r3"]};--r4:{THEME["r4"]};--p-r1:{THEME["p-r1"]};--p-r2:{THEME["p-r2"]};--p-r3:{THEME["p-r3"]};--p-r4:{THEME["p-r4"]};--p-bar:{THEME["p-bar"]};--p-src:{THEME["p-src"]};--head:{THEME["head"]},"Hiragino Mincho ProN","Yu Mincho",serif}}{current}</style></head>
<body>
{chr(10).join(body)}
<script>{SIDE_JS}</script>
diff --git a/skills/imozuru/scripts/digest.py b/skills/imozuru/scripts/digest.py
index eaebe60..7beeb02 100644
--- a/skills/imozuru/scripts/digest.py
+++ b/skills/imozuru/scripts/digest.py
@@ -34,11 +34,13 @@ import json
import os
import re
import sys
+import tempfile
from pathlib import Path
from urllib.parse import urlsplit
sys.path.insert(0, str(Path(__file__).resolve().parent))
import report # noqa: E402 照合と引用の描画は抜き書きと同じものを使う
+import skin # noqa: E402 見た目(コルク板と象牙の紙)は抜き書き・ダッシュボードと共通
QUERIES = "queries.jsonl"
FETCH_LOG = "fetch-log.jsonl"
@@ -163,8 +165,11 @@ esc = report.esc
def link(url: str, text: str) -> str:
"""http(s) だけをリンクにする。javascript: などはそのまま文字で出す。"""
- if urlsplit(url).scheme in ("http", "https"):
- return f'<a href="{esc(url)}" rel="noreferrer noopener">{esc(text or url)}</a>'
+ try:
+ if urlsplit(url).scheme in ("http", "https"):
+ return f'<a href="{esc(url)}" target="_blank" rel="noopener noreferrer">{esc(text or url)}</a>'
+ except ValueError:
+ pass
return esc(text or url)
@@ -201,7 +206,7 @@ def level_html(src: Path, key: str, name: str, lead: str, lv: dict) -> str:
body.append(f'<h4>{esc(a["claim"])}</h4>{sentences_html(src, a["sentences"])}')
if lv.get("quiz"):
# 自分で思い出してから答えを見る形にする。読み返すより、自分をテストするほうが定着する(Dunlosky ら 2013)
- body.append('<h3>理解の確認</h3><p class="note">答えを見る前に、自分の言葉で答えてみる。</p>')
+ body.append('<h3>理解の確認</h3>')
for q in lv["quiz"]:
body.append(f'<div class="quiz"><p class="q">{esc(q["q"])}</p><details class="ans"><summary>答えを見る</summary>'
+ sentences_html(src, q["answer"]) + "</details></div>")
@@ -216,7 +221,7 @@ def levels_html(src: Path, data: dict) -> str:
for i, (k, _, _) in enumerate(LEVELS))
tabs = "".join(f'<label for="t-{k}">{esc(n)}<small>{esc(lead)}</small></label>' for k, n, lead in LEVELS)
sections = "".join(level_html(src, k, n, lead, data["levels"][k]) for k, n, lead in LEVELS)
- return f'<div class="levels" id="explain">{inputs}<div class="tabs">{tabs}</div>{sections}</div>'
+ return f'<div class="levels sheet" id="explain">{inputs}<div class="tabs">{tabs}</div>{sections}</div>'
def overview_html(data: dict) -> str:
@@ -247,7 +252,10 @@ def sites_html(records: list[dict], fetched: dict[str, dict]) -> str:
sites: dict[str, list[int]] = {}
for r in records:
for h in r["hits"]:
- host = (urlsplit(h["url"]).hostname or "?").removeprefix("www.")
+ try:
+ host = (urlsplit(h["url"]).hostname or "?").removeprefix("www.")
+ except ValueError:
+ host = "?"
row = sites.setdefault(host, [0, 0, 0])
row[0] += 1
f, _ = hit_status(h, fetched)
@@ -275,15 +283,14 @@ def records_html(records: list[dict], fetched: dict[str, dict]) -> str:
linked = set()
total_hits = sum(len(r["hits"]) for r in records)
empty = sum(1 for r in records if not r["hits"])
- body = ['<section id="record"><h2>調査記録<span class="status">自動生成</span></h2>',
- f'<p class="note">検索 {len(records)}本・ヒット {total_hits}件・空振り {empty}本。'
- "ヒットは検索で挙がったものの全件で、〔保存〕は原文を保存できたもの。</p>",
+ body = ['<section class="sheet" id="record"><h2>調査記録<span class="status">自動生成</span></h2>',
+ f'<p class="note">検索 {len(records)}本・ヒット {total_hits}件・空振り {empty}本</p>',
sites_html(records, fetched),
"<h3>検索語別の全結果</h3>"]
for rnd in sorted({r["round"] for r in records}):
rs = [r for r in records if r["round"] == rnd]
n_hits = sum(len(r["hits"]) for r in rs)
- body.append(f"<details><summary>{rnd}周目(検索 {len(rs)}本・ヒット {n_hits}件)</summary>")
+ body.append(f"<details><summary>{esc(str(rnd))}周目(検索 {len(rs)}本・ヒット {n_hits}件)</summary>")
for r in rs:
body.append(f'<h4>「{esc(r["query"])}」<span class="meta">{esc(r["by"])}・{esc(r["method"])}</span></h4>')
if not r["hits"]:
@@ -305,8 +312,7 @@ def records_html(records: list[dict], fetched: dict[str, dict]) -> str:
body.append("</details>")
loose = [f for k, f in fetched.items() if k not in linked]
if loose:
- body.append("<h3>検索結果以外から取得した原文</h3>"
- '<p class="note">記事の中のリンクの追跡、別の URL での取り直し、ブラウザでの取得など。</p><ul class="hits">')
+ body.append('<h3>検索結果以外から取得した原文</h3><ul class="hits">')
for f in loose:
st = "保存" if f.get("status") == "OK" else "取得失敗"
detail = f.get("file", "") if f.get("status") == "OK" else f.get("reason", "")
@@ -332,7 +338,11 @@ ul.claims li{margin:.35rem 0;display:flex;gap:.5rem;align-items:baseline}
.st1{border-style:dotted}
.st2{border-style:dashed;color:var(--sub);border-color:var(--sub)}
.levels>input{position:absolute;opacity:0;pointer-events:none}
-.tabs{display:flex;gap:.4rem;margin:2.5rem 0 0;border-bottom:1px solid var(--line);flex-wrap:wrap}
+/* 3編のタブは同じ幅で1段に並べる。折り返すと、スマホで Lv3 だけが2段目に落ちた(2026-10-22 かしぇ) */
+.tabs{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:.4rem;margin:0;border-bottom:1px solid var(--line)}
+@media (max-width:600px){.tabs label{padding:.4rem .5rem .45rem;font-size:.92rem}.tabs label small{font-size:.62rem;line-height:1.35}}
+/* 紙の中の最初の見出し(要旨など)は、ピンと切り替えの札の下に少し間を取る */
+.lv>h3:first-of-type{margin-top:1.4rem}
.tabs label{cursor:pointer;padding:.45rem .9rem .5rem;border:1px solid var(--line);border-bottom:none;border-radius:8px 8px 0 0;color:var(--sub);font-weight:600}
.tabs label small{display:block;font-weight:400;font-size:.7rem}
.lv{display:none}
@@ -372,7 +382,12 @@ REMEMBER_JS = ("try{var k='imozuru-digest-lv',v=localStorage.getItem(k),e=v&&doc
def build(topic: Path, check_only: bool) -> int:
data = json.loads((topic / "digest.json").read_text(encoding="utf-8"))
- records = load_jsonl(topic / QUERIES)
+ # 壊れた記録を飛ばすと調査の全件と誤認させるので、理由を出して前のページを残す
+ try:
+ records = [normalize_record(r, None, None) for r in load_jsonl(topic / QUERIES)]
+ except ValueError as e:
+ print(f"{topic / QUERIES} を読めなかった: {e}", file=sys.stderr)
+ return 1
bad = check(topic, data)
if bad:
print("根拠の照合に通らない文がある(根拠が無いか、引用が原文と合わない):")
@@ -384,39 +399,36 @@ def build(topic: Path, check_only: bool) -> int:
src = topic / "sources"
fetched = fetch_status(load_jsonl(topic / FETCH_LOG))
+ # 冒頭・解説・人物と媒体・未解決の点・調査記録を、それぞれ1枚の紙にする
nav = ['<a href="#explain">解説</a>']
- body = [f"<h1>{esc(data['title'])}</h1>", overview_html(data),
- '<p class="note">解説の文を押すと、その文の根拠として原文からそのまま切り出した引用(機械で照合済み)が開く。'
- "解説はエージェントが書き、調査記録は機械で生成した。</p>"]
sections = [levels_html(src, data)]
if data.get("people_places"):
- sections.append('<section id="people"><h2>主な人物と媒体</h2>' + sentences_html(src, data["people_places"]) + "</section>")
+ sections.append('<section class="sheet" id="people"><h2>主な人物と媒体</h2>' + sentences_html(src, data["people_places"]) + "</section>")
nav.append('<a href="#people">人物と媒体</a>')
if data.get("unresolved"):
- sections.append('<section id="open"><h2>未解決の点</h2><ul>'
+ sections.append('<section class="sheet" id="open"><h2>未解決の点</h2><ul>'
+ "".join(f"<li>{esc(u)}</li>" for u in data["unresolved"]) + "</ul></section>")
nav.append('<a href="#open">未解決の点</a>')
sections.append(records_html(records, fetched))
nav.append('<a href="#record">調査記録</a>')
- body.append("<nav>" + "".join(nav) + "</nav>")
+ # 操作の案内は書かない(2026-10-21 かしぇ「長々と注釈や操作案内を書きたくない」)。調査記録が機械の生成であることは見出しの札が示す
+ body = ['<section class="sheet">', f"<h1>{esc(data['title'])}</h1>", overview_html(data),
+ "<nav>" + "".join(nav) + "</nav></section>"]
body += sections
body.append(f'<footer>imozuru の詳細レポート・原文はこのページと同じ場所の {esc(src.name)}/</footer>')
- # スクリプトは中身のハッシュで許可する。'unsafe-inline' にすると、原文から紛れ込んだ文字列も動きうる
- digest_b64 = base64.b64encode(hashlib.sha256(REMEMBER_JS.encode()).digest()).decode()
- page = f"""<!doctype html>
-<html lang="ja"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
-<meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline'; script-src 'sha256-{digest_b64}'">
-<title>{esc(data['title'])} 詳細レポート</title><style>{CSS}</style></head>
-<body><main>
-{chr(10).join(body)}
-</main><script>{REMEMBER_JS}</script></body></html>
-"""
+ # スクリプトは中身のハッシュで許可する(skin.page)。'unsafe-inline' にすると、原文から紛れ込んだ文字列も動きうる
+ page = skin.page(f"{data['title']} 詳細レポート", "\n".join(body),
+ extra_head=f"<style>{CSS}</style>", scripts=(REMEMBER_JS,))
out = topic / "digest.html"
- # 一時ファイルに書いてから置き換える。途中で止まっても前のページが壊れずに残る
- tmp = out.with_name(".digest.html.tmp")
- tmp.write_text(page, encoding="utf-8")
- os.replace(tmp, out)
+ # 同じ場所に排他的に作り、仕込まれたリンクを踏まず、途中で止まっても前のページを残す
+ fd, tmp = tempfile.mkstemp(prefix=".digest.html.", suffix=".tmp", dir=out.parent)
+ try:
+ with os.fdopen(fd, "w", encoding="utf-8") as f:
+ f.write(page)
+ os.replace(tmp, out)
+ finally:
+ Path(tmp).unlink(missing_ok=True)
print(f"→ {out}")
return 0
diff --git a/skills/imozuru/scripts/make_guide_shots.py b/skills/imozuru/scripts/make_guide_shots.py
new file mode 100644
index 0000000..666f382
--- /dev/null
+++ b/skills/imozuru/scripts/make_guide_shots.py
@@ -0,0 +1,179 @@
+#!/usr/bin/env python3
+"""説明の節(#guide)に載せる画面の図(assets/guide-*.webp)を描き出す。開発用の道具。
+
+画面の作りを変えたときだけ回す。ページを作るたびには要らない(dashboard.py は出来上がった絵を埋め込むだけ)。
+文字だけの説明では、ホーム・一覧・紙面がどこにあるかを思い浮かべにくい(2026-10-22 かしぇ「画像でわかるようにもするのいいかも」)。
+本物の調査を写すと、人に見せたくない題が絵に残るので、架空の調査を並べたモックを撮る。
+撮る前に、指したい部品の上に番号の印を重ねる。番号の意味は絵の下の文字に書く(絵の中に文を描くと、読み上げられず直しにくい)。
+
+使い方:
+ make_guide_shots.py … 絵を全部描き直す(README の assets/screenshots/dashboard.webp も)。playwright の webkit と Pillow が要る(~/.venvs/tools/bin/python で回す)
+"""
+
+import io
+import json
+import sys
+import tempfile
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import dashboard # noqa: E402
+import palette # noqa: E402
+import skin # noqa: E402
+
+# 架空の調査。題・問い・区切った理由・原文を取った場所だけを持つ
+MOCK = [
+ ("sunset-red", "夕焼けはなぜ赤いか", "夕方の空が赤く見えるのは、光のどんな性質によるのか", "論点6/6に原文", 2,
+ ["https://journals.example.org/a", "https://www.example.edu/b", "https://ja.example.org/c"]),
+ ("tea-ceremony", "茶の湯の作法の由来", "茶の湯の作法は、いつ誰が決めたのか", "1周目まで(論点3/5に原文)", 1,
+ ["https://archive.example.jp/a", "https://www.example.ac.jp/b"]),
+ ("bird-songs", "鳥のさえずりの方言", "同じ種の鳥でも、地域でさえずりが違うのはなぜか", "飽和した(挙がった14件中11件が既知)", 3,
+ ["https://journals.example.org/c", "https://www.example.edu/d"]),
+ ("bread-yeast", "天然酵母のパンの失敗", "天然酵母のパンが膨らまない原因は何か", "約束で打ち切り", 1, ["https://blog.example.net/a"]),
+ ("type-history", "明朝体の成り立ち", "明朝体の形は、どこから来たのか", "要の原典が有料で取れない", 2,
+ ["https://archive.example.jp/b", "https://www.example.ac.jp/c"]),
+ ("moss-garden", "苔庭の手入れ", "苔庭を枯らさずに保つには何をするか", "論点4/4に原文", 2, ["https://blog.example.net/b"]),
+ ("old-maps", "古地図の読み方", "江戸の古地図の記号は、何を表すのか", "4周たどって区切った", 4,
+ ["https://archive.example.jp/c", "https://ja.example.org/d"]),
+ ("glass-color", "ガラスの色の出し方", "色ガラスの色は、何を混ぜて出すのか", "論点5/5に原文", 2, ["https://www.example.edu/e"]),
+]
+# 一覧が2ページ以上になるよう、題だけの調査を足す(1ページに収まるとページ送りが出ず、図で指せない)
+MOCK += [(f"extra-{i}", title, f"{title}は、どう調べればよいか", reason, 1, ["https://blog.example.net/c"])
+ for i, (title, reason) in enumerate([
+ ("漆の乾き方", "論点3/3に原文"), ("和紙の漉き方", "1周目まで(論点2/4に原文)"), ("星座の名前の由来", "論点4/4に原文"),
+ ("染め物の色止め", "飽和した"), ("盆栽の針金かけ", "約束で打ち切り"), ("祭り囃子の拍子", "論点3/3に原文"),
+ ("手ぬぐいの柄", "1周目まで"), ("木版画の刷り方", "論点5/5に原文")])]
+CLAIMS = ["この分野の知見はどこに集まっているか", "定番の手法は何か", "どこで失敗するか", "その元になった研究はあるか"]
+
+PHONE = (390, 760)
+PHONE_TALL = (390, 1180) # 紙面は札が縦に3枚続くので、文書と論点の札まで入る高さで撮る
+PC = (1280, 760)
+PC_TALL = (1280, 1000)
+# 書き出す幅(px)。スマホの絵は紙の上で約170px に、PC の絵は約560px に縮めて出す。高精細の画面で2倍あれば足りる
+WIDTH = 400
+WIDTH_PC = 1120
+QUALITY = 72
+
+
+def build_mock(root: Path) -> list[dict]:
+ """架空の調査のフォルダと台帳を作り、dashboard.collect で読む"""
+ rows = ["| 日付 | 話題 | 型 | 回した人 | 調査を区切った理由 | 周 | 原文 | 感覚と合った? |", "|---|---|---|---|---|---|---|---|"]
+ for i, (slug, title, question, reason, rounds, urls) in enumerate(MOCK):
+ d = root / slug
+ (d / "sources").mkdir(parents=True)
+ for j in range(len(urls) * 3):
+ (d / "sources" / f"s{j}.md").write_text("x", encoding="utf-8")
+ table = "".join(f"| 資料{j} | s{j}.md | {u} | 1周 |\n" for j, u in enumerate(urls))
+ claims = "".join(f"- [{'x' if k < 3 else ' '}] {c}\n" for k, c in enumerate(CLAIMS))
+ (d / "map.md").write_text(f"# map: {slug}\n\n問い: {question}\n題: {title}\n\n## 調査の論点\n{claims}\n"
+ f"## 原文(sources/)\n| 資料 | ファイル | 元の URL | 周 |\n|---|---|---|---|\n{table}", encoding="utf-8")
+ date = f"2026-{10 - i // 28:02d}-{28 - i % 28:02d}"
+ (d / "log.md").write_text(f"# log\n\n## 0周目({date})\n\n" + "".join(f"## {r}周目\n\n" for r in range(1, rounds + 1)), encoding="utf-8")
+ # 検索と取得の記録(架空)。無いと紙面の「検索と取得」が「記録なし」になる
+ recs = [{"round": r, "by": "scout", "method": "WebSearch", "query": f"{title} {k}",
+ "hits": [{"title": f"資料{k}-{h}", "url": f"{urls[h % len(urls)]}/{r}{k}{h}"} for h in range(6)]}
+ for r in range(1, rounds + 1) for k in range(4)]
+ (d / "queries.jsonl").write_text("".join(json.dumps(x, ensure_ascii=False) + "\n" for x in recs), encoding="utf-8")
+ logs = [{"url": f"{u}/{j}", "status": "OK" if j % 4 else "FAIL", "file": f"s{j}.md", "reason": "404"}
+ for j, u in enumerate(urls * 4)]
+ (d / "fetch-log.jsonl").write_text("".join(json.dumps(x, ensure_ascii=False) + "\n" for x in logs), encoding="utf-8")
+ for name in ("digest.html", "report.html"):
+ (d / name).write_text(mock_doc(title, question), encoding="utf-8")
+ rows.append(f"| {date} | {slug} | 掘り | モネ | {reason} | {rounds} | {len(urls) * 3} | 「いいね」 |")
+ runs = root.parent / "runs.md"
+ runs.write_text("\n".join(rows) + "\n", encoding="utf-8")
+ return dashboard.collect(root, dashboard.load_runs(runs))
+
+
+def mock_doc(title: str, question: str) -> str:
+ """文書の代わりのページ。本物の詳細レポートと同じ紙の見た目で、冒頭だけを持つ"""
+ body = (f'<section class="sheet"><h1>{title}</h1><dl class="overview"><dt>調べたこと</dt><dd>{question}</dd>'
+ '<dt>調査を区切った理由</dt><dd>論点の全部に原文が付いた</dd></dl></section>'
+ '<section class="sheet"><h2>要旨</h2><p>ここに、原文の引用を根拠にした解説の文が並ぶ。</p>'
+ '<p>文を押すと、その文の根拠の引用が開く。</p></section>')
+ return skin.page(f"{title} 詳細レポート", body, extra_head=f"<style>{skin.CSS}</style>")
+
+
+# 指す部品の上に番号の印を重ねるスクリプト。印は部品を囲む枠と、枠の左上の丸い番号
+MARK_JS = """(marks) => { const c = '%s';
+for (const [sel, n] of marks) { const el = document.querySelector(sel); if (!el) throw new Error('no ' + sel);
+ const r = el.getBoundingClientRect(), box = document.createElement('div'), dot = document.createElement('div');
+ // 枠は画面の内側に収める。画面いっぱいの部品(文書の枠)を囲むと、右と下の辺が画面の外に出て見えなかった
+ const x0 = Math.max(2, r.left - 3), y0 = Math.max(2, r.top - 3);
+ const x1 = Math.min(innerWidth - 2, r.right + 3), y1 = Math.min(innerHeight - 2, r.bottom + 3);
+ box.style.cssText = `position:fixed;left:${x0}px;top:${y0}px;width:${x1 - x0}px;height:${y1 - y0}px;box-sizing:border-box;`
+ + `border:3px solid ${c};border-radius:10px;box-shadow:0 0 0 1.5px #fff;z-index:99999;pointer-events:none`;
+ dot.textContent = n;
+ dot.style.cssText = `position:fixed;left:${Math.max(2, r.left - 14)}px;top:${Math.max(2, r.top - 14)}px;width:30px;height:30px;`
+ + (/^[0-9]+$/.test(n) ? `background:${c};color:#fff;box-shadow:0 0 0 2px #fff;` : `background:#fff;color:${c};box-shadow:inset 0 0 0 2.5px ${c},0 0 0 2px #fff;`)
+ + `border-radius:50%%;font:700 18px/30px system-ui,sans-serif;text-align:center;`
+ + `z-index:100000`;
+ document.body.append(box, dot); } }""" % palette.SWATCH["beni"]
+
+
+def shoot(page, path: Path, marks: list[tuple[str, str]], clip: tuple[int, int, int, int] | None = None, width: int = 0) -> None:
+ """clip は切り抜く範囲(CSS の px で x・y・幅・高さ)。説明に要る所だけを残し、紙の上で読み流す長さを縮める。
+ width は書き出す幅(px)。0 なら切り抜いた幅の2倍(高精細の画面で縮めずに出せる大きさ)で、WIDTH_PC を上限にする"""
+ from PIL import Image
+ page.evaluate(MARK_JS, marks)
+ page.wait_for_timeout(150)
+ box = {"x": clip[0], "y": clip[1], "width": clip[2], "height": clip[3]} if clip else None
+ img = Image.open(io.BytesIO(page.screenshot(clip=box))).convert("RGB")
+ width = width or min(WIDTH_PC, (clip[2] if clip else page.viewport_size["width"]) * 2)
+ img = img.resize((width, round(img.height * width / img.width)), Image.LANCZOS)
+ img.save(path, "WEBP", quality=QUALITY, method=6)
+ print(f"→ {path}({path.stat().st_size / 1024:.0f} KB)")
+
+
+def main() -> int:
+ from playwright.sync_api import sync_playwright
+ with tempfile.TemporaryDirectory() as tmp:
+ root = Path(tmp) / "research"
+ root.mkdir()
+ topics = build_mock(root)
+ page_file = root / "index.html"
+ page_file.write_text(dashboard.render(topics, root), encoding="utf-8")
+ url = page_file.as_uri()
+ first = f"#t-{MOCK[0][0]}"
+ doc = f"#doc/{MOCK[0][0]}/digest.html"
+ side = 300 # パソコンのサイドバーの既定の幅(18rem)に、右端のつまみの分を足した幅
+ # 端末ごとに、各画面をどの状態で開き、どこを切り抜くか。指す部品と番号は dashboard.GUIDE_SCREENS の表だけが決める
+ plan = {
+ "sp": {"home": (PHONE, "", False, (0, 0, PHONE[0], 250)),
+ "side": (PHONE, "", True, (0, 0, PHONE[0], 290)),
+ "topic": (PHONE_TALL, first, False, (0, 225, PHONE[0], 675)),
+ "doc": (PHONE, doc, False, None)},
+ "pc": {"home": (PC, "", False, (side, 0, PC[0] - side, 520)),
+ "side": (PC, "", False, (0, 0, side, PC[1])),
+ "topic": (PC_TALL, first, False, (side, 0, PC[0] - side, 900)),
+ "doc": (PC, doc, False, None)},
+ }
+ with sync_playwright() as p:
+ browser = p.webkit.launch()
+ assets = dashboard.LOGO.parent
+ for dev, screens in plan.items():
+ for key, title, legend in dashboard.GUIDE_SCREENS:
+ size, hash_, open_side, clip = screens[key]
+ pg = browser.new_page(viewport={"width": size[0], "height": size[1]}, device_scale_factor=2)
+ pg.goto(url + hash_)
+ pg.wait_for_timeout(1400) # 書体と枠の中の文書の読み込み、出てくる動きの終わりを待つ
+ if open_side:
+ pg.click(".menu")
+ pg.wait_for_timeout(900)
+ marks = [(sel.format(dev=dev, t=first), n) for sel, n, _, _ in dashboard.screen_parts(legend, dev)]
+ shoot(pg, assets / f"guide-{dev}-{key}.webp", marks, clip, WIDTH if dev == "sp" else 0)
+ pg.close()
+ # README に載せる図。印を付けず、サイドバーとトピック詳細が並ぶパソコンの画面を1枚撮る(2026-10-22 かしぇ「図も載せよう」)。
+ # README はリポジトリの直下にあるので、図もスキルの外(assets/screenshots/)に置く。スキルを入れた人の手元には要らない
+ readme = dashboard.LOGO.parents[3] / "assets" / "screenshots" / "dashboard.webp"
+ readme.parent.mkdir(parents=True, exist_ok=True)
+ pg = browser.new_page(viewport={"width": PC[0], "height": PC[1]}, device_scale_factor=2)
+ pg.goto(url + first)
+ pg.wait_for_timeout(1400)
+ shoot(pg, readme, [], None, 1440)
+ browser.close()
+ return 0
+
+
+if __name__ == "__main__":
+ sys.exit(main())
diff --git a/skills/imozuru/scripts/make_textures.py b/skills/imozuru/scripts/make_textures.py
new file mode 100644
index 0000000..69c2329
--- /dev/null
+++ b/skills/imozuru/scripts/make_textures.py
@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+"""ダッシュボードの質感の絵(assets/cork.png・assets/paper.png)と、ホーム画面のアイコン(assets/apple-touch-icon.png)と
+タブの印(assets/favicon.png)を描き出す。開発用の道具。
+
+質感やロゴを変えたときだけ回す。ページを作るたびには要らない(dashboard.py は出来上がった PNG を使うだけ)。
+描くのにブラウザ(playwright の chromium)を使う。SVG のフィルタの描き方はブラウザに依存するので、毎回同じものでそろえる。
+
+使い方:
+ make_textures.py … 質感の絵(2倍の解像度・透過)とアイコンを全部描き直す
+"""
+
+import re
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import dashboard # noqa: E402
+import palette # noqa: E402
+
+ICON_SIZE = 180 # iPhone のホーム画面のアイコンの大きさ(px)。角の丸めは iPhone がかける
+# 紋の周りの余白。紋は丸いので、iPhone が角を丸めても欠けない。ロゴの SVG の中にも紋の外に約6%の余白がある
+# (0.14 では小さく見えた・2026-10-22 かしぇ「もうちょっとアイコンロゴ大きくていいかも」)
+ICON_PAD = 0.05
+# タブの印は 16px(高精細の画面で 32px)で出るので、その倍の 64px で描いて縮めてもらう。
+# 紋だけを透過の地に置くと明るいタブで字が消えた(象牙の線が白地に溶ける)ので、アイコンと同じ胡桃材の地に置く。
+# タブの印は角を丸めてもらえないので、自分で角を丸める(四角のままだと周りの印より重く見える)
+FAVICON = dashboard.LOGO.with_name("favicon.png")
+FAVICON_SIZE = 64
+FAVICON_PAD = 0.03
+FAVICON_RADIUS = 12
+
+
+def icon_html(size: int = ICON_SIZE, pad_ratio: float = ICON_PAD, radius: int = 0) -> str:
+ """ロゴの紋(左の丸い印)だけを、一覧と同じ胡桃材の地の正方形に置く。
+ ロゴの SVG は紋が左端の 1254 角に収まり、字はその右にあるので、viewBox を正方形に絞れば紋だけが残る。
+ ホーム画面のアイコンは地を透過にしない(iPhone は透過の所を黒で埋める)ので radius=0。角は iPhone が丸める"""
+ svg = dashboard.LOGO_LIGHT.read_text(encoding="utf-8")
+ side = re.search(r'viewBox="0 0 \d+(?:\.\d+)? (\d+(?:\.\d+)?)"', svg).group(1)
+ svg = re.sub(r'viewBox="[^"]*"', f'viewBox="0 0 {side} {side}"', svg, count=1)
+ pad = round(size * pad_ratio)
+ return (f'<style>html,body{{margin:0;background:transparent}}'
+ f'div{{width:{size}px;height:{size}px;border-radius:{radius}px;background:{palette.SWATCH[palette.DASH["side-bg"]]}}}'
+ f'svg{{display:block;width:{size - 2 * pad}px;height:{size - 2 * pad}px;padding:{pad}px}}</style><div>{svg}</div>')
+
+
+def main() -> int:
+ from playwright.sync_api import sync_playwright
+ with sync_playwright() as p:
+ browser = p.chromium.launch()
+ for name, (png, svg, size) in dashboard.TEXTURES.items():
+ page = browser.new_page(viewport={"width": size, "height": size}, device_scale_factor=2)
+ page.set_content(f"<style>html,body{{margin:0;background:transparent}}</style>{svg()}")
+ page.screenshot(path=str(png), omit_background=True, clip={"x": 0, "y": 0, "width": size, "height": size})
+ print(f"→ {png}({png.stat().st_size / 1024:.0f} KB)")
+ for png, size, html_ in ((dashboard.ICON, ICON_SIZE, icon_html()),
+ (FAVICON, FAVICON_SIZE, icon_html(FAVICON_SIZE, FAVICON_PAD, FAVICON_RADIUS))):
+ page = browser.new_page(viewport={"width": size, "height": size})
+ page.set_content(html_)
+ page.screenshot(path=str(png), omit_background=True, clip={"x": 0, "y": 0, "width": size, "height": size})
+ print(f"→ {png}({png.stat().st_size / 1024:.1f} KB)")
+ browser.close()
+ return 0
+
+
+if __name__ == "__main__":
+ sys.exit(main())
diff --git a/skills/imozuru/scripts/palette.py b/skills/imozuru/scripts/palette.py
new file mode 100644
index 0000000..252f8e2
--- /dev/null
+++ b/skills/imozuru/scripts/palette.py
@@ -0,0 +1,97 @@
+"""imozuru が書き出すページ(履歴ダッシュボード・抜書き・詳細レポート・戻るボタン)の色の唯一の置き場。
+
+色はすべて OKLCH で、ここの色見本(SWATCH)から役割の名前へ割り当てる。ページの側は役割の名前
+(CSS の変数)だけを使い、色の値を直接書かない。透かしは color-mix で役割の色から作る。
+tests/test_palette.py が、書き出したページの中の oklch() がすべてここの値かを確認する。
+
+外観は「昆虫の標本箱」(2026-10-21 かしぇが3つの棚の見本から A を選んだ)。胡桃材の濃い地に象牙の面、
+標本の色を点で入れる。文書(抜書き・詳細レポート)は象牙の紙を地にし、暗い設定では胡桃材の地にする。
+"""
+
+SWATCH = {
+ # 胡桃材。暗い地の段。数字が小さいほど暗い
+ "walnut-1": "oklch(0.15 0.022 50)",
+ "walnut-2": "oklch(0.21 0.03 50)",
+ "walnut-3": "oklch(0.25 0.032 53)",
+ "walnut-4": "oklch(0.27 0.035 55)",
+ "walnut-5": "oklch(0.32 0.035 58)",
+ "walnut-6": "oklch(0.34 0.045 62)",
+ "walnut-7": "oklch(0.36 0.035 60)",
+ "walnut-8": "oklch(0.42 0.04 60)",
+ # 象牙。明るい地と、暗い地の上の文字
+ "ivory-1": "oklch(0.98 0.015 88)",
+ "ivory-2": "oklch(0.94 0.025 85)",
+ "ivory-3": "oklch(0.93 0.02 85)",
+ "ivory-4": "oklch(0.89 0.06 85)",
+ "ivory-5": "oklch(0.82 0.03 80)",
+ "ivory-6": "oklch(0.76 0.03 80)",
+ # 墨。象牙の地の上の文字
+ "sumi-1": "oklch(0.25 0.04 58)",
+ "sumi-2": "oklch(0.3 0.03 55)",
+ "sumi-3": "oklch(0.44 0.03 60)",
+ # 琥珀。文書の差し色
+ "amber-dark": "oklch(0.47 0.1 65)",
+ "amber-light": "oklch(0.77 0.11 74)",
+ "amber-hit": "oklch(0.35 0.045 70)",
+ # コルク。本体の地(2026-10-22 かしぇが「コルク板+象牙の台紙」を選んだ)。象牙の文字 6.98・台紙との差 7.2
+ "cork": "oklch(0.42 0.055 62)",
+ # 真鍮。標本箱の金具(一覧の幅を変えるつまみ)
+ "brass": "oklch(0.7 0.09 82)",
+ "brass-dark": "oklch(0.42 0.06 70)",
+ # 影と光沢。透かして使う
+ "umbra": "oklch(0.08 0.02 50)",
+ "glass": "oklch(1 0 0)",
+ # 紅芋の紅紫(ブランドの色)。説明の図で画面の部品を指す番号の印だけに使う。胡桃材の暗い地にも象牙の紙にも埋もれない明るさ
+ "beni": "oklch(0.56 0.19 350)",
+}
+
+# 履歴ダッシュボード(胡桃材の地・詳細は象牙の札)
+DASH = {
+ "paper": "walnut-4", "paper2": "walnut-2", "card": "walnut-5", "card2": "walnut-7", "line": "walnut-8",
+ "lamp": "walnut-6", "side-bg": "walnut-1", "ink": "ivory-3", "sub": "ivory-6",
+ "ivory": "ivory-2", "ivory-ink": "sumi-2", "ivory-sub": "sumi-3", "ivory-line": "ivory-5",
+ "umbra": "umbra", "glass": "glass", "cork": "cork", "brass": "brass", "brass-dark": "brass-dark", "beni": "beni",
+}
+
+# 抜書きと詳細レポート。明るい設定は象牙の紙、暗い設定は胡桃材
+DOC_LIGHT = {"bg": "ivory-2", "ink": "sumi-1", "sub": "sumi-3", "accent": "amber-dark",
+ "card": "ivory-1", "line": "ivory-5", "hit": "ivory-4"}
+DOC_DARK = {"bg": "walnut-2", "ink": "ivory-3", "sub": "ivory-6", "accent": "amber-light",
+ "card": "walnut-3", "line": "walnut-7", "hit": "amber-hit"}
+
+# 文書に重ねる戻るボタン。地の明暗の反対側を当てる
+HUD_LIGHT = {"hud-bg": "walnut-4", "hud-fg": "ivory-2", "hud-umbra": "umbra"}
+HUD_DARK = {"hud-bg": "ivory-2", "hud-fg": "walnut-4", "hud-umbra": "umbra"}
+
+# 標本の4色(終了理由の分類)と棒・原文の色。dataviz の validate_palette.js を暗い面 walnut-5 の上で
+# 全組み合わせ通した(色覚の差は注意の範囲=文字ラベルを必ず添える)。
+# p- の付く色は象牙の台紙(ivory-2)の上に置く棒と点。暗い面の色のままだと緑の対比が 2.45 で、3 に届かなかった。
+# 台紙の上で validate_palette.js --pairs all を全部通した組(2026-10-22)
+# 案1・案2 はキーカラーとキーフォントだけを変えた見比べ用。決まったら1つにする
+THEMES = {
+ "1": {"bar": "oklch(0.62 0.13 75)", "src": "oklch(0.66 0.15 150)",
+ "r1": "oklch(0.62 0.14 245)", "r2": "oklch(0.66 0.15 150)", "r3": "oklch(0.62 0.13 75)", "r4": "oklch(0.56 0.17 345)",
+ "p-r1": "oklch(0.52 0.14 245)", "p-r2": "oklch(0.47 0.13 150)", "p-r3": "oklch(0.61 0.13 75)", "p-r4": "oklch(0.52 0.17 345)",
+ "p-bar": "oklch(0.61 0.13 75)", "p-src": "oklch(0.47 0.13 150)",
+ "head": '"Shippori Mincho"', "font": "Shippori+Mincho:wght@500;700"},
+ "2": {"bar": "oklch(0.66 0.13 85)", "src": "oklch(0.6 0.15 350)",
+ "r1": "oklch(0.6 0.13 250)", "r2": "oklch(0.64 0.13 160)", "r3": "oklch(0.66 0.13 85)", "r4": "oklch(0.6 0.15 350)",
+ "p-r1": "oklch(0.48 0.13 250)", "p-r2": "oklch(0.5 0.13 160)", "p-r3": "oklch(0.62 0.13 85)", "p-r4": "oklch(0.56 0.15 350)",
+ "p-bar": "oklch(0.62 0.13 85)", "p-src": "oklch(0.56 0.15 350)",
+ "head": '"Zen Old Mincho"', "font": "Zen+Old+Mincho:wght@500;700"},
+}
+
+
+def css_vars(roles: dict) -> str:
+ """役割の表を CSS の変数の並び(--名前:値;…)にする"""
+ return "".join(f"--{k}:{SWATCH[v]};" for k, v in roles.items())
+
+
+def mix(role: str, percent: int) -> str:
+ """役割の色を透かす。値を直接書かずに、変数から作る"""
+ return f"color-mix(in oklch,var(--{role}) {percent}%,transparent)"
+
+
+def all_values() -> set[str]:
+ """ページに出てよい oklch() の値の全部"""
+ return set(SWATCH.values()) | {v for t in THEMES.values() for k, v in t.items() if v.startswith("oklch(")}
diff --git a/skills/imozuru/scripts/report.py b/skills/imozuru/scripts/report.py
index a583a12..c6ec5bc 100644
--- a/skills/imozuru/scripts/report.py
+++ b/skills/imozuru/scripts/report.py
@@ -26,8 +26,12 @@ import json
import os
import re
import sys
+import tempfile
from pathlib import Path, PureWindowsPath
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import skin # noqa: E402 見た目(コルク板と象牙の紙)と色は skin.py・palette.py の1か所に置く
+
# 2026-10-21 まで使っていた状態の言葉。前に書いた extracts.json も読めるよう、新しい言葉に読み替える
OLD_STATUS = {"付いた": "根拠あり", "一部だけ": "一部のみ", "付かなかった": "根拠なし"}
@@ -100,7 +104,7 @@ def quote_html(src_dir: Path, q: dict, ctx: list[str], c0: int) -> str:
parts = ['<figure class="quote">']
if q.get("who"):
parts.append(f'<div class="who">{esc(q["who"])}</div>')
- parts.append(f'<blockquote>{esc(q["text"])}</blockquote>')
+ parts.append(f'<blockquote{skin.lang_attr(q["text"])}>{esc(q["text"])}</blockquote>')
if q.get("ja"):
parts.append(f'<p class="ja"><span class="tag">訳</span>{esc(q["ja"])}</p>')
meta = [f'<code>{esc(loc)}</code>']
@@ -109,19 +113,15 @@ def quote_html(src_dir: Path, q: dict, ctx: list[str], c0: int) -> str:
if q.get("context_note"):
meta.append(f'<span class="cn">{esc(q["context_note"])}</span>')
parts.append(f'<figcaption>{" ".join(meta)}</figcaption>')
- parts.append(f'<details><summary>前後を読む({c0}〜{c0 + len(ctx) - 1}行)</summary><pre>{ctx_html}</pre></details>')
+ parts.append(f'<details><summary>前後を読む({c0}〜{c0 + len(ctx) - 1}行)</summary><pre{skin.lang_attr(" ".join(ctx))}>{ctx_html}</pre></details>')
parts.append("</figure>")
return "\n".join(parts)
-CSS = """
-:root{--bg:#f6efd3;--ink:#2e1703;--sub:#6b4a26;--accent:#814e0d;--card:#fbf7e8;--line:#e2cf9f;--hit:#efdcab}
-@media (prefers-color-scheme:dark){:root:not([data-theme=light]){--bg:#1f1710;--ink:#f1e6cc;--sub:#c9b28a;--accent:#e0a85a;--card:#2a2016;--line:#4a3a26;--hit:#4a3820}}
-*{box-sizing:border-box}
-body{margin:0;background:var(--bg);color:var(--ink);font-family:"Noto Sans JP","Hiragino Sans","Yu Gothic UI",sans-serif;line-height:1.85;font-size:16px}
-main{max-width:46rem;margin:0 auto;padding:2.5rem 1rem 5rem}
-h1{font-size:1.6rem;margin:0 0 .5rem;letter-spacing:.02em}
-h2{font-size:1.2rem;margin:3rem 0 .4rem;padding-top:1rem;border-top:1px solid var(--line)}
+# 地と紙と書体は skin.CSS。ここは抜き書きに固有の部品だけ。論点ごとに1枚の紙(.sheet)に載せる
+CSS = skin.CSS + """
+h1{font-size:1.6rem;margin:0 0 .5rem}
+h2{font-size:1.2rem;margin:0 0 .4rem}
.lead{color:var(--sub);margin:.2rem 0}
.status{display:inline-block;font-size:.8rem;padding:.05rem .55rem;border-radius:99px;border:1px solid var(--accent);color:var(--accent);margin-left:.5rem;vertical-align:middle}
.status.none{border-style:dashed;color:var(--sub);border-color:var(--sub)}
@@ -141,7 +141,7 @@ pre span{display:block}
pre span.hit{background:var(--hit)}
pre b{display:inline-block;min-width:3em;color:var(--sub);font-weight:400}
ul.unreached li{margin:.2rem 0}
-footer{margin-top:4rem;font-size:.8rem;color:var(--sub)}
+footer{margin-top:2rem;font-size:.8rem}
"""
@@ -171,43 +171,43 @@ def main() -> int:
if check_only:
return 0
- body = [f"<h1>{esc(data['title'])}</h1>",
+ # 冒頭と、論点ごとに1枚ずつの紙にする
+ body = ['<section class="sheet">', f"<h1>{esc(data['title'])}</h1>",
f'<p class="lead">調べたこと: {esc(data["question"])}</p>',
f'<p class="lead">調査を区切った理由: {esc(data["stopped"])}</p>',
- '<p class="note">ここに並ぶ引用は、すべて原文をそのまま切り出したもの(機械で照合済み)。エージェントが書いたのは見出し・状態・注記・「訳」だけ。要約はしていない。</p>']
+ "</section>"]
for c in data["claims"]:
status = OLD_STATUS.get(c["status"], c["status"])
cls = "status none" if status == "根拠なし" else "status"
- body.append(f'<h2>{esc(c["claim"])}<span class="{cls}">{esc(status)}</span></h2>')
+ body.append(f'<section class="sheet"><h2>{esc(c["claim"])}<span class="{cls}">{esc(status)}</span></h2>')
if c.get("note"):
body.append(f'<p class="note">{esc(c["note"])}</p>')
for q in c.get("quotes", []):
ctx, c0 = rendered[id(q)]
body.append(quote_html(src, q, ctx, c0))
+ body.append("</section>")
for d in data.get("disagreements", []):
- body.append(f'<h2>食い違い: {esc(d["topic"])}</h2><p class="note">どれが正しいかは書かない。並べるだけ。</p>')
+ body.append(f'<section class="sheet"><h2>食い違い: {esc(d["topic"])}</h2>')
for q in d.get("quotes", []):
ctx, c0 = rendered[id(q)]
body.append(quote_html(src, q, ctx, c0))
+ body.append("</section>")
if data.get("unreached"):
- body.append("<h2>届かなかったもの</h2><ul class=\"unreached\">"
- + "".join(f"<li>{esc(u)}</li>" for u in data["unreached"]) + "</ul>")
+ body.append('<section class="sheet"><h2>届かなかったもの</h2><ul class="unreached">'
+ + "".join(f"<li>{esc(u)}</li>" for u in data["unreached"]) + "</ul></section>")
# 絶対パスはページを人に渡すと手元のユーザー名を漏らすので、ページからの相対で書く
body.append(f'<footer>imozuru の抜き書き・原文はこのページと同じ場所の {esc(src.name)}/</footer>')
- page = f"""<!doctype html>
-<html lang="ja"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
-<meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline'">
-<title>{esc(data['title'])} 抜き書き</title><style>{CSS}</style></head>
-<body><main>
-{chr(10).join(body)}
-</main></body></html>
-"""
+ page = skin.page(f"{data['title']} 抜き書き", "\n".join(body), extra_head=f"<style>{CSS}</style>")
out = topic / "report.html"
- # 一時ファイルに書いてから置き換える。途中で止まっても前のページが壊れずに残る
- tmp = out.with_name(".report.html.tmp")
- tmp.write_text(page, encoding="utf-8")
- os.replace(tmp, out)
+ # 同じ場所に排他的に作り、仕込まれたリンクを踏まず、途中で止まっても前のページを残す
+ fd, tmp = tempfile.mkstemp(prefix=".report.html.", suffix=".tmp", dir=out.parent)
+ try:
+ with os.fdopen(fd, "w", encoding="utf-8") as f:
+ f.write(page)
+ os.replace(tmp, out)
+ finally:
+ Path(tmp).unlink(missing_ok=True)
print(f"→ {out}")
return 0
diff --git a/skills/imozuru/scripts/skin.py b/skills/imozuru/scripts/skin.py
new file mode 100644
index 0000000..dc31d88
--- /dev/null
+++ b/skills/imozuru/scripts/skin.py
@@ -0,0 +1,306 @@
+"""imozuru が書き出す文書(抜き書き・詳細レポート・map.md と log.md の表示)の共通の見た目。
+
+履歴ダッシュボードに合わせて、コルク板の地に象牙の紙をピンで留め、その上に中身を載せる
+(2026-10-22 かしぇ「抜き書きと詳細レポートのフォーマットも ダッシュボード側のデザインに合わせたい」)。
+紙は1つの話題ごとに1枚(.sheet)。色は palette.py の値だけを使い、質感は assets/ の PNG を埋め込む。
+md の表示(md_html)は、map.md・log.md を文字のまま見せていたのを、見出し・箇条書き・表などに組む
+(同日かしぇ「mdはちゃんとプレビューするようにしたい」)。
+"""
+
+import base64
+import html
+import re
+from pathlib import Path
+from urllib.parse import urlsplit
+
+import palette
+
+ASSETS = Path(__file__).resolve().parent.parent / "assets"
+HEAD_FONT = '"Shippori Mincho"'
+
+# Google Fonts を読むので、文書の CSP はこの2つの宛先と、質感の data: 画像を許す
+FONT_LINK = ('<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=EB+Garamond:wght@400;500'
+ '&family=Noto+Serif+JP:wght@400;600&family=Shippori+Mincho:wght@500;700&display=swap">')
+CSP_FONTS = "style-src 'unsafe-inline' https://fonts.googleapis.com; font-src https://fonts.gstatic.com; img-src data:"
+
+
+def texture(name: str) -> str:
+ """質感の PNG(make_textures.py が作る)を CSS の url() にする。無ければ平らな色のまま(none)"""
+ png = ASSETS / f"{name}.png"
+ if not png.is_file():
+ return "none"
+ return 'url("data:image/png;base64,' + base64.b64encode(png.read_bytes()).decode() + '")'
+
+
+def _head_meta() -> str:
+ """どのページの head にも置く指定。ダッシュボードと文書の両方が使う。
+ タブの印(favicon.png・make_textures.py が作る)は data: で埋め込む。束を file:// で開いても、
+ 窓口の合言葉が要るページでも、別のファイルを取りに行かずに出る。
+ format-detection は、iPhone の Safari が日付や件数の数字の並びを電話番号のリンクに変えるのを止める"""
+ meta = '<meta name="format-detection" content="telephone=no">'
+ png = ASSETS / "favicon.png"
+ if png.is_file():
+ meta += '<link rel="icon" type="image/png" href="data:image/png;base64,' + base64.b64encode(png.read_bytes()).decode() + '">'
+ return meta
+
+
+HEAD_META = _head_meta()
+
+
+def lang_attr(text: str) -> str:
+ """原文の引用に付ける言語の名乗り。ページは lang="ja" なので、名乗らない英文は日本語の書体の選び方と
+ 日本語の読み上げで扱われる。仮名も漢字も無くラテン文字のある文だけを en と名乗る。原文はほぼ英語か日本語で、
+ ほかの言語を見分ける判定は持たない(フランス語の原文も en と名乗る)"""
+ if re.search(r"[぀-ヿ㐀-鿿]", text) or not re.search(r"[A-Za-z]", text):
+ return ""
+ return ' lang="en"'
+
+
+# 紙の上の役割は文書の明るい組(DOC_LIGHT)。コルクの上に直接置く字(ページの末尾)は on-cork
+SKIN_VARS = (palette.css_vars(palette.DOC_LIGHT)
+ + palette.css_vars({"cork": "cork", "umbra": "umbra", "glass": "glass", "brass": "brass",
+ "pin-dark": "walnut-2", "on-cork": "ivory-5"}))
+
+CSS = """
+:root{@@VARS@@--head:@@HEAD@@,"Hiragino Mincho ProN","Yu Mincho",serif;--serif:"Noto Serif JP","Hiragino Mincho ProN","Yu Mincho",serif;color-scheme:light}
+*{box-sizing:border-box}
+html{background:var(--cork)}
+body{margin:0;background-color:var(--cork);background-image:@@CORK@@;background-size:240px 240px;color:var(--ink);
+font-family:var(--serif);line-height:1.85;font-size:16px}
+main{max-width:48rem;margin:0 auto;padding:2.4rem max(14px,env(safe-area-inset-right,0px)) 6rem max(14px,env(safe-area-inset-left,0px))}
+h1,h2,h3,h4{font-family:var(--head);font-weight:700;letter-spacing:.03em}
+/* 1枚の紙。ダッシュボードの札と同じく、板に貼り付いた紙として縁の細い影だけを落とし、上の真ん中を真鍮のピンで留める。
+ 下の両角だけ少し反った影を付ける */
+.sheet{position:relative;background-color:var(--bg);background-image:@@PAPER@@;color:var(--ink);border-radius:3px;
+padding:2.4rem 2rem 1.6rem;margin:0 0 2.2rem;
+box-shadow:0 1px 0 color-mix(in oklch,var(--glass) 50%,transparent) inset,0 0 0 1px color-mix(in oklch,var(--umbra) 16%,transparent),0 1px 2px color-mix(in oklch,var(--umbra) 45%,transparent)}
+.sheet::before{content:"";position:absolute;top:8px;left:50%;width:16px;height:16px;margin-left:-8px;border-radius:50%;z-index:1;
+background:radial-gradient(circle at 35% 30%,color-mix(in oklch,var(--glass) 80%,transparent),var(--brass) 45%,var(--pin-dark) 100%);
+box-shadow:1px 2px 2px color-mix(in oklch,var(--umbra) 55%,transparent)}
+.sheet::after{content:"";position:absolute;left:3px;right:3px;top:100%;height:9px;pointer-events:none;
+background:radial-gradient(farthest-side at 0 0,color-mix(in oklch,var(--umbra) 50%,transparent),transparent) left top/44px 9px no-repeat,
+radial-gradient(farthest-side at 100% 0,color-mix(in oklch,var(--umbra) 50%,transparent),transparent) right top/44px 9px no-repeat}
+.sheet>:first-child{margin-top:0}
+footer{color:var(--on-cork)}
+@media (max-width:600px){.sheet{padding:2.1rem 1.1rem 1.2rem}main{padding-top:1.6rem}}
+/* 折りたたみの三角は自前で描き、開閉に合わせて回す(ダッシュボードと同じ)。閉じる動きの間(.closing)は閉じた向きへ戻す。
+ 解説の1文(details.s)は文そのものを押す行なので三角を付けない */
+details:not(.s)>summary{list-style:none;cursor:pointer}
+details:not(.s)>summary::-webkit-details-marker{display:none}
+details:not(.s)>summary::before{content:"";display:inline-block;width:0;height:0;margin-right:.5em;vertical-align:.08em;border-style:solid;
+border-width:.32em 0 .32em .5em;border-color:transparent transparent transparent currentColor;transition:transform .25s cubic-bezier(.2,.8,.2,1)}
+details[open]:not(.closing)>summary::before{transform:rotate(90deg)}
+@media (prefers-reduced-motion:reduce){details>summary::before{transition:none}}
+/* md の表示 */
+.md h1{font-size:1.45rem;margin:0 0 .6rem}
+.md h2{font-size:1.15rem;margin:2rem 0 .4rem;padding-bottom:.25rem;border-bottom:1px solid var(--line)}
+.md h3{font-size:1.02rem;margin:1.6rem 0 .3rem}.md h4{font-size:.95rem;margin:1.2rem 0 .2rem}
+.md p{margin:.5rem 0}.md ul,.md ol{padding-left:1.3rem;margin:.4rem 0}.md li{margin:.15rem 0;overflow-wrap:anywhere}
+.md li.task{list-style:none;margin-left:-1.3rem}
+.md .box{display:inline-block;width:1.05em;height:1.05em;margin-right:.45em;vertical-align:-.15em;border:1px solid var(--sub);border-radius:3px;text-align:center;line-height:1;font-size:.85em}
+.md .box.on{background:var(--accent);border-color:var(--accent);color:var(--card)}
+.md a{color:var(--accent);overflow-wrap:anywhere}
+.md code{font-family:ui-monospace,"Cascadia Code",monospace;font-size:.82em;background:color-mix(in oklch,var(--line) 45%,transparent);padding:0 .25em;border-radius:3px}
+.md pre{background:var(--card);border:1px solid var(--line);border-radius:6px;padding:.7rem .9rem;overflow:auto;font-size:.8rem;line-height:1.6;max-height:none}
+.md pre code{background:none;padding:0}
+.md blockquote{margin:.6rem 0;padding-left:.9rem;border-left:3px solid var(--accent);color:var(--sub)}
+.md hr{border:0;border-top:1px solid var(--line);margin:1.5rem 0}
+.md .tablewrap{overflow-x:auto;margin:.6rem 0}
+.md table{border-collapse:collapse;font-size:.85rem;min-width:100%}
+.md th,.md td{border-bottom:1px solid var(--line);padding:.3rem .5rem;text-align:left;vertical-align:top;overflow-wrap:anywhere}
+.md th{font-weight:600;color:var(--sub);white-space:nowrap}
+"""
+CSS = (CSS.replace("@@VARS@@", SKIN_VARS).replace("@@HEAD@@", HEAD_FONT)
+ .replace("@@CORK@@", texture("cork")).replace("@@PAPER@@", texture("paper")))
+
+
+# --- md を HTML に組む -------------------------------------------------------
+# 中身は他人が書いた文(調べた先の題名・URL を含む)として扱う。先に全部エスケープしてから印を付け、
+# リンクは http(s) だけにする。対応するのは imozuru の map.md・log.md が使う形だけ
+# (見出し・段落・箇条書き・番号つき・チェックボックス・表・コードの囲み・引用・区切り線・太字・コード・リンク)
+
+URL_RE = re.compile(r"https?://[^\s<>\"')」]+")
+
+
+def _safe_url(u: str) -> str | None:
+ try:
+ return u if urlsplit(html.unescape(u)).scheme in ("http", "https") else None
+ except ValueError:
+ return None
+
+
+def inline(text: str) -> str:
+ """1行の中の印。text はまだエスケープしていない文"""
+ out, codes = html.escape(text, quote=True), []
+
+ def keep(m):
+ codes.append(f"<code>{m.group(1)}</code>")
+ return f"\x00{len(codes) - 1}\x00"
+ out = re.sub(r"`([^`]+)`", keep, out)
+
+ def mdlink(m):
+ url = _safe_url(m.group(2))
+ return f'<a href="{url}" target="_blank" rel="noopener noreferrer">{m.group(1)}</a>' if url else m.group(0)
+ out = re.sub(r"\[([^\]]+)\]\(([^)\s]+)\)", mdlink, out)
+ # 囲みの無い URL もリンクにする。すでに <a> の中にあるものは触らない
+ parts = re.split(r"(<a [^>]*>.*?</a>)", out)
+ out = "".join(p if p.startswith("<a ") else URL_RE.sub(
+ lambda m: (f'<a href="{m.group(0)}" target="_blank" rel="noopener noreferrer">{m.group(0)}</a>'
+ if _safe_url(m.group(0)) else m.group(0)), p) for p in parts)
+ out = re.sub(r"\*\*([^*]+)\*\*", r"<strong>\1</strong>", out)
+ return re.sub(r"\x00(\d+)\x00", lambda m: codes[int(m.group(1))], out)
+
+
+def _table(rows: list[str]) -> str:
+ cells = [[c.strip() for c in r.strip().strip("|").split("|")] for r in rows]
+ head, body = cells[0], [c for c in cells[1:] if not all(set(x) <= set("-: ") for x in c)]
+ return ('<div class="tablewrap"><table><thead><tr>' + "".join(f"<th>{inline(c)}</th>" for c in head)
+ + "</tr></thead><tbody>" + "".join("<tr>" + "".join(f"<td>{inline(c)}</td>" for c in r) + "</tr>" for r in body)
+ + "</tbody></table></div>")
+
+
+def _item(text: str) -> str:
+ """箇条書きの1項目。「[x]」「[ ]」「[~]」で始まる項目はチェックの印を付ける"""
+ t = re.match(r"\[([ xX~])\]\s*(.*)", text)
+ if not t:
+ return f"<li>{inline(text)}"
+ on = t.group(1) in "xX"
+ mark = "✓" if on else ("〜" if t.group(1) == "~" else "")
+ return f'<li class="task"><span class="box{" on" if on else ""}">{mark}</span>{inline(t.group(2))}'
+
+
+def _list(items: list, k: int, base: int) -> tuple[str, int]:
+ """items[k] から、字下げが base 以上の項目を1つの箇条書きに組む。より深い項目は直前の項目の中へ入れる"""
+ tag, parts = items[k][1], []
+ while k < len(items) and items[k][0] >= base:
+ li = _item(items[k][2])
+ k += 1
+ if k < len(items) and items[k][0] > base:
+ sub, k = _list(items, k, items[k][0])
+ li += sub
+ parts.append(li + "</li>")
+ return f"<{tag}>" + "".join(parts) + f"</{tag}>", k
+
+
+def md_html(text: str) -> str:
+ text = text.replace("\x00", "") # コードを戻す内部の目印を、入力から偽装させない
+ lines, out, i = text.splitlines(), [], 0
+ para: list[str] = []
+
+ def flush():
+ if para:
+ out.append("<p>" + "<br>".join(inline(p) for p in para) + "</p>")
+ para.clear()
+ while i < len(lines):
+ line = lines[i]
+ s = line.strip()
+ if s.startswith("```"):
+ flush()
+ j = i + 1
+ while j < len(lines) and not lines[j].strip().startswith("```"):
+ j += 1
+ out.append("<pre><code>" + html.escape("\n".join(lines[i + 1:j])) + "</code></pre>")
+ i = j + 1
+ continue
+ if not s:
+ flush()
+ i += 1
+ continue
+ m = re.match(r"(#{1,6})\s+(.*)", s)
+ if m:
+ flush()
+ n = min(len(m.group(1)), 4)
+ out.append(f"<h{n}>{inline(m.group(2))}</h{n}>")
+ i += 1
+ continue
+ if re.fullmatch(r"(-{3,}|\*{3,}|_{3,})", s):
+ flush()
+ out.append("<hr>")
+ i += 1
+ continue
+ if s.startswith("|"):
+ flush()
+ j = i
+ while j < len(lines) and lines[j].strip().startswith("|"):
+ j += 1
+ out.append(_table(lines[i:j]))
+ i = j
+ continue
+ if s.startswith(">"):
+ flush()
+ j, quote = i, []
+ while j < len(lines) and lines[j].strip().startswith(">"):
+ quote.append(lines[j].strip()[1:].strip())
+ j += 1
+ out.append("<blockquote>" + "<br>".join(inline(q) for q in quote) + "</blockquote>")
+ i = j
+ continue
+ m = re.match(r"\s*([-*+]|\d+[.)])\s+(.*)", line)
+ if m:
+ flush()
+ # 項目は(字下げの幅・ol か ul・本文)で集め、字下げが深い項目は直前の項目の中の入れ子の箇条書きにする
+ # (CHANGELOG の「追加」の下の細目が、平らに並んで親子が見えなかった・2026-10-22)
+ items, j = [], i
+ while j < len(lines):
+ mm = re.match(r"(\s*)([-*+]|\d+[.)])\s+(.*)", lines[j])
+ if mm:
+ items.append([len(mm.group(1).expandtabs(4)), "ol" if mm.group(2)[0].isdigit() else "ul", mm.group(3)])
+ elif lines[j].strip() and lines[j].startswith((" ", "\t")) and items:
+ items[-1][2] += " " + lines[j].strip() # 続きの行は同じ項目に足す
+ else:
+ break
+ j += 1
+ out.append(_list(items, 0, items[0][0])[0])
+ i = j
+ continue
+ para.append(s)
+ i += 1
+ flush()
+ return "\n".join(out)
+
+
+# 折りたたみ(details)の開閉を、高さの動きでつなぐ。details は既定では一瞬で開閉する(2026-10-22 かしぇ「▼要素のアニメーションがそっち側にない」)。
+# 開くときは開いた高さまで伸ばし(長いほど少し長く・上限 0.42 秒・減速)、閉じるときは見出しの高さまで縮めてから open を外す(0.24 秒)
+DETAILS_JS = ("(function(){var RM=matchMedia('(prefers-reduced-motion:reduce)');"
+ "document.querySelectorAll('details').forEach(function(d){var s=d.querySelector('summary'),an=null;if(!s||!d.animate)return;"
+ "s.addEventListener('click',function(e){if(RM.matches)return;e.preventDefault();var h0=d.offsetHeight;if(an)an.cancel();"
+ "var cs=getComputedStyle(d),pad=parseFloat(cs.paddingTop)+parseFloat(cs.paddingBottom)+parseFloat(cs.borderTopWidth)+parseFloat(cs.borderBottomWidth);"
+ "d.style.overflow='hidden';"
+ "if(!d.open||d.classList.contains('closing')){d.classList.remove('closing');d.open=true;var h1=d.offsetHeight;"
+ "an=d.animate([{height:h0+'px'},{height:h1+'px'}],{duration:Math.min(420,200+Math.abs(h1-h0)*.3),easing:'cubic-bezier(.33,1,.68,1)'});"
+ "an.onfinish=function(){an=null;d.style.overflow=''}}"
+ "else{d.classList.add('closing');an=d.animate([{height:h0+'px'},{height:(s.offsetHeight+pad)+'px'}],{duration:240,easing:'cubic-bezier(.65,0,.35,1)'});"
+ "an.onfinish=function(){an=null;d.open=false;d.classList.remove('closing');d.style.overflow=''}}})})})();")
+
+
+# ダッシュボードの本体の枠(iframe)に開かれたときだけ、指の位置を親へ送る。枠の上の指の動きは親に届かず、
+# 横に引いて一覧を開く操作が効かなかった(2026-10-22 かしぇ「サイドバー引っ張って開けないのは結構きつい」)。
+# 送るのは位置だけで、縦のスクロールはこの文書がそのまま受ける。横にスクロールできる表の上で始めた操作は送らない(表に譲る)。
+# ファイルを直接開いた束でも届くよう postMessage で送る。
+# 文書の一番上から下へ引いたときは「引っぱって更新」として引いた量(pull)を送り、この文書のスクロールと弾みは止める
+# (同日かしぇ「引っぱって更新も足して」)。向きは 10px 動くまで決めない(親の本体と同じ)
+FRAME_JS = ("(function(){if(window.parent===window)return;var on=false,mode='',x0=0,y0=0,top=false;"
+ "function post(o){o.imz='touch';parent.postMessage(o,'*')}"
+ "function send(k,e){var p=e.changedTouches[0];post({type:k,x:p.clientX,y:p.clientY})}"
+ "addEventListener('touchstart',function(e){var w=e.target.closest&&e.target.closest('.tablewrap,pre');"
+ "on=e.touches.length===1&&!(w&&w.scrollWidth>w.clientWidth);mode='';top=scrollY<=0;"
+ "if(on){x0=e.touches[0].clientX;y0=e.touches[0].clientY;send('down',e)}},{passive:true});"
+ "addEventListener('touchmove',function(e){if(!on)return;var p=e.touches[0],dx=p.clientX-x0,dy=p.clientY-y0;"
+ "if(!mode&&Math.hypot(dx,dy)>=10){mode=top&&dy>0&&Math.abs(dy)>Math.abs(dx)?'pull':'free';if(mode==='pull')y0=p.clientY}"
+ "if(mode==='pull'){if(e.cancelable)e.preventDefault();post({type:'pull',dy:p.clientY-y0})}else send('move',e)},{passive:false});"
+ "function up(e){if(!on)return;on=false;if(mode==='pull')post({type:'pullend'});else send('up',e)}"
+ "addEventListener('touchend',up,{passive:true});addEventListener('touchcancel',up,{passive:true})})();")
+
+
+def page(title: str, body: str, extra_head: str = "", scripts: tuple[str, ...] = ()) -> str:
+ """文書のページの外枠。body は組み終わった HTML(.sheet を並べたもの)。
+ スクリプトは折りたたみの動き(DETAILS_JS)と、渡されたものだけを、中身のハッシュで許して置く"""
+ import hashlib
+ js = [*scripts, DETAILS_JS, FRAME_JS]
+ hashes = " ".join("'sha256-" + base64.b64encode(hashlib.sha256(s.encode()).digest()).decode() + "'" for s in js)
+ csp = f"default-src 'none'; {CSP_FONTS}; script-src {hashes}"
+ tags = "".join(f"<script>{s}</script>" for s in js)
+ return (f'<!doctype html>\n<html lang="ja"><head><meta charset="utf-8">'
+ f'<meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover">'
+ f'<meta http-equiv="Content-Security-Policy" content="{csp}">{HEAD_META}'
+ f"<title>{html.escape(title)}</title>{FONT_LINK}{extra_head}</head>\n<body><main>\n{body}\n</main>{tags}</body></html>\n")
diff --git a/tests/test_dashboard.py b/tests/test_dashboard.py
index d325b98..def537b 100644
--- a/tests/test_dashboard.py
+++ b/tests/test_dashboard.py
@@ -5,6 +5,7 @@ import json
import tempfile
import unittest
from pathlib import Path
+from unittest.mock import patch
SCRIPTS = Path(__file__).resolve().parents[1] / "skills/imozuru/scripts"
@@ -43,6 +44,202 @@ class DashboardTests(unittest.TestCase):
def collect(self):
return {t["slug"]: t for t in dash.collect(self.root, dash.load_runs(self.runs_file))}
+ def request(self, path="/?k=kk", headers=None, handler=None):
+ import io
+ from types import SimpleNamespace
+
+ class Request:
+ def __init__(self, data):
+ self.data = data
+ self.output = bytearray()
+
+ def makefile(self, *a):
+ return io.BytesIO(self.data)
+
+ def sendall(self, data):
+ self.output.extend(data)
+
+ headers = {"Host": "127.0.0.1:8765", **(headers or {})}
+ data = f"GET {path} HTTP/1.1\r\n" + "".join(f"{k}: {v}\r\n" for k, v in headers.items()) + "\r\n"
+ request = Request(data.encode("latin-1"))
+ handler = handler or dash.make_handler(self.root, [], "kk")
+ handler(request, ("127.0.0.1", 1), SimpleNamespace(server_port=8765))
+ head, _, body = bytes(request.output).partition(b"\r\n\r\n")
+ lines = head.decode("latin-1").split("\r\n")
+ return int(lines[0].split()[1]), dict(line.split(": ", 1) for line in lines[1:]), body
+
+ def test_malformed_source_urls_still_render_and_serve(self):
+ (self.root / "new-topic" / "map.md").write_text(
+ "問い: 空\n\n## 原文\n| A | https://example.com#frag |\n"
+ "| B | https://[x |\n| C | https://example.com:443 |\n| D | https://good.test/a |\n",
+ encoding="utf-8")
+ self.assertEqual(self.collect()["new-topic"]["hosts"], ["good.test"])
+ self.assertIn("<!doctype html>", dash.render(list(self.collect().values()), self.root))
+ self.assertEqual(self.request()[0], 200)
+
+ def test_symlinked_topics_and_documents_are_not_collected_served_or_bundled(self):
+ import contextlib, io
+ with tempfile.TemporaryDirectory() as tmp:
+ outside = Path(tmp)
+ (outside / "map.md").write_text("問い: 外部の秘密\n", encoding="utf-8")
+ (self.root / "linked-topic").symlink_to(outside, target_is_directory=True)
+ topics = dash.collect(self.root, [])
+ self.assertNotIn("linked-topic", [t["slug"] for t in topics])
+ self.assertEqual(self.request("/linked-topic/map.md?k=kk")[0], 404)
+ for name in ("map.md", "log.md", "digest.html", "report.html", "queries.jsonl", "digest.json"):
+ path = self.root / "new-topic" / name
+ path.unlink(missing_ok=True)
+ path.symlink_to(outside / "map.md")
+ topics = dash.collect(self.root, [])
+ topic = next(t for t in topics if t["slug"] == "new-topic")
+ self.assertEqual(topic["question"], "")
+ self.assertEqual(topic["date"], "")
+ self.assertEqual(topic["docs"], [])
+ for name in ("map.md", "log.md", "digest.html", "report.html"):
+ self.assertEqual(self.request(f"/new-topic/{name}?k=kk")[0], 404)
+ dest = outside / "bundle"
+ with contextlib.redirect_stdout(io.StringIO()):
+ self.assertEqual(dash.write_bundle(topics, self.root, dest), 0)
+ self.assertFalse((dest / "linked-topic").exists())
+ self.assertFalse((dest / "new-topic").exists())
+ self.assertNotIn("外部の秘密", (dest / "index.html").read_text(encoding="utf-8"))
+
+ def test_bundle_rejects_destination_symlinks_before_writing(self):
+ import contextlib, io
+ (self.root / "new-topic" / "report.html").write_text("<p>x</p>", encoding="utf-8")
+ for relative in ("index.html", "new-topic", "new-topic/map.md", "new-topic/log.md",
+ "new-topic/digest.html", "new-topic/report.html", dash.ICON.name, "."):
+ with self.subTest(relative=relative), tempfile.TemporaryDirectory() as tmp:
+ outside = Path(tmp) / "outside"
+ outside.mkdir()
+ marker = outside / "secret"
+ marker.write_text("変えない", encoding="utf-8")
+ dest = Path(tmp) / "bundle"
+ target = dest / relative
+ target.parent.mkdir(parents=True, exist_ok=True)
+ target.symlink_to(outside if relative in (".", "new-topic") else marker)
+ topics = dash.collect(self.root, [])
+ with self.assertRaisesRegex(ValueError, "シンボリックリンク"):
+ dash.write_bundle(topics, self.root, dest)
+ self.assertEqual(marker.read_text(encoding="utf-8"), "変えない")
+ self.assertEqual(list(outside.iterdir()), [marker])
+ if relative != "index.html":
+ self.assertFalse((dest / "index.html").exists())
+ err = io.StringIO()
+ with patch("sys.argv", ["dashboard.py", str(self.root), "--bundle", str(dest)]), contextlib.redirect_stderr(err):
+ self.assertEqual(dash.main(), 2)
+ self.assertIn("シンボリックリンク", err.getvalue())
+
+ def test_index_write_ignores_old_temp_symlink_and_cleans_up_on_error(self):
+ import contextlib, io
+ with tempfile.TemporaryDirectory() as tmp:
+ outside = Path(tmp) / "secret"
+ outside.write_text("変えない", encoding="utf-8")
+ old_tmp = self.root / ".index.html.tmp"
+ old_tmp.symlink_to(outside)
+ with patch("sys.argv", ["dashboard.py", str(self.root)]), contextlib.redirect_stdout(io.StringIO()):
+ self.assertEqual(dash.main(), 0)
+ index = self.root / "index.html"
+ page = index.read_text(encoding="utf-8")
+ self.assertEqual(page, dash.render(dash.collect(self.root, []), self.root))
+ self.assertEqual(outside.read_text(encoding="utf-8"), "変えない")
+ with patch("sys.argv", ["dashboard.py", str(self.root)]), patch.object(dash.os, "replace", side_effect=KeyboardInterrupt):
+ with self.assertRaises(KeyboardInterrupt):
+ dash.main()
+ self.assertEqual(index.read_text(encoding="utf-8"), page)
+ self.assertEqual(list(self.root.glob(".index.html*.tmp")), [old_tmp])
+
+ def test_non_ascii_query_and_cookie_fail_authentication(self):
+ self.assertEqual(self.request("/?k=%C3%A9")[0], 403)
+ self.assertEqual(self.request("/", {"Cookie": "imozuru=é"})[0], 403)
+ status, headers, _ = self.request()
+ self.assertEqual(status, 200)
+ self.assertIn("HttpOnly", headers["Set-Cookie"])
+ self.assertEqual(self.request("/", {"Cookie": "imozuru=kk"})[0], 200)
+
+ def test_logging_without_path_does_not_crash_or_log_token(self):
+ import contextlib, io
+ handler = dash.make_handler(self.root, [], "kk")
+ request = handler.__new__(handler)
+ with contextlib.redirect_stderr(io.StringIO()) as err:
+ request.log_message("bad request")
+ request.path = "/?k=secret"
+ request.log_message("request", "GET", "403")
+ self.assertNotIn("secret", err.getvalue())
+
+ def test_short_serve_tokens_are_rejected_before_server_startup(self):
+ import contextlib, io
+ for token in ("", "short", "x" * 15):
+ with self.subTest(token=token), patch.dict("os.environ", {"IMOZURU_SERVE_TOKEN": token}):
+ with patch("http.server.ThreadingHTTPServer") as server, contextlib.redirect_stderr(io.StringIO()) as err:
+ self.assertEqual(dash.serve(self.root, [], 8765), 2)
+ server.assert_not_called()
+ self.assertIn("IMOZURU_SERVE_TOKEN は16文字以上にしてください", err.getvalue())
+
+ def test_generated_and_long_serve_tokens_work(self):
+ import contextlib, io, os
+ for token in (None, "x" * 16):
+ with self.subTest(token=token), patch.dict("os.environ"):
+ os.environ.pop("IMOZURU_SERVE_TOKEN", None)
+ if token is not None:
+ os.environ["IMOZURU_SERVE_TOKEN"] = token
+ with patch("http.server.ThreadingHTTPServer") as server, contextlib.redirect_stdout(io.StringIO()) as out:
+ server.return_value.serve_forever.side_effect = KeyboardInterrupt
+ self.assertEqual(dash.serve(self.root, [], 8765), 0)
+ given = out.getvalue().split("?k=", 1)[1].splitlines()[0]
+ self.assertGreaterEqual(len(given), 16)
+ self.assertEqual(self.request(f"/?k={given}", handler=server.call_args.args[1])[0], 200)
+
+ def test_host_allowlist_runs_before_token_check(self):
+ with patch.dict("os.environ", {"IMOZURU_SERVE_HOSTS": " Custom.Example.com , Fixed.Example.com:9443, "}):
+ handler = dash.make_handler(self.root, [], "kk")
+ for host in ("127.0.0.1:8765", "localhost:8765", "something.tail0a1b2c.ts.net",
+ "SOMETHING.tail0a1b2c.TS.NET:443", "custom.example.com", "CUSTOM.EXAMPLE.COM:9443",
+ "fixed.example.com:9443"):
+ with self.subTest(host=host):
+ self.assertEqual(self.request(headers={"Host": host}, handler=handler)[0], 200)
+ for host in ("evil.example.com:8765", "something.ts.net.evil.com", "127.0.0.1:9999",
+ "localhost", "fixed.example.com:443", "something.ts.net:bad", ""):
+ with self.subTest(host=host):
+ status, _, body = self.request(headers={"Host": host}, handler=handler)
+ self.assertEqual(status, 403)
+ self.assertIn("Host", body.decode())
+ status, _, body = self.request("/?k=wrong", {"Host": "localhost:8765"}, handler)
+ self.assertEqual(status, 403)
+ self.assertIn("合言葉", body.decode())
+ status, _, body = self.request("/?k=%C3%A9", {"Host": "evil.example.com:8765"}, handler)
+ self.assertEqual(status, 403)
+ self.assertIn("Host", body.decode())
+
+ def test_unsafe_slugs_cannot_enter_current_item_css(self):
+ import re
+ for slug in ('bad"].on{color:red}', "<style>", "bad\\slug", "bad name"):
+ (self.root / slug).mkdir()
+ topics = dash.collect(self.root, [])
+ self.assertEqual({t["slug"] for t in topics}, {"new-topic", "empty-topic"})
+ malicious = 'x</style><script>alert(1)</script>"'
+ page = dash.render(topics + [{**topics[0], "slug": malicious}], self.root)
+ styles = "".join(re.findall(r"<style>(.*?)</style>", page, re.S))
+ self.assertNotIn(malicious, page)
+ self.assertNotIn("</style>", styles)
+ self.assertNotIn("alert(1)", styles)
+ self.assertNotIn('<script>alert(1)</script>', page)
+ self.assertIn(dash.esc(malicious), page)
+
+ def test_percent_encoded_japanese_documents_and_traversal(self):
+ from urllib.parse import quote
+ topic = self.root / "夕焼け"
+ topic.mkdir()
+ (topic / "map.md").write_text("問い: 赤い空\n", encoding="utf-8")
+ self.assertIn("夕焼け", self.collect())
+ status, _, body = self.request(f"/{quote(topic.name)}/map.md?k=kk")
+ self.assertEqual(status, 200)
+ self.assertIn("赤い空", body.decode())
+ for path in ("/..%2Fnew-topic/map.md", "/%2e%2e/new-topic/map.md",
+ f"/{quote(topic.name)}/..%2Fnew-topic/map.md", "/%252e%252e/map.md"):
+ with self.subTest(path=path):
+ self.assertEqual(self.request(path + "?k=kk")[0], 404)
+
def test_counts_rounds_sources_and_hosts(self):
t = self.collect()["new-topic"]
self.assertEqual(t["rounds"], 2) # 0周目は数えない
@@ -55,21 +252,21 @@ class DashboardTests(unittest.TestCase):
t = self.collect()["new-topic"]
# 「回した人」の列が無い行も列をずらさずに読み、見張りの行より掘った行を使う
self.assertEqual(t["run"]["周"], "2")
- self.assertEqual(t["reason_class"], "論点に根拠がそろった")
+ self.assertEqual(t["reason_class"], "論点充足")
def test_topic_without_records_is_marked_not_zero(self):
t = self.collect()["empty-topic"]
self.assertIsNone(t["rounds"])
self.assertIsNone(t["searches"])
- self.assertEqual(t["reason_class"], "記録なし")
+ self.assertEqual(t["reason_class"], "記録欠落")
page = dash.render(list(self.collect().values()), self.root)
self.assertIn("記録なし", page)
def test_reason_classes(self):
- self.assertEqual(dash.classify("約束で打ち切り(壁が多い)"), "約束で打ち切り")
- self.assertEqual(dash.classify("2周で区切った(要の原典5本が出版社のボット対策で取れない)"), "取得の壁")
- self.assertEqual(dash.classify("1周目まで(論点3/5に原文)"), "一部の論点を残して区切った")
- self.assertEqual(dash.classify("論点6/6に原文(道具の比較は一部だけ)"), "論点に根拠がそろった")
+ self.assertEqual(dash.classify("約束で打ち切り(壁が多い)"), "期限到達")
+ self.assertEqual(dash.classify("2周で区切った(要の原典5本が出版社のボット対策で取れない)"), "取得不可")
+ self.assertEqual(dash.classify("1周目まで(論点3/5に原文)"), "一部充足")
+ self.assertEqual(dash.classify("論点6/6に原文(道具の比較は一部だけ)"), "論点充足")
def test_page_escapes_text_and_runs_only_the_hashed_script(self):
import base64
@@ -84,6 +281,174 @@ class DashboardTests(unittest.TestCase):
self.assertIn(f"script-src 'sha256-{h}'", page)
self.assertIn("default-src 'none'", page)
+ def test_explanations_live_on_the_guide_section(self):
+ topics = list(self.collect().values())
+ page = dash.render(topics, self.root)
+ home = dash.home_html(topics)
+ # ホームには数え方や分類の規則を書かず、同じページの説明の節へのリンクだけを置く
+ self.assertNotIn("自動分類", home)
+ self.assertNotIn("新しい順", page.split('id="guide"')[0])
+ self.assertIn('href="#guide"', page)
+ guide = page.split('id="guide"', 1)[1]
+ for label, _ in dash.REASON_RULES:
+ self.assertIn(label, guide)
+
+ def test_bundle_copies_documents_but_not_sources(self):
+ import contextlib, io
+ dest = self.root.parent / (self.root.name + "-bundle")
+ self.addCleanup(lambda: __import__("shutil").rmtree(dest, ignore_errors=True))
+ with contextlib.redirect_stdout(io.StringIO()):
+ self.assertEqual(dash.write_bundle(dash.collect(self.root, []), self.root, dest), 0)
+ self.assertTrue((dest / "index.html").is_file())
+ self.assertTrue((dest / "new-topic" / "map.md").is_file())
+ self.assertFalse((dest / "new-topic" / "sources").exists())
+ # 束を調査の置き場の中に作ると、次の走査で束が調査の1件に見える
+ with contextlib.redirect_stderr(io.StringIO()):
+ self.assertEqual(dash.write_bundle([], self.root, self.root / "b"), 2)
+
+ def test_serve_returns_only_listed_documents(self):
+ import threading, urllib.error, urllib.request
+ from http.server import ThreadingHTTPServer
+ (self.root / "new-topic" / "sources").mkdir(exist_ok=True)
+ (self.root / "new-topic" / "sources" / "a.md").write_text("原文", encoding="utf-8")
+ server = ThreadingHTTPServer(("127.0.0.1", 0), dash.make_handler(self.root, [], "kk"))
+ server.RequestHandlerClass.log_message = lambda *a: None
+ threading.Thread(target=server.serve_forever, daemon=True).start()
+ self.addCleanup(server.shutdown)
+ base = f"http://127.0.0.1:{server.server_port}"
+
+ def status(path):
+ try:
+ return urllib.request.urlopen(base + path).status
+ except urllib.error.HTTPError as e:
+ return e.code
+ self.assertEqual(status("/"), 403)
+ self.assertEqual(status("/?k=kk"), 200)
+ self.assertEqual(status("/new-topic/map.md?k=kk"), 200)
+ page = urllib.request.urlopen(base + "/new-topic/map.md?k=kk").read().decode()
+ self.assertIn('class="imz-hud" href="../index.html#t-new-topic"', page)
+ for bad in ("/new-topic/sources/a.md", "/new-topic/../new-topic/map.md", "/../etc/passwd", "/new-topic/x.md"):
+ self.assertEqual(status(bad + "?k=kk"), 404, bad)
+ # ホーム画面のアイコンだけは合言葉なしで返す(iPhone は cookie を送らないことがある)。ほかは合言葉が要るまま
+ self.assertEqual(status("/apple-touch-icon.png"), 200)
+ self.assertEqual(status("/new-topic/map.md"), 403)
+ self.assertIn('rel="apple-touch-icon" href="apple-touch-icon.png"', urllib.request.urlopen(base + "/?k=kk").read().decode())
+
+ def test_totals_are_the_first_plate_not_the_header(self):
+ page = dash.render(dash.collect(self.root, []), self.root)
+ header = page[page.index("<header>"):page.index("</header>")]
+ self.assertNotIn("原文", header)
+ home = page[page.index('<section class="home">'):]
+ self.assertTrue(home.split(">", 1)[1].lstrip().startswith('<div class="card tally"><h1 class="plate-name">'))
+
+ def test_search_index_takes_words_from_map_and_escapes_them(self):
+ (self.root / "new-topic" / "map.md").write_text(
+ "問い: 夕焼け\n\n## 用語\n- Rayleigh 散乱(\"短い\" <波長>)— a.md:3\n- 薄明 — b.md\n\n"
+ "## 人\n- Strutt(レイリー卿)— c.md\n\n## 場(学会・雑誌)\n- AMS — https://ams.example.test\n",
+ encoding="utf-8")
+ topics = dash.collect(self.root, [])
+ info = next(t for t in topics if t["slug"] == "new-topic")
+ self.assertEqual(info["words"], [("用語", 'Rayleigh 散乱("短い" <波長>)'), ("用語", "薄明"),
+ ("人", "Strutt(レイリー卿)"), ("媒体", "AMS")])
+ page = dash.render(topics, self.root)
+ self.assertNotIn("<波長>", page)
+ self.assertIn("&lt;波長&gt;", page)
+ self.assertIn('data-s="new-topic 夕焼け', page)
+
+ def test_reading_line_goes_to_the_search_index(self):
+ (self.root / "new-topic" / "map.md").write_text(
+ "問い: 夕焼けはなぜ赤いか\n読み: ゆうやけ なぜ あかい\n", encoding="utf-8")
+ topics = dash.collect(self.root, [])
+ self.assertEqual(next(t for t in topics if t["slug"] == "new-topic")["reading"], "ゆうやけ なぜ あかい")
+ self.assertIn('data-r="ゆうやけ なぜ あかい"', dash.render(topics, self.root))
+
+ def test_short_title_heads_the_list_and_the_question_stays_in_full(self):
+ (self.root / "new-topic" / "map.md").write_text(
+ "問い: 夕方の空が赤く見えるのは、光のどんな性質によるのか\n題: 夕焼けはなぜ赤いか\n", encoding="utf-8")
+ page = dash.render(dash.collect(self.root, []), self.root)
+ self.assertIn('<span class="q">夕焼けはなぜ赤いか</span>', page)
+ self.assertIn("<h2>夕焼けはなぜ赤いか</h2>", page)
+ self.assertIn('<p class="question">夕方の空が赤く見えるのは、光のどんな性質によるのか</p>', page)
+
+ def test_sidebar_has_search_and_both_pagers(self):
+ page = dash.render(dash.collect(self.root, []), self.root)
+ self.assertIn('id="find"', page)
+ self.assertIn('class="pager sp"', page.split("</header>")[0])
+ self.assertIn('class="pager pc"', page.split('<div class="side"')[1])
+
+ def test_markdown_preview_escapes_and_links_only_http(self):
+ import skin
+ out = skin.md_html("# 題 <b>\n\n- [x] 済み\n- [ ] まだ <script>alert(1)</script>\n\n"
+ "| 列 | 値 |\n|---|---|\n| a | [x](javascript:alert(1)) |\n\n"
+ "見る https://example.test/a?b=1&c=2 と [論文](https://example.test/p)\n\n```\n<i>そのまま</i>\n```\n")
+ self.assertIn("<h1>題 &lt;b&gt;</h1>", out)
+ self.assertNotIn("<script>", out)
+ self.assertNotIn('href="javascript', out)
+ self.assertIn('<a href="https://example.test/p" target="_blank" rel="noopener noreferrer">論文</a>', out)
+ self.assertIn('href="https://example.test/a?b=1&amp;c=2"', out)
+ self.assertIn('class="box on"', out)
+ self.assertIn("<table>", out)
+ self.assertIn("&lt;i&gt;そのまま&lt;/i&gt;", out)
+ # 字下げした項目は、直前の項目の中の入れ子の箇条書きになる
+ self.assertIn("<ul><li>親<ul><li>子</li></ul></li><li>次</li></ul>", skin.md_html("- 親\n - 子\n- 次"))
+ page = dash.with_back("map.md", "# 地図\n- 項目".encode(), "new-topic").decode()
+ self.assertIn('<article class="sheet md"><h1>地図</h1>', page)
+ self.assertIn('class="imz-hud"', page)
+
+ def test_pages_carry_favicon_and_quotes_name_their_language(self):
+ import report
+ import skin
+ page = dash.render(dash.collect(self.root, []), self.root)
+ doc = dash.with_back("map.md", "# 地図".encode(), "new-topic").decode()
+ for p in (page, doc):
+ self.assertIn('<html lang="ja">', p)
+ self.assertIn('name="format-detection" content="telephone=no"', p)
+ self.assertEqual('rel="icon" type="image/png" href="data:image/png;base64,' in p,
+ (skin.ASSETS / "favicon.png").is_file())
+ en = report.quote_html(self.root, {"file": "a.txt", "line": 1, "text": "Rayleigh scattering"}, ["Rayleigh scattering"], 1)
+ self.assertIn('<blockquote lang="en">', en)
+ self.assertIn('<pre lang="en">', en)
+ ja = report.quote_html(self.root, {"file": "a.txt", "line": 1, "text": "空が青い"}, ["空が青い"], 1)
+ self.assertIn("<blockquote>", ja)
+
+ def test_ledger_note_only_when_numbers_differ(self):
+ t = self.collect()["new-topic"]
+ t["run"] = {**t["run"], "周": "2周", "原文": "原文5本", "感覚と合った?": "「いいね」"}
+ out = dash.topic_html(t)
+ self.assertNotIn("台帳 2周", out)
+ self.assertIn("台帳 原文5本", out)
+ self.assertIn("<dt>ユーザーの反応</dt>", out)
+
+ def test_guide_shows_screens_with_numbered_legend(self):
+ guide = dash.guide_html(list(self.collect().values()))
+ have = all(dash.LOGO.with_name(f"guide-{d}-{k}.webp").is_file() for d in ("sp", "pc") for k, _, _ in dash.GUIDE_SCREENS)
+ # 図があれば図と番号の説明、無ければ文字の3行で画面の見方を書く。どちらでも「ホーム」の説明は出る
+ self.assertEqual('<img src="data:image/webp;base64,' in guide, have)
+ self.assertIn("ホーム", guide)
+ if have:
+ self.assertIn('<span class="n">9</span>', guide)
+ # 両方の端末にある部品(数字)は、どちらの組にも同じ番号と説明で並ぶ。片方だけの部品は文字の印(.only)で、その組にだけ載る
+ sp, pc = guide.split('data-dev="sp"')[1].split('data-dev="pc"')
+ pc = pc.split("</details>")[0]
+ num = lambda h: __import__("re").findall(r'<li><span class="n">(\d+)</span>([^<]*)</li>', h)
+ self.assertEqual(num(sp), num(pc))
+ self.assertIn("サイドバーを閉じる", sp)
+ self.assertNotIn("サイドバーを閉じる", pc)
+ self.assertIn("つまみ", pc)
+ # 題 → 図 → 番号の説明の順。スマホとパソコンの組は、それぞれ畳みに入る
+ self.assertIn('<figure class="shot"><figcaption>', guide)
+ self.assertIn('data-dev="sp"', guide)
+ self.assertNotIn('<ul class="parts">', guide)
+
+ def test_guide_breaks_lines_per_sentence_but_not_inside_tags(self):
+ guide = dash.guide_html(list(self.collect().values()))
+ self.assertIn("ダッシュボードです。<br>", guide)
+ self.assertEqual(dash.sentence_lines('<p>一。二。</p><img alt="a。b">'), '<p>一。<br>二。</p><img alt="a。b">')
+ # 項目の最後に句点が無ければ付ける。図の番号の説明は、同じ番号の中では改行しない
+ self.assertEqual(dash.sentence_lines("<li>一。二</li>"), "<li>一。<br>二。</li>")
+ self.assertEqual(dash.sentence_lines('<ol class="legend"><li>一。二</li></ol><p>三。四。</p>'),
+ '<ol class="legend"><li>一。二。</li></ol><p>三。<br>四。</p>')
+
def test_works_without_ledger(self):
topics = dash.collect(self.root, dash.load_runs(None))
self.assertTrue(dash.render(topics, self.root).startswith("<!doctype html>"))
diff --git a/tests/test_digest.py b/tests/test_digest.py
index ef51949..07ca70d 100644
--- a/tests/test_digest.py
+++ b/tests/test_digest.py
@@ -65,6 +65,13 @@ class DigestTests(unittest.TestCase):
contextlib.redirect_stdout(out), contextlib.redirect_stderr(io.StringIO()):
return digest.main()
+ def build_report(self):
+ data = {"title": "夕焼け", "question": "なぜ赤いか", "stopped": "照合済み",
+ "claims": [{"claim": "散乱", "status": "根拠あり", "quotes": sentence("")["quotes"]}]}
+ (self.topic / "extracts.json").write_text(json.dumps(data), encoding="utf-8")
+ with patch.object(sys, "argv", ["report.py", str(self.topic)]), contextlib.redirect_stdout(io.StringIO()):
+ return digest.report.main()
+
def test_cited_digest_builds_page_with_both_levels(self):
code, _ = self.build()
self.assertEqual(code, 0)
@@ -127,6 +134,61 @@ class DigestTests(unittest.TestCase):
self.assertIn("paper.txt", page)
# 検索で挙がっていない取得も隠さず出す
self.assertIn("other.example.test/x", page)
+ self.assertIn('href="http://www.example.test/paper/" target="_blank" rel="noopener noreferrer"', page)
+
+ def test_malformed_hit_urls_build_as_text_and_unknown_host(self):
+ urls = ("https://example.test#evil/", "https://example.test:443/", "https://[example.test/")
+ record = {"round": 1, "query": "壊れた URL", "hits": [{"title": u, "url": u} for u in urls]}
+ (self.topic / "queries.jsonl").write_text(json.dumps(record), encoding="utf-8")
+ self.assertEqual(self.build()[0], 0)
+ page = (self.topic / "digest.html").read_text(encoding="utf-8")
+ self.assertIn('<th scope="row">?</th>', page)
+ self.assertIn("<td>3</td>", page)
+ for url in urls:
+ self.assertIn(url, page)
+ self.assertNotIn(f'href="{url}"', page)
+
+ def test_loaded_records_reject_non_integer_round_and_keep_prior_page(self):
+ prior = self.topic / "digest.html"
+ prior.write_text("Previous", encoding="utf-8")
+ for rnd in ('<img src=x onerror="alert(1)">', True, None, 1.5):
+ with self.subTest(round=rnd):
+ (self.topic / "queries.jsonl").write_text(
+ json.dumps({"round": rnd, "query": "q", "by": "a", "method": "m", "hits": []}), encoding="utf-8")
+ with contextlib.redirect_stderr(io.StringIO()) as err:
+ self.assertEqual(self.build()[0], 1)
+ self.assertIn("queries.jsonl", err.getvalue())
+ self.assertIn("周(round)が整数でない", err.getvalue())
+ self.assertEqual(prior.read_text(encoding="utf-8"), "Previous")
+
+ def test_record_round_is_escaped_on_output(self):
+ rnd = "<img src=x onerror=alert(1)>"
+ page = digest.records_html([{"round": rnd, "query": "q", "by": "a", "method": "m", "hits": []}], {})
+ self.assertIn("&lt;img src=x onerror=alert(1)&gt;周目", page)
+ self.assertNotIn(rnd, page)
+
+ def test_page_writes_ignore_planted_old_temp_symlinks(self):
+ for name, build in (("digest", self.build), ("report", self.build_report)):
+ with self.subTest(page=name):
+ victim = self.topic.parent / f"keep-{name}.txt"
+ victim.write_text("Keep", encoding="utf-8")
+ planted = self.topic / f".{name}.html.tmp"
+ planted.symlink_to(victim)
+ build()
+ self.assertEqual(victim.read_text(encoding="utf-8"), "Keep")
+ self.assertTrue(planted.is_symlink())
+ self.assertIn("<!doctype html>", (self.topic / f"{name}.html").read_text(encoding="utf-8"))
+
+ def test_failed_page_replace_cleans_temp_and_keeps_prior_page(self):
+ for name, module, build in (("digest", digest, self.build), ("report", digest.report, self.build_report)):
+ with self.subTest(page=name):
+ prior = self.topic / f"{name}.html"
+ prior.write_text("Previous", encoding="utf-8")
+ with patch.object(module.os, "replace", side_effect=OSError("replace failed")):
+ with self.assertRaisesRegex(OSError, "replace failed"):
+ build()
+ self.assertEqual(prior.read_text(encoding="utf-8"), "Previous")
+ self.assertEqual(list(self.topic.glob(f".{name}.html.*")), [])
def test_non_http_hit_is_not_linked(self):
self.add([{"query": "q", "hits": [{"title": "bad", "url": "javascript:alert(1)"}]}], "--round", "1")
@@ -203,6 +265,27 @@ class FetchLogTests(unittest.TestCase):
class ChainLogTests(unittest.TestCase):
+ def test_chain_log_filters_untrusted_url_fields(self):
+ works = [
+ {"doi": 123, "id": "https://openalex.org/W1", "best_oa_location": {"pdf_url": 42}},
+ {"doi": {"url": "bad"}, "id": "https://openalex.org/W2", "best_oa_location": {"pdf_url": {}}},
+ {"doi": "javascript:alert(1)", "id": "https://openalex.org/W3", "best_oa_location": "bad"},
+ {"doi": "https://[bad", "id": "https://openalex.org/W4", "best_oa_location": {"pdf_url": "file:///x"}},
+ {"doi": None, "id": 123}, {"doi": {}, "id": {}},
+ {"doi": "ftp://example.test/x", "id": "javascript:alert(1)"}]
+ with tempfile.TemporaryDirectory() as tmp:
+ chain.log(tmp, 1, "find", "q", works)
+ record = json.loads((Path(tmp) / "queries.jsonl").read_text(encoding="utf-8"))
+ self.assertEqual([h["url"] for h in record["hits"]], [f"https://openalex.org/W{i}" for i in range(1, 5)])
+ self.assertTrue(all("also" not in h for h in record["hits"]))
+ self.assertEqual(record, digest.normalize_record(record, None, None))
+
+ def test_chain_log_validates_record_before_appending(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ with self.assertRaisesRegex(ValueError, "周(round)が整数でない"):
+ chain.log(tmp, "<b>1</b>", "find", "q", [])
+ self.assertFalse((Path(tmp) / "queries.jsonl").exists())
+
def test_chain_log_records_listed_works(self):
works = {"meta": {"count": 1}, "results": [
{"id": "https://openalex.org/W1", "display_name": "Rayleigh", "publication_year": 1871,
diff --git a/tests/test_palette.py b/tests/test_palette.py
new file mode 100644
index 0000000..035babc
--- /dev/null
+++ b/tests/test_palette.py
@@ -0,0 +1,61 @@
+"""書き出すページの色が palette.py の1か所から来ているかを検査する。
+
+ページの側に色の値を直接書くと、同じ役割の色が場所ごとにずれていく(2026-10-21 かしぇ「色管理徹底しよう」)。"""
+
+import importlib.util
+import re
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+
+SCRIPTS = Path(__file__).resolve().parents[1] / "skills/imozuru/scripts"
+sys.path.insert(0, str(SCRIPTS))
+
+
+def load(name):
+ spec = importlib.util.spec_from_file_location(name, SCRIPTS / f"{name}.py")
+ mod = importlib.util.module_from_spec(spec)
+ spec.loader.exec_module(mod)
+ return mod
+
+
+palette = load("palette")
+dash = load("dashboard")
+report = load("report")
+digest = load("digest")
+
+OKLCH = re.compile(r"oklch\([^)]*\)")
+HEX_COLOR = re.compile(r"[:\s,(]#[0-9a-fA-F]{3,8}\b")
+NAMED_COLOR = re.compile(r":\s*(white|black|gray|grey|red|blue|green)\b")
+
+
+class PaletteTests(unittest.TestCase):
+ def assert_from_palette(self, text, where):
+ allowed = palette.all_values()
+ stray = sorted(set(OKLCH.findall(text)) - allowed)
+ self.assertEqual(stray, [], f"{where}: palette.py に無い色")
+ self.assertIsNone(HEX_COLOR.search(text), f"{where}: 16進の色")
+ self.assertIsNone(NAMED_COLOR.search(text), f"{where}: 名前の色")
+
+ def test_document_css(self):
+ self.assert_from_palette(report.CSS, "report.CSS")
+ self.assert_from_palette(digest.CSS, "digest.CSS")
+
+ def test_dashboard_page(self):
+ with tempfile.TemporaryDirectory() as d:
+ (Path(d) / "a-topic").mkdir()
+ self.assert_from_palette(dash.render(dash.collect(Path(d), []), Path(d)), "dashboard")
+
+ def test_back_button(self):
+ self.assert_from_palette(dash.with_back("map.md", b"# map", "a").decode(), "map.md")
+ self.assert_from_palette(dash.with_back("digest.html", b"<body></body>", "a").decode(), "digest.html")
+
+ def test_roles_point_at_swatches(self):
+ for roles in (palette.DASH, palette.DOC_LIGHT, palette.DOC_DARK, palette.HUD_LIGHT, palette.HUD_DARK):
+ for k, v in roles.items():
+ self.assertIn(v, palette.SWATCH, k)
+
+
+if __name__ == "__main__":
+ unittest.main()
diff --git a/tests/test_skin.py b/tests/test_skin.py
new file mode 100644
index 0000000..0f37aa5
--- /dev/null
+++ b/tests/test_skin.py
@@ -0,0 +1,40 @@
+"""外部の文や URL が混ざっても markdown を安全に表示する。"""
+
+import importlib.util
+import sys
+import unittest
+from pathlib import Path
+
+
+SCRIPT = Path(__file__).resolve().parents[1] / "skills/imozuru/scripts/skin.py"
+sys.path.insert(0, str(SCRIPT.parent))
+SPEC = importlib.util.spec_from_file_location("test_skin", SCRIPT)
+skin = importlib.util.module_from_spec(SPEC)
+SPEC.loader.exec_module(skin)
+
+
+class MarkdownTests(unittest.TestCase):
+ def test_malformed_urls_in_map_render_as_text(self):
+ for url in ("https://example.test#evil/", "https://example.test:443/", "https://[example.test/"):
+ for text in (f"# 地図\n\n[資料]({url})", f"# 地図\n\n{url}"):
+ with self.subTest(text=text):
+ page = skin.md_html(text)
+ self.assertIn(url, page)
+ self.assertNotIn("<a ", page)
+
+ def test_nuls_cannot_forge_code_placeholders(self):
+ for text, expected in (("\x000\x00", "<p>0</p>"),
+ ("`code` \x0099\x00", "<p><code>code</code> 99</p>")):
+ with self.subTest(text=text):
+ self.assertEqual(skin.md_html(text), expected)
+
+ def test_external_links_open_outside_frame(self):
+ for text in ("[資料](https://example.test/a?b=1&c=2)", "https://example.test/a?b=1&c=2"):
+ with self.subTest(text=text):
+ page = skin.md_html(text)
+ self.assertIn('href="https://example.test/a?b=1&amp;c=2" target="_blank" rel="noopener noreferrer"', page)
+ self.assertNotIn("<a ", skin.md_html("[危険](javascript:alert(1)) `https://example.test/code`"))
+
+
+if __name__ == "__main__":
+ unittest.main()