前言¶

在 DSH 插件生态里，叙事类工作流经常需要维护时间线、正典来源和角色知识边界。已有工具如 Novel Director、InkOS 可以管理写作流程和较丰富的故事状态；dsh-narrative-ledger 解决的是另一类问题：给这些状态提供一份只读、可验证、机器可检查的证据层。

它面向 DeepSeek Harness，提供内容寻址的时间线、正典和角色知识证据。下面介绍它的定位、能力、安装方式和可复现示例。

这是什么¶

dsh-narrative-ledger 是一个面向 DeepSeek Harness 的只读、可验证故事状态账本。它定位为 machine-checkable continuity 的证据层，不是小说生成器，也不是写作提示包装。

关键信息：

• 仓库 owner：dongsheng123132
• 包名：dsh-narrative-ledger
• 版本：0.2.0
• 许可证：MIT
• 运行环境：Node.js >=22
• 模块类型：type module
• CLI：dsh-narrative-ledger
• 入口：. 和 ./ledger

它引用外部正典来源，但不把稿件正文复制进报告；它也不运行 shell，不发起网络请求，只允许写入显式 artifactDir。

核心功能¶

内容寻址正典¶

插件使用内容寻址方式引用外部正典来源。报告不会复制稿件正文，而是围绕可解析的来源、事件、事实和角色知识证据进行验证。

事件序列与故事时间¶

插件验证连续、不可变的事件序列，并验证单调故事时间。事件序列不能随意插入、删除或回退；故事时间需要按事件顺序推进。

事实断言与撤回¶

插件支持显式事实断言与撤回。断言要求 subject、predicate、value、source ID 可解析。它也会披露无效撤回。

冲突与状态披露¶

插件检测单值冲突，例如同一时刻两个地点或互斥状态。它还会披露过时正典、缺失正典、非活跃事实沟通以及无效撤回。

角色知识边界¶

角色知识不是默认全局可见。插件要求角色知识只在角色见证某个断言，或参与沟通活跃事实的场景时获得。这有助于避免角色提前知道后文事实。

剧透安全投影¶

插件支持按序列号进行剧透安全投影，只返回事实 ID 和知识 ID。这样可以在不展开正文内容的情况下，检查某个时点角色掌握了哪些事实。

报告与发布¶

插件生成确定性内容寻址 JSON 报告，并支持原子发布与 SHA-256 读回。DSH 和 CLI 作为显式文件系统接口，其内容寻址 artifact 响应包含字节长度和成功读回验证。

输入与路径限制¶

插件拒绝 prose、chapter、draft、prompt、secret 类型字段。路径必须保持在 workspaceRoot 内，并拒绝符号链接。

安装与启用¶

插件运行要求 Node.js >=22。安装命令如下：

dsh plugin --profile web add github:dongsheng123132/dsh-narrative-ledger

安装后，插件提供 DSH 工具：

• dsh_narrative_ledger_inspect
• dsh_narrative_ledger_verify
• dsh_narrative_ledger_query

插件还提供 proof-only stdio MCP server，工具名如下：

• narrative_ledger_inspect_inline
• narrative_ledger_verify_inline
• narrative_ledger_query_inline

MCP 只接受有界内联 manifest / event 字符串，不接受路径，也不进行文件系统、网络、进程或 artifact 写入。由于 MCP 不获得正典来源字节，inline 验证只报告 verified-structure，且 sourceBytesVerified: false。只有 DSH/CLI 的文件系统验证才能将正典来源报告为 fully verified。

0.2.0 使用 host-neutral namespace entry，没有私有 DSH runtime 依赖或默认导出，便于 stock Cordis Web loader 组合。

插件以当前 dsh 进程权限运行。安装前建议检查源码、依赖和 MIT 许可证，并确认其路径限制、写入范围和工具权限是否符合你的使用环境。

典型用法¶

examples/basic 示例说明一个简单连续性场景：Bob 在 sequence 2 不知道 key-location fact，只在 sequence 3 的披露场景中学会它。

下面的 verify 命令用于验证示例工作区、manifest 和事件文件，并将结果写入 artifacts：

dsh-narrative-ledger verify --workspace-root examples/basic --manifest narrative.manifest.json --events events.jsonl --artifact-dir artifacts

下面的 query 命令用于查询到 sequence 2 为止的状态：

dsh-narrative-ledger query --workspace-root examples/basic --manifest narrative.manifest.json --events events.jsonl --through-seq 2

这两个命令展示了 CLI 的基本用法：一个做验证与报告发布，一个做按序列号的查询或投影。

适用场景与注意¶

适合：

• 需要在 DSH 中检查叙事连续性，而不只是生成文本。
• 需要把时间线、正典来源、事实断言和角色知识做成可验证证据。
• 与 Novel Director、InkOS 等写作或状态管理工具组合使用。
• 需要在不复制稿件正文的情况下引用外部正典来源。

注意：

• 插件是证据层，不是小说生成器或写作提示包装。
• MCP 的 inline 验证只报告结构验证，不报告正典来源字节已验证。
• 文件系统验证需要通过 DSH/CLI 完成。
• 路径必须保持在 workspaceRoot 内，并拒绝符号链接。
• 插件不运行 shell、不发起网络请求，但只允许写入显式 artifactDir。

获取¶

插件目录页（独立站点）：

https://www.skillhub.cn/plugins/dongsheng123132/dsh-narrative-ledger

GitHub 仓库：

https://github.com/dongsheng123132/dsh-narrative-ledger