EchoPace ユーザーガイド

デスクトップアプリ EchoPace（現行バージョン 2.7.7）向けです。

EchoPace は日常のデザインとデータ作業を一つのウィンドウにまとめます：パス描画、ワークフロー実行、表の閲覧、データベース接続、HTTP、ローカル AI アシスタント、フォルダ内の音声クリップと合成。モジュール名は英語のまま。UI 言語は環境設定で変更できます。

1. 起動方法

Windows

1. EchoPace.exe をダブルクリック。インストーラや展開は不要です。
2. 「Windows によって PC が保護されました」と出たら 詳細情報 → 実行。未署名ビルドでよくある表示で、破損ではありません。
3. 黒いコンソールは出ません。ウィンドウを閉じると終了します。

exe は任意のフォルダに置けます。ショートカット切れを避けるため、場所は固定してください。

macOS

1. DMG を開き、EchoPace を Applications にドラッグ。
2. 初回起動がブロックされたら：システム設定 → プライバシーとセキュリティ → このまま開く（ad-hoc 署名・公証なし）。
3. Launchpad または「アプリケーション」から開きます。通常の .app なので黒いターミナルは出ません。

2. ウィンドウ構成

ウィンドウ
├── ウィンドウトップバー    EchoPace マーク · モジュールタブ（サイドバー非表示時）· セカンダリ切替 · 環境設定
├── モジュールサイドバー    左約 200px のモジュール一覧
├── ワークスペース
│   ├── レフトレール     現在モジュールのリソース（レフトレールタブ）
│   ├── プライマリペイン  キャンバス / 表 / グラフ / チャット
│   └── セカンダリペイン  検査・書き出し・ノード属性など（トップバーから隠せます）
└── ステータスバー        最下行：ライセンス / 更新とステータス

• モジュールサイドバー でモジュール名をクリックして切替。サイドバーを畳むと、同じ項目がウィンドウトップバーのモジュールタブに出ます。
• プライマリ / セカンダリ各ペインに、ペイントップバー・ペインタブ・中域・ペインボトムバーがあります。
• トップバーの歯車は 環境設定。
• ステータスバー右のベル / 盾は ライセンス・開通済み・さらに開通 を開きます。

3. 初回：ライセンス

ライセンス未入力時は GeoCanvas と OtterDrive のみ。他モジュールはサイドバーでロック表示になります。

1. ステータスバーのライセンス入口を開く。
2. ライセンス（または さらに開通）で 5日間の試用/更新を申請 をクリック。本機 MAC とプラットフォームを送り、App ID / App Secret を受け取り暗号化保存したうえでサーバー確認します。同一資格情報は作成から半年以内、5 日更新を回数無制限で自己申請できます。
3. 管理者から受け取った App ID / App Secret を貼り付けて保存しても構いません。
4. 確認成功後、開通済み に本ビルドの全モジュールが一覧されます。解錠済みはクリック可、未解錠はロック。
5. App ID / App Secret はディスク上で暗号化され、平文では保存されません。

オフライン時：前回成功した確認結果を再利用し、開通済みモジュールは使えます。約 2 週間ライブ確認がないと起動時に再案内が出ます。オンラインで確認するか、再度 5日間の試用/更新を申請 してください。

長期ライセンス、または自己申請ウィンドウ（作成から半年）終了後は、同じダイアログの さらに開通 から support@mossboat.dev へメールしてください。本文に App ID を必ず含めてください（ページ内でコピー可。未取得なら先に試用申請）。サポートはサーバー上でアカウントを特定するために App ID が必要です。

4. 環境設定

ウィンドウトップバーの歯車 → 環境設定。

保存 でモジュール一覧を確定。言語は一般タブで即時反映されます。

5. GeoCanvas — パス · SVG · 計測

ベクトル描画、寸法計測、ビットマップのトレース、アイコン書き出し。

レフトレール

• デザイン：ツール、アートボード、ページ、レイヤー。
• 計測：サイズ・幾何。図形を選ぶと幅・高さ・面積など。

