Edges - 认知系统

构建可复用的认知优势，提高未来判断效率

项目背景

Edges 是一个 以知识沉淀为手段、以长期认知复利为目标的个人系统。

它关注的不是一次判断是否正确， 而是：是否在时间维度上，持续形成可复用的判断优势（edges）。

设计思想

终端捕获，核心沉淀：各个终端（ChatGPT、Cursor、Claude Code、Gemini CLI 等）作为知识的感知端，负责总结对话中的核心逻辑与灵感。通过 new-note MCP Server，这些零散的思考被自动、标准地沉淀到 Edges 系统的 knowledge/notes/ 中，实现“对话即笔记，思考即资产”的自动化闭环。

核心指标

所有内容沉淀都应服务于以下指标，否则价值极低：

• 效率: 同类判断是否更快形成
• 时间: 相似问题是否更容易处理
• 评估: 判断是否可被复盘或证伪
• 落地: 是否真实影响行动与取舍
• 复利: 是否能在未来多次被调用并放大收益

---

1. 核心资产 (knowledge/)

这是系统的核心数据层，承载所有的认知材料。

目录流转

knowledge/notes → 加工 → knowledge/edges → 归档/删除
      ↓                        ↓
  3天未处理                形成可复用判断
  就删掉或归档               提高未来决策效率

收录标准

目录	存什么 (Yes)	作用
notes/	新信息、想法、线索、疑问	输入: 允许不确定性，作为未来 Edge 的原材料
edges/	稳定的、可复用的判断优势	资产: 提高成功概率，减少错误成本
archive/	已结算、失效或被替代的内容	历史: 保留痕迹，不干扰当前决策

⛔️ 拒收原则 (Not)

• 只在当下有用、不可复用的总结
• 无法进入判断链条的“聪明观点”
• 没有时间维度、无法被验证的结论

⚠️ 维护规则

1. notes → edges 不是搬运，是提炼。
2. edge 一旦形成，不回写历史；演化通过新增或替代体现。
3. 迁移到 archive 必须有明确原因。
4. 3天未处理的 notes 应定期归档或删除。

---

2. 基础设施 (bin/)

存放维护本仓库的原生脚本工具。

• new-note: 快速创建笔记的 CLI 工具。
• init-extensions: 初始化/同步外部扩展配置。

---

3. 外部连接 (extensions/)

extensions/ 目录是 Edges 系统对外的接口层，供外部 Agent 或系统接入。

• mcp-servers/: 标准化接口服务 (如 new-note server)，让 AI 能够直接操作知识库。
• skills/: 导出给外部 Agent 的思维链与操作规范。
• subagents/: 专用子代理配置。
• tools/: 独立调用工具。

接入初始化

外部 Agent 或协作者在首次接入时，执行：

# (推荐) 初始化本地开发环境并添加 bin/ 路径到系统 PATH
pnpm setup

# 或者仅执行扩展初始化
./bin/init-extensions

---

4. 工作区管理 (Workspace)

本项目采用 pnpm workspace 进行“服务端服务工作区”管理，实现环境隔离与统一调度。

核心操作

• 安装依赖: pnpm install (在根目录执行)
• 启动 MCP Server:
  • 启动 New Note: pnpm start:note-server
  • 开发模式: pnpm dev:note-server
• 通用的启动器: pnpm mcp:run <server-name> <command>
  • 示例: pnpm mcp:run new-note build

结构规范

• extensions/mcp-servers/*: 独立的 MCP 服务单元，各自拥有 package.json。
• bin/: 系统维护脚本，已整合进工作区路径。
• tsconfig.base.json: 共享的全局编译器配置。

---

最后更新: 2026-02-19