大型语言模型编码代理在任务之间会丢失上下文。在大型代码库中，它们大部分的代币都花在了“定位”上——弄清楚各部分位置、相互依赖关系以及哪些可以安全更改。DSP 通过将项目的结构化地图外部化为一个持久的、可查询的图来解决这个问题，该图存储在代码旁边的 .dsp/ 目录中。

DSP 不是面向人类的文档，也不是 AST 转储。它捕捉三件事：意义（实体存在的原因）、边界（它导入和暴露了什么）以及原因（每个连接存在的原因）。这些足以让代理在不将整个源代码树加载到上下文窗口中的情况下进行导航、重构和生成代码。

DSP 将代码库建模为有向图。节点是实体，边是导入和共享/导出。

通过 UID 识别，而不是通过文件路径

每个实体都有一个稳定的 UID：对象使用 obj-，函数使用 func-。文件路径是会改变的属性；UID 可以在重命名、移动和重新格式化后保持不变。

对于文件内的实体，UID 在源代码中通过注释标记固定：

// @dsp func-7f3a9c12
export function calculateTotal(items) { ... }

当记录一个导入时，DSP 会存储一个简短的原因来解释为什么存在该依赖。这会存放在被导入实体的 exports/ 反向索引中。没有原因的依赖图会告诉你什么导入了什么；而原因会告诉你哪些是可以安全更改的，以及谁会因此出错。

每个实体在 .dsp/ 下都有一个小目录：

.dsp/
├── TOC                        # ordered list of all entity UIDs from root
├── obj-a1b2c3d4/
│   ├── description            # source path, kind, purpose (1-3 sentences)
│   ├── imports                # UIDs this entity depends on (one per line)
│   ├── shared                 # UIDs of public API / exported entities
│   └── exports/               # reverse index: who imports this and why
│       ├── <importer_uid>     # file content = "why" text
│       └── <shared_uid>/
│           ├── description    # what is exported
│           └── <importer_uid> # why this specific export is imported
└── func-7f3a9c12/
    ├── description
    ├── imports
    └── exports/

一切都是纯文本。可进行差异比较。可审查。无需数据库。

任何被导入到任何地方的文件或工件都必须在 .dsp 中以对象的形式表示——代码、图像、样式、配置、JSON、wasm，所有内容。外部依赖（npm 包、标准库等）记录为 kind: external，但它们的内部从不被分析。

该技能依赖于一个独立的 Python 命令行脚本 dsp-cli.py。如果项目中缺少该脚本，请下载它：

curl -O https://raw.githubusercontent.com/k-kolomeitsev/data-structure-protocol/main/skills/data-structure-protocol/scripts/dsp-cli.py

需要 Python 3.10。所有命令使用 python dsp-cli.py --root 。

如果 .dsp/ 为空，通过对导入进行深度优先搜索（DFS）从根入口遍历项目：

Create init, create-object, create-function, create-shared, add-import

Update update-description, update-import-why, move-entity

Delete remove-import, remove-shared, remove-entity

Navigate get-entity, get-children --depth N, get-parents --depth N, get-path, get-recipients, read-toc

Diagnostics detect-cycles, get-orphans, get-stats

New file/module create-object + create-function + create-shared + add-import

New import added add-import (+ create-object --kind external if new dep)

Export added create-shared (+ create-function if new)

Internal-only change No DSP update needed

示例 1：设置 DSP 并记录一个模块

python dsp-cli.py --root . init

python dsp-cli.py --root . create-object "src/app.ts" "Main application entrypoint"
# Output: obj-a1b2c3d4

python dsp-cli.py --root . create-function "src/app.ts#start" "Starts the HTTP server" --owner obj-a1b2c3d4
# Output: func-7f3a9c12

python dsp-cli.py --root . create-shared obj-a1b2c3d4 func-7f3a9c12

python dsp-cli.py --root . add-import obj-a1b2c3d4 obj-deadbeef "HTTP routing"

示例 2：在进行更改之前浏览图表

python dsp-cli.py --root . search "authentication"
python dsp-cli.py --root . get-entity obj-a1b2c3d4
python dsp-cli.py --root . get-children obj-a1b2c3d4 --depth 2
python dsp-cli.py --root . get-recipients obj-a1b2c3d4
python dsp-cli.py --root . get-path obj-a1b2c3d4 func-7f3a9c12

示例 3：在替换库之前进行影响分析

python dsp-cli.py --root . find-by-source "lodash"
# Output: obj-11223344

python dsp-cli.py --root . get-recipients obj-11223344
# Shows every module that imports lodash and WHY — lets you systematically replace it

此技能自然地与以下内容相关：

来源说明：本文内容整理自开源项目 agentic-awesome-skills（中文翻译版），遵循 CC BY 4.0（知识共享署名 4.0 国际）许可协议，此处作为中文资料整理分享，版权归原作者所有。

Data Structure Protocol 实用指南

Give agents persistent structural memory of a codebase — navigate dependencies, track public APIs, and understand why connections exist without re-reading the whole repo.

数据库

数据结构协议（DSP）为AI编码代理提供持久化项目结构记忆，通过.dsp目录存储代码实体图、依赖关系及连接原因，帮助代理高效导航、重构和生成代码，减少上下文窗口占用，支持影响分析与依赖管理。

数据结构

Python

Agent

JSON

对象存储COS新用户低至1元！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Data Structure Protocol 实用指南

Data Structure Protocol 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