配置参考

#配置位置与生效方式

配置即 DSH profile 中的 mnemon 条目。DSH 的 settings 服务把用户值写入 profile patch：

$DSH_HOME/profiles/<profile>/cordis.patch.yml

Web profile 的 patch 通常是 ~/.dsh/profiles/web/cordis.patch.yml。旧宿主留下的 settings.yaml 会被导入 profile 一次，并保留为 settings.yaml.imported，参见DSH 0.1.7 设置恢复。当前全部配置标记为 live 生效；改动生效时会先初始化候选运行图，再原子切换 Host 服务。

执行中的回合保留已固定的运行图。已经派发的子 Agent 保留委托运行图直到本次 activation 销毁，即使父回合已结束；后续父回合和新委托的 activation 使用新 generation。保存设置不会静默扩大既有任务的 Recall 权限。

与 DSH 0.1.7 对所有自带配置的插件一样，Web 界面在“插件”中该插件自己的页面编辑 Mnemon 的设置，而不在“设置”中。界面指南展示了每个部分。

开关与选择器立即生效；存储目录、嵌入连接、审查参数与组件选项等需要输入的值要点击应用。Provider 可复用的服务字段（服务地址、凭据、可执行文件）保存在 Provider 注册表中，而不是 Mnemon 的 YAML；启用或保存 Provider 时，会把它已有的命名空间发现到记忆空间 → 概览，关闭时只移除这些本地映射。其他高级项需要直接修改 YAML。

OpenViking user key 没有 admin 权限时，可组合服务字段 discoveryUser、endpoint、apiKey、account，显式发现单个用户的记忆空间；discoveryUser 留空仍枚举 admin。服务字段保存在 Memory Spaces 的 Provider 注册表，不是新的 Mnemon 顶层 YAML 设置。参见 OpenViking 配置与兼容性。

#完整示例

mnemon:
  storageScope: global # global | workspace | custom | workspaces
  runtimeUserScope: storage # storage | global
  # dataDir: ~/mnemon-data       # custom 时必填
  # cliPath: /opt/homebrew/bin/mnemon
  # store: legacy-store          # 兼容发现提示，不是常规路由目标
  timeoutMs: 10000
  defaultRecallLimit: 10
  runtimeMemory:
    memoryLimitBytes: 10240
    userLimitBytes: 4096
    maintenanceMaxTokens: 8192
  embedding:
    enabled: false
    endpoint: http://localhost:11434
    model: nomic-embed-text
  memoryTopology:
    layers:
      runtime: { enabled: true }
      documents: { enabled: true }
      memory-spaces: { enabled: true }
  recallQuality:
    policy: strict-v1
    lowScoreThreshold: 0.25
    highScoreThreshold: 0.6
    candidateMultiplier: 3
    maxMediumResults: 4
    maxUnknownResults: 2
  routingGuidance: true
  lifecycleEnabled: true
  recallMode: guided
  writebackMode: guided
  idleReviewMs: 30000
  idleReview:
    enabled: true
    runtimeMemory: true # false：只建项目档案
    provider: spawn
    fallback: spawn
    agentTeams: pause # pause | scoped
    minIntervalMs: 300000
    maxPerSession: 20
    maxContextChars: 24000
    maxTokens: 4096
  tabEnabled: true
  writeEnabled: true
  taskAgentModel:
    mode: inherit # inherit | fixed
    # provider: deepseek # fixed 时必填
    # model: deepseek-chat # fixed 时必填
  remoteAccess: read-only # 远程管理：read-only | trusted-host

#选项

所有值都保存在 mnemon 条目下并实时生效：界面的 mnemon-ui 设置范围保存为 conversationInteraction，mnemon-view 设置范围保存为 memoryView。存储根只会在新运行图初始化成功后原子切换。

#Runtime Memory 容量与维护预算

长会话可以提高两类热记忆的字节上限和有界迁移/压缩 worker 预算，无需再补丁修改生成的包文件：

mnemon:
  runtimeMemory:
    memoryLimitBytes: 20480
    userLimitBytes: 10240
    maintenanceMaxTokens: 32768

默认值保持已发布版本的 10240 / 4096 / 8192 行为。保存后会构建新的运行图，后续 Runtime 读取、写入、容量维护与 Mnemon Pack 校验统一使用这组上限。已有条目与 memories.json 格式不变。若把字节上限降低到当前用量以下，不会删除数据；Runtime 视图会显示超容状态，后续写入需要先压缩或重新提高上限。回滚只需删除该配置块或恢复默认值。

