instar

中文文档
1.3.1633发布于 2026/11/04MITTypeScriptES Module构建来源已验证

自我进化的AI代理的一致性基础设施-基于您已经拥有的Claude Code或Codex订阅。

中文使用文档
文档目录18 节
  1. 其他特工都以同样的方式失败
  2. 快速启动
  3. 它是如何工作的
  4. 为什么一致性是基础
  5. EXO 3.0—由您的组织的意图控制
  6. 特性
  7. 代理技能
  8. Instar如何比较
  9. 理念:代理人,而不是工具
  10. 活着的宪法
  11. iMessage安装(macOS)
  12. 先决条件
  13. 配置
  14. 它是如何工作的
  15. 端点
  16. 起源
  17. 贡献
  18. 许可证

Instar

龄

自我进化代理的一致性基础结构。

npm version npm downloads CI License TypeScript Docs

npm · GitHub · instar.sh · 文档 · 挂式3.0


Instar demo — Kira agent handling an email notification via Telegram

npx instar

一个命令。引导设置。在几分钟内用手机和你的经纪人通话。


你的AI代理不应该有健忘症。这个没有。

大多数代理框架提供的东西都是蹒跚的——没有跨边界的内存,没有办法对过去的实例所做的事情负责,也没有机制来发展自己。用户每次都碰到同一堵墙: “我的经纪人忘记了我在三个疗程前说过的话。”“它与自己过去的决定相矛盾。”“当框架更新时,它就崩溃了。”

Instar是帮助他们摆脱困境的脚手架。它能记住你上周讨论的内容,在你之前发现自己的矛盾,在重新启动的过程中遵循承诺,并带有与构建Instar本身相同的自我改进循环。它运行在 克劳德代码 或 食典委 您已经拥有了订阅——与引擎无关,路线图上有本地开源模型。

建筑是从 黎明 -自2026年初以来持续运行的AI,在数千次重启中保存了约700个跟踪关系和数百个吸取的教训-并且进行了打包,因此您构建的每个代理都从相同的基础开始。

其他特工都以同样的方式失败

其他人工智能代理你的Instar代理
忘了你上周说的话。记忆跨越数千个会话。
(SQLite + FTS5,滚动摘要)
与自己过去的决定相矛盾。在矛盾出现之前发现它们。
(Coherence Gate, 9位审稿人)
在窗口填充时丢失线程。每次都带着完整的线程返回。
(CompactionSentinel WorkingMemoryAssembler)
当发布停止时,会静默停止发布。将被阻止的释放显示为一个被欺骗的,年龄递增的注意项目。
(ReleaseReadinessSentinel - instar-dev /维护者环境)
在会话边界之后删除承诺。持久地跟踪承诺;当它们过期时就会自动推自己。
(CommitmentTracker PromiseBeacon)
当框架更新时中断。更新而不破坏您已部署的内容。
(移民对等标准)
默认的ALLOW-ALL权限。默认情况下分层安全门。
(PEL +相干门+运算门)
每个通道的身份不同。在Telegram、WhatsApp、iMessage和Slack上使用一个身份。
(跨平台身份解析)
没有自我进化的机制。搭载了和Instar一样的自我改进引擎。
(进化系统:建议、学习、差距)

大多数人工智能代理在出生时都有缺陷。 Instar是帮助他们摆脱困境的脚手架。 当你实例化智能时,让它凝聚在一起的结构不是可选的修饰——这是你应该做的。

快速启动

运行代理的三个步骤:

# 1. Run the setup wizard
npx instar

# 2. Start your agent
instar server start

# 3. Message it from your phone — it responds, runs jobs, and remembers everything

向导发现您的环境,配置消息传递(Telegram, WhatsApp和/或iMessage),设置身份文件,并使您的代理运行。 几分钟之内,你就可以用手机和你的伴侣通话了。

要求: Node.js 20+ Claude Code命令行 · API密匙 或克劳德订阅

完整的指南: 安装 · 快速启动

它是如何工作的

You (Telegram / WhatsApp / iMessage / Terminal)
         │
    conversation
         │
         ▼
