Skip to content

Releases: ttzc/relationship-graph

v1.2

Choose a tag to compare

@ttzc ttzc released this 31 Aug 13:24

变更内容

v1.2 在联系人 + 三层标签之外新增第三种实体:名单(roster)——记录公共群体名单(班级、竞赛队……),一份一个文件放 rosters/。

核心设计

  • 成员表格 | 姓名 | 角色 | 状态 |,双链有无即状态标记:
    • 已登记:姓名列 [[双链]] 直达 contacts/ 档案
    • 仅名单:纯文本名字 + 角色,不建文件
  • 升级路径:仅名单成员熟络后走录入流程建档,名单行改 [[名]]
  • 参与 AI 联想:名单有「触发场景」,话题命中时浮现整份名单(已登记成员优先)
  • 两类卫生约束:名单不进三层标签;联系人文件不记所在名单(避免双写)

文件改动(+341/−30,7 文件)

  • assets/roster-template.md(新)— 触发场景 + 成员表格模板
  • scripts/audit_graph.py — 扫描 rosters/、解析成员表;双链必须指向联系人;状态与链接一致性;仅名单成员有档案 → 提示升级;报告加名单统计
  • assets/INDEX-template.md — 新增「名单」导航区
  • SKILL.md — 数据模型 + 工作流 3(名单管理,补上空缺编号)+ AI 联想扩展 + 审计清单
  • CLAUDE.md / README.md / onboarding-example.md — 结构树、工作流、审计清单镜像更新

验证

测试 vault(venv/pyyaml)+ --report / --json:

  • ✅ 仅名单成员零误报,统计 已登记 1 + 仅名单 2
  • ✅ 断链、状态矛盾(已登记无双链 / 仅名单带双链)、升级提示全部生效

v1.1

Choose a tag to compare

@ttzc ttzc released this 31 Aug 13:11

变更内容

v1.1 是基于 code review 反馈的一次全面修订(PR #1,8 个文件,+482/−405)。

1. 全库中文化

  • SKILL.md、CLAUDE.md、README.md、INDEX/contact 模板全部翻译为中文
  • 刻意保留英文:YAML 字段名与强度枚举(close/acquaintance/…),保证脚本兼容

2. 联系人 schema 收敛(最大结构变化)

  • YAML 块从 Obsidian frontmatter 移到正文 ```yaml 围栏,只保留 7 个键
  • help_areas / trigger_tags / notes 不再是 YAML 字段,唯一归属四个中文正文小节(可帮事项/触发标签/历史互动/备注)

3. audit_graph.py 增强

  • 新增 parse_yaml_blocks() 支持正文围栏块中的 trigger_tags
  • os.path.expanduser 支持 ~/people 路径
  • stdout 强制 UTF-8,修复 Windows cp936 下 emoji 崩溃
  • 断链占位符白名单扩充

4. 修复 code review 发现

  • 移除模板注释里的真实标签双链(幽灵边)
  • 修复 CJK 引号导致的非法 YAML
  • 解决 2d vs 2c 标签创建规则矛盾
  • 找回 identity-change 维护行、INDEX 列名同步

5. 其他

  • 私有路径 D:/people → ~/people 占位
  • 实践经验(chat-log 批量录入、audit 环境提示)并入 SKILL.md
  • 新增 .gitignore 忽略 .claude/

v1.0

Choose a tag to compare

@ttzc ttzc released this 31 Aug 12:08

首个正式版本:人际关系图谱 Claude Code Skill

  • 三层原子标签体系(学校 / 领域 / 城市)
  • 联系人模板与 INDEX 索引
  • 图谱审计脚本 audit_graph.py
  • 触发式联想匹配工作流