存储字节上限计算条目正文和分隔符。模型快照中的重要性与时间跨度注释不占用存储容量，但会占用 Strategy 已有的投影字符预算；它们不增加排序、相关性过滤或独立配置。

运行时记忆页面显示每个文件的已用大小与上限。

#Mnemon Native 嵌入

从 Finder 或 Dock 启动的 macOS 应用通常不会继承交互式 shell 启动文件。在 Mnemon Native 中开启“由 DSH 管理嵌入配置”，即可让保存值成为每个 Mnemon 子进程的权威配置：

mnemon:
  embedding:
    enabled: true
    endpoint: http://127.0.0.1:11434
    model: qwen3-embedding:0.6b

OpenAI 兼容服务器把 endpoint 指到 /v1 基础 URL 即可，Mnemon 会自动从 Ollama 协议切换到 OpenAI 协议（/v1/embeddings）；需要认证的服务填写 apiKey，它将以 Bearer 头注入。不以 /v1 结尾的兼容端点用 protocol: openai 显式指定协议：

mnemon:
  embedding:
    enabled: true
    endpoint: http://127.0.0.1:8080/api
    model: bge-m3-mlx-8bit
    apiKey: sk-...
    protocol: openai

Host 会复制正常进程环境，然后只在子进程中覆盖 MNEMON_EMBED_ENDPOINT、MNEMON_EMBED_MODEL、MNEMON_EMBED_API_KEY 与 MNEMON_EMBED_PROTOCOL（protocol: auto 时不注入协议变量，由 Mnemon 按 /v1 自动探测）；不会修改桌面会话、launchctl、shell 文件或 Mnemon 持久数据。保存后会切换到新的运行图，后续调用无需重启 DSH 即可使用新值。enabled: false 或省略 embedding 时，dsh-mnemon 不注入覆盖值，原有继承环境与 Mnemon 内建默认值保持不变。MNEMON_EMBED_DIMENSIONS 仍属于可通过 Host 环境继承的高级配置。

Endpoint 必须是不含凭据、查询参数或片段的 HTTP(S) 绝对 URL。Mnemon 会把记忆与查询正文发给该服务；apiKey 与其他设置一样保存在 DSH 设置文件中，远程明文 HTTP 会暴露传输内容，请使用受信任的回环地址或 HTTPS。“测试状态”会针对当前默认 Store 执行实际生效的 mnemon embed --status，只报告嵌入服务可达性、模型、Mnemon 报告的解析协议与嵌入覆盖率，不会回填或改写记忆。有未保存编辑时必须先保存，避免把草稿值误报成已生效。

#记忆来源开关

每个记忆 Source 在记忆组合中有一个开关。它通过 DSH 插件管理器打开或关闭该 Source 的 DSH Entry，并在 profile patch 中保存为对应 Entry 的 disabled 行。打开表示允许主策略在需要时使用该 Source，并不强制每一轮召回或写入；关闭会同时停止它的上下文注入、工具、后台任务与数据面 Web/RPC 操作。

关闭是可逆的路由状态，不是删除。它在记忆系统中的页面会保留并标记为未运行，不读取数据面；状态页与管理目录仍可查看。重新打开后使用原来的目录与数据。最后一个运行中的 Source 不能关闭。旧版的 memoryTopology.layers.<id>.enabled 标记会随 Source 一起恢复，只在读不到组件时使用。

WebUI 从实时管理目录读取 Source 实例，新增 Source 无须修改前端。Source type id 匹配配置，Strategy 选择精确的实例 key。设置更新有修订栅栏，候选组合验证成功后才会替换。Core 与 Source 边界会再次检查能力、范围与当前授权。

#召回质量策略

strict-v1 是面向 Agent 的安全默认值：仅对明确声明为 0–1 标准化相关度的 Provider，在正文进入 Agent 前移除非正分和低于阈值的结果；随后在请求上限内保留全部高相关度结果，默认最多保留 4 条中相关度结果和 2 条无 score 或未知量纲结果，不再用较弱证据补满 limit。balanced-v1 把低分结果放在主要证据之后，exhaustive-v1 为直接检查保留有限分数结果。超出声明范围的分数按未知量纲处理，不伪造成置信度。跨 Provider 排序继续使用倒数排名融合。

