npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

taskboard-workbench

v0.3.5

Published

agent team 任务工作台:零依赖核心(node:sqlite)+ CLI + 本地 Web 看板 + DSH 内嵌插件

Readme

taskboard-workbench

Agent Team 任务工作台:一个本地优先(local-first)的多项目任务看板, 零运行时依赖(node:sqlite),既可独立跑成 CLI + 本地 Web 服务,也能作为 DSH(DeepSeek Harness)内嵌插件挂进会话里,派发任务、回流证据、独立复验。


它解决什么

把「需求条目 → 看板派发 → CLI/agent 实际开发 → 证据回流 → 独立复验 → 人工验收」 这条闭环固化成可查询的数据与可重放的流程,而不是散落在聊天记录里。

  • 任务不是聊天:任务卡有状态机(backlog → todo → in_progress → in_review → done)、 乐观锁(--if-version)、认领锁与心跳、失败会计与熔断。
  • 证据留在卡上:评论、事件流、尝试记录、诊断信息都挂在任务上,可回溯。
  • 人工守住最后一道门:执行侧只能把卡推到「待验收」,done 必须由人确认。

功能概览

| 模块 | 内容 | | --- | --- | | 存储核心 | 零依赖 SQLite(node:sqlite);多项目 / 任务 / 需求条目;状态机、父任务、标签、负责人 | | 看板 | 列看板(列内拖拽排序)、关键词搜索、Markdown 呈现与内容安全过滤 | | 需求视图 | 需求条目列表化展示(行式列表 + 点击右侧抽屉看详情)、引入文件按文件夹树呈现 | | 执行编排 | 看板侧 CLI 执行器(如 cli:claude)、派发引擎选择、执行看护、通知订阅与唤醒 | | CLI | tb 命令(项目 / 任务 / 评论的 CRUD,JSON 输出 + 稳定退出码) | | DSH 插件 | dsh.bundle.patch + dsh.client(web 平台侧栏 / 布局 / 槽位注入),会话内「任务工作台」标签页 |

安装

作为 DSH 插件

dsh plugin --profile web add taskboard-workbench

插件通过 dsh.bundle.patch(cordis.patch.yml)与 dsh.client 注入到宿主; 需要宿主支持的 @deepseek-ai/dsh-client-ui-{layout,sidebar,slots}(已声明为可选 peer)。

装好后在 DSH 里打开「任务工作台」面板(地址以 /integrations/taskboard-workbench 结尾)。 只有这个形态拿得到宿主会话通道:GET /api/health 的 host.capabilities 非空, 「投给主会话 / 打开会话 / 派发团队」才可用。

验收这条链路(从 npm pack 产物装进全新隔离 profile,真宿主起会话): node tools/bench-market-install.mjs —— 11 项,含「独立进程无宿主通道」的反向对照。

从源码

git clone https://github.com/SilenZerOrz/taskboard-workbench.git
cd taskboard-workbench
dsh plugin --profile web add .

独立跑(不用 DSH)

npm start                      # 启动本地 Web 服务(默认监听本机端口)
node cli/tb.mjs project list   # 或用 CLI 直接操作

⚠️ 独立进程没有 DSH 宿主会话通道:/api/health 的 host.capabilities 恒为 null, 「投给主会话 / 打开会话 / 派发团队」不可用(界面按能力位置灰并常驻提示)。 看板、建卡、改状态、评审、人工收口照常可用。要投递或派发,请用上面的插件形态。

要求

