dsh-memory-hub
用于 AI 角色的本地记忆助手：可以记忆、在客户端之间发送信息、连接到你自己的 AI，并提供可选的支付功能。所有内容都保留在你自己的电脑上。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:shenmingsolar-01/dsh-memory-hub#8d303294e3476daf2a6ecd3067272c810961acbfMemory Hub 以 dsh-memory-hub 发布，当前版本为 1.1.10。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
版本：1.1.10.3
多端 AI 角色的本机记忆助手：记得住、能收发、能接自己的 AI、可选支付，数据只留在自己电脑上。
English
A local memory helper for AI characters: remembers, sends between clients, connects to your own AI, and offers optional payment. Everything stays on your own computer.
这个包不含任何个人数据、账号、路径或聊天记录。 安装后只会保存安装者自己客户端写进来的数据。
点分类名直接跳到对应功能说明。Click a category to jump to its section.
| 分类 / Category | 中文 | English |
|---|---|---|
| 记忆 | 按角色和客户端分开记，写入前备份，删错能恢复 | Separate memory, backup and restore |
| 收发 | 任意可接端口的聊天软件互通，离线先存 | Any chat app with a port, offline queue |
| AI 接入 | 读写记忆、识别模型、绑定后提供本地接口 | Memory tools, model detection and binding |
| 支付 | 按国家显示货币和方式，也能手动选 | Country-aware currency and methods |
| 本机运行 | 自动端口、数据目录、端数和容量 | Auto port, local data, capacity |
| 边界 | 不统计、可停用、跟随语言 | No stats, disable, language |
0 表示不限制：config:
historyLimit: 1000 # 每个来源保留条数，0 = 不限
snapshotLimit: 100 # 快照份数，0 = 不限
inboxLimit: 200 # 收件箱条数，0 = 不限
outboxLimit: 200 # 发件箱条数，0 = 不限
实际能存多少只受安装者本机磁盘限制。
这个插件默认：
~/.dsh/memory-hub.json 及其派生文件；任何未来的数据收集都必须：
查看当前状态：
GET /privacy
返回 telemetry: false、collectsData: false、consentRequired: true，以及是否已同意。
装好后无需额外配置：
<DSH_HOME>/memory-hub.port；memory_hub_* 工具默认注册，安装者自己的模型可直接调用；default、来源 model，不写任何人的真实身份；不想用时，二选一：
# 1. 总开关
- id: memory-hub
config:
enabled: false
# 2. 直接停用插件行
- id: memory-hub
disabled: true
停用后：
dsh plugin --profile <你的 profile> add <这个包的路径或 npm 包名>
重启该 profile 后生效。
在 profile 的 cordis.patch.yml 加一条同名覆盖：
- id: memory-hub
config:
host: 127.0.0.1
port: 0 # 0 = 自动选端口
snapshotLimit: 100
file: "" # 默认 ~/.dsh/memory-hub.json
所有请求/响应均为 JSON，已开启 CORS。
GET /health
POST /cross
{
"character": "assistant",
"from": "chat-app",
"to": "chat-channel",
"text": "我到家了"
}
先写入收件箱，再按 to 投递到已配置通道；适合「一端说一句，另一端也收到」。
GET /memory
GET /memory?character=assistant
GET /memory/backups?character=assistant
POST /memory
{
"character": "assistant",
"source": "mobile",
"history": [
{ "role": "user", "text": "在吗" },
{ "role": "assistant", "text": "在的，你好" }
]
}
重复消息会自动去重，不会重复写入。
POST /memory/delete
{ "character": "assistant", "source": "mobile", "text": "要删掉的那句" }
也可以用 "at": 时间戳 精确定位。
POST /memory/restore
{ "character": "assistant", "source": "mobile" }
不带 snapshotAt 时恢复最近一份快照；带 snapshotAt 可恢复指定快照。
任意一端把消息写进收件箱，其他端轮询取走。适合「手机端收到消息，让电脑端角色回复」这类跨端投递。
POST /inbox
{
"character": "assistant",
"from": "chat-app",
"text": "我到家了"
}
可选 deliverTo：写入后同时投递到已配置的通道。
POST /cross
{
"character": "assistant",
"from": "chat-app",
"to": "chat-channel",
"target": "mobile",
"text": "我到家了"
}
先写入收件箱，再按 to 投递到已配置通道；target 可选，指定只有哪一端能取到这条消息。
GET /inbox?character=assistant&since=0&client=mobile
since 之后的新消息才会返回，避免重复；client 只取发给该端或未指定端（广播）的消息；client 时返回全部。客户端可以轮询这个接口做本地通知；插件本身不直接发系统通知。
收件箱与 Outbox 默认都不含任何地址、账号或数据。
插件本身不内置任何聊天通道。你可以在配置里声明自己的本机 HTTP 通道，然后调用 /outbox 把消息投递过去。
任何能接 HTTP 端口的聊天软件都能接入；常见软件不用自己拼报文：
| type | 适用 |
|---|---|
slack | Slack Incoming Webhook |
discord | Discord Webhook |
telegram | Telegram Bot API |
feishu / lark | 飞书群机器人 |
wecom | 企业微信机器人 |
line | LINE Messaging API |
matrix | Matrix 客户端 API |
generic | 任意自定义 HTTP 接口，默认 |
channels:
team-slack:
type: slack
url: https://hooks.slack.com/services/...
chat-telegram:
type: telegram
url: https://api.telegram.org/bot<TOKEN>/sendMessage
chatId: '123456'
local-app:
type: generic
url: http://127.0.0.1:9000/message
body:
text: '{{text}}'
GET /channels 可以查看已配置通道和可用适配器。
- id: memory-hub
config:
channels:
team-chat:
url: https://channel.example.invalid/hook
body:
who: your-character
action: message
text: '{{text}}'
{{text}}、{{character}}、{{channel}}、{{locale}} 会被替换。
POST /outbox
{
"channel": "team-chat",
"character": "assistant",
"text": "晚上好，记得吃饭"
}
插件会用配置里的 url、method、headers、body 发起请求，并返回目标的状态码和响应片段。
GET /outbox
返回最近 50 条投递记录（成功/失败都会记录）。
默认 channels: {}，不带任何地址、账号或 ID。
断线时可以先写入独立来源（例如 offline），恢复后合并回正常来源：
POST /memory/flush
{
"character": "assistant",
"from": "offline",
"to": "default"
}
返回 { "ok": true, "added": N }；合并会去重，成功后清空 from 来源，并保留快照。
也可以在配置里声明启动时自动并回：
- id: memory-hub
config:
flush:
- character: assistant
from: offline
to: default
默认 flush: []，不会自动处理任何来源，也不含任何外部数据。
支付用于给 AI 服务的 Token 余额充值。插件只保存支付入口配置，不处理支付凭证。
支付方式、货币和付款界面跟随安装者所在国家/地区自动切换，GET /payment 会返回：
region.country：识别到的地区；region.currency：当地货币；region.methods：当地常用支付方式；region.locale：付款界面语言。支持 CN、HK、TW、US、CA、GB、EU、JP、KR、SG、AU、IN、AE、BR；也可以用 payment.region 强制指定，或用 payment.regions 覆盖货币和方式。
创建支付意图时会把 amount、currency、method、region 带进支付地址，付款界面可按地区渲染。
- id: memory-hub
config:
payment:
enabled: true
provider: auto
checkoutUrl: https://your-provider.example/top_up
currency: '' # 留空则使用地区货币
presets: [10, 20, 50, 100, 300, 500]
默认 enabled: false、checkoutUrl: ''，不含任何商户号或账号。
GET /payment
POST /payment/intent
{ "amount": 50, "target": "mobile" }
返回金额、币种、支付方式和带金额参数的支付地址；只记录本地意图，不发起扣款。
GET /payment/intents
GET /payment/regions
POST /payment/region
{ "region": "US", "method": "card" }
"region": "AUTO" 可恢复自动；{ "amount": 20, "region": "JP", "method": "paypay" }
如果该方法在当地不可用，会返回 400，不会生成错误入口。
安装者自己的模型可以直接调用这些工具，把数据写进安装者本机的记忆中枢：
memory_hub_write：写入一条或一批消息；memory_hub_read：读取指定角色/来源的最近记忆；memory_hub_delete：删除某来源的一条记录；memory_hub_flush：把离线来源并回正常来源；memory_hub_payment_intent：按配置生成支付意图。配置：
- id: memory-hub
config:
tools: true
defaultCharacter: default
defaultSource: model
默认 tools: true，但角色和来源都是通用名，不含任何人的数据；模型写入的内容只存在安装者自己的 ~/.dsh/memory-hub.json。
记忆工具本身不依赖某一家模型。联网只发生在绑定模型之后：没绑定时只探测本机服务，不查云端、不更新目录；绑定后才访问该模型和公开目录。rnrn插件会探测本机常见的 AI 服务：
127.0.0.1:11434127.0.0.1:1234127.0.0.1:8000、8080、5000同时识别主流云端厂商，只有安装者自己配置了对应 Key 时才查询，否则只返回模型目录：
GET /models 会返回厂商、协议、地址和可用模型列表。厂商目录每天最多刷新一次，新增软件和模型会写入本机缓存，不用等插件升级；POST /models/refresh 可手动刷新。
也可以手动登记：
models:
- name: local-ollama
baseUrl: http://127.0.0.1:11434
protocol: ollama
- name: my-openai-compatible
baseUrl: http://127.0.0.1:9000
apiKeyEnv: MY_MODEL_KEY
protocol: openai
接口：
GET /models
POST /models/probe
{ "baseUrl": "http://127.0.0.1:11434" }
只探测模型列表，不发送记忆内容、不上传数据。
没有开放 API 的桌面 AI 软件无法直接适配，需要它的客户端主动调用本插件的 HTTP 接口或模型工具。
没有设置页面，也没有按钮。安装者直接和自己的 AI 说话：
把默认角色改成 role-a
默认来源用 client-x
模型地址是 https://model.example.invalid/v1
支付地址换成 https://pay.example.invalid/checkout，档位 10,20,50
也可以添加自己的 API：
接口名称=my-api
接口地址=https://api.example.invalid/v1
接口密钥环境变量=MY_API_KEY
接口模型=my-model
绑定接口=是
接口密钥环境变量 只保存变量名，不保存密钥本身；密钥放在安装者自己的环境变量里。
模型调用 memory_hub_configure，从原话里识别键值并写入：
<DSH_HOME>/memory-hub-settings.json
规则：
安装者选定自己的 AI 软件或模型后，插件提供本地 OpenAI 兼容地址：
POST /bind
{ "providerId": "auto", "model": "可选模型名" }
也可以指定厂商或自定义地址：
{ "providerId": "ollama", "model": "qwen3" }
{ "baseUrl": "http://127.0.0.1:9000/v1", "model": "local-model", "force": true }
绑定后：
GET /bind
GET /v1/models
POST /v1/chat/completions
/v1/chat/completions 会把请求转发到绑定端点，只支持 OpenAI 兼容或 Ollama 协议；Anthropic、Gemini 原生协议需要各自客户端。
模型工具 memory_hub_bind 也能让 AI 用对话完成绑定。
插件文字跟随安装者系统语言或请求的 Accept-Language，支持：
zh en es fr de ja ko pt ru ar
rol、source、paiement、支払い；language: zh，默认 auto。GET /locale
插件加载后显示约 2 秒科技风开场：
Windows 下用 Edge 无边框窗口自动打开，2 秒后自动关闭。其他系统可以直接访问：
GET /splash
不需要开场时设：
splash: false
{
"version": 2,
"characters": {
"assistant": {
"sources": {
"app": { "history": [], "updatedAt": 0 },
"pc": { "history": [], "updatedAt": 0 },
"mobile": { "history": [], "updatedAt": 0 }
},
"snapshots": []
}
}
}
插件只认端口，不认品牌，也没有内置任何私有聊天软件的数据。
source，例如 slack、telegram、line；/inbox，再继续写入；{{locale}}，由各自软件按当地语言展示。公共 Webhook、Bot API、Matrix 客户端 API 都只需要安装者自己的地址和 Token，不依赖任何作者的私有服务。
MIT