ActSpace Docs
ActSpace 是什么
理解 ActSpace 作为本地 Agent 桌面应用与 Harness 的定位、边界和设计原则。
ActSpace 来自 Act + Space:给模型一个能够读取上下文、调用工具并在权限边界内完成工作的运行空间。
它既是一个本地桌面应用,也是一个可改造的 Agent Harness。桌面界面负责交互与可视化,Agent Core 负责模型接入、上下文、工具、持久化和执行循环,共享包负责跨进程契约。
它解决什么问题
一个能聊天的模型,不等于一个能可靠工作的 Agent。真正执行任务还需要回答这些问题:
- 模型本轮看到了哪些上下文?
- 哪些工具可以调用,参数如何验证?
- 高风险动作在哪里暂停并等待用户批准?
- 流式输出、工具结果和中断状态怎样被持久化?
- 长会话如何压缩,同时保留可追溯性?
ActSpace 把这些 Harness 工程放到一套本地、可阅读、可替换的实现里。
当前产品形态
当前主线是面向开发工作的桌面工作台:
- 在 Composer 中描述任务并选择模型。
- Agent 组装系统规则、历史记录、工具和工作区上下文。
- 模型流式回复或发起工具调用。
- 工具经过参数校验、权限判断和执行器处理。
- 回复、工具事件、用量与 Context 快照写入本地会话。
除被动响应的主 Agent 外,ActSpace 还包含 Kairos 主动模式、Browser Use、Skills、文件监听插件和可独立查看的 Review / Context / Reply 对象面板。
三条设计原则
简约干净
优先使用小而明确的抽象。能由一个清楚边界解决的问题,不为了“架构感”堆叠额外层级。
上下文可控
上下文不是不可见的 prompt。Token、缓存、Context 快照和会话状态都应可观察,并能被用户干预。
成本可控
模型选择、缓存命中、上下文裁剪与压缩都属于产品体验的一部分。ActSpace 会展示真实用量,并允许为不同任务选择不同模型。
本地优先意味着什么
会话、事件、Context 状态与记忆优先写入本机文件。这个选择让数据更容易迁移、审计和排障,但也意味着你需要像管理其他开发数据一样管理本机目录与备份。
下一步可以直接安装并启动 ActSpace,或者从一次 Agent Turn开始理解运行链路。