本文介绍如何把 dsh-advisor 装入 dsh profile、验证安装与卸载。快速版本见 README。
- 可用的 dsh 运行环境（
$DSH_HOME，默认~/.dsh）与可写的目标 profile（如web）；安装后重启 dsh 会话。 - registry 安装只需 PATH 上有 pnpm（
dsh plugin是 pnpm 转发器）。从源码构建（下文 git / 本地目录 / tarball 安装）另需 node（≥ 22）与私有@deepseek-ai/*peers 的 registry 认证——prepare只运行pnpm build（依赖解析不需要DSH_HOME源码树前置条件；peers 经autoInstallPeers+~/.npmrc认证令牌从 npm registry 解析）。
dsh plugin --profile web add dsh-advisor # <name> = 你的 profile 名
# 需要可复现安装时钉住精确版本：
# dsh plugin --profile web add dsh-advisor@0.1.0registry 安装拉取的是已发布的 tarball，其中自带构建产物（lib/ + cordis.patch.yml）且没有 install / postinstall 脚本——不会运行 prepare 构建，也无需构建权限。运行时依赖（@deepseek-ai/cordis、@deepseek-ai/schemastery 与 @deepseek-ai/dsh-* peers）声明为 peerDependencies，由 dsh 安装的扁平 profile module fallback 解析——无需额外安装步骤。
- 版本钉住：追加
@<version>即可（如dsh-advisor@0.1.0）。registry 包没有 commit 钉住；要测试未发布改动，用下面的本地目录安装。
pnpm install # 构建组合包（prepare 自建）
dsh plugin --profile web add . # <name> = 你的 profile 名dsh plugin add 会把组合包追加到 profile 的 dsh.profile.bundles（包声明了 dsh.bundle）；组合包插入一行插件配置 —— id: advisor，name: dsh-advisor（见 cordis.patch.yml）。本地 add . 走 pnpm 的 link: 依赖，pnpm 不会为 link: 依赖运行 prepare/postinstall——请先用 pnpm install（或 pnpm build）构建好组合包再添加。无需任何宿主补丁：插件完全通过插件配置行运行（见 web Settings 暴露）。
pnpm pack
dsh plugin --profile web add dsh-advisor-0.1.0.tgztarball 附带的是构建产物（lib/ + cordis.patch.yml），因此不会运行 prepare 脚本，也无需构建权限。运行时依赖（@deepseek-ai/cordis、@deepseek-ai/schemastery 与 @deepseek-ai/dsh-{session,agent,llm,commands,timeout}）声明为 peerDependencies，由 dsh 安装的扁平 profile module fallback 解析——无需额外安装步骤。
advisor 也可以用与 web profile 相同的命令装入终端 TUI profile（dsh --profile dsh-tui）：
dsh plugin --profile dsh-tui add dsh-advisor # <name> = 你的 profile 名
# 需要可复现安装时钉住精确版本：
# dsh plugin --profile dsh-tui add dsh-advisor@0.1.0
# 本地目录变体（在已构建的 checkout 中）：
dsh plugin --profile dsh-tui add .组合包把同样的 - insert: id: advisor 行插入 dsh-tui profile 的补丁层（~/.dsh/profiles/dsh-tui/cordis.patch.yml）。每个 profile 在补丁层里持有自己的 advisor entry config——该行的 config 字段是 schema-volatile 的 live 字段（dsh ≥ 0.1.7-rc.1），由 Loader 免重挂载提交；全局 settings.yaml 分节已不存在（pre-0.1.7 的旧文件会在首次启动时被导入活跃 profile 并改名 .imported）。dsh-tui ≥ v0.8.0 时，TUI /settings 屏幕同样可编辑这四个键（provider / model / immuneTurns / maxDeltaMessages）——在 Advisor 分节中暂存编辑，保存时经 revision 栅栏保护的 settings.mutate 写入同一份 advisor entry config（持久化在 profile 补丁层），live 重应用、无需重启。该分节随 v0.8.0+ 组合包的 dsh-tui-settings-sections 行提供；旧版 dsh-tui 干净地 no-op，profile 补丁层仍是编辑路径。systemPrompt 不是 TUI 字段（单行输入）——请经 web 卡片或 profile 补丁层编辑。/advisor config 是回读手段（只读，seam 挂载时编辑提示指向 /settings 屏幕），/advisor / on|off|status|config 则出现在 TUI 的 / 菜单中并带子命令补全（要求 dsh-tui-command-trees 行，随附的 dsh-tui 组合包自带）。
验证：
dsh --profile dsh-tui --dump-config # 显示带 advisor 配置行的 "# == dsh-advisor" 层
dsh --profile dsh-tui卸载：
dsh plugin --profile dsh-tui remove dsh-advisor
dsh --profile dsh-tui --dump-config # 确认 dsh-advisor 层已消失dsh web 的**「插件」页在组合包自己的页面上渲染该组合包的配置，经 plugins.bundle.config 卡片 slot 注册（以组合包包名为 key）。Advisor 卡片（key dsh-advisor）通过 dsh 宿主的 apiproxy describe 读取 provider 目录（已暴露的 llm-* 命名空间），但 advisor 配置只通过官方 GatewayService RPC 通道读写——它不依赖 apiproxy allowlist（allowlist 仅覆盖模型提供者命名空间 + 产品命名空间：locale / permission / ui-conversation / ui-theme / ui-onboarding / agent-presets）。上游 dsh 没有注册级 opt-in（exposeToWebClients 不存在于上游 SettingsRegisterOptions——已在 pristine 20da39e 快照上核实），因此 advisor 命名空间不在 apiproxy allowlist 上**。插件注册 AdvisorConfigGateway（带 @Remote('get')/@Remote('set') 方法的 GatewayService），宿主的 typertGateway 认领 /api/advisor/get + /api/advisor/set（与 dsh 内建 goals 服务同一机制），卡片经 connection.rpc 调用它们。进程内写入（ctx.settings.update）没有 exposed-namespace 检查，因此在任何提供 GatewayService 通道的 dsh 构建上保存都可用。无需也不施加任何宿主补丁。
dsh --profile web --dump-config # 显示带 advisor 配置行的 "# == dsh-advisor" 层
dsh --profile web启动后，web 的「插件」页会在 dsh-advisor 组合包页面上渲染 Advisor 卡片；它通过 /api/advisor/get + /api/advisor/set live 读写 advisor entry config——保存后运行中的会话立即生效。
dsh plugin --profile web remove dsh-advisor
dsh --profile web --dump-config # 确认 dsh-advisor 层已消失重启 dsh 会话使卸载生效。