Skip to content

Releases

wenlab 1.1.0

wenlab 1.1.0 Latest
Latest

Choose a tag to compare

View all tags
@basstal basstal released this 26 Oct 09:01
1.1.0
c7d7ed0

wenlab 1.1.0

wenlab 提供中文写作规范和只读 Markdown 审计工具，检查文件名、排版、结构、拼写、术语和链接，并生成诊断报告与格式修复预览。内容与表达仍需按写作规范由人或 Agent 审阅。

相对 1.0.0 的变化

  • RemoteGate 只有需要人工复核的外部链接结果（401、403、429、5xx、超时等 REVIEW）时，退出码由 1 改为 3，与文档质量问题区分。
  • 新增项目级配置 archiveLinks.enabled 与 archiveLinks.directoryNames：按配置的目录名识别指向归档文档的链接并列入 diagnosis.md，未配置目录名时不扫描。
  • 移除 Vale 的 AbsolutePaths 规则；以 / 开头且目标不存在的链接改由 lychee 报告。
  • npm 依赖改为从公网 npm Registry 安装，不再要求访问仓库作者的本地 Nexus 仓库，步骤见下文。
  • wenlab-docs-audit Skill 支持以单个文件为审计范围，按文章类型选择适用规范，并统一汇报结构。
  • 测试不再依赖 Python 编写的 HTTP 夹具。

下载文件

  • wenlab-1.1.0.zip：完整项目源码，包含隐藏配置目录、写作规范、审计脚本、测试和 Agent 技能。解压后得到 wenlab-1.1.0/；不含 Git 历史、npm 依赖、原生工具和临时报告。
  • wenlab-docs-audit-bin.zip：Windows 原生工具包，包含 AutoCorrect 2.16.3、rumdl 0.3.0、Vale 3.24.0 和 lychee 0.24.2 四个 .exe 文件。与 1.0.0 发布的文件相同，SHA-256 未变。
  • wenlab-docs-audit-bin-licenses.zip：上述四个工具对应版本的上游许可证文本及项目第三方许可说明，请与工具包一并保留和分发。与 1.0.0 发布的文件相同。
  • SHA256SUMS.txt：上述三个 ZIP 的 SHA-256 校验值。

GitHub 自动生成的 Source code 压缩包也可用于获取源码；原生工具需另外下载本页的工具包。

Windows 使用步骤

先准备 Node.js 22.18.0 或更高版本、Git 和 PowerShell。以下命令假设三个 ZIP 均已下载到当前目录，且解压目标目录尚不存在。

  1. 解压项目、工具及许可证：

    Expand-Archive .\wenlab-1.1.0.zip -DestinationPath .
Expand-Archive .\wenlab-docs-audit-bin.zip -DestinationPath .\wenlab-1.1.0\tools\docs-audit\bin
Expand-Archive .\wenlab-docs-audit-bin-licenses.zip -DestinationPath .\wenlab-1.1.0\tools\docs-audit\bin\licenses
Set-Location .\wenlab-1.1.0

    工具 ZIP 内没有外层目录。解压后应直接存在 tools/docs-audit/bin/autocorrect.exe、lychee.exe、rumdl.exe 和 vale.exe。Gate 优先使用该目录中的工具，无需手动加入 PATH。

  2. 从公网 npm Registry 安装固定版本的 npm 依赖 CSpell 10.3.6 和 Prettier 3.9.9：

    Set-Location .\tools\docs-audit
npm install --no-package-lock --registry=https://registry.npmjs.org/ --ignore-scripts --include=dev
Set-Location ..\..

    源码中的 package-lock.json 指向仓库作者的本地 Nexus 仓库，公网环境无法访问，因此安装时用 --no-package-lock 忽略它。CSpell 和 Prettier 本身按固定版本安装，它们的间接依赖从公网重新解析。

  3. 检测依赖并执行本地检查：

    node ./tools/docs-audit/Check-Dependencies.mjs
node ./tools/docs-audit/LocalGate.mjs

    依赖检测全部通过后再运行 Gate。默认检查本项目 docs/。检查其他项目，或在发布前检查外部网址，可分别运行：

    node ./tools/docs-audit/LocalGate.mjs -Path ../your-project
node ./tools/docs-audit/RemoteGate.mjs -Path ../your-project

Gate 退出码：

  • 0：通过。
  • 1：文档质量问题。
  • 2：缺工具、版本不符，或配置、执行、报告故障。
  • 3：只由 RemoteGate 返回，表示只有需要人工复核的外部链接结果。

报告位于 wenlab 根目录的 .tmp/docs-audit/，先查看当次报告的 diagnosis.md。检查不会修改原文。

项目专有词可写入被检查项目的 .wenlab/dictionary.txt；排除项、归档链接检查及规则覆盖可写入 .wenlab/docs-audit.json。完整参数和配置说明见源码包中的 README.md、docs/依赖安装说明.md 和 docs/Markdown-审计入口.md。

