本仓库是树莓娘（Raspberry Girl）体系中的文本输入模块：把操作者在控制台敲入的每一行文本作为一个 waycast 输入帧发送给核心。核心是 waycast（道枢）；本模块是它的一个输入模块（capability.kind = "input"），完全按 waycast 的 wire 契约（ADR-0008）工作，不包含任何核心逻辑。模块与核心是独立的微服务：两者之间只通过网络（WebSocket + wire JSON 帧）通信，本仓库不依赖 waycast 的任何 Python 包。
它是树莓娘各输入通道（语音、弹幕、IM……）之外最简单的一个：人在键盘前 = 一条输入通道。定位为管理端的初级形态——操作者用它直接向树莓娘下指令、纠正话题、要求停下当前讲话；未来管理端能力（结构化指令、多会话等）在本仓库上生长，不进核心。
本文是用户文档：如何安装、配置并运行本模块。协议实现与开发/测试见开发者文档 DEVELOPMENT.md；术语见 GLOSSARY.md。
- 控制台输入：从 stdin 逐行读取，一行就是一条控制台输入，即一条 UnifiedInput（
content= 行文本，source/module=loom），不做合并、不做 partial/final 标记。 - 发送输入帧：连接 hub
/ws/modules，首帧 capability 广告（input-only），随后经同一条连接发送 input 帧。 - 模块不参与话权与打断判断（ADR-0011）：任何抵达 hub 的 input 帧都触发一次 Invocation；"要不要打断当前讲话、如何干预"由核心 Agent 决定。capability 的对 Agent 描述把这条通道说明为操作员指令（权威意图），但行动方式仍归 Agent。
- 最简基本版的已知边界（有意为之，留待管理端演进）：断线期间敲入的行由终端行缓冲 兜住、重连后照发；正在发送的那一行由模块持有、重连后重发一次；但已被 socket 收走恰又在断线瞬间丢失的帧无法找回（输入侧没有 ACK 通道，waycast 契约如此）。 无输入历史；单实例控制台；超过 8192 字符的行丢弃。
- Python 3.12+ 与 uv（https://docs.astral.sh/uv/）。
- 已启动且可达的 waycast hub（例如 ws://127.0.0.1:8000），以及分配给文本输入的连接令牌（hub 无令牌校验时留空）。
uv sync --locked
cp .env.example .env # 至少填 WAYCAST_HUB_URL| 键 | 必填 | 说明 |
|---|---|---|
WAYCAST_HUB_URL |
是 | hub 地址（ws:// 或 wss://） |
WAYCAST_HUB_TOKEN |
否 | 模块连接令牌 |
WAYCAST_TLS_CA |
否 | wss 使用的 CA 文件 |
LOOM_LOG_LEVEL |
否 | 本模块日志级别（默认 INFO） |
uv run --locked loom出现 loom> 提示符后，每敲一行回车就发一条输入帧；Ctrl-D（EOF）正常退出，Ctrl-C 即刻退出。hub 不可达时按指数退避重连：首次等 1 秒，每失败一次翻倍、封顶 30 秒（带 ±20% 随机抖动），成功入连后复位。
本模块原名 raspberrygirl-text-input，2026-11-10 依 waycast ADR-0015 更名为机杼（Loom）（本仓库 ADR-0001 记录标识符映射）。
- 机杼：织布机的梭与架（《木兰辞》「唧唧复唧唧，木兰当户织」）。两层极客渊源：其一，雅卡尔提花机的打孔卡是程序之源——织机是第一种「按指令编织」的机器；其二，Ada Lovelace 论分析机：「它织出代数花纹，正如提花织机织出花叶图案」——Loom 就是第一行程序的家。
- Loom：织机。操作者在此敲下的每一行，都是织进树莓娘言行里的一根纬线。
- 「织」亦是织网——北京理工大学网络开拓者协会「网络开拓者」的本业：这张智能体网络的一经一纬，从此处织起。
- 本仓库是独立微服务项目，与 waycast 仅经 wire 契约（waycast ADR-0008）松耦合；决策见 docs/adr/，核心仓库：waycast（道枢）。
Copyright © 2026 北京理工大学网络开拓者协会（BITNP）。本仓库以 AGPL-3.0-or-later 发布（全文见 COPYING：SPDX）：可自由使用、修改、分发；但修改版以分发或网络服务方式对外提供时，必须以同许可整体开源（AGPL 的网络条款）。
树莓娘（Raspberry Girl）名称、形象与相关美术资产为网协专有，不适用本许可证。