dsh-dlc

DLC 数字生命卡片协议 × DeepSeek Harness 原生插件 — 全量 TypeScript 重写。

一个文件夹，一段数字生命。dsh-dlc 把 DLC Protocol v3.0 的 Python 引擎整体重写为 TypeScript，以 Cordis 插件的形式长进 DeepSeek Harness：状态机常驻、命令即工具、叙事自动组装、记忆与状态本地持久化。

特性

• 状态机引擎（DlcEngine）：命令/触发词 → 状态转移 → 叙事编号 → 阈值 → diff，零自然语言，纯计算；
• 交互系统：命令加载、最长触发词匹配、/命令 与自然语言双入口、四类效果（modifier / state / narrative / command_narrative）、道具与库存（稀有度五档）；
• 叙事组装（NarrativeAssembly）：编号域分发（action / threshold / boundary / system / emergence）、管道操作（range / switch / cond / rand / interp）、legacy 兼容；
• 记忆系统：双核线性记忆 —— ChatlogStore（按日 JSONL · MD5 去重 · 原子写）+ TimelineStore（小时槽覆盖）+ MemorySearch（按日/区间/关键词检索）；
• 可插拔存储：StateStore 接口（文件 / 内存 / DSH storages 可替换）+ 导出/导入/备份；
• Cordis 插件化：ctx.dlc 服务 + 三个模型工具 + systemPrompt 提示段；
• 卡片格式 v3.0 兼容：card.json + engine/ + interaction/ + narratives/ + identity/ 结构不变，现有卡片即插即用。

架构

命令/触发词 → 状态机(executeCommand) → 叙事编号(NarrativeAssembly) → 阈值 → diff
    → dlc/change 事件 → 记忆(chatlog/timeline) → 状态(StateStore 可插拔)

src/
  types.ts        卡片 schema（zod）· 实体 · 事件类型
  entity.ts       实体状态 · 自然衰减
  modifiers.ts    修改器（add/set/multiply/state_set/batch_restore/flag_toggle/钳制/冷却/自动触发）
  thresholds.ts   阈值判定（操作符 + 冷却）
  card-loader.ts  卡片加载 · 版本兼容 · 模块索引 · 运行时上下文
  interaction.ts  命令与道具系统
  narrative.ts    叙事组装
  memory.ts       双核线性记忆 + 检索
  storage.ts      可插拔状态存储
  events.ts       dlc/change 事件
  engine.ts       DlcEngine 状态机
  tools.ts        tool-dlc 工具契约
  plugin.ts       Cordis 插件入口

快速开始

pnpm install        # 依赖（@deepseek-ai/* 通过 file: 链接 DSH 仓库）
pnpm test           # 30 项测试（引擎/交互/叙事/记忆/插件冒烟）
pnpm run build      # tsc 类型 + tsdown bundle → lib/index.js

作为 DSH 插件挂载

- id: dlc
  name: '@soli/dsh-dlc'
  config:
    cardsDir: /path/to/cards   # 缺省为包内 cards/
    defaultCard: my-card

挂载后模型获得三个工具：

阶段历史

与传统人格蒸馏 .skill 的区别

传统数字生命做法（如 colleague-skill 类项目）把一个人的素材蒸馏成一份静态 Skill： 采集（飞书/钉钉/邮件）→ 人格分析 → 人格固化 → 装进宿主。产物的本质是一次性快照—— 一本装订成册的传记，不会自己变化。

dsh-dlc 走的是另一条路——引擎化：

一句话：传统做法是把一个人蒸馏成一段文字，dsh-dlc 是把一个人做成一台会持续活着的引擎——蒸馏留存的是「当时」，引擎活着的是「以后」。

生态

• digital-life-card — DLC Protocol v3.0 官方协议（Python 参考实现，本项目的语义蓝本）
• cardforge — DLC 数字生命卡片编译器

License

MIT © 2026 soli0x4ea