前言¶
DeepSeek Harness (DSH) 采用插件化架构，支持通过扩展来增强核心能力。在实际开发或长对话场景中，往往需要在处理主任务流的同时，对特定片段进行独立分析、思考或多轮验证，但又不想打断当前的对话进度。dsh-sidechat 旨在为 DSH 提供一个 Codex 风格的侧边聊天面板，允许用户在主对话之外，运行一个独立的智能体会话。
插件介绍¶
这是一个为 DeepSeek Harness (DSH) 提供的独立、自主聊天插件。它通过右侧面板的形式，为每个主对话创建一个隔离的会话实例。该插件 fork 自 heartmove/dsh-side-chat，使用 MIT 许可证。它继承了主会话的上下文（工具集、模型、思考力度、权限预设），但作为独立的 Agent 运行。
核心功能¶
- 右侧独立面板：提供 Codex 风格的侧边聊天界面，面板宽度可在 280px 至 720px 之间调整，支持折叠。
- 上下文继承：侧边聊天自动继承主会话的工具集、模型选择、思考力度和权限预设，支持在侧边栏内单独调整。
- 选中文本与暂存：在主对话中选中任意文本并点击“Ask in side chat”，文本会写入输入框，不会自动发送。用户可在输入框中确认后手动发送。
- 一键新建：面板头部提供“+”按钮，可立即创建一个新的空侧边聊天。
- 结果带回：侧边聊天的回复可以“直接插入”或“总结后插入”到主对话的草稿区或折叠的上下文行中。
- 问题对话框支持：当主 Agent 提出问题时，可将问题和选项导入侧边聊天进行分析，待思考完毕后再将答案带回。
- 语言跟随：界面语言自动跟随 DSH 的语言设置（支持中文/英文）。
安装与启用¶
使用官方命令安装插件：
dsh plugin --profile web add github:realpkuasule/dsh-sidechat
安装过程中需要注意以下限制：
1. 该插件依赖 pnpm >= 10。
2. 在首次安装时，由于 pnpm 默认会忽略构建脚本，安装可能会失败并提示忽略。此时需要将提示中显示的包键（通常是 dsh-sidechat）添加到当前 Profile 的 pnpm-workspace.yaml 配置文件中：
onlyBuiltDependencies:
- dsh-sidechat
添加后，重新运行安装命令，并重启 dsh web 服务。
典型用法¶
- 启动侧边聊天：在主对话中选择一段文本，点击“Ask in side chat”，文本会出现在侧边输入框中，等待确认发送。或者直接打开面板并点击“+”创建新会话。
- 独立运行：在侧边面板中，你可以调整模型、思考难度或权限，也可以开启“Look up workspace / parent when needed”开关以获取更多上下文。
- 结果带回：当侧边聊天给出回复后，点击“Insert directly”将内容直接放入主对话的输入框，或点击“Summarize & insert”生成摘要后插入。
- 通知主会话：如果需要将侧边聊天的结论直接通知给主 Agent，可以使用
/notify或/to-main命令。
注意事项¶
- 依赖要求：请确保环境中的 pnpm 版本满足
>= 10的要求。 - 权限与安全：侧边聊天会以当前 DSH 进程的权限运行，涉及敏感操作前请检查源码与许可证。
- 安装配置：首次从 GitHub 安装时，必须按照上述步骤配置
pnpm-workspace.yaml，否则无法完成构建。
结语¶
dsh-sidechat 为 DSH 提供了一种非侵入式的并行思考方式。通过将复杂的分析任务隔离到右侧面板，既能保持主对话的连贯性，又能利用独立的 Agent 能力进行深度处理。对于需要频繁进行代码审查、方案论证或多轮验证的用户，这是一个实用的工具。
