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