前言¶
在 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 为准。