dsh-devlisted

# dsh 扩展开发（插件 / Agent preset / MCP） dsh 一切皆插件。开发扩展的**权威文档在 harness 仓库内**，先读再动手——本 skill 不复述它们，只负责"选对路径 + 脚手架 + 坑位提醒"： ```text 官方教程地图（deepseek-harness 仓库）： docs/user/develop/basic/index.md 第一个插件（三种形态、inject、ctx.effect） docs/user/develop/basic/tool.md 工具 DSL（defineTool 全契约） docs/user/develop/basic/config.md 插件配置（Config 字段） docs/user/develop/basic/publish.md 打包安装（bundle/profile/层序/GitHub 安装坑） docs/user/develop/framework/ 插件生命周期、服务、事件 docs/cookbook/adding-a-conversation-node.md 网页端聊天流业务节点 packages/mcp/mcp-client/README.md MCP 接入配置表 ``` 没有仓库检出时：`git clone https://github.com/deepseek-ai/deepseek-harness.git`（只读参考即可，开发产物不进仓库）。 ## 第一步：选路径（决策树） 用户想要什么 → 走哪条路： | 需求 | 路径 | 工具 | |---|---|---| | 一个角色化 Agent（人设/职责/工具组合，如"公司组织架构师"） | **agent preset**，无需写代码 | `dshdev preset-new` | | 给模型一个新工具/能力（TypeScript/JS 插件） | **插件 bundle** | `dshdev plugin-new` | | 接入现成的 MCP server（工具市场通用协议） | **mcp-client 行** | `dshdev mcp-snippet` | | 换/加模型 provider | 网页端 Settings → Models（自定义 OpenAI 兼容端点） | 见 docs/user/guide/providers.md | | 网页聊天流里插入业务卡片/行 | **客户端 ConversationNode**（进阶 TS） | 见 cookbook 指南 | | 只给某个 Agent 加流程知识 | preset 的 `skills/<名>/SKILL.md` | 直接写文件 | 80% 的"帮我做个 Agent"需求 = **agent preset**：persona 文本 + 挂哪些工具行，零代码。 ## agent preset（最常用路径） ```sh dshdev preset-new my-analyst --name "数据分析师" --desc "描述" # 默认基于 minimal dshdev preset-new my-agent --from standard --name "全功能" # 在线拉取 standard 真实组合 ``` 产物在 `~/.dsh/.agent-presets/<id>/`： - `preset.yml` — 显示名/描述（网页端模式列