Skillget

hermes-desktop-guide

agent
Security Audit
Warn
Health Warn
  • 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 Warn
  • process.env — Environment variable access in astro.config.mjs
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

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

Reviews (0)

No results found