这些是 Memory Spaces Source 自己维护的纯函数召回质量策略，配置只能选择已随该 Source 提供的策略 ID。内部注册函数不是公开插件 API；自定义检索实现应通过 Source/Provider 的公开契约接入。非法候选上限、决策或选择会回退到 strict-v1；配置未知 ID 会拒绝候选运行图。过滤计数通过结构化的 source.quality 返回，不会拼接进 Agent hint。

#浏览器认证

DSH 负责浏览器认证或配对，以及 Host/Origin 校验。远程页面使用命名空间 API Gateway，本地回环客户端与 DSH 桌面版窗口（dsh-app://app/）使用各自的通道；只有 DSH 为页面声明了不持有 Host 的传输方式时，应用页面才按远程页面处理。Mnemon 网关映射单独执行 remoteAccess：read-only 允许普通读取、小范围激活和设置查看，但拒绝写入、ZIP 操作、View 变更与设置修改；没有 trusted-host 授权时，设置快照报告 writable: false。修改这项仅在启动时读取的策略后请重启 DSH。DSH trustedHosts 不能代替 HTTPS 或部署层访问控制。writeEnabled=false 是产品级只读模式，不能代替传输层认证。

完整的代理、启动 token、可信 authority、重启与验证流程见云端 WebUI。

#存储范围

#global

MNEMON_DATA_DIR when non-empty
  otherwise ~/.mnemon

适合希望多个工作区共享 Runtime、Documents 和 Memory Spaces 的用户；其他 Mnemon-enabled Agent 使用相同根时，也可以共享其中的 Mnemon Memory Spaces。

#workspace

Agent / 工具 / 生命周期：resolve(currentSession.header.cwd, ".mnemon")
Web 工作台查看：resolve(workspaceRegistry.get(selectedWorkspaceId).path, ".mnemon")

每个 DSH 工作区拥有独立的记忆根，包含运行时记忆、项目档案与记忆空间。对话 Agent、模型工具、命令和生命周期按当前会话的 cwd 路由；Web 发起的独立任务 Agent 则显式使用工作台选择的 Host 已登记工作区，不能提交任意路径。因此，没有选中主会话时，整理名称与说明、Agent 查询、存入记忆和档案归档仍会写入记忆系统顶栏选定的工作区。

Headless 没有 workspaceRegistry；其新 session 的 cwd 就是启动 dsh --profile headless ... 的目录，因此 workspace 直接解析为 <启动命令 cwd>/.mnemon。

#全局 USER.md 与工作区项目记忆同时生效

若要跨仓库共享用户级协作要求，同时隔离项目事实，可在插件 → 可组合记忆页面把存储范围选为“工作区”，并在“运行时记忆”页面把用户画像范围选为“全局共享”，或配置：

mnemon:
  storageScope: workspace
  runtimeUserScope: global

此后每回合会把全局根（设置 MNEMON_DATA_DIR 时使用该目录，否则使用 ~/.mnemon）的 USER.md 与 <workspace>/.mnemon 的 MEMORY.md 一起投影。target=user 变更和本地 USER.md 压缩只写全局事实源；target=memory、Documents、Memory Spaces 与 Provider state 仍留在工作区。全局 MEMORY.md 和工作区 USER.md 条目会完整保留在磁盘，但在该模式下不进入投影。

切换设置不会复制、合并或删除条目；改回 runtimeUserScope: storage 后，原工作区 USER.md 会重新可见。Mnemon Pack 仍表示一个所选存储根，因此工作区 Pack 不会暗中带入独立的全局 USER.md；重要的全局档案需要单独备份全局根。

#workspaces

这是 Starter 的内置模式，无需额外安装插件。在“存储范围”中选择“集中存储 · 按工作区隔离”，如需自己的集中根目录，在同组“数据目录”中选择“自定义”。

mnemon:
  storageScope: workspaces
  dataDir: ~/central-memory # 可选；默认 MNEMON_DATA_DIR 或 ~/.mnemon
  runtimeUserScope: global # 可选；只共享 USER.md

四个 area（runtime、data、documents、state）都保存在 <集中根>/workspaces/<规范工作区路径的 SHA-256>/。现存符号链接别名解析到同一 ID，不同工作区路径相互隔离。移动或重命名会选择新 ID，不会自动迁移。侧栏跟随所选的已登记工作区，会话标签页和 Headless 跟随所属会话 cwd。即使集中根为自定义目录，全局 USER.md 仍使用 MNEMON_DATA_DIR 或 ~/.mnemon。

