dsh-lt-tasks

多窗口接力推进长期任务的 DeepSeek Harness 插件。

任务 = 持久文件夹（11 个存档文档 + 极简对接文档 + 锁），不绑定任何窗口；靠「极简对接文档（索引）+ 存档」交接，AI 按需定位文档，把长上下文 / 遗忘降到最低。

English

界面

功能

• 11 业务文档 + meta：meta（机器元数据）+ handoff / goal / frozen / tasklist / next / progress / refs / index / errors / blockers / review 共 11 个业务文档，一类内容一个文档。
• 极简对接文档：handoff.md 只存各文档完整路径 + 下次推进一句话，推进时 AI 按需 read，不通读。
• 多窗口接力：任何窗口「推进长期任务 xxx」→ 读 handoff 索引 → 按需定位 → 执行 → 存档，不依赖历史对话。
• 6 态状态机：筹划中 / 进行中 / 已暂停 / 已阻塞 / 待审 / 已完成。
• 并发锁：.lock（session + 时间戳），单窗口推进，超时可配。
• 参考资料只读：复制到 refs/ 后打 Windows 只读属性。
• 目录索引：index.md / refs.md 记录文件绝对路径 + Markdown 章节，可定位到文档内部。
• 任务完成度：tasklist 的 checkbox 自动统计完成/总数。
• 前端视图：左栏「任务」tab，分组折叠列表 + 搜索 + 详情抽屉 + inline 编辑 + 状态下拉。
• 任务↔对话关联：推进时记录对话 session，点任务详情自动打开对应对话。
• 输入框预填：点「＋」新建任务 / 详情页「＋新对话」时，自动在对话输入框预填引导语（请帮我新建一个长期任务： / 推进长期任务 xxx），不自动发送，补充要求后由你主动发送。
• 自成长：完成时生成归档建议，确认后写入知识库 / skill。

安装

1. 把本包放到 profile 可解析位置（如 ~/.dsh/profiles/node_modules/dsh-lt-tasks）。
2. 在 profile 的 cordis.patch.yml 追加：

- insert:
    - id: dsh-lt-tasks
      name: 'dsh-lt-tasks'

3. 重启 dsh web 后端。

配置

| 变量 | 默认 | 说明 | |---|---|---| | DSH_LT_TASKS_ROOT | ~/.dsh/lt-tasks/ | 任务库根目录（管理文档） | | DSH_LT_TASKS_LOCK_TTL | 24 | 锁超时（小时） |

用法

模型工具（9 个）

| 工具 | 作用 | |---|---| | create_task | 新建任务（筹划中），可选 refPath 复制参考资料到 refs/ 并只读 | | list_tasks | 列出所有任务及状态 | | get_task | 读某任务存档（meta + 9 个业务文档，blockers/review 需单独 read） | | advance_task | 推进：加锁、筹划中则置进行中，返回极简 handoff 索引 | | save_progress | 存档：写总结/改动/决策/阻塞（自动置 blocked）/审查，版本 +1，解锁 | | pause_task / resume_task | 暂停（解锁）/ 恢复 | | complete_task | 完成，生成归档建议（不自动写知识库） | | delete_task | 删除任务（连同文件夹，不可恢复） |

典型流程：create_task →（筹划）→ advance_task → 工作 → save_progress → … → complete_task。

目录结构

<DSH_LT_TASKS_ROOT>/<任务名>/
  meta.md / handoff.md / goal.md / frozen.md / tasklist.md / next.md /
  progress.md / refs.md / index.md / errors.md / blockers.md / review.md
  .lock
  works/v1, v2, ...   # 产出（按迭代版本，各窗口共享）
  refs/               # 参考资料（只读）

开发

plugins/lt-tasks/
├── lib/index.js      # host 入口：注册工具 + HTTP 路由
├── lib/store.js      # 任务存储、状态机、目录索引、原子写
├── lib/lock.js       # 并发锁
├── lib/readonly.js   # 只读属性
├── lib/tools.js      # 9 个模型工具
├── lib/routes.js     # HTTP 接口（/lt-tasks/*）
├── lib/client.js     # 前端「任务」视图
├── test.mjs          # 核心逻辑单测（node test.mjs）
├── package.json
└── cordis.patch.yml

• host 改动需重启 dsh 后端；client 改动刷新页面即可。
• 测试：node test.mjs。

License

MIT