# 在腾讯云 CVM 上跑 DSH 的记忆插件：三处必须改的配置

`dsh-fish-memory` 是一个 Web 侧插件，逻辑全在宿主进程里，所以它可以跑在 CVM 上——但这不等于「装完就能用」。在云主机上它有三个和本机不一样的约束：profile 文件的编码、出网能力、以及数据目录的持久化。这三处任意一处没处理，表现都是「插件装好了，但记不住东西」。

## 一、实例与系统的最低要求

插件本身很轻（逻辑 + 一份约 900KB 的中文词表），真正的开销在 DSH 宿主。实践上按下面配：

| 项 | 建议 | 说明 |
|---|---|---|
| 实例 | 2 核 4G 起 | 1 核 1G 跑 DSH 勉强，一旦触发「提炼」调模型会明显卡 |
| 系统盘 | 50G 起 | DSH 的 node_modules 与 profile 体积不小 |
| 系统 | Ubuntu 22.04 / Debian 12 | 与官方 dsh 的安装脚本兼容性最好 |
| 出网 | **必须能到模型 API 端点** | 提炼与正常对话都要，见第三节 |

## 二、安装：两步，但第二步最容易出错

```bash
dsh plugin --profile web add dsh-fish-memory
```

装完重启一次 DSH，然后进「设置 → 鱼的记忆」，能看到面板就算装上。

**最容易出错的是 profile 的 `package.json` 编码。** 插件的 README 专门用一节写这件事，因为它的后果比较严重：

> 如果 DSH 弹「The application could not start」，错误里有 `Unexpected token ''`、`is not valid JSON`、`readProfileManifest` —— 那是 profile 的 package.json 被存成了 UTF-8 带 BOM。跟插件无关：内容都是对的，只是开头多了三个看不见的字节，DSH 读它就崩。

在 CVM 上这个坑的概率比本机高，原因是**跨平台编辑**：本地 Windows 上用记事本或某些编辑器改完再 `scp` 上去，很容易带上 BOM。可以这样确认：

```bash
# 看前三个字节是不是 ef bb bf
head -c 3 ~/.dsh/profiles/web/package.json | xxd
```

有输出就是带 BOM。去掉：

```bash
sed -i '1s/^\xEF\xBB\xBF//' ~/.dsh/profiles/web/package.json
```

改完 `python3 -c "import json;json.load(open('$HOME/.dsh/profiles/web/package.json'))"` 能过，再重启 DSH。

**注意**：真正的 profile 目录同时有 `cordis.yml`、`cordis.patch.yml`、`package.json` 三个文件，别处同名的都不算。

## 三、出网：提炼与检索要分开看

这个插件的两个动作对网络的要求不同：

| 动作 | 是否走网络 | 受安全组影响 |
|---|---|---|
| 记一条记忆 | 否 | 否 |
| 检索 / 注入 | 否 | 否 |
| 「提炼」旧档案 | **是**，调用你 DSH 里配的模型 | 是 |
| 「扩词」 | **是** | 是 |

也就是说：**日常「记住 / 想起来」完全不依赖出网**，只有你点「提炼」和「扩词」时才调模型。这一点在受限网络里很有用——你可以只装不改，先把记忆跑起来。

但 DSH 本身的对话要出网。CVM 上确认两件事：

1. 安全组出方向没有拦截 443。
2. 如果实例只在私有子网，NAT 网关要配好。

验证方式：在 CVM 上直连一次 API 域名，能拿到响应头即可。

## 四、数据目录

记忆存在这里：

```
~/.dsh/fish-memory/      # 一个会话一个文件，纯文本 JSON
~/.dsh/fish-memory-config.json   # 设置
```

**卸载插件不会删这些**，README 明确写了「卸载 → 重装，设置、记下来的所有记忆都还在」。但**重装系统会删**——它们在系统盘的用户目录下。

所以如果在 CVM 上长期用，两件事值得做：

