前言¶
在使用 DeepSeek Harness（DSH）进行开发或调试时，用户常遇到需要提交功能想法、错误报告或改进建议的情况。将这些零散的对话记录整理成结构清晰、符合社区规范的 GitHub Discussions 内容，往往需要手动复制粘贴和格式调整。DSH Feedback Bridge 插件旨在解决这一问题，它允许用户在 DSH Web 界面中直接整理反馈草稿，并利用模型辅助完善内容，最终提交到官方 Discussions 或导出为 Markdown。
插件简介¶
DSH Feedback Bridge 是一个 DeepSeek Harness 插件，由用户 yx222yx 维护。它的核心价值是将杂乱的对话内容转化为结构化的社区反馈草稿。该插件支持将反馈内容整理为 GitHub Discussions，提供模型辅助建议、相似性检查以及本地草稿保存功能，所有操作均在 DSH Web 环境内完成。
核心功能¶
- 入口与界面：通过 DSH Web 左侧栏进入“社区反馈”。主界面展示反馈文本编辑与预览。
- 反馈来源整理：点击“反馈来源”进入独立页面。反馈内容按“一次完整交流”分组（即从用户提问开始，到模型完整输出结束，包含工具结果与报错），支持筛选、确认、移除与引用。
- 模型辅助：点击“模型辅助建议”，使用当前对话选择的模型生成反馈类型推荐、缺失信息提示或逐字段建议。
- 编辑与展开：每个字段文本框较小，点击展开按钮可进入大编辑页进行详细修改。
- 相似性检查：点击底部操作行的“相似性检查”按钮，会读取官方 Discussions、插件信息和允许访问的官方文档，检查内容重复度。
- 导出与提交：支持复制或导出 Markdown 草稿。支持通过 GitHub 登录或 GitHub CLI 提交。每次提交前会显示最终内容和 GitHub 账号，需用户确认。
- 草稿管理：自动保存未完成的草稿，刷新页面或重启 DSH 后可恢复。本地仅保存成功提交的链接和基本信息。
安装与启用¶
该插件目前仅支持 DSH Web 环境（v0.1）。
- 确保你的 DeepSeek Harness 版本在
>=0.1.1-rc.2 <0.2.0范围内。 - 使用 DSH 插件命令安装：
dsh plugin --profile web add dsh-feedback-bridge
- 启动 DSH Web：
dsh --profile web --no-open --port 3080
- 在 DSH Web 左侧栏找到“社区反馈”并点击进入。
如果需要指定版本或使用本地文件安装：
dsh plugin --profile web add dsh-feedback-bridge@0.1.3
# 或
dsh plugin --profile web add ./dsh-feedback-bridge-0.1.3.tgz
使用方法¶
- 打开“社区反馈”，在主界面进行编辑与预览。
- 点击顶部 反馈来源 查看并引用对话内容，确认无误后引用到字段。
- 点击顶部 模型辅助建议，根据模型推荐完善反馈内容。
- 点击字段展开按钮进入大编辑页，进行精细调整。
- 点击底部 相似性检查 查看结果。
- 检查预览，删除不希望公开的信息。
- 选择导出 Markdown，或登录 GitHub 后直接提交。直接提交前需再次确认公开内容和账号信息。
配置与隐私¶
插件支持两种 GitHub 授权方式：Device Flow 登录和 GitHub CLI 登录。授权过期时插件会尝试自动续期。
如果仅需要导出草稿而不提交，可在 DSH profile 配置中设置：
github:
auth:
provider: none
隐私说明：
- GitHub access token 和 refresh token 仅在 DSH Host 端使用，不会发送给浏览器客户端或模型。
- DSH 本地凭据存储不等同于操作系统级安全存储。
- 相似性检查会读取官方 Discussions、插件信息和允许访问的官方文档。
- 插件不会自动提交，每次写入 GitHub 都需用户单独确认。
- 本地只保存提交链接和基本信息，不跟踪回复或状态。
适用场景与限制¶
该插件适合需要在 DSH Web 环境下快速整理反馈、利用 AI 辅助撰写并确保隐私的开发者。
当前限制：
- v0.1 版本仅支持 DSH Web。
- 同一时间只保存一份未完成的草稿。
- 只提交到官方 DeepSeek Harness Discussions，不支持向第三方插件仓库提交。
- 不支持创建 GitHub Issue。
总结¶
DSH Feedback Bridge 是一个专注于反馈整理流程的工具，通过规范化的数据结构和模型辅助，降低了向社区提交高质量反馈的门槛。对于习惯在 DSH Web 中工作的用户，它提供了一条从对话到社区反馈的清晰路径。
