リリースノート

チャットでIIoT現場アプリを作成、デプロイ、データに質問するスタジオ — 最新バージョンは 2026.08 です。

バージョン表記

バージョンは YYYY.MM 形式です(例: 2026.08)。同じ月内の更新は同じバージョン番号を 維持し、以下には反映日順に整理しています。 インストール・アップグレード方法は インストール を参照してください。

---

🚚 受信アドレスが変更されました — product.kopens.io

インストールスクリプトとエアギャップバンドルを download.kopens.io から product.kopens.io に移しました。 フォルダ構造とファイル名はそのままです。インストールコマンドをスクリプトに組み込んでいる場合は、アドレスだけ変更してください。

…-latest.tar.gz は廃止されました

最新バンドルのコピーを公開中にダウンロードするとチェックサムがずれ、正常なファイルが 「破損」と判定されることがありました。現在は最新バージョンの名前のみを含む latest.txt を読み、 バージョン付きアドレスから取得してください。

BASE=https://product.kopens.io/plantpulse-studio
VER=$(curl -fsSL $BASE/latest.txt)
curl -fLO -C - --retry 5 $BASE/plantpulse-studio-images-$VER.tar.gz

一度公開したバージョンは削除しません。 2026.09 がリリースされても …-2026.08.tar.gz アドレスはそのまま 有効で、いつでも再取得またはロールバックできます。インストール手順をスクリプトで固定している場合は、 latest.txt よりもバージョンを直接指定する方が安全です。

🗓 毎月定期リリース — 2026.08

毎月1日にその月のバージョンがリリースされます。2026.08 はデプロイ自動化のみを含むリリースで、製品機能の変更は ありません — 2026.07 をご利用の場合は、急いでアップグレードする必要はありません。

---

先に確認してください — アップグレード時に必要な対応

該当する場合	行うべきこと
閉域網ではない環境で運用中	今回のアップデートを必ず適用してください(ビルダーサイドカー露出の遮断)
設定ファイルにAPIキーを入れている	キーを .env に移動してください → シークレット管理
ドメイン・リバースプロキシでサービスを提供している	ユーザーの再ログイン1回 → ドメインとリバースプロキシ
バックアップはあるが復旧を試したことがない	復旧リハーサルを一度実行してください → バックアップと復旧

---

🛡 データ整合性の全面点検

全ソースを監査し、重大3件・高15件を発見して修正しました。ほとんどが「普段は見えず、 いざ必要な時に顕在化する」タイプのため、再現テストを先に作成してから修正しました。

バックアップ・復旧

復旧リハーサルを一度実行してください

復旧が実際には何も元に戻していませんでした。 バックアップは毎日正常に取得されていましたが、 復旧を実行するとDBが一文字も変更されないまま「復旧完了」と表示されていました。 以前のバージョンでは DRYRUN=1 リハーサルが成功しても実際の復旧は行われなかったため、今回のアップデート 後実際の復旧を一度テストすることをお勧めします → バックアップと復旧

• 復旧直前の退避コピーが失敗してもそのまま進行し、その退避コピーでは戻すこともできませんでした。 現在は正式なバックアップと同じ形式で作成し、失敗した場合は復旧を開始しません。
• バックアップに .env が含まれていませんでした。 キーを環境変数に移してからは、これがないとバックアップだけでは システムを復元できません → シークレット管理
• ワークスペース内に postgres フォルダがあると、バックアップから静かに除外される問題を修正しました。
• スケジュールバックアップが初回実行から全て失敗していました(ログファイルパス不存在)。自動バックアップを 有効にしている場合、実際には1件も蓄積されていない可能性があるため、dist/ を確認してください。

データ損失

