dsh-sidechat

dsh-sidechat

面向 DeepSeek Harness 0.2.1 Web GUI 的侧边聊天插件。

侧边聊天以右侧栏停靠标签页的形式存在，与「工作区文件 / 新建终端 / 浏览器」共用同一个入口： 只有主动打开时才出现，不悬浮、不遮挡主对话。它会自动共享当前会话的对话内容；在主对话中 用鼠标划选一段内容后，可一键将其作为引用带入并直接提问。

• 目标运行时：DeepSeek Harness 0.2.1-rc.2（Desktop / Web）
• 安装方式：DSH 插件管理器一键导入，Git 地址 github:JiaskyNo1/dsh-sidechat
• 开源协议：MIT

安装（一键导入）

本仓库是可直接导入的 bundle 包：lib/ 已包含构建产物，安装器会自动完成依赖安装、 bundle 选择与配置注册，无需构建、无需手动改配置。

1. 打开 DSH 侧边栏 → 插件（Plugins） → 添加插件。

2. 在 Git 地址栏粘贴：

   github:JiaskyNo1/dsh-sidechat
   

3. 安装完成后启用插件。当前页面通常会热加载；若未出现，重启 DSH 即可。

功能

工作原理

浏览器 (lib/client.js)
├── ctx.remote.$mount(TYPERT_REMOTE)          挂载 sidechat Remote
├── ctx.sidebarRightTabs.register({ kind })   注册侧边栏标签类型
├── sidebar.right.pane.tab (key: dsh-sidechat) 停靠标签页正文
├── ctx.shortcuts.register('sidechat.open')   Ctrl+J / Ctrl+Alt+J
└── shell.overlay                              划选时出现的「添加到侧边聊天」按钮
        │
        │ Typert Remote（JSON over /api）
        ▼
宿主 (lib/index.js)
└── SidechatService
    ├── getContext(sessionId)  项目根 / Git 分支 / 会话最近 12 条消息
    ├── models()               provider / model / reasoning effort 目录
    ├── start(messages)        调用 llm.stream 生成，返回 job id
    ├── poll(jobId)            返回累计文本、思考过程、完成状态与错误
    └── stop(jobId)            停止任务

设计要点：

• 宿主半运行时只依赖 zod；@deepseek-ai/* 均为类型导入，安装后无需解析对等依赖。
• 浏览器半只使用 Web 平台共享模块表中的 react / react/jsx-runtime / zod。
• 宿主 ./typert 导出为手写 strict manifest，由 dsh-typert-loader 自动发现并注册。
• 标签页正文注册在 session-scoped 的 sidebar.right.pane.tab，每个会话自动获得独立实例。

使用

侧边聊天是独立问答面：不写入主会话，也不会调用工具。

• 本面板没有工具；若模型尝试输出工具调用标记，会被过滤并按需重试，不会把原始标记显示出来。

构建与开发

需要 Node.js 24 与安装好依赖的 DSH 0.2.1 运行时（@deepseek-ai/* 包）。

pnpm install                       # 安装开发依赖
pnpm run typecheck                 # tsc --noEmit
pnpm run build                     # tsc 中间产物 + tsdown 构建

构建产物：

构建中间产物（lib/types/、lib/*.map）已被 .gitignore 排除，不进入仓库。

兼容性

• 目标版本：DeepSeek Harness 0.2.1-rc.2。
• 使用的 client 契约：client-modules 的 bundle 格式、ui-sidebar-right 标签注册、 ui-slots keyed slot、client-shortcuts 命令注册、typert Remote 协议。
• 跨 DSH 版本升级时，需要同步调整 package.json 的 peerDependencies 与 tsdown.config.ts 中的平台共享模块表。

项目结构

.
├── cordis.patch.yml        # bundle 补丁：声明本包
├── src/
│   ├── index.ts            # 宿主半：SidechatService
│   ├── typert.ts           # 宿主 strict Typert manifest
│   ├── types.ts            # wire 类型
│   └── client/
│       ├── index.ts        # 浏览器半入口
│       ├── apply.tsx       # 标签类型 / 标签正文 / 快捷键 / 划选按钮 / Markdown
│       ├── remote.ts       # 浏览器侧 Remote contribution
│       ├── settings.ts     # 偏好存储（localStorage）
│       └── sidechat.module.css
├── lib/                    # 预构建产物（安装即用）
├── tsconfig.json
└── tsdown.config.ts

更新记录

版本变化与升级说明见 CHANGELOG.md。

致谢与许可

• 上游实现：kittsai/dsh-sidechat（MIT）。
• 本项目同样以 MIT 发布，详见 LICENSE；版权声明与上游保持一致。