safal207/Liminal-Presence-Interface-LPI

# LPI - Liminal Presence Interface [](https://github.com/safal207/Liminal-Presence-Interface-LPI/actions/workflows/ci.yml) [](https://opensource.org/licenses/MIT) [](https://github.com/safal207/Liminal-Presence-Interface-LPI) [](https://github.com/safal207/Liminal-Presence-Interface-LPI) **快速验证路径（可进行审查）：** ``` python scripts/validate_project.py node --test tests/vocab.artifacts.test.mjs ``` ## 审查链接 - 资助证明：`docs/GRANT_EVIDENCE.md` - 架构与规范：`docs/specs/` - 安全模型：`docs/security/THREAT-MODEL.md` - 安全框架：`docs/safety/agentic_presence_threat_model.md` - 验证快照：`VALIDATION_RESULTS.md` - 安全策略：`SECURITY.md` - 贡献流程：`CONTRIBUTING.md` LPI 是一种 Layer 8 协议，用于使用结构化的 intent、affect、consent、trust 和 memory 元数据来封装应用消息。具体而言，它为 agentic 系统和人机交互（human-AI）应用提供了一个便携的信封，用于说明不仅发送了什么，还说明了为什么发送、在什么 consent 下发送、附带什么 trust 材料以及具有什么样的 session 连续性。 ## 为什么这很重要 仅限输出的接口隐藏了重要的控制信号。一条消息可能在语法上是有效的，但仍然可能是不安全的、定义不明确的或脱离用户 intent 的。 LPI 通过使通信状态显式化来弥补这一差距： - `intent` 捕获消息试图执行的操作 - `affect` 和 `meaning` 保留语义上下文 - `policy` 携带 consent 和共享预期 - `trust` 附加加密验证材料 - `memory` 和 `LSS` 保留线程连续性和漂移指标 这使得 LPI 适用于： - agentic 监督 - 感知 consent 的人机交互接口 - 安全的消息签名与验证 - session 一致性监控 - 跨传输的结构化握手 ## 仓库内容 这个 monorepo 目前包含： - `packages/node-lri` - Node.js SDK 和中间件 - `packages/python-lri` - Python SDK、FastAPI 集成、验证器和 LSS 支持 - `packages/lpictl` 和 `packages/lrictl` - CLI 工具 - `docs/specs` - LHS、LTP、LSS 和传输规范 - `docs/security/THREAT-MODEL.md` - STRIDE 风格的安全审查 - `vocab/` 和 `schemas/` - 规范的协议词汇表和 schema 工件 - `examples/` - Express、FastAPI、WebSocket 和签名示例 ## 安全与监督框架 LPI 可作为更广泛的安全堆栈中的通信和接口层发挥作用。 它特别适用于系统需要验证以下情况的场景： - 消息是否携带了正确的 consent 状态 - 已签名的上下文信封是否被篡改或重放 - session 是否在多轮对话中出现语义漂移 - 传输握手是否正确保留了上下文 - trust、context 和路由元数据是否在跨边界时保持附加状态 有关面向安全的简明摘要，请参阅 [docs/safety/agentic_presence_threat_model.md](docs/safety/agentic_presence_threat_model.md)。 ## 验证状态 该仓库现在在根目录下包含了验证快照，位于 [VALIDATION_RESULTS.md](VALIDATION_RESULTS.md)。 当前的可重现验证路径涵盖： - 词汇工件生成与验证 - 用于解析、验证和 LSS 行为的 Python SDK 核心测试 使用以下命令在本地运行： ``` python scripts/validate_project.py python scripts/generate_validation_results.py ``` ## 快速开始 ### Node.js ``` npm install node-lri express ``` ``` import express from 'express'; import { lriMiddleware } from 'node-lri'; const app = express(); app.use(lriMiddleware()); app.get('/api/data', (req: any, res) => { const lce = req.lri?.lce; res.json({ message: 'Hello from LPI', intent: lce?.intent.type ?? null, }); }); app.listen(3000); ``` ### Python ``` pip install python-lri fastapi ``` ``` from fastapi import FastAPI, Request from lri import LRI app = FastAPI() lri = LRI() @app.get('/api/data') async def get_data(request: Request): lce = await lri.parse_request(request, required=False) return { 'message': 'Hello from LPI', 'intent': lce.intent.type if lce else None, } ``` ## 协议构建块 ### LCE Liminal Context Envelope 是携带语义上下文的结构化 payload。 ### LHS Liminal Handshake Sequence 定义了建立上下文的传输握手。 #### 协议版本控制（WebSocket 握手） 此 SDK 使用 `lpiVersion` 作为在 LHS 握手期间宣告协议版本的规范选项。 - **规范选项：** `lpiVersion` - **旧版别名（已弃用）：** `lriVersion` - **网络传输兼容性：** 握手字段保持为 `lri_version` 版本解析是集中处理的，遵循以下顺序： `lpiVersion` → `lriVersion` → 默认值 (`0.1`) ### LTP Liminal Trust Protocol 使用分离的 Ed25519 签名对信封进行签名。 ### LSS Liminal Session Store 跟踪线程级别的连续性、一致性和漂移。 ## 关键文档 - [入门指南](docs/getting-started.md) - [RFC-000 概述](docs/rfcs/rfc-000.md) - [LHS 规范](docs/specs/lhs.md) - [LTP 规范](docs/specs/ltp.md) - [LSS 规范](docs/specs/lss.md) - [传输说明](docs/specs/transports.md) - [安全威胁模型](docs/security/THREAT-MODEL.md) - [Agentic Presence 威胁模型](docs/safety/agentic_presence_threat_model.md) - [验证快照](VALIDATION_RESULTS.md) ## 开发说明 完整的工作区测试矩阵仍然依赖于完整的 Node 工作区设置。为了获得稳定的审查路径，请首先使用根验证脚本，然后再深入研究各个包。 ``` node --test tests/vocab.artifacts.test.mjs cd packages/python-lri python -m pytest -q tests/test_lri.py tests/test_lss.py tests/test_validator.py ``` ## 定位 应将 LPI 评估为面向人机交互（human-AI）系统的语义通信和接口控制层。 它不仅仅是一个消息传递包装器。该仓库结合了： - 结构化的语义信封 - 传输握手语义 - 携带 consent 的 policy 字段 - 已签名的 trust 材料 - session 漂移和一致性跟踪 这种组合使其可作为 agentic 监督和面向安全接口设计的支持性工件。

标签：AI智能体, MITM代理, 上下文管理, 人机交互, 信任与同意, 自动化攻击, 语义接口, 逆向工具, 通信协议