dsh-1tempo

1tempo

曖昧な依頼文を MiL へ変換し、承認してから dsh で選択中のモデルへ渡す dsh プラグイン。

/onetempo 3Dモデルを作って
  ↓ sarashina が MiL へ変換（mil-spec を system に渡す）
  ↓ 原文と MiL を表示し、承認（必要なら修正）
  ↓ 承認済みの MiL を、dsh で選択中のモデルへ渡す

• 確定設計: architecture.md
• dsh への要望（会話へ書く API）: dsh-feature-request.md
• 企画の原案・質疑応答・実測レポート（proposal.md / qa-record.md / preflight-report-*.md）はローカル記録のため、この公開リポジトリには含めていない。本文中の preflight-report-run*.md はその記録のファイル名を示す。

何をするか

1. /onetempo が起動したときだけ動く。通常の依頼文には反応しない。
2. 依頼文を Sarashina API に送り、MiL へ変換する。
3. 原文と MiL を表示し、承認を求める。承認前に編集もできる。
4. 承認された MiL を、dsh の選択モデルへ 利用者のメッセージとして 渡す（source.kind: 'user'）。dsh は source.kind === 'user' のメッセージだけを利用者の行として扱い、/rewind の戻り先にもする（それ以外はコンテキスト行になり、会話に出ない）。変換の来歴はプラグインの storage ログと通知に残す。
5. 原文・MiL・逆翻訳・変換モデル・呼び出し回数・承認有無を dsh の storage に記録する。storage が使えない場合は「ログ: 保存できませんでした（理由）」と出し、保存したように見せない（セッション内の記録だけを保持する）。

必要なもの

• dsh（@deepseek-harness-tui/dsh-tui が入ったプロファイル）
• Node.js 24 以降（テストと測定ツールで確認）
• SARASHINA_API_KEY（Sarashina で発行。無償ベータ、Google ログイン、事前申し込み不要）

キーの指定方法は以下のいずれか（優先順位順）:

1. ~/.dsh/.credentials.yaml（dsh 標準の認証情報ファイル、推奨）
2. 環境変数 SARASHINA_API_KEY（.env を使う場合は node --env-file=.env）

# 測定ツールの例（~/.dsh/.credentials.yaml にキーがあれば --env-file 不要）
node tools/preflight-decode.mjs --dry

使い方

/onetempo [mini|nano] [back] <依頼文>

引数なしの /onetempo は使い方を表示する。

名前について: プロジェクト名は 1tempo だが、コマンドと識別子は onetempo。dsh のコマンド名とプラグイン所有の設定名前空間は /^[a-z][a-z0-9_-]*$/（英小文字で始まる）に一致する必要があり、当初案の 1tempo は数字始まりのため拒否される（実測: command name "1tempo" must match ... / invalid TUI settings-section namespace: 1tempo）。表示名（1tempo、設定セクションの見出し、source.plugin）は 1tempo のまま。

表示と承認

• 変換結果は 通知欄 に出る。200 セル以内に収まる形に整形する（1tempo: 送信しました… / MiL: <送信する MiL> / 逆翻訳・ログ行）。
  • dsh はプラグインのコマンド結果を channel.notify(cleanRenderText(text, COMMAND_RESULT_CELLS = 200)) で通知欄に描く。200 セルを超えた分は … で切られるため、先頭を MiL にし、続く注記は予算内の分だけ載せる（プラグイン側では切り詰めない）
  • 長い MiL の全文は承認ダイアログの初期値（490 セルまで）で読める
• 会話に出るのは送信メッセージの本文だけ（content）。本文は MiL のみ。
  • content は「会話に表示されるテキスト」と「モデルが読むテキスト」を兼ねる。dsh に両者を分ける欄は無い（実測: tools/inspect-session-log.mjs --grep で agent/inbox/spliced に本文が入ることを確認）。そのため原文を会話に出すと、そのままモデルにも渡る
  • includeOriginalInMessage: true にすると本文が「依頼: <原文>」→「MiL: …」になる。会話の行が自分の言葉で始まり /rewind で識別しやすいが、MiL の圧縮効果は失われる。既定は false
  • source は { kind: 'user' } のみ（form を付けない）。dsh は isHuman = sourceKind === 'user' の一点で利用者とプラグインを区別し（dsh-adapter/trajectory/projection.js）、/rewind も同じ条件で戻り先を選ぶ（sessionTree.js）。plugin:1tempo のままだと context 行になり会話に出ず、form を付けると行ごと消える（どちらも実機で確認）。代償: セッションログ上は「利用者が送った」記録になる。変換の来歴は storage ログと通知に残す（qa-record.md §6.22）
  • 会話へ任意の行を足す API は無い。プラグインのコマンド結果は通知に回り（200 セル上限）、session.append でログ専用イベントを足すこともできない（ignorable を付けられない）。「会話にだけ原文を出す」要望は dsh-feature-request.md の提案 6（入力欄へ本文を入れる API）にまとめた
