前言¶
在 DeepSeek Harness(dsh)里跑智能体时,系统提示、技能目录和长期记忆往往要分别接入:自己写 persona 片段、维护 skills 加载顺序,再单独挂 MCP 做记忆。上游项目 gentle-ai 已经把这些能力打包成一套约定;若希望在不改 dsh 核心的前提下一次性挂上这套组合,可以用插件包把它们灌进 Cordis 运行时。下面介绍社区仓库 gentle-ai-dsh(维护者 maiconcrespo)的做法与局限。
这是什么¶
gentle-ai-dsh 的定位是:将 gentle-ai 作为 dsh 的 plugin bundle(补丁层)接入,而不是单独某一个功能点插件。README 标明当前状态为 Spike / proof of concept,尚未发布;细节见仓库内 docs/spike-findings.md。
在 SkillHub 目录中归类为「模型推理」;GitHub 侧版本为 0.0.1,许可证 MIT(自 gentle-ai 复制的内容另见 NOTICE)。
核心功能¶
bundle 通过 cordis.patch.yml 向 dsh 叠加三类能力,README 描述如下。
Persona¶
将 gentle-ai 的 Gentleman 人格作为独立的 system-prompt 段落注入,实现位于仓库根目录的 index.js(persona 插件),内容由 persona.md 提供。
Skills¶
从包内 skills/ 目录加载 gentle-ai 技能;加载优先级为 bundled,因此若你本地有同名 skill,本地版本优先。
Memory(Engram)¶
通过 stdio MCP 接入 Engram。运行前需保证 engram 可执行文件在 PATH 中,否则记忆相关能力无法按设计工作。
环境与版本¶
本地试用 README 要求:
- Node.js 24.9 或更高
- pnpm
- dsh 引擎范围(见
package.json的engines.dsh):>=0.2.2-rc.1 <0.3.0
安装与启用¶
官方 README 给出的方式是 本地路径安装(非远程一键 add);请先将仓库放到本机,再执行:
dsh plugin --profile web add /path/to/gentle-ai-dsh
dsh web
将 /path/to/gentle-ai-dsh 替换为你机器上该插件目录的实际路径。
卸载:
dsh plugin --profile web remove gentle-ai-dsh
包内结构(便于核对)¶
| 路径 | 作用 |
|---|---|
package.json |
声明 dsh.bundle 与 engines.dsh |
cordis.patch.yml |
bundle 层:persona 插件、skill provider、Engram MCP 行 |
index.js |
persona 插件入口 |
persona.md、skills/ |
自 gentle-ai 复制的内容(见 NOTICE) |
spike/probe/ |
Spike 用运行时探测,不属于正式 bundle |
odd/tasks/ |
Spike 任务跟踪 |
典型用法与适用场景¶
典型用法即:在 web profile 下添加本地 bundle 后启动 dsh web,在 Web 界面中验证 Gentleman 人格、内置 skills 与 Engram 记忆是否按预期加载。
适合希望在 dsh 上 快速对齐 gentle-ai 默认体验、并愿意接受 POC 状态与本地路径安装的开发者。不适合需要已发布、稳定 semver 安装渠道且不愿自行审查源码的场景。
注意事项¶
- 插件在 当前 dsh 进程权限 下运行;安装前应阅读
cordis.patch.yml、index.js及NOTICE,确认上游授权与 MCP 行为。 - 记忆依赖 Engram 二进制;未配置
PATH时,bundle 其余部分仍可能加载,但记忆链路不完整。 - 社区目录 SkillHub 插件页 与 GitHub 仓库 不由 DeepSeek / 幻方官方运营;dsh 生态理念是「一切皆插件」,本文事实以 仓库 README 为准。
结尾¶
gentle-ai-dsh 把 gentle-ai 的人格、技能与 Engram 记忆收成一层 dsh bundle,适合作为 Spike 验证「gentle-ai × dsh」的集成路径。查阅目录与源码:
- 目录页:https://www.skillhub.cn/plugins/maiconcrespo/gentle-ai-dsh
- GitHub:https://github.com/maiconcrespo/gentle-ai-dsh