dsh-skill-trace

DSH Skill 智能实验室

dsh-skill-intelligence ·

探索优秀 Agent Skill 的结构与方法， 将成熟 AI 工作流转化为个人能力和企业业务能力。

DSH Skill Intelligence 是面向 DeepSeek Harness 的 Agent Skill 研究与演进工具。

通过 Skill 洞察，用户可以：

• 理解优秀 Skill 的设计结构
• 分析 Skill 的运行逻辑
• 阅读和翻译 Skill 文档
• 复刻已有 Skill
• 持续沉淀个人与企业 AI 能力

DeepSeek Harness 插件 · 本地优先 · MIT · DSH 会话里的显示名：Skill 洞察（品牌：DSH Skill 智能实验室）

它仍然只做一件事，只是名字换了： Skill 是一级对象 —— 它声明了什么、这次会话到底加载过它、以及它的 SKILL.md 原文。底层能力是 Skill Trace（本地加载证据：/skill-trace/* 路由、npm 包名 dsh-skill-trace、存储结构都不改名），产品层是理解 → 阅读 → 翻译 → 复刻 → 演进。

当 Agent 自动选择 Skill 时，普通用户常常只看到结果：不知道它加载了什么、按什么步骤工作。DSH Skill Intelligence 把两件事分开摆：Skill 声明了什么（只来自 SKILL.md 正文）与这次会话实际加载过什么（只来自 DSH 的运行时事实）。两者不互相推断，也都不打分。

一次成功的 skill(name) 调用只证明 Agent 请求并成功加载了 Skill；不证明 Agent 完全遵循其指令，也不证明 Skill 导致了正确结果。插件会明确保留这条证据边界。

第一屏回答“这次用了哪些 Skill”。截图由真实客户端 bundle + 真实会话数据渲染（渲染台是本地工具，不在仓库内）。

快速概览

项目	说明
产品名称	DSH Skill 智能实验室（英文：DSH Skill Intelligence）
会话显示名	Skill 洞察（英文：Skill Insight）—— DSH 侧边栏 / 工作栏 / 插件入口这类高频位置用的短名；产品品牌仍是 DSH Skill 智能实验室
插件名称（npm / 目录 / 路由）	dsh-skill-trace —— 保持不变：npm 上已发布，改名会让所有安装命令与已锚定的 github: 源失效
技术底座	Skill Trace —— 本地加载证据；/skill-trace/* 路由、模块名与存储结构都属于内部技术层，不随品牌改名
适配平台	DeepSeek Harness web Profile / Desktop（当前运行基线：DSH Desktop 0.11.3 / runtime 0.1.5-rc.2；此前基线验证于 Desktop 0.8.3 / runtime 0.1.1-rc.2）
解决的问题	Agent 加载了什么 Skill、何时加载、声明如何运行、我能否手动延续，都缺少用户可读的证据
核心界面	本次 Skill、已安装 Skill，以及它们共用的二级页 Skill 详情（SKILL.md 原文 / 中文阅读版）；详情页左栏的对象动作里有 复刻 Skill
第一屏	默认打开「本次 Skill」列表：这次会话真正加载过的 Skill（名称 / 简介 / 加载次数 / 最近加载 / 定义状态）。不需要先理解 Turn、Step 或 Runtime Graph
证据范围	观测 skill(name) 的调用/结果；区分请求、成功、失败、未知与人工判断
阅读闭环	本次加载的 Skill（或已安装 Skill 列表里点一张卡）→ 读它自己的 SKILL.md → 看不懂原文时切中文阅读版 → 需要时回看它这次拿到的证据 → 想拿它当底子就复刻成自己的 Skill
隐私	本地优先；不保存完整 Prompt、完整 Skill 正文、Token、Cookie、绝对路径或项目内容
界面语言	跟随 DeepSeek Harness 设置：中文显示中文，英文显示英文；运行中切换即时刷新
不做什么	不发现/安装/同步/路由 Skill；不自动运行脚本；不自动改写、提交或发布 Skill

你会看到什么

整个插件只有两个一级页面，以及它们共用的一个二级页面。

1. 本次 Skill：这次用了哪些 Skill

打开就是这次会话真正加载过的 Skill 列表——只有观测到真实加载证据的 Skill 才会出现，当前环境里可发现但这次没用过的不在其中（那是「已安装 Skill」的回答）。

每一张卡片给出名称、声明简介，以及本次会话的加载次数、调用方式（model / /name / 未使用）和定义是否读得到。列表里没有 Tool 数、节点数和边数：Tool / MCP / CLI / Subagent 不是产品的一级对象，只作为某个步骤的运行证据出现。

2. 已安装 Skill：我现在有哪些可用 Skill

当前 DSH 环境可发现、可调用的 Skill，按名称排序，带一个实时过滤的搜索框（匹配名称与描述）。它不读本次会话的收据——不管这次加载过什么，这个列表都一样。

这一页刻意只做发现：没有学习状态、没有验证状态、没有历史理解、没有 review queue，也没有把“可发现”写成“已加载”。

3. Skill 详情：这个 Skill 声明了什么

从上面任一列表点进来，返回键会说明你是从哪个列表进来的，并回到那里。

左边是这个 Skill 的事实卡：调用方式、定义文件与当前指纹、本次加载次数、定义来源，以及指令指纹比对——把“这次运行实际收到的指令哈希”与“现在读到的定义哈希”并列，结论只有 match / mismatch / unavailable 三种（只有一侧存在哈希就是 unavailable，不会温和地写成 mismatch，也不会写成“Skill 已失效”，因为哈希只证明版本变化，不证明好坏）。再下面是仓库来源：只可能来自 frontmatter、git origin 或用户配置，找不到 .git 就显示「仓库 · 未解析」，不用目录名或 Skill 名猜一个链接出来。

主内容区从上到下是四层，顺序本身是产品的一部分：框架 → 本次运行逻辑 → 步骤证据 → SKILL.md。

第一层是「Skill 框架」，它回答的是“这个 Skill 由什么组成”。 框架不是那条 01 → 02 → 03 → 04——那只是 SKILL.md 里某个小节的有序列表，是一个 342 行能力包的一小部分。框架由三个子模块组成：

• 结构：把正文按标题层级切成小节，归入八个角色（定位 / 触发 / 规则 / 控制 / 工作流 / 资源 / 产出 / 验证），确定性解析，不调模型。归不进角色的小节进「其它章节」而不是被丢掉；某个角色正文里没有，界面就直说缺什么（ui-craft 缺「验证」），不替它补一节。
• 声明流程 · Declared Workflow：detail.flow.steps[] 原样保留，现在作为框架的子模块出现，竖排成 01 → …，每步给出序号、标题、类型，以及本次会话里观察到的证据状态。
• 渐进披露 · Progressive Disclosure：Skill 目录 → 载入 Skill → SKILL.md 全文 → 资源基准路径 → 被引用的资源 → 按需读取，下面按 Tier 1 — Required 这样的层级列出被引用的资源。对 ui-craft 是「39 个声明引用 · 0 个已读取」，而 0 个已读取是这一层要说的话：收据里没有来源证据能证明某个 references/tokens.md 被读过，界面就不会说读过。

第二层是「本次运行逻辑」：只从当前会话的收据出发，走 目录 → 载入 → 指令 → 运行能力 → 证据 五段，每段给出能观察到的事实和观察不到时的原因。它不是运行图，阶段之间也没有因果顺序——Skill Load 之后 100ms 的一次工具调用不会被画成 Skill → Tool。

状态词是这两层最要紧的约定。五档读作「有相关运行证据 / 部分相关证据 / 仅有模型意图 / 暂无足够证据 / 无法判断」，「已执行」「未执行」「已完成」「已加载」「已读取」这类词一个都不会出现——没有观察到证据，推不出没有执行，这两句话之间的距离就是整个产品的立场。**第三层「步骤证据」**把每一步已经在后端算好的依据摆出来（命中类型、观察到的节点、证据 id、是否有模型意图、匹配数），并常驻一句：「暂无足够证据」不代表这一步没有执行。

点框架里的任意一节、任意一个资源、或声明流程里的任意一步，右侧文档会滚到对应章节并短暂高亮——用的是同一套锚点机制，有锚点的渲染成按钮，没锚点的渲染成不可点的行。不跳页，不打开任何运行图。

再往下才是 SKILL.md 本身，只读展示，两个模式：

• 原文：逐字来自定义文件，这里不做任何改写；
• 中文阅读版：把正文交给宿主模型翻译，用于当前页面阅读。标题层级、代码围栏、围栏内的命令、行内代码、URL、文件路径、frontmatter 键都由宿主的规则逐条校验，对不上就不接受。译文存在本机（/translations/，按「Skill 名 + 正文指纹 + 语言」索引，不含会话），退出 DeepSeek Harness 后再打开同一个 Skill、还是同一版正文，就还是这份译文，不会重新请求模型。正文一改，指纹就变，旧译文不再显示，界面退回原文并允许重新翻译。译文不写回 SKILL.md、不进收据、不进这次对话。保存态是真的写成功才说：宿主没写成，界面就直说「中文阅读版没有保存到本机，下次打开需要重新翻译。」

左侧目录跟着当前显示的那一份走：切到中文阅读版时，目录锚定的是译文里对应的标题，而不是原文行号。

表格按 GFM 渲染成真正的表格（此前 ui-craft/SKILL.md 里 101 行以 | 开头的内容会退化成一串竖线）：

原文与中文预览共用同一个渲染器调用点，所以标题、列表、代码围栏与表格在两种模式下行为一致：

边界同样是产品的一部分：定义正文永不落盘、永不进收据，只在当前会话上现读现返；资源基的绝对路径只暴露类别不暴露路径；凭据型仓库地址（https://user:token@…）整条拒绝，不剥离也不半显。

工作方式

flowchart LR
    A[Agent 请求 skill name] --> B[DSH 工具调用与结果]
    U["用户输入 /name"] --> B
    B --> C[Skill Trace：本地收据]
    C --> D[本次 Skill 列表]
    R[Skill Registry] --> E[已安装 Skill 列表]
    D --> F[Skill 详情]
    E --> F
    F --> G[读 SKILL.md 原文]
    G --> H[需要时切中文预览]
    C --> I[每一步挂上这次运行留下的证据]

    B -. 成功加载不等于有效 .-> J[不自动推断遵循、正确性或因果]

列表只有一条来路：加载证据。详情只有一条来路：定义文本。运行时证据只往已有步骤上挂标注，既不增加、也不删除、不改名、不重排步骤——反过来用运行时事件推断出一条流程，是这一版刻意排除的做法。

三步开始

1. 安装

从 GitHub 安装（锚定本次发布的 tag）：

dsh plugin --profile web add "github:PolinniZhong/dsh-skill-intelligence#v0.7.1&path:/"

或从 npm 安装（0.7.1 已发布，npm 上的 beta 与 latest 都指向它）：

dsh plugin --profile web add dsh-skill-trace@0.7.1

安装后重启 DeepSeek Harness Desktop，在会话中打开 Skill 洞察。

当前功能已通过本地链接安装的 Desktop 验证。dsh plugin add 会把包名参数转交 pnpm 解析，所以 npm 包名与 github: 源两种写法都可用；如未来 DSH 更新导致源安装行为变化，可使用下方的克隆安装作为回退方式。

2. 跑一次真实任务

让 Agent 自然加载一个 Skill。若本次没有观测到任何 Skill，插件只显示“当前对话暂未加载任何 Skill”的空状态，不会填入示例数据。

3. 读它的 SKILL.md，不要停在列表

点开任意一张卡片，进入 Skill 详情。右侧是这份 Skill 的 SKILL.md 原文——逐字来自定义文件，不重排、不摘要、不改写；左侧的目录由正文标题确定性抽取，跟着当前显示的那一份走，点一下跳到对应位置。

需要中文时切到「中文阅读版」。这不是把 SKILL.md 改写成中文：代码围栏、URL、文件路径、行内代码与 frontmatter 都按原样保留，模型只翻译正文；译存在本机，按「Skill 名 + 正文指纹 + 语言」索引，退出 DSH 再打开、正文没变就还是它，正文一变就不再显示。它不写回文件、不进入这次对话。翻译失败时分段控件会回到「原文」，错误摆在最上面，原文不受影响。

看到一份值得学的 Skill，左栏对象区里有 复刻 Skill：给它起个名字、选当前项目还是我的 Skill、选复刻整包还是只要 SKILL.md，插件就读源、写新目录、回读校验。它不改源、不覆盖同名 Skill、执行不了 Skill 里的 scripts/，也不显示任何本地绝对路径。完成后它说三件事：写到哪、目录刷新观察到没有、源有没有被动过——最后一件是重新读源比对哈希得出的，不是一句保证。目录刷新观察不到时它会直说「待确认」并告诉你重启后一定可见。

左栏的事实卡回答的是这次会话实际发生了什么：本次加载了几次、每次用的哪种调用方式、加载时收到的指令哈希与现在读到的定义哈希是否一致（一致 / 文件已改变 / 无法比对）。声明是 SKILL.md 说的，观测是收据记的，插件从不把两者混成一句「Skill 有没有被正确执行」。

本地开发与回退安装

git clone https://github.com/PolinniZhong/dsh-skill-intelligence.git
cd dsh-skill-intelligence
npm test
npm run verify
dsh plugin --profile web add "link:$(pwd)"

移除插件：

dsh plugin --profile web remove dsh-skill-trace

移除插件不会自动删除已有本地收据；删除应始终由用户在产品内明确确认。

隐私与边界

• 不实现遥测、云同步、收据上传或远程分析。
• 只保存显示加载证据所需的最小元数据与安全来源标识。旧版本写入过的人工笔记与验证结果仍留在收据里，但 v0.6 已移除写入入口（学习工作台随信息架构一起删除）。
• 不保存完整 Prompt、完整 Skill 指令、访问 Token、Cookie、凭据、绝对路径、项目文件或生成内容。
• 网络、模型、MCP、脚本、权限只会作为候选线索呈现，仍需要人工核对；“可手工延续 / 可部分延续 / 当前受阻”也必须由用户自己判断。

详见 隐私说明 与 架构说明。

当前状态

当前公开版为 0.7.1（品牌迁移：Skill Trace → DSH Skill Intelligence / DSH Skill 智能实验室）：GitHub Release（tag v0.7.1）与 npm 上是同一份构建，npm 的 beta 与 latest 都指向它。这一版只改产品名、用户可见措辞与仓库元信息——npm 包名仍是 dsh-skill-trace，路由、模块与存储结构一个都没动，功能行为不变。中间跳过的 0.5.0 与 0.6.0 只在 GitHub，所以 npm 的版本号从 0.4.0-beta.66 直接跳到 0.6.1，再到 0.7.0 与 0.7.1。信息架构没动，四层仍是：框架（结构 + 声明流程 + 渐进披露）→ 本次运行逻辑 → 步骤证据 → SKILL.md 原文与中文阅读版。一级页面仍是两个——「本次 Skill」与「已安装 Skill」，两者点进同一个二级页「Skill 详情」，返回键写明是从哪个列表进来的。运行流程、运行图谱、Skill 收据、上下文检查器与「我的 Skill」学习工作台自 0.5.0 起保持删除状态，连同只服务于它们的 elkjs 与 @xyflow/react —— 相比它们还在时的 3536 行，客户端源码现在是 2343 行，bundle 129254 字节，宿主路由 10 条。

仓库里还有一处尚未发布的命名调整：DSH 会话内的短显示名从「DSH Skill 智能实验室」改为「Skill 洞察」（英文 Skill Insight）。 只影响侧边栏 / 工作栏标签与面板的无障碍名称——产品品牌、npm 包名、路由与存储结构都不变。发布前你在运行中的 DSH 里看到的仍是旧标签。

0.7.0 把产品从「观察 → 理解」推进到「观察 → 理解 → 阅读 → 复刻 → 让当前 Agent 继续用」，三个能力都落在已有页面里，没有新增一级或二级页面。 一是已安装 Skill 的卡片整张可点：它此前是个纯展示的 article，只能看不能进，现在点一下就进同一个 SkillDetailPage，返回键照旧写明是从哪个列表来的；卡片里没有再加一个「查看详情」按钮——两个入口指向同一个动作，其中一个必然多余，渲染烟测直接断言这个页面的按钮数恰好等于卡片数。二是中文阅读版从「临时」变成「资产」：译文落到 /translations/，按「Skill 名 + 正文指纹 + 语言」索引、不含会话 ID（它是资产，不是某次会话的产物），退出 DSH 再打开、正文没变就直接用，正文一变就退回原文并允许重译。保存态是真的写成功才说——宿主在 /translate 的响应里回一个 saved 布尔，没写成界面就直说「中文阅读版没有保存到本机，下次打开需要重新翻译。」三是复刻 Skill：详情页左栏对象区里唯一的对象级动作，弹一个 560px 的紧凑对话框（名字、当前项目还是我的 Skill、复刻整包还是只要 SKILL.md）。它只读源、只写新目录，mkdir 不带 recursive，所以同名不覆盖是文件系统的性质而不是一段记得住的判断；sourceSha256 随请求提交、宿主重新读源再校验，对不上就 409 让用户重开详情页；副本的 frontmatter name: 会被改写成目标名（DSH 认 frontmatter 不认目录名）；写完之后必须回读再报成功，并且重新读一遍源比对哈希、如实说源有没有被动过。它不执行 Skill 里的 scripts/、不跑 bash、不触发 Agent，也不返回任何本地绝对路径。目录刷新是观察出来的——插件拿不到 provider 的 invalidate，观察不到就写「待确认」并说明重启后一定可见。

0.5.0 之后，Skill 详情内部陆续加了几样东西，信息架构没动。 先是真正的 GFM 表格渲染——此前 ui-craft/SKILL.md 里 101 行以 | 开头的内容全部退化成竖线串；同一版给翻译加了表格结构校验：单元格里的自然语言照翻，表格的行列形状不许变。

接着是把**「Skill 框架」重做了一遍**。第一版把框架做成了从正文里抽出的那条竖排链条，结果 ui-craft —— 342 行、11 个小节、39 个外部资源 —— 在界面上被说明成四步。声明流程是一份 Skill 的一部分，不是这份 Skill 的形状。 现在的框架由 src/core/skill-framework.mjs 从 SKILL.md 确定性解析（无模型调用）：小节分类进八个角色，未归类的进「其它章节」而不是消失，缺哪个角色就直说缺哪个，被引用的资源按层级列出来并严格区分「声明」与「已读取」。detail.flow 一个字没删，只是降级成框架的一个子模块。

同一次改动加了**「本次运行逻辑」（src/core/skill-runtime-logic.mjs：目录 / 载入 / 指令 / 运行能力 / 证据五段，每段只列当前会话能观察到的事实）与「步骤证据」**（把 detail.flow.steps[].evidence 里早已算好的依据第一次显示出来）。四层在主内容区里的顺序由守卫盯着：框架 → 运行逻辑 → 步骤证据 → SKILL.md。

声明与观测不互相推导这条原则没有变，变的只是渲染它的界面。SKILL.md 的正文与目录是声明：逐字读取，不经过任何模型、Embedding 或检索。收据里的加载证据是观测：谁加载、加载了几次、用哪种调用方式、加载时的指令哈希是多少。v0.6 不再把两者叠成「声明流程 + 证据徽章」的中间栏——那只在旧的三栏工作台里说得通。列表只认加载证据；Run 标识不伪造（runId 字段刻意不存在）；仓库来源只可能来自 frontmatter、git origin 或用户配置，猜不到就显示「仓库 · 未解析」，不造链接。证据词表仍是五个值，仍然只做投影，只是不再有页面逐个渲染它。

0.4.0-beta.66 加入定义视图——三栏展示某个 Skill 的声明流程、SKILL.md 原文与目录、以及每一步当前拿到的证据等级，并把「这次运行实际收到的指令哈希」与「现在读到的定义哈希」并列比对，结论只有 match / mismatch / unavailable 三种（定义正文永不落盘，只在活会话上现读现返）。同一版修掉证据链路里三处静默降级——它们此前不会被任何测试抓到，因为每一处单看都「工作正常」：Scope 构造时丢弃了证据类别字段，导致 npm test 永远降级成裸能力；运行结果因为 turn 为 null 而进不了 Scope，导致 Scope 从来看不到 success / failure；声明步骤与运行时能力类别不匹配时直接判「证据不足」，导致「模型确实表达了这一步意图」这个事实根本没有机会被汇报。修复后，同一个 Turn 内的 Skill 加载与 bash npm test 已经能给出 resolution=matched status=success category=test。

上述实现已通过 429 项自动化测试与 23 道静态合同守卫，覆盖两个一级列表页、唯一二级页、中文阅读版的持久化边界（键里不许有会话、不许落盘不该落的东西、退出重启后还能取到、指纹变了就不显示）、「已安装」投影里不得出现绝对路径或定义正文，以及 v0.5.0 之后的 Skill 详情增强（声明流程只从定义抽取、证据状态词表不许说出「未执行」、框架只从正文确定性解析而不调模型、声明资源不得写成已读取资源、表格渲染与翻译表格校验共用一个解析器、原文与中文阅读版只有一个渲染调用点）。复刻那一块单独成组：目录解析、整包选取、符号链接绝不跟进副本、同名不覆盖且不先删后写、半途失败要把目录清掉、回读校验、409 分得清「源变了」还是「名字被占了」、以及响应里永远没有绝对路径。守卫里有一类值得单说：它们断言的是今天仍然成立的事实。第 5 步删掉 3536 行里的 22 个组件时，verify-project.mjs 的客户端契约里有 45 条断言在描述已经不存在的界面——其中大多数之所以还能通过，只是因为那句文案还留在英文字典里，而字典项没有消费者。契约清单因此重写成 28 条，并反向钉住那 15 条已删的宿主路由与 buildRuntimeGraph / computeRuntimeLayout / buildCatalogView：删掉的东西不该悄悄回来。界面验收仍是两层：渲染台用真实客户端 bundle + 真实会话载荷逐张核对（首屏、已安装列表、点已安装卡片进入详情、详情原文、详情里的表格、中文阅读版已保存态、本机没有这一版译文时回落到原文、翻译失败态、复刻对话框、复刻成功、目录刷新待确认、整包被上限截断、同名 409 错误就地显示），返回的 JSON 中不含任何绝对路径；两个升级缺陷（React #310 白屏、旧偏好里的缺省 map）是在运行中的真实 DSH 里用 CDP 复现并复验的。仍未覆盖的一层是人眼走查：以上都是无头浏览器截图，最终在 DSH Desktop WebView 里由人确认断点与可读性，留给发布会话。

0.4.0-beta.7 修复了 DSH 会话格式 V3 → V4 迁移带来的静默证据丢失：V4 把工具结果提升为一等 tool 消息并取消了 V3 的 tool-result 包裹块，而观察器只认包裹块，导致迁移后的会话仍报告“已加载”，却不再产生指令指纹、候选步骤与版本变化。现在两种格式都能读取，并新增了基于真实 V4 事件样本的契约测试。

0.4.0-beta.8 补齐观测面。此前只订阅工具事件，因此用户以 /名称 显式加载 Skill 时（DSH 以 user/message 注入，不产生 skill 工具调用）在收据里完全不存在；实测同一次会话中两次 /character-asset-kit 加载此前全部不可见，现在都能给出指令指纹与候选步骤。同时把 DSH 持久化发布的 Skill 目录作为声明基线记录下来，并把每个工具调用保留为有限的运行证据——工具、CLI、MCP、Subagent 调用本来就到达事件流，只是被入口丢弃，这正是运行图谱缺少原料的原因。运行证据只保留关联与分类元数据，不读取参数与结果内容。

0.4.0-beta.9 把运行事件归一化成统一的 RuntimeEvent 模型，并按 invocationId 聚合成 Invocation。每个事件带 source（dsh 宿主事实 / derived 具名规则派生）与可引用的 eventId；派生事件只会追加，绝不覆盖它读过的事件，且必须能说出依据的规则名（目前一条：same-turn-repeat-after-failure，用于识别同一 Turn 内失败后的重试）。聚合严格按 invocationId 配对，不使用时间相邻，因此没等到结果的请求保持 unresolved-request、没有请求的结果保持 orphan-result，不会被"就近补全"。Skill 证据仍然即时落盘，运行证据改为在 Turn 边界持久化——它是可以从会话日志重建的派生证据，而每次工具调用都重写整个收据会把同一个不断变大的文件写上百次。本版不上 UI。

0.4.0-beta.10 加入关联引擎与图谱重建。规矩只有一条，且高于其余所有：图可以不全，但不能错。每条边必须能引用收据里真实存在的事件，引用不到就丢弃并计入 droppedEdgeCount，不会降级成一条更弱的说法；无法确定归属的调用列进 unlinked 并附原因，不会挂到最近的节点上。包含关系（会话→Turn→调用）与 Subagent 派生是 observed，因为它们基于宿主事实（turn/step 与父会话发出的 subagent/catalog.childId）；唯一的启发式是"同一步骤内相邻"，且只标 candidate。目录事件里的自由文本 label 刻意不读——那是调用方文本。边的词表是封闭的：没有 uses、没有 produces（把工具调用归因给 Skill 需要对齐证据），也没有任何能表达"因果"的边类型。本版不上 UI。

0.4.0-beta.11 加入 Declaration ↔ Runtime Alignment——这是整个产品的分水岭。三条承诺：不评分（只报告证据状态计数，没有遵循率、百分比或排名）；证据不足不等于没有执行（没有对应证据的声明步骤记为 insufficient，词表里刻意没有 not-observed，因为缺失的数据永远无法证明 Agent 跳过了某步）；直接证据不等于泛化证据（bash 只证明"执行了某条命令"，不能证明就是测试步骤，所以只记为 partial）。

同时修掉了一个真实缺陷：声明步骤抽取此前只抓有序列表，在真实技能上抽出的 5 条全是条件分支与内容分类，而 7 条真正的流程步骤一条没抓到。现在改为标题层级 + 有序列表双通道且标题优先，实测 ai-frontier-daily-topics 正确给出 7 条真实步骤。另外，把 ## 硬约束 里的条目当成"流程步骤"是错误标注，因此有序列表只在流程类章节内（或整篇无章节时）才计入——正文不声明流程的技能会明确说 numbered-items-outside-a-process-section，而不是把约束升格成对齐对象。本版不上 UI。

0.4.0-beta.13 加入运行图谱画布——插件里的第三个视图，也是 beta.5 以来第一次改动界面。按重构方案的硬约束先量后决：本机 56 个真实会话的图谱规模是中位 61 节点、p90 915、最大 1095，比扁平画布能承受的量大一个数量级，所以分组是模型的一部分，不是事后优化。三条规则依次生效：单个 Turn 超过 12 次调用→按能力折叠；会话超过 36 个 Turn→折成区间；单层超过 26 行→换列。它们把画布稳定压在 200 节点以内、约 1036px 高，56 个会话无一超限（布局耗时中位 0.3ms，最差 15ms）。

布局是图的纯函数：不存坐标、不记视口与缩放、不改动图本身——同一份收据永远画出同一张图，所以重绘不会被误读成新证据。检查器逐节点/逐边回答"这条线为什么存在"，每条关系都同时给出含义与它不表示什么（follows 是日志顺序不是因果；规则派生的 spawns 归属不是宿主事实；retries 不代表重试更接近成功），并携带 causal/compliance/correctness: false 的证据边界。画布只发计数不发 id 列表，细节按需重新推导——最大会话的响应从 481KB 降到 145KB（中位 21KB）。 上面的逐版说明只写到 0.4.0-beta.13，完整历史见 CHANGELOG.md（当前已到 0.7.1）。 以下是 beta.14 以来的主线：

• beta.14–beta.30：My Skills 目录页、指纹预留结构、五层运行时模型（会话 → Turn → 能力 → 调用 → 结果）、 证据优先的 UI 治理收口

• beta.31：回改三处实现偏离，统一配色 Token（宿主 Token 优先，实现值为回退）

• beta.32–beta.42：按 preview.html 对齐视觉与交互；建立真实插件静态渲染台， 运行流程的阅读密度从 195 节点降到 16–22 节点（100% 缩放可读）

• beta.43–beta.48：修掉四个「功能写了、测试通过、产品里没有」的缺陷——

  缺陷	根因
  阅读视图看不到 Skill	边界循环把 skill × 1 并进 mixed 分组，类型标签丢失
  Skill 三个 Tab 从未出现	inspect 的折叠节点没带 capabilityId
  Error 态页头与正文矛盾 / Tab 无标签	未区分"正在读"与"读失败"；标签表缺键
  选中 Skill 却提示"先选 Skill"	skillLoads 记调用 id，与分组 id 匹配不上

  共同根因：折叠分组是布局层合成的，而周围代码都按"调用节点"设计。

• beta.49–beta.52：节点字重复与图标来源修正、折叠分组缝隙系统性核查、补齐知识管理

• beta.53–beta.57：公开范围收敛。产品主张、需求与技术设计纳入公开仓库 （过程目录 00_ / 01_ / 99_ 与 specs/ 仍留在本地），.gitignore 的注释改写为说明理由

• beta.58–beta.59：Contextual Inspector（Expanded / Collapsed / Rail）与 Skill Runtime Scope 的画布表达。运行图谱默认折叠为 26px Rail，画布释放 314px； 范围成员用 data-in-scope 淡淡标注，不画包围盒、不画连线，且只有 observed / correlated 参与

• beta.60：Dark Mode 改为 Token 化。14 个 --st-* 指向 DSH 的 --dsw-alias-*， 不再维护第二套 CSS 与 isDark 状态

• beta.61–beta.63：Layout Contract 修复。详见下节

• beta.64：知识管理同步与根目录收敛（无代码改动）

• beta.65：消除 correlated → observed 的静默提升。区分「证据强度」（事件是否在可靠 Scope 内）与「证据指向」（它是否指名了声明步骤所指的那个对象）两个正交轴；同 Turn 不再等同于归属

• beta.66：定义视图 + 证据链路三处静默降级修复 + 证据词表收敛为 5 值 + 全库颜色字面量清零。 详见上文「你会看到什么」第 4 节与 CHANGELOG.md

• beta.67：Skill-first 信息架构——第一屏从运行流程图换成「本次 Skill」，运行流程 / 运行图谱 / Skill 收据一并收进「高级 ▾」。这是结构性重构，不是加第四个视图。测试 382 → 406； 随后一个修复把「拉不到列表」与「没有加载过 Skill」分开，到 407