@gfgghgftgffg/rpiv-todo-lean

中文文档
0.1.14发布于 2026/11/11MITES Module构建来源已验证近 30 天下载 2315

@juicesharp/rpiv- todo:任务和依赖性依然存在.

中文使用文档
文档目录7 节
  1. 优点
  2. 功能
  3. 来源
  4. 使用方法
  5. 安装
  6. 上下文占用(字符代理)
  7. 开发

@gfgghgftgffg/rpiv-todo-lean

English

优点

为 @juicesharp/rpiv-todo 提供更轻量的封装。任务、依赖、批量创建和 /todos 都还在,首轮就要带上的工具注册文本大约少 77%。

功能

  • 模型只看到一个 todo 工具:create、update、list、get、delete、clear。
  • 省略 action 时,带 subject 按创建处理,带 id 和可改字段按更新处理。其余情况由上游报错。
  • 字段、校验、持久化和按会话隔离仍在上游引擎里。/todos 仍可用。

来源

门面来自 kunkun9527/rpiv-todo-lean。引擎是 juicesharp/rpiv-todo。本包跟随上游发布,不复制引擎。两者都是 MIT,本包保留原始 LICENSE。它属于 amox-pi-extensions-lean。

使用方法

建一条任务。只写 subject 即可:

{ "subject": "Inspect the cache" }

一次建多条:

{ "action": "create", "tasks": [{ "subject": "Inspect" }, { "subject": "Test" }] }

把一条标成完成。有 id 再加一个字段,就是更新:

{ "id": "1", "status": "completed" }

列出、读取、删除,或清空:

{ "action": "list" }
{ "action": "get", "id": "1" }
{ "action": "delete", "id": "1" }
{ "action": "clear" }

新任务一开始是 pending。分几步做时,保持一条为 in_progress,做完改成 completed。list 不显示已删除的任务。clear 清空列表并重新编号。依赖用 blockedBy。其余字段见上游文档。

安装

这是公开的 npm 包,安装时不固定版本:

pi install npm:@gfgghgftgffg/rpiv-todo-lean
pi update --extensions

需要 Git 回退安装时,在仓库 checkout 根目录执行:

node scripts/install-extension.mjs rpiv-todo-lean

本地 Git 安装通过拉取 checkout 并重跑安装脚本更新,pi update 不更新本地内容。只保留一种安装来源。迁移时先备份 settings,移除 pi list 显示的精确旧来源,再安装 npm 来源。请勿同时加载其它 rpiv-todo 包装扩展。

上下文占用(字符代理)

PackageRegistered character proxy
@gfgghgftgffg/rpiv-todo-lean277
@juicesharp/rpiv-todo1222

Fixed ceil(characters / 4), not provider billing tokens.

开发

开发检查与维护策略;适配细节见 MAINTENANCE.md。

版本与发布记录

@gfgghgftgffg/rpiv-todo-lean 共发布 12 个版本,首次发布于 2026/10/17;过去 12 个月发布了 12 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.14latest2026/11/115 天前
0.1.132026/10/3016 天前
0.1.122026/10/2719 天前
0.1.112026/10/2720 天前
0.1.102026/10/2621 天前
0.1.92026/10/2522 天前

关于 @gfgghgftgffg/rpiv-todo-lean 的常见问题

@gfgghgftgffg/rpiv-todo-lean 是什么?

@juicesharp/rpiv- todo:任务和依赖性依然存在.

如何安装 @gfgghgftgffg/rpiv-todo-lean?

在项目目录运行 npm install @gfgghgftgffg/rpiv-todo-lean,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:typebox(*)、@earendil-works/pi-ai(>=1.1.0)、@earendil-works/pi-tui(>=1.1.0)、@earendil-works/pi-coding-agent(>=1.1.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gfgghgftgffg/rpiv-todo-lean 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/gfgghgftgffg__rpiv-todo-lean 是否存在。

@gfgghgftgffg/rpiv-todo-lean 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@gfgghgftgffg/rpiv-todo-lean 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@gfgghgftgffg/rpiv-todo-lean 可以商用吗?

@gfgghgftgffg/rpiv-todo-lean 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gfgghgftgffg/rpiv-todo-lean 的下载量有多少?

根据 npm 官方下载统计,@gfgghgftgffg/rpiv-todo-lean 在 2026/10/17 – 2026/11/15 这 30 天内被下载 2,315 次,日均约 77 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gfgghgftgffg/rpiv-todo-lean 还在维护吗?

最新版本 0.1.14 发布于 2026/11/11(5 天前);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/10/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。