运维 ThreadCells
无需翻查仓库。

ThreadCells 是一个自托管系统，用于在 Linux 机器上将多个编码智能体作为一个协调的工作流运行。它为智能体提供真实终端和 Git worktree，让开放任务能够跨模型轮次持续推进，同时让操作员掌控容量、写入权限、受保护的变更以及最终结果。

这是从源代码检出到本地 ThreadCells 服务器最快的受支持路径。它会构建不可变的本地候选版本，验证其内容，将它安装在当前仓库下，并且仅监听 loopback。

本指南说明受支持的本地安装路径，以及 ThreadCells 为何从经过验证的候选版本安装。若只需要命令，请使用快速设置。

本教程启动一个刻意保持小规模的智能体，并说明在哪里找到它的终端和结果。请先完成快速设置，并让 ThreadCells 服务器保持运行。

ThreadCells 为原生编码智能体终端增加结构。本页一次介绍一个概念，然后说明这些部分如何组合。

ThreadCells 采用 loopback-first：服务器应监听 127.0.0.1，而不是公共接口。普通 Web UI 是操作员控制台，并不提供通用登录边界。

Web UI 是操作员查看 ThreadCells 实时状态的界面。它面向 loopback 监听器设计，既可在浏览器中正常使用，也可作为已安装的基础 PWA 使用。安装它不会增加离线运行行为或新的认证边界。

ThreadCells 项目是已注册的 Git 仓库和规范源代码权限。它为会话、配置文件、统计和工作流提供稳定的归属位置，但不是新 supervisor 的常规可写目录。仅注册仓库绝不会让它变得安全，因此请从干净状态开始，并了解你授予的写入边界。

提供商是实际运行模型回合的原生编码代理 CLI。ThreadCells 会在该 CLI 外提供适配器，使启动、终端状态、取消、能力报告及可用的用量遥测具有统一的形式。

配置文件是代理可复用的启动策略。它回答：应运行哪个提供商和模型、应使用多少推理强度、应接收什么角色和指令，以及允许哪些能力或权限？

工作流表示必须跨越多个模型回合、终端或委派代理保持一致的工作。它防止将提供商的最终消息误认为更大任务已经完成。

Statistics 汇总受支持的提供商 CLI 实际发出的用量数据。它帮助回答哪些会话、配置文件、项目和提供商消耗了模型 token；它不是计费账本，也不会虚构缺失值。

操作员授权保护 Settings 中敏感的控制平面变更。它与对普通 Web UI 的访问是分开的：浏览代理、终端、文档和统计信息不需要操作员密钥。

ThreadCells 可以向一个 Telegram 目标发送低噪声的生命周期通知。这是安装级别全局的 ThreadCells 能力：它不属于、不从中读取配置，也不依赖当前选定的项目。

ThreadCells 分别处理各种容量，因为编码代理工作会在不同时间对主机的不同部分施加压力。模型回合消耗提供商容量；分配的编码上下文可以在模型空闲时保持活动；模型输出停止后，构建仍可能使机器饱和。

这是面向维护者的高级指南，用于添加受信任的提供商集成。在内置提供商之间进行选择的操作员应先阅读提供商。

ThreadCells 在本地候选版本的 schemas/v1 以及 wheel 包的 cliagentorchestrator/publicschemas/v1 下发布 ProfileDefinition V1、ProviderConfiguration V1、AdapterManifest V1 和 AdapterCapabilities V1 的…

ThreadCells 是围绕原生编码代理进程构建的本地控制平面。它有意将提供商终端、Git 仓库、持久化协调状态和浏览器 UI 保持为具有明确边界的独立组件。

ThreadCells 的日常运维主要在于维护四类事实：正在运行的构建标识、工作流所有权、可用容量和可恢复状态。

只有当 ThreadCells 能证明运行时工件符合条件时，Housekeeping 才会回收它们。它有意采取保守策略：未知、不可读、活动、被引用或已变更的资源会受到保护，而不会被猜测为可安全删除。

有用的 ThreadCells 备份会保留持久化协调状态，以及解释该状态所需的配置。已安装代码和构建缓存通常可重建；数据库、操作员所有的配置和提供商原生证据则未必如此。

ThreadCells 部署会将已验证的不可变候选版本提升到本地运行时。它不意味着发布、Git 推送/打标签、包发布或公开网络暴露。

升级是带有已验证回滚的受控候选版本提升，而不是原地覆盖碰巧正在运行的任何文件。

先保留证据：当前构建身份、安全错误文本、受影响的会话/工作流、容量状态、近期日志和 Git 状态。在确认持久化操作是否已经成功前，避免清理、删除或盲目重试。

使用 scripts/buildlocalcandidate.py --output <new-directory 从干净、已提交的工作树构建隔离的本地候选版本。它会打包生成的文档/UI 和本地 wheel。验证 SHA256SUMS，检查 candidate-manifest.json、sbom.cdx.json 和 EVIDENCE.md，然后使用…

ThreadCells 面向由一人或一小组受信任人员操作的一台受信任 Linux 主机。它协调功能强大的原生编码代理；它不是用于敌对用户、提示、仓库或提供商插件的沙箱。

ThreadCells 是一项技术预览，专注于在一台 Linux 主机上为编码代理提供可信赖的本地操作。这些边界是有意设定的产品事实，不是对尚未实现的企业功能的承诺。

ThreadCells 面向已经认可原生编码代理 CLI、但需要更清晰地在一台机器上操作多个此类 CLI 的开发者。

ThreadCells 是从 AWS Labs CLI Agent Orchestrator 派生的独立下游项目。保留的上游许可证和署名位于源候选版本的 LICENSE 和 NOTICE 文件中。本仓库在保持既有行为所需之处保留兼容的内部 cao 名称和命令；公开产品表面使用 ThreadCells。不暗示 AWS 的赞助或认可。

感谢你帮助改进 ThreadCells。我们欢迎聚焦、可执行且适合公开讨论的报告和拉取请求。

英语是 ThreadCells 公开文档、根 README 和产品声明的规范权威。翻译可以改善自然表达，但不得遗漏或虚构行为、削弱安全边界、更改限制或修改命令。

GitHub Issues 是 ThreadCells 精心维护的公开待办事项，而不是警告、审计或发布调试的记录稿。