nanpaidashi/dsh-honcho-sync

Give your DeepSeek Harness AI persistent memory. Auto-sync every conversation turn to a self-hosted Honcho service, and give the AI built-in tools to recall, search, and remember across sessions. Configure everything from a visual settings panel — no YAML editing required.

---

中文

这是什么？

DeepSeek Harness (DSH) ↔ Honcho 记忆桥接插件。 安装后 DSH 自动将每轮对话同步到用户自建的 Honcho 记忆服务（NAS、服务器或云端均可），AI 获得内置记忆工具，可直接检索、保存跨会话信息。

功能

功能	说明
可视化设置面板	DSH 设置 → "Honcho Memory"，所有配置项图形化编辑，无需手动改 YAML
自动同步	每轮对话自动推送到 Honcho（默认 debounce 3s），无需 AI 主动操作
honcho_recall	从长期记忆中语义搜索相关上下文，会话开始或重要任务前调用
honcho_search	跨所有 session 精确搜索，适合查找具体信息
honcho_remember	保存重要事实、决策、偏好到持久记忆
honcho_context	读取当前 session 的完整对话上下文
honcho_status	检查 Honcho 服务器健康状态
上下文注入	会话启动时自动从 Honcho 加载近期上下文
去重	同一 session 不重复推送相同内容

安装

前提： 已部署 Honcho 记忆服务（Docker 一行命令即可）

# 方式 1：从 GitHub 直接安装（推荐）
dsh plugin --profile web add link:https://github.com/nanpaidashi/dsh-honcho-sync dsh web

# 方式 2：从 npm 安装
dsh plugin --profile web add @nanpaidashi/dsh-honcho-sync@latest

配置

方式 1：可视化面板（推荐）

打开 DSH → 左下角 设置 → Honcho Memory，直接填写：

• Honcho URL（API 地址）
• Workspace（工作区名称）
• User / Agent Peer（标识符）
• Debounce、Recall Budget、Max Chars（调优参数）
• Auto Recall / Auto Sync（开关）

点击 Save 即生效，无需重启。

方式 2：环境变量

export HONCHO_URL="http://your-honcho-server:8000"   # 必填
export HONCHO_WORKSPACE="your-workspace"              # 必填

方式 3：cordis.patch.yml

在 ~/.dsh/profiles/web/cordis.patch.yml 中追加：

- id: honcho-sync
  config:
    honchoUrl: "http://your-honcho-server:8000"   # Honcho API 地址（必填）
    workspace: "your-workspace"                    # Workspace 名称
    userPeer: "user"                               # 用户标识
    agentPeer: "agent"                             # Agent 标识
    debounceMs: 3000                               # 同步防抖（毫秒）
    autoRecall: true                               # 会话启动时自动 recall
    recallBudget: 2000                             # recall token 上限
    autoSync: true                                 # 自动同步开关
    messageMaxChars: 25000                         # 单条消息最大字符数

环境变量速查：

变量	默认值	必填	说明
HONCHO_URL	—	是	Honcho API 地址
HONCHO_WORKSPACE	—	是	Workspace 名称
HONCHO_USER_PEER	user	否	用户标识
HONCHO_AGENT_PEER	agent	否	Agent 标识
HONCHO_DEBOUNCE_MS	3000	否	同步防抖延迟（毫秒）

架构

DSH Session
    │
    ├─ session/event ──→ 自动同步（debounce）──→ Honcho API (POST messages)
    │
    ├─ honcho_recall / search / remember / context / status
    │         └────────→ AI 可调用的记忆工具
    │
    ├─ session/start ──→ 上下文自动注入（autoRecall）
    │
    └─ 设置面板 ──→ /_dsh/dsh-honcho-sync/status (loopback-only)

依赖

• Honcho — 需自行部署（Docker 一行命令）
• DeepSeek Harness ≥ 0.1.0-rc.6

许可证

MIT

---

English

What is this?

A bridge plugin connecting DeepSeek Harness to Honcho memory. After installation, DSH auto-syncs every conversation turn to a self-hosted Honcho service (NAS, server, or cloud), and the AI gains built-in tools to recall, search, and remember across sessions. All settings are editable from a visual panel — no YAML editing required.

Features

Feature	Description
Visual Settings Panel	DSH Settings → "Honcho Memory" — all configuration in a graphical UI, no YAML editing
Auto-sync	Every conversation turn synced to Honcho (debounced 3s default), no AI action needed
honcho_recall	Semantic search across long-term memory. Call at session start or before important tasks.
honcho_search	Search across ALL sessions for precise lookups.
honcho_remember	Save facts, decisions, preferences to persistent memory.
honcho_context	Get full conversation context for the current session.
honcho_status	Check Honcho server health.
Context injection	Auto-load recent context from Honcho on session start.
Deduplication	Same content in same session won't be pushed twice.

Installation

Prerequisite: Deploy Honcho first (one Docker command)

# Option 1: Install from GitHub (recommended)
dsh plugin --profile web add link:https://github.com/nanpaidashi/dsh-honcho-sync dsh web

# Option 2: Install from npm
dsh plugin --profile web add @nanpaidashi/dsh-honcho-sync@latest

Configuration

Option 1: Visual panel (recommended)

Open DSH → bottom-left Settings → Honcho Memory, then fill in:

• Honcho URL (API address)
• Workspace (name)
• User / Agent Peer (identifiers)
• Debounce, Recall Budget, Max Chars (tuning)
• Auto Recall / Auto Sync (toggles)

Click Save — takes effect immediately, no restart needed.

Option 2: Environment variables

export HONCHO_URL="http://your-honcho-server:8000"   # required
export HONCHO_WORKSPACE="your-workspace"              # required

Option 3: cordis.patch.yml

Append to ~/.dsh/profiles/web/cordis.patch.yml:

- id: honcho-sync
  config:
    honchoUrl: "http://your-honcho-server:8000"   # Honcho API URL (required)
    workspace: "your-workspace"                    # Workspace name
    userPeer: "user"                               # User identifier
    agentPeer: "agent"                             # Agent identifier
    debounceMs: 3000                               # Sync debounce (ms)
    autoRecall: true                               # Auto-recall on session start
    recallBudget: 2000                             # Token budget for recall
    autoSync: true                                 # Auto-sync toggle
    messageMaxChars: 25000                         # Max chars per message

Environment variables:

Variable	Default	Required	Description
HONCHO_URL	—	Yes	Honcho API base URL
HONCHO_WORKSPACE	—	Yes	Workspace name
HONCHO_USER_PEER	user	No	User peer_id
HONCHO_AGENT_PEER	agent	No	Agent peer_id
HONCHO_DEBOUNCE_MS	3000	No	Sync debounce delay (ms)

Architecture

DSH Session
    │
    ├─ session/event ──→ Auto-sync (debounced) ──→ Honcho API (POST messages)
    │
    ├─ honcho_recall / search / remember / context / status
    │         └────────→ Memory tools callable by the AI
    │
    ├─ session/start ──→ Context auto-injection (autoRecall)
    │
    └─ Settings panel ──→ /_dsh/dsh-honcho-sync/status (loopback-only)

Dependencies

• Honcho — Self-hosted memory service (one Docker command)
• DeepSeek Harness ≥ 0.1.0-rc.6

License

MIT