工作区身份解析允许尚未创建的目录后代，包括 Unicode 名称和符号链接别名下的后代。若路径位于现存文件之下，所有平台（包括 Windows）都会在计算存储 ID 之前以 ENOTDIR 拒绝。有效 ID 保持不变，既有存储不会被移动、改写或删除。

切换范围不会迁移、合并或删除旧根。ZIP Pack 仍只包含当前工作区根；要保留全部工作区，请备份整个集中目录。远端 Provider 命名空间仍遵循自身共享语义。

#custom

mnemon:
  storageScope: custom
  dataDir: /absolute/path/to/mnemon-data

也允许 ~ 和 ~/...。相对路径会被拒绝。

#选择跨 Agent 共享范围

Mnemon Native 通过 data/<store>/mnemon.db 与其他 Mnemon-enabled Agent 原生互操作；三方引擎通过配置的 Provider 作用域互操作。Runtime、Documents、DSH 激活状态和 UI 元数据仍属于 dsh-mnemon 管理范围。见长期记忆 Provider。

第三方服务配置、记忆空间范围配置与 Secret 保存在当前范围根目录的 state/memory-providers.json，不会写入 profile patch。服务配置由同一 Provider 的多个记忆空间复用；运行时才与单个记忆空间配置合并。Mnemon Native 的 ZIP 只包含 Runtime、Documents 与原生记忆空间；第三方服务数据、连接凭据和本地三方 Store 不进入该 ZIP。

#CLI 发现优先级

config.cliPath
  -> executable MNEMON_CLI_PATH
  -> each PATH directory
  -> Windows: GOBIN/mnemon.exe
              first GOPATH/bin/mnemon.exe, or ~/go/bin/mnemon.exe
              %LOCALAPPDATA%/Programs/mnemon/mnemon.exe
              %ProgramFiles%/mnemon/mnemon.exe
  -> Unix: ~/.local/bin/mnemon
           /opt/homebrew/bin/mnemon
           /usr/local/bin/mnemon
           /usr/bin/mnemon

显式 cliPath 会被采用；既可以填写完整路径，也可以填写 PATH 中的命令名（例如 mnemon）。状态检查与实际调用使用同一套发现规则，并在重新检查时识别安装或移除的 CLI，无需重启 DSH。若显式指定的命令不可执行，实际调用会返回启动错误，不会悄悄改用其他 CLI。Windows 自动发现接受普通 .exe 文件及经过验证的官方 npm mnemon.cmd 启动器。npm 启动器通过 Node 调用，全程不使用 shell；任意其他 .cmd 与 .bat wrapper 仍被排除。迁移至 npm 后，请将显式 CLI 配置指向 npm 启动器，并在“状态 → 检查版本”核对可执行文件路径。

#兼容 Store 提示优先级

config.store
  -> MNEMON_STORE
  -> <storageRoot>/active
  -> default

Memory Space 目录建立后，长期语义操作使用明确的记忆空间 ID，不依赖全局 active Store 进行路由。

#后台任务 Agent 的模型路由

整理名称与说明、Agent 查询、记忆系统与对话中的存入记忆和档案归档会创建一个无会话历史的独立顶层任务 Agent。它使用当前查看工作区作为 cwd；即使没有选中主 Agent session，也能落到左上角选定工作区。任务完成后 Agent 会被释放。

默认的 inherit 先使用 DSH“创建新会话”时的默认 Provider / Model；该路由不可用时才沿用当前可用主 Agent 的完整模型路由。在“分层策略”页面的“后台任务 → 任务 Agent 模型”中选择“指定模型”后，会保存完整的 Provider + Model，并只覆盖 Mnemon 后台任务，不改变对话主 Agent。独立任务 Agent 内部如需语义判断，仍可调度受限 worker；该 worker 继承任务 Agent 的模型路由。

mnemon:
  taskAgentModel:
    mode: fixed
    provider: deepseek
    model: deepseek-chat

DSH 的实时模型目录会报告各模型的输入模态，选择器为支持图片的模型标记图片输入。选中它不代表 Mnemon 后台任务会摄取图片：整理名称与说明、Agent 查询、存入记忆、智能选择与档案归档仍只提交文本与有界证据。在主对话中，dsh-mnemon 追加生命周期指引时会保留 DSH 管理的图片块及其附件引用，活动阈值只计算文本块。原始图片字节不会复制进运行时记忆、项目档案或记忆空间。

#Provider 要求

普通 worker 会优先选择 spawn；如果没有该名称，可以选择另一个具备全部能力的 provider：

toolFilter   = true
persona      = true
depthLimit   = true