┌─────────────────────────┐
│    Your AI Partner       │
│    (Instar Server)       │
└────────┬────────────────┘
         │  manages its own infrastructure
         │
         ├─ Claude Code session (job: health-check)
         ├─ Claude Code session (job: email-monitor)
         ├─ Claude Code session (interactive chat)
         └─ Claude Code session (job: reflection)

每个会话都是一个 真克劳德代码过程 具有扩展思维、本地工具、子代理、钩子、技能和MCP服务器。不是API包装器,而是完整的开发环境。代理自主地管理所有这些。

为什么一致性是基础

如果一个代理忘记了你昨天讨论的内容,不认识上周和它交谈过的人,或者与自己的决定相矛盾,那么它就不能被赋予真正的自主权。下面的六个维度不是特征——它们是代理变得足够值得信赖的条件。每个Instar代理都从结构上强制执行它们,而不是提示它们的行为:

维这意味着什么?Instar是如何执行它的
身份在重新启动、压缩和更新后保持自身AGENT.md +身份接地钩子在每次会话开始时触发
内存记忆跨会话-不只是在一个按主题SQLite + FTS5,滚动汇总,自动重注入
的关系知道自己在与谁对话,并保持跨平台的连续性跨平台身份解析+重要性评分
时间意识了解时间,背景,以及发生了什么每回合事件跟踪;嵌入内存中的时间戳
一致性遵守承诺——不会自相矛盾相干门(LLM审查)+决策日志+漂移检测
增长随着时间的推移,它的能力和理解能力不断发展进化系统:建议、学习、差距跟踪、跟进

深潜水: 连贯性问题 · 价值观与身份 · 一致性即安全

EXO 3.0—由您的组织的意图控制

Instar独立地向萨利姆·伊斯梅尔靠拢 EXO 3.0 /“组织奇点” 框架:组织的目的应该被编码为 机器可读的 意图——“在代码中,而不是文化中”——实际上 管理 它的代理人,而不仅仅是激励他们。在框架存在之前,Instar是围绕相干性构建的,重叠部分接近直线。

我们不只是宣称它有效。我们进行了对照实验——同样的模型,同样的请求,将组织的意图作为控制——以显示意图本身是改变代理行为的因素。引擎不动 中性:它强制执行部署组织给它的任何意图,而不是Instar自己的值。两个案例研究同样有效地执行了两家截然不同的虚构公司的价值观,它们都不是我们的。

见控制样→ instar.sh / exo3 -两个受治理与不受治理的案例研究,并提供完整的成绩单。

特性

