装完 dsh-data-agent 之后很多人的疑问是「它到底是怎么把『数据模式』塞进我的会话里的」。答案全在预设preset这一层插件不是往界面里硬加一个按钮而是往 DSH 的预设注册表里注册一个名为data-agent的模式再由宿主决定这个模式在哪种会话、带哪些工具生效。把这层机制弄清楚TUI 和 Web 两种入口的差别、升级后报错的原因、installPreset: false的后果就都能自己推导出来。从 standingKeyFor() 到 dsh-agent-preset-registry旧版本里数据模式是靠standingKeyFor()这个调用接入的。当前版本已经不再调用它——它被移除了。取而代之的是新版dsh-agent-preset-registry插件通过这个注册表把 data-agent 预设注册进去。这是一个值得注意的迁移信号预设的接入方式是跟着 DSH 主干走的如果你从很旧的版本一路升上来遇到的第一类问题往往就出在这层。预设是从哪个目录读出来的预设不是编译进插件包里的固定字符串而是从磁盘上的目录读出来的对 data-agent 来说presetId就是data-agent默认$DSH_HOME位于~/.dsh。目录里有两个文件是机制的关键agent.cordis.yml描述这个预设由哪些插件组成preset.yml存的是预设元数据。插件在启动时会读这两个文件静态扫描里能看到对应的读取点把它们变成可用的预设。所以「预设」对 DSH 来说是一份可读、可改、可覆盖的配置不是一个封闭的黑盒——这也解释了下面所有和自定义有关的行为。宿主注册表负责什么预设注册进去之后真正决定它「在哪、怎么用」的是宿主注册表。README 列了三件事工具作用域、空会话切换和卸载。工具作用域数据模式会带上它需要的那批工具查询、报表生成等宿主负责把作用范围界定清楚不让它越界到别的场景。空会话切换在一个还没指定模式的空会话里切到 data-agent 是由注册表完成的。卸载卸载插件时注册表负责把预设一并摘掉不会在$DSH_HOME里留一个孤儿预设。README 同时明确了一句现有自定义预设与名称保持不变。也就是说升级插件不会把你已经建好的预设名和内容动掉。installPreset: false 会关掉什么如果你的配置里把installPreset设成了false插件会禁用自身的预设安装及注册。后果很直接插件装是装上了但不会有 data-agent 预设被注册进来你也就找不到「数据模式」这个入口。README 给的出路是——此时需要由其他宿主插件来声明预设。这个开关的意义在于「谁说了算」。团队做统一预设分发的时候往往不希望某个子插件自作主张往注册表里塞预设而是由一个统一的宿主插件集中声明installPreset: false就是给这种情况准备的开关。升级后第一次启动prefix 会被自动补上新版 DSH 要求预设里的persona.config.prefix是必填的。为了让老预设能继续跑插件在升级后的首次启动会自动更新已识别的原版 data-agent 预设让它兼容这个必填字段同时保留已有的text字段。README 特意强调自定义过的预设不会被覆盖。这最后一句是一把双刃剑你的自定义被保护了但也意味着如果你自己改过这个预设、恰好又缺prefix自动修补不会碰它启动就会报$.prefix missing required value。解法是手工的备份$DSH_HOME/.agent-presets/data-agent/agent.cordis.yml默认在~/.dsh在persona的config里让prefix与原来的text使用相同提示词然后重启。两种入口的差别Web「数据模式」和 TUI 斜杠命令同一套预设、同一套工具在两个 profile 下的打开方式不一样。Web 界面dsh --profile web是图形化路径新建会话时选择「数据模式」选中之后连接入口出现在两处——新会话页「数据模式」旁的「连接配置」或进入会话后输入框右上角的数据库图标。填完连接信息工作台里可以直接点「测试连接」验证连通性连通之后直接在对话框里提问。终端dsh --profile dsh-tui是命令路径分两步/preset data-agent负责切到数据模式/database connect负责建连接两步都做完才能提问。区别在于 Web 把「选模式」和「配连接」做成了可视化的点击与状态提示连接配置、库表浏览、数据治理、SQL 执行都在工作台里TUI 则把它们拆成两条命令适合键盘流。两种方式的产物是一致的分析需要可视化时会生成单图或多维 Dashboard并自动把独立的离线 HTML 报告写到工作目录的analysis-reports/下。安装与版本边界两条安装命令分别对应两个 profile版本边界必须记牢插件 0.2.2 的 peerDependencies 全部要求0.2.0-rc.1其中deepseek-ai/cordis钉在精确版本4.0.4README 声明的也是0.2.0-rc.1目前已完成运行验证的是0.2.0-rc.2。README 里还有一句给旧版用户的话旧版 DSH 请继续使用相应旧版插件。各插件对不同 DSH 版本的要求、预设形态与安装方式都汇总在 完整插件清单与汉化避坑指南 里动手前可以先对照一遍。如果你还想横向比较同类数据分析插件同一份 完整插件清单与汉化避坑指南 也把它们的安装形态与中文说明放在了一起。总结data-agent 的接入全靠预设这一层注册走dsh-agent-preset-registry读取走$DSH_HOME/.agent-presets/presetId/生效范围由宿主注册表管想对照同类插件的中文清单与安装形态见 完整插件清单与汉化避坑指南。适合与不适合适合需要理解 DSH 预设机制、准备自己做预设分发的开发者从旧版 DSH 升级上来、要排查预设报错的人偏向键盘流、想用/preset加/database connect的终端用户团队里需要统一预设、考虑installPreset: false的维护者。不适合DSH 还停在 0.1.x、暂时不打算升级的用户只想点开就看图、完全不关心配置层次的纯业务使用者不准备维护任何本地配置、希望装完零心智的人。标签dsh-data-agent、DeepSeek Harness、预设注册机制、dsh-agent-preset-registry、TUI 与 Web 入口本文由 DeepSeek Harness Hub 自动整理数据来源于插件详情页。