DeepSeek-Reasonix/README.ja-JP.md-代码预览-DeepSeek-Reasonix:基于 DeepSeek 的 AI 编码助手项目 - AtomGit

GGitHubdocs: add Japanese README (#2011 )

English · 简体中文 · 日本語 · 公式サイト · ガイド · アーキテクチャ · ベンチマーク · Discord

ターミナルで動く DeepSeek ネイティブの AI コーディングエージェント。

プレフィックスキャッシュの安定性を中心に設計されているため、長時間のセッションでもトークンコストを低く保ち、動かしっぱなしにできます。

Reasonix code mode — assistant proposes a SEARCH/REPLACE edit; nothing on disk until /apply

Tip

キャッシュの安定性はオンにする「機能」ではなく、ループそのものが前提として設計された不変条件です。 これこそが Reasonix が DeepSeek 専用である理由であり、すべてのレイヤーがバイト単位で安定したプレフィックスキャッシュの仕組みに合わせて調整されています。

Note

実ユーザーの1日（2026-05-01）: 入力トークン 4億3,500万、キャッシュヒット率 99.82%、同じワークロードを v4-flash でキャッシュなしに実行した場合の約 $61 に対して、わずか約 $12 で済んでいます — 詳しくはケーススタディを参照。キャッシュ可能なバイト列を提供するのは DeepSeek ですが、それを長時間のセッションにわたってキャッシュ可能に保つのが Pillar 1 の4つの仕組みです。

Important

Community · 加入社区 — セットアップのヘルプ（#help / #求助）、ワークフローのショーケース、機能アイデア、コントリビューター限定の PR 調整用チャンネルを備えたバイリンガル Discord。サーバー内で GitHub を認証すると、自動的に Contributor ロールが付与されます。→ https://discord.gg/XF78rEME2D

インストール

Node ≥ 22 が必要です。macOS · Linux · Windows（PowerShell · Git Bash · Windows Terminal）で動作します。

reasonix コマンドを PATH 上で使えるようにしたい場合は、Reasonix をグローバルにインストールします:

npm install -g reasonix
reasonix code my-project   # 初回実行時に DeepSeek API キーを貼り付け。以降は保存される

または、グローバルインストールせずに一度だけ実行することもできます:

cd my-project
npx reasonix code          # デフォルトでは常に最新のパッケージを使用

DeepSeek API キーを取得 → · フラグは reasonix code --help を参照。

Reasonix を毎日使うなら、グローバルインストールが最もシンプルな方法です。とりあえず試してみたいだけなら npx を使ってください。

キー入力を減らしたい？ より短い dsnix エイリアスが同じ CLI を指します:

npm install -g dsnix       # PATH 上に `dsnix` を公開。reasonix に依存
npx dsnix@latest code      # より短いコマンドで一度だけ実行

npm install -g reasonix でグローバルインストールすると dsnix のシムも PATH 上に配置されるため、2つは相互に置き換え可能です。

サブコマンドなしの reasonix（裸の reasonix）はカレントディレクトリで code を起動します — reasonix と入力するのは reasonix code と等価です。

コマンド	用途
`reasonix` / `reasonix code [dir]`	コーディングエージェント。ここから始めてください。
`reasonix chat`	プレーンなチャット — ファイルシステムやシェルのツールなし。
`reasonix run "task"`	一度だけ実行し、stdout にストリーミング。パイプ向き。
`reasonix doctor`	ヘルスチェック: Node、API キー、MCP の配線。
`reasonix update`	Reasonix 自体をアップグレード。

その他のサブコマンド（replay · diff · events · stats · index · mcp · prune-sessions）は reasonix --help と CLI リファレンスにあります。

QQ チャンネル

QQ は既存の chat、code、またはデスクトップのセッションをリモートチャンネルとして拡張できます。これは独立したランタイムモードではなく、現在のセッションフローの一部です。

CLI: セッションを開始し、/qq connect を実行
デスクトップ: Settings -> General -> QQ Channel を開く

接続すると、QQ のメッセージを現在のセッションに取り込み、アシスタントの返信を QQ に転送し、その後のやり取りをリモートで継続できます。

詳しいセットアップ、デスクトップのクイックスタート、トラブルシューティングは QQ チャンネルのセットアップを参照してください。

デスクトップクライアント（プレリリース）

同じループの GUI が欲しいユーザー向けのネイティブ Tauri クライアント。マルチタブ対応で、右パネルにはこのセッションでエージェントが読み取り・編集したファイルが表示され、下部には同じコスト / キャッシュ / トークンのメーターがリアルタイムで表示されます。同じ DeepSeek API キー、同じ ~/.reasonix 設定を使い、デスクトップ版は独自の Node ランタイムを同梱するため、別途 npm install する必要はありません。

各プラットフォームのインストーラーは GitHub Releases からダウンロードできます。デスクトップ版は プレリリース として提供されます: ループとプロトコルは CLI と同じですが、UI はまだ磨き込み中で、インストーラーはまだコード署名されていません。

macOS — 初回起動時に Gatekeeper に引っかかります。一度きりの対処: xattr -dr com.apple.quarantine /Applications/Reasonix.app（または右クリック → 開く → 確認）。
Windows — SmartScreen が「不明な発行元」と警告します。詳細情報 → 実行 をクリックしてください。
Linux — .deb と .AppImage はそのまま起動でき、追加の手順は不要です。

CLI が引き続き正規のインターフェースです。CLI に入った機能はすべてデスクトップのコンポーザーからも利用できます。

別のフォルダで作業する · chat と code の違い · スキルを書く

別のフォルダで作業する。 Reasonix はファイルシステムツールを起動ディレクトリにスコープします。対象を変えるには --dir を渡してください。セッション途中での切り替えは設計上サポートされていません（メモリのパスが古いルートと絡まってしまうため）— 一度終了して再起動してください。

npx reasonix code --dir /path/to/project

chat と code の選び方。 code がデフォルトであり、ファイルシステム / シェルツールと SEARCH/REPLACE レビューを備えた唯一のモードです。chat はより軽量でツールをオフにしたシェルです — MCP は接続しつつディスクアクセスのない思考のパートナーが欲しいときに使ってください。

得られるもの	`code`	`chat`
ファイルシステムツール + `edit_file`	✓	—
SEARCH/REPLACE → `/apply` レビュー	✓	—
シェルツール（ゲート付き）	✓	—
プランモード · `/todo` · `/skill new` · `/mcp add`	✓	—
メモリ（`remember` / `recall_memory`）	プロジェクト + グローバル	グローバルのみ
設定からの MCP サーバー · ウェブ検索 · `ask_choice`	✓	✓
コーディング用システムプロンプト	✓	汎用
セッションのスコープ	ディレクトリごと	共有デフォルト

最初のスキルを書く。 リモートレジストリはありません — 直接書きます。ファイル（description: フロントマター + 本文）を編集し、/skill list を実行します。本文をインライン展開する代わりに分離したサブエージェントループを生成するには runAs: subagent を追加します。

/skill new my-skill              # <project>/.reasonix/skills/my-skill.md
/skill new my-skill --global     # プロジェクト横断で使うなら ~/.reasonix/skills

Claude 形式のスキルも読み込まれます。 <project>/.claude/skills/<name>/SKILL.md と ~/.claude/skills/ が Reasonix のネイティブパスと並んで読み込まれるため、Claude 形式のスキルを出力するツールはそのまま動きます。例 — 上流アダプターなしで OpenSpec ワークフローを投入する:

npx openspec init --tools claude    # .claude/skills/openspec-*/SKILL.md を書き出す
/skill openspec-propose <task>      # その後 Reasonix から呼び出す

設定

~/.reasonix/config.json の1つの JSON ファイルと、<project>/.reasonix/ 配下のプロジェクトごとのオーバーライドで設定します。すべてのキー、すべてのスラッシュコマンド、スキル / メモリ / フックのオンディスク構造を網羅した完全なバイリンガルリファレンスはこちら:

📘 設定ガイド · 中文

トピック	概要
MCP サーバー	stdio · SSE · Streamable HTTP。1つの仕様形式が `config.json` と `--mcp` の両方で動作。
スキル	モデルが呼び出せる Markdown のプレイブック。`inline` または `subagent` モード。
メモリ	プレフィックスにピン留めされるユーザー専用の知識。`user` / `feedback` / `project` / `reference` の型。
フック	ライフサイクルイベント時のシェルコマンド。`PreToolUse`（ゲート） · `PostToolUse` · `UserPromptSubmit` · `Stop`。
権限	ワークスペースごとのシェル許可リスト。完全な前方一致。
ウェブ検索	デフォルトは Mojeek。`/search-engine` でセルフホストの SearXNG や Metaso に切り替え可能。
セマンティックインデックス	`reasonix index` — ローカルの Ollama または任意の OpenAI 互換の埋め込みエンドポイント。

Reasonix の何が違うのか

ループは3つの柱を中心に構成されています。それぞれが、汎用的なエージェントフレームワークには見えてすらいない問題を解決します — それらは別のキャッシュの仕組み向けに設計されているからです。

_{完全なアーキテクチャ解説はこちらから → Pillar 1 — キャッシュファーストのループ · Pillar 2 — ツール呼び出しの修復 · Pillar 3 — コスト制御}

機能

Reasonix capabilities — cell-diff renderer, MCP, plan mode, permissions, dashboard, persistent sessions, hooks/skills/memory, semantic search, auto-checkpoints, /effort knob, transcript replay, event log

比較

	Reasonix	Claude Code	Cursor	Aider
バックエンド	DeepSeek	Anthropic	OpenAI / Anthropic	任意（OpenRouter）
ライセンス	MIT	クローズド	クローズド	Apache 2
コストプロファイル	タスクあたり低コスト	プレミアム	サブスク + 従量	まちまち
DeepSeek プレフィックスキャッシュ	設計込み	該当なし	該当なし	偶発的
組み込みウェブダッシュボード	あり	—	該当なし（IDE）	—
設定可能なウェブ検索エンジン	`/search-engine`	—	—	—
ワークスペースごとの永続セッション	あり	一部	該当なし	—
プランモード · MCP · フック · スキル	あり	あり	あり	一部
ウェブ検索（Mojeek + SearXNG + Metaso）	あり	あり	あり	あり
オープンなコミュニティ開発	あり	—	—	あり

リアルタイムのキャッシュヒット率、コスト、手法については benchmarks/ を参照してください — 数値はモデルの料金とともに変動するため、README ではなくハーネスとともに置いています。

ドキュメント

アーキテクチャ — 3つの柱: キャッシュファーストのループ、ツール呼び出しの修復、コスト制御
CLI リファレンス — すべてのシェルサブコマンド、すべてのスラッシュコマンド、すべてのキーバインド
QQ チャンネルのセットアップ — CLI の初回接続フロー、デスクトップのエントリ、QQ Open Platform の認証情報
ベンチマーク — τ-bench-lite ハーネス、トランスクリプト、コスト算出手法
公式サイト — はじめに、ダッシュボードのモックアップ、TUI のモックアップ
コントリビューション — コメントポリシー、エラーハンドリングのルール、自作よりライブラリを優先
行動規範 · セキュリティポリシー

コミュニティ

Note

Reasonix はオープンソースであり、コミュニティによって開発されています。このファイル末尾の謝辞ウォールにあるすべてのアバターは、実際にマージされた PR です。

スコープが切られた入門用チケット — それぞれ背景、コードの参照ポイント、受け入れ基準、ヒント付き — は good first issue ラベルの下にあります。オープンなものなら何でも選んでください。

オープンな Discussions — 意見募集中:

#20 · CLI / TUI デザイン — 何が壊れていて、何が足りず、何を変えますか？
#21 · ダッシュボードデザイン — 提案中のモックアップへの反応をどうぞ
#22 · 今後の機能ウィッシュリスト — 次に Reasonix に組み込みたいものは？

すでに Reasonix を使っていて、他の人に広める手伝いをしてもいい？ ブログ記事、記事、スクリーンショット、講演、動画を Show and tell に公開してください。このプロジェクトにはマーケティング予算がありません — 新しいユーザーは口コミで見つけてくれます。継続的に応援してくれる人は、以下のバッジを獲得でき、付与されるとコントリビューターウォールの横に表示されます:

最初の PR の前に: CONTRIBUTING.md を読んでください — 短く厳格なルール（コメント、エラー、自作よりライブラリを優先）。tests/comment-policy.test.ts がコメントのルールを強制します。npm run verify がプッシュ前のゲートです。参加することで行動規範に同意したものとみなされます。セキュリティの問題は → SECURITY.md。

非目標

Important

Reasonix には明確な方針があります。あえて やらない ことがいくつかあります — あなたの作業に合ったツールを選べるよう、ここに挙げておきます。

マルチプロバイダーの柔軟性。 あえて DeepSeek 専用にしています。1つのバックエンドに密結合していることは制限ではなく機能です。
IDE 統合。 ターミナルファースト。差分は git diff に、ファイルツリーは ls にあります。ダッシュボードはあくまで補助であり、Cursor の代替ではありません。
最難関リーダーボードの推論。 Claude Opus はいまだに一部のベンチマークで勝っています。DeepSeek はコーディングで競争力がありますが、もしあなたの作業が「この認証バグを直す」ではなく「この博士課程レベルの証明を解く」ものなら、Claude から始めてください。
エアギャップ / 完全無料。 Reasonix には有料の DeepSeek API キーが必要です。エアギャップ環境やゼロコストでの実行には Aider + Ollama または Continue を参照してください。

スター履歴

サポート

Reasonix が役に立って、お礼を言いたいと思ったらどうぞ。これはあくまでコーヒー一杯であって契約ではありません — 寄付で機能の優先順位が買えるわけでも、issue のトリアージのされ方が変わるわけでもありません。

International — PayPal: paypal.me/yuhuahui
国内 — 微信支付（扫码）

WeChat Pay QR code

謝辞

Reasonix を最も形づくってくれた人々の小さなリストです — コミット数とコード量の両方で測っています。重要度の順位付けはなく、アルファベット順に記載しています。 完全なコントリビューターグラフは GitHub にあります。

また、プロジェクトのロゴをデザインしてくれた Bernardxu123（docs/brand/ を参照）と、小紅書（XiaoHongShu）でプロジェクトを宣伝してくれた AIGC Link にも別途感謝します。

_{MIT — LICENSE を参照}
_{esengine/DeepSeek-Reasonix のコミュニティによって構築}