Skillget

hermes-desktop-guide

agent
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: CC-BY-4.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Uyari
  • process.env — Environment variable access in astro.config.mjs
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Hermes Desktop（Nous Research 製デスクトップ AI エージェント）の非公式日本語ガイド。Obsidian Vault を正本に Astro Starlight で静的サイト化。

README.md

Hermes Desktop ガイド

Hermes Desktop ガイド

公開サイト: https://hermes.ai-deck.app

Hermes Desktopの導入、基本操作、設定、安全な運用、問題解決を日本語でまとめた非公式ドキュメントサイト。Obsidian Vaultを正本に、Astro Starlightで静的サイト化する。

特徴

  • Pagefindによる本文・見出し・タグの全文検索
  • モバイル対応のサイドバー、目次、ダークモード
  • キーボード操作と支援技術に配慮したStarlight標準UI
  • frontmatter slugによるフォルダ構成と独立した恒久URL
  • Obsidian WikiLinkとコールアウトの自動変換
  • frontmatter必須項目・slug形式・basename/slug重複・未解決WikiLinkをビルド前に検出
  • 「実機・内容確認日」「対応バージョン／コミット」の表示

技術スタック

  • Astro 6
  • Astro Starlight
  • Pagefind
  • TypeScript
  • Biome
  • Cloudflare Workers（Static Assets / Workers Builds）

本番サイトはhttps://hermes.ai-deck.appで公開中。mainへpushするとWorkers Builds（GitHub連携）が自動でビルド・デプロイする。

必要要件

  • Node.js >= 22.12.0

セットアップ

npm install

記事の正本はリポジトリ内のvault/にある。ObsidianでこのフォルダをVaultとして開けば、サイトと同じリポジトリでコンテンツを編集できる。

コマンド

コマンド 内容
npm run dev 開発サーバーを起動
npm run build 本番ビルドとPagefindインデックス生成
npm run preview ビルド結果をローカルプレビュー
npm run preprocess Vaultを検証してsrc/content/docs/・src/content/tutorials/へ変換
npm run validate:content コンテンツ変換と前処理テスト
npm run lint Biomeチェック
npm run format Biomeで整形
npm run check Astro型チェック
npm test 前処理の自動テスト
npm run check:links ビルド済み内部リンク・アンカーを検査
npm run quality Lint、型、テスト、ビルド、リンク検査を一括実行
npm run deploy ビルドしてCloudflare Workersへ手動デプロイ
npm run cf:preview ビルドしてwrangler devでローカル確認

コンテンツパイプライン

vault/                      Obsidian Vault、コンテンツの正本
    ↓ npm run preprocess
scripts/preprocess.ts       frontmatter・slug・WikiLink・コールアウトを検証変換
    ↓
src/content/docs/           生成物、gitignore対象。Starlightが直接ルーティング
src/content/tutorials/      生成物。09_入門コース・10_概念解説・11_実践レシピの出力先で、
                            src/pages/learn|concepts|recipes/[...slug].astro が描画する
    ↓
Astro Starlight             ルーティング、ナビ、目次、検索、SEO
    ↓
dist/                       静的サイトとPagefindインデックス

どちらの出力先も毎回全削除して再生成するため、直接編集しない。

Vault構成

00_ホーム.md
02_基本操作/
03_設定/
04_ガイド/
05_トラブルシューティング/
06_リファレンス/
07_ダッシュボード/
08_連携/
09_入門コース/
10_概念解説/
11_実践レシピ/

フォルダとファイルの数字はObsidian内の並び順にだけ使う。公開URLはfrontmatter slugから生成する。

03_設定/12_MCP.md → /settings/mcp/
04_ガイド/01_推奨設定プリセット.md → /guides/recommended-presets/
09_入門コース/01_Hermes Desktopの世界.md → /learn/world/

frontmatter

---
title: MCP
description: Hermes DesktopでMCPサーバーを設定する方法と安全上の注意。
slug: settings/mcp
sidebar:
  order: 12
