dsh-design-ledger

大型游戏或软件项目往往在同一工作区里开发数月甚至数年，而单次对话的上下文容量有限。把整份设计文档塞进提示词并不现实：一份真实文档动辄十余万字、十万级 token，远超可持续注入的上限。dsh-design-ledger 把设计文档、进度清单与代码索引整理成可查询、可更新、可注入的结构化台账，让新开的会话不必从零读完全部材料，也能接着上次的进度往下做。

插件的核心是一张按层级组织的开发进度树：每个节点记录名称、状态、与设计文档的引用、代码符号索引、接口与 bug 等字段，并支持标记当前聚焦子树。注入策略分层处理：任务开启提示词与轻量索引、聚焦子树常驻上下文，其余子树、代码明细与文档原文由 design_ledger_read、design_doc_read 等工具按需读取，在信息完整与 token 预算之间取得平衡。设计文档既可从单个 Markdown 按标题建树，也可从带编号目录递归解析，还能把 design.md 里带 ID 列的功能表展开为可推进的功能节点。

台账记录的是实际在做的开发，而不是设计清单的镜像：自动生成只提供骨架与候选，真正要推进的功能在推进时按需建节点、更新状态与 code_refs，完成度才反映真实进度。注入走 system-prompt 装配，与 dsh-agent-instructions 注入 AGENTS.md 同一接缝；侧栏面板便于选择设计文档、查看与维护台账，界面文案跟随 DSH 的中英文语言设置。

适合在同一 DSH 工作区长期迭代、设计文档体量较大、且希望代理跨会话记住做到哪、焦点在哪、代码在哪的团队或个人开发者，尤其是目录型或表格型设计文档与模块划分清晰的项目。