Files
rss-generator/AGENTS.md
T

146 lines
8.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# プロジェクト固有規則(rss-generator)
本プロジェクト(`rss-generator`)におけるコード記述およびフィード生成処理では、以下のプロジェクト固有規則を厳格に遵守してください。
---
## 1. ドメイン毎の出力先フォルダ分離規則(必須)
RSSフィード(XMLファイル)を出力する際は、`output` ディレクトリ直下に直接配置せず、**必ず対象サイトのドメイン名等に応じたサブディレクトリを作成し、その中にXMLファイルを出力してください**。
### 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/...`
- `momon-ga.com` → `output/momon-ga.com/...`
- `skebetter.com` → `output/skebetter.com/...`
- `danbooru` → `output/danbooru/...`
- `youtube` → `output/youtube/...`
### 1.2 実装方法(C#)
- フィード出力メソッド `CmnUtil.ExportXMLFileAsync` を呼び出す際は、必ず `addDir` 引数に対象ドメインサブディレクトリ名を指定してください。
```csharp
// 例: ryuugames.com の場合
private const string DomainDir = "ryuugames.com";
await CmnUtil.ExportXMLFileAsync(
fileName,
feed,
client,
addDir: DomainDir,
embedBase64: false,
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件程度)を安定して保持してください。