完全版 Granvas 1.0 公式ドキュメント 対応実装: Granvas v0.1 Release Candidate
このページの目次

WRITE THOUGHTS. SEE STRUCTURE.

思考を書く。
構造が見える。

Granvasは、自然な文章と最小限の記法から思考のグラフを映し出すWebエディターです。文章を壊さず、テキストとグラフの両側から意味を育てられます。

正本テキスト
投影グラフ

グラフの操作も、現在のテキストへの最小編集として反映されます。

このドキュメントの位置づけ

これは「Granvas 1.0 公式ドキュメント — 完全版」です。説明対象はPhase 8 / 9までを完了したGranvas v0.1 Release Candidateです。ドキュメントのedition 1.0は製品version 1.0を意味せず、製品versionはv0.1.0です。

01

QUICK START

はじめる

Vercelで公開中のGranvasをブラウザーで開けば、インストールせずに利用できます。ローカルで動かす場合はBunを用意し、次の3行を実行してください。

1

取得する

GitHubからGranvasを複製します。

2

準備する

Bunで依存関係をインストールします。

3

開く

表示されたローカルURLをブラウザーで開きます。

git clone https://github.com/dayaa-arch/granvas.git
cd granvas
bun install && bun run dev
対応環境

Chromium、Firefox、WebKitの3ブラウザーで検証しています。プロジェクトファイルはブラウザーから読み込み・ダウンロードします。サーバーへの自動保存、ログイン、tracking、外部API通信はありません。

02

WORKSPACE

画面の見方

左のテキストが正本、右のグラフが現在の投影です。中央の区切りをドラッグするか、矢印キーで表示幅を調整できます。

左に日本語のテキストエディター、右に対応する思考グラフを表示したGranvasのワークスペース
実際の日本語UIテキストの宣言とグラフのNodeが同じ意味構造を表します。
A

テキスト

文章とGranvas Notationを同じエディターで編集します。通常の文章はそのまま残ります。

B

グラフ

Node、Relation、Groupを自動配置します。座標は保存せず、意味だけを扱います。

C

状態バー

ダウンロード状態、リビジョン、Node / Relation / 診断の件数を確認できます。

テキストとグラフを行き来する

  • グラフのNodeを選ぶと、対応する宣言がテキスト側で選択されます。
  • テキストのNode宣言へカーソルを置くと、対応するNodeが強調されます。
  • 入力途中に診断が出ても、正常に解釈できたグラフは表示を維持します。
03

GRANVAS NOTATION

記法を書く

すべてを記法にする必要はありません。通常の文章に、構造として見たい行だけを加えます。

NODE

Nodeを宣言する

[Type @id] Labelで1つのNodeになります。Typeは英字から始め、Explicit IDは必要なNodeだけに付けます。

[problem @scattered] 顧客情報が分散している
[idea @unify] AIでメモと構造を統合する
NESTED RELATION

親子関係を書く

親Nodeの下に半角スペース2個のインデントと->を書きます。さらに深くする場合も2個ずつ増やします。

[problem] 顧客情報が分散している
  -> [cause] ファイルが部署ごとに分かれている
    -> [evidence] 更新時期が異なる
CROSS RELATION

離れたNodeをつなぐ

Explicit ID同士を接続し、任意のラベルを付けられます。

[idea @unify] AIで情報を統合する
[problem @scattered] 情報が分散している

@unify -> @scattered : 解決する
GROUP & LAYOUT

まとめ方と流れを指定する

{Group名}の下へNodeまたはID参照を書きます。Layoutは上から下のTBと左から右のLRです。

@layout flow LR

{調査}
  [todo @interview] インタビューを行う
  @scattered
大切な規則

Node Type、Explicit ID、->@layout flow TB|LRはASCIIで入力します。通常文やラベル、Group名には日本語を使えます。

04

CERTAINTY

確信度を残す

Typeとは別に、NodeとRelationへ確信度を付けられます。棄却した要素も消さず、検討の履歴として残します。

指定なし[idea]->
?未確定[?idea]?->
確定[!idea]!->
×棄却[~idea]~->

たとえば、確定した案から未確定の効果を伸ばす[!idea] 案 ?-> [effect] 効果も有効です。NodeとRelationの確信度は互いに独立しています。

05

GRAPH AUTHORING

グラフから編集する

グラフは読み取り専用ではありません。操作は現在のテキストへの最小編集に変換され、再解析後のグラフへ反映されます。

