前言¶
DeepSeek Harness（DSH）的核心理念是“一切皆插件”。尽管 DSH 仓库提供了通用的输入源、引用呈现、会话查询和预步骤扩展点，但具体的跨会话引用功能通常需要通过插件单独挂载。dsh-session-reference 是一个独立的安装包，为 DSH 提供了完整的跨会话引用实现。
插件介绍¶
dsh-session-reference 是 DeepSeek Harness 的一个记忆类插件，由 PUPPET17 维护。它解决的核心问题是让智能体能够引用其他会话的上下文信息。该插件默认不挂载，需要手动安装。
核心功能¶
该插件拥有完整的跨会话引用能力，包括：
- 提供
@菜单源，用于列出当前 DSH Home 会话。 - 对候选会话进行优先级排名，相同工作目录的会话排在前面。
- 通过
ReferenceInsert及其编解码器插入响应式@title胶囊。 - 提供
dsh-session:提及序列化协议，用于文本复制、持久化和提交。 - 在发送消息时，处理当前表面读取、有界投影和持久化不可信的回忆上下文。
安装与启用¶
环境要求¶
- DeepSeek Harness 版本：0.1.0-rc.5
- Node.js 版本：^22.19 || >=24
安装步骤¶
- 构建并打包插件：
pnpm install
pnpm run pack:plugin
- 将生成的 tarball 安装到 Web 配置文件：
dsh plugin --profile web add ./dsh-session-reference-0.1.0.tgz
- 导出配置以验证安装：
dsh --profile web --dump-config
- 启动 DeepSeek Harness：
dsh --profile web
卸载¶
dsh plugin --profile web remove dsh-session-reference
配置说明¶
- 依赖处理：DSH 启动器通过维护的配置文件回退提供兼容的 Host 和浏览器服务。因此，包管理器将 peerDependencies 视为可选，因为配置文件不会安装这些内联包的第二个副本。
- 默认限制：默认限制为每条消息三个引用，每个引用源 65,536 UTF-8 字节。
- 自定义限制：如需调整限制，可在配置文件的
cordis.patch.yml中覆盖session-reference配置项。
典型用法¶
- 在输入框使用
@菜单选择会话，插入@title胶囊。 - 使用规范的
dsh-session:提及序列化进行文本复制或长期保存。 - 在
cordis.patch.yml中调整引用数量或大小限制。
适用场景与注意事项¶
- 该插件以当前 DSH 进程的权限运行。在安装前，建议检查源码和许可证。
- 插件提供了有界的投影和持久化不可信的回忆上下文，适合需要跨会话上下文连接的开发场景。
相关链接¶
- GitHub 仓库：https://github.com/PUPPET17/dsh-session-reference
- 技术文档目录：https://www.skillhub.cn/plugins/PUPPET17/dsh-session-reference
