5 分钟快速上手

September 6, 2026 · View on GitHub

本文带你在 5 分钟内完成 dsh-skill-forge 的安装、第一次技能锻造和基本使用。

第 1 步：确认环境

开始之前，确保你已经安装了：

  • DeepSeek Harness (DSH) 0.1.0-rc.5 或更高版本
  • Node.js 18 或更高版本
  • 一个可用的 DSH web profile（已经配置好模型和 API key）

检查 DSH 版本：

dsh --version

如果没有安装 DSH，先按照 DSH 官方文档完成安装和初始化。

第 2 步：安装插件

在你的 DSH profile 目录（如 ~/.dsh/profiles/web）下执行：

pnpm add dsh-skill-forge@github:Epiphany-Leon/dsh-skill-forge

然后编辑 profile 的 package.json，在 dsh.profile.bundles 中添加 "dsh-skill-forge"：

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-skill-forge"
      ]
    }
  }
}

本地开发安装（可选）

如果你想从源码安装或参与开发：

git clone https://github.com/Epiphany-Leon/dsh-skill-forge.git
cd dsh-skill-forge
pnpm install
pnpm build

# 链接到本地 DSH profile
cd ~/.dsh/profiles/web
pnpm add dsh-skill-forge@link:/path/to/dsh-skill-forge
# 然后在 package.json 的 dsh.profile.bundles 中添加 "dsh-skill-forge"

第 3 步：启动 DSH Web

dsh web

浏览器会自动打开 DSH Web 界面。注意观察：

  • 右侧边栏：应该出现「Skill Forge」面板，展示锻造队列和技能库
  • 顶部导航栏：应该出现锻造状态指示器（有进行中的任务时会显示动画）
  • 设置页面：在 DSH 设置中能找到「Skill Forge」配置项

如果面板没有出现，打开浏览器控制台检查是否有报错，常见原因是 profile 配置冲突或依赖版本不匹配。

第 4 步：手动锻造第一个技能

最简单的上手方式是手动触发锻造。

  1. 在 DSH 中和 Agent 完成一段对话，比如让它帮你写一个「快速生成正则表达式」的步骤
  2. 对话结束后，点击右侧边栏顶部的 「锻造当前对话」 按钮
  3. 在弹出的对话框中填写锻造理由，例如「这个正则表达式生成方法很实用，可以复用」
  4. 点击「开始锻造」

锻造流程随即启动。你会在右侧边栏的「锻造队列」中看到一个新任务，状态依次变化：

提取中 → 生成中 → 验证中 → 迭代中 → 审计中 → 待审核

每一步状态变化时，页面右上角会弹出 Toast 通知。

第 5 步：审核并激活技能

锻造完成后，任务状态变为 「待审核」，同时弹出审核弹窗。

审核弹窗包含以下内容：

  • 技能元数据：名称、描述、适用场景、标签
  • 技能正文：完整的 SKILL.md 内容预览
  • 验证报告：五个维度的得分雷达图，以及失败用例详情
  • 安全审计：危险模式检测结果和重复技能检测结果
  • 来源摘要：这段对话的简要总结

仔细检查后，你有三个选择：

  • 批准：技能进入激活状态，立即可以被召回使用
  • 驳回：选择驳回原因（预设选项 + 自定义文本），锻造记录保留
  • 取消：关闭弹窗，稍后在队列中继续处理

点击 「批准」，你的第一个锻造技能就正式入库了。

第 6 步：使用锻造的技能

批准后的技能会自动注册到 DSH 的技能系统中。

全部注入模式（默认）

默认配置下（injectionMode: 'all'），所有激活的技能都会在每轮对话中注入给 Agent。技能数量少时这种方式简单直接。

智能注入模式

当技能数量增多后，建议切换到智能注入模式以节省 token：

  1. 打开 DSH 设置 → Skill Forge
  2. 将「技能注入模式」改为 smart
  3. 调整「Token 预算占比」和「最低相关度阈值」到合适的值

智能注入会在每轮对话开始前，根据用户消息的关键词和上下文，动态选择最相关的技能注入，在 token 预算内达到最优效果。

你可以通过以下方式验证技能是否正常工作：

  • 开始一段新对话，聊与锻造技能相关的话题
  • 观察 Agent 是否引用了锻造技能中的方法或步骤
  • 在技能库面板查看该技能的「使用次数」是否增加

第 7 步：管理技能库

点击右侧边栏的「技能库」标签，进入技能库管理界面。

搜索与筛选

  • 顶部搜索框支持按名称、描述、标签模糊搜索
  • 可以按状态筛选（激活 / 待审核 / 草稿 / 已归档）
  • 可以按分类筛选
  • 支持按质量分、使用次数、创建时间排序

查看详情

点击任意技能卡片打开详情面板，可以看到：

  • 完整的技能内容
  • 版本历史列表
  • 锻造来源记录
  • 使用统计与反馈评分

版本管理

每个技能的每次修改都会生成一个新版本。你可以：

  • 查看任意历史版本的内容
  • 回滚到任意历史版本
  • 为每次修改填写变更说明

反馈收集

每次使用技能后，Agent 可以记录用户对技能的反馈（有用 / 一般 / 无用）。技能库中会展示反馈得分，得分过低的技能会被自动标记，建议重新锻造或归档。

下一步

  • 阅读 配置参考 了解所有配置项的含义和调优建议
  • 阅读 FAQ 解答常见问题
  • 阅读 README.zh.md 了解完整的架构设计和功能特性