Files
deepseek-harness/packages/util/README.zh.md
T
turtle1999 3de3a977e0 feat(plugin-market): add the Custom plugin markets bundle and Discover tab
Read configured plugin market indexes on the Host, search them with fuzzy
multilingual matching, and install a chosen version from the Plugins page.

- dsh-plugin-market-index validates format-1 indexes and builds install
  arguments; inline icons are capped at 32 KiB.
- The pluginMarket service fetches configured http(s) URLs, parses bodies in
  a Worker Thread, caches documents, and pages filtered, ordered results with
  installation status and engines.dsh compatibility.
- Discover is an opt-in experimental bundle; the Plugins page gains a
  plugins.tab slot and confirmed installs.
- The plugin_market tool lists indexes, plugins, and versions for Creator mode.
- Plugin compatibility reads engines.dsh before DSH peer dependencies.
2026-10-15 05:37:44 +08:00

3.4 KiB

description, kind
description kind
共享工具家族的包映射:原子文件写入、品牌化 id、双端队列、JSON 值、harness 主目录路径、启动环境、原生命令、输出保留、时区与超时。 package-group

util/:共享工具

English | 中文

概述

util/ 组为能力包提供共享的机制原语,避免重复实现。它涵盖原子写入、品牌化 id、双端队列、无损 JSON 值、UUID、Harness home 路径、启动环境、出站代理策略、原生命令、输出保留、时区规范化和超时处理。这里的每个根入口都是库:它不注册产品服务或事件,业务语义仍由消费它的能力负责。

目录


包

每个包提供一个原语;打开对应包页面了解如何使用。

包 职责
brand/ 提供名义字符串类型及其无状态构造函数
package-manifest/ 包 manifest(元数据清单)的共享 TypeScript 声明
plugin-market-index/ 校验插件市场索引格式 1,并生成锁定版本的安装参数
crypto/ 基于跨运行时 crypto.getRandomValues 原语生成 RFC 9562 v4 UUID
deque/ 提供摊销常数时间的队列操作和有界空闲存储
chunked-list/ 通过有界追加复制和检查点校验保留不可变列表版本
values/ 校验、创建快照、比较和冻结无损 JSON 兼容值
home-paths/ 解析统一的 Harness 主目录并拼接共享的用户数据路径
http-proxy/ 解析出唯一的出站代理策略,并为 fetch、SDK agent(智能体)与 spawn 的子进程安装它
launch-environment/ 冻结的启动环境,记住每个值来自哪一层
atomic-write/ 原子文件替换与跨进程写锁
lazy-require/ 在首次使用时按调用方位置加载兼容 CommonJS 的 Host 依赖
native-command/ 直接运行宿主原生命令,绝不拼 shell 字符串
workspace-path/ 提供浏览器安全的 Workspace 路径与显示辅助函数
code-language/ 把文件名后缀映射为 Code 预览、diff 审阅与 read 卡片所渲染的语法高亮语言
output-retention/ 限制面向模型的输出并报告精确的省略元数据
time/ 校验并规范化调用方所报的 IANA 时区
timeout/ 截止时间运算、信号融合与超时和取消分类

相关文档

开发备注

维护者的工作上下文——点击展开

无。