dongsheng123132/dsh-narrative-ledger
30最近提交 2026年8月14日
dsh-narrative-ledger DSH 插件
DSH Narrative Ledger 是 DSH 插件，提供基于内容寻址、不可变的故事事件和事实账本。它验证事件序列、事实断言、角色知识，并检测矛盾，无需修改原稿。插件输出确定性 JSON 报告，附带 SHA-256 回读。
如何安装 dsh-narrative-ledger DSH 插件
dsh plugin --profile web add github:dongsheng123132/dsh-narrative-ledger复制不会执行命令。安装 dsh-narrative-ledger DSH 插件前请核对仓库和版本。
dsh-narrative-ledger DSH 插件数据来源
dsh-narrative-ledger DSH 插件快照日期：2026年8月16日
discovered
dsh-narrative-ledger DSH 插件能做什么
- 验证内容寻址的外部规范来源，无需复制原稿内容
- 强制连续不可变事件序列和单调故事时间
- 检测单值矛盾（如两个同时位置）
- 追踪角色知识：仅通过目睹或参与场景获取
- 提供基于序列号的防剧透投影，仅返回事实和知识 ID
- 生成确定性内容寻址 JSON 报告，支持原子发布和 SHA-256 回读
dsh-narrative-ledger DSH 插件适合哪些场景
- 验证叙事项目中的事件时序和因果关系
- 检测角色知识不一致或事实撤销错误
- 生成叙事连续性的可审计证据，用于团队审查
- 制作防剧透投影，在不泄露秘密的情况下共享部分故事状态
- 集成到 CI 流水线，在变更时自动验证叙事一致性
dsh-narrative-ledger DSH 插件适合谁
- 在 DeepSeek Harness 上构建交互式叙事的开发者
- 需要机器可验证叙事连续性的叙事设计师
- 管理复杂故事世界（含多个角色和事实）的团队
dsh-narrative-ledger DSH 插件的限制
- 只读账本：无法写入或修改故事散文、章节或提示
- 不执行 shell 命令或发起网络请求
- 路径必须在 workspaceRoot 内，拒绝符号链接
- 仅允许写入显式 artifactDir（用于报告）
- 需要 Node.js 22+ 和 DeepSeek Harness 环境
dsh-narrative-ledger DSH 插件的仓库 README 摘录
以下文字摘自 dsh-narrative-ledger DSH 插件的上游仓库 dongsheng123132/dsh-narrative-ledger 的 README，版权归原作者，仅作引用。
A read-only, verifiable story-state ledger for [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness). It is not a novel generator or writing-prompt wrapper. Existing tools such as Novel Director and InkOS manage writing workflows and rich story state; this plugin is the complementary evidence layer for machine-checkable continuity. ## What it verifies - content-addressed external canon sources without copying manuscript prose into reports; - contiguous immutable event sequence and monotonic story time; - explicit fact assertion and retraction with resolvable subject, predicate, value and source IDs; - single-value contradictions such as two simultaneous locations or mutually exclusive states; - character knowledge acquired only by witnessing an assertion or participating in a scene that communicates an active fact; - spoiler-safe projection at a sequence number, returning only fact IDs and knowledge IDs; - stale/missing canon, inactive fact communication and invalid retraction disclosure; - deterministic content-addressed JSON reports with atomic publication and SHA-256 read-back. The ledger rejects prose-, chapter-, draft-, prompt- and secret-shaped fields. Paths
阅读完整 README仓库许可: MIT
dsh-narrative-ledger DSH 插件常见问题
如何安装 DSH Narrative Ledger？
在终端中运行命令：`dsh plugin --profile web add github:dongsheng123132/dsh-narrative-ledger`。这将安装插件并使其工具在 DeepSeek Harness 环境中可用。请确保已预先安装 Node.js 22+ 和 DSH。
可以使用这个插件编写或编辑故事内容吗？
不可以。DSH Narrative Ledger 是只读账本，不会修改散文、章节、草稿或提示。它的目的是通过预定义的事件和事实文件验证并报告叙事连续性。要编写故事内容，需要使用其他工具，如 Novel Director 或 InkOS。
账本强制执行哪些验证规则？
账本强制执行多项规则：事件序列必须连续且不可变；故事时间必须单调递增；事实断言和撤销必须具有可解析的主语、谓语、值和来源 ID；角色知识只能通过目睹或参与场景获取；检测单值矛盾（如两个同时位置）；所有报告都是确定性的，并带有 SHA-256 校验和。
如何使用这个插件验证叙事项目？
使用 `dsh-narrative-ledger verify` 命令，并指定必需参数：工作区根目录、manifest 文件、事件文件和工件目录。例如：`dsh-narrative-ledger verify --workspace-root examples/basic --manifest narrative.manifest.json --events events.jsonl --artifact-dir artifacts`。插件将输出包含验证结果的 JSON 报告。
这个插件支持网络请求或 shell 命令吗？
不支持。插件不运行任何 shell 命令，也不发起网络请求。所有处理都是本地且基于文件的，确保安全性和可重现性。唯一允许的文件系统写入是显式指定的工件目录，用于输出报告。