| 项 | 值 | | --- | --- | | Node.js | >= 22.5.0(依赖 node:sqlite) | | DSH | >=0.2.1-rc.3(与 package.json#engines.dsh 一致);0.2.2-rc.3 真机验证通过 | | 运行时依赖 | 无(dependencies 为空) |

快速上手(CLI)

# 数据目录:--data-dir > $TB_DATA_DIR > 系统临时目录
export TB_DATA_DIR="$HOME/.taskboard-data"

node cli/tb.mjs project create --name "示例项目" --id demo
node cli/tb.mjs task create --project demo --title "跑通一次闭环" --description "验证一下"
node cli/tb.mjs task list --project demo
node cli/tb.mjs comment add 1 --body "证据:npm test 全绿"

CLI 约定:成功 stdout 输出 JSON(含 schemaVersion),退出码 0; 失败 stderr 输出 {schemaVersion, error:{code,message}},退出码 2/3/4/5。 并发编辑用 --if-version,版本不符返回 VERSION_CONFLICT(退出码 5)而不静默覆盖。

MCP 契约层(九个工具)

把「开局要读什么、规范长什么样、哪里有漂移、卡怎么建、进度怎么回填」做成 agent 可直接调用的接口, 让 Claude Code / Codex / Hermes 等外部 agent 不必靠人肉复制粘贴就能对齐同一份项目事实。

node src/mcp/server.mjs --data-dir "$TB_DATA_DIR"   # MCP 客户端作为子进程拉起(stdio)
node src/mcp/server.mjs --print-tools               # 只打印工具清单(调试用)
node src/mcp/server.mjs --read-only                 # **只读模式**:只暴露五件只读工具,写四件调用即 READ_ONLY_MODE
npm run mcp -- --data-dir "$TB_DATA_DIR"            # 同上,走 npm script

--read-only 是写工具的回滚开关(写路径出问题时的逃生口):tools/list 里不再出现 card_create / card_progress / requirement_upsert / requirement_change,直接调用返回 isError:true + code=READ_ONLY_MODE(不是「未知工具」,便于区分「开关生效」与「名字拼错」)。 不带该参数时行为不变(9 个工具)。

传输是 stdio + newline-delimited JSON-RPC 2.0(MCP stdio transport): 不占端口、不碰 :3080、不写 ~/.dsh/**、不需要重载宿主,每个 agent 会话一个进程。

只读五件

| 工具 | 用途 | | --- | --- | | flow_start | 开局第一步(S0):项目身份 + contract_version + 缺口(未归因卡 / 未绑定主会话 / 待确认候选)+ 下一步建议 | | project_info | 项目总览:任务与需求条目按状态计数 + 契约版本与基线是否漂移 | | norm_get | 取机器规范正文(flow / card-update / doc-editing / acceptance / project-defaults;norm="project" 读项目自有 <workspace>/AGENTS.md)+ digest | | requirement_list | 需求条目列表:条目 + 内容版本(乐观锁用)+ 每条下的卡数与完成数 | | workbench_audit | 漂移盘点:contract-stale / unattributed / unbound-session / candidate-flood 四类,各带计数、样例与处置建议 |

写四件(形状即约束)

| 工具 | 强制的形状 | 被拒的样子 | | --- | --- | --- | | card_create | 归因硬门:requirement 或显式 unattributed_reason(落审计)。新卡只能进 backlog | REQUIREMENT_REQUIRED / AUTHORIZATION_REQUIRED(backlog → todo 是人工授权) | | card_progress | evidence[] 非空(每项 {kind: file\|command\|url\|reading, ref, note?})+ norm_digest 必填(card-update 的 sha256) | EVIDENCE_REQUIRED / NORM_DIGEST_REQUIRED / NORM_STALE(回带最新正文)/ GOVERNANCE_AGENT_DONE | | requirement_upsert | 改条目必须带 expected_version(requirement_list 返回的 version) | MISSING_VERSION / VERSION_CONFLICT | | requirement_change | 先预览拿 change_id + 影响面 affected_cards,带 change_id + apply:true 才落地 | CHANGE_NEEDS_APPROVAL / CHANGE_ID_MISMATCH(预览后条目被改过即失效) |

四条红线仍然由门守,不是由纪律守:

  1. done 只能人点 —— card_progress 走执行侧状态门,写 done 直接 GOVERNANCE_AGENT_DONE;
  2. backlog → todo 是人工授权 —— card_create 只接受 backlog;
  3. 人工校验任务不得被执行侧改状态;
  4. 证据不能是「已完成」三个字 —— evidence[] 的形状就是判据;同一批证据重复回填会按 hash 去重。

契约档位:contract_version 目前仍是 warn 档(不符只落 contract-warn 审计、不阻断), 切 reject 要等观察期到点单独拍板;写工具的返回体里带 contract.verdict 让 agent 自己知道用没用旧规范。

数据源是同一个 taskboard.sqlite(--data-dir > $TB_DATA_DIR > 默认), MCP 不是第二份数据 —— 看板里看到的、CLI 改的、MCP 读的,是同一行记录。 tests/mcp-parity.test.mjs 守的就是这条:同一操作在 HTTP 与 MCP 上错误码与副作用必须同形。

同一个 server 还提供一个 MCP prompt taskboard.flow(prompts/list / prompts/get): 内容是当前项目的「开局装载块」—— 契约版本、门档、六类缺口、下一步该做什么、八步表与五条硬规则。 它与 CLI 的 tb-flow start 共用一个生成器,输出逐字节相同(tests/skill-flow.test.mjs 守这条)。

技能包(开局装载)

skills/taskboard-flow/ 是给 agent 读的主流程技能(八步 S0–S7 × 六栏:入口 / 前置门 / 判据 / 证据落点 / 失败处置 / 对应 FR),随包分发。它只教顺序与判据,不持有业务规则副本 —— 数据在 taskboard.sqlite,门在 src/mcp/ 与 src/core/,机器规范在 spec/norms/。

npm run flow -- start --data-dir "$TB_DATA_DIR" --project demo   # 打印开局装载块(档 A:整块贴进会话)
npm run flow -- start --json                                     # 同上,结构化输出
npm run flow -- snippet                                          # 打印档 B 的 AGENTS.md 片段
npm run flow -- check                                            # 自检 frontmatter 与八步完整性
node scripts/tb-flow.mjs start --cwd /path/to/repo                # 缺项目时按 cwd / 目录名猜

三种开局方式,按侵入性排序:

| 档 | 谁用 | 怎么做 | 要不要改宿主 | | --- | --- | --- | --- | | A 开局提示词 | 人在 dsh 主会话里新开一轮 | 贴 tb-flow start 输出;或 MCP 客户端取 prompt taskboard.flow | 不用 | | B 外部 agent 约定 | Claude Code / Codex 在项目仓库里开工 | 项目根 AGENTS.md 写「开工先跑 <taskboard>/scripts/tb-flow.mjs start」,片段用 tb-flow snippet 打印 | 不用 | | C 宿主自动注入 | dsh 会话创建即注入 | 未启用(须报批改 ~/.dsh/** 并重载宿主);接口形状见 skills/taskboard-flow/references/injection.md | 须报批 |

配置

| 环境变量 | 作用 | 默认 | | --- | --- | --- | | TB_DATA_DIR | SQLite 数据目录 | 系统临时目录(仅适合试跑,正式用请显式指定) |

项目级配置(工作区路径、审批策略、执行者选择等)在 Web 看板的「项目设置」里维护。

目录结构

index.js              DSH 插件入口(cordis patch 注入点)
lib/client.js         宿主侧客户端桥
cordis.patch.yml      dsh.bundle.patch
src/core/             存储、状态机、团队模板、执行编排、看护
src/server/           HTTP API 与事件流
src/host/             团队引擎与工具面
src/mcp/              MCP 契约层(stdio server + 九个工具:只读五 / 写四 + prompt taskboard.flow)
skills/taskboard-flow/ 主流程技能包(八步 × 六栏 + 每步 references + 错误码 + 装载说明)
scripts/tb-flow.mjs   `tb-flow` 开局装载块 CLI(start / snippet / check)
web/                  本地 Web 看板(app.js / tokens.css / index.html)
cli/tb.mjs            `tb` 命令行
spec/团队agent.md      团队契约(随包发布,供工作台里的 agent 读取)
spec/norms/           机器执行规范(运行时唯一真源,随包;manifest.json 带 sha256 digest)
tests/                `node --test` 单测
tools/                开发与验证脚本(不进 npm 包,除 seed/env-check)

测试

npm test          # node --test,全量单测
node --check index.js   # 语法自检(对每个源文件)
node src/mcp/server.mjs --print-tools   # MCP 工具清单自检

版本

见 CHANGELOG.md。对外首个版本为 0.1.0。

说明:docs/ 不随仓库发布

本仓库的过程文档(需求 / 计划 / 进度 / 验证 / 规范 / 发布 SOP 等)在本地维护, 不进入 git 与 npm 包(见 .gitignore)。仓库只发布可运行的代码与随包契约 spec/。

License

MIT