模型的运行空间——从 Coding Agent 开始

开始使用 · 架构设计 · 设计文档 · Apache-2.0

什么是 Actspace

Act + Space = 运行空间。

Actspace 是一个本地 Agent 桌面应用，也是模型的 Harness——从底层构建上下文管线、工具系统和执行循环，让模型能够获取充分的上下文，真正地行动起来。

当前主模型选择 DeepSeek，成本低且缓存机制友好。从 Coding Agent 开始，逐步走向通用 Agent——最终愿景是彻底释放模型的能力。

设计原则

• 简约干净——采用简单有效的方案，不堆没必要的复杂度。能用一个清晰的抽象解决的问题，不拆成三层。
• 上下文的绝对控制与可视化——你随时知道模型的上下文里有什么、花了多少 token、缓存命中了多少。上下文不是黑箱，而是你可以审视和干预的对象。
• 成本可控——选择高性价比模型，围绕缓存机制优化上下文管线，最大化命中率；

核心特性

• 上下文绝对控制——token usage、context snapshot、每会话 context-state.json，模型看到了什么、花了多少，一目了然。
• 多种 Agent 形态——Solo 单任务执行；Team 由 Leader 编排多成员协作；Room 多 Agent 在共享消息流中讨论和辩论。形态由用户选择，架构可扩展。
• 被动与主动——常规 Agent 被动响应你的指令；Kairos 主动自治运行，拥有独立 prompt、短期记忆、tick 调度和专属监控页。
• 执行可视化——每个工具调用都有独立预览：文件 diff、Bash 输出、权限审批、运行状态，不靠日志猜。
• 工具系统——内置文件读写、Grep / Glob、Bash、Browser Use 等工具；Agent 也能依托 Lab 实验台，根据实际任务自己构建工具。
• 本地优先——会话、记忆、事件流全部以 jsonl 落盘，可迁移、可审计、可追溯。
• 开放可改造——项目的全部上下文（设计规范、开发历史、执行计划、设计原则）都以文档沉淀在 docs/，你可以用任何 Coding Agent 按自己的想法改造源码。

开始使用

git clone https://github.com/WakeUp-Jin/actspace-agent.git
cd actspace-agent
pnpm install
cp .env.example .env   # 填入 DEEPSEEK_API_KEY（可选 KIMI_API_KEY）
pnpm dev

打包当前平台的桌面应用：

pnpm package:desktop   # 产物输出到 dist/

截图

Kairos 自治监控	工具执行与审批
Usage 与缓存统计	文件预览
上下文控制与可视化	Review

架构设计

所有架构事实与设计决策都以文档形式版本化在仓库里：

• 架构总览——包边界、依赖方向和阅读路线。
• KAIROS模式——定时任务和KAIROS模式
• 设计文档索引——全部 core / agent / front / lab 专题。
• LLM模块的设计——学习和整理Pi的LLM模块设计
• 工具调度的设计——参数验证、权限验证、工具调度、工具执行、已取消、执行成功、执行失败
• 为你的 Agent 集成 Skill 系统——开发的核心步骤：发现、解析、使用、管理
• 上下文管理——目前的压缩机制主要是两种策略：工具输出的结果裁剪和压缩、会话历史记录的压缩

一些闲谈

我很喜欢市面上的很多 Agent 产品，想法和设计都很棒。真心感谢每一个在背后付出的团队和开发者。

大模型应用还在快速发展，我特别希望有一个能够按照我自己想法构建的运行空间——给模型一个可控的环境，让它能够真正地行动起来。

DeepSeek 的低成本和开放理念，让我可以专注于 Harness 工程本身，而不必担心模型端的成本和可靠性。

这个应用有很多的不足，但我相信随着日常使用，它会持续完善。无论应用如何变化，我希望始终保持简约干净、上下文可控、成本可控。

---

「不诱于誉，不恐于诽，率道而行，端然正己。」

致谢

• 上下文工程与运行空间实践指南——本项目的方法论参考。
• agent-harness-dev -- 一份指导开发者如何无框架从0构建 Agent 后端的架构规范的skill
• code-develop-harness-init--面向 Agent-first 开发的基础模板
• Linux.Do 社区 (真诚 、友善 、团结 、专业)
• Linux.Do社区佬友们的公益站大力支持和帮助，充足的Token得以让该项目可以实现Agent-first(人定方向，Agent 执行)

许可证

Actspace 采用 Apache License 2.0 授权。允许商用、修改和分发，但分发时需要保留许可证、版权声明和 NOTICE 中的归属声明。