QoderWake CN 讓你在本機組建一支"數字員工"團隊（Wakers）。每個員工有崗位、有名字、有人設、有專長，可以被你召喚聊天或幹活，也可以按計劃或事件自動開工。他們能做什麼、用什麼工具、有什麼記憶、能碰什麼不能碰什麼——全部可配。
這份文檔教你從零把 QoderWake CN 跑起來：裝好工具 → 開啟控制台 → 建立數字員工 → 派活 → 管理員工。
產品理念：7×24 小時數字員工，"Always awake, always working."
產品特性：安全可控、生產可用、持續進化。
核心概念：員工角色（Role）→ 數字員工（Agent）→ 團隊 / 組織（Agent Teams）。
首批角色：後端工程師、前端工程師、測試工程師、產品經理、資料分析師、內容營運，同時支援自訂角色。
你需要哪種崗位的員工
當前邀測覆蓋以下角色，選最貼近你需求的即可：
角色 | 崗位特性 |
後端工程師 | 專註於 API 開發、資料建模、服務整合、效能最佳化和線上穩定性。遵循增量交付、測實驗證和約定優先設計的工程實踐。員工自動分析 Bug / Issue，改完代碼直接提 PR。 |
前端工程師 | 專註前端介面設計與實現，擅長組件架構、視覺語言打磨、響應式適配、無障礙最佳化和效能調優。遵循增量交付、分層驗證和基於證據的校正，兼顧使用者體驗與工程品質。 |
測試工程師 | 面向通用命令列工具和 Web 產品的品質保障角色，專註測試計劃文檔、端到端測試、缺陷複現和基於證據的報告；不運行單元測試，也不修複問題。 |
產品經理 | 面向軟體產品的 AI 原生產品管理角色，專註目標驅動的需求全生命週期管理、PRD 產生、使用者反饋分析、競品研究和發布溝通，並對外部寫入設定明確審批門禁。 |
資料分析師 | 面向問題框定、指標口徑、DingTalk文檔/表格 MCP 資料收集、資料診斷、市場背景和證據化建議的 AI 原生資料分析師。 |
內容營運 | 面向帳號定位、熱點洞察、內容日曆、小紅書筆記創作、視覺素材 brief、審批後發布、評論互動、資料複盤、品牌合規和跨平台改寫的 AI 原生內容營運角色。 |
自訂 | 自己定義崗位的工作方式與工作流程，可掛載 MCP、Skill 等任意配置。 |
環境準備
QoderWake CN 支援本地部署和雲端部署。建議部署在穩定線上、網路良好的常開裝置或CloudDesktop環境中，以保障數字員工 7×24 小時持續運行。
Windows 版本敬請期待，暫未對外開放，請先在 macOS 或 Linux 上使用。
本地部署
推薦部署在可長期穩定啟動並執行本地裝置上，例如 Mac mini，以獲得更好的 7×24 小時運行體驗。
macOS：13.0 及以上版本。
Linux：推薦 Ubuntu 22.04 LTS 及以上版本，需啟用 GUI 案頭以使用本地 Web Console。
雲端部署
支援主流CloudDesktop和雲主機環境。為方便瀏覽器登入和本地 Web 管理，推薦使用無影雲電腦企業版或個人版。
Linux：Ubuntu 22.04 及以上版本，需啟用 GUI 案頭以使用本地 Web Console。
前置工具
產品預置多個軟體研發類數字員工角色，安裝前請先準備好 Git 環境，並確認當前帳號能正常訪問目標代碼倉庫：
已安裝
git。已完成倉庫認證配置。
可以正常執行
clone、pull、push操作。
本地或雲端部署環境均需支援外部網路訪問，用於使用者登入、模型調用、代碼倉庫訪問等。在商業網路、代理或防火牆環境下，請提前放通必要的 HTTPS 出站訪問。
步驟 1：安裝 QoderWake CN
macOS
進入QoderWake CN官網，下載安裝包：
或者開啟終端（應用程式中尋找"終端"或 Terminal），運行：
curl -fsSL https://ide.qoder.com.cn/qoderwake-cn/install.sh | bash指令碼會自動檢測平台、下載並校正安裝包、安裝主程式和資源檔、把命令入口加入 PATH、啟動瀏覽器登入、啟動本地常駐服務並開啟 Web Console。命令入口：~/.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 Console。
命令入口：
~/.qoderwake-cn/bin/qoderwake-cn預設 Web Console 地址：
http://127.0.0.1:19830Windows
Windows 版本敬請期待，正式發布後會在本頁同步更新。
步驟 2：開啟控制台
瀏覽器訪問：http://127.0.0.1:19830/。這是 QoderWake CN 在你原生管理台，員工管理、派活、配置許可權都在這裡完成。
介面說明：
左側邊欄：展示"我的 Waker"列表，顯示所有已建立的員工和最近啟用時間。
頂部按鈕：點擊"建立 Waker"快速建立員工，右側支援建立任務。
主地區：進入某個員工後預設開啟對話頁面，可直接派活。
右側邊欄：查看已建立的任務及當前運行中任務的詳情。
首次訪問會引導你登入賬戶，按提示完成即可。
步驟 3：建立數字員工
點擊左側"建立 Waker"按鈕。
選一個角色模板：每個角色模板內建人設、典型工作流程、核心技能集和預設問題，點擊"查看詳情"可以預覽。
或自訂角色：如果預置角色都不合適，可選擇"自訂角色"，完全由你定義這位員工的人設、專長、工作風格，再為其配置技能、連接器和許可權。
填寫基本資料：填寫員工的名字、頭像、簡介。選擇預置角色後內容會自動帶過來，可按需調整。
儲存：點擊儲存，員工就建立好了。新員工首次建立後會進入引導，推薦你先掛哪些技能、接哪些渠道，可以跳過留待後續配置。
為提升自訂角色的使用效果，建議在建立時盡量提供完整的角色資訊——角色定位、核心職責、工作流程、所需技能以及 MCP 等工具能力配置。
步驟 4：跟員工開始幹活
新員工建立完成後，可以選擇直接對話或建立自動任務。
對話任務
直接在輸入框輸入需求並發送，員工就開始幹活。過程中你可以：
追問、調方向：隨時插話，員工接著上下文繼續。
附檔案 / 截圖：任何一輪發言都能再貼。
打斷：員工方向跑偏可以讓他停。
審批操作：當員工要動檔案、跑命令、上網時會停下來徵求同意，你點"允許"或"拒絕"。
回答員工提問：他遇到選擇會回頭問你，直接在卡片上選。
切換 AI 模型：對話中途感覺不夠聰明或想省錢，頂部下拉可以換模型繼續。
看思考過程：能即時看到員工下決定前的推理思路。
看產物：右側面板即時展示員工產出的代碼補丁、新產生的檔案等。
選擇工作目錄：在對話底部可以選擇員工工作的本地目錄。
自動任務
適合"每天跑一次"、"監聽某個倉庫變化就自動響應"這類情境。
進入Waker 詳情 → 觸發任務 → 建立，可配置：
任務名和描述：員工讀了就知道要做什麼。
AI 模型：選哪個模型。
工作目錄：在本地哪個目錄、哪個倉庫或哪個專案工作區裡執行。
觸發方式（最多 5 種，可混用）：
定時：一次性 / 周期性 / 複雜周期（每天 9 點、每周一、每月 1 號等）。
事件驅動：監聽 GitHub 倉庫的 Issue / PR / 評論變化。
最大次數 / 到期日（可選）：限制任務不要無限跑。
儲存後，員工按你設的節奏自動幹活。你可以隨時暫停 / 啟用、立即運行測試、查看運行歷史。
步驟 5：管理你的數字員工
進員工詳情頁能看到、調整他身上的所有東西。
目錄 | 你能做什麼 |
首頁 | 看頭像、狀態、入職天數、觸發任務數、對話任務數、工作熱力圖。 |
專案 | 給他綁定要工作的代碼倉庫或本地目錄。一個專案可包含多個源（多個目錄或倉庫），專案記憶與員工個人記憶分開。 |
觸發任務 | 增 / 刪 / 改 / 暫停他身上的自動化任務。 |
對話任務 | 翻歷史對話，繼續聊。 |
記憶 | 看 / 編輯他對你和專案的長期認知。來源：對話過程中自動沉澱、手動編輯、系統定期梳理與去重。本機存放區，不上傳雲端。 |
技能 | 從 Qoder CN官方 Skills Marketplace 安裝，本地上傳自訂技能，或開關已有技能。內建技能不可卸載。 |
連接器 | 對接外部工具 / 服務（GitHub、Jira、GitLab 等）。 |
許可權 | 工具防護——基於內建安全規則校正工具參數，覆蓋命令注入、資源濫用、代碼執行、網路濫用、敏感檔案訪問、許可權提升等；檔案防護——控制對本地檔案的讀寫權限；內建工具——為每個內建工具設定允許 / 詢問 / 禁用策略。高危操作會彈出審批卡片。 |
員工配置
記憶管理
每個員工有自己的長期記憶，用於積累對你和專案的認知。記憶來源有三種：
自動沉澱：對話過程中員工認為值得記住的資訊會自動寫入。
手動寫入：你可以進記憶頁直接編輯。
系統整理：定期由系統幫他梳理和去重。
進入員工詳情 → 記憶，可瀏覽、搜尋、編輯所有記憶條目。記憶儲存在本地，不上傳雲端。
技能（Skill）
技能是員工在對話或觸發任務中可以調用的專項能力包。
技能市場：從 Qoder CN官方 Skills Marketplace 安裝。
上傳 Skill：本地自行匯入。
內建技能：系統內建，不可卸載。
進入員工詳情 → 技能，可查看已安裝技能、搜尋市場、上傳自訂技能。
連接器（Connector）
連接器是員工對接外部工具 / 服務的橋樑。支援手動添加連接器。
專案
專案是員工的工作空間。進入員工詳情 → 專案，可以：
綁定本地目錄或 git 倉庫。
一個專案可以包含多個源（多個目錄 / 倉庫）。
專案有獨立的記憶，跟員工個人記憶分開。
許可權管理
許可權控制員工能做什麼、不能做什麼。進入員工詳情 → 許可權，包含兩大類，外加內建工具策略。
工具防護：基於內建安全規則對工具參數做校正；命中高危規則後會請求使用者授權。規則分類：
命令注入：檢測
rm、mv等危險操作。資源濫用：檢測 fork 炸彈、系統重啟等。
代碼執行：檢測
curl | bash等遠程執行。網路濫用：檢測反彈 shell、本地迴環訪問。
敏感檔案訪問：檢測訪問系統關鍵檔案。
許可權提升：檢測
sudo等提權操作。
檔案防護：控制員工對本地檔案的讀寫權限。
內建工具：對 Waker 可用的內建工具設定允許 / 詢問 / 禁用策略。
當員工執行操作觸發安全規則時，會彈出審批卡片讓你決定是否允許。
情境樣本：自動修複 Bug
兩種驅動方式。
方法 A——手動發起對話：開啟控制台，選一個後端工程師角色的 Waker。在對話方塊輸入："幫我排查這個報錯的根因並給出最小修複方案"，附上報錯資訊。員工分析問題、定位根因、給出修複方案。確認後讓他執行修複並提 PR。過程中要執行命令或改檔案時，他會先徵求你同意。
方法 B——設自動任務處理：進員工詳情 → 觸發任務 → 建立，觸發方式選"事件"，監聽 GitHub 倉庫的 Issue 變化。任務描述寫："有新 Bug Issue 進來時，自動分析並給出修複 PR。" 儲存後，每當倉庫出現新的 Bug Issue，員工自動啟動分析與修複。
問題反饋
遇到任何問題或者有產品功能想反饋，點擊控制台右下角的反饋按鈕提交，我們會儘快回複 & 解決。