跳到主内容

base 使用指南

把 dsh 全套基础能力打包成 profile 组合包，作为每个 profile 的第一层 patch，承载模型、工具、沙箱、权限、会话持久化等 60+ 基础行。

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

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

快速上手

dshcode — @deepseek-ai/dsh-base

— 源: plugin_wiki.wiki_content

安装与验证

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

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

— 源: plugins.install

关键要点

  • macOS: right-click the app in Finder and choose Open, then confirm in the dialog that appears. Alternatively run xattr -cr /Applications/DSHCode.app once in Terminal.
  • Windows: click More info on the SmartScreen dialog, then Run anyway.
  • LINUX DO — This project is continuously shared and discussed in the LINUX DO community.
  • dsh-genui — Provides the built-in generative UI plugin.
  • dsh-annotation — Provides the built-in selection-annotation workflow.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个组合包包含哪些能力？

它是 dsh 所有"出厂自带"能力的集合——LLM 适配器、Agent 主循环、bash/pwsh 工具、文件系统、subagent 派发、subagent fork、会话持久化（JSONL）、SQLite 会话查询、权限与沙箱策略、设置/凭据本地化、遥测、token 用量计量、压缩、计划模式、目标（goal）循环、Web 搜索等。

我可以编辑这个组合包吗？

不需要也不建议。它的"配置"集中在同一份 cordis.patch.yml，由 profile 组合器在加载时挂入；你的覆盖应该写在自己 profile 的 cordis.patch.yml 里，按 row 的 id 整行覆盖即可。patch 的语义是"替换整行 config"，没有深度合并。

在 macOS / Linux 上跑和在 Windows 上跑有什么不同？

bash 与 pwsh 两套 shell 栈在同一份 patch 文件里互斥挂载。POSIX 上启用 bash-sandbox 与 tool-bash、禁用 pwsh 系列；Windows 上启用 pwsh 系列、禁用 bash 系列。沙箱、权限和 fs-sandbox 在两边都生效，Windows 走 ACL 受限令牌 runner。

怎么开启遥测？

出厂默认关闭。要开启需设置环境变量 DSH_TELEMETRY_MODE 为 FULL 或 FEEDBACK_ONLY，并把 DSH_TELEMETRY_OTLP_URL 指向你的 OTLP/HTTP 收集器。不设 DSH_HOME/.anonymous-user-id 的话导出还会带上随机 UUID 作为 user.id。

默认是哪种权限模型？

沙箱默认 workspace-write（写入限制在工作区与本会话 temp 子目录），审批默认 ask。如果把环境变量 DSH_PERMISSION_MODE 设为 danger-full-access，沙箱变全权访问、审批变 never；设为 read-only 则只读。

卸载它会发生什么？

它是所有出厂 profile 的第一层 patch——把它从 dsh.profile.bundles 里移除，整个 profile 会回到"仅剩用户自定义 row"的空状态，常用工具、模型、持久化都会消失。它本身不是面向普通用户的可选扩展，建议保留。

我可以换成别的默认模型吗？

可以。在自己 profile 的 cordis.patch.yml 里按 id 覆盖 agent-default-model 这一行即可（provider/model 字段整行替换），或在 "$DSH_HOME/settings.yaml" 里配 llm-deepseek / llm-pi-ai 段，覆盖这个组合包默认的 deepseek-official / deepseek-v4-flash 选择。

会话里的图片存在哪里？

实际字节放在 attachment-local 这个 row 配置的本地目录（与 JSONL 会话日志分离）。会话日志里只保留内容寻址引用，由该 row 在每次请求时即时解析。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 未声明
  • Node: >=22.19.0（要求 ^22.19.0 或 >=24.0.0，源自仓库根 engines 字段）
  • Platforms: macOS, Linux, Windows

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则

base 使用指南