• チャットルームを1つ削除すると他のユーザーの質問履歴まで消える可能性があった問題。
• プロジェクト削除後に7日間保持されるべきゴミ箱が、次の再起動で即座に空にされていた問題。
• ストレージ読み取りが一度失敗すると、その後ウォッチャー・スキルを1つ作成する瞬間に既存のものが全て 削除されていた問題。
• 設定・会話履歴の保存が途中で切れると、プロジェクトや履歴が消える問題。
• 軽量(ファイル)インストールをPostgreSQLへ昇格する際に、アカウントとチャット履歴が移行されなかった問題 → インストール

動作安定性

• アプリを素早く2回開くと内部ポートがリークし、最終的にすべてのアプリ起動が失敗する問題。
• ビルダー会話が長くなるほどリクエストが増え続け、トークン使用量が増加して最終的にチャットが停止する問題。
• 元に戻す操作がビルダー作業中に割り込み、結果が混ざったり失われたりする問題 → ビルダーでアプリ開発
• 再インストールがTLS証明書を削除し、HTTPSが平文に格下げされる問題 → ドメインとリバースプロキシ
• 設備制御コマンドが応答遅延時に最大4回重複送信される可能性があった問題。

画面

• チャット開始直後に送信した質問が、リスト読み込み完了後に消える問題 → チャットでデータ問い合わせ
• モバイルで通知が二重に表示され、ログアウトしてもリフレッシュすると再ログインされる問題 → 現場モバイル
• プラン作成後にモードを変更すると、作成した要件が消える問題。
• セッションが失効しても何の案内もなく空白画面だけが表示される問題。

📖 ユーザーマニュアル内蔵

• 製品にマニュアルが組み込まれました — 現在ご覧いただいているこの文書です。左ナビゲーションの マニュアル ↗(fa-book-open)をクリックすると新しいウィンドウで開きます。
• インターネットなしでも開けます: マニュアルが製品イメージに同梱されるため、閉域網の現場でも そのまま閲覧できます。本文検索もローカルで動作します。
• 左ナビゲーションのアイコンを少し大きくして、可読性を向上させました。

🔒 セキュリティ・サプライチェーン

• チャットに貼り付けたキーが履歴に残りません: アプリ変更履歴は自動的に記録されますが(→ ビルダーでアプリ 開発)、チャット欄にAPIキーを貼り付けるとその値が履歴にそのまま残っていました。 現在は既知の形式のキー・トークンを自動的にマスクします。

  それでも貼り付けないでください

  すべての形式の秘密情報を捕捉できるわけではありません。キーはチャットではなく、シークレット管理の 環境変数として設定してください。

• ビルダーエンジンイメージも署名対象に含めました: オフラインバンドルに含まれるイメージのうち、ビルダーサイドカーのみ 署名から漏れていたものを修正しました。bin/verify-images.sh が4種類すべてを検証します。

• 設定ファイルの権限が保存するたびに緩む問題を解決: ログイントークンファイルと設定バックアップも 保護対象に追加しました。

• ビルダーエンジンの最新化: OpenHands サイドカーを SDK v1.37.1 に更新しました(使用方法の変更はありません)。

📌 バージョン固定

• 全イメージを固定バージョンで指定しました(latest を削除)。再インストール時点によって異なるバージョンが 入ることはなくなります。.env の TAG で任意のバージョンを指定できます → インストール。
  ⚠ TAG は 2026-08-31 に PP_IMAGE_TAG に変更されました(イメージごとに個別固定できるよう PS_IMAGE_TAG_SERVER · PS_IMAGE_TAG_WEB も追加されました)。現在の基準は 環境変数リファレンス を参照してください。

🔑 シークレット管理・接続安定性

• APIキーを環境変数でのみ管理 — 設定ファイルに平文で保存されていたプラットフォーム・AI・Git・レジストリ キーを環境変数専用に移行しました。設定ファイルが流出してもキーは露出しません。 既存のインストールはそのまま動作し、起動ログが移行対象を案内します(値はログに残りません)。 環境設定画面は該当キーを 「環境変数で管理中」 と表示し、編集をブロックします。
  ⚠ この動作は 2026-08-23 に逆転しました — 環境変数が優先されると、失効したキーを画面で 修正できない問題が判明し、現在は画面の値が環境変数を上書きし、入力欄もロックされません。 現在の基準は シークレット管理 を参照してください。
