# @chainlesschain/session-core 中文文档

规范地址：https://npmcn.com/package/%40chainlesschain/session-core/

版本：0\.3\.27
npm 元数据更新时间：2026-11-08T17:27:17.492Z
中文译文更新时间：2026-11-09T13:04:04.354Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40chainlesschain/session-core
原文对照：https://npmcn.com/package/%40chainlesschain/session-core/?lang=original
项目主页：https://github.com/chainlesschain/chainlesschain#readme
源码仓库：https://github.com/chainlesschain/chainlesschain

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.6 MB，85 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：4 个
- 首次发布：2026-04-16T02:56:11.946Z
- 最新版本发布：2026-11-08T17:27:17.149Z
- 近 30 天下载量：2668（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

会话寿命周期、痕量存储、代理定义、闲置parker——由桌面和CLI共享(管理代理均等)

## 安装

```sh
npm install @chainlesschain/session-core
```

也可以使用：`pnpm add @chainlesschain/session-core`、`yarn add @chainlesschain/session-core`、`bun add @chainlesschain/session-core`

## README

# 会话核心

共享会话生命周期,跟踪,代理定义,内存,批准,沙盒, 进化接收,以及ChainlessChain桌面和 cLI(英语:CLI).

## 释放候选人

添加控件 `task.create` 建议/要求/v6连接合同, 交易草稿转换和恢复,以及内存输出 在现有本地交易中重新验证。 现有仅说明 赠款没有获得任务产生权;模式产生的草案仍然需要 当前内存授权和单独的本地预览/确认。 发布 ,并在 CLI 0.166.143 及其配对的 IDE 扩展前读回此包.

## 发布 0.3.25

添加边框交易目标事件日记, 签名的持久光标和 仅通过现有证据阅读器读取保留的历史网页。 风险 检查和行动收据与本地商业交易相配合. 保留漏洞、腐败和恢复数据库回归显然失败. 出版需要精确来源的Linux、Windows和macOS验证和 GitHub Actions OIDC; CLI 0.166.142 取决于这个版本.

## 发布 0.3.24

重用一个孤立的 Windows 本地 ACL 工人, 而不是启动一个进程 每次行动 每一个操作仍然读取当前的代号 和现场ACL, 检查路径身份,并关闭它的把手。 请求保留限定输入和 输出、独立删除期限以及请求特定响应绑定. 失败的工人被丢弃;许可失败从不重复使用缓存权限. Monotonic 最后期限可以容忍应用时钟的变化和一个稳定的孩子 工作目录允许呼叫者正常删除可支配的项目目录 . 国 际 `0.166.123` 针入此放出. 出版需要精确来源验证 在Linux上,Windows和macOS在GitHub Actions OIDC发布之前.

## 释放0.3.22

将 Windows PowerShell ACL 脚本模块的发现限制为内置 Windows 模块目录. 国 际 `0.166.117` 将此发布标为私有存储 ACL业务.

## 发布0.3.21

使用扩展的 Windows PowerShell ACL 操作来修复本地长路径 Windows路径在内部同时保留调用器-facing路径. 国 际 0.166.112 为本地快讯公司签名的"快讯"(Quick Ask)证据存储所标注此发布.

## 发布0.3.20

公布目标起草、证据、延期提案和草案 导入 API 作为公共软件包的切入点。 这些出口是主机的 呼叫申请中的授权和完成检查.

这个 `0.3.15` 增加业务目标合同,控制任务 说明行动和阅读器、离线风险规则和节省的项目风险 评议。 国 际 `0.166.90` 针入此确切版本。 在候选人准备时,npm 最近的情况是: `0.3.14`,用于提供单调审批 同步修订事件. 发布工作流程需要准确的CI, 在CLI前公布孩子,并核查公共档案字节.

软件包通过 `package.json`,包括: `./runtime-claims`, (中文(简体) ), `./evolvable-artifact`, (中文(简体) ), `./structured-evolution-memory`,以及届会、核准、政策和 东道产品使用的回收合同.

