powercontext-TS Related questions

[guozhihao-224]

进度

组件	范围	状态
协议	冻结 OpenAPI 中 52 个操作的类型定义与运行时校验	已完成
HTTP 客户端	52 个类型化方法；用于调用合规 Server（当前为参考实现）	已完成
确定性内核	规范 JSON、Unicode 规范化、身份哈希、UTF-8 字节计量、Analyzer v1	已完成，并与参考实现对照用例对齐
软件包发布	npm 正式版本	未发布（版本号 0.0.0）

能力域	功能说明	参考实现	本仓库
Memory 写入	显式写入 Memory 条目	已实现	实验实现
Memory 检索	按范围搜索	已实现	实验实现（仅全文检索；命中分数未按参考实现排序合同）
Memory 列举 / 读取	列举条目、按标识读取	已实现	实验实现
Memory 修订	修订已有条目	已实现	未实现
Memory 废止	废止条目并保留变更记录	已实现	未实现
Memory 抽取	由已捕获 Source 经模型抽出 Memory	已实现	未实现
Source 捕获	持久化内容源	已实现，并可衔接抽取	实验实现（仅追加单调位置，不触发抽取）
上下文准备	按字节预算生成 Agent 上下文	已实现	实验实现（按全文检索结果贪心装箱，不对齐参考实现装箱规则）
Work	工作契约、当前工作交接、任务结果记录	已实现	未实现
Handoff	交接稿生成与提交（激活、草稿、定稿、提交）	已实现	未实现
Skill	受管技能的提议、生成与读取；外部技能扫描与导入	已实现	未实现
Review	候选产物的批准、驳回与再修订	已实现	未实现
Handoff Report	交接报表项目、工作流、活动与工作区绑定	已实现	未实现
HTTP API	对外 HTTP 操作	52	实验实现 9
MCP	宿主可调用的工具	22	实验实现 5
命令行	进程启动、配置与诊断	已实现	未实现
Dashboard	管理界面	已实现	未实现

实验实现的 9 个 HTTP 操作：存活检查、就绪检查、能力声明、上下文准备、Source 捕获、Memory 写入、搜索、列举、读取。
实验实现的 5 个 MCP 工具：Source 捕获、Memory 写入、搜索、列举、读取。

职责	Python	Node
Unicode 规范化	unicodedata	本仓库实现（对齐参考实现，含 NFC）
UTF-8 字节长度	str.encode	TextEncoder / Buffer.byteLength
JSON 解析	json	JSON.parse；整数越界在解析前扫描文本
SQLite 引擎	SQLite 3 + FTS5	同一引擎；差异在驱动

职责	Python	预定 Node 替代
配置	pydantic-settings	本仓库显式配置对象 / 环境变量解析
进程调度	APScheduler	实施时专项选定
推理 / 抽取 / 生成	Pydantic AI	不移植 Pydantic AI；实施时对接官方模型 SDK 或本仓库端口
向量（SQLite）	sqlite-vec	实施时按参考实现 Vec1 合同专项；根目录 sqlite-vec 仅为扩展加载探针
OceanBase 向量	pyobvector	实施时用官方 Node/MySQL 驱动专项
指标	prometheus-client	实施时锁定 prom-client
追踪	OpenTelemetry（Python）	实施时锁定官方 @opentelemetry/*
HTML / Dashboard	Jinja2	Dashboard 不在当前范围
CLI	Typer + InquirerPy	实施时用本仓库命令入口（node:util.parseArgs 或单一 CLI 库）
路径/配置目录	platformdirs	实施时用 node:os / node:path 或等价 XDG 约定
评测平台	evaluation 独立依赖树	不移植

职责	Python	Node（本仓库）	版本/形态
Wire 校验	Pydantic	Ajv + ajv-formats；校验器由冻结 OpenAPI 生成	ajv ^8.17、ajv-formats ^3
HTTP Server	FastAPI + Uvicorn	Fastify	Fastify 5
MCP Server	FastMCP	官方 TypeScript MCP SDK	@modelcontextprotocol/server、node、fastify 均为 2.0.0；协议 2025-03-26
HTTP Client	httpx	运行时 fetch（Client 手写传输）	无额外 HTTP 库
规范 JSON	rfc8785（对照 0.1.4）	canonicalize + 本仓库严格输入与哈希封装	canonicalize ^2.1.0
SHA-256	标准库 hashlib	node:crypto createHash('sha256')	标准库
UUID	标准库	node:crypto randomUUID	标准库
SQLite 访问	aiosqlite + SQLAlchemy（asyncio）	node:sqlite DatabaseSync	Node 24 内置；实验 Runtime 使用
ORM / DDL	SQLAlchemy	手写 DDL + 独立库戳记	无 ORM
OpenAPI → 产物	datamodel-code-generator	openapi-typescript + 本仓库生成器	仅输出 packages/protocol/src/generated/