前言¶
DeepSeek Harness(DSH)遵循“一切皆插件”的理念。當智能體在執行任務時發現自身能力缺口,且社區缺乏對應插件時,self-iteration-forge 提供了自動化解決方案。它允許 AI 通過工具調用,讓子代理開發缺失的功能,將其遷移爲獨立的 git 倉庫,自動提交代碼,並熱掛載至當前運行時。
核心功能¶
該插件由 csiroqa 維護(MIT 許可證),主要解決智能體能力擴展的工程化問題。
- 能力缺口發現與生成:AI 自發識別需求,通過子代理生成代碼。
- 生命週期管理:生成的插件自動遷移至
dsh-plugins/<name>,執行 git 初始化與提交。 - 即時集成:支持自動裝入 profile 並熱掛載到當前會話,無需重啓。
- 統一賬本:所有插件的工具調用次數匯入
$DSH_HOME/storages/plugin-call-stats.json,可通過命令彙總。 - 自舉:插件本身支持自舉,即通過調用自身的能力來迭代進化。
安裝與啓用¶
前置要求:Node ≥ 22、pnpm、本地檢出 deepseek-harness。
pnpm install && pnpm build
dsh plugin --profile web add link:D:\2-OGP\self-iteration-forge
安裝後需重啓 dsh web。
使用方法¶
工具調用¶
使用工具 extend_self(別名 add_capability)讓子代理開發新能力。
參數說明:
* requirement:插件需求(必填)。
* name:倉庫目錄名(自動派生,kebab-case)。
* migrate:是否遷移爲獨立倉庫(默認 true)。
* update:是否更新既有倉庫(默認 false)。
* install:是否裝入 profile(默認自動)。
* hot:是否熱掛載(默認 true)。
命令行監控¶
- 狀態查詢:
/self-iteration status(等價於裸/self-iteration)。
輸出包含倉庫路徑、HEAD 提交信息、工作區狀態、累計調用次數等。 - 統計查詢:
/self-iteration stats [插件名]。
按調用次數降序展示插件/工具的調用明細。 - 統計重置:
/self-iteration stats reset [插件名]。
配置說明¶
在 cordis.patch.yml 中配置參數,覆蓋默認行爲。
| 參數 | 默認值 | 說明 |
|---|---|---|
targetRoot |
項目根/dsh-plugins | 插件遷移根目錄 |
stagingRoot |
工作區/.forge-staging | 子代理開發暫存目錄 |
harnessRoot |
自動查找 | deepseek-harness 檢出路徑 |
subagentProvider |
spawn | 子代理提供者 |
maxChildDepth |
2 | 子代理委託深度上限 |
childTimeoutMs |
2700000 | 子代理/構建超時時間 |
commitType |
feat | Conventional Commit 類型 |
push |
false | 是否提交後 push |
gitAuthorName |
csiroqa | Git 提交作者名 |
gitAuthorEmail |
justinwangyj@163.com | Git 提交作者郵箱 |
keepStaging |
true | 是否保留 staging 目錄 |
stagingTtlDays |
0 | staging 保留天數,>0 時啓動前清理 |
installProfile |
自動探測 | 顯式指定的 profile 名 |
autoInstall |
true | 成功後自動裝入 profile |
注意事項與安全¶
- 別名過渡:
add_capability爲過渡期別名,賬本按實際調用名字分記。 - 依賴限制:拒絕 registry 版
@deepseek-ai/*依賴。 - 提交控制:
push默認關閉,遵守 AGENTS.md 規範。 - 錯誤處理:任何構建或加載失敗均被吞掉,不影響工具執行,僅保留 staging 供排查。
- 安全性:
- 子代理僅寫入 staging 目錄。
- 提交前執行 diff 檢查,構建產物與依賴已通過
.gitignore排除。 - forge 僅在接收可信需求時執行子代理與 git 操作。
生態與鏈接¶
插件目錄:https://www.skillhub.cn/plugins/csiroqa/self-iteration-forge
項目地址:https://github.com/csiroqa/self-iteration-forge