Nodeを選択し、子Nodeの追加、接続、構造変更、確信度変更、削除を行える日本語のグラフ操作バー
意味を編集する選択中のNodeに対する操作がグラフ上部に表示されます。
操作方法テキストへの反映
Nodeを作成空白をダブルクリック、または「Nodeを作成」新しいNode宣言を追加
ラベル / TypeNodeをダブルクリック、またはF2 / Shift+F2対象トークンだけを置換
子Nodeを追加Nodeを選び「子Nodeを追加」Nested Relationを追加
接続接続点をドラッグ、または「接続」Cross Relationを追加
構造を変更別Node / Group / 空白へドラッグ親子関係またはGroup所属を変更
削除対象を選びDelete / Backspace影響範囲を確認後、対応する宣言を削除
Undo

グラフから適用した1回の操作は、テキストエディターで1回のUndoとして元に戻せます。通常文を含むテキスト全文をグラフから再生成することはありません。

06

PROJECTS & EXPORT

プロジェクトを手元に残す

ブラウザー内の自動永続化はありません。続きから編集するには、.granvasをダウンロードしてください。

.granvas、SVG、PNG、PDFを選択できる日本語のダウンロードダイアログ
ダウンロード再編集用と共有用の形式を選びます。
再編集

.granvas

UTF-8の正本テキストです。「プロジェクトを読み込む」から再開できます。

利用可能
共有

SVG

現在の有効なグラフ全体を、拡大可能なvector画像として書き出します。

利用可能
共有

PNG

グラフ全体を白背景の2倍解像度画像にします。各辺8192pxを上限とし、縮小時は通知します。

利用可能
配布

PDF

日本語を含むグラフ全体を、boundsに合う白背景の単一ページへ配置します。

利用可能

安全な作業の流れ

  1. 1
    「未ダウンロード」を確認

    状態バーに表示されている間は、端末へ最新の正本を残していません。

  2. 2
    .granvasをダウンロード

    ファイル名を入力し、.granvas形式を選びます。

  3. 3
    次回読み込む

    「プロジェクトを読み込む」でファイルを選択します。未ダウンロードの変更がある場合は確認が表示されます。

07

KEYBOARD & ACCESSIBILITY

キーボードで操作する

Tab

ペイン区切り、グラフのNode / Relation、ボタンへ順番に移動

EnterSpace

フォーカス中のNodeを選択

F2

Nodeのラベルを編集

Shift+F2

NodeのTypeを編集

DeleteBackspace

Node / Relationの削除内容を確認

Esc

編集中の入力やダイアログをキャンセル

ペイン区切りにフォーカスして表示幅を変更

Ctrl/⌘+Z

テキストとグラフからの編集をUndo

確信度は記号と日本語の読み上げ名でも伝え、色だけには依存しません。ダイアログはフォーカスを内部へ保ち、閉じた後は操作元へ戻します。日本語IMEの変換中にEnterで確定しても、意図しない編集確定を行いません。

08

DIAGNOSTICS & FAQ

診断とよくある質問

Notationとして始まった行に問題があると、該当範囲と行番号の横に日本語の診断が表示されます。

グラフにNodeが出てきません

Node宣言が[Type] Labelになっているか確認してください。Typeは英字から始め、閉じ角括弧とラベルを入力します。

Relationが表示されません

Nested Relationは半角スペース2個単位のインデントが必要です。Cross Relationは両方のExplicit IDが文書内に存在するか確認してください。

入力途中のエラーでグラフは消えますか

正常に解釈できたNodeやRelationは残ります。問題のある宣言だけが投影から省略され、修正すると再び反映されます。

グラフでNodeを動かした位置は保存されますか

保存されません。ドラッグは座標ではなく、親子関係やGroup所属を変える操作です。表示位置は意味構造から毎回計算します。

ブラウザーを閉じても作業は残りますか

自動では残りません。閉じる前に.granvasをダウンロードしてください。「未ダウンロード」の表示が目印です。

診断がある状態でもSVG / PNG / PDFを書き出せますか

書き出せます。各visual formatには正常に解釈できた現在のグラフだけが含まれます。正本全体を残すには.granvasもダウンロードしてください。

09

CURRENT STATUS

現在の制約

RELEASE

Granvas v0.1 Release Candidate

  • 日本語UIとText ⇄ Graph編集
  • .granvas Import / Download
  • SVG / PNG / PDF full-graph出力
  • Vercel static production
QUALITY

Phase 9の公開品質

  • Chromium / Firefox / WebKit E2E
  • WCAG 2.2 A / AA自動監査
  • performance budgetと依存license監査
  • CSP、outbound 0、secret / source map検査

プライバシー

この公式ガイドにはアクセス解析、追跡、cookie、入力フォーム、外部フォントを含めていません。Granvas v0.1にもバックエンド、アカウント、クラウド同期はありません。

セキュリティ

.granvasは最大5 MiBのUTF-8テキストとしてブラウザー内で処理します。脆弱性の報告方法はSECURITY.mdを確認してください。

START GRANVAS

文章から、思考の構造を育てる

アカウント登録なしで、ブラウザーからすぐに始められます。
Granvasを開く