diff --git a/AGENTS.md b/AGENTS.md index be5a33c..17006f9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -11,6 +11,9 @@ RSSフィード(XMLファイル)を出力する際は、`output` ディレ ### 1.1 命名規則および具体例 - 対象サイトのドメイン名(FQDN)またはサービス識別子をサブディレクトリ名として使用します。 - `ryuugames.com` → `output/ryuugames.com/ryuugames.xml` + - `kimochi.info` → `output/kimochi.info/kimochiinfo.xml` + - `japaneseavi.blogspot.com` → `output/japaneseavi.blogspot.com/japaneseavi.xml` + - `jpfiles.net` → `output/jpfiles.net/jpfiles.xml` - `pixiv.net` → `output/pixiv.net/...` - `x.com` → `output/x.com/...` - `e-hentai.org` → `output/e-hentai.org/...` @@ -34,3 +37,109 @@ RSSフィード(XMLファイル)を出力する際は、`output` ディレ filter24Hours: false); ``` - 既存XMLファイルを読み込むキャッシュ処理(`LoadExistingEntries` 等)を実装する場合も、`CmnUtil.GetExportXmlPath(fileName, addDir)` を使用して該当ドメインサブフォルダ内のXMLファイルを探索・読み込んでください。 + +--- + +## 2. GUID(一意識別子)の標準ハッシュ化規則(必須) + +各記事エントリの一意識別子(RSS 2.0 の ``、`SyndicationItem.Id`)には、生のURL文字列をそのまま設定せず、**必ず `CmnUtil.CreateGuid(articleUrl)` で生成した SHA512 ハッシュ文字列(小文字16進数)を設定してください**。 + +### 2.1 実装方法 +```csharp +var guid = CmnUtil.CreateGuid(articleUrl); + +var item = new SyndicationItem( + cleanTitle, + summaryHtml, + new Uri(articleUrl), + guid, // 生URLではなく CmnUtil.CreateGuid によるハッシュ値を指定 + publishDate) +{ + PublishDate = publishDate, + LastUpdatedTime = lastUpdatedTime +}; +``` +- キャッシュ再利用時および既存フィードマージ時も、必ず `CmnUtil.CreateGuid(url)` によるハッシュIDを付与してください。 + +--- + +## 3. 日付・時刻(pubDate / LastUpdatedTime)の日本時間(JST)統一規則(必須) + +RSSフィード内の `` は、**必ず正確な日本時間(JST = UTC+9)として解釈・出力してください**。UTC時刻のまま `+0900` が付与されて時間がズレる(例: UTC 02:22 に `+0900` が付いて深夜2時になってしまう現象)ことを厳重に防止してください。 + +### 3.1 取得元形式別の変換実装 +- **サイト現地日時(JST表記、タイムゾーンなし文字列)の場合**: + `DateTime.TryParse` 後、オフセット `TimeSpan.FromHours(9)` を明示して `DateTimeOffset` を構築します。 + ```csharp + if (DateTime.TryParse(dateStr, out var parsedLocal)) + { + pubDate = new DateTimeOffset(parsedLocal, TimeSpan.FromHours(9)); + } + ``` +- **UTC日時(`date_gmt` や `Z` 付き文字列)の場合**: + `DateTimeKind.Utc` を明示し、`ToOffset(TimeSpan.FromHours(9))` で日本時間に変換します。 + ```csharp + if (DateTime.TryParse(dateGmtStr, out var parsedGmt)) + { + var utc = DateTime.SpecifyKind(parsedGmt, DateTimeKind.Utc); + pubDate = new DateTimeOffset(utc).ToOffset(TimeSpan.FromHours(9)); + } + ``` +- **HTMLメタタグ(`meta property="article:published_time"` 等)の場合**: + `CmnUtil.GetPublishedTimeAsJst(doc)` または `CmnUtil.GetModifiedTimeAsJst(doc)` を使用してください。 + +### 3.2 本文内の日本時間表示 +本文(SummaryHtml)ヘッダー部分にも、リーダー画面で直感的に確認できるよう日本時間を明記してください: +```html +📅 2026/11/11 11:22:27 (JST) +``` + +--- + +## 4. タイトル整形および Windows フォルダ名用タイトルの提供規則(必須) + +ユーザーが記事タイトルをそのままWindowsの保存用フォルダ名として利用できるよう、以下の整形処理とワンクリックコピー枠を必ず提供してください。 + +### 4.1 タイトル整形仕様 +1. **Windows 禁止文字の全角置換**: + `\ / : * ? " < > |` は必ず全角文字 `¥ / : * ? ” < > |` に置換してください。 +2. **タイトル構成フォーマット**: + 原則として `[サークル名・発売元・カテゴリ・品番] タイトル (バージョン情報)` の形式に整形してください。 + +### 4.2 本文最上部へのワンクリックコピー枠の配置 +本文(SummaryHtml)の先頭に、クリックするだけで文字列全体が選択(`onclick="this.select();"`)される入力欄を必ず配置してください: +```html +
+
📁 フォルダ名用タイトル(クリックで全選択)
+ +
+``` + +--- + +## 5. ダウンロードリンクの直リンク化および直下グリッド配置規則(必須) + +### 5.1 直リンク化の徹底 +- 外部ストレージ・アップローダーへのリンクは、中継短縮URL(adfly等)や不要なサイト内中継ページを可能な限りバイパス・自動解決し、**目的のストレージ(Mediafire, Mega, Rapidgator, Katfile, Nitroflare, Frdl 等)のダウンロードページURLを直接出力してください**。 +- ボタンではなく、RSSリーダー上で確実にクリック遷移可能な標準の `` タグで出力してください。 + +### 5.2 タイトル直下へのグリッドレイアウト配置 +- ダウンロードリンクは本文の奥深くに埋もれさせず、**タイトル・フォルダ名コピー枠のすぐ直下に配置してください**。 +- 1行に押し込めず、押しやすいボタングリッド(`display: flex; flex-wrap: wrap; gap: 8px;`)として並べてください。 +- プロバイダー別にブランドカラーを設定してください(例: Rapidgator=青 `#1976d2`, Katfile=オレンジ `#f57c00`, Nitroflare=赤 `#d32f2f`, Frdl=緑 `#388e3c`, Mediafire=紺 `#00539b`)。 +- 分割ファイルの場合は、ファイルパート番号(`Part 1`, `Part 2` 等)を自動判定してボタンに表記してください。 + +--- + +## 6. カバー画像表示規則(必須) + +- 記事内のカバー画像・サムネイル(Pixhost, TurboImageHost, ブログ内画像等)は、本文中央にセンタリング配置してください。 +- サムネイル画像をクリックした際、高解像度の元画像ページ(例: Pixhost の `show` ページ等)を別タブで開けるようにアンカータグ(``)でラップしてください。 + +--- + +## 7. 既存XMLキャッシュとの連携および差分マージ規則(必須) + +- 各フィード処理では、起動時に該当ドメインサブディレクトリ内の既存 XML を読み込む `LoadExistingEntries` を実装してください。 +- 最新フォーマット識別タグ(例: `domain-format-vX`)を持つ記事は解析処理をスキップして高速に再利用してください。 +- サイト側の最新一覧から押し出された過去記事も、重複排除(URLおよびGUIDによるチェック)を行った上でマージし、フィード全体として最大件数(50〜100件程度)を安定して保持してください。 diff --git a/rss-generator/Class/Jpfiles/jpfiles.cs b/rss-generator/Class/Jpfiles/jpfiles.cs index 8e90521..6b65836 100644 --- a/rss-generator/Class/Jpfiles/jpfiles.cs +++ b/rss-generator/Class/Jpfiles/jpfiles.cs @@ -29,7 +29,7 @@ internal class jpfiles /// /// キャッシュ判定用の最新フォーマット識別子です。 /// - private const string CacheFormatTag = "jpfiles-format-v1"; + private const string CacheFormatTag = "jpfiles-format-v2"; #endregion @@ -166,17 +166,20 @@ internal class jpfiles contentHtml = contentTextElem.GetString() ?? string.Empty; } - // 公開日時 (date_gmt または date) - var pubDate = DateTimeOffset.UtcNow; - if (postElem.TryGetProperty("date_gmt", out var dateGmtElem) && - DateTimeOffset.TryParse(dateGmtElem.GetString(), out var parsedGmt)) + // 公開日時 (date または date_gmt) を日本時間 (JST = UTC+9) として厳密に解釈 + var pubDate = DateTimeOffset.Now; + if (postElem.TryGetProperty("date", out var dateElem) && + DateTime.TryParse(dateElem.GetString(), out var parsedLocal)) { - pubDate = parsedGmt; + // date はサイト現地時刻(日本時間相当の文字列)のため JST (+09:00) として解釈 + pubDate = new DateTimeOffset(parsedLocal, TimeSpan.FromHours(9)); } - else if (postElem.TryGetProperty("date", out var dateElem) && - DateTimeOffset.TryParse(dateElem.GetString(), out var parsedDate)) + else if (postElem.TryGetProperty("date_gmt", out var dateGmtElem) && + DateTime.TryParse(dateGmtElem.GetString(), out var parsedGmt)) { - pubDate = parsedDate; + // date_gmt は GMT/UTC のため UTC として設定後に JST (+09:00) へ変換 + var utcDate = DateTime.SpecifyKind(parsedGmt, DateTimeKind.Utc); + pubDate = new DateTimeOffset(utcDate).ToOffset(TimeSpan.FromHours(9)); } if (string.IsNullOrWhiteSpace(articleUrl) || string.IsNullOrWhiteSpace(rawTitle)) @@ -184,6 +187,9 @@ internal class jpfiles continue; } + // プロジェクト共通仕様に基づく一意な GUID (SHA512ハッシュ) の生成 + var guid = CmnUtil.CreateGuid(articleUrl); + // 既存キャッシュの確認 if (existingEntries.TryGetValue(articleUrl, out var cached) && !string.IsNullOrWhiteSpace(cached.SummaryHtml) && @@ -193,7 +199,7 @@ internal class jpfiles cached.Title, cached.SummaryHtml, new Uri(articleUrl), - articleUrl, + guid, cached.LastUpdatedTime) { PublishDate = cached.PublishDate @@ -212,7 +218,7 @@ internal class jpfiles article.CleanTitle, summaryHtml, new Uri(article.Url), - article.Url, + guid, article.PublishDate) { PublishDate = article.PublishDate @@ -224,7 +230,8 @@ internal class jpfiles // 既存フィードのうち API に含まれなかった未重複記事をマージ(最大100件まで保持) foreach (var kvp in existingEntries) { - if (items.Any(i => i.Id == kvp.Key)) + var oldGuid = CmnUtil.CreateGuid(kvp.Key); + if (items.Any(i => i.Id == oldGuid || i.Links.Any(l => l.Uri.ToString().Equals(kvp.Key, StringComparison.OrdinalIgnoreCase)))) { continue; } @@ -233,7 +240,7 @@ internal class jpfiles kvp.Value.Title, kvp.Value.SummaryHtml, new Uri(kvp.Key), - kvp.Key, + oldGuid, kvp.Value.LastUpdatedTime) { PublishDate = kvp.Value.PublishDate @@ -577,7 +584,7 @@ internal class jpfiles // コンテナ開始(スタイル定義) sb.AppendLine($"
"); - // 1. バッジ・タグ表示 + // 1. バッジ・タグ表示および公開日時(日本時間) sb.AppendLine("
"); sb.AppendLine(" JPFILES.NET"); @@ -586,6 +593,7 @@ internal class jpfiles sb.AppendLine($" {WebUtility.HtmlEncode(article.CategoryTag)}"); } + sb.AppendLine($" 📅 {article.PublishDate:yyyy/MM/dd HH:mm:ss} (JST)"); sb.AppendLine("
"); // 2. コピー用フォルダ名枠(クリックで全選択できるワンクリックコピー仕様)