前言¶

在 DeepSeek Harness（DSH）里推进主线——写论文段落、改代码、和 Agent 对齐方案——时，常会卡在一个术语上。若在主会话里当场追问定义，session log 会堆满名词解释，翻记录时很难找回刚才那段「正经事」；另开会话或开浏览器查，又要重复交代上下文或离开工作流。

dsh-aside（社区目录名 zenmokandouhenshuai/dsh-aside）提供「旁问」浮卡：就地提问、就地看答案，答案不进主对话的 session log，也不进入后续 prompt，主线上下文不因此变长。下面介绍它的定位、能力、安装方式与使用注意。

这是什么¶

dsh-aside 是 DSH 的 bundle 插件（Host 与 Client 在同一包内），维护者为 zenmokandouhenshuai，在 SkillHub 目录中归类为 客户端。包名 @local/dsh-aside（package.json 版本 0.3.0，许可证 MIT）。一句话定位：给 Harness 的旁问卡片——问不会的专业术语，答案留在浮卡与本地存档，不写进主会话。

核心功能¶

调用方式¶

• 输入框右侧出现 ? 问 按钮，或按 Alt+Q 呼出浮卡。
• 可先选中一段文字再点按钮：选中内容作为上下文一起发送，问法自动预填为「什么是 XXX？」。
• 浮卡内：Enter 提交问题，Shift+Enter 换行，Esc 关闭。
• 长答案在卡片内滚动，避免把输入框和领域设置顶出视野。

与主线的关系¶

旁问走独立路径：问答 不写入 session log，因此 不进入主对话的 prompt。设计意图是避免为一句名词解释在每次请求里重复计费、污染主线上下文。旁问与主线 不能「升格」为正式一问，也没有回到当时对话位置的锚点（存档仅保留选中文字与 session id）。

存档与侧栏¶

每条问答自动存档。侧栏提供 「旁问存档」 整页：本地搜索、按天分组、复制、删除。数据在 ~/.dsh/dsh-aside/asides.json（纯文本 JSON，可读可编辑可备份）。卸载插件 不删除 该目录下的数据。

路由与领域¶

回答使用的模型路由是可切换的 偏好，保存在 ~/.dsh/dsh-aside/config.json，例如：

{
  "mode": "dp",
  "provider": "dp",
  "model": "deepseek-v4.1-flash-1017",
  "domain": "电池材料"
}

• mode: "dp"：走你在 cordis.patch.yml 里配置的路由（中转或自建网关等）。
• mode: "auto"：跟随应用默认模型（agent-default-model，通常为官方账号）。

卡片顶部与存档页顶部均可点选切换，即时生效、无需重启。首次启动若配置文件不存在，插件会按内置 dp 路由写一份，之后以文件为准。

领域前提：卡片顶部可设置「我在做电池材料」一类说明，写入 domain 字段并进入提问的 system prompt，解释优先按该领域；未设置时按最常见含义解释，并在跨领域歧义明显时用一句话点出。回车保存、Esc 取消。

回答通过 Host 侧的 ctx.llm.stream() 调用 profile 自带路由，计费与主对话同源，无需另行配置 API key。

安装与启用¶

需要以 profile 方式 启动 DeepSeek Harness。安装任选其一（路径均为 本仓库在本机的绝对路径，勿使用未在文档中出现的 github:owner/repo 简写）。

方式一（推荐）：让 Agent 安装，调用 plugin_manager 的 install_bundle：

target: <这个仓库的绝对路径>

方式二，命令行：

dsh plugin --profile <你的 profile> add <这个仓库的绝对路径>

装完后 必须重启一次 DSH：Host 半模块在启动时装载，不重启则改动不生效。若改包名，需同步修改 package.json 的 name 与 cordis.patch.yml 的 name，否则 profile 可能解析不到。

插件以当前 DSH 进程权限运行，安装前请自行审阅源码与 MIT 许可证。

典型用法¶

1. 主线对话中遇到不熟悉的术语，按 Alt+Q 或点 ? 问。
2. 可选：选中含该术语的句子再打开，自动带上上下文并预填「什么是 XXX？」。
3. 在浮卡中编辑问题后 Enter 提交，在浮卡内阅读答案；历史问题留在卡片下方。
4. 需要长期查阅时，打开侧栏 「旁问存档」 搜索、复制或删除记录。
5. 若中转额度用尽，在卡片或存档页顶部将路由切到 auto；若术语含义随学科变化大，在 领域 一行设置前提后回车保存。

适用场景与限制¶

适合：长时间在同一 DSH 会话里写材料或写代码，频繁遇到术语卡点，又不想污染主对话或反复为解释付 prompt 成本的开发者与研究者。

README 载明的限制（安装前应知）：

Host 侧在应用 Origin 下注册 /dsh-aside/list、/dsh-aside/ask 等 JSON 路由，与页面共用登录态；Client 侧占用输入框右侧按钮、浮层、侧栏入口与存档页等 slot，样式使用 --dsw-alias-* 主题 token。

结尾¶

dsh-aside 用浮卡与本地存档承接术语旁问，把名词解释从主 session log 里拆开，适合在 Harness 里保持主线紧凑、又可随时查词的场景。目录与源码：

• 社区目录：https://www.skillhub.cn/plugins/zenmokandouhenshuai/dsh-aside
• GitHub：https://github.com/zenmokandouhenshuai/dsh-aside

DSH 生态强调「一切皆插件」；SkillHub 为社区独立站点，与 DeepSeek / 幻方无官方从属关系。