后台审查默认使用不继承父上下文的 spawn Provider，并从父 Agent 当前公开 surface 构建有界检查点。仅收录完整可见文本消息与成功工具结果，不重建被省略或不可用的上下文。idleReview.provider: fork 保留完整父上下文审查，并要求 inheritsParentContext=true。fork 缺失或不兼容时，idleReview.fallback 在启动前选择 spawn 或 skip；已启动的运行绝不通过其他 Provider 重试。

审查要求本地子 Agent 发布、agents.isOwnedBy 和 agent.ctx.tools.guard；guard 同样阻止无关的 own-scope 插件工具与 Code Mode 子调用。maxContextChars 限制 spawn 检查点；maxTokens 限制每次模型响应，不限制 fork 继承输入或多步运行的总用量。

**审查写入什么。**每条知识只进一层。项目记录（设计、实现细节、路径、端口、范围约定、交接说明等）最多写成一份项目档案。工作记忆（MEMORY.md）只收用户明确说过的简短规则，例如约定、纠正、环境事实或工具特性，且项目档案和已有条目都未涵盖；USER.md 收身份与偏好。guard 让每轮审查只写一层：建了项目档案后，修改工作记忆会被拒绝；修改工作记忆后，新建项目档案会被拒绝；USER.md 的修改不受影响。idleReview.runtimeMemory: false 会从审查中收回 mnemon_runtime_memory，审查只创建项目档案。审查从不写入记忆空间：工作记忆在容量整理时归档进去，项目档案在冷归档时建立索引；存入记忆与 mnemon_remember 则直接写入。

idleReviewMs 仍是连续空闲防抖时间。独立的 minIntervalMs 限制尝试间隔，失败与取消也计入；maxPerSession 限制当前加载的父 Agent 的尝试次数，零表示暂停。清空或压缩上下文时 DSH 会替换该 Agent；这与重启 Host、卸载后重新打开 Agent 一样，都会获得新的内存内预算。运行结束通过 DSH 公开 API dispose。持久会话历史保留：已发布 Host 没有插件范围的归档/TTL 契约，Mnemon 不删除会话文件或其他插件的 Agent。

**Agent Teams 兼容：**现有配置默认保留 idleReview.agentTeams: pause。同时检测到公开 agentTeams 服务与父 Agent 作用域的 spawn_teammate 工具时，在创建子代理前暂停。仅加载 TeamService 不会暂停审查。

DSH 与全部官方 Agent Teams 组件均为 0.1.7-rc.2 时，可在分层策略页面（插件 → 可组合记忆）的空闲审查中选择受限子代理审查，或设置 idleReview.agentTeams: scoped。该已发布 Team 策略兼容有界 spawn 与显式 fork。此模式仍检查父子归属、本地子代理发布、maxDepth: 1 和单调的审查工具白名单（包括 Code Mode 子调用）。审查子代理仍不能使用 Team 工具或再次委派；父 Agent 保留 Teams。不会猜测包版本或移除其他插件的策略。缺少 guard/归属能力或策略报错时，运行失败且不通过 fallback 重放。保留 pause 可在安装 Team 工具时不运行审查；也可设置 idleReview.enabled: false，只关闭审查，保留 Teams、召回与主动写入。

有界 spawn 按公开的扁平 user/message 事件读取真实用户证据，仅保留已完成检查点之前、当前可见的完整消息；注入的召回、摘要和没有真实用户来源的消息不会被提升为用户断言。配置的字符预算内，明确决策与禁止写入指令都以整条消息保留。

失败的审查仍计为失败。如果失败前已有写入提交，工作区显示子运行 id 和已提交变更回执元数据，包括 Code Mode 外层失败前已提交的内部工具。不自动回滚或重放。手动重试前请核对该运行、档案 id 或 Runtime revision。后续审查仍遵守冷却和会话预算。只需停用此维护流程时，可在分层策略页面关闭空闲审查，或设置 idleReview.enabled: false。

#只读配置

mnemon:
  writeEnabled: false

效果：

• 不注册模型写工具；
• 写与激活 RPC 保持注册，在 Host 边界拒绝记忆 mutation；
• /mnemon remember 和 /mnemon forget 拒绝；
• Source 管理与模型 action 同样不能绕过 Host 的写入限制。

它是“功能只读”，不是文件系统只读模式：Runtime 控制器仍可能初始化或修复投影，Document 搜索会更新 LRU 访问时间，Mnemon 读命令也可能触发上游数据库迁移。不要把 writeEnabled=false 用作只读挂载的安全承诺。

