Agent 与自动化AI 资源
Selvedge:为 AI 编码代理提供持久决策记忆
masondelan/selvedge · Persistent decision memory for AI agents: rationale, rejected approaches, and entity history. Connect any compatible agent through local MCP or the CLI.
ELI5:它是什么,解决什么问题
Selvedge 是一个面向 AI 代理的决策记忆工具,用于记录某项选择的原因、被否定的方案以及改变主意的条件,并以函数、数据库列、API 路由或依赖等实体作为查询键,在后续编码会话中检索这些上下文。它通过本地 stdio MCP 或 CLI 接入兼容代理,记录保存在项目内 `.selvedge/` 的 SQLite 中,切换工具时仍可复用。项目提供查询、diff、blame、变更集、全文搜索及导出等命令,并支持 Agent Trace 格式导入导出。核心存储与检索不调用 LLM,也不需要托管账户。
核心能力与快速开始
★ 26 · Python
- 能做什么
- 记录决策的理由、被否定的方案和重新考虑的信号,并绑定到代码实体;通过 MCP 工具(log_change、prior_attempts、blame、diff、history、changeset、search、stale_decisions)或 CLI 保存与检索;支持按最近时间、变更集、实体路径查询,全文搜索,统计,从迁移文件回填,导出 CSV 或 Markdown,以及 Agent Trace v0.1.0 格式互转;可选安装 Git post-commit 钩子,并用摘要漂移检查发现过期记录。
- 适用场景
- 个人开发者在原始对话丢失后重新进入项目时找回此前的设计约束;团队在多个会话与编码工具之间传递已记录的决策;在修改数据库列、路由、函数或依赖之前检查此前尝试与被否定的方案;按功能或任务用 changeset 汇总跨实体决策;审查前导出决策摘要做一致性检查。
- 项目形态
- 可直接使用的工具
- 部署方式
- 本地安装使用,通过 stdio 启动 selvedge-server 作为本地 MCP 服务器,数据存于项目内 `.selvedge/` 的 SQLite;不提供托管端点,远程 HTTP 客户端需自行配置 stdio 桥接。
- 主要依赖
- 需要 uv 与 Python,推荐 Python 3.11–3.14,Python 3.10 兼容但已停止维护;也可在虚拟环境中用 pip 安装。兼容能启动本地 stdio MCP 服务器或具备 shell 访问的代理。
- 使用限制
- 只能召回被显式保存的决策,且不验证记录内容的真实性,也不保证代理一定会查阅;MCP 接入不会自动捕获所有决策,需要安装的指令引导代理使用;生命周期钩子、启动投递与压缩通知因客户端而异;GitHub 审查 Action 的原生执行与实际审查效果尚未验证;未说明 API 成本相关限制。
- 许可证
- MIT
- 最近推送
- 2026-11-01 13:13
资料检查:2026-11-02 07:00 · 卡片整理:2026-11-05 07:00
卡片由 AI 根据仓库资料整理,未进行安装或运行验证
讨论 0
登录后参与讨论,阅读资讯无需注册。
还没有评论,来分享第一个看法。