tags: [hermes, settings, mcp]
audience: [Hermes Desktop利用者]
platforms: [macOS, Windows, Linux]
status: verified
hermes_version: 0.22.1
hermes_commit: '297552a9'
verified: '2026-10-15'
---
  • title、description、slugは必須
  • slugはASCII小文字、数字、ハイフン、/だけを使う
  • sidebar.orderはサイドバーと索引の表示順。ファイル名の数字接頭辞とは独立している
  • hermes_commitは引用符付きの8桁で書く。引用符なしや7桁だとYAMLが数値・指数表記として解釈しうる
  • draft: trueのページは本番ビルドから除外される
  • statusはverifiedまたはneeds-review
  • 内容のない準備中ページは公開しない

画像

画像はsrc/assets/に置き、viteエイリアス経由で参照する。Astroが最適化してWebPで配信する。

![](@editorial/editorial-05-girl-subagents.webp)
![設定 > モデル 画面](@screenshots/settings-models.webp)

@editorialはsrc/assets/editorial/（挿絵）、@screenshotsはsrc/assets/screenshots/（実機スクリーンショット）を指す。スクリーンショットの一覧と撮影条件はsrc/assets/screenshots/manifest.mdにまとめている。

バージョン追従

Hermes Desktopの新バージョンへの追従は.claude/skills/hermes-version-update/の手順を正本とし、scripts/hermes-audit/のスクリプト群（差分抽出、frontmatterの一括更新、画像参照とピンの整合チェック、実機スクリーンショットの撮影・加工）で行う。

WikiLink

パス付きWikiLinkを基本とする。

[[03_設定/12_MCP|MCP]]
[[03_設定/08_詳細#実行バックエンド|隔離バックエンド]]

basenameだけのリンクはVault全体でファイル名が一意な場合のみ解決できる。basename重複、slug重複、未解決リンクは前処理を失敗させる。

コールアウト

Obsidian記法をStarlight Asideへ変換する。

> [!warning] 注意
> 実行内容を確認してください。

対応type:

  • note / info / important
  • warning / caution
  • danger / error
  • tip

URLとSEO

旧番号付きURLはastro.config.mjsで恒久URLへリダイレクトする。本番ドメインhttps://hermes.ai-deck.appをsiteに設定済みで、canonical、OGP絶対URL、sitemap（/sitemap-index.xml）が有効。public/robots.txtがsitemapを参照する。

デプロイ

Cloudflare Workers（Static Assets）にWorkers Builds（GitHub連携）でデプロイする。mainへpushすると本番デプロイ、非本番ブランチはnpx wrangler versions uploadでプレビューが作られる。公開URLはカスタムドメインhttps://hermes.ai-deck.app。ローカルから手動デプロイする場合はnpm run deploy（astro build && wrangler deploy）。

貢献

誤りの指摘・修正を歓迎する。

  • 気軽な報告: Issue または X（@nagataku_ai）
  • 直接修正: Pull Request。編集対象はvault/配下のみ（src/content/docs/は自動生成の中間生成物のため編集しない）
  • 設定値・既定値の変更報告には、確認したアプリのバージョン（設定 > 情報）を添えてもらえると検証が速い
  • PR前にnpm run qualityを実行すると、リンク切れやfrontmatter不備を事前に検出できる

ライセンス

このリポジトリは内容の種類ごとに異なる扱いを併用する。適用範囲と除外の正本はLICENSING.md。

  • 技術ドキュメント（vault/配下の解説本文と図版）: CC BY 4.0（クリエイティブ・コモンズ 表示 4.0 国際）
  • ソースコード（scripts/、src/、設定ファイル）: MIT License
  • 著者・ブランド・集客に関する素材（著者/サービス紹介、ロゴ・サイト名等のブランド要素、広告・アフィリエイト関連の記述）: 権利留保（All Rights Reserved。CC BY 4.0 の対象外）

「権利留保」は3つ目のライセンスではなく、ライセンスを付与しない既定の状態を指す。詳細はLICENSING.mdを参照。

© 2026 Taku Nagai（ながたく）

Hermes DesktopはNous Researchの製品であり、本リポジトリはコミュニティによる非公式の日本語ガイドである。最新かつ正確な情報は公式ドキュメントを参照すること。

Yorumlar (0)

Sonuc bulunamadi