EiffelBS/dsh-plugin-ideas-manager

dsh-plugin-ideas-manager

创意管理器将创意待办列表直接带入 DSH Web GUI。它是一个通用的、自包含的待办列表：AI 智能体捕获创意，每个创意成为看板上的一张卡片，经过评分和排名，并流经一个生命周期，直到被交付或拒绝。当存在 TaskBoard 插件（@linxin666/dsh-client-ui-task-board，由 linxin666 开发——第三方，无关联）时，它还会与之桥接。

一个由 Host 权威管理的 /api/ideas 账本保持一切一致，并允许智能体直接通过 HTTP 写入卡片——无需 UI。在没有 TaskBoard 的情况下也完全可用：对它零硬依赖。

创意管理器看板

它能为你做什么

随时随地捕获创意
- 一个侧边栏入口（New Session → Ideas）打开该面板。
- 使用 New idea 按钮或 Open 列顶部的快速添加行来捕获一个创意——Title 是唯一必填字段。
- 可选的描述（markdown）、标签、工作区和建议排名。
- AI capture 按钮会打开一个新会话，分析草稿，在待办列表中创建/合并该创意，并报告保留的排名。

一个 4 列看板
Open · Under review · Archived · Declined。
- 拖放可在列之间移动卡片并重新排序；当你向边缘拖动时，列会自动滚动（在窄窗口中当 Archived/Declined 在屏幕外时，会垂直和水平滚动）。
- 搜索和合取标签过滤器可缩小列的范围。
- 单击卡片标题或正文会打开编辑模态框（原始文本或渲染后的 markdown）。
- 每张卡片都会显示其稳定的 #N 编号、工作区标签、标签、价值/工作量徽章和更新日期。

评分与排名
- 每个创意都带有价值和工作量（低 / 中 / 高），以颜色编码的徽章显示。
- 建议排名是其工作区开放待办列表中的位置；输入一个排名会以事务方式重新排列待办列表（现有行会移动）。
- 一个专门的 Priorities 标签页按工作区对开放创意进行排名，并提供 ↑/↓ 按钮和拖放来重新排名。

生命周期
- Deliver ✓ 会归档该创意，并盖上绿色的 Delivered {date} 印章。
- Under review 是 recette 关卡：已完成的工作会进入那里，每张卡片都提供 Recette OK（交付）、Follow-up needed（创建一个关联的开放子项以及理由，并归档父项）和 Decline。
- Delivered 标签页显示退出日志（已交付 vs. 手动归档）。
- 每张卡片上都可以一键恢复、归档和删除。

工作区
- 标题选择器可将看板限定到一个工作区（或 all / none）。
- 当未限定时，新创意默认使用当前会话的工作区。
- New/Edit 模态框带有一个工作区字段，因此捕获的创意会落到正确的位置，并且创意可以移动到另一个工作区。

TaskBoard 集成

当 TaskBoard 插件
（@linxin666/dsh-client-ui-task-board，
仓库：zhu1090093659/dsh-web）存在时，
Ideas 管理器会将其账本镜像到 TaskBoard 的 backlog，使两个工具保持同步——单向（Ideas → TaskBoard）。
该镜像在运行时检测（GET /api/task-board/state）；如果 TaskBoard 不存在，Ideas 管理器就独立运行。

| Ideas 操作 | TaskBoard 镜像 |
|---|---|
| 创建 idea | 在 backlog 中新建只读卡片（绑定到 idea id） |
| 更新 idea | 卡片更新 |
| 拒绝 / 拖到 Archived | 卡片归档 |
| 恢复 | 卡片恢复 |
| 删除 | 无操作（关闭为 done 仍为手动） |
| Task-Board 卡片到达 done | Idea 自动移动到 Under review（recette 关卡） |

分诊（评分、理由、排名）仅属于 ideas，从不镜像——它是 backlog 的意见，而非看板状态。

面向 agent 驱动工作流的说明： capture → triage → lifecycle
协议以及完整的通信契约记录在
SKILL.md 中，因此 agent 可以直接通过 HTTP
API 编写卡片，而无需 UI。

