tdir-entities
查询 TDIR 已存的 IP、域名、URL、Hash 等实体画像、平台内实体 ↔ 洞察 ↔ 终端关联、威胁情报运营态势汇总(entities summary),并在用户明确确认后写回实体人工研判结论(entities verdict update);独立的 BTI 实时情报请求使用 tdir-investigation-enrichment,不负责威胁检测、因果证明或终端失陷判定。
How do I install this agent skill?
npx skills add https://tdir-1258344699.cos.ap-guangzhou.myqcloud.com --skill tdir-entitiesIs this agent skill safe to install?
No partner audit is available yet. Read the source before installing.
What does this agent skill do?
TDIR 实体分析与情报运营
本能力读取与治理 TDIR 平台已存实体数据(ti_entity、ti_entity_review、ti_entity_investigation_detail),不触发 BTI 实时查询;用户直接查外部 BTI 实时情报时使用 ../tdir-investigation-enrichment/SKILL.md。实体是 IP、域名、URL、文件哈希等可观测对象,本身不代表恶意;即使情报或深度调查判定某个实体为恶意,那也只是该实体的一个属性。
执行时遵守 ../tdir-shared/SKILL.md 的认证、输出、写操作和安全契约。
采用 direct-first:默认直接使用 tdir entities,并先读取目标叶子命令帮助。
tdir entities get <entity>→get_entity:点查单个实体画像(类型、关联洞察数与终端数、风险分布、TICS 情报结论与标签、深度调查结论)。tdir entities list→list_entities:按值、类型、时间、关联洞察数(--min-insights)与终端数(--min-machines,如--min-machines 100筛选高影响面实体)分页列出实体。tdir entities summary [--last 7d | --start ... --end ...](或tdir entities list --summary):威胁情报运营态势一键汇总,一次输出:- 周期新增 IOC 分布(
new_entities:按entity_type与tics_attribute拆分); - 高影响面实体分布(
high_impact_entities:machine_count >= 100,排除 URL 与生效黑名单ti_entity_blacklist.enabled = 1),含total、malicious(black)、suspicious、safe(white)、unknown、no_entity(not_found)、文件无实体数(file_no_entity_count)与待分析高影响面未知实体数(pending_analysis_count:tics_attribute IN ('unknown','info') AND review_ti_result IS NULL AND operation_value_score >= 6); - 漏报误报冲突情报治理(
conflict_governance:统计ti_entity_investigation_detail中 Agent 确认llm_verdict='confirmed'的疑似漏报direction='fn'与疑似误报direction='fp'的总数total、已运营数operated、人工确认数confirmed)。
- 周期新增 IOC 分布(
tdir entities links list --entity <value>→get_entity_insights:涉及该实体的洞察与终端,用于评估影响范围。tdir entities links list --insight-uuid <uuid>或tdir insights entities <uuid>→get_insight_entities:一条洞察关联的实体。tdir entities verdict update <entity> --verdict <black|white|gray|suspicious|unknown> [--comment <text>] [--dry-run] [--yes]→update_entity_verdict(写命令):写回威胁实体的人工研判结论(ti_entity_review)。必须先以--dry-run预览变更前后结论并向用户展示,取得用户在当前对话明确确认后才加--yes正式写入;写入后用tdir entities get <entity>回查。
需要实时情报、上下文、历史解析或样本功能补证时,按实际疑点选择 tdir intel 或已明确授权的 tdir samples download,按 ../tdir-investigation-enrichment/SKILL.md 选择动作。已有画像与实时结果分别标明来源和时间。
machine_count 表示与实体有关联的终端数量;实体 ↔ 洞察 ↔ 终端关联仅作为调查线索,关联存在不证明因果,也不能据此直接确认真实事件或判定终端失陷。核对关联洞察与终端的失陷状态时,有效失陷包含人工确认失陷与未经人工排除的 L1 定性失陷(含独立定性 / 聚类传播),经人工排除则剔除(终端表 machine.compromise_status=1 由 L1 定性失陷驱动标记,人工复核结果不联动修改终端表状态)。URL、域名仅作为查询值,禁止主动访问。
References
- get/list/summary/verdict 参数、核心字段、工具与输出:
references/entity-lookup.md - links 两个方向、关联语义与跨域核验:
references/entity-links.md
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tdir-1258344699.cos.ap-guangzhou.myqcloud.com/tdir-entities">View tdir-entities on skillZs</a>