#开关交互

writeEnabled=false
  -> overrides all explicit semantic writes

writebackMode=off
  -> no write cue, no scored review
  -> explicit writes remain when writeEnabled=true

recallMode=off
  -> no recall cue
  -> explicit recall remains

lifecycleEnabled=false
  -> no lifecycle cues or review
  -> UI, commands, and explicit tools remain

routingGuidance=false
  -> removes only mnemon:routing
  -> runtime-memory context remains

#入口位置：displayMode 与 tabEnabled

记忆系统默认使用 Sidebar：从 DSH 左侧栏打开独立主内容区工作台，使用无 Mnemon Logo 的 DSH 官方风格极简皮肤。设置 displayMode: builtin，或在界面 → 记忆系统入口中选择会话标签页，即可把同一个工作台放进当前会话的 conversation.view 标签页。页面、导航、弹窗和样式全部共用，不维护另一套 builtin 界面。主题作者可在两种位置使用受支持的表面选择器与自定义属性。

侧栏“记忆系统”的样式、折叠图标和选中状态与 DSH 原生“插件”入口一致。重复点击仍保持打开；返回会话或 Esc 会回到当前会话。选择“插件”、其他原生面板或“新建会话”会切换主面板。与任务看板、SSH 切换时，同时同步面板可见性和入口状态，即使其他插件的激活通知遗漏，点击也能重新打开记忆系统。

会话标签页隐藏页眉中的存储模式标记、工作区选择和对齐控件。所有读取、写入和独立任务请求都通过现有 Host 路由跟随所属会话：

既有 runtimeUserScope: global 例外仍让 USER.md 保持全局。切换入口不会改变范围、迁移记忆数据或恢复旧 builtin 导航。选择后立即切换入口。

规范拼写统一为 builtin。历史上的 displayMode: buildin 偏好仍会被识别，运行时与界面统一使用 builtin。Host 启动及配置外部热更新时，通过 DSH 带修订号保护的设置接口自动写回这一个字段；旧客户端 RPC 提交 buildin 也直接保存为 builtin。其他字段和配置注释保持不变，并发期间用户明确选择的 Sidebar 优先，不会被迁移覆盖。

在插件 → 可组合记忆页面保存后，当前界面会立即更新。回环页面上，Client 还会跟随 DSH 的设置文档：在其他窗口保存，或 Host 重新加载了对 profile 的修改，都无需刷新浏览器即可看到。远程页面不接收 DSH 的设置镜像，需要刷新才能看到别处的修改。

如果旧值只来自组合 profile，迁移保存一条规范的用户设置覆盖，不直接改写 profile 文件。只读设置仍识别旧拼写，但不会绕过只读限制写盘；落盘失败会记录在 Host 日志中，不会关闭已归一化的入口。

tabEnabled=false 会实时移除所选入口和工作台；重新开启后恢复配置的入口位置，两种入口不会同时出现。Host RPC、命令和工具保持注册，运行中的 Agent 或命令不会因界面开关而失效。对话中的回合记忆栏与存入记忆仍由各自的界面开关控制，并跳转到所选入口。

#Profile patch 覆盖

包内 cordis.patch.yml 提供默认 config 行。DSH profile 的同 ID 配置可能整体覆盖这行。不要在 profile 的最终 patch 中只增加 cliPath；请改用 MNEMON_CLI_PATH 或用户设置 mnemon.cliPath。确因其他原因需要自定义 profile patch 时，应保留仍需启用的全部键，而不是假设深合并。

已认证网关管理所需的 remoteAccess 覆盖属于这种整行自定义。请使用远程管理操作步骤中的完整、可随升级核对的示例，保留当前配置的其他字段；单独的 config: { remoteAccess: trusted-host } 片段会替换这些字段。

#常见配置

工作区隔离：

mnemon:
  storageScope: workspace

在各会话内使用相同的工作区隔离：

mnemon:
  storageScope: workspace
  displayMode: builtin

显式指定 Windows CLI 路径：

mnemon:
  cliPath: 'C:\Users\alice\AppData\Local\Programs\mnemon\mnemon.exe'

自定义数据盘和较长 CLI 超时：

mnemon:
  storageScope: custom
  dataDir: /Volumes/AgentData/mnemon
  timeoutMs: 30000

保留显式工具、关闭生命周期行为：

mnemon:
  lifecycleEnabled: false

仅关闭后台写回判断：

mnemon:
  writebackMode: off