tmpdot/dsh-audit-foundation--packages-common0

dsh-audit-common

Trust Anchor 共享纯函数库(零 DSH 依赖):提供工作区键与快照布局解析、意图标签、行级差异引擎、写路径安全防护及内容哈希功能。

AI 分析

核心用途是作为 Trust Anchor 审计生态的底层公共工具库。适合开发 DSH 安全、审计、回滚相关插件的开发者复用。零 DSH 依赖,可直接进行 CI 测试。

包名
dsh-audit-common
版本
0.1.0
许可证
Apache-2.0
最近更新
2026年8月21日

安装

此插件尚未提供可验证的 bundle,或兼容性检查未通过。请先阅读仓库说明。 阅读完整 README ↗

dsh-audit-common —— Trust Anchor 公共纯函数库

Trust Anchor(dsh-audit-foundation)的共享纯函数库。零 DSH 依赖 (不 import 任何 @deepseek-ai 包),CI 可直接测试;供基座各插件与生态 复用(M4:横切关注点独立实现;M6/M7:唯一实现,禁止各写一份)。

模块

模块职责MDP
workspace.mjs工作区键(workspaceKeyOf)/ 快照根解析 / 快照目录名(rewind 同构算法)+ cdp 布局助手(resolveCdpSnapshotRoot / cdpWorkspaceDir / cdpSnapshotDir)M8(组合不 fork)/ M6
labels.mjs意图标签:tool/call 事件 → 人类可读 label(路径相对化 / 命令简写 / 别名)M4
diff-engine.mjs行级 LCS diff(Uint32Array 全表 + 单元上限降级)+ 二进制检测
pathguard.mjs写路径安全纯函数:normalizeTargetPath / isProtectedRel / resolveInside / classifyRollback / withKeyLockM6
hash.mjs内容寻址(contentHash)/ 记录哈希链(recordHash / stableStringify)M7
retention.mjs保留策略纯函数(computeRetention:数量/字节配额 → 保留/逐出划分;只算不删)M9
constants.mjs词汇表与协议常量(providers / file status / diff ops / limits)

来源:workspace/labels/diff-engine/pathguard/constants 迁移自 dsh-checkpoint-diff 0.5.x (文件头注明);hash 为本基座新增。迁入后旧仓不再演进这些模块(D3)。

用法

import { workspaceKeyOf, snapshotKeyDir } from 'dsh-audit-common'
import { normalizeTargetPath, resolveInside } from 'dsh-audit-common'
import { diffLines } from 'dsh-audit-common'
import { contentHash, recordHash } from 'dsh-audit-common'
import { computeRetention } from 'dsh-audit-common'

合规自证(MDP)

  • M6:写路径校验唯一实现(pathguard);任何写路径禁止自写校验。
  • M7:哈希唯一实现(hash);"可验证 ≠ 不可篡改"(不密封、不签名)。
  • 无写路径、无数据产出(不拥有 schema——schema 归 dsh-audit-spec)。