Kyno Vibe 项目

项目简介

Kyno 是一个面向 AI Agent 的「方向运行时」（Direction Runtime）开源工具。它的核心理念是让「任务方向」成为 AI Agent 运行时的一等公民——人类操作者设定使命（Mission）和原则（Principles），Agent 在每一步执行前主动拉取当前版本的方向，基于此判断 trade-off 并自主决策。方向变更可以热更新、版本化、可追溯，Agent 无需重启即可获取最新指令。

Kyno 的典型使用场景是：多个 Agent 并行工作（如 researcher、planner、writer、reviewer），人类主管在途中修改了优先级或目标，所有 Agent 在下一次拉取方向时自动感知变化，继续以新方向推进工作。所有方向变更均有版本记录，事后可完整回溯每次决策时的指令版本。

核心功能

• 版本化方向存储：每次方向变更生成新版本号，旧版本保留完整历史
• MCP 传输协议：通过 Model Context Protocol（MCP）在每个工作步骤边界向 Agent 推送当前方向
• 热更新不中断：方向变更后，正在运行的 Agent 在下一次 pull 时自动获取最新版本，workflow 无需重启
• 版本溯源：每一步执行均记录所使用的方向版本号，事后可回溯「当时 Agent 基于哪个版本做决策」
• 操作者仪表盘：提供方向编辑界面（Operator UI），人类可随时修改使命和原则
• 多 Agent 支持：支持多个 Agent 并行工作，每个 Agent 可订阅不同的方向配置文件
• 本地向量宪法：支持将方向存储为结构化宪法文件（YAML），易于人类读写
• 零依赖 CLI：pip 安装，无需额外服务，本地二进制可离线运行

技术实现

Kyno 的架构分为三层：

方向存储层（Direction Store）：持久化的版本化 KV 存储，记录每个宪法（Constitution）的当前版本和完整历史。底层支持 SQLite 或文件存储，保证轻量和可移植。

传输层（Transport）：通过 MCP（Model Context Protocol）在 Agent 每次工作前主动推送当前方向。MCP 是一种标准化的上下文协议，Kyno 作为 MCP Host 端，Agent 作为 Client 端，方向以结构化 JSON 随每次上下文注入传递。

策略层（Policy）：Agent 拉取方向后，由 Agent 自身根据方向的优先级列表（ordered principles）做本地推理判断。当方向变更时，策略引擎感知新优先级，做出不同决策。

安装方式：pip install kyno，然后 kyno new && kyno db init，编辑 constitution.yaml 后 kyno apply 并 kyno serve --transport stdio。

快速上手

1. 安装 Kyno：pip install kyno
2. 初始化项目：kyno new acme && cd acme，进入项目目录
3. 初始化数据库：kyno db init，创建本地 SQLite 方向存储
4. 编写宪法文件：在 constitution.yaml 中定义 mission（使命）和 principles（原则列表，按优先级排序）
5. 应用方向：kyno apply constitution.yaml --note "initial constitution"
6. 启动 MCP 服务：kyno serve --transport stdio，Agent 通过 stdio 接口拉取方向
7. 运行时更新：在任何时候修改 constitution.yaml，运行 kyno apply，Agent 下一次 pull 自动获取新版本

适用人群

• 需要多 Agent 协作且希望集中控制任务方向的团队
• 对 AI 决策过程有合规或审计要求的企业（金融、医疗、法律）
• 希望 Agent 在运行时能「响应指令变化」而非僵化执行初始 prompt 的开发者
• AI 研究者和 AI Governance 实践者