pi-memory-strata 0.1.0

package/scripts/memory_distill_check.py

@@ -0,0 +1,281 @@
+#!/usr/bin/env python3
+"""
+memory_distill_check.py - Memory Strata 蒸馏检查工具
+
+检查四层记忆系统的状态，提示需要蒸馏的内容。
+适用于任何使用 memory-strata 架构的项目。
+
+用法：
+  python memory_distill_check.py                           # 自动扫描所有项目
+  python memory_distill_check.py --project MyProject       # 检查指定项目
+
+功能：
+1. 扫描每日日志，检查近7天覆盖情况
+2. 检查各项目开发状态的新鲜度
+3. 检查各项目核心档案的新鲜度
+4. 检查 MEMORY.md 的 last_used 标记，提示衰减
+5. 检查记忆锚点完整性
+"""
+
+import os
+import re
+import glob
+import sys
+import argparse
+from datetime import datetime, timedelta
+from pathlib import Path
+
+# Windows UTF-8 输出
+if sys.platform == "win32":
+    sys.stdout.reconfigure(encoding="utf-8")
+
+
+def find_vault():
+    """自动发现 Obsidian vault 路径"""
+    # 1. 环境变量
+    env = os.environ.get("OBSIDIAN_VAULT_PATH", "").strip()
+    if env and os.path.isdir(env):
+        return env
+    # 2. 常见位置
+    home = Path.home()
+    candidates = [
+        home / "dumatework" / "dumate-memory-vault",
+        home / "ObsidianVault",
+        home / "vault",
+    ]
+    for c in candidates:
+        if c.is_dir():
+            return str(c)
+    return None
+
+
+def discover_projects(vault):
+    """自动发现 vault 中的项目"""
+    projects_dir = os.path.join(vault, "20-projects")
+    if not os.path.isdir(projects_dir):
+        return []
+    projects = []
+    for name in os.listdir(projects_dir):
+        pdir = os.path.join(projects_dir, name)
+        if os.path.isdir(pdir):
+            status = os.path.join(pdir, "开发状态.md")
+            core = os.path.join(pdir, "项目核心档案.md")
+            if os.path.exists(status) or os.path.exists(core):
+                projects.append(name)
+    return projects
+
+
+def check_journal_recency(vault):
+    """检查最近日志的覆盖情况"""
+    print("\n" + "=" * 60)
+    print("[1] 日志覆盖检查 (L4)")
+    print("=" * 60)
+
+    journal_dir = os.path.join(vault, "10-journal")
+    if not os.path.isdir(journal_dir):
+        print("  ! 10-journal 目录不存在，跳过")
+        return
+
+    today = datetime.now()
+    lines = []
+    for i in range(7):
+        d = today - timedelta(days=i)
+        fname = os.path.join(journal_dir, f"{d.strftime('%Y-%m-%d')}.md")
+        if os.path.exists(fname):
+            size = os.path.getsize(fname)
+            lines.append(f"  {d.strftime('%Y-%m-%d')} OK ({size} bytes)")
+        else:
+            lines.append(f"  {d.strftime('%Y-%m-%d')} MISSING")
+
+    for line in lines:
+        print(line)
+
+    missing = sum(1 for l in lines if "MISSING" in l)
+    if missing > 3:
+        print(f"\n  ! 近7天有{missing}天无日志，可能有信息未记录")
+
+
+def check_project(vault, project_name):
+    """检查单个项目的记忆状态"""
+    pdir = os.path.join(vault, "20-projects", project_name)
+    status_file = os.path.join(pdir, "开发状态.md")
+    core_file = os.path.join(pdir, "项目核心档案.md")
+
+    print(f"\n{'=' * 60}")
+    print(f"  项目: {project_name}")
+    print(f"{'=' * 60}")
+
+    # 开发状态新鲜度 (L3)
+    if os.path.exists(status_file):
+        with open(status_file, "r", encoding="utf-8") as f:
+            content = f.read()
+        m = re.search(r"updated:\s*(\d{4}-\d{2}-\d{2})", content)
+        if m:
+            updated = datetime.strptime(m.group(1), "%Y-%m-%d")
+            days_ago = (datetime.now() - updated).days
+            icon = "OK" if days_ago <= 7 else "STALE"
+            print(f"  [L3] 开发状态: updated {m.group(1)} ({days_ago}d ago) {icon}")
+            if days_ago > 7:
+                print(f"       -> 建议回顾近{days_ago}天的会话，更新开发状态")
+        else:
+            print(f"  [L3] 开发状态: 缺少 updated 日期")
+    else:
+        print(f"  [L3] 开发状态: 不存在")
+
+    # 核心档案新鲜度 (L2)
+    if os.path.exists(core_file):
+        with open(core_file, "r", encoding="utf-8") as f:
+            content = f.read()
+        m = re.search(r"updated:\s*(\d{4}-\d{2}-\d{2})", content)
+        if m:
+            updated = datetime.strptime(m.group(1), "%Y-%m-%d")
+            days_ago = (datetime.now() - updated).days
+            icon = "OK" if days_ago <= 30 else "STALE"
+            print(f"  [L2] 核心档案: updated {m.group(1)} ({days_ago}d ago) {icon}")
+            if days_ago > 30:
+                print(f"       -> 检查开发状态中是否有稳定信息需要提升")
+        else:
+            print(f"  [L2] 核心档案: 缺少 updated 日期")
+    else:
+        print(f"  [L2] 核心档案: 不存在")
+
+    # 检查双向链接
+    if os.path.exists(status_file) and os.path.exists(core_file):
+        with open(status_file, "r", encoding="utf-8") as f:
+            s = f.read()
+        with open(core_file, "r", encoding="utf-8") as f:
+            c = f.read()
+        status_links_core = "[[项目核心档案" in s or "[[核心档案" in s
+        core_links_status = "[[开发状态" in c
+        if status_links_core and core_links_status:
+            print(f"  [LINK] L2 <-> L3 双向链接: OK")
+        else:
+            missing_links = []
+            if not status_links_core:
+                missing_links.append("L3->L2")
+            if not core_links_status:
+                missing_links.append("L2->L3")
+            print(f"  [LINK] 双向链接不完整: 缺 {', '.join(missing_links)}")
+
+
+def check_memory_last_used(vault):
+    """检查 MEMORY.md 中记忆的 last_used 标记 (L1)"""
+    print("\n" + "=" * 60)
+    print("[L1] 记忆强度衰减检查 (last_used)")
+    print("=" * 60)
+
+    memory_file = os.path.join(vault, "00-brain", "MEMORY.md")
+    if not os.path.exists(memory_file):
+        print("  ! MEMORY.md 不存在")
+        return
+
+    with open(memory_file, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    tagged = re.findall(
+        r"- \*\*(.+?)\*\*.*?\[last_used:\s*(\d{4}-\d{2}-\d{2})\]", content
+    )
+
+    if not tagged:
+        print(
+            "  (no last_used tags found - add [last_used: YYYY-MM-DD] to your MEMORY.md entries)"
+        )
+        return
+
+    today = datetime.now()
+    stale = 0
+    for label, date_str in tagged:
+        last = datetime.strptime(date_str, "%Y-%m-%d")
+        days_ago = (today - last).days
+        if days_ago > 30:
+            print(
+                f"  !! [{label}] last_used: {date_str} ({days_ago}d ago) -> consider archiving"
+            )
+            stale += 1
+        elif days_ago > 14:
+            print(
+                f"  !  [{label}] last_used: {date_str} ({days_ago}d ago) -> rarely used"
+            )
+        else:
+            print(f"  OK [{label}] last_used: {date_str} ({days_ago}d ago)")
+
+    if stale > 0:
+        print(f"\n  {stale} entries >30d unused, consider downgrading to L3/L4")
+
+
+def check_anchors(vault):
+    """检查记忆锚点是否完整 (L1)"""
+    print("\n" + "=" * 60)
+    print("[L1] 记忆锚点检查")
+    print("=" * 60)
+
+    memory_file = os.path.join(vault, "00-brain", "MEMORY.md")
+    if not os.path.exists(memory_file):
+        print("  ! MEMORY.md 不存在")
+        return
+
+    with open(memory_file, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    # 查找"经验教训"或"锚点"部分中的条目
+    anchor_section = re.search(r"## 经验教训(.*?)(?=##|$)", content, re.DOTALL)
+    if anchor_section:
+        anchors = re.findall(r"-\s+\*\*(.+?)\*\*", anchor_section.group(1))
+        if anchors:
+            print(f"  Found {len(anchors)} anchor(s) in MEMORY.md:")
+            for a in anchors:
+                print(f"    - {a}")
+        else:
+            print("  ! '经验教训' section exists but has no anchors")
+    else:
+        print("  ! No '经验教训' section found in MEMORY.md")
+        print("    -> Add a '## 经验教训' section with memory anchors")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Memory Strata - Distillation Check")
+    parser.add_argument("--project", help="Check a specific project")
+    parser.add_argument("--vault", help="Path to Obsidian vault")
+    args = parser.parse_args()
+
+    vault = args.vault or find_vault()
+    if not vault:
+        print(
+            "ERROR: Cannot find Obsidian vault. Set OBSIDIAN_VAULT_PATH or use --vault"
+        )
+        sys.exit(1)
+
+    print(f"\nMemory Strata - Distillation Check")
+    print(f"  Vault: {vault}")
+    print(f"  Date:  {datetime.now().strftime('%Y-%m-%d %H:%M')}")
+
+    # L4 日志覆盖
+    check_journal_recency(vault)
+
+    # 项目状态
+    if args.project:
+        projects = [args.project]
+    else:
+        projects = discover_projects(vault)
+
+    if projects:
+        for p in projects:
+            check_project(vault, p)
+    else:
+        print("\n  (No projects found in 20-projects/)")
+
+    # L1 衰减检查
+    check_memory_last_used(vault)
+
+    # L1 锚点检查
+    check_anchors(vault)
+
+    print("\n" + "=" * 60)
+    print(
+        "Check complete. Follow the suggestions above to maintain your memory system."
+    )
+    print("=" * 60)
+
+
+if __name__ == "__main__":
+    main()

package/templates/01-status.md

@@ -0,0 +1,45 @@
+# Project: {{PROJECT_NAME}} — Development Status
+
+> Last updated: {{YYYY-MM-DD}}
+> Type: L3 (Dev Status)
+
+---
+
+## Current Phase
+
+| Phase | Status | Since |
+|-------|--------|-------|
+| {{Phase Name}} | {{in progress / completed / blocked}} | {{YYYY-MM-DD}} |
+
+## Progress This Session
+
+- [x] {{Completed task}}
+- [x] {{Completed task}}
+- [ ] {{Pending task}}
+
+## Known Issues
+
+| Priority | Issue | Impact | Resolution |
+|----------|-------|--------|------------|
+| P0 | {{Critical issue}} | {{blocks release}} | {{status}} |
+| P1 | {{Important issue}} | {{workaround available}} | {{status}} |
+
+## Decisions & Context
+
+- **{{Decision title}}**: {{Decision content}} — decided on {{YYYY-MM-DD}}
+- **{{Technical choice}}**: {{Why this choice}} — confirmed
+
+## Next Actions
+
+1. {{Next step 1}}
+2. {{Next step 2}}
+3. {{Next step 3}}
+
+---
+
+## Bidirectional Links
+
+- [[{{Project Core Archive}}]] ← stable facts about this project
+
+---
+*Auto-maintained by [pi-memory-strata](https://github.com/bailianfa/pi-memory-strata)*

package/templates/02-core.md

@@ -0,0 +1,62 @@
+# {{PROJECT_NAME}} — Project Core Archive
+
+> Last updated: {{YYYY-MM-DD}}
+> Type: L2 (Project Core)
+
+---
+
+## Hardware Selections
+
+| Component | Model | Status | Rationale |
+|-----------|-------|--------|-----------|
+| **CPU/SoC** | {{model}} | {{selected / testing}} | {{reason}} |
+| **WiFi/BT** | {{model}} | {{selected / testing}} | {{SRRC certified, avoid re-research}} |
+| **Camera IR** | {{model}} | {{selected / testing}} | {{global shutter for eye tracking}} |
+| **Camera RGB** | {{model}} | {{selected / testing}} | {{4K for fundus imaging}} |
+| **Display** | {{model}} | {{selected / testing}} | {{resolution, interface}} |
+| **Touch** | {{model}} | {{selected / testing}} | {{capacitive/resistive}} |
+
+## Architecture Decision Records (ADR)
+
+### ADR-001: {{Decision Title}}
+- **Context**: {{Why this decision was needed}}
+- **Decision**: {{What was chosen}}
+- **Consequences**: {{Trade-offs and implications}}
+- **Date**: {{YYYY-MM-DD}}
+
+### ADR-002: {{Decision Title}}
+- **Context**: {{Why this decision was needed}}
+- **Decision**: {{What was chosen}}
+- **Consequences**: {{Trade-offs and implications}}
+- **Date**: {{YYYY-MM-DD}}
+
+## Memory Anchors
+
+> These are facts that are easy to forget but costly to lose. Do NOT re-research these.
+
+- **{{Anchor title}}**: {{Anchor content}} — [last_used: {{YYYY-MM-DD}}]
+- **{{Anchor title}}**: {{Anchor content}} — [last_used: {{YYYY-MM-DD}}]
+
+## Build & Deployment
+
+| Environment | Details |
+|-------------|---------|
+| **Build** | {{Build method, e.g., WSL2 Ubuntu 22.04}} |
+| **Compiler** | {{aarch64-buildroot-linux-gnu-gcc}} |
+| **Deployment** | {{scp/rsync method}} |
+| **Remote** | {{user@host}} |
+
+## External References
+
+- **Hardware Docs**: {{Link to datasheets}}
+- **SDK Docs**: {{Link to SDK documentation}}
+- **Vendor Contact**: {{Vendor name, contact}}
+
+---
+
+## Bidirectional Links
+
+- [[{{Dev Status}}]] ← current development progress and recent decisions
+
+---
+*Auto-maintained by [pi-memory-strata](https://github.com/bailianfa/pi-memory-strata)*

package/templates/MEMORY_/351/224/232/347/202/271/347/211/207/346/256/265.md

@@ -0,0 +1,13 @@
+## 经验教训（记忆锚点示例）
+
+<!-- 将以下格式的锚点添加到 MEMORY.md 的"经验教训"部分 -->
+<!-- 每条锚点 = 易遗忘事实 + 遗忘后果 -->
+
+- **[事实摘要]**：[详细说明]——[后果提示，如"不可遗忘"/"不要重新研究"]
+- **[事实摘要]**：[详细说明]——[后果提示]
+
+<!-- 示例：
+- **横屏是产品默认**：开发板默认竖屏，但产品横屏使用——这是项目的基本事实，不可遗忘
+- **AP6256已选型**：SRRC已认证，是RK3568生态主流选择——不要重新研究这个问题
+- **只用增量build.sh**：禁止--full全量编译——全量编译会失败浪费时间
+-->

package/templates//345/274/200/345/217/221/347/212/266/346/200/201_/346/250/241/346/235/277.md

@@ -0,0 +1,45 @@
+---
+title: <项目名称>开发状态
+type: project-status
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+permalink: dumate/20-projects/<项目slug>/status
+---
+
+# <项目名称>开发状态
+
+> 本文档跟踪当前开发进展、活跃问题和近期上下文。
+> 每次重要进展后更新。超过 1 个月无变化的内容应沉淀到 [[项目核心档案]]。
+> 记忆维护规范见 [[记忆维护规范]]，蒸馏规则见 [[记忆蒸馏规则]]。
+
+## 当前阶段：<阶段描述>
+
+### 已完成
+
+- [ ] <!-- 功能描述（日期）→ 见 [[项目核心档案#对应章节]] -->
+
+### 进行中
+
+- [ ]
+
+### 待做（近期）
+
+- [ ]
+
+## 当前关键参数
+
+<!-- 经过验证的参数值，如屏幕尺寸、校准参数、UI 布局数值等 -->
+
+## 操作方案
+
+<!-- 日常操作流程，如部署、截屏、调试等 -->
+
+## 板子/环境当前配置
+
+- **IP**：
+- **程序路径**：
+- **日志路径**：
+
+## 已知问题
+
+-

package/templates//350/256/260/345/277/206/345/256/236/350/267/265/346/227/245/345/277/227_/346/250/241/346/235/277.md

@@ -0,0 +1,44 @@
+---
+title: 记忆实践日志
+type: experiment-log
+created: YYYY-MM-DD
+permalink: dumate/20-projects/<项目slug>/memory-log
+---
+
+# 记忆实践日志
+
+> 记录记忆系统的使用效果、失效事件和改进实践。
+> 如果后续要发表论文，这些数据是实证基础。
+
+## 评估指标定义
+
+| 指标 | 定义 | 记录方式 |
+|------|------|----------|
+| 召回成功率 | 会话启动时关键事实正确回忆的比例 | 每次会话自评 |
+| 失效事件 | 遗忘/误忆/重复研究已解决问题 | 发生时记录 |
+| 维护成本 | 每次会话花在记忆维护上的时间 | 估算分钟数 |
+| 锚点命中率 | 记忆锚点被实际使用的比例 | 蒸馏检查脚本 |
+
+---
+
+## 记录模板
+
+```
+### YYYY-MM-DD：[会话主题]
+
+**记忆召回情况**：[成功/部分/失败] — [具体说明]
+
+**失效事件**（如有）：
+| 时间 | 类型 | 内容 | 后果 | 改进措施 |
+|------|------|------|------|----------|
+
+**蒸馏操作**（如有）：
+- [源文件] → [目标文件]：[蒸馏内容]
+
+**last_used 更新**（如有）：
+- [记忆条目]：[旧日期] → [新日期]
+
+**维护成本**：约 [N] 分钟
+
+**锚点命中**：[哪些锚点被实际使用]
+```

package/templates//351/241/271/347/233/256/346/240/270/345/277/203/346/241/243/346/241/210_/346/250/241/346/235/277.md

@@ -0,0 +1,71 @@
+---
+title: <项目名称>项目核心档案
+type: project-core
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+permalink: dumate/20-projects/<项目slug>/core
+---
+
+# <项目名称>项目核心档案
+
+> 本文档是项目的"事实锚点"，只放**确定且稳定**的关键信息。
+> 变更时更新 updated 日期。不确定的信息不放这里。
+> 当前进展见 [[开发状态]]，记忆维护见 [[记忆维护规范]]。
+
+## 产品定位
+
+- **产品名称**：
+- **所属公司**：
+- **核心功能**：
+- **目标用户**：
+
+## 硬件平台
+
+### 主板
+
+- **开发板**：
+- **SoC**：
+- **内存**：
+- **存储**：
+
+### 显示与输入
+
+- **屏幕**：
+- **触摸**：
+- **其他输入**：
+
+### 系统
+
+- **内核**：
+- **文件系统**：
+- **图形栈**：
+
+### 关键外设
+
+<!-- 摄像头、无线模组、传感器等 -->
+
+## 软件架构
+
+- **UI 框架**：
+- **项目路径**：
+- **关键源码**：
+
+## 编译部署
+
+- **编译环境**：
+- **编译命令**：
+- **部署方式**：
+
+## 协作模式
+
+<!-- 描述各角色分工 -->
+
+## 重要决策记录（ADR）
+
+| 日期 | 决策 | 原因 |
+|------|------|------|
+| | | |
+
+## 资料路径
+
+<!-- 项目文档、SDK、参考资料等 -->