• ファイル権限の自動強化 — サーバーが起動するたびに設定ファイルと .env を所有者専用(0600)に 強制します。
• 設定変更の追跡 — 何が変更されたかを監査ログに記録します(秘密情報は値の代わりにフィンガープリントのみ)。 「いつから動作しなくなったか」の追跡が可能になります。
• 長いビルド中の接続切断を解消 — エージェントがツール実行で長時間沈黙するとプロキシがストリームを 切断し「接続エラー」が表示される問題を、サーバーハートビートで解決しました(プロキシ設定に関係なく動作)。
• エラーメッセージの改善 — 「サイドカー状態: error」のように原因が不明だったメッセージが、実際の理由と 対処法を提供します(例: AIプロバイダーアドレスに接続不可 → 環境設定を確認)。
• 推論モデル互換性 — ツールを使用するモデルでゲートウェイ設定の競合により問い合わせが失敗する問題を 自動補正します。
• 運用ドキュメントにプロキシ設定の全例と「症状 → 原因」の対照表を追加しました。

🔒 セキュリティ・安定性強化

全面監査(セキュリティ・コード健全性・フロントエンド・運用)後に確認された問題を一括対処しました。

• ビルダーサイドカー露出の遮断 — ビルダーエンジンサイドカーがデフォルト設定で起動し、社内ネットワーク全体から 認証なしでアクセス可能でした。ループバックバインドに縮小し、メモリ・CPU・ログ上限を適用しました。 閉域網ではない環境で運用中の場合は、今回のアップデートを必ず適用してください。
• プレビューアクセス制御 — プレビューアドレスを知るだけで非公開プロジェクトのソースやチャット添付まで閲覧可能でした。 オーナー・管理者・共有対象のみアクセス可能にしました(リアルタイム更新WebSocketを含む)。
• アプリオリジンプロキシ制限 — 生成アプリのデータプロキシが全メソッド・全パスでした。 読み取りパスの許可リスト + 書き込みはアプリ自体の認証がある場合のみに限定しました(画面動作はそのまま)。
• ウォッチャーコスト事故防止 — 更新APIが入力を検証せず、不正な値が入るとウォッチャーが 停止したり、1分ごとにAIを呼び出したりする可能性がありました。
• 復旧スクリプトの提供 — バックアップのみで復旧手段がありませんでした。復旧スクリプトを新設し (リハーサル用の非破壊モードを含む)、バックアップファイルの権限を所有者専用に強化しました。
• 再インストール安全性 — ワンラインインストールを既存サーバーで再実行すると .env とローカルバックアップが削除され、 スタックが起動できませんでした。保持するよう修正しました。
• パフォーマンス — 初期画面バンドルを66%削減(チャートエンジン・画面の遅延読み込み)、回答ストリーミング中の入力遅延を解消、 バックグラウンドタブでのポーリング停止。
• アクセシビリティ・多言語 — モーダル・ドロワー11種にEsc・フォーカス処理を追加、英語モードで韓国語が 表示されていたエラーメッセージ83件を翻訳。

🌐 カスタムドメインデプロイ対応

• アプリオリジン設定 — 環境設定 → ランタイムタブでプレビュー・デプロイアプリの公開URLを指定します。 リバースプロキシ/HTTPSドメイン背後でのデプロイ時に再起動なしで即座に反映されます。
• ログインクッキーの自動ドメイン — スタジオとアプリオリジンが兄弟サブドメインの場合、クッキーに共通の親 ドメインを自動付与し、ドメイン分離後もデプロイアプリの実データ参照と非公開アプリへのアクセスが 動作します。⚠ ドメイン設定変更後は1回の再ログインが必要です。
• 混合コンテンツ案内 — HTTPSスタジオからHTTPアプリオリジンの場合、空白画面の代わりに原因と解決策を プレビュー・設定画面に表示します。
• デプロイガイド — オリジン2つの構成・Host保持・WebSocket・Cloudflare注意事項を整理しました → ドメインとリバースプロキシ
• UI調整: 英語モードのビルダー画面の横スクロールバー削除、コンテキストレールのトグル位置調整。

