更新: GUIDのSHA512ハッシュ化統一、日本時間(JST)パース修正、およびAGENTS.mdへの共通フィード出力規則の明文化
This commit is contained in:
1 parent
d2f3bb4a6e
commit
39eb1fef31
2 files changed
+131
-14
No files matched your search
@@ -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件程度)を安定して保持してください。
|
||||||
@@ -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. コピー用フォルダ名枠(クリックで全選択できるワンクリックコピー仕様)
|
||||||
|
|||||||
Reference in new issue
Block a user