dsh-agent-bridge

功能

界面

项目记忆	项目 Skills
记忆按项目和共享状态分组，可逐条预览。	Skills 标记会话中记录过的使用。

交接预览	导出 DSH 会话
预览记忆、Skills 和会话摘录，导入或导出 Markdown。	选择本机会话，导出为 Markdown。

更多界面：项目归档、主题和 Agent 图标

项目归档	黑色主题

蓝色主题 · 白色主题 · Agent 图标

快速开始

1. 下载 dsh-agent-bridge.tgz（0.7.0）。
2. 打开 DSH Desktop → 插件 → 安装插件，选择这个文件。
3. 完全退出 DSH 后再打开，侧栏会出现 Agent 工作接续。

dsh plugin --profile web add ./dsh-agent-bridge.tgz
dsh web

发行包只依赖 DSH 的运行时。本版在 Windows 的官方 DSH Desktop 和 Web 0.2.2-rc.1 验收；原生会话入口依赖对应的 DSH 客户端服务。macOS 和 Linux 的数据路径规则有测试覆盖，桌面运行时的实机验收以 Windows 为准。DeepSeek Harness

使用

1. 打开 Agent 工作接续，按项目名、路径、Agent 或目录状态筛选。按 / 定位搜索框；不同 Git worktree 会独立显示。
2. 在资料区勾选记忆和 Skills。接续清单会汇总两类资料，也可以勾选近期会话；Skills 页会标记会话中记录过的使用。
3. 打开 预览交接，核对内容后选择导入或导出。导入会在原工作目录创建 DSH 会话，并填入可编辑的草稿。

当前项目离开筛选结果时，右侧会提示重新选择。搜索后按 ↓ 聚焦第一项，按 Enter 打开第一项。每个项目的资料勾选和近期会话选项会单独保存，切换项目或重启 DSH 后仍可继续。

项目详情右上角可置顶常用项目。成功在 DSH 打开交接草稿的项目会进入「最近接续」，最多显示五个符合当前筛选的非置顶项目。

右上角可切换蓝色、白色或黑色主题，插件会记住选择。Agent 筛选菜单支持方向键、回车和按字母查找；已适配的 Agent 名称旁显示随包提供的官方图标（图标来源）。

面板打开时会自动监听 Agent 索引、会话和当前项目资料的文件变化，并在后台定时复扫。正在查看或导出资料时，列表会在关闭预览后更新；刷新来源 可立即复扫。

整理项目

项目详情右上角可归档单个项目。批量整理时，先按 Agent、项目名或「离线」缩小范围，再点「整理」，勾选项目或全选当前结果，点「归档所选」。归档项目移入「已归档」，可查看资料、恢复项目，或撤销刚才的操作。

归档状态保存在 agent-bridge.json 所在目录的 agent-bridge-archive.sqlite，实时扫描和重启后仍保留。原工作目录、记忆、Skills 和会话记录继续留在各自的来源中。

读取方式

项目原有的 .agents/skills 和 .dsh/skills 由 DSH 原生发现。其他 Agent 的 Skill 以 SKILL.md 正文摘录和原路径带入，DSH 可在需要时读取同目录资源；导入预览会标记截取内容。插件通过本机已认证的 DSH Host 读取资料，源文件与 Agent 数据库按只读方式访问。发送之后，当前会话所选的模型会收到草稿。

导出交接

• 导出 Markdown：在项目中勾选资料，打开 预览交接 → 导出 Markdown。文件包含已选记忆、Skill 说明、来源和已选会话摘录。
• 导出 DSH 会话：用面板右上方的 导出 DSH 会话 选择本机 DSH 会话。文件包含原工作目录和最近的用户与助手消息；较长的会话会标记截取。

把下载的 Markdown 放进接收项目的 .agent-bridge/handoffs/，刷新后即可从「记忆」页重新导入。原工作目录不可访问时，仍可导出尚可读取的归档资料。

支持来源

插件会从当前用户的标准数据目录查找来源，也会识别 CODEX_HOME、CLAUDE_CONFIG_DIR、XDG_DATA_HOME、XDG_CONFIG_HOME、OPENCODE_DB 和 OPENCODE_CONFIG_DIR。用 本机来源 查看发现情况。加密、服务端或未知格式的记忆可先导出为 Markdown。Codex 配置实现 · Claude Code 配置 · OpenCode 数据存放位置

在项目里存放共享记忆

在已发现的项目目录下放入 Markdown，刷新后即可查看并导入。

my-project/
  .agent-bridge/
    memory/
      current-state.md
    handoffs/
      latest-handoff.md

current-state.md 可记录当前目标、分支状态与待办。latest-handoff.md 可记录已完成事项、验证结果和下一步。两个目录的第一层 Markdown 会显示在项目的「记忆」页。也可把这两份文件与项目一起交给其他开发者。

自定义来源

{
  "projectRoots": ["~/projects/example"],
  "agentRoots": {
    "opencode": ["~/agent-data/opencode"],
    "claude": ["~/agent-data/claude"]
  },
  "skillRoots": ["~/shared/skills"],
  "opencodeSkillRoots": ["~/agent-config/opencode"],
  "memoryExports": {
    "~/projects/example": ["~/exports/example/current-state.md"]
  },
  "workspaceHubRoots": ["~/workspace-manager-data/workspacehub"],
  "archiveFiles": ["~/workspace-manager-data/sessions.db"]
}

卸载与构建

Desktop 在插件管理页卸载 dsh-agent-bridge；Web 版运行：

dsh plugin --profile web remove dsh-agent-bridge

从源码运行 npm test 和 npm pack。项目没有第三方 npm 依赖，安装包包含插件代码、界面和本说明。