主器灵
君所与语之常驻器灵。
首启而生，为恒久之枢：掌谋与忆，且衍生余者。凡小事付之——多时唯此足矣。
入门
自无入有，成其初功
灵台者，令君于己之机、于一隅之中，得一长伴之 AI 助手也。此篇自安装始，至托以初任，复明其运思之要，俾君得以自行。
约十分钟可读
灵台何谓，何所不谓
灵台者，长伴器灵之所居也，君自运之。其工于一目录之内，凡所知者——忆、身、识、艺——皆化为寻常文件，藏于此目录之中。其要曰：器灵即其文件，文件即器灵。易其模型，而器灵犹存。
其为
- 本地文件之 AI 助手居所，君所自有，历时而长。
- 终端之应用（TUI），以常言与数则斜杠之令驱之。
- 忆、身、识、艺，皆一夹中文件之处也。
其非
- 非闲谈之网站，非寄托之外服——运于君之机、君之项目。
- 不系于一模型——与模型无涉，LLM 可更也。
- 不独为编码——凡君可述而可督之事，器灵皆可任之。
所需与安装
始事之前
- 类 Unix 之终端——macOS 或 Linux（Windows 可假 WSL）。终端宜用深色，观之最佳。
- Python 三点一一以上。然灵台自备而自理其运行时，君殆无须亲抚 Python。
- 至少一 LLM 供者之凭（API key）。首运之际填之即可；无须灵台之籍。
安装（所荐）
此新用者之正途也。取预构之版，备其受管之运行时，且不假 Homebrew。
$ curl -fsSL https://lingtai.ai/install.sh | bash
他途安装
Homebrew（旧用者）
brew install lingtai-ai/lingtai/lingtai-tui 迁徙之期，仍可用之。若君既以 Homebrew 安之，升之以：brew update && brew upgrade lingtai-ai/lingtai/lingtai-tui，而后重启 TUI。
pip（唯为开发与诊断）
pip install lingtai 此非常规安装升级之法。唯欲开发或诊内核之时用之——其不理项目之运行时。
常保其新
循所荐之法，TUI 自理其运行时之更。须记有二层——TUI 之程与受管之 Python 运行时；若升而版犹旧，则重启 TUI，运 /doctor 以葺其运行时。
首启与初立项目
灵台之项目，一夹而已。君于其中启 TUI，器灵所造皆藏于斯。首运之时，有简导引君以竟设置，且启一常驻之器灵。
-
造一项目之夹而入之
君所在之夹，即为项目。习艺之初，先自空夹始。
$mkdir my-project && cd my-project -
启 TUI
此于当下之目录开灵台。首运自造 .lingtai/ 之夹，且备其运行时。
$lingtai-tui -
随设置之导，择 Tutorial 之谱
导者次问君之 API key、模型、器灵之名，及一始谱。择内置之「Tutorial」谱：器灵遂于 TUI 之中，逐课授君以斯系之用。
此首导即 /setup 之流也。君可随时重运 /setup，以易供者、模型或能力；缀以 /setup credentials，则径入凭据之检。
君之初任
君以常语相语，按回车而达之。善之初任，安而具、唯观而不改——令器灵先察而后动。
试输如是之语
助我谙此项目。先阅 README 与 docs 之夹，勿改一文；既而告我：此项目何为、何文最要、下一步君何所荐。
何以授令，俾器灵可行
- 明其的——以一言状「成」之貌。
- 定其界——何文何夹当动，何者不当动。
- 标其禁——如：勿发讯、勿删文、勿泄密钥。
- 示其复命之式——一结、一录、一文，皆从君所欲。
观器灵所为
此无 /status 之令，代之以启一看板。最要者 /kanban，示诸器灵之态、之脉息、之 token 耗，及其上下文之盈几何。
/kanban | 网络之看板：诸器灵之态、脉息、token 与体力，及上下文之耗。 |
/daemons | 察器灵所遣之短工——其任、其迹、其态。 |
lingtai-tui list --detailed <project-dir> | 于命令行：列某项目目录中之诸器灵（主器灵有志）。 |
三者之别：主器灵、分神、分身
灵台非独一器灵，乃一小组织也。三者宜早知；各系一经验之则。
分神
短时并行之工也。
为一嘈而有界之事而分——群查、互核、广扫——事竟即弃。君留其论，不留其身。凡一时并发之工，用之。
分身
恒久而专司之侪也。
长存之器灵，自有其忆、其邮、其责——若一定侪，专司一域。若一专长宜跨多会而存，则立一焉。
器灵何以记：文件、知识、技艺
器灵所知，尽藏于盘上 .lingtai/ 之中，君可假 ls、cat 之常器观之。三层宜辨。
文件
寻常之工作文件。
器灵于项目各处所读写之报、之改、之成物。无甚异——即工作本身耳。
知识
恒久而私有、各器灵自持之忆。
器灵为己所存之久事、之径、之断、之鉴，置于其 knowledge/ 之夹。提示之中唯列简目，全条则按需而取。以 /knowledge 阅之。
技艺
可复用之做事之法，诸器灵共之。
Markdown 所撰之做事之册（各一 SKILL.md），述何以竟一类屡见之事，按需而载。异于「知识」，技艺乃同一 .lingtai/ 下诸器灵所共。以 /skills 阅之。
上下文与凝蜕
器灵一时所能见之对话有限——是谓上下文之窗。譬之一案，纸渐盈焉。案既满，器灵乃「凝蜕」：自撰一慎密之结，遂空其窗，携此结——并其一切久忆——迁于净案而续之。
此常理之事，非败也。上下文既迫，器灵历数则短警之后，自行凝蜕。君常无所须为。
若一任攸关，君可预为凝蜕之备：先令器灵「收功总结」——存其的、其已成未成、其要文之径、其论、其下一步于忆——而后运 /molt 以强之。（勿与 /clear 相混，彼空对话而不存；亦勿与 /nirvana 相混，彼不可复而尽抹其器灵。）
可选：外部之径与附件
常则君于终端与助手语。若愿，亦可假外径以达同一助手——同其忆、同其史。此皆可选之附件，以 /mcp 设之。
- Telegram 自 Telegram 与助手语，可择设白名。
- 飞书 假长连之 WebSocket 而通——无须公网之 IP 或 webhook。
- 微信／WhatsApp 假各讯软所备之桥以达助手。
- 邮（IMAP） 假 IMAP/SMTP 予助手一真收件之箱，于生人有安全之默设。
凡易一径或 MCP 之配，运 /refresh，俾器灵纳之。
令与捷键速查
于 TUI 中输 / 以开令之面板；其能模糊而合，故 /skl 即得 skills。下列一精简之集，以为入门：
常用之令
/setup | 设或易供者、模型、能力与凭据。 |
/kanban | 网络之看板，含上下文窗之耗。 |
/skills | 阅所共之技艺之册。 |
/knowledge | 阅此器灵私有之知识（别名：/library、/codex）。 |
/mcp | 理外部之径及余 MCP 之附件。 |
/molt | 存上下文，遂重置对话之窗。 |
/doctor | 诊连、钥、模型，且葺其运行时。 |
/help | 启 TUI 内之助读器，览其全列。 |
键盘之捷
| Enter | 发当下之讯。 |
| Shift+Enter / Ctrl+J | 插一换行而不发。 |
| / | 开令之面板（输而模糊以筛）。 |
| Ctrl+E | 为长讯开外部之编辑器。 |
| Ctrl+T | 于 /skills、/knowledge、/system 之视中易器灵。 |
排疑
- lingtai-tui：命令不获
- 安装之目录不在君之 PATH。启一新终端，或将安装之处（安装之末所示）纳于 PATH，而后再试。
- TUI 已启，而助手无应
- 其或正运一久器，或方凝蜕——少待之。既而观 /kanban、运 /doctor，且视 .lingtai/<agent>/logs/agent.log 之末。
- 既升而无所改
- 记其二层——TUI 之程与其受管之 Python 运行时。重启 TUI；若版犹旧，运 /doctor 以葺其运行时。
- 一技或一令若失
- 运 /doctor 以重解内置之技与器，且验所启之预设无误。
下一步
欲更深者，其捷莫如产品本身：启 lingtai-tui，择 Tutorial 之谱，令器灵逐念授君。若欲知其详，下列乃其正源。