未发行的 DMM 基金会增加公开 `./scheduler-contract`, (中文(简体) ), `./scheduler-service`, (中文(简体) ), `./scheduler-runtime`, (中文(简体) ), `./scheduler-store`, (中文(简体) ), `./scheduler-source-path`, (中文(简体) ), `./private-storage` 财务报告和审定财务报表 `./host-storage-environment` 通用JS主机和无害环境管理消费者的切入点。 CLI 兼容条目 保留原图、配置、家用和本地司机组装. 共享运行时间需要实时授权和注入图像管理局 或明确选择的遗留图模式。 共享商店需要一个主机 驱动程序,一个单独的数据库文件和同步存储保护 打开后. `./scheduler-authority-resolver` 供应共享政策 具有拘束力的、不可更改的可用性检查和持久的保留。 这些 条目不装入 CLI 图形或配置堆栈.

`./goal-contract` 财务报告和审定财务报表 `./goal-repository` 定义已绑定、已版本的目标记录 和带有比较和扫描更新的存储适配器. `./project-goal-service` 将个人项目目标存储在东道主现有的本地 SQLite 数据库中, 立即重新检查当前主机身份和项目所有权 交易。 IPC无法启动工程或声称已核实完成. 预算和授权参考说明意图;执行必须仍然使用 该主机当前的授权和使用分类账。 完成核查 禁用,除非主机提供独立信任的检查器。 见 [执行进展情况](https://npmcn.com/package/docs/research/agents/dots-muse-mods-implementation-progress-2026-10-07.md) 用于当前边界、遗留相容性和测试证据.

`./project-goal-monitoring` 明确允许的个人项目风险 检查通过共享调度器。 本地项目交易承诺 核查证据和目标使用。 一个单独的 调度员分类账可以收回已承付的支票而无需再次审查或借记. 目标运行/时限、当前主要政策和当前项目所有权 在工作前和域承诺前重新检查。 手动请求ID绑定 持续到目标/控制/政策版本;新的意图可以约束新政策 不更改先前的重播身份。 计时器时段在停机后汇合 . 历史和最终结果重新验证所保存的核定风险证据.

桌面主机保护它单独的调度器数据库, 排出关于退出的工作, 并且从成功的主进程密码/获得监测身份 UKey 登录 管理者。 锁定或删除一个 UKey 并登录退出相关会话 . 装入默认的 DID 不认证会话 。 项目风险小组 披露明确的开始/停止/检查/状态控制并保存证据。 这是第一个 适配器运行定型规则,零模式使用;企业写道, 通知和独立目标完成仍然是单独的工作.

来源也出口 `./business-object-contract`: 不可更改的参考文献 项目、任务、文件、人员、决定和行动运行;有版本约束的行动 ;和动作运行包含证据参考的记录。 内容版本 使用 SHA-256 以排序对象键来覆盖 JSON 。 动作身份约束 源、范围、目标修订和输入文摘; 使用 不同的动作内容被拒绝 `assertBusinessActionReplay`。 。 。 .

这些合同不执行行动或给予许可。 主机还需要 权威身份、当前许可和批准检查,原子版 比较、耐久性能和经授权的证据阅读器。 匹配请求 当前一个结果未知时,摘要不允许重放 。 结构 有效运行记录不认证其证据或证明业务成功.

`./task-description-action-service` 增加了第一项具体的企业行动: `TaskDescriptionActionService` 更新 `project_tasks.description` 待定 个人起草/活动项目的任务。 本地的 SQLite 主机供应 当前 DID 和 私人严格/ 高度批准 , 有本地用户确认 . 服务检查所有权 和完整的行版 在批准后, 然后将编辑和 ActionRun 证据进行解剖。 组织/工作空间 任务和非本地数据库的倒置不支持。 一再援引 返回耐用收据;中断运行的收据仍未解决 从未自动重播。 收据读取了对当前所有权的重新检查 .

服务也提供有限度 `listTasks`, (中文(简体) ), `readTask`,以及 `listRuns` 实时项目任务小组的阅读器。 元数据及收件不装入 大型任务结果有效载荷。 未解决的运行屏蔽了相同程序的新动作 任务,即使有新的象徵键;重放原请求只读 它的持久收据。 工作空间资源协会遭到拒绝 个人专用适配器与组织域并列.

同一个模块的 `createTaskDescriptionPreview` 编写来自 离线快照并明确标出其权威 `unverified-snapshot`。 。 。 . CLI 曝光此准备路径, 而桌面主机则曝光直播 通过独立的IPC/预装方法进行动作。 现有任务编辑和遗产 CRUD路径并非全部被转换 。 见 [控制动作指南](https://npmcn.com/package/docs/research/palantir/controlled-task-description-action.md) 用于边界、引用实例、接收语义和焦点主机测试.

`./project-risk-evaluation` 出口 `evaluateProjectRiskSnapshot`,决定主义 对完整、有界限的项目/任务快照进行离线评价。 它的规则版本, 输入文摘和内容版参考支持可再生比较. 它针对具体风险的参考文献是选定的实地预测,而不是完整的 控制动作所需的数据库行版本。 评价均无 认证快照或批准某项动作或预测项目交付.

`./project-risk-review-service` 添加授权的桌面阅读器并持久 规则审查. `ProjectRiskReviewService({ db, getActor })` 读取当前 本地 SQLite 交易中所有者的个人项目, 评估选中 任务字段,并存储源快照和结果. `evaluate({ projectId })` 财务报告和审定财务报表 `getReview({ reviewId })` 返回时 `{ review, sourceSnapshot, evaluation }`。 。 。 . 历史读取重检查当前所有权并对照 决定性的评估者。 缺少一栏或任务数过多 明确不完整; 失败的 SQL 读取从未成为空成功 评价。 审查不是批准,也不受行动收据的约束. 见 [项目任务基准指南](https://npmcn.com/package/docs/research/palantir/project-task-review-workbench.md)。 。 。 .

```bash
npm test --workspace packages/session-core
```

工作树也出口 `./goal-extension-proposal-contract` 财务报告和审定财务报表 `./project-goal-extension-queue`. 共同提案合同映射SDK `task.description.update` 改为本地 `task.update-description` 当然. `ProjectGoalExtensionQueue` 需要信任的本地语言 `ProjectGoalWorkflow` (单位:千美元) 同步直播录用回调. 它存储待决建议,对 目前行为者、目标修订/控制生成、本土风险提案和准确性 复议文摘. 重复请求ID重放同一份草稿;更改了输入冲突. 重新检查来源和录用,包括禁用/重新启用后.

信任的主机可以调用 `prepareDraft({ id })` 将坚持不变的草案约束在其中 不可改变的转换、本土请求和意图ID。 崩溃后重新打开或 重试丢失的响应 恢复这些ID。 原生预览, 明确批准 行动证据保留准确的草稿/转换摘要 `extensionRef`。 。 。 . 安装同步 `verifyExtensionIntent` 回拨 `ProjectGoalWorkflow` 并授权给 `queue.verifyIntentInTransaction(context)` 使用前; 缺少 或同步核查者不能承认已转换的工作。 普通意图 重新检查现有补助金和来源,以确定有待完成的工作。 现有运行/地面 收据在撤销后仍可读取,不再执行.

源适配器接受描述建议并 `task.create` 草稿. 创建需要明确 `taskType` 从 `GOAL_EXTENSION_TASK_TYPES`· ; 说明性建议拒绝这个领域。 该类型通过SDK被固定 授权、等待储存、转换和本土意图完整性检查. `list({ goalRef, type: "task.create" })` 需要创建允许和返回 只创建草稿; 省略 `type` 保留只描述列表行为. 主办方必须独立授权每个实际的建议书类型. 桌面 内置规则使用单独的创建同意并保留现有的描述 授予身份。 这些是工作-树木添加;CLI v3在线桥和 v1描述文件收养合同仍只限描述. 资源助理 0.3.0 宣布创造能力;它仍然需要单独的本地权威. 分开 `chainlesschain.goal-task-create-request/v1` 文件合同使用 `createGoalTaskCreateRequest` 编号 : `validateGoalTaskCreateRequest` 从 `./goal-draft-request-contract`. 信任的本地进口商通过 `validateGoalDraftImportRequest`; 原件 `validateGoalDraftRequest` 还是 只接受描述文件. `ProjectGoalDraftImports` 单独确认 每个创建文件并绑入 `native-imported-task-create`,保留 最初的描述身份和防止旧的收养 创建。 请求身份、 完整任务类型/ 机构、 原始风险源、 撤销 时代、 本地预览和 ActionRun 仍然通过重启和重试绑定 . 插件只接收待决的等序端口;队列没有执行端口. 本地描述仅限于 8192 UTF-8 字节 转换前;转换记录限于8 KiB. 存储范围为每个演员/目标/插件100个草稿,每个记录48个基B,20个 候选人每页。 桌面的固定内置规则使用单独的本地规则 同意命名空间; 它没有建立 CLI 插件信任或活的 CLI 项目 连接。 这些出口需要相应的会话 核心儿童释放 在下游的 CLI 或桌面分布之前.

工作树也出口 `./project-goal-evidence-reader` 财务报告和审定财务报表 `./goal-evidence-contract`。 。 。 . `ProjectGoalEvidenceReader({ db, getActor, clock })` 提议 `readSummary(goalRef)` 财务报告和审定财务报表 `read(goalRef)` 准确的主动个人 项目目标。 它重新利用本土目标、风险检查和接受行动的完整性 通过内部只读的 SQLite 外观验证器。 本地语句 `readonly`编号 :`reader` 需要标记; 只有延迟读取的交易运行 . 建筑和阅读从未初始化计划,恢复动作或结算用法.

证据包括最新的持续核查(包括不完整结果)和 最后20个实际行动收据,由本地操作插入 `hasMore`。 。 。 . 最近的草稿无法隐藏收据 。 下落不明的仓库仍然没有,未知 风险仍然是无效的,开展中的行动仍未得到解决。 预测包含 限定的元数据只有明确的历史,没有任务机构或批准. 共享合同严格验证有界限的字段和格式的平面文字. 工作树还加了 `ProjectGoalEvidenceReader.readEventPage(goalRef, after)` 财务报告和审定财务报表 `validateGoalEventHistoryPage` 编号 : `parseGoalEventCursor` 从现有的 `./goal-evidence-contract` 输出。 本地监测和目标行动 商业交易中的事件,包括运行和终端行动 各州。 失败的附加将交易卷回 。 私人日记有 每名演员/目标序列单通、按键输入完整性、1 000个保留条目和 最多4096个持久重复身份。 没有任务,目标或记忆体被复制.

页面被授权只读查看精确的主动个人目标,最多 20个条目和16 KiB. 光标由连续的每个流键签名并绑定 演员、存储、目标修改和控制生成;它们生存在连接/服务器中 未成为授权而重新启动 。 驱逐、缺失记录、腐败或 恢复光标后的数据库显然失败 。 缺少日记存储 无法使用,不是空的。 只有新工具的本地交易才输入 日记:老客户端的旧数据和写作不会被回填. CLI 重放和 v5本土授权与v4最新snapshot观察者不同.

这是一个没有释放的 儿童包装改变。 精确源跨平台验证 而在下游CLI/IDE发布之前仍需要OIDC首次发布.

东道主仍必须提供目前经认证的身份和明确证据 同意; 桌面使用不同的能力约束连接而不是 扩大现有的简易租赁。 这些出口品尚未公布.

`./goal-draft-request-contract` 财务报告和审定财务报表 `./project-goal-draft-imports` 添加明确的 离线请求交接。 严格的信封包含一个已声明的插件标签, 申报文摘和准确版本的描述建议,共计16 KB 和8192 UTF-8字节描述限制. 既非消化认证插件代码 . `ProjectGoalDraftImports` 需要信任的本地工作流程和确认 调用。 它将每次收养都与现任本地演员,来源和准确 有效载荷; 队列使用固定的本地进口商身份 `user-edited` 源代码。 元数据无法选择特权插件或授予 .

通过和待通过的插入草案,通过 队列可信 `enqueueInTransaction` 组成条目。 再导入为 拒绝一能和相冲突的有效载荷,并失去反应/重新启动再利用 同样的身份依然存在。 撤销推进每个记录的时代,不能 被再次导入来解除 。 有待转换/执行 采用有效载荷和划时代;完成的历史保留。 本地主机必须 路由 已核实的导入草稿到此验证器并保存普通本地 预览/核准流程。 桌面提供明确的导入/列表/读取/预览/ 取消终点;现有读取租约中不增加在线写取权限.

`./goal-draft-connection-contract` 财务报告和审定财务报表 `./project-goal-external-drafts` 添加 独立 v3 在线待起草能力. `ProjectGoalExternalDrafts` 需要一个本地 `ProjectGoalWorkflow`; 只有信任的主机可以调用 `grant({ goalRef, access, expectedEpoch })` 未经当地人同意。 赠款持续存在 跨越断开/重新启动和绑定演员/仓库/项目/目标/完整的插件身份, 宣言摘要和时代。 CAS防止延迟同意撤销. 撤销无效旧的待起草和转换意图,同时完成 根据现有的商业许可,动作历史仍然可以读取.

`sourcePage` 扫描最多20个本地建议ID,没有计数. `enqueue` 插入仅待处理的草稿 来源和授权检查仍然适用. `submissionReceipt` 校验精确 请求/赠款和当前赠款,不要求来源保留 新鲜 这些读取操作使用延迟交易并支持 SQLite `query_only`; 写入使用即时交易。 未知/ 无效的证据失败 . 原生名单/阅读/准备方法继续现有的转换和行动 工作流程;没有HTTP调用器接收到准备,批准或执行权限.

同样的模块暴露了单独的创建配置: `validateGoalCreateDraftAccess`, (中文(简体) ), `validateGoalCreateDraftDescriptor` 财务报告和审定财务报表 `validateGoalCreateDraftProposal`。访问计划是 `chainlesschain.goal-create-draft-access/v1`;描述符是 `chainlesschain.project-goal-connection/v6`,能力 `goal.create-drafts`, (中文(简体) ), 结束点 `/goal-create-drafts`。请求/响应MAC使用独立的v6域. 现有的v3验证器、终点和赠款仍只限描述.

创建赠款的使用 `chainlesschain.goal-external-create-grant/v1` 与 `type: "task.create"`此外,他们的身份还包含行动, 保存遗留的捐赠身份证和记录形状。 目前的目标设定范围, 在等待写作和确认之前,先检查赠款的时间和来源. 通过草稿,转换和意图,任务类型是不可改变的. 撤销/计算 通过行动分开; 重复使用同一插件/目标/请求身份 行动冲突。 提交参考书目保留现有的无体能计划, 具有独特的赠与身份和提案摘要,对创作行动具有约束力. 未知的结果需要查找该身份,而无需自动再发送.

合同还验证了无身体,无证书的提交参考文献. 客户在发送和调节前必须坚持确切的要求身份 未知结果而不自动重发。 元数据散列确保一致性, 不是插件代码认证 。 这些出口仍未公布;下游 分配需要先释放相应的儿童包装.

### 原生目标模型输出授权( 只来源)

`ProjectGoalMemoryService.revalidateOutputInTransaction(token)` 重复 a/ 现有准确的目标/范围/沉积/版本/开发/赠款/划入/过期检查 信任的呼叫器同步本地交易 。 打电话不做交易 失败. `revalidateOutput(token)` 仍然是独立的包装;既不接受 缓存内存体或将模型槽添加到持续的内存权限中.

源桌面使用此守护器进行本地 Ollama 草稿管道的点取. 每个模式调用需要自己的本土同意,并有全部选定的输入. 默认内存关闭;同意只允许引用的本地处理. 在保存、列表/阅读、预览和个人中再次检查待决的模型输出 任务确认。 已过期/已撤销的内存无效未确认的产出;已完成 营业收入仍然是历史。 保留治理投入/答复证据 因此,这并不保证实际删除先前的拷贝.

共享 `GoalUsageLedger` 套接字发送和记录之前的储备未知 在通话之前使用。 记录了现有的即时/完成数 没有发明成本。 当前本地适配器无法可靠地保留一个符号 或货币上限,所以有限的象征性/成本预算拒绝发送。 现有 模式身份只查询; 重新启动或 `unknown` 再也不会自动打电话了. 这些是未公布的源添加;真实的模型质量、图形用户界面和业务效果 接受与合成协议和SQLite测试分开.

## 常见问题

### @chainlesschain/session-core 是什么？

会话寿命周期、痕量存储、代理定义、闲置parker——由桌面和CLI共享\(管理代理均等\)

### 如何安装 @chainlesschain/session-core？

在项目目录运行 npm install @chainlesschain/session-core，或使用 pnpm add / yarn add / bun add。

### @chainlesschain/session-core 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/chainlesschain\_\_session-core 是否存在。

### @chainlesschain/session-core 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @chainlesschain/session-core 需要什么版本的 Node\.js？

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

### @chainlesschain/session-core 可以商用吗？

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

### @chainlesschain/session-core 的下载量有多少？

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

### @chainlesschain/session-core 还在维护吗？

最新版本 0\.3\.27 发布于 2026/11/09（今天）；至今共发布 28 个版本，其中过去 12 个月发布了 28 个；首次发布于 2026/04/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。