dsh-pangu
给 DSH 会话装上盘古长期记忆:
打开对话就带着你的记忆,侧栏多一个「盘古记忆系统」面板。
这是可选项。 盘古本体是个独立服务(MCP / REST / Web UI 三种接入都有),
不用 DSH 也完全能用。只有你想在 DSH 会话里直接读写记忆时,才需要装它。
前置条件
| 需要什么 | 说明 |
|---|
| 盘古本体 | 已安装并跑起来。没装的话:curl -fsSL https://raw.githubusercontent.com/Mlte0907/pangu/master/install.sh | bash |
| DSH | DeepSeek Harness,且 dsh 在 PATH 里(或设 DSH_DIR 指向源码目录) |
| pnpm | npm i -g pnpm |
安装
curl -fsSL https://raw.githubusercontent.com/Mlte0907/dsh-pangu/main/install.sh | bash
或者克隆后本地跑:
git clone --depth 1 https://github.com/Mlte0907/dsh-pangu
cd dsh-pangu && ./install.sh # 默认装到 web profile
./install.sh tui # 换 profile:./install.sh <profile>
装完 重启 DSH(cordis.patch.yml 的热更新在 web 实例不生效,必须重启才加载)。
之后改地址/凭据无需再重启:设置页保存即由插件热重注到 MCP 客户端(lib/mcp-inject.js → entry.update)。
装完只填两个字段
DSH → 设置 →「盘古记忆系统」:
| 字段 | 填什么 |
|---|
| 盘古服务地址 | 盘古安装脚本最后打印的那个地址(本机就是 http://127.0.0.1:19529) |
| 盘古凭据 | 盘古安装脚本打印的那串凭据(记忆读写、搜索、管理页都用它) |
两个字段都可以在盘古安装横幅的「DSH 填写卡」里直接复制。
凭据是密码框,已配置时框内会显示脱敏值(如 pgk_J_*****zkQA),
用于你核对"当前生效的是哪一把"。留空 = 保持不变。
它带来什么
会话里:pangu_* 系列 MCP 工具(记忆读写、混合检索、知识图谱…)直接可用,
自动注入相关记忆、会话结束自动沉淀。
界面上(3 个位置):
- 侧栏底部记忆卡片
- 对话区「盘古」标签页(知识图谱 / 记忆进化)
- 设置页「盘古记忆系统」(服务地址、凭据、LLM 配置、多模态、平台接入)
宿主侧 6 个服务:panguDashboard / panguConfig / panguKG / panguKnowledge /
panguAdminKeys / panguPlatforms。
常见问题
| 现象 | 原因 / 处理 |
|---|
| 面板空白、日志 401 | 设置页「盘古凭据」没填或填错 —— 复制安装时打印的那串 |
| 记忆/搜索不通 | 「盘古服务地址」不对;本机填 http://127.0.0.1:19529 |
| 管理页 401 | 服务端 ~/.pangu/.admin_secret 与「盘古凭据」不是同一把(早期部署)。装上跑一遍盘古的 install.sh 会打印统一命令;新装默认同值,不会遇到 |
| 工具列表没刷新 | 服务端 exposure 改动后重启 DSH;仅改地址/凭据则保存设置即热重注 |
| MCP 行启动失败 | ~/.pangu/config.json 缺 pangu_base_url 或 api_key —— 设置页填好保存即自动重注(fail-loud,不再静默连 127.0.0.1) |
DSH 启动报 ERR_MODULE_NOT_FOUND: zod | 插件依赖没装:cd <插件目录> && pnpm install --prod |
开发
pnpm install --prod # 运行时依赖(zod,宿主提供 react)
npm install # 含测试依赖(react / react-dom / jsdom)
npm test # 渲染测试 + 保存语义 + 管理页/凭据回归
测试说明:test/settings/llm-form.test.js 用 jsdom 真实渲染设置页;
test/settings/save-semantics.mjs 等独立脚本验证保存语义与管理面错误上报。
缺少 jsdom / react 时渲染测试会自动跳过(不让 CI 因缺依赖而红)。
版本
与盘古本体分开版本:本插件自 0.5.0 起独立发版(此前跟盘古仓库同号)。
许可
MIT