• 承認は 編集ダイアログ 1 つだけ。MiL がダイアログの初期値として表示されるので、その場で読んで確認できる。
  • そのまま Enter → 送信
  • 本文を編集して Enter → 修正した MiL を送信
  • Esc / Ctrl+C → 送信を取り消す（未編集の MiL を勝手に送らない）
  • dialogTimeoutMs（既定 3 分）を過ぎた場合も取り消す
• 確認ダイアログ（「この MiL を送信しますか」）は 2026-10-14 に廃止した。コマンドの出力はハンドラの終了後に出るため、その時点では MiL が画面に無く、見えないまま承認させることになっていた。
• MiL が 490 セルを超える場合は編集ダイアログを開かず、表示のみ行う。
• MiL が質問のみで内容を持たない場合は、その旨を注記に出す（依頼の要件が落ちていないかを確認するため）。
• 変換に失敗したときは、設定 failureMode に従う（既定は「原文をそのまま送るか確認」。自動送信はしない）。
• ダイアログ下部の操作ヒント（Enter to confirm · Esc to cancel など）は dsh のダイアログ部品が描くもので、プラグインからは消せない。消すにはダイアログを使わない方式（会話で完結する 2 段階）へ変える必要がある。

インストール（dsh への登録）

このリポジトリは dsh の bundle パッケージとして作ってある（package.json の dsh.bundle.patch → cordis.patch.yml）。したがって、展開も手作業の設定も不要で、dsh のプラグイン管理から spec を指定するだけで入る。

1. Web UI の Plugins ページから（推奨）

サイドバーの Plugins ページで追加先に次を入れて Install する。

github:puyokura/dsh-1tempo

• dsh のプラグイン管理（@deepseek-ai/dsh-plugin-manager）が pnpm add でこのリポジトリをプロファイルへ入れ、bundle を既定で有効化し、同梱の cordis.patch.yml の行を適用する。手で cordis.patch.yml を編集する必要はない。
• プロファイルが HMR 有効（patchReload: live）ならその場で反映される。無効なら dsh を再起動する。
• 削除も同じページから行える（pnpm remove 相当）。

エージェント経由なら plugin_manager ツールの install_bundle に同じ spec を渡す（Creator 系プリセットで有効。実行には danger-full-access か承認が要る）。

2. プロファイルへ CLI で入れる（bundle 方式）

Web UI を使わない場合（サーバー上で動かす、ヘッドレスなど）は同じ操作を CLI で行う。

cd ~/.dsh/profiles/<プロファイル名>
pnpm add github:puyokura/dsh-1tempo

次に package.json の dsh.profile.bundles の末尾へ "dsh-plugin-1tempo" を足す。pnpm add だけでは bundle は有効にならず、この 1 行が Install ボタンの仕事にあたる。

      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-plugin-1tempo"
      ],

• 反映は patchReload: live なら即時、そうでなければ dsh を再起動する。
• 戻すときは pnpm remove dsh-plugin-1tempo と bundles からの削除。
• サーバー側の Web UI で使う場合、SARASHINA_API_KEY はそのサーバーの ~/.dsh/.credentials.yaml に置く。プラグインはコマンド実行時にキーを読むため、置いた時点で有効になる（再起動は不要）。

3. プロファイルのパッチへ直接書く（手動・従来の方法）

プロファイルのパッチ（例: ~/.dsh/profiles/dsh-tui/cordis.patch.yml）の insert: に 1 行追加する。

    - id: onetempo
      name: <このリポジトリの絶対パス>/index.mjs
      config:
        model: sarashina3-nano
        specPreamble: off

