dongsheng123132/dsh-narrative-ledger

Plugin插件 Native原生 ⭐ 2 MIT Memory & Knowledge记忆与知识库

用于DeepSeek Harness的可验证叙事状态、连续性与角色知识账本

Project Overview项目介绍

This is a DSH-native plugin that provides a read-only, verifiable story-state ledger for DeepSeek Harness. It is not intended to be a novel generator or writing prompt wrapper. Instead, it acts as a complementary evidence layer for machine-checkable narrative continuity, working alongside existing writing workflow tools like Novel Director and InkOS that manage rich story state. To install, run the one-line DSH plugin command dsh plugin --profile web add github:dongsheng123132/dsh-narrative-ledger.

The ledger verifies a range of narrative continuity properties, including content-addressed external canon sources, contiguous immutable event sequences, explicit fact assertions and retractions, and single-value contradictions like conflicting character locations. It also tracks character knowledge acquisition, detects stale or missing canon and invalid retractions, and outputs deterministic content-addressed JSON reports with atomic publication and SHA-256 read-back verification. It rejects prose, chapter, draft, prompt, and secret fields, blocks symlinks, and restricts writes to an explicit artifactDir.

The plugin ships three DSH tools: dsh_narrative_ledger_inspect, dsh_narrative_ledger_verify, and dsh_narrative_ledger_query. It also exposes a proof-only stdio MCP server that accepts bounded inline manifest and event strings, with no filesystem, network, or artifact writes. It requires Node.js 22 or newer to run, makes no shell calls or external network requests, and is released under the open source MIT license. Version 0.2.0 uses a host-neutral namespace with no private DSH runtime dependency, so it loads cleanly with the stock Cordis Web loader.

这是专为 DeepSeek Harness (DSH) 开发的原生插件,提供一个只读、可验证的故事状态账本。它不是小说生成器或写作提示工具,而是为现有写作流程工具补充了一个可供机器检查故事连续性的证据层,辅助保障叙事内容的一致性和可追溯性。

它可以验证基于内容寻址的外部规范源、连续不可变事件序列、明确的事实声明与撤回,还能检测单值矛盾、知识获取时序、缺失规范、无效声明等问题,最终生成可验证的确定性内容寻址 JSON 报告。

本插件需要 Node.js 22 及以上版本支持,可通过 DSH 插件命令一键安装,提供了三个 DSH 工具命令和基于标准输入输出的 MCP 服务器实现,采用 MIT 许可开源,运行时不执行shell也不发起网络请求。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 dongsheng123132/dsh-narrative-ledger 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DSH Narrative Ledger

CI MIT license Node.js 22+ Awesome DSH Plugins

A read-only, verifiable story-state ledger for 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 must remain inside workspaceRoot; symlinks are rejected. It runs no shell and makes no network requests. Only an explicit artifactDir may be written.

Install

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

DSH tools: dsh_narrative_ledger_inspect, dsh_narrative_ledger_verify, dsh_narrative_ledger_query.

The Codex plugin also exposes a proof-only stdio MCP server through .mcp.json: narrative_ledger_inspect_inline, narrative_ledger_verify_inline, and narrative_ledger_query_inline. MCP accepts bounded inline manifest/event strings only, never paths, and performs no filesystem, network, process, or artifact writes. Because canon source bytes are not supplied, inline verification reports verified-structure plus sourceBytesVerified: false; only DSH/CLI filesystem verification may report the canon sources as fully verified.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-routed-subagent 下一个 Next dsh-prompt-optimizer →