@listen1954/board
v0.1.2
Published
Board for DeepSeek Harness: global and session scopes, natural-language tools, and a native Web UI.
Readme
Board
作者:listen
包名:@listen1954/board
DeepSeek Harness 的统一看板:普通列和每个会话对应的任务列存于同一块全局数据;会话入口只投影本会话列,人在 Web 里编辑,模型在对话里用自然语言查看和改。
设计口径(实现以这三份为准)
| 文档 | 内容 | | --- | --- | | docs/product.md | 产品:范围、隔离、模型体验 | | docs/technical.md | 技术:数据、工具、Remote、提醒 | | docs/ui.md | 交互:侧栏入口、会话芯片、编辑器 |
当前已实现统一存储、旧会话 sidecar 自动迁移、四个工具、ctx.board Remote、提醒通知、多标签管理与搜索,以及 Web/桌面端侧栏「看板」+ 输入栏芯片/浮层。标签属于整个看板,可为卡片贴多个标签,并统一改名、换色或删除;颜色提供红、橙、蓝、绿四种。
设置页支持隐藏会话输入栏的看板入口,以及添加供 Agent 调用看板工具时参考的自定义规则。新会话不会自动创建任务列,首次添加卡片时才按需创建。
Agent 操作协议
Agent 与界面使用同一个 Board 服务,所有看板读写只能通过以下公开工具完成:
board_list:查看全局/当前会话概览,并取得列、卡片和标签 ID。board_search:按用户描述查找已有任务并取得卡片 ID。board_get:读取已知卡片的备注、时间、标签和过程记录(含可用于删除的日志 ID)。board_apply:唯一写入口,创建、修改、移动、完成、恢复或删除任务、过程记录。
已有任务固定走 board_search →(需要详情时)board_get → board_apply;按列名新增任务走 board_list → board_apply。Agent 不应读取或修改插件存储 JSON、源码、安装目录或私有 HTTP 地址;接口失败时最多刷新并修正一次,仍失败就向用户报告,不得绕过接口直接改数据。
过程记录中的 http://、https:// 地址可直接用系统默认浏览器打开。删除过程记录时,其附带的图片和文件也会一并删除。
安装
DSH Desktop 使用 desktop profile:
dsh plugin --profile desktop add @listen1954/board独立浏览器版使用 web profile:
dsh plugin --profile web add @listen1954/board安装后请完全重启对应的 DSH 客户端。两个 profile 相互独立;只安装到 web 不会让 Desktop 自动加载插件。
本地挂载
桌面端:
dsh plugin --profile desktop add "link:$(pwd)"
dsh --profile desktop --dump-config # 应出现 id: board独立浏览器版:
dsh plugin --profile web add "link:$(pwd)"
dsh --profile web --dump-config # 应出现 id: board