一、开始
一个 loop，就是一个经营主体；它的根目录，就是经营基地。
- 在 loopling.cn 注册。系统会为你的账号单独开通 Codex 与 Claude 两条模型通道，不限额度。
- 登录控制台，点右上角「⤓ 下载 Windows 安装包」。安装包与你的账号绑定，双击即装到
%LOCALAPPDATA%\Loopling，不需要管理员权限。 - 在经营基地（例如
D:\loops\3D打印_钥匙扣）上点右键「灵环 · 接入此 loop」。Windows 11 先点「显示更多选项」。 - 一个 cmd 窗口亮起：连接员激活、创建
.loopling\、登记云端、自检。没有需要你回答的问题。保持窗口开着，这个环就在线。 - 回到控制台，环已经在转。在右下角对主管说话。
每次启动都会先检查更新，只下载有变化的组件。不要把磁盘根目录、用户主目录或系统目录接入。
二、.loopling 目录
右键接入后，目录里会多出两个隐藏文件夹：.loopling\ 是通往云端的门，.loop\ 是这个 loop 自己的宪法与记忆。
| 路径 | 内容 |
|---|---|
.loopling\AGENTS.md | 写给本机任何 agent 的说明：这是哪个 loop、怎样记账、怎样找到主管 |
.loopling\lp.cmd | 连接员命令行：lp status、lp doctor、lp sync、lp ask "…" |
.loopling\loop.cmd | 运行时命令行，等同 python -m loopling …（用安装包自带的 Python） |
.loopling\config.json | loop ID、主管引擎、连通目录 links |
.loopling\agent.json | 设备凭据与模型通道——不要复制给别人 |
.loopling\STATUS.md | 连接员最近一次自检汇报 |
.loop\loop.json | 宪法：班次、节律、欲望、资本折算率 |
.loop\state\capital.jsonl / workers.json | 资本账本 / 劳动者花名册 |
Loop.md · 拍板.md · 请拍板.md | 台账 · 你对 loop 说的话 · loop 问你的话（不阻塞） |
想让经营基地连通别的目录（素材库、打印机共享目录），在 .loopling\config.json 的 links 里写上 {"name": "素材库", "path": "E:\\assets"}，控制台的目录网状图会把它画在外缘。
三、两个本地 agent
| 灵环 agent（连接员） | 主管 agent | |
|---|---|---|
| 是什么 | 安装包里的常驻进程，自带一个无头 Codex 做自检与诊断 | loop 根目录里的 Codex CLI（gpt-6-astra / high）或 Claude Code（claude-opus-5-5） |
| 职责 | 打通云端：登记、心跳、快照、收指令、回传事件；不经营 | 经营：读台账、记账、推进 M→C→M'，对你负责 |
| 生命周期 | 窗口开着就在线 | 每条消息唤起一次无头会话，用 resume 接上同一段对话 |
云端唤起主管用的是托管会话：连接员收到你的话，在根目录启动 codex exec resume … 或 claude -p --resume …，把每一步流式回传到控制台，同时打印在本地窗口里。它不依赖有人开着终端，锁屏、远程桌面断开时照样工作；每条消息是一个独立进程，死了不影响连接员。控制台可以随时切换引擎——切换即开启新对话，台账不变：主管是一个位置，不是某个模型。
四、资本账本
M 是投出的钱，C 是钱变成的商品，M' 是商品回笼的钱。每笔都记在 .loop\state\capital.jsonl。
python -m loopling capital add M 320 --category material --note "PLA 耗材 10 卷" python -m loopling capital add C 260 --category product --note "连笔字钥匙扣 60 件" python -m loopling capital add M1 1180 --category sales --note "拼多多回款" python -m loopling capital add M1 --unit 粉丝 --raw 420 --note "本周涨粉" # 按折算率换算 python -m loopling capital summary [--days 30] [--json] python -m loopling capital list [--limit 30]
非货币收益必须先在 loop.json 写折算率，否则拒绝入账——口径要写下来，才能被质疑：
"capital": { "currency": "CNY", "window_days": 30,
"conversions": { "粉丝": 0.8, "播放": 0.002 } }
汇总给出窗口内的 M、C、M'、增殖 ΔM = M' − M、增殖率 ΔM / M 与周转 M' / M。它们每班注入主管的 prompt 作为「资本回路」，但从不进入完成定义：数字是方向盘，不是终点线。
五、劳动者
人也是 agent。每位劳动者有工牌 ID（LP-0001 起，永不复用）、种类（silicon 硅基 / carbon 碳基）、角色、技能、权限与可工作时段。
python -m loopling workers list [--all] [--json]
python -m loopling workers add --name 打包师傅 --kind carbon --role worker \
--skills 打包,发货 --hours "mon-sat 14:00-20:00" --contact 微信
python -m loopling workers add --name 上架员 --kind silicon --role operator \
--engine claude --model claude-opus-5-5 --perm write,publish
python -m loopling workers set LP-0005 --status paused
python -m loopling workers remove LP-0005 # 标记离开，工牌不复用
权限：decide 拍板 · spend 花钱 · write 改文件 · publish 对外发布 · redline 改红线。初始化时登记三位：主管、连接员、所有者；只有所有者持有 redline 与 decide。
六、欲望与驱力
运行时来自拉康的欲望与驱力模型。欲望 = 要求 − 需要：每班点火时计算落后比例，调节主管的激进度；所有要求达标时，缺口移位而不是宣布闭合。驱力的满足在回路本身：每一圈必须留下剩余（lesson / signal / hypothesis / symptom / log），没有剩余的一圈被审计为空转。反复出现的事故登记为症状，直到被裁决为规则，或被接受为“知道怎么跟它过”的 sinthome。每周的轮回之刃审规则、审假设、审班次表本身——包括 loop.json。
python -m loopling status | doctor | desire | knife python -m loopling residue add --kind lesson "…" python -m loopling symptom add "…" / request "…" / halt "原因"
七、云端架构
| 部分 | 位置 | 作用 |
|---|---|---|
| loopling.cn | 香港 | 网站、账号、安装包、模型通道（按用户 key 转发） |
| loopling-cloud | 新加坡 · 独立区域 | loop 登记、快照、指令队列、主管对话 |
| 云端 Agent | 新加坡 | Codex · gpt-6-astra / high；只能提出类型化动作：转告主管、点火、停机、恢复、同步、诊断 |
| 连接员 | 你的电脑 | HTTPS 长轮询连云端，证书固定 |
凭据分层：浏览器只有登录 cookie；设备只有安装密钥与设备凭据；你的模型 key 只在服务器上，nginx 转发时替换。吊销安装后，那台电脑既不能登记，也不能用模型。
八、控制台
- 环：三站 M → C → M' 在 120°；粗细是窗口金额，粒子流速是周转；终点比起点高出的那一级台阶是 ΔM（亏损为红，落在起点之内）。环心是空位，只有
desire.void的淡字。 - 外圈是劳动者（六边形为硅基、圆为碳基，在班的发光）；内圈刻痕是最近的班次，暗红为空转。
- 目录网状图：根目录居中，子目录径向展开，连通目录以紫色虚线挂在外缘。
- 右栏：点选任何对象看详情；下方「主管」与「云端 Agent」两个面板。
九、诚实的边界
- 灵环不保证赚钱。账本只记录事实。
- 主管以你的系统账号在你的电脑上运行，没有操作系统级隔离；红线写清楚，拍板留给自己。
- 窗口关闭、电脑关机，环就停止心跳；云端不代你运行业务，也不保存业务文件。
- 目前只提供 Windows x64 安装包；安装包未做代码签名。