innate-ai 0.1.0__tar.gz

innate_ai-0.1.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: innate-ai
+Version: 0.1.0
+Summary: 自成长 Agent 程序性知识层
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: sqlite-vec>=0.1.0
+Requires-Dist: click>=8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+
+# Innate — 自成长 Agent 程序性知识层
+
+> **一句话定位**: 一个**可嵌入可外挂、自成长、引擎可换**的 agent 程序性知识层系统。  
+> 它不做编排(对 LangGraph / Claude Code / 裸 API 中立), 只解一件事——**在有限 context 预算内, 组装最相关、最精确的知识, 并让这套知识随使用自我进化。**
+
+## 接入 Agent（一行安装）
+
+```bash
+npx skills add vima-tech/Innate
+```
+
+安装后 Claude Code 等支持 [Agent Skills 开放标准](https://agentskills.io/specification)的 Agent 会自动获得 `innate-memory` skill——知道何时召回、何时记录、何时成长，无需手动配置。
+
+> 前提：本机已安装 `innate` CLI（见下方快速开始）。
+
+### 让 Agent 帮你完成安装（完整提示词）
+
+将以下内容直接发送给你的 Agent：
+
+---
+
+> 请帮我安装并初始化 Innate 知识层，步骤如下：
+>
+> ```bash
+> 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` 触发蒸馏
+
+---
+
+## 快速开始
+
+```bash
+# 安装 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
+
+```python
+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`](docs/Innate-设计文档-v4.5.1.md)。
+
+## License
+
+MIT

innate_ai-0.1.0/README.md

@@ -0,0 +1,127 @@
+# Innate — 自成长 Agent 程序性知识层
+
+> **一句话定位**: 一个**可嵌入可外挂、自成长、引擎可换**的 agent 程序性知识层系统。  
+> 它不做编排(对 LangGraph / Claude Code / 裸 API 中立), 只解一件事——**在有限 context 预算内, 组装最相关、最精确的知识, 并让这套知识随使用自我进化。**
+
+## 接入 Agent（一行安装）
+
+```bash
+npx skills add vima-tech/Innate
+```
+
+安装后 Claude Code 等支持 [Agent Skills 开放标准](https://agentskills.io/specification)的 Agent 会自动获得 `innate-memory` skill——知道何时召回、何时记录、何时成长，无需手动配置。
+
+> 前提：本机已安装 `innate` CLI（见下方快速开始）。
+
+### 让 Agent 帮你完成安装（完整提示词）
+
+将以下内容直接发送给你的 Agent：
+
+---
+
+> 请帮我安装并初始化 Innate 知识层，步骤如下：
+>
+> ```bash
+> 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` 触发蒸馏
+
+---
+
+## 快速开始
+
+```bash
+# 安装 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
+
+```python
+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`](docs/Innate-设计文档-v4.5.1.md)。
+
+## License
+
+MIT

innate_ai-0.1.0/innate/__init__.py

@@ -0,0 +1,31 @@
+"""Innate — 自成长 Agent 程序性知识层."""
+
+from innate.core import (
+    ChunkNotFoundError,
+    CurateReport,
+    CurateScope,
+    Curator,
+    DummyEmbeddingProvider,
+    EmbeddingProvider,
+    EmbeddingUnavailable,
+    InnateError,
+    InvalidStateError,
+    KnowledgeBase,
+    OutcomeConflictError,
+    RecallResult,
+)
+
+__all__ = [
+    "KnowledgeBase",
+    "RecallResult",
+    "Curator",
+    "CurateScope",
+    "CurateReport",
+    "EmbeddingProvider",
+    "DummyEmbeddingProvider",
+    "InnateError",
+    "EmbeddingUnavailable",
+    "OutcomeConflictError",
+    "ChunkNotFoundError",
+    "InvalidStateError",
+]

innate_ai-0.1.0/innate/__main__.py

@@ -0,0 +1,6 @@
+"""innate 包入口 — 支持 `python -m innate`."""
+
+from innate.cli.main import main
+
+if __name__ == "__main__":
+    main()