前言¶

在 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