- 定期快照系统盘（腾讯云控制台可以直接做）。
- 或者把 `.dsh/fish-memory/` 单独同步出去（`rsync` 到 COS，或者干脆挪到数据盘再做个软链）。

同目录的滚动备份救不了实例级故障。

## 五、四个实际会踩到的坑

**坑一：本地编辑后上传，DSH 起不来。**
现象：启动崩溃，报 `is not valid JSON` 或 `readProfileManifest`。
原因：`package.json` 带 BOM，Windows 编辑器与部分工具默认写入 BOM。
解决：按第二节的三字节检查 + `sed` 去掉，或用 `python3 -c "open(p,'w',encoding='utf-8').write(open(p,encoding='utf-8-sig').read())"` 重写。

**坑二：安全组只开了入方向，提炼一直失败。**
现象：日常记忆正常，点「提炼」后报错。原因：出方向被拦。解决：放行出方向 443，或先不提炼。

**坑三：直接装更新，装完还是老版本。**
现象：`dsh plugin add` 之后功能没变。
原因：可能拿到缓存里的旧副本。
解决：必须先卸再装，然后重启。

```bash
dsh plugin --profile web remove dsh-fish-memory
dsh plugin --profile web add dsh-fish-memory
```

**坑四：用「重装 DSH」来更新插件。**
现象：想升级插件，结果重装了整个 DSH，配置被动。
原因：这是两件事。
解决：更新只走插件自己的卸装流程。



## 总结

装是一行命令，真正要处理的是三件云侧的事：profile 的 `package.json` 不能带 BOM、出方向要能到模型端点（只在提炼时需要）、以及 `~/.dsh/fish-memory/` 和实例生命周期绑定所以要快照；把这三点做好，其余和本机一致。同类插件的部署形态对照见 [DeepSeek Harness Hub 插件清单](https://dpharness.com/top?utm_source=txyun&utm_medium=article)。

## 适合与不适合

**适合**：在 CVM 上长期跑 DSH、希望会话之间保持偏好与约定的人；能接受「记忆按会话分文件、不跨实例共享」这个模型的人；有快照策略、能保住系统盘数据的人；只需要日常记忆、不需要导入旧档案的人（那样连出网都不必配）。

**不适合**：1 核 1G 的小规格实例，提炼会拖垮宿主；需要多实例共享同一份记忆的人，它没有文件锁；把 `$DSH_HOME` 放在临时盘或容器可写层的人，重启即丢；期待记忆永久不过期的人，默认半衰期 30 天。

标签：dsh-fish-memory、腾讯云 CVM、DeepSeek Harness、记忆插件、部署配置

本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。


dsh-fish-memory 是一个 Web 侧插件，逻辑全在宿主进程里，所以它可以跑在 CVM 上——但这不等于「装完就能用」。在云主机上它有三个和本机不一样的约束：profile 文件的编码、出网能力、以及数据目录的持久化。这三处任意一处没处理，表现都是「插件装好了，但记不住东西」。

在腾讯云 CVM 上跑 DSH 的记忆插件：三处必须改的配置

人工智能

在腾讯云CVM部署DSH记忆插件需改三处配置：profile的package.json需去除UTF-8 BOM、安全组出方向放行443端口以支持提炼功能、数据目录~/.dsh/fish-memory/需定期快照持久化。日常记忆功能无需出网，插件轻量但建议2核4G配置。注意更新插件须先卸后装，避免缓存旧副本问题。

代码解释

云主机

Windows

容器

Cordis

JSON

快速部署LLM、AI绘画等应用,助你玩转AIGC！


4核4G3M云服务器 新用户低至38元/年！

对象存储COS新用户低至1元！


让每一个 Agent，都跑在云上

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

在腾讯云 CVM 上跑 DSH 的记忆插件：三处必须改的配置-腾讯云开发者社区-腾讯云

在腾讯云 CVM 上跑 DSH 的记忆插件：三处必须改的配置

在腾讯云 CVM 上跑 DSH 的记忆插件：三处必须改的配置

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