跳到主内容

base 使用指南

dsh 共享核心的 profile 组合包:在空 profile 根上一次性插入模型适配、工具、持久化、沙盒、遥测等基础插件行,作为所有 profile 的第一层

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

deepseek-harness-ux(packages/bundle/base)

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @deepseek-ai/dsh-base

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • Agent Loop、模型路由、工具、权限、沙箱和 Session Log 仍沿用 DeepSeek Harness 的执行方式。
  • 原始思考、上下文、命令和工具证据没有被删除,只是收进“运行详情”。
  • 展示辅助不会修改 System Prompt、用户消息、工具、原始回答或会话历史。
  • Session Log 默认仍保存在本地。
  • 这是基于上游源码快照维护的社区版本,不会自动获得官方后续的修复、兼容性更新和安全更新。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装上后会自动获得 DeepSeek 联网搜索能力吗?

是。patch 注册了 DeepSeek 官方搜索路由,复用 Models 页管理的同一个 API Key,超时 60 秒;fetch 默认关闭。

Windows 上跑这个 bundle 需要额外装什么吗?

不需要。bash 与 pwsh 两套 shell 栈在同一份 patch 内按平台互斥挂载,Windows 自动启用 pwsh;若想换不受沙箱约束的本地 PowerShell,需在自己的 patch 中完整覆盖(同时切换两行,缺一会在加载时报错)。

默认是否会上送遥测数据?

不上送。session-telemetry-otel 默认 mode: 'DISABLED';需设置 DSH_TELEMETRY_MODE=FULL 或 FEEDBACK_ONLY 才会上报,DSH_TELEMETRY_OTLP_URL 可改端点。

想换默认模型,应该改这个 bundle 的 patch 还是改 settings?

改 settings。在 $DSH_HOME/settings.yaml 中写 llm-deepseek: 或 llm-pi-ai: 段即可热更新,Web 的 Models 页面写的就是这个文档。

装上后会不会把 Codex / Claude Code provider 也装上?

会作为宿主级 provider 装上但保持休眠。patch 同时挂载 @deepseek-ai/dsh-subagent-codex 与 @deepseek-ai/dsh-subagent-claude-code,是否对模型可见取决于 Agent Preset。

默认的"工作区内可写"沙箱到底管什么?

写入被限制在当前工作目录与该会话的临时子目录;只读模式不授予任何写入权限。Windows 上由 ACL 受限令牌 runner 强制。

我在 profile 写了 cordis.patch.yml,会不会和这个 bundle 冲突?

不会冲突,但按 id 整体替换该行的 config;没有深度合并,升级 bundle 时自定义覆盖仍按 id 命中整行。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6+
  • Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则