更新: GUIDのSHA512ハッシュ化統一、日本時間(JST)パース修正、およびAGENTS.mdへの共通フィード出力規則の明文化

This commit is contained in:
armonica committed 2026-11-11 17:49:40 +09:00
1 parent d2f3bb4a6e
commit 39eb1fef31
2 files changed
+131 -14

No files matched your search

+109
View File
@@ -11,6 +11,9 @@ RSSフィード(XMLファイル)を出力する際は、`output` ディレ
### 1.1 命名規則および具体例 ### 1.1 命名規則および具体例
- 対象サイトのドメイン名(FQDN)またはサービス識別子をサブディレクトリ名として使用します。 - 対象サイトのドメイン名(FQDN)またはサービス識別子をサブディレクトリ名として使用します。
- `ryuugames.com` → `output/ryuugames.com/ryuugames.xml` - `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/...` - `pixiv.net` → `output/pixiv.net/...`
- `x.com` → `output/x.com/...` - `x.com` → `output/x.com/...`
- `e-hentai.org` → `output/e-hentai.org/...` - `e-hentai.org` → `output/e-hentai.org/...`
@@ -34,3 +37,109 @@ RSSフィード(XMLファイル)を出力する際は、`output` ディレ
filter24Hours: false); filter24Hours: false);
``` ```
- 既存XMLファイルを読み込むキャッシュ処理(`LoadExistingEntries` 等)を実装する場合も、`CmnUtil.GetExportXmlPath(fileName, addDir)` を使用して該当ドメインサブフォルダ内のXMLファイルを探索・読み込んでください。 - 既存XMLファイルを読み込むキャッシュ処理(`LoadExistingEntries` 等)を実装する場合も、`CmnUtil.GetExportXmlPath(fileName, addDir)` を使用して該当ドメインサブフォルダ内のXMLファイルを探索・読み込んでください。
---
## 2. GUID(一意識別子)の標準ハッシュ化規則(必須)
各記事エントリの一意識別子(RSS 2.0 の `<guid isPermaLink="false">`、`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フィード内の `<pubDate>` は、**必ず正確な日本時間(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
<span style="font-size: 11px; color: #6c757d; font-weight: bold;">📅 2026/11/11 11:22:27 (JST)</span>
```
---
## 4. タイトル整形および Windows フォルダ名用タイトルの提供規則(必須)
ユーザーが記事タイトルをそのままWindowsの保存用フォルダ名として利用できるよう、以下の整形処理とワンクリックコピー枠を必ず提供してください。
### 4.1 タイトル整形仕様
1. **Windows 禁止文字の全角置換**:
`\ / : * ? " < > |` は必ず全角文字 `¥ / : * ? ” < > |` に置換してください。
2. **タイトル構成フォーマット**:
原則として `[サークル名・発売元・カテゴリ・品番] タイトル (バージョン情報)` の形式に整形してください。
### 4.2 本文最上部へのワンクリックコピー枠の配置
本文(SummaryHtml)の先頭に、クリックするだけで文字列全体が選択(`onclick="this.select();"`)される入力欄を必ず配置してください:
```html
<div style="margin-bottom: 16px; background-color: #f8f9fa; border: 1px solid #ced4da; border-radius: 6px; padding: 10px;">
<div style="font-size: 11px; color: #6c757d; font-weight: bold; margin-bottom: 4px;">📁 フォルダ名用タイトル(クリックで全選択)</div>
<input type="text" readonly value="{WebUtility.HtmlEncode(cleanTitle)}" onclick="this.select();" style="width: 100%; padding: 6px 10px; font-size: 13px; font-family: Consolas, monospace; background-color: #ffffff; border: 1px solid #adb5bd; border-radius: 4px; box-sizing: border-box; cursor: pointer; color: #212529;" />
</div>
```
---
## 5. ダウンロードリンクの直リンク化および直下グリッド配置規則(必須)
### 5.1 直リンク化の徹底
- 外部ストレージ・アップローダーへのリンクは、中継短縮URL(adfly等)や不要なサイト内中継ページを可能な限りバイパス・自動解決し、**目的のストレージ(Mediafire, Mega, Rapidgator, Katfile, Nitroflare, Frdl 等)のダウンロードページURLを直接出力してください**。
- ボタンではなく、RSSリーダー上で確実にクリック遷移可能な標準の `<a href="...">` タグで出力してください。
### 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` ページ等)を別タブで開けるようにアンカータグ(`<a href="元画像URL" target="_blank"><img src="サムネイルURL" /></a>`)でラップしてください。
---
## 7. 既存XMLキャッシュとの連携および差分マージ規則(必須)
- 各フィード処理では、起動時に該当ドメインサブディレクトリ内の既存 XML を読み込む `LoadExistingEntries` を実装してください。
- 最新フォーマット識別タグ(例: `domain-format-vX`)を持つ記事は解析処理をスキップして高速に再利用してください。
- サイト側の最新一覧から押し出された過去記事も、重複排除(URLおよびGUIDによるチェック)を行った上でマージし、フィード全体として最大件数(50〜100件程度)を安定して保持してください。
+22 -14
View File
@@ -29,7 +29,7 @@ internal class jpfiles
/// <summary> /// <summary>
/// キャッシュ判定用の最新フォーマット識別子です。 /// キャッシュ判定用の最新フォーマット識別子です。
/// </summary> /// </summary>
private const string CacheFormatTag = "jpfiles-format-v1"; private const string CacheFormatTag = "jpfiles-format-v2";
#endregion #endregion
@@ -166,17 +166,20 @@ internal class jpfiles
contentHtml = contentTextElem.GetString() ?? string.Empty; contentHtml = contentTextElem.GetString() ?? string.Empty;
} }
// 公開日時 (date_gmt または date) // 公開日時 (date または date_gmt) を日本時間 (JST = UTC+9) として厳密に解釈
var pubDate = DateTimeOffset.UtcNow; var pubDate = DateTimeOffset.Now;
if (postElem.TryGetProperty("date_gmt", out var dateGmtElem) && if (postElem.TryGetProperty("date", out var dateElem) &&
DateTimeOffset.TryParse(dateGmtElem.GetString(), out var parsedGmt)) 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) && else if (postElem.TryGetProperty("date_gmt", out var dateGmtElem) &&
DateTimeOffset.TryParse(dateElem.GetString(), out var parsedDate)) 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)) if (string.IsNullOrWhiteSpace(articleUrl) || string.IsNullOrWhiteSpace(rawTitle))
@@ -184,6 +187,9 @@ internal class jpfiles
continue; continue;
} }
// プロジェクト共通仕様に基づく一意な GUID (SHA512ハッシュ) の生成
var guid = CmnUtil.CreateGuid(articleUrl);
// 既存キャッシュの確認 // 既存キャッシュの確認
if (existingEntries.TryGetValue(articleUrl, out var cached) && if (existingEntries.TryGetValue(articleUrl, out var cached) &&
!string.IsNullOrWhiteSpace(cached.SummaryHtml) && !string.IsNullOrWhiteSpace(cached.SummaryHtml) &&
@@ -193,7 +199,7 @@ internal class jpfiles
cached.Title, cached.Title,
cached.SummaryHtml, cached.SummaryHtml,
new Uri(articleUrl), new Uri(articleUrl),
articleUrl, guid,
cached.LastUpdatedTime) cached.LastUpdatedTime)
{ {
PublishDate = cached.PublishDate PublishDate = cached.PublishDate
@@ -212,7 +218,7 @@ internal class jpfiles
article.CleanTitle, article.CleanTitle,
summaryHtml, summaryHtml,
new Uri(article.Url), new Uri(article.Url),
article.Url, guid,
article.PublishDate) article.PublishDate)
{ {
PublishDate = article.PublishDate PublishDate = article.PublishDate
@@ -224,7 +230,8 @@ internal class jpfiles
// 既存フィードのうち API に含まれなかった未重複記事をマージ(最大100件まで保持) // 既存フィードのうち API に含まれなかった未重複記事をマージ(最大100件まで保持)
foreach (var kvp in existingEntries) 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; continue;
} }
@@ -233,7 +240,7 @@ internal class jpfiles
kvp.Value.Title, kvp.Value.Title,
kvp.Value.SummaryHtml, kvp.Value.SummaryHtml,
new Uri(kvp.Key), new Uri(kvp.Key),
kvp.Key, oldGuid,
kvp.Value.LastUpdatedTime) kvp.Value.LastUpdatedTime)
{ {
PublishDate = kvp.Value.PublishDate PublishDate = kvp.Value.PublishDate
@@ -577,7 +584,7 @@ internal class jpfiles
// コンテナ開始(スタイル定義) // コンテナ開始(スタイル定義)
sb.AppendLine($"<div style=\"font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif; line-height: 1.6; color: #212529; max-width: 800px; margin: 0 auto;\">"); sb.AppendLine($"<div style=\"font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif; line-height: 1.6; color: #212529; max-width: 800px; margin: 0 auto;\">");
// 1. バッジ・タグ表示 // 1. バッジ・タグ表示および公開日時(日本時間)
sb.AppendLine(" <div style=\"margin-bottom: 12px;\">"); sb.AppendLine(" <div style=\"margin-bottom: 12px;\">");
sb.AppendLine(" <span style=\"display: inline-block; background-color: #1a237e; color: #ffffff; padding: 3px 8px; font-size: 11px; font-weight: bold; border-radius: 4px; margin-right: 6px;\">JPFILES.NET</span>"); sb.AppendLine(" <span style=\"display: inline-block; background-color: #1a237e; color: #ffffff; padding: 3px 8px; font-size: 11px; font-weight: bold; border-radius: 4px; margin-right: 6px;\">JPFILES.NET</span>");
@@ -586,6 +593,7 @@ internal class jpfiles
sb.AppendLine($" <span style=\"display: inline-block; background-color: #37474f; color: #ffffff; padding: 3px 8px; font-size: 11px; font-weight: bold; border-radius: 4px; margin-right: 6px;\">{WebUtility.HtmlEncode(article.CategoryTag)}</span>"); sb.AppendLine($" <span style=\"display: inline-block; background-color: #37474f; color: #ffffff; padding: 3px 8px; font-size: 11px; font-weight: bold; border-radius: 4px; margin-right: 6px;\">{WebUtility.HtmlEncode(article.CategoryTag)}</span>");
} }
sb.AppendLine($" <span style=\"display: inline-block; font-size: 11px; color: #6c757d; font-weight: bold; margin-left: 4px;\">📅 {article.PublishDate:yyyy/MM/dd HH:mm:ss} (JST)</span>");
sb.AppendLine(" </div>"); sb.AppendLine(" </div>");
// 2. コピー用フォルダ名枠(クリックで全選択できるワンクリックコピー仕様) // 2. コピー用フォルダ名枠(クリックで全選択できるワンクリックコピー仕様)