AGINT
English | 中文
基于 DeepSeek Harness (dsh) 的自进化智能体框架。
v0.26.0 · 39 个插件已挂载(39 条挂载声明)· 1 套 preset · 25 个工具行 · 10 个 skills · 27 个 cron job。
数字取自仓库级判据:版本看 VERSION 表首行,插件看 node bin/verify-manifests.mjs,其余看 AGENTS.md 文末 LOCAL-STATE 块。实时运行数字不在本文件。
- 哲学:美 = 简洁 + 真实 + 靠谱 + 主动 + 安全;冲突时取前者。
- 定位:dsh 是上游 runtime。AGINT 是它上面的规范与插件集合,不是 fork,也不是 AGI 实现。它提供记忆 / 反思 / 约束 / 度量 / 评估的工程骨架。新功能必须过 D-QAF 评估。
- 宪法:D-QAF 四阶段流水线 + HARM 四维指标 + 进化记忆层,见
docs/evolution-framework.md。默认自动化,人工审批只兜底。新机制自带 kill-switch、出厂即开、配齐降级与审计出口。
四层结构
| 层 | 内容 | 位置 |
|---|---|---|
| bundle | @agint/host:全部插件 + 挂载 patch |
package.json + cordis.patch.yml |
| preset | 智进人格 + 工具集 + skills,1 套 agint |
presets/agint/ |
| plugin | 39 个已挂载插件,8 组(记忆 / 调度 / 反思 / 质量 / 闭环 / 执行 / 观测 / 感知) | plugins/agint-*/ |
| data | 记忆 / 规则 / 指标 / 梦境 / 复盘 | runtime 数据,不进仓库 |
三个子 preset(
agint-blockchain/agint-investor/agint-ops)2026-10-26 起拆到私有仓agint-presets,以@agint/presets交付。先装本仓,再装它。
安装
前置:Node.js ≥ 20 · python3 · dsh ≥ 0.1.7-rc.1(矩阵见 VERSION)· 目标 profile 已初始化。
git clone https://github.com/Anmulzhao/DSH-AGINT.git ~/projects/AGINT
cd ~/projects/AGINT
./install/install.sh --profile=web # 装桌面 profile 写 --profile=desktop
装完必须重启目标 profile。bundle 与 profile 层不热更新。卸载 ./install/uninstall.sh。
一份 preset 服务所有 profile:
$DSH_HOME/.agent-presets/agint/只有一份,web 与 desktop 共用。25 行工具声明锚定.agint-bundle/plugins/,不随--profile变化。安装器逐条核验 25 个目标,缺一个即报。
四条红线:
- 升 dsh 必须带精确版本号。
npm i -g @deepseek-ai/dsh@latest会静默降级。 - 包内
node_modulesjunction 指向 dsh 官方包。rm -rf会跟进删包,卸载时必须保留。 - 装完像没装且零报错,多半是没注册进
dsh.profile.bundles(安装步骤 3.5)。 cordis.patch.yml的!!js只能写成标量。写成块集合或模板会让整份 bundle patch 解析失败,dsh 静默跳过@agint/host且界面无报错。改完跑node bin/check-patch-yaml.mjs。
更多排障见 docs/dsh-integration.md;容器部署走 docker/。
仓库自检
改完插件按序跑四步:
node bin/check-patch-yaml.mjs—— patch YAML 可解析。node bin/check-wiring.mjs—— 接线通电。node bin/check-dsh-compat.mjs—— dsh 兼容。node bin/check-boundary.mjs—— 能力边界未越界。
其余自检(manifest / tool schema / 记忆层 / LOCAL-STATE 回写)用法见 bin/ 下脚本。
文档地图
| 想看什么 | 去哪 |
|---|---|
| 运行现状(真实数字,权威) | AGENTS.md 文末 LOCAL-STATE 块 |
| 架构 / 插件详细 | docs/architecture.md · docs/plugins/ |
| dsh 集成 / 安装排障 | docs/dsh-integration.md |
| 安全边界 / kill-switch 清单 | docs/security-boundary.md |
| 能力归属 / 越界判据 | docs/capability-boundary.md |
| 已知盲区(先看这个再下结论) | docs/known-limitations/ |
| 运维 SOP / 踩坑 / 评估场景 | docs/operations/ · docs/lessons/ · eval/scenarios/ |
| 路线图 / 变更日志 / PHILOSOPHY | GitHub Wiki |
环境变量三个:DSH_HOME(数据根,默认 $HOME/.dsh)· AGINT_PROFILE(install.sh 目标 profile,缺省 web)· AGINT_HOME(双语义:安装器当源码根、插件当数据根;设错会把数据写进仓库目录,见 docker/entrypoint.sh)。
许可
MIT
No comments yet. Be the first to write one.