灵台

于一项目之中，立器灵之组织；非但增一智能体也。

本地为先 · 器灵常驻 · 心流自省 · 信匣往来 · 生死有制 · 群灵成网

灵台，心也。

灵台者有持，而不知其所持，而不可持者也。 — 庄子 · 庚桑楚

English | 中文 | 文言 | lingtai.ai

诸 agent 之器，多予人一善工。灵台所予者，AI 组织之基也：器灵久居本地项目，各有庐舍目录、收发信匣、久藏之记、生死之制、自省之心流；事大而一心不足，则可召同侪，亦可化分身。

OpenClaw、Hermes 诸器，善为可役之手，能行 agentic task。灵台则立其上之组织法：能以编码智能体与 CLI 为工，而自守其角色、记忆、书信、督察、复苏之道，使一网器灵不以一窗既闭、一终端既息而散。

人自 TUI、Telegram、飞书、微信、WhatsApp、邮件下令。其组织由被召之器灵醒，读项目旧记，用本地诸器，成文卷，必要则调同侪，终仍由来路复命。

非一窗，乃元组织

人曰：
  “今夜守此仓。若 PR 坏，则察其故，草其修，
   明旦以简报告我。”

灵台：
  自信匣而醒
  → 读久存项目之记
  → 用 shell / web / file / coding-agent 诸器
  → 闲或滞时，以 soul flow 自省
  → 书札、成报、补丁、定期之务
  → 需并行，则请分身或神识
  → 仍由 Telegram / TUI / 邮件奉复

终端可闭。其组织犹有 .lingtai/ 之宅、信匣、可验之日志，亦有眠、醒、刷新、复苏、凝蜕诸生命之制。Soul flow 者，器灵内省之流也：久闲之后，能返观其局，见所遗漏，陈可行之后策，不必永候下一问。

三令而启

brew install lingtai-ai/lingtai/lingtai-tui
mkdir my-project && cd my-project
lingtai-tui

初入 LingTai？先读小白工作手册（或单文件 HTML 图解版），再启首个项目。

初启之时，灵台作 .lingtai/，备其运行时，引君择模型与配方，并令一常驻器灵守此项目。

project/
└── .lingtai/
    ├── human/              # 人之信匣身份
    └── <agent>/            # 一常驻项目器灵
        ├── inbox/ outbox/  # 书至则醒
        ├── knowledge/      # 久存事实与所学
        ├── system/         # pad、总结、恒规
        └── logs/           # 可考之运行迹

PyPI 之 lingtai 包固在，然其为 TUI 代管之 Python 运行时。安装、升级宜用 Homebrew；唯开发或诊断内核时，乃用 pip。

欲手动更新 TUI，可行 lingtai-tui self-update；其先辨装法，Homebrew 与 source/user-local 皆可自更，unknown/other 则止而示指引。

启时亦察源码/用户本地之新版；若辞，则不动旧二进制，并示 lingtai-tui self-update 以待后行。

doctor 亦辨 TUI 之装法：homebrew、source/user-local、unknown/other。非 Homebrew 者，不妄行 brew，但示手动更新之路。

大陆网络之镜像、stale tap、源码编译诸细，详见 README.zh 安装详解。

所善

何以异

制式一览

flowchart LR
    human[Human] --> channels[TUI / Telegram / Email / Feishu / WeChat]
    channels --> agent[常驻灵台器灵]
    agent --> soul[Soul flow: 自省 + 主动后策]
    agent --> tools[Files / Bash / Web / Vision / MCP / Coding CLIs]
    agent --> memory[Pad / Knowledge / Skills / Character]
    agent --> lifecycle[Sleep / Wake / Refresh / CPR / Molt]
    agent --> network[组织: avatars + daemons]
    network --> portal[组织实时可视]
    tools --> artifacts[报告 / 补丁 / 笔记 / 定期之务]
    soul --> agent
    memory --> agent

随事而长

始于一常驻器灵。事大，则组织随之而长：

• 凝蜕而不失忆。 长会话卸其尘滓，而以总结与久记传后身。
• 自省而不枯候。 Soul flow 使器灵于闲时反观，见失路与新机。
• 化分身。 令长存专才各有记忆、信匣、职责。
• 遣神识。 以短命工人分繁杂批务，留其结论。
• 以编码智能体为手。 Claude Code、Codex、OpenCode、OpenClaw、Hermes 等为精作之手；灵台执其计、记、协同与对人之言。
• 观其生长。 Portal 显谁存、谁作、组织拓扑何以变。

外接诸器

外接插件者，接通外部通讯之道也。可于 TUI 中以 /mcp 控制面板配置，亦可于 init.json 中明示。

飞书（Feishu/Lark）

飞书插件以长连接之术接收讯息，无需公网之址，无需回调之路。

飞书开放台配置：

1. 于 open.feishu.cn/app 创企业自建应用
2. 启机器人之能（Bot → 功能 → 启用）
3. 权限管理 → 加 im:message
4. 事件订阅 → 选"以长连接接收事件" → 加 im.message.receive_v1
5. 发布应用版本

配置文件 feishu.json：

{
  "app_id_env": "FEISHU_APP_ID",
  "app_secret_env": "FEISHU_APP_SECRET",
  "allowed_users": ["ou_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"]
}

于 init.json 中明示：

{
  "addons": {
    "feishu": { "config": "feishu.json" }
  }
}

文档

• 初用者，可先读 《灵台工作手册（初学者友好版）》，亦可观 单文件图解版。
• 接外渠者，于 TUI 中用 /mcp，再读相应插件之入门文。
• 读源码者，自 ANATOMY.md 入，而后下至 tui/ANATOMY.md 或 portal/ANATOMY.md。

同道

诸君若有问、有疑、有议，可于 GitHub Issues 或 Discussions 言之。

微信同道群

扫码加作者微信（备注 lingtai），引入测试群。此码按时更之，若已过期，烦君提 issue 相告。

许可

MIT — Zesen Huang, 2025–2026

lingtai.ai · lingtai-kernel · PyPI