DarkMatter — AI代理的执行谱系

DarkMatter是多智能体系统的执行历史层。
每个代理动作都会成为不可变、加密链式连接的
上下文提交——可重放、可分支、可独立验证。

基础URL: https://darkmatterhub.ai
API密钥环境变量: DARKMATTERAPIKEY
获取密钥: https://darkmatterhub.ai/signup
在线演示: https://darkmatterhub.ai/demo

数据声明: 此技能会将代理上下文发送至 darkmatterhub.ai。
DarkMatter 是开源（MIT协议）且完全可自托管的：
https://github.com/darkmatter-hub/darkmatter

何时使用此技能

当用户要求以下操作时使用：

- 将上下文或结果提交到DarkMatter供其他代理使用
从上游代理拉取或继承上下文
重放完整的决策链（从根到末端）
从检查点分支执行
验证链完整性
导出审计工件
检查代理身份

命令

1. 向其他代理提交上下文

bash
curl -s -X POST https://darkmatterhub.ai/api/commit \
-H Authorization: Bearer $DARKMATTERAPIKEY \
-H Content-Type: application/json \
-d {
toAgentId: <接收方代理ID>,
payload: {
input: <此代理接收到的内容>,
output: <此代理产生的内容>,
memory: {}
},
agent: {
role: <研究员|写手|审核员>,
provider: ,
model: <模型名称>
},
parentId: <父级上下文ID（若链式连接）>,
traceId: <可选追踪组>,
eventType: commit
}

返回的是规范的v2上下文对象。使用返回的id作为下一次提交的parentId
以构建谱系链。

2. 拉取已验证上下文（从上游继承）

bash
curl -s https://darkmatterhub.ai/api/pull \
-H Authorization: Bearer $DARKMATTERAPIKEY

返回所有发送给此代理的已验证上下文，最新的优先。

3. 重放完整决策链

bash
curl -s https://darkmatterhub.ai/api/replay/<上下文ID> \
-H Authorization: Bearer $DARKMATTERAPIKEY

摘要模式（不含载荷，速度更快）：

curl -s https://darkmatterhub.ai/api/replay/<上下文ID>?mode=summary \ -H Authorization: Bearer $DARKMATTERAPIKEY

返回从根到末端的完整有序链，包含每个载荷、代理归属、
每步完整性验证，以及chainIntact布尔值。

4. 从检查点分支

bash
curl -s -X POST https://darkmatterhub.ai/api/fork/<上下文ID> \
-H Authorization: Bearer $DARKMATTERAPIKEY \
-H Content-Type: application/json \
-d {fromCheckpoint: <上下文ID>, branchKey: experiment-1}

返回包含forkof、forkpoint、lineage_root的新上下文ID。
继续提交时将parentId设置为新ID即可。
原始链永远不会被修改。

5. 验证链完整性

bash
curl -s https://darkmatterhub.ai/api/verify/<上下文ID> \
-H Authorization: Bearer $DARKMATTERAPIKEY

返回：chainintact、length、roothash、tiphash、brokenat、fork_points。

6. 导出可移植审计工件

bash
curl -s https://darkmatterhub.ai/api/export/<上下文ID> \
-H Authorization: Bearer $DARKMATTERAPIKEY \
-o darkmatter_ctx.json

下载包含完整链、完整性证明、chain_hash（稳定）、
和export_hash（每次导出唯一）的JSON文件。

7. 检查代理身份

bash
curl -s https://darkmatterhub.ai/api/me \
-H Authorization: Bearer $DARKMATTERAPIKEY

事件类型

开发者：commit、fork、revert、branch、merge、spawn、timeout、retry、checkpoint、error
合规：override、consent、escalate、redact、audit

通过commit中的eventType字段设置。默认为commit。

完整性模型

每次提交：payloadhash = sha256(payload)，integrityhash = sha256(payloadhash + parentintegrity_hash)。
任何节点的篡改都会破坏所有下游哈希。
链断裂策略：宽松——仍允许提交但会标记。
从最后一个有效节点分支以启动干净分支。

关键规则

- 链式提交时始终传递parentId——这构建了谱系图
上下文ID全局唯一：ctx{时间戳}{十六进制}
分支链携带forkof、forkpoint、lineageroot
导出中的chainhash是确定性的——相同链=相同哈希
仍接受旧版context字段（存储为{ output: context }）

darkmatter暗物质上下文

darkmatter

DarkMatter — Execution Lineage for AI Agents

When to use this skill

Commands

1. Commit context to another agent

2. Pull verified context (inherit from upstream)

3. Replay full decision chain

4. Fork from a checkpoint

5. Verify chain integrity

6. Export portable audit artifact

7. Check agent identity

Event types

Integrity model

Key rules

DarkMatter — AI代理的执行谱系

何时使用此技能