困ったときの対処
同梱リポジトリ版: (ZIP配布物ではここにバージョンが記載されます)
この文書は、問題が起きたときにデータを失わず状況を切り分けるための案内です。直そうとしてファイルを消す前に、まず一次対応を行ってください。
最初に行うこと
問題が起きても、すぐにファイルを削除・改名・上書きしないでください。特に内部作業保護の __pdf_note_workspace__/__tmp__/__stage__/ と __pdf_note_workspace__/__escape__/ は、未統合の編集や復旧用データを含むことがあります。
次を確認します。
- エラー表示と対象ファイル名を控える
- ワークスペースと対象ファイルの空き容量・書込み権限を確認する
- 「保存 > 保存状態を確認」で保護中の作業が残っていないか確認する
- 必要ならワークスペース全体を別の安全な場所へコピーしてから調査する
コピーを作るときは、アプリを終了してからワークスペースのフォルダ全体を複製します。__pdf_note_workspace__ を除外しないでください。
状況別の対処
| 状況 | 一次対応 | 理解しておくこと |
|---|---|---|
| ノートが保存できない | 保存先の書込み権限、空き容量、同名ファイルのロックを確認する | 元ファイルを守るため、保存失敗時は統合を中止します |
| 変更が見えない | 「保存 > 保存状態を確認」を開く | 編集中の変更は、原本とは別に内部で保護されることがあります |
| PDF位置または最終オープン時刻を戻したい | 「復元」から対象を選ぶ | バックアップは統合前に作られます。「復元 > バックアップ」から復元または個別削除できます。未統合の変更との関係を確認してから操作してください |
.clro と .clrop を取り違えた | 拡張子を変更せず、元の名前へ戻す | .clro はノート、.clrop は PDF 注釈 JSON です |
.md が期待どおりに見えない | .txt ではないか、文字コードや内容を確認する | .md は .clro と同じMarkdown系の表示です |
| 保存または終了に失敗する | 表示内容を控え、「保存 > 保存状態を確認」を開く | 原本を上書きせず、保護中の作業を残して操作を中止します |
| PDF やノートを移動・改名した後に問題が出た | 変更前のワークスペースコピーへ戻し、保存状態を確認する | 注釈データや内部作業保護は元のファイルとの対応を保って扱います |
| Lite版で DOCX/PPTX をドロップしても PDF にならない | PDF を用意してから取り込むか、通常版を使う | Lite版は変換 runtime を含まないため、Office-to-PDF 変換は行いません。ウィンドウ名に Lite と表示されます |
| 通常版で「LibreOffice変換ランタイムが見つからない」と表示される | 通常版のZIPを新しい空フォルダへ展開し直し、フォルダ内のファイルを混ぜずに起動する | runtimeが欠けてもLite版には切り替わりません。通常版の配布フォルダ一式を復元します |
| 通常版で Office 変換後の見た目が元文書と異なる | 変換後の PDF を確認し、必要なら元文書のフォントやレイアウトを調整して変換し直す | DOCX/PPTX 変換は試験的です。Microsoft Office やオンライン変換サービスは使用せず、同梱 LibreOffice でローカル変換します |
| Office変換でパス・起動引数の上限が表示される | 詳細の対象と上限を確認する。runtimeの起動フォルダーが対象なら、アプリ一式の配置先を短くする | 変換用ファイルに一律220文字の制限はありません。ファイル名単体、Windowsの起動フォルダー、引数全体には別の制約があります。書き込めない場合にOSの一時フォルダーへ退避しません |
| 起動時に「Windows によって PC が保護されました」と表示される | 「詳細情報」をクリックし、現れた「実行」ボタンを押す | インストーラーのない未署名ZIP配布物のため表示されます。1回許可すれば次回からそのまま起動できます |
| 操作時に Windows の「一般の警告音」が鳴る | 鳴った操作、アプリ版、Windows の版を控える。Windows の音を無効にすることで問題を受け入れない | この音は意図した通知ではなく、未解消の既知問題です。ファイルが壊れたことを示すものではありませんが、再現情報を添えて報告してください |
| 「プログラムから開く」でPDFを開くと案内が出る、または目的のファイルが開かない | 対象ファイルがワークスペース内にあるか確認する。ワークスペース外のファイル単体閲覧は「読み取り専用ソフト（readonly_viewer.exe）」を使う | メインソフトはワークスペース内のPDF/画像ファイルを直接開く仕様です。ワークスペース内のファイルであれば「プログラムから開く」で開けますが、外のファイルは安全案内が表示されます |
画面が表示されない・別の場所のアプリが見つかる
同じ配布フォルダから再度起動した場合は、既存のメイン画面を前面に出します。別の場所へ展開したアプリは独立して起動できますが、同じPDF・ノートなどを同時に開くことは保護のため制限されます。
起動時に、別の場所で画面を表示していないアプリが見つかることがあります。その場合は、保存や確認待ちの可能性があるため強制終了しません。確認後に通常終了を要求できますが、10秒以内に終了を確認できなければ未確認として扱います。対象プロセス専用の終了要求に対応していない旧版には、終了要求を送りません。
自分のメイン画面が15秒以上表示されない場合は、表示の復旧を最大3回試みます。それでも戻らないときは、無音の通知で「再表示を試す」「通常終了を試す」「待機する」を選べます。画面が戻れば通知は自動で閉じます。最小化や一時的な非表示は終了として扱いません。この機能は、画面が表示されたまま応答しない状態を検知するものではありません。
診断ログの容量
診断ログは調査用で、ワークスペースの __pdf_note_workspace__/__log__/ に保存します。プレビュー、切替時間、クラッシュ、起動監視、Office変換の5種類を合わせて10 MB（10,000,000バイト）までとし、停止記録1行分を残して追記を停止します。既存ログは切り詰めず、アプリを起動し直しても停止を維持します。編集・保存は継続できます。
一般設定のデバッグログ欄で、確認時点の容量と停止状態を確認できます。ログを再開する場合は、必要な診断ログを保管した後、開発者向けメニューのログ削除を明示実行してください。ZIP化だけでは容量は減りません。ZIPの控えと、独立して整理する write_checks.log はこの容量枠に含みません。ログ設定の変更はOffice変換ログも含め次回起動時に反映します。
__tmp__ や __escape__ には未保存・復旧用データがあります。ログ整理の目的で管理フォルダー全体を削除しないでください。
ログ・生成物の容量を確認する
「ヘルプ > 確認 > アセット存在確認」の「容量を調べる」で、選択中ワークスペースの管理フォルダー全体と、ログ、一時作業、復旧・作業データ、保存バックアップ、操作の復旧データ、メモのバックアップを確認できます。容量、取得できたファイル数、容量確認時刻、前回容量との差を表示し、詳細で正確なバイト数と確認状況を確認できます。
集計は明示操作で背景実行し、ファイルの作成・変更・削除は行いません。管理フォルダー外の原本PDFなどは集計せず、リンク先もたどりません。容量はファイル名ごとの論理サイズの合計で、ディスク使用量とは異なります。親フォルダーには子フォルダー分が含まれるため、行を足し合わせないでください。ログ行はZIP控え・検査ログも含むため、診断ログ5種の10 MB枠とは区別します。
中断・読取失敗・集計上限は取得分だけを表示し、未確認部分を0とは判断しません。上限は10万項目・深さ64・確認開始から5秒で、処理の区切りで判定するため、OSの読み取り応答待ちは5秒を超える場合があります。中断ボタンと画面を閉じる操作で取消を要求できます。確認中の保存などで容量は変わるため目安です。両方とも集計完了した確認結果だけを比較します。
存在確認と容量確認の時刻・待機は別に管理します。容量確認後は10秒間待機し、閉じ直しても結果と待機を保持します。存在状況の更新で容量を再集計することはなく、アプリ再起動後は容量未確認に戻ります。自動削除は行いません。
解決のための知識
ファイルの開き方とソフトの使い分け
- メインソフト (
pdf_note_workspace.exe):
ワークスペース内の PDF や画像ファイルを「プログラムから開く」で指定すると、該当する講義・セッションと同期して直接開きます。注釈の編集・保存を行う場合はこちらを使います。
- 読み取り専用ソフト (
readonly_viewer.exe):
ワークスペース外にある任意の PDF、Markdown、TXT などのファイルを単体で確認・閲覧したい場合に適しています。「プログラムから開く」に指定すれば、ワークスペース保護に制約されず直接閲覧できます。
自動作業保護と原本保存
自動作業保護は編集途中を守るための内部データです。切替では原本を書き換えず、通常の保存・終了・出力の直前には保存前の控えを作った後に原本が更新されます。
.clro は通常テキストです
.clro は UTF-8 のノート本文です。見慣れない拡張子ですが、バイナリ形式ではありません。形式の選択は File_Formats.md を参照してください。
復旧データは問題を調べるまで残します
__escape__ や内部作業保護のフォルダを消すと、復旧できる情報まで失う可能性があります。削除は、内容と不要になったことを確認してから行ってください。
相談・記録に役立つ情報
問題を再現できる場合は、次を控えると原因の確認に役立ちます。
- 何をしようとしたときに起きたか
- 表示されたメッセージ
- 対象の PDF、ノート、注釈ファイルの種類
- 保存前か保存後か、未統合の変更があるか
- アプリの版番号と Windows の版
個人情報や PDF・ノート本文をそのまま共有する必要はありません。必要な場合だけ、複製した作業用データで確認してください。