# instar 中文文档

规范地址：https://npmcn.com/package/instar/

版本：1\.3\.1633
npm 元数据更新时间：2026-11-03T21:49:53.051Z
中文译文更新时间：2026-11-03T22:28:02.520Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/instar
原文对照：https://npmcn.com/package/instar/?lang=original
项目主页：https://instar.sh/
源码仓库：https://github.com/JKHeadley/instar

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：104 MB，13619 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.12\.0
- 运行依赖：26 个
- 首次发布：2026-02-19T03:48:05.767Z
- 最新版本发布：2026-11-03T21:49:52.696Z
- 已发布版本数：2227（近 12 个月 2227 个）

## 中文简介

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

## 安装

```sh
npm install instar
```

也可以使用：`pnpm add instar`、`yarn add instar`、`bun add instar`

## README

![Instar](https://npmcn.com/package/instar/assets/logo.png)

# 龄

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

[![npm version](https://img.shields.io/npm/v/instar?style=flat-square)](https://www.npmjs.com/package/instar) [![npm downloads](https://img.shields.io/npm/dw/instar?style=flat-square)](https://www.npmjs.com/package/instar) [![CI](https://img.shields.io/github/actions/workflow/status/JKHeadley/instar/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/JKHeadley/instar/actions/workflows/ci.yml) [![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)](https://github.com/JKHeadley/instar/blob/main/LICENSE) ![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue?style=flat-square&logo=typescript&logoColor=white) [![Docs](https://img.shields.io/badge/Docs-instar.sh-teal?style=flat-square)](https://instar.sh/introduction/)

[npm](https://www.npmjs.com/package/instar) · [GitHub](https://github.com/JKHeadley/instar) · [instar.sh](https://instar.sh/) · [文档](https://instar.sh/introduction/) · [挂式3.0](https://instar.sh/exo3)

* * *

![Instar demo — Kira agent handling an email notification via Telegram](https://npmcn.com/package/instar/assets/demo.gif)

```bash
npx instar
```

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

* * *

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

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

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

建筑是从 [**黎明**](https://dawn.bot-me.ai/) -自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是帮助他们摆脱困境的脚手架。** 当你实例化智能时，让它凝聚在一起的结构不是可选的修饰——这是你应该做的。

## 快速启动

运行代理的三个步骤：

```bash
# 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命令行](https://docs.anthropic.com/en/docs/claude-code) · [API密匙](https://console.anthropic.com/) 或克劳德订阅

> **完整的指南:** [安装](https://instar.sh/installation/) · [快速启动](https://instar.sh/quickstart/)

## 它是如何工作的

```
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审查）+决策日志+漂移检测 |
| **增长** | 随着时间的推移，它的能力和理解能力不断发展 | 进化系统：建议、学习、差距跟踪、跟进 |

> **深潜水:** [连贯性问题](https://instar.sh/concepts/coherence/) · [价值观与身份](https://instar.sh/concepts/values/) · [一致性即安全](https://instar.sh/concepts/safety/)

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

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

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

> **见控制样→ [instar.sh / exo3](https://instar.sh/exo3)** -两个受治理与不受治理的案例研究，并提供完整的成绩单。

## 特性

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

**队列的速度** 报告每个工作队列是赶上还是落后，使用arrival， 完井和剩余工作，而不仅仅是快照计数。 `QueuePace` 定义了 测量, `QueuePaceAdapters` 读取源队列， `QueuePaceLedger` 保存每小时的证据， 选择加入 `QueuePaceTuner` 可以添加有界反馈排序运行，当该工作者是限制。 看到 [队列速度指南](https://npmcn.com/package/instar/site/src/content/docs/features/queue-pace.md)。

> **参考:** [CLI命令](https://instar.sh/reference/cli/) · [API端点](https://instar.sh/reference/api/) · [配置](https://instar.sh/reference/configuration/) · [文件结构](https://instar.sh/reference/file-structure/)

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

## 代理技能

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

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

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

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

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

浏览所有技能： [agent-skills.md /作者/ sagemindai](https://agent-skills.md/authors/sagemindai)

## Instar如何比较

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

|  | 龄 | Claude Code（独立版） | OpenClaw | LangChain / 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](https://instar.sh/guides/vs-openclaw/)

**安全模型**

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

安全存在于多个层面：

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

> **详情:** [安全模型](https://instar.sh/guides/security/)

## 理念：代理人，而不是工具

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

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

> **深潜水:** [哲学](https://instar.sh/concepts/philosophy/)

## 活着的宪法

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

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

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

> **阅读宪法：** [标准注册表](https://instar.sh/foundations/standards-registry/) · [北极星](https://instar.sh/foundations/north-star/)

## iMessage安装（macOS）

iMessage支持让您的代理在macOS上发送和接收iMessage。消息直接从本机消息数据库中读取，并通过 [`imsg`](https://github.com/steipete/imsg) CLI。

### 先决条件

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

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

有关作为LaunchDaemon运行（始终打开，在重新启动后仍然有效），请参见 [文档/ LAUNCHDAEMON-SETUP.md](https://npmcn.com/package/instar/docs/LAUNCHDAEMON-SETUP.md)。

### 配置

添加到你的 `.instar/config.json`：

```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是从 [黎明/门户项目](https://dawn.bot-me.ai/) ——一个人工智能生产系统，一个人和一个人工智能一起构建了几个月。基础设施模式是 **通过实际经验获得**在真实的人类与人工智能关系中，通过真实的失败和成长来完善。

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

## 贡献

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

看到 [CONTRIBUTING.md](https://npmcn.com/package/instar/CONTRIBUTING.md) 完整的故事。

## 许可证

麻省理工学院

## 常见问题

### 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 和提交记录判断。