让开源，少一点语言距离。
npm包中文文档

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

中文文档
0.2.1-rc.5发布于 2026/11/01MITTypeScriptES Module

OpenWiki lifecycle tools (openwiki_begin/submit_plan/next_page/submit_page/finish) over the in-process engine @hy-sde-org/dsh-openwiki, plus an openwiki:tools prompt section wiring codebase-memory tools as structural discovery — no external CLI.

原始使用文档
中文原文
文档目录4 节
  1. Surface
  2. Configuration
  3. Agent preset
  4. License

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

Model-facing repository wiki lifecycle tools — openwiki_begin, openwiki_submit_plan, openwiki_next_page, openwiki_submit_page, openwiki_finish — that drive the deterministic openwiki 0.4 engine core (@hy-sde-org/dsh-openwiki) in-process. The five-tool contract and every model-facing description match upstream openwiki 0.4, so harness agents run the same resumable, claim-grounded wiki generation with no external openwiki CLI and with codebase-memory for structural discovery.

Surface

One Cordis agent-plane plugin (mounts as a preset or profile-patch row, injects tools + systemPrompt, registers no service of its own):

  • openwiki_begin — start or resume a durable run (.run.json) over a Git repository root; returns status=noop for clean updates.
  • openwiki_submit_plan — validate and durably persist the ordered PageJob queue; init requires /openwiki/quickstart.md, paths are normalized.
  • openwiki_next_page — first pending job with existing Markdown + Claims.
  • openwiki_submit_page — complete the current job by proving its complete Claim set against the written page (front matter repair then Claims resolution and durable verification).
  • openwiki_finish — deterministic finalization: planned/abandoned deletions, Mermaid validation, wiki index sync, link validation, generated provenance, Claims finalization + manifest replacement, run metadata, and .run.json removal.

Configuration

- 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

Agent preset

examples/agent-preset/ is a ready-to-copy DeepSeek Harness agent preset: the openwiki:tools prompt section is registered by this package, and pairing the row with @deepseek-ai/dsh-tool-codebase-memory gives agents structural discovery on top of the forced lifecycle sequence.

License

MIT — see the repository LICENSE. Tool-level wrappers keep the upstream openwiki protocol contract and model-facing descriptions (openwiki 0.4.3, Copyright (c) 2026 langchain-ai, MIT).

版本与发布记录

@hy-sde-org/dsh-tool-openwiki 共发布 9 个版本，首次发布于 2026/09/06；过去 12 个月发布了 9 个版本。

版本发布日期距今
0.2.1-rc.5latest2026/11/012 天前
0.2.1-rc.32026/10/259 天前
0.2.1-alpha.42026/10/1618 天前
0.2.1-alpha.22026/10/1321 天前
0.2.0-rc.22026/10/031 个月前
0.1.7-rc.22026/09/291 个月前

关于 @hy-sde-org/dsh-tool-openwiki 的常见问题

@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 和提交记录判断。