开发的速度变了。理解系统的方式,
也该变了。

功能越来越快地完成,我们却越来越难掌握整个项目。

同一个项目,两种节奏概念示意 · 非实际测量数据
功能实现速度
逐渐扩大的
理解差距
工程理解的积累
开始开发多轮迭代后

当 Agent 持续推进实现,Living 把系统现状、关键变化与工程记录组织在一起,帮你看清项目现在是什么、为什么变成这样,以及还有哪些问题值得关注。

开始使用

公开 Beta 准备中 · Coming Soon

代码留下了实现。但设计的来由,在哪里?

从零散的工程资料,到能够沿着问题找到答案的项目脉络。

整理前资料散落在各处

  • Agent 会话
  • Commit 8f2…
  • 设计方案
  • 测试结果
  • 架构变化
  • 需求记录
  • 讨论纪要
  • TODO

记录 · 归类 ·
建立关联

项目脉络同一个问题的完整线索

为什么改用独立搜索服务?

  1. 01当前系统

    现在的方案与结构

    • 应用服务
    • 搜索服务
    • 数据存储
  2. 02关键变化

    调整了什么,为什么

    1. 原先直接数据库查询
    2. 后来引入独立搜索服务

    变化背景可以追溯

  3. 03依据与待确认

    讨论、验证与后续关注

    • 设计讨论
    • 验证记录
    • 待确认的问题

不是又一份文档,而是可以按问题找回的工程上下文。

概念示意 · 展示已记录工程信息的组织方式

三个工程视角

看清系统,找回判断,
关注全局。

01工程可视化

看清系统

「Agent 改完了很多文件,现在整个系统长什么样?」

继续之前,你需要先知道这轮改动牵涉哪些模块和数据,而不是从头读一遍代码。

Living 帮你
把需求、实现方案与数据资源的关系画成一张图,从能力进入系统结构。
你可以期待
更快找到理解系统的入口,看到主要组件与关系,定位值得深入调查的部分。

关系图为工程判断提供上下文,不评定工程成熟度。

示意 · 一个虚构的资料检索应用

本轮改动的文件

  • web/search-page.tsx
  • api/routes/search.ts
  • api/import/worker.ts
  • jobs/queue.ts
  • search/indexer.ts
  • db/migrations/0007.sql
  • … 共 14 个文件
需求方案数据资源
导入资料检索资料导入流程检索流程任务队列搜索索引数据库

02判断集中

找回判断

「准备再次调整架构,上一次为什么选择了现在的方案?」

当时的背景与约束散落在会话、实验记录、Commit 和文档里,重新讨论时很容易从头再查一遍。

Living 帮你
把已记录的工程选择、变化历史、依据、验证结果与未决事项放在一起。
你可以期待
理解为什么采用当前方案,回顾曾被考虑的选项,检查旧判断今天是否仍然适用。

判断始终由开发者作出。Living 只让判断所需的信息更容易找到。

示意 · 「后台任务怎样执行」的判断线索
  1. 最初方案请求内同步处理实现简单,适合小文件
  2. 调整原因大文件导入超时问题记录与一次 Agent 会话
  3. 当前选择独立任务队列导入改为后台执行
  4. 相关依据
    • 设计讨论
    • 压测记录
    • 待确认:失败重试策略

再次调整之前当时的约束,今天还成立吗?

03工程俯视

关注全局

「功能越来越多,测试、恢复和运维这些话题讨论过了吗?」

注意力自然集中在眼前的功能,测试、安全、性能、运维这些主题很难单靠记忆持续照看。

Living 帮你
从工程整体看:哪些主题已有记录,哪些判断待核实,哪些还没找到明确资料。
你可以期待
更容易发现值得讨论或验证的工程主题,决定下一步该调查什么。

当前 Beta集中展示资料覆盖与状态。探索中让记录与观察持续自动更新。

示意 · 工程领域的资料覆盖
  • 有相关记录
  • 待核实
  • 未见相关记录
  • 需求有相关记录需求记录与变更说明
  • 架构有相关记录设计说明与架构变化
  • 数据待核实有迁移记录,内容未核对
  • 测试有相关记录验证范围与结果
  • 性能待核实一次压测,结论待确认
  • 安全未见相关记录资料中尚未找到
  • 运维未见相关记录备份与恢复尚无资料

「未见相关记录」表示资料里还没找到,不代表没有做。

三个视角汇聚成的结果

  1. 看清系统
  2. 找回判断
  3. 关注全局
  4. 重新掌握工程

直接的收获

更容易理解项目,找回判断的依据,发现值得关注的问题。

长期的期待

减少信息断层与重复理解,让工程决策更连续,项目更可控。

这是 Living 的产品假设,尚未经过实验验证。

Living 不替你作决定,
而是让你拥有作出判断所需的工程视角。

这些工程视角,已经开始成为实际的工作台。

一个项目的架构,
不只有最终的样子。

这是 Living 当前 Beta 中的一张真实工程视图。从系统结构出发,可以进一步查看关键架构选择、相关设计约束及其依据。

