QoderWake CN を使用すると、ローカルマシン上にデジタル従業員 (Waker) のチームを構築できます。各 Waker には、定義されたロール、名前、ペルソナ、およびスキルセットがあります。Waker とチャットしたり、タスクを割り当てたり、スケジュールやイベントに応じて自動的に作業させることもできます。Waker の機能、ツール、記憶、権限は完全に設定可能です。
新しい Qoder CN ドキュメントサイトが公開されました。このサイトのコンテンツは、最新の製品機能や変更を反映していない場合があります。最新の製品ドキュメントについては、docs.qoder.cn をご参照ください。
QoderWake CN をゼロからセットアップします。ツールをインストールし、コンソールを開き、最初の Waker を作成し、タスクを割り当て、チームを管理します。
製品哲学：24 時間 365 日稼働するデジタル従業員、「常に覚醒し、常に稼働する」
製品の特長：安全で制御可能、本番環境に対応、そして継続的に進化します。
コアコンセプト：ロール → エージェント → エージェントチーム
初期ロール：バックエンドエンジニア、フロントエンドエンジニア、テストエンジニア、プロダクトマネージャー、データアナリスト、コンテンツオペレーション。さらに、カスタムロール の作成もサポートしています。
ロールの選択
招待制ベータ版には、以下のロールが含まれています。ニーズに最も適したものを選択してください。
ロール | 説明 |
バックエンドエンジニア | API 開発、データモデリング、サービス統合、パフォーマンス最適化、オンラインサービスの安定性確保を専門とします。インクリメンタルデリバリー、テスト検証、規約を優先した設計などのエンジニアリングプラクティスに従います。エージェントはバグや課題を自動的に分析し、コードを修正して PR を送信します。 |
フロントエンドエンジニア | フロントエンドの UI 設計と実装に重点を置いています。コンポーネントアーキテクチャ、ビジュアル言語の洗練、レスポンシブデザイン、アクセシビリティの最適化、パフォーマンスチューニングに優れています。インクリメンタルデリバリー、階層化された検証、エビデンスベースの検証を遵守し、ユーザーエクスペリエンスとエンジニアリング品質のバランスを取ります。 |
テストエンジニア | 一般的なコマンドラインツールや Web 製品の品質保証を提供します。テスト計画書の作成、エンドツーエンドテストの実行、不具合の再現、エビデンスベースのレポート生成に重点を置いています。単体テストの実行や問題の修正は行いません。 |
プロダクトマネージャー | ソフトウェア製品向けの AI ネイティブなプロダクトマネジメントロールです。ゴール駆動のライフサイクル全体にわたる要件管理、PRD 作成、ユーザーフィードバック分析、競合調査、リリースに関する情報伝達に重点を置いています。外部への書き込み操作には明確な承認ゲートを設定します。 |
データアナリスト | 問題の明確化、メトリクスの定義、DingTalk ドキュメントやスプレッドシートからの MCP ベースのデータ収集、データ診断、市場コンテキスト分析、エビデンスベースの推奨事項に重点を置く AI ネイティブなデータアナリストです。 |
コンテンツオペレーション | アカウントのポジショニング、トレンドの洞察、コンテンツカレンダーの管理、Xiaohongshu 投稿の作成、ビジュアルアセットのブリーフィング、承認後の公開、コメントへの対応、パフォーマンスレビュー、ブランドコンプライアンスの確保、複数プラットフォーム向けのコンテンツ最適化に重点を置く AI ネイティブなコンテンツオペレーションロールです。 |
カスタム | ロールのワークフローとワークスタイルを自分で定義します。MCP やスキルなど、任意の設定が可能です。 |
環境準備
QoderWake CN は、ローカルデプロイとクラウドデプロイをサポートしています。24 時間 365 日の最適な運用のためには、専用のローカルマシンやクラウドデスクトップなど、常時起動し、ネットワーク接続が安定しているデバイスにデプロイしてください。
Windows 版はまだ一般公開されていませんが、近日公開予定です。現時点では、macOS または Linux で QoderWake CN をご使用ください。
ローカルデプロイ
24 時間 365 日の信頼性の高い運用のために、Mac mini などの安定して長期間稼働できるローカルデバイスにデプロイします。
macOS：13.0 以降。
Linux：Ubuntu 22.04 LTS 以降を推奨します。ローカルの Web コンソールを使用するには、GUI デスクトップ環境が必要です。
クラウドデプロイ
QoderWake CN は、主要なクラウドデスクトップおよびクラウドサーバー環境をサポートしています。ブラウザベースの便利なログインとローカル Web 管理のためには、Elastic Desktop Service (Enterprise Edition または Personal Edition) を使用してください。
Linux：Ubuntu 22.04 以降。ローカルの Web コンソールを使用するには、GUI デスクトップ環境が必要です。
前提条件
QoderWake CN には、ソフトウェア開発用に事前設定されたいくつかのデジタル従業員ロールが含まれています。インストールする前に、Git 環境がセットアップされていること、およびユーザーアカウントがターゲットのコードリポジトリにアクセスできることを確認してください。
gitがインストールされていること。リポジトリ認証が設定されていること。
clone、pull、push操作を正常に実行できること。
ローカルデプロイとクラウドデプロイの両方で、ユーザーログイン、AI モデルの呼び出し、コードリポジトリへのアクセスのために外部ネットワークへのアクセスが必要です。企業のネットワーク、プロキシ、またはファイアウォールの内側にいる場合は、必要なアウトバウンド HTTPS トラフィックが許可されていることを確認してください。
ステップ 1：QoderWake CN のインストール
macOS
QoderWake CN 公式ウェブサイトにアクセスして、インストールパッケージをダウンロードします。
または、ターミナルを開き、次のコマンドを実行します。
curl -fsSL https://ide.qoder.com.cn/qoderwake-cn/install.sh | bashこのスクリプトは、プラットフォームを自動的に検出し、インストールパッケージをダウンロードして検証し、メインプログラムとリソースファイルをインストールし、コマンドのエントリポイントを PATH に追加し、ログイン用のブラウザを起動し、ローカルのバックグラウンドサービスを開始し、Web コンソールを開きます。コマンドのエントリポイントは ~/.qoderwake-cn/bin/qoderwake です。
Linux
ターミナルを開き、次のコマンドを実行します。
curl -fsSL https://ide.qoder.com.cn/qoderwake-cn/install.sh | bashインストールスクリプトは自動的に以下を実行します。
Linux CPU アーキテクチャを検出します。
お使いのプラットフォーム用の QoderWake CN インストールパッケージをダウンロードして検証します。
QoderWake CN のメインプログラムとリソースファイルをインストールします。
コマンドのエントリポイントを作成し、
PATHへの追加を試みます。ログイン用のブラウザを起動します。
ログイン後、ローカルのバックグラウンドサービスを開始または再起動します。
ローカルの Web コンソールを開きます。
コマンドのエントリポイント：
~/.qoderwake-cn/bin/qoderwake-cnデフォルトの Web コンソールアドレス：
http://127.0.0.1:19830Windows
Windows 版は近日公開予定です。正式リリース後、このページは更新されます。
ステップ 2：コンソールの起動
ブラウザを開き、http://127.0.0.1:19830/ にアクセスします。これは、Waker の管理、タスクの割り当て、権限の設定を行うローカルの QoderWake CN コンソールです。
インターフェースの概要：
左側メニュー：「My Wakers」リストが表示されます。ここには、作成済みのすべての Waker とその最終アクティビティ時刻が記載されています。
上部ボタン：[Create Waker] をクリックして、新しい Waker を追加します。右上では、新しいタスクを作成できます。
メインエリア：Waker を選択すると、デフォルトでチャットインターフェースが開き、タスクを直接割り当てることができます。
右サイドバー：作成済みのタスクと現在実行中のタスクの詳細を表示します。
初めてアクセスすると、ログインを求められます。画面の指示に従ってプロセスを完了してください。
ステップ 3：Waker の作成
左側の [Create Waker] ボタンをクリックします。
ロールテンプレートの選択：各ロールテンプレートには、事前定義されたペルソナ、典型的なワークフロー、コアスキルセット、およびデフォルトのプロンプトが含まれています。[View Details] をクリックしてプレビューします。
または、カスタムロールの作成：事前設定されたロールのいずれもニーズに合わない場合は、[Custom Role] を選択します。Waker のペルソナ、専門知識、ワークスタイルをゼロから定義し、その後、スキル、コネクタ、権限を設定できます。
基本情報の入力：Waker の名前、アバター、自己紹介を入力します。事前設定されたロールを選択した場合、この情報は自動的に入力されますが、必要に応じて編集できます。
保存：[Save] をクリックして Waker を作成します。Waker を作成すると、オンボーディングガイドが表示され、追加すべきスキルや接続すべきチャネルが提案されます。これはスキップして後で設定することもできます。
カスタムロールで最良の結果を得るには、作成時に包括的な情報を提供してください。これには、ロールの位置付け、中核となる責任、ワークフロー、必要なスキル、MCP 設定などのツール機能が含まれます。
ステップ 4：Waker との連携開始
Waker を作成した後、対話型タスクを開始するか、自動タスクを作成する ことができます。
対話型タスク
入力ボックスにリクエストを入力して送信します。Waker はすぐに作業を開始します。このプロセス中に、以下の操作が可能です。
フォローアップの質問や方向性の調整：いつでも介入でき、Waker はコンテキストに基づいて作業を続行します。
ファイルやスクリーンショットの添付：会話のどの時点でも添付ファイルを追加できます。
中断：Waker が脱線した場合は、作業を停止させます。
操作の承認：Waker がファイルの変更、コマンドの実行、またはインターネットへのアクセスを必要とする場合、一時停止して承認を求めます。[Allow] または [Deny] をクリックします。
Waker の質問への回答：選択を行う必要がある場合、入力を求められます。表示されたカードで直接選択します。
AI モデルの切り替え：現在のモデルのパフォーマンスが悪い場合やコストを削減したい場合は、上部のドロップダウンメニューから別のモデルに切り替えて会話を続けることができます。
思考プロセスの表示：Waker が決定を下す前に、その推論をリアルタイムで確認できます。
アーティファクトの表示：右側のパネルには、コードパッチや新しいファイルなど、Waker によってリアルタイムで生成されたアーティファクトが表示されます。
作業ディレクトリの選択：チャットの下部で、Waker が操作するローカルディレクトリを選択できます。
自動タスク
自動タスクは、「1 日 1 回実行する」や「リポジトリの変更に自動的に対応する」のようなシナリオに最適です。
[Waker Details] → [Triggered Tasks] → [New] に移動して、以下を設定します。
タスク名と説明：Waker が実行内容を理解するのに役立ちます。
AI モデル：使用するモデルを選択します。
作業ディレクトリ：タスクが実行されるローカルディレクトリ、リポジトリ、またはプロジェクトのワークスペース。
トリガー方法 (最大 5 つ、組み合わせ可能)：
スケジュール実行：1 回、定期的、または複雑なスケジュールで実行します (例：毎日午前 9 時、毎週月曜日、または毎月 1 日)。
イベント駆動：GitHub リポジトリの課題、PR、またはコメントの変更を監視します。
最大実行回数 / 終了日 (オプション)：タスクが無期限に実行されるのを防ぎます。
保存後、Waker はスケジュールに従って自動的に実行されます。いつでもタスクを一時停止または有効化したり、テストのためにすぐに実行したり、実行履歴を表示したりできます。
ステップ 5：Waker の管理
Waker の詳細ページに移動して、その設定を表示および調整します。
セクション | 説明 |
ホーム | Waker のアバター、ステータス、作成日からの経過日数、トリガータスクの数、対話型タスクの数、およびアクティビティヒートマップを表示します。 |
プロジェクト | Waker が作業するコードリポジトリまたはローカルディレクトリを紐付けます。プロジェクトには複数のソース (ディレクトリまたはリポジトリ) を含めることができます。プロジェクトの記憶は、Waker の個人的な記憶とは別です。 |
トリガータスク | この Waker の自動タスクを追加、削除、変更、または一時停止します。 |
対話型タスク | 過去の会話を確認し、チャットを続行します。 |
記憶 | あなたとプロジェクトに関する Waker の長期記憶を表示および編集します。記憶は、会話中の自動キャプチャ、手動編集、および定期的なシステムレビューと重複排除から構成されます。すべての記憶はローカルに保存され、クラウドにはアップロードされません。 |
スキル | 公式の Qoder CN スキルマーケットプレイスから新しいスキルをインストールしたり、ローカルマシンからカスタムスキルをアップロードしたり、既存のスキルを有効化または無効化します。組み込みのスキルはアンインストールできません。 |
コネクタ | GitHub、Jira、GitLab などの外部ツールやサービスと統合します。 |
権限 | ツール保護：組み込みのセキュリティルールに基づいてツールパラメータを検証し、コマンドインジェクション、リソースの不正使用、コード実行、ネットワークの不正使用、機密ファイルへのアクセス、権限昇格などの脅威を防ぎます。ファイル保護：ローカルファイルへの読み取りおよび書き込みアクセスを制御します。組み込みツール：各組み込みツールに対して、許可 / 確認 / 拒否ポリシーを設定します。高リスクの操作については、承認カードが表示されます。 |
Waker の設定
記憶の管理
各 Waker は、あなたとプロジェクトに関する長期記憶を維持します。記憶は 3 つのソースから構成されます。
自動キャプチャ：Waker は会話から重要な情報を自動的に保存します。
手動入力：記憶ページに移動して、エントリを直接編集できます。
システムレビュー：システムは定期的に記憶エントリを整理し、重複を排除します。
[Waker Details] → [Memory] に移動して、すべての記憶エントリを参照、検索、編集します。記憶はローカルに保存され、クラウドにはアップロードされません。
スキル
スキルは、Waker が対話型タスクまたは自動タスク中に呼び出すことができる機能パッケージです。
スキルマーケットプレイス：公式の Qoder CN スキルマーケットプレイスからインストールします。
スキルのアップロード：ローカルマシンからカスタムスキルをインポートします。
組み込みスキル：標準で組み込まれており、アンインストールはできません。
[Waker Details] → [Skills] に移動して、インストール済みのスキルを表示したり、マーケットプレイスを検索したり、カスタムスキルをアップロードしたりします。
コネクタ
コネクタは、Waker を外部ツールやサービスと連携させます。コネクタは手動で追加できます。
プロジェクト
プロジェクトは Waker のワークスペースを定義します。[Waker Details] → [Projects] に移動して、以下を実行します。
ローカルディレクトリまたはコードリポジトリを紐付けます。
プロジェクトには複数のソース (ディレクトリまたはリポジトリ) を含めることができます。
プロジェクトには、Waker の個人的な記憶とは別の、独自の記憶を保持します。
権限管理
権限は、Waker ができることとできないことを制御します。[Waker Details] → [Permissions] に移動して、保護カテゴリと組み込みツールのポリシーを設定します。
ツール保護：組み込みのセキュリティルールに基づいてツールパラメータを検証します。高リスクのルールがトリガーされた場合、ユーザーの承認を要求します。ルールカテゴリは次のとおりです。
コマンドインジェクション：
rmやmvなどの危険な操作を検出します。リソースの不正使用：フォーク爆弾、システム再起動、および同様の脅威を検出します。
コード実行：
curl | bashのようなリモート実行パターンを検出します。ネットワークの不正使用：リバースシェルやローカルループバックアクセスを検出します。
機密ファイルへのアクセス：重要なシステムファイルへのアクセスを検出します。
権限昇格：
sudoの使用などの権限昇格の試みを検出します。
ファイル保護：Waker のローカルファイルへの読み取りおよび書き込みアクセスを制御します。
組み込みツール：Waker が利用できる各組み込みツールに対して、許可 / 確認 / 拒否ポリシーを設定します。
Waker のアクションがセキュリティルールに抵触すると、承認カードが表示され、操作を許可または拒否できます。
例：バグの自動修正
これには 2 つの方法があります。
方法 A：手動で会話を開始する：コンソールを開き、「バックエンドエンジニア」ロールの Waker を選択します。チャットボックスに 「このエラーの根本原因を見つけて、最小限の修正を提供してください」と入力し、エラーメッセージを添付します。Waker は問題を分析し、根本原因を特定し、解決策を提案します。承認すると、修正を適用して PR を送信します。コマンドの実行やファイルの変更の前に、承認を求められます。
方法 B：自動タスクを設定する：[Waker Details] → [Triggered Tasks] → [New] に移動します。トリガー方法として [Event] を選択し、GitHub リポジトリでの課題の変更を監視するように設定します。タスクの説明には、「新しいバグの課題が作成されたら、自動的に分析し、修正を含む PR を作成してください」と記述します。保存後、リポジトリに新しいバグの課題が表示されるたびに、Waker は自動的に分析と修正プロセスを開始します。
フィードバック
課題の報告や機能の提案を行うには、コンソールの右下隅にある [Feedback] ボタンをクリックしてください。フィードバックには迅速に対応いたします。