dsh-local-board:DSH 左侧导航里的本地 Markdown 看板

前言

在 DeepSeek Harness(DSH)里做智能体或长会话开发时,任务往往分散在对话记录、临时笔记和外部工具之间。换一台机器或换一个 profile,很难用同一份数据结构继续跟进。社区插件 dsh-local-board(仓库 Finalbingo/dsh-local-board)把 Todo / Doing / Done 三列看板嵌进 DSH 左侧导航,数据落在你自选的目录下的一个 Markdown 文件里,便于备份、手改,以及在对话里通过 kanban 工具读写。

下面按「是什么 → 能做什么 → 怎么装上并用起来 → 注意点」说明,事实以仓库 README 与 SkillHub 目录页 为准。DSH 生态强调「一切皆插件」;SkillHub 是社区目录,与 DeepSeek / 幻方无官方从属关系。

这是什么

dsh-local-board 由维护者 Finalbingo 发布,分类为客户端插件(@deepseek-ai/dsh-client-ui-sidebar 注入侧边栏)。当前 package 版本为 1.5.5,许可证 MIT。

一句话定位:本地待办看板,按项目组织,三列流转;首次使用选一个文件夹,看板在该目录生成 看板.md,任务全部写在这个文件里。你可以把目录放在 Obsidian 仓库、网盘同步目录或 U 盘,整夹拷贝即可迁移。

核心功能

界面与操作

  • 左侧导航常驻入口,点开为整页看板。
  • 三列看板支持卡片拖拽在列间流转;也可拖到左侧项目名上更换所属项目。
  • 每个项目有状态(进行中 / 暂停 / 已结束,左侧圆点颜色区分)和角色(我负责 / 需跟进 / 仅知晓)。
  • 卡片字段:负责人、优先级、截止日期(精确到分钟)、备注、颜色标记、私密打码(默认遮罩,点击后显示)。
  • 逾期标红、当天到期标橙。
  • 顶部「打开文件夹」可在 macOS 访达中定位数据目录(README 原表述为访达;其他平台以实际客户端行为为准)。
  • 支持搜索、按截止日排序、新建 / 重命名 / 删除项目;删除会归档到文件末尾,可恢复。

数据与 Agent

  • 面向 Agent 提供 kanban 工具,可在对话中直接读写看板。
  • 存储格式为纯 Markdown,可用任意编辑器打开修改。

macOS 定时提醒(其他平台无「自动化」标签)

安装后在 macOS 上会自动创建三个 LaunchAgent,可在面板「自动化」里改时间或停用:

任务 默认 内容
每日摘要 每天 09:00 今天到期(按时间排序)+ 已逾期
临近提醒 每 30 分钟 仅当 2 小时内有卡片到期时提醒,同一条不重复
周回顾 每周一 09:30 上周完成、进行中、待办、逾期

macOS 隐私策略可能阻止定时任务读取 ~/Documents 等受保护目录;插件每次保存会向 ~/.dsh/kanban/board-snapshot.md 写快照,任务读不到原文件时使用快照。

已知边界:同一台机器同一时间只支持一个数据目录的定时提醒;多 profile 各配不同目录时,仅最后一次配置的目录会收到提醒。换目录可在面板里重新选择,任务会跟随;不需要提醒可在「自动化」里停用,看板功能不受影响。

安装与启用

SkillHub 上的安装方式为:在 dsh-local-board 目录页 使用「发送给 DeepSeek Harness 安装」,让当前 Harness 读取并完成 Finalbingo/dsh-local-board 的安装。资料中未给出单独的 dsh plugin add … 命令行原文,此处不自行拼接。

插件以当前 DSH 进程权限运行,安装前建议阅读 GitHub 源码与 LICENSE,确认是否符合你的安全与合规要求。

数据目录

第一次打开看板时会提示选择一个文件夹;路径保存在:

~/.dsh/kanban/settings.json

也可在 profile 的 cordis.patch.yml 里固定目录,跳过选择界面:

- id: kanban
  config:
    vaultDir: '/你的/路径/看板'

选定目录后,插件会在其中生成 看板.md。

典型用法

Markdown 文件结构示例(摘自 README,含插件约定的标记):

## 童话镇守卫战

- 角色: 我负责
- 状态: 进行中

### Todo
- [ ] 修好泡泡糖发射器 · @小呆呆 · #P1 · 📅2026-11-12 14:30 ^k-a1

### Doing
- [ ] 特训菲菲的魔法棒 · 🎨blue · @菲菲 · 📝周三下午在糖果广场集合 ^k-a2

### Done
- [x] 把怪兽赶出糖果森林 · ✅2026-11-05 ^k-a3

约定摘要:

  • 🎨 后为颜色名:red / orange / yellow / green / blue / purple / gray。
  • 🙈 表示界面默认打码。
  • ^k-xxxxx 为稳定 ID,请勿删除。
  • 将 [ ] 改为 [x] 表示完成。

日常可以只在 DSH 面板里拖拽、编辑;需要批量整理或脚本处理时,直接改 看板.md 即可。与 Agent 协作时,通过对话调用 kanban 工具同步任务状态。

适用场景与注意

适合谁

  • 希望任务与 DSH 会话同屏、又不想把数据锁在云端 SaaS 的开发者。
  • 已有 Obsidian 或 git 管理笔记习惯、需要「文件即数据」可迁移方案的用户。
  • 在 macOS 上需要到期摘要、临近提醒、周回顾,且能接受「单目录提醒」限制的用户。

平台

看板本体跨平台;定时提醒依赖 launchctl,仅 macOS 生效。

权限与安全

插件随 DSH 运行,能访问你配置的数据目录及 ~/.dsh/kanban/ 下的设置与快照。自选目录时请避免把敏感内容目录误设为同步到不信任的环境;私密打码仅影响界面展示,Markdown 源文件仍须由你自己控制访问权限。

结尾

dsh-local-board 把三列看板、项目维度和 Agent 可用的 kanban 工具收进 DSH 侧边栏,核心数据是你目录里的 看板.md。若要从社区入口安装或查看更新说明,可看 SkillHub 目录页;实现细节、自动化与 Markdown 约定以 GitHub 仓库 README 为准。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