dsh-box-context 使用指南

把 DSH Box 容器元数据（容器 ID、版本、路径、凭据环境变量名）以结构化形式注入宿主 DSH 的系统提示，让代理把容器信息当作事实而非装饰。

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

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

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add github:Nexus-Aethra/DSHBox#path:src-tauri/crates/box-dsh-context/dsh-box-context

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

— 源: plugins.install

Embedded WebView, no browser needed — the DSH frontend opens in a native WebView window managed by DSH Box. No port-forwarding, no copy-pasting URLs, no tab clutter.
Zero-dependency install — a private Node, npm, and pnpm runtime is bundled with every release. No system Node, no manual toolchain setup, no PATH hacking.
Version manager built in — browse DSH releases from deepseek-ai/deepseek-harness, install or uninstall any tag with one click, and pin a version per Container.
Bundle (整合包) workflow — group any mix of plugins and skills into a named bundle, then export it two ways:
- Quick export: GitHub-sourced entries are kept as URLs, keeping the archive tiny.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

这个插件是给谁用的？

给 DSH Box 用户。Box 启动每个容器时把容器元数据写入 JSON，由本插件读出来注入宿主 DSH 的系统提示，使代理始终能看到自己在哪个容器里运行。

用户需要自己配置什么吗？

不需要。cordis.patch.yml 已写好默认 contextFile 与 order，Box 启动容器时会动态生成 patch 覆盖文件，不需要手工编辑配置。

容器信息多久刷新一次？

默认使用 fs.watch 监听 JSON 文件变化，Box 重写文件时立即重新加载；如果文件监视失败（macOS/Windows 编辑器原子重命名等场景），自动降级为每 30 秒轮询一次。

凭据密钥会不会进入提示词？

不会。快照只携带 apiKeyEnv（环境变量名），真实密钥始终留在 DSH_HOME/.credentials.yaml，插件只告诉代理"哪个环境变量承载了对应提供商的密钥"。

卸载会破坏 DSH Box 吗？

本插件是 Box 自身的一部分，单独卸载会导致容器启动时 Box 注入上下文失败，Box 启动流程会受影响；正常情况下不需要也不建议单独卸载。

这个插件有客户端/浏览器侧吗？

没有。README 明确说明 Box 没有 WebView 标签页可扩展，所以只发布 host 半（Node 端），不打包 client bundle。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

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

— 来源：通用规则