dshelm

English · 简体中文

[!IMPORTANT] DSHelm 目前是 0.3.0-alpha 源码预览版，npm 包尚未发布。当前适合 DSH 插件开发者和愿意反馈早期体验的用户，不建议用于生产环境。

DSHelm 解决什么问题

当一个任务同时需要强规划、低成本并行执行和独立审核时，固定使用一个模型往往不是最合适的选择。DSHelm 为 DeepSeek Harness 增加一层可解释的调度能力：

• 按能力选择模型：先检查运行时、认证、上下文和成本等硬条件，再对候选模型排序。
• 让每次选择可追溯：展示角色、模型、推理等级、覆盖来源和候选淘汰原因。
• 复用 DSH 生态：使用 DSH 官方扩展接口，不复制会话、工具、工作流或桌面运行时。
• 尊重用户配置：项目和请求级设置始终可以覆盖 DSHelm 的建议。

一句话概括：让规划、执行和审核使用合适的模型，并告诉你为什么。

当前可以体验

从源码体验

环境要求：Node.js >=22.19.0、pnpm 11.7.0、可在 PATH 中调用的 DSH CLI。当前验证版本见 compatibility.json。macOS、Linux 或 Windows 11 + WSL2 均可尝试，Windows 原生体验仍待社区验证。

git clone https://github.com/Altairpaca/dshelm.git
cd dshelm
corepack enable
pnpm install --frozen-lockfile
pnpm preview:init

preview:init 会构建本地包，并把源码预览安装到 $DSH_HOME/profiles/dshelm。它不会自动登录，也不会复制 Codex、Claude 等产品的凭据。

dsh --profile dshelm --dump-config
node packages/cli/dist/index.js doctor
node packages/cli/dist/index.js auth status
node packages/cli/dist/index.js explain deepseek/deepseek-v4-flash
dsh --profile dshelm

卸载会移除项目发现信息和 dshelm profile，默认保留凭据：

node packages/cli/dist/index.js uninstall --yes

[!NOTE] npm alpha 发布后的目标入口是 npx dshelm init --yes。在 npm 页面真实可用前，文档不会把它写成现有安装方式。

它如何工作

任务需求 → 运行时与认证硬条件 → 模型能力与证据评分 → 用户/项目/请求策略覆盖 → DSH 执行 + Resolution Trace

DSHelm Core 只负责策略、配置、路由和解释；任务执行仍由 DSH 及其插件完成。详细边界见架构说明。

面向中国用户

我们优先补齐简体中文文档和故障说明、DeepSeek/Qwen/本地模型兼容状态、Windows 11 + WSL2 安装验证，以及密钥、费用、网络和数据位置的透明说明。当前计划见社区版本路线图，桌面方向见桌面化策略。

与 DSH 社区一起演进

DSHelm 是 DSH 生态的一部分，不是 DSH 的替代品。项目会优先在官方 Discussion 中讨论公共接口和可复用契约：

• 模型规划与执行切换 #3297
• DSH 桌面宿主 #3118
• dsh doctor 社区契约 #1719
• 安全的 CLI provider 与 fallback #3283

欢迎提交一个真实任务、一次安装记录、一个路由结果，或 Windows、WSL2、本地模型和国内 provider 的验证结果。请使用 GitHub Issues 报告可复现问题；涉及 DSH 公共能力的讨论会同步回对应的官方 Discussion。

安全与事实边界

• 只有不透明的 CredentialRef 会进入策略和 trace；产品自有 secret 仍由产品管理。
• 无法可靠确认的认证状态会显示为 unknown，不会猜测为已登录。
• 模型软评分是带来源和置信度的维护者启发式，不是模型排行榜。
• DSHelm 不隶属于 DeepSeek，也不代表文中提到的模型或厂商。

开发环境、测试命令和贡献边界见 CONTRIBUTING.md。中英文 Issue 和 PR 都欢迎。

Apache License 2.0。