JohnXu22786/task-board

README excerpt

dsh-slate · 工作石板 跨会话的工作台账插件：任务/议题的登记、跟踪、状态流转与完成记录，全部以 事件溯源 方式落盘——每条操作都是一条不可磨灭的追加事件，历史可完整追溯，任何会话打开同一块石板都能接续工作。 - 零运行时依赖（纯 Node.js ESM，仅 TypeScript 编译产物） - 以 DeepSeek Harness（dsh）bundle 形式分发，也可作为独立 CLI 使用 - 石板摘要自动注入每轮模型上下文（systemPrompt 段） - 内置优先级、截止日、逾期判定、看板导出、git 提交关联 目录 - 概念 - 快速开始（CLI） - 接入 dsh - 工具一览 - 查询语言 - 数据与存储格式 - 配置项 - 技能文件（可选） - 完整示例 - 故障排查 - 开发 概念 术语 说明 石板（board） 一个持久化的条目集合，位于某个数据目录，有名称与编号前缀 条目（item） 石板上的最小工作单元（任务/议题/待办），编号如 S-0001 流水（journal） 追加式事件日志（ events.jsonl ），石板状态的唯一事实来源 快照（snapshot） 物化状态的周期缓存（ snapshot.json ），加速启动，可随时删除重建 结算（settle） 条目进入终态： fulfilled （完成）或 withdrawn （撤销） 撤销（undo） 追加一条补偿事件，抵消该条目的最近一次操作（登记与撤销本身除外） 状态机 设计要点 - 只追加、不修改：任何写操作都是一条新事件，旧事件永不改变。 - 崩溃安全：每条事件写入后 fsync；崩溃中断留下的半行在打开时自动丢弃并告警。 - 可审计： show / ledger 可回看每个条目或整块石板的完整操作序列（谁、何时、做了什么）。 - 多写者：长驻进程（dsh）不占写锁，CLI 使用写锁；每次读操作前自动与磁盘同步，追加前自动对齐磁盘序号。 快速开始（CLI） 要求：Node.js ≥ 20.6。 完整命令表见 slate --help （含通用参数 --home / --by / --json / --help 说明）。 接入 dsh 插件形态 本包以 dsh 标准 bundle 分发： 入口模块约定与 dsh 官方文档一致： apply() 内完成：宿主版本守卫 → 配置校验 → 打开石板（后台异步，不阻塞加载）→ 注册 13 个 slate 工具 → 注册 slate-digest 提示词段。任何注册随插件卸载自动清理（ ctx.effect ）。 安装 要求宿主 dsh 版本提供 @deepseek-ai/dsh-tools = 0.1.0-rc.6 （ @deepseek-ai/dsh 0.1.0-rc.6 及以上； next 发行线已验证）。 启动日志…

Category