# Harbor Evolution

> YourBuddy 0.3.12 内置快照版本：`0.9.8`。来源：[istarwyh/harbor-self-evolving](https://github.com/istarwyh/harbor-self-evolving)。

---

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

---

[0.3.12 验证归档](https://github.com/istarwyh/yourbuddy/blob/master/docs/releases/yourbuddy-v0.3.12/README.zh.md)记录插件与配套 Python Adapter 0.9.8、公开 App、迁移运行时与 Host Historical Session Adapter Smoke。本版本原生启动、窗口可视化检查与真实模型评分仍未验证。不支持页面附件的旧宿主仍需使用“问 AI”或 `@harbor` 显式引用。仅更新独立插件不能增加缺失的宿主能力。

## 解决的问题

面对不稳定的 Agent 结果，用户可以从已完成会话寻找问题，也可以用固定任务比较一次受控修改前后的表现。

## 使用方式

打开已有 Harbor 结果，选择一个 Trial 或勾选多行，直接在现有输入框中提问。发送时冻结页面与选区；展开消息附件即可检查。“问 AI”和 `@harbor` 显式引用优先。关闭“发送时附带当前页面”即可不自动附加；其他标签页和斜杠命令不会隐式附加 Harbor。失败消息可以找回，不会覆盖新草稿。输入框空闲后恢复，再次发送会重新捕获当前页面。

没有数据集时，选择 `Evaluate recent Sessions`。它从当前 DSH 可访问的历史中预览最多三个已完成对话，包括其他项目目录。先检查样本、审阅模型和脱敏数据／费用说明；确认后启动后台诊断并打开完成的 Job。无需提供历史路径，有限的近期样本不代表全部历史。`evolve-agent-with-harbor` Skill 提供对话入口，按准确工作目录选择；已有明确任务时，说明评测集、生成器、评测器及标准、优化器四项信息。

## 默认集成的理由

它使“按你的方式工作”可以延伸为“根据你的任务判断什么有效”。用户可以从实际失败逐步形成回归样例，而非只凭单次演示判断模型或提示词好坏。

## 配套内容

桌面同时携带 Harbor Skill、配套的 `harbor-dsh-evolution` Python Adapter 和托管 Python 运行时，普通桌面用户不应再照搬独立插件 README 的 `npx ... setup` 安装流程。Job 默认使用 Host 执行；任务需要容器隔离时仍可使用 Docker。Candidate 依赖、模型服务与网络必须存在于所选环境中，并通过 Doctor 检查。

## 限制

页面引用在原项目和会话中保存私有身份与修订记录，不保存证据正文或凭据。已保存引用在内存缓存到期或宿主重启后仍可使用；缺失／损坏的记录与另一会话不能恢复。证据变化会明确报告；Trial 集合不会静默扩大。记录不会自动删除。未发送消息找回仅持续于当前浏览器会话，不是持久化发件箱。附加页面不会启动评测或部署。

历史会话诊断观察已有记录，不重新运行 Candidate，不能作为晋级比较基线；缺少证据时允许不评分。单 Query 快速诊断主要检查执行链路，其草拟标准不等于已执行的质量评测。正式比较要求固定任务、模型与评测身份；评测器可靠性还需要独立的 Ground Truth 元评测。插件不会自动部署 Candidate 或替换生产 Agent。评测可能产生额外模型请求、容器运行与磁盘开销。

## 凭据说明

评测中的 Candidate 可通过 Job 级临时能力调用已冻结的 Host 模型；可复用的 Codex OAuth 或上游 API 密钥不会复制进 Candidate。这不表示模型请求不经过网络。

<a id="development-example"></a>
## 开发案例：从专业需求到插件

Harbor Self Evolving 是 Y8 维护者本人深度开发、独立维护的项目。它解决的需求是把任务诊断与受控评测放进日常工作台，而不是让每个用户手动拼接评测命令和报告。

| 组成 | 负责的工作 | 用户检查的位置 |
|---|---|---|
| DSH 插件 | 注册评测相关能力与工作台视图 | 结果、证据和比较报告 |
| 配套 Skill | 指导任务选择、必要信息收集与评测操作 | 对话中的任务说明和确认步骤 |
| Python Adapter | 连接评测执行环境与 DSH Candidate | 运行诊断、任务输出和失败记录 |

开发自己的扩展时，可以借鉴这种职责划分：说明负责引导，插件负责运行时操作与界面，外部程序承担必要的专门执行。普通小插件无需 Python 或容器。先从[第一个插件](/yourbuddy/docs/develop/first-plugin/)入手，再通过项目顶部的源码链接阅读 Harbor 的完整实现；本页维护使用说明，不复制其开发 API。