产品与价值
把多种 AI 编码代理组织成“公司”：目标、组织架构、预算、治理、审计统一在一个控制面板里。
代码与规则片段
CODE
Monorepo layout: server + ui + cli + shared + adapters + db packages
server/src/index.ts bootstraps DB, migrations, telemetry, websocket live events
Entity scoping uses companies/companyMemberships for multi-company isolation
Adapters include claude-local/codex-local/cursor-local/openclaw-gateway/http/process
PLAIN ENGLISH
这一段是项目最值得先读懂的能力边界。
先确认主链路，再决定扩展与改造路径。
应用测验
第一次接手这个项目，哪一步最该优先完成？
角色与模块协作
从责任边界观察系统复杂度。
群聊动画
关键配置片段
CODE
npx paperclipai onboard --yes
cli/src/commands/onboard.ts parses env and bind presets (loopback/lan/tailnet/custom)
manual dev: pnpm install && pnpm dev
root scripts expose dev/server/ui/test/db:migrate/release/e2e paths
default local API: http://localhost:3100 with embedded postgres bootstrap
PLAIN ENGLISH
这些配置通常决定部署方式与集成成本。
数据流动画
输入到输出的主链路拆解。
消息流
User
Entry
Core
UI
点击 Next Step 开始
核心实现片段
CODE
Migration gate: inspectMigrations + applyPendingMigrations + prompt guard
Local trusted board principal auto-provisioned with instance_admin role
Telemetry wired by initTelemetry/getTelemetryClient with config toggles
CLI and server both maintain extensive test suites for routes/adapters/routines
PLAIN ENGLISH
这里是判断性能、扩展性与可维护性的关键入口。
落地与风险
稳定运行和风险边界同样是产品能力的一部分。
代码与规则片段
CODE
Requirements: Node.js 20+ and pnpm 9.15+
Telemetry enabled by default and can be disabled via env or config
Startup blocks on stale migrations unless explicitly applied
Bind/public URL choices directly affect auth and exposure model
Budget/heartbeat/governance controls are core anti-runaway boundaries
PLAIN ENGLISH
这一段是项目最值得先读懂的能力边界。
先确认主链路，再决定扩展与改造路径。