Agent 入门指南AGENT ATLAS
Agent 指南
AGENT ATLAS / 学习手册

DeepSeek Harness Skills 与 MCP

最小本地 Skill、一次性 MCP overlay 和退出回滚,区分工具桥接与完整协议。

Agent 入门指南

DSH 可以从本地加载 Skill,也可以通过 MCP 插件连接外部工具。本课用 Windows PowerShell 添加一个 README 检查 Skill 和一个记忆服务;请先完成 DSH上手。

创建 Skill

在项目 .dsh/skills 下直接创建技能文件夹。DSH 不递归查找任意深度的 SKILL.md,所以不要在技能文件夹上再套一层分类目录。这里的规则来自rc.2源码文档,所用发行版为rc.1;若未发现技能,需检查当前预设与版本。

Set-Location (Join-Path $HOME 'agent-atlas-dsh-lab')
New-Item -ItemType Directory -Force -Path '.dsh/skills/atlas-review' | Out-Null
notepad '.dsh/skills/atlas-review/SKILL.md'

如果已有同名文件,先备份。填入下面内容,以 UTF-8 保存:

---
name: atlas-review
description: 为练习目录的 README 给出三条有原文依据的检查意见。
---
# README检查
- 仅检查当前工作区README.md;不存在时报告缺失,不创建替代文件。
- 分别检查项目目的、输入材料和预期输出是否清晰。
- 每项给出原文依据;没写到的标为“文档未说明”。
- 本次只输出建议,不执行命令、联网或修改文件。

在该工作区新建会话,输入“加载 atlas-review 技能并检查 README”。回答应包含三项检查意见和原文依据。目录变化会被监视,正文在加载时重新读取;没有找到技能时,检查当前预设是否启用了 Skill 注册表、文件系统提供方和消费工具。DSH 这里不用 Pi 的 /reload。

移除本课技能文件夹后,新建会话确认不再可发现。之前会话已有的文字不会因删除磁盘文件自动消失。Skill指令不是权限隔离,仍需检查动作范围。

连接 MCP 记忆服务

官方 @deepseek-ai/dsh-mcp-client 可桥接stdio及Streamable HTTP,只桥接Tools,不支持Resources和Prompts。默认没有启用服务器。stdio程序随插件生命周期启动退出;HTTP服务需要事先运行。

下面使用官方记忆服务器示例,通过 node 启动程序,避开 Windows 命令 shim 的差异。记忆服务不需要额外模型 Key,DSH 的模型请求仍会计费。

安装服务器并写入配置

停止 DSH,在练习目录安装依赖。依赖放入独立子目录,不修改全局安装。以下配置参考rc.2源码文档,rc.1发行包没有提供 gitHead,兼容性尚未确认。先查看帮助;若没有相应参数或插件,停止后续操作。

npx @deepseek-ai/[email protected]-rc.1 web --help
if (Test-Path -LiteralPath './atlas-mcp-tools') { throw '练习依赖目录已存在,请先检查内容或换一个新目录。' }
npm install --prefix ./atlas-mcp-tools --save-exact @modelcontextprotocol/server-[email protected]
$npmRoot = (Resolve-Path './atlas-mcp-tools/node_modules').Path
$entry = (Join-Path $npmRoot '@modelcontextprotocol/server-memory/dist/index.js').Replace('\','/')
Test-Path -LiteralPath $entry
$memory = (Join-Path (Get-Location) 'atlas-memory.jsonl').Replace('\','/')

Test-Path 应返回 True。接着创建 atlas-mcp.yml,已有文件先备份。下面的代码会转义路径中的单引号:

$entryYaml = $entry.Replace("'", "''")
$memoryYaml = $memory.Replace("'", "''")
@"
- insert:
    - id: atlas-memory
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: atlas_memory
        transport: stdio
        command: node
        args: ['$entryYaml']
        env:
          MEMORY_FILE_PATH: '$memoryYaml'
"@ | Set-Content -LiteralPath 'atlas-mcp.yml' -Encoding utf8
npx @deepseek-ai/[email protected]-rc.1 web --patch ./atlas-mcp.yml

insert overlay和 --patch 来自官方记忆 MCP 指南。这个配置只用于本次启动,不覆盖用户的 cordis.patch.yml。

**macOS/Linux:**同样用 npm install --prefix ./atlas-mcp-tools --save-exact @modelcontextprotocol/[email protected] 安装到新的练习子目录,入口位于其 node_modules/@modelcontextprotocol/server-memory/dist/index.js;手写相同YAML时填该入口绝对路径,再运行相同npx命令,不执行上面的PowerShell变量语法。

读写记忆与卸载

等待 mcp__atlas_memory__ 前缀的工具出现,先让模型读取图谱。再要求它记住“atlas-demo-0913,颜色蓝”,最后新建会话查询这个实体。新会话能查到内容,才说明数据从记忆服务读了回来。

工具没有出现时,检查入口文件、node 路径、YAML 缩进和启动错误。调用卡住时先检查子进程日志,不要反复发送请求。

退出时Ctrl+C停止DSH,确认stdio子进程退出。再次启动不传 --patch,确认工具不再加载;仅移除本课overlay与测试JSONL,保留其他配置。不清理全局软件。要卸载本课独立子目录里的依赖,可在原练习目录执行:

npm uninstall --prefix ./atlas-mcp-tools @modelcontextprotocol/server-memory

如需移除剩余练习依赖目录,先用文件管理器确认其绝对路径确实位于本课工作区,只处理 atlas-mcp-tools,不要删除用户全局 npm 目录。

HTTP路由另用transport: streamable-http、url及必要headers,不填stdio的command;认证值来自自己的环境,不复制进公开YAML。此处不部署远程服务,也不开放公网端口。

社区插件与参考资料

菜鸟社区插件目录可以用来查找插件。安装前查看许可证、版本要求、profile 和卸载方法。社区 OAuth 插件与内置模型登录是两回事。

更多练习见 第一项任务。

资料核对:2026-09-13;以下操作尚未实机测试。

本页目录