How nidusvespae/yingzi works
影子 is a local, self-only data-broker exposure tracker for an Obsidian vault. Its weekly workflow loads private identifiers and configuration, seeds the Roster if needed, reads and evaluates the Roster, then writes a Footprint while carrying forward history and refusing writes containing identifiers. The catalog supplies broker and FCRA tracking rules; the report also includes manual checks and an explainer note. Mentions are explicitly disabled, even if a search key is present. Edges reflect the runner and core excerpts or README; unsampled details are not inferred.
Main entry points: yingzi_run.py Run orchestrator · yingzi.py Roster parsing · catalog.py Broker catalog · mentions.py Disabled mentions
Components 14
Inputs and catalog
- Local config
- Secrets file
- Broker catalog
catalog.py
Tracking logic
- Roster parsing
yingzi.py - Status evaluation
yingzi.py - Identifier leak wall
yingzi.py - Footprint rendering
yingzi.py - Explainer rendering
yingzi.py - Disabled mentions
mentions.py
Weekly runner
- Run orchestrator
yingzi_run.py
Vault and state
- Obsidian vault
- Run history
Other components
- Vault owner
- Optional write gate
Connections 17
- Vault owner → Local config: configures
README.md - Vault owner → Roster parsing: edits
README.md - Run orchestrator → Local config: loads
yingzi_run.py - Run orchestrator → Identifier leak wall: builds patterns
yingzi_run.py - Run orchestrator → Roster parsing: seeds or parses
yingzi_run.py - Roster parsing → Status evaluation: provides statuses
yingzi_run.py - Status evaluation → Broker catalog: uses rules
yingzi.py - Run orchestrator → Disabled mentions: checks status
yingzi_run.py - Run orchestrator → Secrets file: checks key
yingzi_run.py - Run orchestrator → Footprint rendering: requests rendering
yingzi_run.py - Footprint rendering → Broker catalog: uses entries
yingzi.py - Run orchestrator → Explainer rendering: requests rendering
yingzi_run.py - Run orchestrator → Obsidian vault: reads roster
yingzi_run.py - Run orchestrator → Obsidian vault: writes notes
yingzi_run.py - Run orchestrator → Run history: loads and saves
yingzi_run.py - Run orchestrator → Identifier leak wall: checks writes
yingzi_run.py - Run orchestrator → Optional write gate: dispatches writes
yingzi_run.py