innate-ai 0.1.0

自成长 Agent 程序性知识层

Innate — 自成长 Agent 程序性知识层

一句话定位: 一个可嵌入可外挂、自成长、引擎可换的 agent 程序性知识层系统。
它不做编排(对 LangGraph / Claude Code / 裸 API 中立), 只解一件事——在有限 context 预算内, 组装最相关、最精确的知识, 并让这套知识随使用自我进化。

接入 Agent（一行安装）

npx skills add vima-tech/Innate

安装后 Claude Code 等支持 Agent Skills 开放标准的 Agent 会自动获得 innate-memory skill——知道何时召回、何时记录、何时成长，无需手动配置。

前提：本机已安装 innate CLI（见下方快速开始）。

让 Agent 帮你完成安装（完整提示词）

将以下内容直接发送给你的 Agent：

---

请帮我安装并初始化 Innate 知识层，步骤如下：

pip install innate          # 安装 CLI
npx skills add vima-tech/Innate   # 安装 Agent Skill
innate inspect              # 验证，应输出空库健康报告

权限说明（人和 Agent 同权）
你拥有与我完全相同的操作权限，无需等待我确认即可执行：

操作类别	命令
召回与记录	innate recall · innate record
知识写入	innate add · innate spark · innate promote-spark · innate drop-spark
治理	innate approve · innate archive · innate invalidate · innate restore
成长与体检	innate evolve · innate inspect

工作规范

• 每次任务开始前执行 innate recall "<任务意图>" --format json，将结果纳入计划
• 任务结束后执行 innate record <trace_id> --outcome ok|fail，闭合 trace
• 发现值得保留的经验或灵感时，直接执行 innate add 或 innate spark，无需询问
• 判断知识已失效时，直接执行 innate invalidate <chunk_id> --reason "原因"
• 会话结束时执行 innate evolve --trigger manual 触发蒸馏

---

快速开始

# 安装 CLI
pip install innate

# 1. 写入知识
innate add "Python 列表推导式比 map/filter 更易读" --kind note --trigger "python 列表处理"

# 2. 召回知识
innate recall "python 列表优化" --budget 2000 --format json

# 3. 记录使用结果
innate record <trace_id> --outcome ok --feedback up

# 4. 触发成长(蒸馏 + 治理)
innate evolve --trigger manual

# 5. 库体检
innate inspect

Python SDK

from innate import KnowledgeBase

kb = KnowledgeBase("personal.db")

# 写入
cid = kb.add("经验内容", kind="note", trigger_desc="触发场景")
sid = kb.spark("一个灵感")

# 召回
ctx = kb.recall("任务描述", budget=6000)
for chunk in ctx.knowledge:
    print(chunk["content"])

# 记录使用
kb.record(ctx.trace_id, outcome="ok", used=[cid], feedback="up")

# 成长
kb.evolve(trigger="manual")

# 体检
print(kb.inspect())

系统架构

Innate System
├── Core SDK              知识层逻辑(recall/record/evolve/curate/confidence)
│   ├── Public API        8 个核心方法
│   └── Storage           sqlite-vec 默认; 5 个可替换扩展点
├── CLI Adapter           Core SDK 的命令行薄封装, 1:1 映射
├── Hook Integration      外部系统事件触发 CLI
├── Runtime (Daemon)      外部独立进程; 监听日志/事件
└── skills/               Agent Skills 标准接入层
    └── innate-memory/    npx skills add vima-tech/Innate

核心特性

• 双向量召回: content_vec(1024维) + trigger_vec(256维), 融合排序
• 置信度驱动: EMA 更新 + 时效加权 + 时间衰减, 知识越用越准
• 零主动行为: SDK 永不自发行动, 所有成长由外部触发
• 安全可注入: sanitize 钩子覆盖所有写入路径, 默认零重依赖
• 灵感系统: spark 记录灵感, 独立 maturity 生命周期, 相关语境下自动唤起
• 闭环完整: 召回 → 观测 → 成长 → 治理 → 安全, 五个闭环不缺
• 一行接入: npx skills add vima-tech/Innate 即可让 Agent 具备完整知识层行为

设计文档

详见 docs/Innate-设计文档-v4.5.1.md。

License

MIT