liudao-heritage
v1.0.0Search, enrich, and manage family heritage and historical relationship data from the LiùDào (六道) SQLite database. Use this skill when answering questions about historical figures, calculating relationship paths (A的B), or adding new personal records with privacy controls.
Installation
六道 (LiùDào) Heritage Manager
This skill provides access to the LiùDào family heritage and relationship database. It allows you to query historical figures, analyze relationship networks, and manage personal data with strict privacy controls.
Core Capabilities
- Search Database: Look up people by name, including their basic info, relationships, and milestones.
- Relationship Engine: Resolve complex queries like "A的B" (e.g., "康熙的父亲").
- Data Enrichment: Safely upsert new records or append milestones (history today) to existing ones.
Environment Details
- Database Path:
/home/admin/.openclaw/workspace/liudao-bot/data/liudao.db - Core Scripts: Located in
/home/admin/.openclaw/workspace/liudao-bot/ - User Privacy: For private entries (e.g., family members), ensure you pass the correct
viewer_id(e.g.,1234567890for the specific authorized user).
Workflows
1. Searching for a Person
When a user asks about a specific historical figure or family member:
- Run the python search script passing the name and the user's ID for privacy.
- Example: python3 scripts/search_person.py "康熙" --viewer_id "5104087055"
2. Resolving Relationships ("A的B")
When a user asks relationship questions (e.g., "朱元璋的长子是谁?"):
- Use the relation engine script.
- Example: python3 scripts/resolve_relation.py "朱元璋" "长子"
3. Adding/Editing Data
For inserting a new person or adding milestones:
- Write a quick python script using db_manager.py's upsert_person method.
- Ensure is_private=1 and creator_id are set when adding personal family data.
Important Notes
- Always parse the
relations_jsonandmilestones_jsoncarefully; they contain structured relationship links and life events. - See
references/db_schema.mdfor exact table structures.