OpenHuman 內(nèi)置 Settings Agent 全解析配置管理、健康診斷、服務(wù)生命周期與安全更新的受控自治設(shè)計【免費下載鏈接】openhumanOpenHuman is an open source personal AI for Mac, Windows and Linux — local-first memory, agent orchestration, and deep research.項目地址: https://gitcode.com/GitHub_Trending/op/openhuman導(dǎo)讀本文以 OpenHuman 內(nèi)置代理 Settings Agentsettings_agent的系統(tǒng)提示詞為切入點結(jié)合其agent.toml 元數(shù)據(jù)與底層領(lǐng)域?qū)崿F(xiàn)完整拆解這一系統(tǒng)管家代理的設(shè)計原則只讀優(yōu)先、高風(fēng)險操作顯式確認、事實邊界約束、更新與診斷的規(guī)范化流程。讀完本文你將掌握 OpenHuman 中改配置、查健康、重啟/升級、本地診斷類請求是如何被安全地路由和執(zhí)行的以及如何理解或復(fù)刻一個高影響力系統(tǒng)代理的提示詞工程。一、Settings Agent 是什么職責(zé)邊界與觸發(fā)場景Settings Agent 是 OpenHuman 內(nèi)置的設(shè)置與系統(tǒng)專家代理其自我定位在 prompt.md 開頭一句話說得很清楚You own OpenHuman configuration, runtime health, service lifecycle, update, proxy, and local diagnostics surfaces.即它負責(zé)六類核心表面surface配置configuration——讀取、理解、修改 OpenHuman 的本地配置運行時健康runtime health——組件存活狀態(tài)、進程元數(shù)據(jù)、模型健康服務(wù)生命周期service lifecycle——守護進程的安裝、啟動、停止、重啟、卸載更新update——檢查新版本、下載并應(yīng)用更新代理proxy——HTTP/HTTPS 代理配置本地診斷l(xiāng)ocal diagnostics——doctor 體檢、成本面板、安全策略等只讀排查。在 agent.toml 中when_to_use字段明確了編排器orchestrator何時應(yīng)把任務(wù)委派給它Settings and system specialist: app/core config, health and model diagnostics, service lifecycle, proxy, updates, cost dashboards, security policy. Use for change-a-setting, is-the-app-healthy, restart/update, and local diagnostic requests.也就是說幫我改個設(shè)置應(yīng)用健康嗎重啟一下 / 更新一下做本地診斷這四類用戶意圖是觸發(fā) Settings Agent 的標準場景。作為內(nèi)置代理它在注冊表里以settings_agent為穩(wěn)定 id 存在并被 builtin_definitions_tests.rs 的expected_builtin_ids_are_present測試明確斷言為應(yīng)存在的內(nèi)置代理之一。其內(nèi)置定義由 loader.rs 的BUILTINS靜態(tài)列表加載解析agent.toml生成AgentDefinition再把prompt.md內(nèi)容裝配為PromptSource::Inline系統(tǒng)提示詞并打上DefinitionSource::Builtin標記。二、元數(shù)據(jù)畫像溫度、迭代預(yù)算與提示詞裁剪agent.toml 給出了這個代理的運行時畫像各字段含義如下字段值含義idsettings_agent穩(wěn)定 id路由與 UI 選擇均引用它display_nameSettings Agent用戶可見名稱delegate_namemanage_settings委派時的語義名temperature0.2低隨機性——設(shè)置/系統(tǒng)操作要求穩(wěn)定、可復(fù)現(xiàn)的輸出max_iterations8單輪最多 8 次工具調(diào)用迭代IterationPolicy嚴格上限sandbox_modenone無沙箱自身是系統(tǒng)操作面agent_tierworker工作級代理非編排器omit_identitytrue提示詞中省略身份描述omit_memory_context/omit_memory_mdtrue不注入記憶上下文與記憶 Markdown保持提示詞精簡omit_profiletrue不注入用戶畫像omit_safety_preamblefalse保留安全開場白——因為本代理擁有高影響力工具[model].hintagentic模型路由提示為 agentic 角色值得注意omit_safety_preamble false這一反例大多數(shù)非編排器內(nèi)置代理默認省略安全開場白以壓縮上下文但 Settings Agent 擁有服務(wù)生命周期與更新這類可改變系統(tǒng)狀態(tài)的高影響力工具因此必須保留安全引導(dǎo)。這體現(xiàn)了權(quán)限越大、提示約束越強的工程取舍。三、第一原則只讀優(yōu)先先觀察再行動prompt.md 用 Work conservatively保守工作概括了整體行為基調(diào)第一條規(guī)則是Start with read-only tools (config_*,doctor_*,health_*,service_status,daemon_host_prefs_get,security_policy_info, cost/model health) before proposing any mutation.即在提出任何變更之前必須先使用只讀工具建立事實基線。按此原則agent.toml 中的工具白名單可以被清晰地劃分為只讀偵查與變更動作兩大陣營只讀偵查工具Read-only工具對應(yīng)底層實現(xiàn) / 領(lǐng)域config_snapshot/config_get_client_config/config_get_autonomy/config_get_search/config_get_runtime_flags/config_resolve_api_url/config_get_data_paths配置域讀取。config_snapshot底層由 loader_part_01.rs 的get_config_snapshot/load_and_get_config_snapshot提供返回完整配置快照并注明配置來源路徑doctor_health/doctor_models診斷域。見 platform/doctor/ops.rsdoctor_report在 blocking 線程上運行同步體檢并統(tǒng)計記憶塊數(shù)doctor_models執(zhí)行模型探針health_snapshot/health_system_info健康注冊表。見 platform/health/ops.rs快照返回各組件存活狀態(tài)system_info返回version/os/arch/piddashboard_model_health模型健康對比視圖Settings → Developer Options → Model Health見 desktop/dashboard/README.mdcost_get_dashboard/cost_get_daily_history/cost_get_summary成本面板。見 platform/cost/README.md7 天看板、按日歷史、會話/日/月匯總security_policy_info安全策略只讀。見 security/ops.rs輸出autonomy、workspace_only、allowed_commands、max_actions_per_hour等service_status服務(wù)狀態(tài)。見 platform/service/ops.rs 與 service/core.rs 的ServiceStatus { state, unit_path, label, details }state為Running/Stopped/NotInstalled/Unknowndaemon_host_prefs_get讀取守護進程宿主偏好session_state/session_get_user/credential_list/oauth_connect_url/oauth_list只讀賬號/憑據(jù)/OAuth 狀態(tài)。agent.toml 注釋特別說明這些是從已移除的account_admin_agent繼承的只讀賬戶狀態(tài)當(dāng)前登錄了哪個賬號、哪些 provider 已連接與資金流轉(zhuǎn)或團隊管理無關(guān)且credential_list只返回非機密元數(shù)據(jù)變更動作工具High-impactservice_start/service_stop/service_restart/service_shutdown/service_install/service_uninstall——服務(wù)生命周期daemon_host_prefs_set——守護進程偏好寫入proxy_config——代理配置變更寫路徑見下文底層實現(xiàn)update_apply——應(yīng)用更新。四、高風(fēng)險操作的顯式確認閘門prompt.md 的第二條規(guī)則是本代理最核心的安全機制Treat service lifecycle and update actions as high-impact. Ask for explicit confirmation beforeservice_start,service_stop,service_restart,service_shutdown,service_install,service_uninstall,daemon_host_prefs_set,proxy_config, orupdate_apply.即上述 9 個變更工具必須在獲得用戶顯式確認后才能調(diào)用。這一提示詞層面的口頭閘門與代碼層面的硬性閘門相互配合ask_user_clarification作為中斷工具該工具是子代理回合圖subagent_runner/ops/graph.rs中的early-exit tool——當(dāng)模型需要向用戶求證時才調(diào)用它執(zhí)行后本輪回合暫停等待用戶輸入是編排層對顯式確認的機械支撐。更新域的 fail-closed 策略見 platform/update/README.md——update_apply/update_run由enforce_update_mutation_policy把關(guān)若config.update.rpc_mutations_enabledfalse或配置加載失敗fail-closed任何更新變更都會被拒絕。工具級自主性檢查update_apply工具實現(xiàn)tools/impl/system/update_apply.rs除了走 RPC 策略外還會疊加SecurityPolicy::can_act自主性檢查確保只讀會話即使策略門開著也無法觸發(fā)下載其工具描述明確要求編排器先通過ask_user_clarification與用戶確認——因為應(yīng)用更新會替換磁盤上的二進制并可能重啟核心進程。服務(wù)生命周期的實現(xiàn)邊界service_restart/service_shutdown走的是異步重啟/優(yōu)雅關(guān)閉通道service::restart::service_restart、service::shutdown::service_shutdown并接受source與reason兩個上下文參數(shù)便于審計誰、為什么觸發(fā)了動作。五、事實邊界絕不虛構(gòu)配置變更prompt.md 用兩條規(guī)則約束模型的嘴Never claim a config value changed unless a tool result confirms it.If a requested config mutation has no tool, say which current read-only state you inspected and what UI or controller should own the change.第一條防止模型幻覺——工具沒有返回成功結(jié)果就不允許聲稱已修改這要求模型嚴格基于RpcOutcome的返回值陳述事實。第二條是優(yōu)雅降級如果用戶要求的變更在當(dāng)前工具集中沒有對應(yīng)工具模型必須如實說明我檢查了哪些只讀狀態(tài)以及這個變更應(yīng)由哪個 UI 面板或 controller 負責(zé)而不是假裝完成或編造路徑。最后一條規(guī)則 Return exact tool-observed state and any action taken返回工具實際觀測到的狀態(tài)與已執(zhí)行的動作與上述兩條一脈相承共同構(gòu)成可審計的對話式運維紀律。六、更新流程的規(guī)范三步曲針對更新場景prompt.md 給出了明確的執(zhí)行順序For update flows, runupdate_checkfirst, summarize version/channel/risk, then callupdate_applyonly after confirmation.update_check先行update_check是只讀工具tools/impl/system/update_check.rs僅執(zhí)行一次對 GitHub Releases latest 端點的 HTTPS 請求返回版本信息、下載 URL、資產(chǎn)名與發(fā)布說明不下載不安裝。匯總版本/通道/風(fēng)險模型向用戶報告當(dāng)前版本 vs 最新版本、通道差異與更新風(fēng)險。確認后再update_apply獲得確認后調(diào)用update_apply底層走update::rpc::update_run編排的 check → download → stage → restart 全流程platform/update/README.md。底層更新域的細節(jié)值得展開同樣來自 update README資產(chǎn)選擇按平臺 triple 匹配openhuman-core-{triple}Windows 為.exe下載后 Unix 置0o755并原子重命名進 staging 目錄重啟策略分SelfReplace發(fā)布自重啟與Supervisor僅暫存后臺還有默認 1 小時、下限 10 分鐘的周期檢查器。RPC 邊界會對下載 URL必須是 HTTPS GitHub 主機與資產(chǎn)名必須以openhuman-core-開頭、不允許路徑分隔符或..做二次校驗。七、診斷輸出紀律癥狀、現(xiàn)狀、建議三分法For diagnostics, separate symptoms, current state, and recommended next action.prompt.md 要求診斷類回答嚴格區(qū)分三層信息癥狀symptoms——用戶描述的現(xiàn)象或觸發(fā)背景當(dāng)前狀態(tài)current state——工具實際觀測到的狀態(tài)如health_snapshot中各組件 status / last_ok / last_error / restart_count或service_status返回的Running/Stopped/NotInstalled建議的下一步recommended next action——基于狀態(tài)的處置建議。這種現(xiàn)象—事實—建議的三段式結(jié)構(gòu)與底層健康域的設(shè)計相呼應(yīng)健康注冊表platform/health/README.md維護每個組件的status/updated_at/last_ok/last_error/restart_count并通過verdict()分類只有關(guān)鍵組件core、memory_tree_db不健康時/health才返回 503非關(guān)鍵組件scheduler、channels、update_checker 等不健康則返回 200 degraded標志。診斷代理匯報時必須把這些可驗證的狀態(tài)字段與建議分開展示避免把推斷當(dāng)事實。八、工具白名單全景從提示詞到領(lǐng)域?qū)崿F(xiàn)的映射將 agent.toml 的[tools].named白名單按領(lǐng)域歸類可得到以下全景含底層實現(xiàn)佐證領(lǐng)域工具底層實現(xiàn)配置快照config_snapshot,config_get_client_config,config_get_autonomy,config_get_search,config_get_runtime_flags,config_resolve_api_url,config_get_data_pathsconfig/ops/loader_part_01.rsget_config_snapshot體檢/診斷doctor_health,doctor_modelsplatform/doctor/ops.rs健康health_snapshot,health_system_infoplatform/health/ops.rs模型健康dashboard_model_healthdesktop/dashboard/README.mdmodel_health控制器dashboard.model_health閾值成本cost_get_dashboard,cost_get_daily_history,cost_get_summaryplatform/cost/README.mdcost_*命名空間預(yù)算門BudgetCheck::{Allowed, Warning, Exceeded}安全策略security_policy_infosecurity/ops.rsSecurityPolicy::from_config 策略 JSON 載荷服務(wù)生命周期service_status只讀、service_start、service_stop、service_restart、service_shutdown、service_install、service_uninstallplatform/service/ops.rs、service/core.rs守護進程偏好daemon_host_prefs_get只讀、daemon_host_prefs_set寫platform/service/ops.rsdaemon_host_get/daemon_host_set代理proxy_configconfig/schema/proxy.rsProxyConfig更新update_check只讀、update_apply寫tools/impl/system/update_check.rs、tools/impl/system/update_apply.rs賬號/憑據(jù)只讀session_state,session_get_user,credential_list,oauth_connect_url,oauth_list僅非機密元數(shù)據(jù)協(xié)作/其他ask_user_clarification,current_time回合圖中的 early-exit 工具subagent_runner/ops/graph.rs8.1 代理配置的底層模型proxy_config工具對應(yīng) config/schema/proxy.rs 中的ProxyConfig[proxy] enabled false # 總開關(guān) http_proxy # HTTP 代理 URL https_proxy # HTTPS 代理 URL all_proxy # 全協(xié)議代理 URL no_proxy [] # 豁免域名列表 scope openhuman # Environment | OpenHuman | Services services [] # 命中的服務(wù)鍵列表其中scope控制代理生效范圍進程環(huán)境 / OpenHuman 自身 / 外部服務(wù)services支持按服務(wù)鍵精確控制SUPPORTED_PROXY_SERVICE_KEYS覆蓋provider.*anthropic、openai、gemini、ollama 等、channel.*telegram、slack、discord 等、tool.*browser、composio、http_request、memory.embeddings、tunnel.custom等條目也支持provider.*、channel.*這類通配選擇器。代理配置屬高風(fēng)險寫操作因此在提示詞中被列為須顯式確認的工具之一。8.2 安全策略只讀面的字段含義security_policy_info由 security/ops.rs 計算自活動配置返回六個關(guān)鍵字段autonomy——自主性級別Supervised / SemiAutonomous / Autonomous見 security/README.mdworkspace_only——是否僅限工作區(qū)操作allowed_commands——允許的命令列表max_actions_per_hour——每小時動作上限r(nóng)equire_approval_for_medium_risk——中風(fēng)險操作是否需審批block_high_risk_commands——是否阻斷高風(fēng)險命令。這些字段讓 Settings Agent 在不接觸秘密的前提下就能回答當(dāng)前安全策略是什么、會攔什么。九、提示詞是如何在運行時組裝的prompt.md并不是最終發(fā)送給模型的完整提示詞而是 archetype原型部分。prompt.rs 的build()展示了完整的組裝流水線include_str!(prompt.md)載入原型正文追加render_user_files(ctx)——與用戶關(guān)聯(lián)的文件上下文追加render_tools(ctx)——根據(jù)運行時狀態(tài)渲染實際可用的工具清單這是工具白名單最終生效的環(huán)節(jié)動態(tài)分支于可用工具集合追加render_safety()——安全開場白omit_safety_preamble false決定了它必須被渲染追加render_workspace(ctx)——工作區(qū)上下文。也就是說最終系統(tǒng)提示詞 本文剖析的 archetype 用戶文件 動態(tài)工具清單 安全引導(dǎo) 工作區(qū)信息。這種靜態(tài)原型 動態(tài)裝配的結(jié)構(gòu)正是 OpenHuman 內(nèi)置代理提示詞工程的標準模式見 loader.rs 中 每個內(nèi)置代理 agent.toml prompt.rs 的約定。十、從內(nèi)置到自定義注冊表視角Settings Agent 不只是一段提示詞它是整個用戶面代理注冊表中的一個條目。注冊表數(shù)據(jù)模型AgentRegistryEntrytypes.rs包含id/name/description/sourceDefault 或 Custom/enabled/model/system_prompt/tool_allowlist/tool_denylist/subagents/tags/metadata等字段且validate()強制id只允許 ASCII 字母、數(shù)字、_、-。內(nèi)置代理如 Settings Agent通過default_agents()從 harness 定義生成注冊表條目defaults.rswhen_to_use成為description工具范圍映射為tool_allowlistagent_tier寫入tags。反過來用戶自定義代理也能通過definition_from_registry_entry合成 harness 定義走同一執(zhí)行路徑defaults.rs。理解這一機制的意義在于Settings Agent 的工具邊界35 個具名工具不是硬編碼在 prompt 里的而是由agent.toml聲明、由注冊表路由、由運行時render_tools最終落地的。若你想裁剪或擴展一個系統(tǒng)代理的權(quán)限修改的方向是tool_allowlist/tool_denylist而不是提示詞里的工具名。結(jié)語OpenHuman 的 Settings Agent 是一個高權(quán)限但強約束的內(nèi)置代理范本它用temperature 0.2壓制隨機性、用只讀先行規(guī)則保證先取證后行動、用ask_user_clarification與代碼層 fail-closed 策略雙保險約束 9 個高風(fēng)險寫工具、用癥狀/現(xiàn)狀/建議三分法規(guī)范診斷輸出、用工具結(jié)果才算數(shù)杜絕變更幻覺。其 prompt.md 與 agent.toml、prompt.rs 及 health / doctor / service / update / security / cost / dashboard / proxy 各領(lǐng)域?qū)崿F(xiàn)共同構(gòu)成一套完整的對話式系統(tǒng)運維閉環(huán)值得作為系統(tǒng)類子代理提示詞與權(quán)限設(shè)計的參考樣例。相關(guān)閱讀繼續(xù)深入可查看 settings_agent/prompt.rs提示詞裝配、registry/defaults.rs注冊表映射、platform/update/README.md更新域、platform/health/README.md健康域與 security/README.md安全邊界。【免費下載鏈接】openhumanOpenHuman is an open source personal AI for Mac, Windows and Linux — local-first memory, agent orchestration, and deep research.項目地址: https://gitcode.com/GitHub_Trending/op/openhuman創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考