# 扩展 Y8

> 从一个想改进的具体任务开始。Y8 使用 DSH 的插件机制，你可以采用已有扩展，也可以开发自己的插件，沿用同一种插件格式。

---

LLMS 索引： [llms.txt](/yourbuddy/llms.txt)

---

专业插件可以从两个问题开始：领域分析引擎需要处理什么数据、返回什么结果？操作面板需要让用户发起什么操作、检查哪些结果？按需求扩展其中一部分或两部分，复用 DSH 已有的运行能力。背后的分工见[产品理念](/yourbuddy/docs/about/)。

## 选择合适的方式

| 你的需求 | 从这里开始 |
|---|---|
| Y8 已经包含的能力 | 阅读[默认插件](/yourbuddy/plugins/)及其使用前提 |
| 已有其他人维护的能力 | 在[插件市场](/yourbuddy/plugins/marketplace/)查找，检查 README 和兼容要求 |
| 固定流程、提示词或输出标准 | 编写[工作区 Skill](/yourbuddy/docs/workspace/)；仅有操作说明时无需新建运行时插件 |
| 调整选项或组合现有能力 | 先看[设置](/yourbuddy/docs/settings/)，再看[插件配置](/yourbuddy/docs/develop/config/)和 Bundle 说明 |
| 接入一个已有外部服务 | 先检查该服务是否提供可用的 MCP 集成 |
| 增加操作、服务、设置卡片或界面 | 进入下面的插件开发路径 |

<a id="define-a-small-requirement"></a>
## 定义一个小需求

把这份提纲复制到对话或项目 README。先填写已知信息，其余可以让助手检查现有项目；提供样例数据，不要填写凭据。

- 要解决的任务：
- 输入内容及来源：
- 期望输出，以及在哪里检查：
- 允许修改的范围，以及禁止执行的操作：
- 需要的账号、服务和配置项：
- 一份样例输入及预期结果：

例如：只读查询团队构建服务的失败任务，返回失败原因和链接，不触发重跑。提供一份脱敏响应作为验收样例。这是扩展需求示例，不表示 Y8 已经接入该服务。

## 开发并检查结果

1. [借助 Creator 开发](/yourbuddy/docs/develop/creator/)，查询可用接口，试验一个范围明确的需求。
2. 按[第一个插件](/yourbuddy/docs/develop/first-plugin/)加载可编辑源码。本教程需要准备好的 DSH 源码 checkout，仅有桌面安装包还不够。
3. 增加一个[工具](/yourbuddy/docs/develop/tool/)或[配置项](/yourbuddy/docs/develop/config/)，每次修改一种行为并检查可见结果。
4. 按[打包与安装](/yourbuddy/docs/develop/publish/)把源码交付给其他人。临时动态试验不等于已安装的软件包。

专业扩展示例见 [Harbor 如何开发](/yourbuddy/plugins/harbor-evolution/#development-example)。框架、事件和服务细节见[框架指南](https://github.com/istarwyh/yourbuddy/blob/master/docs/user/develop/framework/index.zh.md)；尚未在本站发布的深入参考会打开 GitHub。

## 在团队内复用

共享项目或确切的软件包版本、支持的 DSH 版本、安装步骤、配置项名称和验收样例。同事使用自己的账号与目录，再重复执行样例。共享文件不携带私人会话或凭据。本地 checkout 链接只在作者机器上有效，交给他人时使用打包指南。

文档中的步骤失败时，通过[故障排查](/yourbuddy/docs/troubleshooting/)提供具体步骤、版本与错误，帮助区分说明缺失和需要完善的开发能力。

## 参与 Y8 开发

构建桌面应用和维护站点属于贡献者工作。相关 GitHub 参考为[桌面源码指南](https://github.com/istarwyh/yourbuddy/blob/master/apps/desktop-tauri/README.zh.md)、[站点维护指南](https://github.com/istarwyh/yourbuddy/blob/master/docs/product-website.zh.md)和[产品声明](https://github.com/istarwyh/yourbuddy/blob/master/YOURBUDDY_NOTICES.md)。

---

本节页面：

- [借助 Creator 开发](/yourbuddy/docs/develop/creator/): Creator 帮助你检查正在运行的 DSH 组合，并试验一个小插件。任务需要新操作或界面时使用它；如果只是调整配置或固定流程，先看[扩展方式选择](/yourbuddy/docs/develop/)。
- [第一个插件](/yourbuddy/docs/develop/first-plugin/): 本教程会创建一个最小的 Harness 插件，并将其加载到 Web UI 中。请从已完成[从源码运行路径](https://github.com/istarwyh/yourbuddy/blob/master/README.zh.md#run-from-source)的仓库检出开始。
- [开发一个工具](/yourbuddy/docs/develop/tool/): 本教程会在 Web UI 中添加一个 `greet` 工具。请先完成[第一个插件](/yourbuddy/docs/develop/first-plugin/)，并保留其中的 `scratch-plugin` 目录。
- [插件配置](/yourbuddy/docs/develop/config/): 让你的插件接受用户在 `cordis.yml` 中传入的配置。
- [打包与安装插件](/yourbuddy/docs/develop/publish/): 前几篇教程通过 `--patch` overlay 加载本地插件。本教程把它打包成可安装的**组合包**（bundle），用 `dsh plugin add` 安装进一个 **profile**，并解释决定组合后配置的层顺序。本文假设 `dsh` CLI 已安装。请先完成[插件配置](/yourbuddy/docs/develop/config/)。