前言¶
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