🏗 3Dデジタルツイン + 拡張スタック

• 3Dデジタルツイン — チャットで工場の3D画面を生成します。状態色・アラームパルス・値ビルボードを 含む標準3Dキットと「3Dデジタルツイン」テンプレートが新規に追加されました。
• 図面 → 床テクスチャ — チャットに図面画像を添付すると自動保存され、3Dシーンの床に敷かれます。
• 拡張スタック12種を事前同梱 — プロセスフロー図・アニメーション・フォーム・ドラッグアンドドロップ・仮想スクロール・QRスキャン マップなどを追加インストールなしで即座に使用できます。
• アプリセッションコンテナのデフォルトメモリを2 GBに引き上げました(3Dビルド対応)。

🧩 MCPレジストリ

• 環境設定MCPタブ — 外部MCPサーバーの追加・削除、ツールの自動検出(10分キャッシュ + 手動リフレッシュ)、 ツールごとの有効/チャット/ビルダートグル、新規・競合バッジ。
• プラットフォームツールの自動反映 — プラットフォームがツールを追加すると、スタジオのチャット・ビルダーに自動公開されます。

🔒 ビルダービルド標準

• 依存関係ロック(デフォルト有効) — 生成アプリの任意パッケージインストール・設定変更をブロックし、標準スタックを 固定します。管理者の許可リストで例外を設定できます。
• レイアウト強制(デフォルト有効) — 全画面が標準シェルを使用しているか検証し、違反時はエージェントが 自動修正します。
• アプリデフォルトレイアウト — 製品名・強調色・最大幅・フッターを環境設定で一括指定し、新規アプリに 注入します。

📦 オフライン持ち出しバンドル

• デプロイバージョンサイドバーで [バンドル] をクリックすると、アプリイメージと実行スクリプトを含む圧縮 ファイルをダウンロードします。エアギャップ現場で bash run.sh の1行で起動できます。

🐳 Docker — アプリをどこでも

• アプリイメージpush — デプロイバージョンをワンクリックでDockerイメージにパッケージングしてレジストリに アップロードします。スタジオ外のどこでもコンテナとして実行できます。
• ランダイムパネル — 下部ステータスバーでセッションコンテナの状態(CPU/メモリ)をリアルタイム確認し、 クリックでログ・再起動まで可能です。
• アプリカタログ — デプロイされたアプリをサムネイルクリックで即座に新しいタブで起動します。

🗣 データに直接質問するチャット

• 自然言語問い合わせ — 「3番ラインの設備別タグ数を表示して」のように質問すると、プラットフォームの実データで即座に 回答します。
• リッチ回答 — 表(CSVコピー対応)・チャート・プロセスフロー図で可視化します。
• チャットルーム管理 — 会話の分離・名前変更・検索、回答所要時間表示、写真添付。
• チャット → アプリ変換 — 良い回答はワンクリックでダッシュボードアプリのドラフトになります。

🛰 ウォッチャー — 自然言語監視ルール

• 「ライン圧力が8barを超えたら知らせて」と書くだけです。定期実行と条件判断はAIが行います。
• 発動時にリアルタイム画面通知(トースト) + 未確認バッジ(デバイス間同期)。
• 通知一覧画面(検索・もっと見る)、Slack/Teams互換Webhook送信。
• チャット中の「これを監視して」の一言でウォッチャーを作成できます。

🏭 セマンティックレイヤー — 工場を理解するAI

