Skip to main content

How to use dsh-track

Embedded task management engine: decision-point protocol, idea capture wall, Linear-style issue store.

This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.

This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

Embedded task management engine: decision-point protocol, idea capture wall, Linear-style issue store.

— source: plugins.ai_summary

Install & verify

dsh plugin --profile web add @fakechris/dsh-track

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

  • 🧠 捕获墙（Capture Wall） —— capture_thought 零摩擦收录念头；规划时的 todo_write 也会被自动捕获，且每条都携带动机上下文（当时那条用户请求），永远不会变成"无来由的琐碎清单"。
  • ⚖️ 决策账本（Decision Ledger） —— 遇到不可逆 / 风险 / 范围 / 验收类决策，先上报决策点，用户轻决策回答，选择与理由落盘可查（回答率进 funnel）。
  • 📋 任务生命周期（Evidence-driven Lifecycle） —— Linear 兼容的任务模型；证据驱动的状态机，done / canceled 永不自动达成，必须用户确认。
  • 🔄 历史同步（History Sync） —— 一键把工作区过往会话折叠成 epic/issue 候选，默认 dry-run，确认后才落库。
  • 💰 LLM 用量账本（Usage Ledger） —— track 引擎自己调用的 LLM 费用（token / 成本）单独计量，"track 花了多少 token" 一句话可查。

— source: plugin_wiki.readme_en (fallback readme_raw)

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule