# @hy-sde-org/dsh-tool-openwiki 中文文档

规范地址：https://npmcn.com/package/%40hy-sde-org/dsh-tool-openwiki/

版本：0\.2\.1-rc\.5
npm 元数据更新时间：2026-11-01T04:25:08.254Z
中文译文更新时间：2026-11-01T09:21:02.443Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40hy-sde-org/dsh-tool-openwiki
原文对照：https://npmcn.com/package/%40hy-sde-org/dsh-tool-openwiki/?lang=original
项目主页：https://github.com/hy-sde/dsh-openwiki#readme
源码仓库：https://github.com/hy-sde/dsh-openwiki

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

- 包体积（解压后）：48.2 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：1 个
- peer 依赖：@deepseek-ai/cordis ~4\.0\.5，@deepseek-ai/dsh-tools ^0\.2\.1-rc\.5，@deepseek-ai/dsh-util-values ^0\.2\.1-rc\.5，@deepseek-ai/dsh-system-prompt ^0\.2\.1-rc\.5
- 首次发布：2026-09-06T03:19:44.418Z
- 最新版本发布：2026-11-01T04:25:08.076Z
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

OpenWiki生命周期工具（openwiki\_begin/submit\_plan/next\_page/submit\_page/finish）通过进程内引擎@hy-sde-org/dsh-openwiki，加上一个OpenWiki:tools提示部分，将代码库-内存工具连接为结构发现-没有外部CLI。

## 安装

```sh
npm install @hy-sde-org/dsh-tool-openwiki
```

也可以使用：`pnpm add @hy-sde-org/dsh-tool-openwiki`、`yarn add @hy-sde-org/dsh-tool-openwiki`、`bun add @hy-sde-org/dsh-tool-openwiki`

## README

# @hy-sde-org dsh-tool-openwiki

面向模型的存储库wiki生命周期工具 `openwiki_begin`， `openwiki_submit_plan`， `openwiki_next_page`， `openwiki_submit_page`， `openwiki_finish` -驱动确定性的openwiki 0.4引擎核心 （`@hy-sde-org/dsh-openwiki`） **进程内的**． 五工具合同和每一个 面向模型的描述与上游openwiki 0.4匹配，因此可以运行线束代理 相同的可恢复的，基于声明的wiki生成，没有外部 `openwiki` CLI和with `codebase-memory` 结构发现。

## 表面

一个Cordis代理平面插件（作为预设或配置文件补丁行挂载）； 注入 `tools` + `systemPrompt`，不注册自己的服务)：

-   `openwiki_begin` -开始或恢复持久运行(`.run.json`)超过一个Git 库根;返回 `status=noop` 为干净的更新。
-   `openwiki_submit_plan` -验证并持久保存已订购的PageJob 队列;初始化需要 `/openwiki/quickstart.md`，路径归一化。
-   `openwiki_next_page` -第一个悬而未决的工作与现有的降价+索赔。
-   `openwiki_submit_page` -完成当前的工作，证明它是完整的 索赔设置对书面页(前事项修复然后索赔 解决和持久验证)。
-   `openwiki_finish` -确定性终结：计划/放弃 删除，美人鱼验证，wiki索引同步，链接验证，生成 来源，索赔最终确定+清单替换，运行元数据，以及 `.run.json` 去除。

## 配置

```yaml
- id: tool-openwiki
  name: '@hy-sde-org/dsh-tool-openwiki'
  config:
    host: harness          # stable host identity recorded in run metadata
    producerActor: harness # provenance actor for engine-owned finalizers
```

## 代理预定

[`examples/agent-preset/`](https://npmcn.com/package/%40hy-sde-org/dsh-tool-openwiki/examples/agent-preset/) 是一个随时可以复制的DeepSeek 线束剂预置 `openwiki:tools` 提示部分由 此包，并将配对行与 `@deepseek-ai/dsh-tool-codebase-memory` 在强制生命周期序列之上为代理提供结构化发现。

## 许可证

MIT -参见存储库 [`LICENSE`](https://npmcn.com/package/LICENSE)． 工具级包装器保留 上游openwiki协议契约和面向模型的描述 （openwiki 0.4.3，版权(c) 2026 langchain-ai， MIT）。

## 常见问题

### @hy-sde-org/dsh-tool-openwiki 是什么？

OpenWiki生命周期工具（openwiki\_begin/submit\_plan/next\_page/submit\_page/finish）通过进程内引擎@hy-sde-org/dsh-openwiki，加上一个OpenWiki:tools提示部分，将代码库-内存工具连接为结构发现-没有外部CLI。

### 如何安装 @hy-sde-org/dsh-tool-openwiki？

在项目目录运行 npm install @hy-sde-org/dsh-tool-openwiki，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（~4\.0\.5）、@deepseek-ai/dsh-tools（^0\.2\.1-rc\.5）、@deepseek-ai/dsh-util-values（^0\.2\.1-rc\.5）、@deepseek-ai/dsh-system-prompt（^0\.2\.1-rc\.5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @hy-sde-org/dsh-tool-openwiki 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @hy-sde-org/dsh-tool-openwiki 支持 ESM 还是 CommonJS？

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

### @hy-sde-org/dsh-tool-openwiki 需要什么版本的 Node\.js？

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

### @hy-sde-org/dsh-tool-openwiki 可以商用吗？

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

### @hy-sde-org/dsh-tool-openwiki 还在维护吗？

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