更新: 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 命名規則および具体例
- 対象サイトのドメイン名(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 の `<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件程度)を安定して保持してください。