工具 ZIP 仅包含 Windows 可执行文件；其他系统需自行预置相同版本的原生工具。Node.js、Git、npm 依赖和可选的 Beyond Compare 均不包含在工具 ZIP 中。

发布验证

发布源码对应 GitHub 提交 c7d7ed05df8fde1324194e402977813872b32154，其文件树与本地提交 7749f5af432338146c8b3564a96716f07d22abee 完全一致。

已通过依赖检测、LocalGate 和全部五组回归测试：编排契约、真实工具、审阅包、项目词典和项目配置。

项目原创代码与文档采用 MIT 协议；第三方工具保留各自许可证，详见源码中的 THIRD-PARTY-NOTICES 和随附许可证包。

Assets 6
Loading

wenlab 1.0.0

wenlab 1.0.0

Choose a tag to compare

View all tags
@basstal basstal released this 25 Oct 01:26
1.0.0
2a8f27d

wenlab 1.0.0

wenlab 提供中文写作规范和只读 Markdown 审计工具，检查文件名、排版、结构、拼写、术语和链接，并生成诊断报告与格式修复预览。内容与表达仍需按写作规范由人或 Agent 审阅。

下载文件

  • wenlab-1.0.0.zip：完整项目源码，包含隐藏配置目录、写作规范、审计脚本、测试和 Agent 技能。解压后得到 wenlab-1.0.0/；不含 Git 历史、npm 依赖、原生工具和临时报告。
  • wenlab-docs-audit-bin.zip：本地原始 Windows 工具包，包含 AutoCorrect 2.16.3、rumdl 0.3.0、Vale 3.24.0 和 lychee 0.24.2 四个 .exe 文件。
  • wenlab-docs-audit-bin-licenses.zip：上述四个工具对应版本的上游许可证文本及项目第三方许可说明，请与工具包一并保留和分发。
  • SHA256SUMS.txt：上述三个 ZIP 的 SHA-256 校验值。

GitHub 自动生成的 Source code 压缩包也可用于获取源码；原生工具需另外下载本页的工具包。

Windows 使用步骤

先准备 Node.js 22.18.0 或更高版本、Git 和 PowerShell。以下命令假设三个 ZIP 均已下载到当前目录，且解压目标目录尚不存在。

  1. 解压项目、工具及许可证：

    Expand-Archive .\wenlab-1.0.0.zip -DestinationPath .
Expand-Archive .\wenlab-docs-audit-bin.zip -DestinationPath .\wenlab-1.0.0\tools\docs-audit\bin
Expand-Archive .\wenlab-docs-audit-bin-licenses.zip -DestinationPath .\wenlab-1.0.0\tools\docs-audit\bin\licenses
Set-Location .\wenlab-1.0.0

    工具 ZIP 内没有外层目录。解压后应直接存在 tools/docs-audit/bin/autocorrect.exe、lychee.exe、rumdl.exe 和 vale.exe。Gate 优先使用该目录中的工具，无需手动加入 PATH。

  2. 通过 Nexus 安装固定版本的 npm 依赖 CSpell 10.3.6 和 Prettier 3.9.9：

    Set-Location .\tools\docs-audit
npm ci --registry=https://nexus.home.arpa/repository/npm-group/ --ignore-scripts --include=dev
Set-Location ..\..

    此步骤需要能访问上述 Nexus 仓库。Nexus 不可访问或缺少制品时，记录包名、版本及错误后停止，不切换其他源。

  3. 检测依赖并执行本地检查：

    node ./tools/docs-audit/Check-Dependencies.mjs
node ./tools/docs-audit/LocalGate.mjs

    依赖检测全部通过后再运行 Gate。默认检查本项目 docs/。检查其他项目，或在发布前检查外部网址，可分别运行：

    node ./tools/docs-audit/LocalGate.mjs -Path ../your-project
node ./tools/docs-audit/RemoteGate.mjs -Path ../your-project

Gate 退出码：0 表示通过，1 表示文档质量问题，2 表示工具、配置或执行故障。报告位于 wenlab 根目录的 .tmp/docs-audit/，先查看当次报告的 diagnosis.md。检查不会修改原文。

项目专有词可写入被检查项目的 .wenlab/dictionary.txt；排除项及规则覆盖可写入 .wenlab/docs-audit.json。完整参数和配置说明见源码包中的 README.md、docs/依赖安装说明.md 和 docs/Markdown-审计入口.md。

工具 ZIP 仅包含 Windows 可执行文件；其他系统需自行预置相同版本的原生工具。Node.js、Git、npm 依赖和可选的 Beyond Compare 均不包含在工具 ZIP 中。

发布验证

发布源码对应 GitHub 提交 2a8f27dcec5eb5a71ec870d434b03346942730a6，其文件树与本地提交 6a64ab037b3179b1750021d82a1b4bef56f1a3a3 完全一致。

已通过依赖检测、LocalGate 和全部五组回归测试：编排契约、真实工具、审阅包、项目词典和项目配置。

项目原创代码与文档采用 MIT 协议；第三方工具保留各自许可证，详见源码中的 THIRD-PARTY-NOTICES 和随附许可证包。

Loading