プライマリペインタブ

• ボード：キャンバスで描画。レフトレール ツール：選択、ペン、矩形、楕円、多角形、星、正多角形、矢印、チェック、クロス、番号、テキスト。
• パス：ノード編集、ブール演算、簡略化など。
• プレビュー：選択を描画。書き出し… / SVG を書き出し で 書き出し背景：透明 / 黒 / 白 / カスタム色。

ペイントップバーの例：SVG を読み込み、画像を読み込み、画像をトレース、画像をコピー。

セカンダリペイン

• アウトライン：レイヤー一覧。
• 選択：整列、分布、回転コピーなど。
• 色：線 / 塗り。

キャンバスのコツ

• スクロールでズーム、ドラッグでパン。プレビューでダブルクリックするとビューをリセット。
• 定規からガイドをドラッグ。ガイドを定規へ戻すと削除。ダイアログ越しに定規へクリックは通りません。
• アートボード背景：ペインボトムバー 背景。
• デザインはこのマシンに自動保存（§12）。

6. OtterDrive — ワークフロー · トリガー · モニター

ノードグラフでコマンドを組み、手動・スケジュール・ファイル投入で実行。

レフトレール

• プレイブック：ワークフローとプロジェクト。Demo plant / Nightly ingest、または新規。
• モニター：Workers と Queue（保留中のファイル投入）。

プライマリペイン

• グラフ：ノード配置。選択からリンク で接続。エッジ右クリックで削除。
• 実行：実行履歴。
• モニター：進捗と出力。

セカンダリペイン

• ノード：実行コマンド。
• トリガー：cron（5 フィールド）および/またはフォルダ投入。一致ファイルをドロップするとコピーしてキュー。
• 環境：プロジェクト / ワークフローの $ENV。

一度実行 で現在のグラフを走らせます。他マシンへの投入は Monitor → Workers で本機登録と Hub URL が必要。監視フォルダは移植可能なパスにしてください（Windows: %USERPROFILE%\Desktop\TAG、macOS / Linux: ~/Desktop/TAG）。

7. SilkQuery — Excel · CSV · SQLite · JSON

表ファイルをデータソースとして閲覧・絞り込み・クエリ構築・書き出し。ライセンス解錠が必要です。

レフトレール

ソース：ファイル、表、DB。+ で Excel / CSV / SQLite / JSON を追加。

プライマリペイン

• ワークシート：データ閲覧。
• スキーマ：フィールド一覧。
• サンプル：サンプルプレビュー。
• ビルダー：視覚的クエリ構築。

セカンダリペイン

• スクリプト：SQL / レシピ。
• 書き出し：ファイル出力。
• 履歴：書き出し履歴。

流れの例：ファイル追加 → ワークシートで確認 → ビルダーまたはスクリプト → 書き出し。

8. RapidDock — 接続 · SQL

リモート DB に接続しワークシートで結果を表示。ライセンス解錠が必要。接続ダイアログに列挙されるエンジン（PostgreSQL、MySQL、SQLite、SQL Server など）。

レフトレール

ソース：接続、表、DB。新規接続 でホスト / DB / アカウントを入れ、テスト後に表を閲覧。

プライマリ / セカンダリ

SilkQuery に近い構成。パスワードはローカル接続設定に保存。権限のある DB だけに接続し、設定ファイルを不用意に共有しないでください。

9. MintCall — リクエスト · コレクション

HTTP / WebSocket クライアント。ライセンス解錠が必要。

レフトレール

コレクション：リクエスト、フォルダ、プロジェクト。

プライマリペインタブ

Headers、Body、Auth、Query、Listen、Encrypt。メソッドと URL を設定して送信。

セカンダリペイン

応答プレビュー、タイムラインなど。同一プロジェクトで WebSocket も可。

管理者がローカル Playground を用意している場合は http://127.0.0.1:8765 を指してください。

10. MossNet — Ollama · クラウドモデル

プロジェクトファイルに対するチャット、編集、コマンド実行。ライセンス解錠が必要。ローカルモデルは Ollama の導入と起動が必要です。