Host API（agents）

Host 暴露了一个 REST API，以便脚本和 agent 可以读取看板并写入
ideas。前缀 /api/ideas，同源防护（loopback socket + 浏览器
标记），JSON 信封 { requestId, action, initiator? }。

| 路由 | 用途 |
|---|---|
| GET /api/ideas/state | { schemaVersion: 1, revision, ideas[] } |
| POST /api/ideas/action | create、update、move、decline、deliver、followUp、triage、restore、delete、reorder、import、export |
| GET /api/ideas/events | SSE { revision } |

每个操作都按 requestId 去重（每次调用使用新 id），并且
变更操作会返回整个看板，以便调用方确认结果。
完整契约（动词表、镜像映射、PowerShell 注意事项）位于
SKILL.md。

安装与更新

从 npm 安装（推荐）：

dsh plugin --profile web add dsh-plugin-ideas-manager

固定到某个版本：

dsh plugin --profile web add dsh-plugin-ideas-manager@0.2.6

从本地检出安装（无需 registry）：

dsh plugin --profile web add link:/path/to/dsh-plugin-ideas-manager

从 git URL 安装（后备方案，固定到已发布的 tag）：

dsh plugin --profile web add github:EiffelBS/dsh-plugin-ideas-manager#v0.2.6

dsh plugin 会在 profile 目录中运行 pnpm add，然后协调
dsh.profile.bundles：由于此包声明了 dsh.bundle，它会
被自动追加为一个 profile 层。重启 web 实例（或打开一个新的
页面会话）以使 bundle 更改生效。

验证安装：

dsh web --profile web --no-open   # then look for the Ideas entry in the sidebar

要在发布后获取更新的修订版本（版本号遵循该包的
version 字段；发布版本会打标签，例如 v0.2.6）：

dsh plugin --profile web add dsh-plugin-ideas-manager@latest

然后重启 web 实例。

卸载 / 禁用：

dsh plugin --profile web remove dsh-plugin-ideas-manager

维护者： 每次有意义的推送时都要提升 package.json 中的 version，这样
已安装配置的版本才能保持可观测（例如通过 dsh plugin ls 或
配置目录中的 pnpm list）。

构建、测试与安装（开发）

pnpm run typecheck   # tsc --noEmit
pnpm test            # vitest（协议门禁、账本持久化、导出黄金测试、镜像、markdown 解析器）
pnpm run build       # tsc -p tsconfig.build.json（类型 -> lib/types）&& tsdown（lib/index.js + lib/client.js）

隔离的测试配置（绝不使用运行中实例的生产配置）
dsh --profile ideas-test --from-default-profile web --dump-config
dsh plugin --profile ideas-test add link:C:/path/to/dsh-plugin-ideas-manager
dsh --profile ideas-test --port 3099                # 省略 --no-open 会用带 token 的 URL 打开浏览器

浏览器端部分通过 /plugins//client.js 提供（每次请求都会重新解析）；
宿主端部分在启动时注册 /api/ideas 路由。

架构

src/
index.ts            # apply + mountOnce + Config + 指导部分
protocol.ts         # /api/ideas 前缀、类型、parseActionEnvelope（exactKeys）
host-service.ts     # apply + 镜像调度
host-ledger.ts      # 持久化账本、去重缓存、锁、内部绑定
host-routes.ts      # state / action / events + 回环保护
taskboard-bridge.ts # 运行时特性检测 + 单向镜像（无硬导入）
export-markdown.ts  # 单向账本 -> markdown（黄金测试）
http.ts / loopback.ts / mount-once.ts   # 共享规范
core/ideas.ts       # IdeaRecord、状态、标签校验
client/             # 侧边栏入口 + 看板 + Priorities/Delivered + 工作区作用域
tests/                # 每个模块的 vitest 测试套件
SKILL.md / README.md

持久化位于 ~/.dsh/ideas/ledger-v2.json（原子 tmp+rename 写入、
损坏隔离、单写入者锁、重启安全的请求 ID 去重）。

许可证

MIT — 参见 LICENSE。