工程成果系统架构设计

  • 系统架构总览
  • 代码组织与设计规范
  • API 与接口设计

观察范围 固定案例一个《水浒传》知识问答项目当前运行未核实最后可靠观测 候选数据非正式 Knowledge

现在是什么系统结构

部署主机 · Docker Compose

可出站网络

app应用服务

内部网络 · 无出口

searchOpenSearch
falkordbFalkorDB
tools按需 · 初始化与核验

宿主机数据 · 不是网络服务

beta.db配额与反馈
Dataset冻结数据集 · 离线

与架构判断相关的部分

为什么变成这样架构判断

关联 searchfalkordbDataset

为什么在线知识,不再由 SQLite 直接提供?

  1. 原有方案在线应用直接读取知识 SQLite
  2. 调整原因让冻结数据集只作离线依据,在线应用不再挂载知识文件
  3. 当前选择在线知识改由 OpenSearch 与 FalkorDB 提供配额与反馈仍保存在 beta.db
  • 相关设计说明设计约束与信任假设 5 条,例如数据库只在内部网络可达
  • 实施与验证记录实验环境核验(10.24)· GraphRAG 案例 Beta 环境切换(10.25)
  • 待确认事项两个库的发布,还不是一次原子操作

提议采纳只有间接转述,这条判断尚未记录为正式决定。

真实 Beta 界面内容 · 根据固定案例简化重绘省略了版本号、外部服务与部分网络细节。图中不显示实时运行状态;资料为候选数据,不是正式 Knowledge。

来源说明
这些资料从哪里来?看 Living 怎样与 Coding Agent 协作

工作原理

融入你的开发流程,
而不是替换它。

开发仍由你习惯的 Coding Agent 完成。Living 只让值得长期保留的工程信息,沿着一条明确的路径积累下来。

图中是本地 Beta 的 stdio Adapter 架构。Getting Started 中的远程 HTTP MCP 是公开版计划,接入尚未开放。

A你的项目

Living Skills规定哪些信息值得保留,怎样整理成记录与知识
已公开
Coding AgentClaude Code、Codex 照常完成开发任务
.living/ 本地工程记录记录、知识对象与同步状态,留在项目里

BMCP 集成层

MCP Adapter
  • 获取项目上下文
  • 读取 Knowledge 与契约
  • 校验结构化记录
  • 提交明确的同步
  • 返回同步结果
计划开放

与 Agent:stdio
与 Backend:HTTP Agent API
本身不保存数据

CLiving 核心产品核心

Living Backend
  • 数据契约校验
  • 结构化同步与版本历史
  • 工程资料的关联与投影
  • 证据与来源追溯
Living Web系统与能力 · 工程成果 · 工程演进

工程索引目前单独准备并安装,不经过同步。

  1. 1Agent 按 Skills 整理工程信息,写进项目里的 .living/。
  2. 2你明确要求同步时,Agent 通过 MCP 先校验、再提交。
  3. 3Backend 统一校验并整批写入,把回执交还给项目。
  4. 4Living 把已同步的资料组织成可视化、可追溯的工程视角。

只在你明确要求时同步不自动收集 Agent 会话MCP 不保存数据Living Web 不读写你的项目目录

为什么通过 MCP 连接

  1. 不替换现有的 Coding Agent

    Living 不再做一个 Agent。支持相应工具接口的客户端,可以读取 Living 的工程上下文并提交同步。目前已针对 Claude Code 与 Codex 实现适配,其他客户端尚未验证。

  2. 开发与知识管理分开

    你继续用习惯的工具开发,Living 负责保存和组织被提交的结构化工程信息。每一次开发,都可以成为长期工程理解的一部分。

  3. 清楚的接口与数据边界

    MCP Adapter 不直接操作 Living 的数据库,校验与写入统一由 Backend 完成。Agent 对项目文件的操作,不会直接改变 Living 里的正式数据。

当前版本 · Beta 0.3

从看见工程,
到持续关注工程。

Living 目前是在作者本地运行的单用户 Beta,尚未开放公众安装,也还没有注册或试用流程。

已经可以当前 Beta 的能力

  • 系统与能力的可视化需求、方案与数据资源之间的关系,以及每一项背后的记录。
  • 工程成果与资料覆盖各工程领域有哪些资料,以及系统架构、代码组织与 API 的总览。
  • 工程演进与来源追溯项目的阶段脉络与关键变化,资料可以回到原始记录。

开放连接能力,
持续演进产品核心。

已公开
Living Skills 的源文件,按版本固定。公开可读,尚未附开源许可证。
计划开放
本地 MCP Adapter、命令行工具、安装示例与接口契约。许可证与时间未定。
产品核心
Backend、Web 可视化与工程分析。保持闭源,继续独立演进。
想了解接入流程?看「开始使用」

让代码继续向前。让理解留在项目里。

Living Engineering Workspace

本地单用户 Beta · 仍在早期探索