maxmilian/dsh-odoo

dsh-odoo

English | 繁體中文 | 简体中文 | 日本語

dsh-odoo は Odoo external API 向けの、無料・オープンソースで読み取り専用を基本とする DeepSeek Harness プラグインです。エージェントは Odoo の状態を変更することなく、業務データ （連絡先、見積、受注、請求書、プロジェクトタスク、リード、在庫）を参照できます。 明示的に有効化した場合のみ、厳しく制限されたドラフトレコードを作成するツールが 1 つ追加されます。 無効のときはそのツール自体が登録されません。

✅ 2026-08-27 に Odoo 18 で live 検証を実施しました。 公式 odoo:18 イメージ （server_version は 18.0-20260817）です。互換性に関する前提の大半を実サーバーで確認しており、結果と 未検証の範囲は docs/live-verification.md にあります。 検証したのは Odoo 18 のみ（8〜17 および 19 は未検証）、かつ直接接続した Docker イメージのみで、 リバースプロキシ配下・Odoo Online・Odoo.sh は未検証です。本プラグインは JSON-RPC のみを使用し、 /jsonrpc に到達できる必要があります（トランスポート参照）。問題が起きた 場合は、Odoo のバージョンと serie、デプロイ形態（Odoo Online、Odoo.sh、自己ホスト、コンテナ、 前段のリバースプロキシ）、および odoo_server_info の完全な出力を添えてご報告ください。

ツール

トランスポート

本プラグインは JSON-RPC 2.0 で POST {baseUrl}/jsonrpc を呼び出すため、Odoo サーバーが このエンドポイント（web モジュールが提供）を公開している必要があります。エンドポイントが 存在しない、リダイレクトされる、プロキシに遮断される場合は、すべてのツールが TRANSPORT_UNSUPPORTED エラーでその旨を通知します。XML-RPC は実装していません。

model の利用可否

許可リストにある 14 個の model は、すべての Odoo に存在するとは限りません。常に存在するのは base が提供する model だけで、残りは業務モジュールが提供し、初期状態の Odoo には インストールされていません。

業務モジュール未導入の Odoo 18 で sale.order を照会すると ODOO_VALIDATION_ERROR となり、 上流の理由 Object sale.order doesn't exist が付きます。まず odoo_describe_model を呼び出し、 その model がご自身のインスタンスで利用可能かを確認してください。

必要条件

• 互換性のある @deepseek-ai/dsh-tools API を備えた DeepSeek Harness
• Node.js 22.19 以上（22.x 系）または Node.js 24 以上
• GitHub ソースからのインストールやローカル開発には Bun 1.3.5 以上
• Odoo の URL、データベース名、ログイン名、API キー（またはパスワード）と、対象 model へのアクセス権

設定

認証情報がプロファイルパッチに現れないよう、環境変数の利用を推奨します:

export ODOO_URL='https://odoo.example.com'
export ODOO_DB='production'
export ODOO_USERNAME='integration@example.com'
export ODOO_API_KEY='your-api-key'

プラグイン設定は環境変数より優先されます:

認証情報はツールを実際に実行するときにのみ必要です。プラグインを導入しただけで未設定の状態でも、 プロファイルの読み込みは失敗しません。locale はツールとパラメータの説明のみを切り替え、 ツール名とエラーメッセージは常に英語のままです。

安全境界

• 既定で読み取り専用。 本リリースに write、unlink、ワークフロー操作はありません。
• Model 許可リスト。 照会できるのは標準の 14 model のみです: res.partner、res.users、 res.company、product.product、product.template、sale.order、sale.order.line、 purchase.order、account.move、account.move.line、project.project、project.task、 crm.lead、stock.quant。
• リレーションのたどりは不可。 domain のフィールド名にドットは使えません。関連レコードで 絞り込むには、まず関連 model を照会して id を取得し、('partner_id','in',[ids]) を使います。 これにより許可リストは提案ではなく実際の能力境界になります。
• binary フィールドは返しません。 Odoo の型が binary のフィールドは拒否され、 既定フィールドセットにも含まれません。
• レスポンスに上限。 model ごとの既定フィールド、limit ≤ 100、offset + limit ≤ 10000、 1 つの文字列値は 2000 文字で切り詰め、すべてのレスポンスにバイト数の上限があります。
• アーカイブされていないレコードのみを返します。active_test コンテキストは公開しません。
• ドラフト作成は明示的な有効化が必要で、形も固定です。 sale.order は常に state=draft で 作成され、project.task は state や stage_id を指定できず、ステージは Odoo の既定の ステージが適用されます。許可リストのフィールドのみ受け付け、one-to-many コマンドは拒否します。

0.1 の非目標

• 業務ラッパーツール（list_customers、list_quotations など）は作りません。実際の Odoo なしでは 検証できないフィールド前提に依存しており、前提が誤っていてもエラーではなく空の結果を返します。 これはエージェントにとって最悪の失敗モードです。0.2 に延期します。
• 更新・削除・ワークフロー遷移は行いません。添付ファイルやレポート生成も扱いません。
• XML-RPC トランスポート、model の探索、複数データベースの切り替え、カーソルページングは行いません。

開発

bun install
bun run lint
bun run typecheck
bun run test
bun run build

scripts/smoke-odoo.sh は実サーバーに対する手動のエンドツーエンド確認で、意図的に CI から除外しています。

ライセンス

MIT