日本語を含む技術文書、README、仕様書、コードコメントでは、文法だけでなく表記ゆれ、弱い表現、用語の揺れ、公文書ルール、Markdown構造の乱れも見落としやすくなります。otak-lspはVS CodeのLanguage Serverとして編集中の日本語を解析し、診断、品詞ハイライト、ホバー辞書を同じ編集画面で提供します。

クイックスタート

1. VS Code Marketplace からインストールします。
2. Markdown、プレーンテキスト、または対応言語のソースファイルを開きます。
3. 日本語を入力すると、文書変更に合わせて自動解析されます。
4. 必要に応じてコマンドパレットから otak-lsp: 現在のファイルを解析 を実行します。

手元のVSIXから入れる場合は、リポジトリでパッケージを生成してからインストールします。

npm install
npm run package
code --install-extension otak-lsp-1.0.26.vsix

主な機能

• 日本語文法チェック: 二重助詞、助詞連続、動詞と助詞の不整合、文体混在、ら抜き言葉、二重否定、ねじれ文などを検出します。
• 高度ルール57種: 表現、表記、約物、Markdown構造、公文書向けルールまで、実装済みの高度ルールをまとめて提供します。
• 校正ルール: 誤字、用語基準、表現洗練、字種統一、長さ、環境依存文字、約物、括弧、表記ゆれをカテゴリ別に制御できます。
• 公文書対応: 常用漢字外、「及び/並びに」「又は/若しくは」、箇条書き句点運用をチェックします。
• 技術用語の表記統一: JavaScript、GitHub、Node.js、AWS、Azure、OCI、生成AI関連語などの揺れを検出します。
• Markdown構造チェック: 見出しレベルの飛び、テーブル列数不一致、コードブロック言語指定欠落を検出します。
• セマンティックハイライト: 名詞、動詞、形容詞、助詞、副詞を品詞別に色分けします。
• ホバー情報: 形態素情報、読み、原形、Wikipediaサマリー、オフライン用語図鑑を表示します。
• 段階実行: 入力中は軽量ルール、アイドル時や保存時は全ルールを実行して体感速度を保ちます。
• 外部依存なし: kuromoji-optimizedとIPA辞書を同梱し、MeCabのセットアップなしで動作します。

仕組み

otak-lspはVS Code拡張のクライアントとTypeScript製Language Serverで構成されています。文書が開かれた、または変更されたタイミングで解析をスケジュールし、対象テキストを抽出してからkuromoji-optimizedで形態素解析します。

Markdownではコードブロック、URL、テーブル、リスト記号など、診断対象から外すべき範囲をスペース置換で除外します。文字数を保ったまま解析するため、診断位置とセマンティックトークンの位置が元テキストに戻せます。

対応シナリオ

コマンド

コマンドパレットから実行できます。ステータスバーの項目からON/OFFを切り替えることもできます。

設定

設定の完全な一覧は docs/configuration.md に自動生成されています。READMEには代表的な設定だけを載せています。

ルールの完全な一覧は docs/rules.md に自動生成されています。

ルールグループ

インライン抑制

一部の行だけ警告を消したい場合は、Markdownコメントや各言語のコメントに抑制ディレクティブを書きます。

<!-- otak-lsp-disable-next-line orthography-variant -- 法令用語をそのまま引用 -->
「及び」「並びに」「又は」「若しくは」は公用文の接続表現です。

行末で抑制することもできます。 <!-- otak-lsp-disable-line term-notation -->

ホバー用語図鑑

ホバーでは品詞、原形、読みを表示し、設定に応じてWikipediaサマリーとオフライン用語図鑑を追加します。Wikipedia取得に失敗しても、ホバー全体は壊れず、サマリー部分だけ省略されます。

用語図鑑カテゴリ（オフライン）

otakLsp.hover.enabledGlossaries で表示するカテゴリを選べます。

この一覧は同梱辞書データと一致しており、npm run audit:glossary で整合性を検証できます。設定型には整備中のカテゴリも含まれますが、データ提供までは表示対象になりません。

セキュリティとプライバシー

• MeCab不要: 形態素解析エンジンとIPA辞書を同梱しています。
• ローカル優先: 文法チェック、校正、用語図鑑はローカルで処理されます。
• Wikipediaは任意: otakLsp.hover.enableWikipedia が有効な場合のみ、ホバー対象語を日本語版Wikipedia REST APIへ問い合わせます。
• APIキー不要: 外部サービスのアカウントやAPIキーは必要ありません。
• テレメトリなし: 拡張機能独自の分析イベント送信は行いません。
• 大規模文書への上限: otakLsp.maxDocumentChars と otakLsp.maxNumberOfProblems で解析負荷を制御できます。

要件

• VS Code 1.60.0 以上
• 日本語テキストを含むMarkdown、プレーンテキスト、または対応言語のソースファイル
• Wikipediaホバーを使う場合のみネットワーク接続

トラブルシューティング

• 文法チェックが動かない: otakLsp.enableGrammarCheck が true か、対象ファイルの言語IDが otakLsp.targetLanguages に含まれているかを確認してください。
• セマンティックハイライトが表示されない: otakLsp.enableSemanticHighlight とVS Codeの editor.semanticHighlighting.enabled を確認してください。
• コードブロックやテーブルを対象外にしたい: otakLsp.markdown.analyzeCodeBlocks または otakLsp.markdown.analyzeTables を false にしてください。
• 特定ルールだけ無効化したい: 設定画面で該当する otakLsp.advanced.*、otakLsp.official.*、otakLsp.proofreading.* を false にしてください。
• 初回起動が遅い: 初回はkuromoji-optimizedの辞書ロードに数秒かかる場合があります。2回目以降は高速に動作します。

開発

npm install
npm run compile
npm test
npm run package

ドキュメント整合性は実装を真実源として検証します。

npm run docs:all
npm run check:consistency

品質評価

評価データとランナーは server/src/grammar/evals/ にあります。npm run evals:update-readme で以下のブロックを更新できます。

Detection Coverage

Last updated: 2026-06-29

関連拡張機能

odangoo のVS Code拡張機能:

ライセンス

MIT License のもとで公開しています。