DeepSeek Harness (dsh) 采用插件化架构,这使得开发者可以通过扩展来增强智能体的能力。在开发过程中,让 AI 在不同会话间保持上下文、同步任务或恢复之前的操作是一个常见需求。dsh-greatarrow 插件通过 GreatArrow.ai MCP 服务器连接 DeepSeek Harness,提供共享记忆与任务管理能力。
插件介绍¶
这是 GreatArrow-ai 维护的 memory 类插件。它是一个配置包,不包含可执行代码或构建步骤。安装后,它会向 dsh 的配置中添加一行 dsh-mcp-client,指向 GreatArrow.ai 的固定 API 端点,从而使智能体具备跨会话的记忆与任务管理能力。
核心功能¶
- 连接服务:将 dsh 连接到 GreatArrow.ai MCP 服务器。
- 记忆管理:支持搜索和保存记忆。
- 任务管理:支持读取和更新任务。
- 会话恢复:支持恢复之前的会话状态。
- 跨客户端共享:记忆与任务在 GreatArrow.ai 工作区内与其他 AI 客户端共享。
- 配置变更:仅作为配置包,向 dsh 配置中添加
dsh-mcp-client行。
安装与启用¶
下面是具体的安装步骤。请确保你已经拥有 GreatArrow.ai 的 Token。
- 获取 Token:访问 greatarrow.ai/install/deepseek-harness 获取 Token。
- 保存 Token:将 Token 保存为
~/.dsh/great-arrow.token(或$DSH_HOME/great-arrow.token)。建议使用编辑器手动写入,以避免 Token 出现在 Shell 历史记录中。保存后,请设置正确的文件权限:
chmod 600 ~/.dsh/great-arrow.token
- 安装插件:将插件添加到你正在使用的 Profile 中(例如
web):
dsh plugin --profile web add github:GreatArrow-ai/dsh-greatarrow
- 重启服务:重启 dsh 以加载配置。工具将以
mcp__great-arrow__<tool>的形式出现,例如mcp__great-arrow__memory_search。
验证配置¶
安装完成后,可以通过以下命令检查配置是否正确生成:
dsh --profile web --dump-config | grep -A8 great-arrow-memory
在新的会话中,直接询问智能体:“What do you know about my workspace?”(你知道我的工作区什么?)。如果配置正确,智能体会调用 mcp__great-arrow__memory_search 工具进行搜索。
注意事项¶
- Token 读取机制:当前版本(2026-10-19 之后)仅从
great-arrow.token文件读取 Token,不从环境变量读取(除非是 2026-10-02 之前的旧版本)。这意味着 Token 不会出现在项目目录的.env文件中。 - API 地址固定:插件连接的 URL 固定为
https://www.greatarrow.ai/api/mcp。 - 安装器冲突:如果你已经运行过 GreatArrow.ai 的安装程序,请不要同时使用此插件。安装程序会在
~/.dsh/cordis.patch.yml中写入配置,两者冲突会导致配置加载失败。 - 卸载方法:如需卸载,执行:
dsh plugin --profile web remove dsh-greatarrow
同时请删除 `~/.dsh/great-arrow.token` 并在 GreatArrow.ai 后台撤销 Token。
- 隐私与支持:鉴权、权限、速率限制和审计日志由 GreatArrow.ai 服务器管理。该插件源代码的最终解释权在 GreatArrow.ai 的应用仓库中。
总结¶
dsh-greatarrow 作为一个轻量级的配置包,为 DeepSeek Harness 提供了接入 GreatArrow.ai 生态的入口。它解决了智能体跨会话记忆保持和任务同步的问题,适合需要在 GreatArrow.ai 工作区内与多客户端协作的开发场景。