• name は index.mjs の絶対パス。Windows ではスラッシュ区切りで書く（例: C:/Users/you/1tempo-pulgin/index.mjs）。
• id は設定画面が設定セクションを引く名前空間になる。/^[a-z][a-z0-9_-]*$/ に一致する必要がある（1tempo は不可）。
• config は省略可能。省略時は下記の既定値が使われる。
• bundle として入れたプロファイルに、この手動の行を足さない（同じ id: onetempo が二重になる）。すでに手動の行があるプロファイルへ bundle を入れるときは、先に手動の行を消す。
• 読み込みに失敗すると dsh の起動がロールバックする。戻すときはこの 4 行を削除する。

Web UI（プロファイル web）

同じ手順（上記 1 か 2）を web プロファイルへ行う。手動で入れる場合だけ、insert: 行を ~/.dsh/profiles/web/cordis.patch.yml に置く。プラグインはどちらのホストでも動く（接点は実行時に選ばれる）。

• TUI 固有の 3 サービス（tuiPluginHost / tuiDialogs / tuiPluginStorage）は Web ホストに存在しない。ctx.storageDomain は逆に TUI ホストに mount されていない（実測 2026-10-15）。
• どちらの対話接点も無い構成では、MiL を表示するだけで送信しない（未確認の送信を避ける）。
• 引数つきで実行させるには input.hint の宣言が要る。Web の入力判定（dsh-client-ui-commands の matchEnter）は input を持つコマンドだけを引数つき行として実行し、無い場合はその行をそのままメッセージとして送る（実測 2026-10-17）。
• ctx.userQuestions.ask() には解決済みの agent を渡す。Web の回答器は live な Agent スコープの要求だけを受け、agent 無しでは NO_PROVIDER になってカードが出ない（実測 2026-10-17）。

設定

config または設定セクション（/settings）で変更する。未知の値は警告つきで既定に落ちる。

specPreamble の使い分け（実測に基づく指針）

prepend は定義行を MiL の前に置く。原典の使用例（例A）と同じ運用で、対象モデルが MiL を知らない場合に復号が安定する。代わりにペイロードが定義行の分だけ長くなる。off は軽く、MiL のみを送る。

どちらも復号テストに合格している（preflight-report-run6-off.md / preflight-report-run7-prepend.md。ローカル記録）。対象モデルが MiL を初めて見る場合は prepend、すでに文脈がある場合やトークンを抑えたい場合は off を目安にする。

記法（MiL）と本プラグインの立場

MiL は @AM09_21 が CC0 1.0 で公開した記法。本プラグインは仕様を改良も公式化もしない。

• 定義本体: https://x.com/AM09_21/status/2103233036817170460
• 精密化: https://x.com/AM09_21/status/2103282758231707887
• @ 衝突の報告: https://x.com/AM09_21/status/2103290587374096573

仕様の写しと、本プラグイン独自の追加規則は mil-spec/ にある。

本プラグイン独自の規則（原典には無い。mil-spec/v0-snapshot-2026-09-25.md §4）:

• 送信直前にトークン先頭の @ を ext: へ置換し、復元しない（dsh が @ をファイルメンションとして展開するため）。
• 返答言語の指示を system prompt に足せる（既定は無効）。

開発

node --test "tests/*.test.mjs"     # 173 件

測定

# 送信 payload の確認（API を呼ばない）
node tools/preflight-decode.mjs --dry

# 変換と復号テスト（対象モデルを差し替え可能。変換器は Sarashina 固定）
node --env-file=.env tools/preflight-decode.mjs --count 5 --instruction example `
  --target-base https://api.commandcode.ai/provider/v1 `
  --target-model inclusionai/ling-3.1-flash:free `
  --target-key-env COMMANDCODE_API_KEY `
  --out preflight-report.md

# 既存レポートのペイロードで復号だけを試す
node --env-file=.env tools/preflight-decode.mjs --decode-only preflight-report-run6-off.md `
  --target-base https://api.commandcode.ai/provider/v1 `
  --target-model inclusionai/ling-3.1-flash:free `
  --target-key-env COMMANDCODE_API_KEY

検証状況

ライセンスと帰属

• 本プラグインのコードは MIT ライセンス（LICENSE）。
• MiL の記法は @AM09_21 による CC0 1.0 の公開物。原典の URL は本 README と mil-spec/ に残している。
• mil-spec/examples-v0.txt は原典ではなく本プラグインが作成した教材である。