插件简介
Honcho(plastic-labs/honcho,7223 Star)是 DeepSeek Harness 的有状态记忆插件。在阿里云 ECS 上部署 DSH + Honcho,Agent 可跨会话记住用户偏好和项目背景,适合团队共享使用。DSH 插件包 @honcho-ai/dsh-honcho。
核心功能
安装后 Agent 获得 honcho_remember、honcho_search、honcho_chat 三个工具,支持 /honcho 命令查看记忆状态。记忆数据存储在 Honcho 服务端,支持托管或自托管。
安装与配置(阿里云 ECS 环境)
步骤一:ECS 环境准备
推荐配置:2核4G、Ubuntu 22.04、安全组开放 80/443 端口。
安装 Node.js 22.19+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
安装 DSH CLI
npm install -g @deepseek-ai/dsh
步骤二:安装 Honcho DSH 插件
dsh plugin --profile web add @honcho-ai/dsh-honcho
步骤三:配置 Honcho 服务端
方式 A:使用托管服务(推荐快速上手)
export HONCHO_API_KEY=your-key
从 app.honcho.dev 获取
方式 B:阿里云 ECS 上自托管(推荐生产环境)
安装 Docker
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
安装 honcho-cli
uv tool install honcho-cli
honcho init
honcho start --setup basic
自动拉起 API + deriver + Postgres + Redis
步骤四:验证
honcho doctor
dsh web --host 0.0.0.0
会话中输入 /honcho
阿里云环境特殊配置:ECS 安全组需放行 Honcho 服务端口(默认 8000),如果用 Nginx 反代需配置 SSE 长连接超时。完整 Nginx 配置见 Honcho 详情页。
避坑指南
- ECS 需 Docker:自托管 Honcho 依赖 Docker 运行 Postgres 和 Redis,确保已安装。
- 安全组放行:Honcho API 端口 8000 不要直接暴露公网,建议 Nginx 反代 + HTTPS。
- 内存建议 4G+:Postgres + Redis + deriver 同时运行,2G 内存可能 OOM。
- swap 配置:轻量应用服务器 2G 机型建议加 2G swap。
- 国内网络:托管服务 api.honcho.dev 访问慢,阿里云 ECS 上建议自托管。
更多阿里云部署方案见 DeepSeek Harness Hub。
适合人群
在阿里云上部署 DSH 的团队、需要多用户共享 Agent 记忆的企业、对数据隐私有要求需自托管的场景。
标签:Honcho、DeepSeek、阿里云、AI工具、AIAgent
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。
最佳实践篇:Honcho 阿里云生产部署最佳实践:5个关键配置保障 Agent 记忆服务稳定
Honcho 阿里云生产部署最佳实践:5个关键配置保障 Agent 记忆服务稳定
背景
某内容团队在阿里云 ECS 上部署 DeepSeek Harness + Honcho,为 8 名开发者提供 Agent 记忆服务。初期直接安装后遇到记忆不更新、服务 OOM、数据丢失等问题,经过调优总结出 5 条生产部署最佳实践。
架构设计
阿里云 ECS(4核8G)+ DSH Web(pm2 守护)+ Honcho 自托管(Docker Compose)+ Nginx 反代 + 定期备份。记忆数据存本地 Postgres,不依赖海外托管服务。
最佳实践清单
实践一:版本锁定与镜像固定DSH 版本锁定
npm install -g @deepseek-ai/dsh@锁定版本
Honcho 插件版本锁定
dsh plugin --profile web add @honcho-ai/dsh-honcho@具体版本
Honcho 和 DSH 都在快速迭代,跨大版本可能不兼容。升级前先在测试环境验证。完整版本配对方案见 Honcho 详情页。
实践二:Postgres 自动备份
每日凌晨备份 Honcho 数据库
0 3 * docker exec honcho-postgres pg_dump -U honcho honcho | gzip > /backup/honcho-$(date +\%Y\%m\%d).sql.gz
保留最近 30 天备份。记忆数据是 Agent 的核心资产,一旦丢失无法恢复。
实践三:deriver 资源隔离
deriver 调用 LLM 做记忆归纳,是 CPU 和内存消耗大户。在 Docker Compose 中限制 deriver 内存上限 2G,避免 OOM 影响 Postgres。
实践四:Nginx SSE 超时配置
location / {
proxy_pass http://127.0.0.1:8000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 86400;
proxy_send_timeout 86400;
}
Honcho 查询和部分 API 使用 SSE 长连接,Nginx 默认 60 秒超时会断开。
实践五:监控告警
配置 honcho doctor 定时检查(每 5 分钟),API 端口不通或 deriver 挂掉时触发告警。Postgres 磁盘使用率超过 80% 告警。
部署配置示例
一键部署
docker compose up -d
honcho doctor
dsh plugin --profile web add @honcho-ai/dsh-honcho
export HONCHO_URL=http://localhost:8000
总结
阿里云 ECS 自托管 Honcho 的关键是:版本锁定防升级翻车、定时备份防数据丢失、资源隔离防 OOM、SSE 超时防断连、监控告警防宕机。更多生产部署方案见 DeepSeek Harness Hub。
标签:Honcho、DeepSeek、阿里云、最佳实践、AIAgent
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。