@xihe-lab/tapd-core
v2.1.0
Published
Shared kernel for TAPD tools: tool definitions, TapdClient and registry, shared by CLI and MCP entries
Readme
@xihe-lab/tapd-core
TAPD 研发协作工具的共享内核:沉淀 TAPD 全部工具定义、HTTP 客户端与工具注册表,供 @xihe-lab/tapd-cli 与 @xihe-lab/tapd-mcp-server 复用。单独安装本包通常没有直接用途。
安装
npm install @xihe-lab/tapd-core能力概览
- 工具定义:
src/tools/按 TAPD 领域组织——需求(story)、缺陷(bug)、任务(task)、迭代(iteration)、Wiki、附件、评论、用户、工作区、发布、看板、工时、报表等,统一收敛为allTools - HTTP 客户端:
TapdClient,支持 Bearer Token(fromAccessToken)与 Basic Auth(fromBasicAuth)两种认证 - 只读缓存:workitem_types / workflow / 成员 / 自定义字段配置 / settings 系 / 分类 / 角色等低频 GET 内置 TTL 缓存(LRU + 并发去重 + 深拷贝返回);
TAPD_CACHE=off关闭(默认开)、TAPD_CACHE_TTL全局倍率、TAPD_CACHE_DEBUG=1命中日志,invalidateCache(workspaceId?)显式失效 - 工具注册表:
ToolRegistry,负责工具注册、执行、审计(AuditEvent)与写策略裁决(resolveWrite) - 配置:
config.ts提供配置加载/保存与注入环境变量 - 富文本:
richtext/语义库,md ↔ html 双向转换与@/附件锚点处理 - Schema 导出:
exportSchemas导出工具 JSON Schema
仓库与镜像
- GitHub(主):https://github.com/xihe-lab/tapd-core
- Gitee 镜像:https://gitee.com/xihe-lab/tapd-core