• サイト・ライン・設備・タグ構造をスタジオがスナップショットで学習します。
• エージェントが設備名・別名・期間表現(「昨日」、「先週」)を正確なデータアドレスに解釈します。
• ISA-95階層ピッカーで人間も同じ構造を探索できます。

📊 運用可視性

• 統計ダッシュボード(管理者) — 使用量・アクティビティ・アプリ・問い合わせ・デプロイ成功/失敗ログ・監査検索を1タブで。
• デプロイは段階進行ダイアログ(ビルド → 変換)とQRコードで現場タブレット接続まで対応します。
• 監査ログ全文検索、デプロイ履歴・ロールバック追跡。

🤖 コーディングエージェント高度化

• OpenHandsエンジン — アプリビルドに業界標準のオープンソースコーディングエージェントエンジンを選択できます (環境設定 → エージェント → ビルダーエンジン)。精密編集と会話要約圧縮で長いセッションも安定します。 チャット(質問)には影響なく、いつでも内蔵エンジンに戻せます。
• ビルダー3モード — プラン(構成案承認後にビルド) · 自動(デフォルト) 承認(編集をプレビューで確認してから承認/元に戻す — 会話履歴は保持)。
• スラッシュコマンド — チャット入力に / と入力すると /plan /build /review /fix /test /loop /deploy が表示されます。/loop は型チェックを通過するまで自動修正を繰り返します(最大3回)。

📱 現場モバイル

• 電話専用画面 — スマートフォンでアクセスすると自動的にモバイルビューに切り替わります(タブレット・デスクトップを除く)。
• 下部4タブ — ホーム · チャット · ウォッチャー · アプリ。
• ホーム概要 — 未確認通知・アクティブウォッチャー・デプロイアプリ・会話数をカードで、最近の通知を一目で。
• リアルタイム通知 — 他のデバイスでウォッチャーが発動してもトーストと未確認バッジで即座に通知します。
• モバイルウォッチャー管理 — 一覧・オン/オフ・即時実行・削除、自然言語で新しいウォッチャー作成まで。
• デプロイアプリ閲覧 — デプロイされたアプリをライブミニプレビューカードで見て、一度に開きます。
• テーマ・言語 — ライト/ダーク・韓国語/英語切り替え。

アプリ一覧・デザイン更新

• アプリ一覧2タブ — [デプロイ済み]・[共有受信]に分けて、自分がデプロイしたアプリと共有されたアプリを区別します。
• プレミアム計器盤デザイン — 淡いオーロラ背景・グラスカード・状態LEDパルスで現場のスマートフォン 画面をより鮮明に(産業用ダークトーンは維持)。

🔒 セキュリティ・運用ハードニング

• 生成アプリオリジンの分離(スタジオとは別リスナー) — 信頼境界を明確にしました。
• プラットフォームAPIキーはサーバーにのみ保管し、ログインしたユーザーにのみ代理で使用します(匿名ブロック)。
• ログイン・AI経路のレートリミット、監査ログ、ロールベースの権限(管理者/ビルダー/ビューア)。
• すべてのコアデータ(会話・ウォッチャー・通知既読・スキル・デプロイ履歴)をPostgreSQLに永続化 — ブラウザストレージに依存しません。
• 非公開デプロイアプリはオーナー・管理者・共有対象のみ使用できます(以前の「ログイン済み全ユーザー 許可」から強化)。共有はアプリカードの「ユーザー共有」で指定します。
• エアギャップ(閉域網)インストールとバックアップ/復旧スクリプトを同梱します。

---

インストール・アップグレード

状況	ドキュメント
新規インストール	インストール
閉域網にインストール	閉域網インストール
ドメイン・HTTPSでサービス提供	ドメインとリバースプロキシ
アップグレード前のバックアップ	バックアップと復旧
キーを環境変数に移行	シークレット管理
問題が発生した場合	トラブルシューティング

初めて使用する場合は はじめに から始めてください。