@listen1954/board 0.1.0 → 0.1.2

package/README.md

@@ -13,17 +13,51 @@ DeepSeek Harness 的统一看板：普通列和每个会话对应的任务列存
 | [docs/technical.md](docs/technical.md) | 技术：数据、工具、Remote、提醒 |
 | [docs/ui.md](docs/ui.md) | 交互：侧栏入口、会话芯片、编辑器 |
 
-当前已实现统一存储、旧会话 sidecar 自动迁移、四个工具、`ctx.board` Remote、提醒通知，以及 Web 侧栏「看板」+ 输入栏芯片/浮层。
-
-## 本地挂载
-
-```sh
-dsh plugin --profile web add "link:$(pwd)"
-dsh --profile web --dump-config   # 应出现 id: board
-```
-
-发布到 npmjs 后：
-
-```sh
+当前已实现统一存储、旧会话 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：
+
+```sh
+dsh plugin --profile desktop add @listen1954/board
+```
+
+独立浏览器版使用 `web` profile：
+
+```sh
 dsh plugin --profile web add @listen1954/board
-```
+```
+
+安装后请完全重启对应的 DSH 客户端。两个 profile 相互独立；只安装到 `web` 不会让 Desktop 自动加载插件。
+
+## 本地挂载
+
+桌面端：
+
+```sh
+dsh plugin --profile desktop add "link:$(pwd)"
+dsh --profile desktop --dump-config   # 应出现 id: board
+```
+
+独立浏览器版：
+
+```sh
+dsh plugin --profile web add "link:$(pwd)"
+dsh --profile web --dump-config   # 应出现 id: board
+```