レフトレール

• チャット：プロジェクトとセッション。作業ディレクトリを指定。
• ファイル：ファイルツリー。

プライマリペイン

• ワークスペース：チャット。モデル選択、ストリーム、キャンセル。
• ツール：呼び出し可能なツール。

セカンダリペイン

• トレース：ツール呼び出し。
• ドキュメント：説明 / プレビュー。
• ロールバック：チェックポイント（git ではありません）。

スキル：

.moss/skills/<名前>/SKILL.md

.cursor/skills/*/SKILL.md も認識。list_skills / read_skill でも読めます。

機微な操作は毎回確認または常に許可。作業ディレクトリ外は既定で制限されます。

11. AmberClip — フォルダ · 波形 · クリップ · 合成

フォルダ内の音声 / 動画 / 画像をカルーセルで選び、再生範囲を付け、順に合成して書き出します。ライセンスが必要です。動画ポスター・波形・書き出しには本機の ffmpeg が必要です（アプリと同じフォルダ、または PATH）。

左レール

• ソース：フォルダ（ドロップまたは参照）、ファイルツリー（件数とサイズ、ホバーで削除）。
• スナップショット：クリップ（スライサーの単一ファイル再生範囲）、合成（コンポジターの複数ファイル順と範囲）。

主領域タブ

• カルーセル：カードプレビュー（音声 / 動画は波形）。領域下バーで種類・並べ替え・フィルター。領域上バーで全選択 / なし / 反転。
• スライサー：波形でイン/アウトを付け、スナップショットのクリップ一覧に出します。
• コンポジター：複数ファイルの再生範囲と順序を並べ、合成一覧に出します。

副領域

• スクリプト：カルーセルに一致するファイルを別フォルダへ移す。
• 書き出し：選んだ合成から結合 WAV、または各スパンを書き出し。ffmpeg が必要。
• 履歴：書き出し履歴。副領域下バーで履歴をクリア。

典型：フォルダ追加 → カルーセルで絞り込み → スライサーと/またはコンポジター → 書き出し。

12. データの場所

インストール先には書き込みません。設定とモジュールデータは：

アプリだけコピーしてもデータは移りません。必要ならデータフォルダごとコピー。App Secret や DB パスワードを含むファイルを公開場所に置かないでください。

13. 更新

起動時にバックグラウンドで更新確認。ステータスに更新ヒントが出たらライセンス / 更新ダイアログを開いてください。本ガイドは 2.7.7 対応。

• Windows：新しい EchoPace.exe で上書き。
• macOS：新しい DMG から Applications へ再ドラッグ。

データフォルダは保持されます。

14. FAQ

モジュールが二つしか見えない？
ライセンス未入力、または該当モジュール未含む。ステータスから ライセンス を開き App ID / App Secret を入力。開通済み のロック行は未包含です。

ライセンス期限切れ？
まず 5日間の試用/更新を申請。半年ウィンドウ後は さらに開通 から support@mossboat.dev へ App ID 付きでメール。

UI が日本語でない？
環境設定 → 一般 → 言語 → 日本語。

セカンダリを隠して検査が見つからない？
ウィンドウトップバーでセカンダリを再表示。

GeoCanvas 書き出しに背景が付く？
プレビュー → 書き出し時に透明 / 黒 / 白 / カスタム。

MossNet にモデルがない？
Ollama を起動しモデルを pull（例：ollama pull …）、MossNet で一覧を更新。

AmberClip に波形がない、または書き出しに失敗？
ffmpeg を入れるか、ffmpeg をアプリと同じフォルダに置きます。

SmartScreen / 「開発元を確認できない」？
Windows：詳細情報 → 実行。macOS：プライバシーとセキュリティ → このまま開く。社内ポリシーで禁止の場合は IT に許可リスト依頼。

アートボードやワークフローを消した？
各モジュールの元に戻す、MossNet のチェックポイント。復旧できない場合、古いバックアップでデータフォルダ全体を安易に上書きしないでください。