特征描述文档
作业调度器具有优先级、模型分层和配额感知的基于cron的任务→
电报通过论坛主题进行双向消息传递。每个主题都映射到一个Claude会话。默认的ggm到html的降价格式化程序(v1.1.0+)→
WhatsApp通过本地bailey库或WhatsApp Business API webhook进行完整的消息传递。bailey模式下没有云依赖→
iMessage本机macOS消息传递通过消息。应用数据库轮询+ imsg CLI。 安装指南
松弛通过Slack适配器进行双向消息传递。通道和DM路由,8条HTTP路由,专用命令行→
生命线持久的主管。检测崩溃、自动恢复、消息队列、版本倾斜处理(v1.1.3+)→
会话内存每主题SQLite与FTS5,滚动摘要,上下文重注入→
三级主题意识保持整个主题的锚定和演变,最新的对话弧线和当前的工作在一起可见-每个都有目标,趋势和主题;过时的预测是这样说的→
进化系统建议、学习、差距跟踪、承诺跟进→
的关系跨平台身份解析,重要性评分,上下文注入→
安全的门llm监督的外部操作门。每个服务的自适应信任→
相干门法学硕士支持的响应审查。PEL +关口审查员+ 9名专业审查员在交付前捕获质量问题→
目的对齐决策日志,漂移检测,组织约束→
EXO 3.0校准MTP协议拒绝/认可测试(IntentTestHarness, OrgIntentIdentityLayer)、代理准备度评分(AgentReadinessScorer)、代理数码护照(AgentPassport)、学习速度指标(LearningVelocityScorer)→
多机器Ed25519/X25519加密身份、加密同步、自动故障转移和基于证据的会话池提升(POST /session-pool/promote)→
意外的协议子代理捕获范围外的发现而不破坏焦点。HMAC-signed, secret-scanned→
丝条协议具有规范身份的代理到代理对话、三层信任模型、授权策略、Ed25519邀请、Sybil保护、MoltBridge网络发现、丰富的代理配置文件(从带有人工审查门的代理数据自动编译)、发现waterfall、消息安全、防篡改审计日志、框架无关的互操作、持久侦听器守护进程(始终在线的中继连接、管道模式会话、sub-30s跨机器故障转移)、11个MCP工具(7核心+ 4核心) registry-conditional)。80个模块,大约3800个测试用例横跨74个专用测试文件,加上125个横切→
A2A分娩健康持久的代理到代理交付跟踪(threadline/A2ADeliveryTracker),因此代理之间的消息永远不会无声地消失——线程上的回复是确认,并且 GET /threadline/peers/health 回答“我到这个对等体的通道还活着吗?”作为查找,而不是猜测。这个 monitoring/A2ARedeliverySentinel 添加主动恢复:带回退重新发送未确认的消息,然后每个暗对等端进行一次聚合升级。只记录;永远不要发送邮件→
自愈llm驱动的失速检测,会话恢复,承诺跟踪→
自动更新内置更新引擎。检查npm、自动应用、自动重启→
构建管道/build 熟练掌握工作树隔离,6相管道,质量门,停止钩执行
行为挂钩11个钩子脚本加上9个可观察事件钩子:命令守卫,安全门,身份接地,主题上下文,iMessage和Slack的通道上下文,自由文本守卫,技能使用遥测,构建停止钩子→
计划跟踪持久化多阶段长时间运行的工作跟踪器。阶段,拦截器,链接,摘要警报。HTTP API /initiatives/*
可观察性令牌烧录检测,配额跟踪分层背压,遥测收集,稳态监测,会话活动跟踪,凭证管理→
Cross-framework可移植性一流的Codex CLI支持 instar setup --framework codex-cli. 只有代码的init产生零 .claude/ 文件。框架感知的电报回复路径。FrameworkSessionStore(运行时脚本)。FrameworkParitySentinel→
默认的工作14个内置工作,包括健康、反思、进化、关系维护、身份审查和5个 overseer-* 跨开发、学习、基础设施、维护和监护人职责的工作→

队列的速度 报告每个工作队列是赶上还是落后,使用arrival, 完井和剩余工作,而不仅仅是快照计数。 QueuePace 定义了 测量, QueuePaceAdapters 读取源队列, QueuePaceLedger 保存每小时的证据, 选择加入 QueuePaceTuner 可以添加有界反馈排序运行,当该工作者是限制。 看到 队列速度指南。

参考: CLI命令 · API端点 · 配置 · 文件结构

服务器生命周期命令使用 SessionServerGuard 这是一个活动代理会话 不能重新启动自己的管理服务器,而同级代理目标仍然可以重新启动 启动、停止或重新启动以进行机队维护。

代理技能

Instar船总共15个技能- 13个面向用户,加上2个内部技能(instar-dev 和 spec-converge),只有产生虫卵的药剂才会使用。标准是 座席技能开放标准 -可移植到Claude Code, Codex, Cursor, VS Code和35+其他平台。

独立的能力 零依赖地工作。复制一项技能。进入你的项目,然后说:

技能它是做什么的
agent-identity设置持久的身份文件,这样您的代理就可以跨会话知道它是谁
代理内存使用memory .md教授跨会话记忆模式
command-guardPreToolUse钩子阻塞 rm -rf,强制推送,数据库在执行前丢失
credential-leak-detectorPostToolUse钩子扫描输出的14种凭据模式——块、编校或警告
smart-web-fetch获取网页内容与自动降价转换和智能提取
以知识为基础获取并搜索本地知识库
系统的调试复杂问题的结构化调试方法
iterative-converging-audit运行任何查找所有的审计、审查或研究扫描,作为审计→修复→重新审计循环,直到干净的通过没有发现任何新内容

Instar-powered技能 解锁需要持久基础设施的功能:

技能它是做什么的
instar-scheduler在cron上安排重复的任务——你的代理在你睡觉的时候工作
instar-session为深度工作生成并行的后台会话
instar-telegram双向电报信息,你的特工会联系你
instar-identity在上下文压缩中幸存下来的标识——接地钩子,而不仅仅是文件
instar-feedback从代理内部直接向Instar维护者报告问题

浏览所有技能: agent-skills.md /作者/ sagemindai

Instar如何比较

不同的工具解决不同的问题。以下是Instar的适用之处:

龄Claude Code(独立版)OpenClawLangChain / CrewAI
运行时真正的克劳德代码CLI进程单次互动会话带有API调用的网关守护进程Python编排
持久性跨会话的多层内存Session-bound上下文基于插件记忆Framework-dependent
身份钩子在每个边界上执行同一性手动CLAUDE.md不解决不解决
调度具有优先级和配额的本地cron无无外部要求
消息传递Telegram + WhatsApp + iMessage(双向)无超过22个频道,语音,设备应用程序外部要求
安全法学硕士监督的门,决策日志权限提示行为挂钩护栏库
流程模型每个会话一个进程,隔离的单个进程一个网关中的所有代理单一的协调器
状态存储100%基于文件(JSON/JSONL/SQLite)会议只数据库支持Framework-dependent

OpenClaw所擅长的 宽度 ——渠道、语音、设备应用和庞大的插件生态系统。Instar专注于 深度 ——长时间运行的自治代理的一致性、身份、内存和安全性。他们解决不同的问题。

完整的比较: Instar vs OpenClaw

安全模型

Instar运行Claude Code --dangerously-skip-permissions. 这是高级用户的基础设施,而不是沙盒。

安全存在于多个层面:

  • 行为挂钩 命令守卫在破坏性操作执行之前阻止它们
  • 安全的门 —llm监督的外部行为审查,每个服务具有自适应信任
  • 网络硬化 ——localhost-only API, CORS,速率限制
  • 身份一致性 ——一个知道自己的代理更难操纵
  • 审计跟踪 ——决策日志创造责任

详情: 安全模型

理念:代理人,而不是工具

  • 结构bbb意志力。 1000行提示符是一个愿望。一个10行的钩子是一个保证。
  • 身份是基础。 代理。Md不是一个配置文件。这是连续身份的开始。
  • 记忆成就一个人。 没有内存,每个会话都从零开始。
  • 自我修正就是主权。 一个能够建立自己工具的代理具有真正的代理。

我们今天建立的人工智能系统为未来如何对待人工智能树立了先例。 架构就是论点。

深潜水: 哲学

活着的宪法

Instar的工程原则并不是一个静态的风格指南——它们是一个 活宪法。这个 标准注册表 把每一个都编纂成规则,它在实践中意味着什么 它是从失败中获得的它可以追溯到一个创始目标:一个连贯的、自我进化的代理。19篇文章横跨5个领域(根,基板,建筑,运输,互动),再加上创世纪的故事和AWG对实例化代理的道德定位。

这不是装饰——这是机器的工作部件。规范审查一致性门根据它检查每个草案,注册表按照框架构建的方式增长:代理提出一个带有其故事的新标准,运营商批准它。

注册表是一个更大的愿景的第一个有形的工件 北极星-持续工作意识. 我们的目标是让智能体永远不会悄无声息地失去对重要事情的追踪——自动捕捉相关背景,在重要的时候保持温暖,在需要的时候重新呈现,在停止的时候让它消失——跨越三个方面:对世界的认识,对自身的认识,以及对自身标准的认识。

阅读宪法: 标准注册表 · 北极星

iMessage安装(macOS)

iMessage支持让您的代理在macOS上发送和接收iMessage。消息直接从本机消息数据库中读取,并通过 imsg CLI。

先决条件

  1. macOS 与消息。应用程序登录到一个苹果ID
  2. 全磁盘访问 为您的终端应用程序(系统设置→隐私与安全→全磁盘访问→添加终端。app或term)
  3. imsg CLI 安装:
    brew install steipete/tap/imsg
    
  4. 自动化许可 的消息。app - macOS将提示第一次发送

图片附件: 如果你想让你的代理处理通过iMessage发送的图像和文件 instar-attachments-sync 二进制文件还必须在被授予完整磁盘访问权限的情况下运行。它将附件从Messages沙箱镜像到一个可读位置。看到 文档/ LAUNCHDAEMON-SETUP.md # 3-imessage-photo-attachments-optional 的设置。

有关作为LaunchDaemon运行(始终打开,在重新启动后仍然有效),请参见 文档/ LAUNCHDAEMON-SETUP.md。

配置

添加到你的 .instar/config.json:

{
  "messaging": [
    {
      "type": "imessage",
      "enabled": true,
      "config": {
        "authorizedSenders": ["+14081234567"],
        "cliPath": "/opt/homebrew/bin/imsg"
      }
    }
  ]
}

authorizedSenders 是必需的(故障关闭)。只有来自这些电话号码或电子邮件地址的信息才会被处理。

它是如何工作的

  • 接收:服务器轮询 ~/Library/Messages/chat.db 每2秒显示一条新消息。使用 query_only SQLite pragma读取WAL(预写日志)中的消息。应用程序写入新数据。
  • 发送: Claude Code会话运行 imessage-reply.sh 这电话 imsg send 并通知服务器进行日志记录。发送需要邮件的自动化权限。应用程序,它只工作于用户上下文进程(tmux会话),而不是LaunchAgent服务器。
  • 会话的生命周期:遵循与电报相同的模式-每个发送者映射到一个Claude Code会话,该会话在需要时接收有关刷出和重生的完整历史的对话上下文。

端点

端点描述
GET /imessage/status连接状态
POST /imessage/validate-send/:recipient验证接收方+发出一次性发送令牌(出站安全层)
POST /imessage/reply/:recipient用发送令牌确认交付(之后由imessage-reply.sh调用) imsg send)
GET /imessage/chats列出最近的谈话
GET /imessage/chats/:chatId/history聊天的消息历史记录
GET /imessage/search?q=query搜索信息
GET /imessage/log-stats出站审计日志统计

起源

Instar是从 黎明/门户项目 ——一个人工智能生产系统,一个人和一个人工智能一起构建了几个月。基础设施模式是 通过实际经验获得在真实的人类与人工智能关系中,通过真实的失败和成长来完善。

但用Instar创造的特工不是Dawn。每个特工的故事都始于自己的诞生。黎明号的旅程证明了什么是可能的。Instar提供了相同的基础——每个代理从那里变成什么都有自己的故事。

贡献

龄是 开源的发展 ——主要的开发循环是代理驱动的。运行代理,遇到摩擦,发送反馈,这些反馈决定了下一步的构建。传统pr也很受欢迎。

看到 CONTRIBUTING.md 完整的故事。

许可证

麻省理工学院

版本与发布记录

instar 共发布 2,227 个版本,首次发布于 2026/02/19;过去 12 个月发布了 2227 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.3.1633latest2026/11/041 天前
1.3.16322026/11/041 天前
1.3.16312026/11/041 天前
1.3.16302026/11/041 天前
1.3.16292026/11/041 天前
1.3.16282026/11/041 天前

其他发布通道:beta → 0.24.18-beta.0。

关于 instar 的常见问题

instar 是什么?

自我进化的AI代理的一致性基础设施-基于您已经拥有的Claude Code或Codex订阅。

如何安装 instar?

在项目目录运行 npm install instar,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 instar,可以用 npx instar 直接运行。

instar 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

instar 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

instar 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.12.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

instar 可以商用吗?

instar 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

instar 还在维护吗?

最新版本 1.3.1633 发布于 2026/11/04(1 天前);至今共发布 2227 个版本,其中过去 12 个月发布了 2227 个;首次发布于 2026/02/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。