dsh-article-review 0.0.0-stage → 0.2.1-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -0,0 +1,3 @@
+# Bilingual consistency record: Git blob hashes.
+README.md: 3510103710d25575c2bcb73302f06b1e26577130
+README.zh.md: 7a5742733fb10dc452595dc964a8dc7198e499e2

package/README.md

@@ -1,3 +1,106 @@
-# Temporary Holding Version
+---
+description: "Read, annotate and revise Markdown manuscripts in DSH with AI proposals, word-level diffs and persistent review baselines."
+kind: "package-bundle"
+---
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# DSH Article Review
+
+English | [中文](README.zh.md)
+
+Read, annotate and revise Markdown manuscripts alongside your [DSH](https://github.com/deepseek-ai/deepseek-harness) conversation. AI submits revision proposals; you inspect the changes, accept or reject them, or request another revision.
+
+Across multiple revision rounds, each paragraph stays compared with **the last version you marked reviewed**, so you can see what still needs your attention.
+
+![Review an AI proposal with rendered and source differences](docs/screenshots/review-proposal.png)
+
+*Screenshots use fictional manuscripts; proposals include real model runs.*
+
+## Features
+
+- **Read and annotate** — highlights, underlines, comments and manuscript search.
+- **Revise with AI** — propose replacements, insertions or deletions; revise pending proposals. Supports headings, lists and tables.
+- **Track your review** — mark and lock reviewed paragraphs; track later changes.
+- **Compare versions** — word-level comparisons and exact Markdown source diffs.
+- **Review figures** — preview and propose replacements; keep before/after copies.
+- **Preview companion documents** — open the manuscript or workspace files in DSH’s native preview alongside the review.
+- **Manage references** — bind BibTeX, jump to citations and check new citation keys.
+
+<a id="installation"></a>
+## Install
+
+Supports DSH Web `0.2.1-alpha.4` and Desktop `0.2.0-rc.2`. Uses your existing model configuration.
+
+### Desktop App
+
+The App includes its runtime; no separate Node installation is needed.
+
+1. Open **Plugins** in the App's left sidebar, then click **Add plugin**.
+2. Paste the npm package name and version:
+
+   `dsh-article-review@0.2.1-alpha.2`
+
+3. After installation, click **Enable now** and follow any restart prompt.
+4. Choose a local workspace and open a conversation. In the right sidebar, choose **Read, annotate and revise**.
+5. Click **Browse workspace → Choose local file** to open a Markdown manuscript. The system dialog belongs to the App; the selected file must be inside this conversation's workspace. BibTeX and replacement figures use the same Desktop picker.
+
+Desktop uses its own `desktop` profile. Installing into the `web` profile does not install into the App. If you previously installed `@deepseek-ai/dsh-experimental-paper-review` from GitHub, uninstall that package in Plugins before installing the npm package above and restarting. Workspace review records in `.paper-review/` continue to be used. macOS Desktop has been exercised; see [platform requirements](docs/development.md#scope-and-compatibility) for Windows.
+
+Choose the official npm registry or the mainland China mirror. If the mirror has not synced this version, use the official registry. GitHub installation is also available as `github:Biogod2020/dsh-article-review#v0.2.1-alpha.2`. If GitHub times out, download the [prebuilt release archive](https://codeload.github.com/Biogod2020/dsh-article-review/tar.gz/refs/tags/v0.2.1-alpha.2) and enter its absolute local path in **Plugins → Add plugin**, without extracting or building it. Tags through `v0.2.1-alpha.1` retain the old package name; install one package name at a time.
+
+### Web
+
+Requires Node.js 22 (≥22.19) or 24+:
+
+```sh
+dsh plugin --profile web add 'dsh-article-review@0.2.1-alpha.2'
+dsh web
+```
+
+Restart a running Web profile after installation. For GitHub installation, use the prebuilt tag; `main` contains development source.
+
+## Start reviewing
+
+1. Choose **Read, annotate and revise** in the right sidebar and open a Markdown manuscript.
+2. Select text, annotate it, attach the notes to the conversation and send your request.
+3. In **Review changes**, accept, reject or request a revision; check the result and mark it reviewed.
+
+Accepting updates the manuscript and keeps your review baseline. Back up `.paper-review/` with the manuscript and exclude it from public Git history. Paragraph locks apply within this plugin.
+
+## Screenshots
+
+Select text and right-click to highlight or annotate.
+
+![Selection actions](docs/screenshots/select-text.png)
+
+Save annotations and attach revision requests to the conversation.
+
+![Annotations and highlights](docs/screenshots/annotate.png)
+
+Check review progress and jump to sections or paragraphs.
+
+![Review progress and navigation](docs/screenshots/review-outline.jpg)
+
+Compare two versions and see changed words directly.
+
+![Version comparison](docs/screenshots/versions-rendered.jpg)
+
+Preview PDFs, review figure replacements and browse references.
+
+![PDF preview](docs/screenshots/figure-pdf.jpg)
+
+![Figure replacement](docs/screenshots/figure-replacement.jpg)
+
+![Reference browser](docs/screenshots/references.jpg)
+
+Compact reading on narrow screens.
+
+<img src="docs/screenshots/narrow-zh-light.jpg" alt="Narrow-screen reading" width="360">
+
+## Documentation
+
+- [User guide](docs/user-guide.md) — operations and configuration.
+- [Development and compatibility](docs/development.md) — builds, tools and persistence.
+
+Edit Markdown manuscripts; figures support images and PDFs. See [other formats and platforms](docs/development.md#scope-and-compatibility).
+
+[MIT License](LICENSE)

package/README.zh.md

@@ -0,0 +1,106 @@
+---
+description: "在 DSH 中阅读、批注与修改 Markdown 稿件，查看 AI 提案、逐词差异及相对上次审阅的累计变化。"
+kind: "package-bundle"
+---
+
+# DSH Article Review
+
+[English](README.md) | 中文
+
+在 [DSH](https://github.com/deepseek-ai/deepseek-harness) 对话旁读论文、写批注、与 AI 逐段修稿。AI 提交修改提案，你查看差异、接受、拒绝或要求重写。
+
+经历多轮修改后，每段仍对照**你最后确认已审的版本**，待审变化一目了然。
+
+![查看 AI 提案的渲染效果与源码差异](docs/screenshots/review-proposal.png)
+
+*截图使用虚构稿件，含真实模型提案。*
+
+## 核心功能
+
+- **阅读批注**：高亮、下划线、评论与全文搜索。
+- **AI 修稿**：替换、增删和重写提案，支持标题、列表、表格。
+- **审阅进度**：标记、锁定已审段落，追踪后续变化。
+- **版本对比**：逐词对比与 Markdown 源码差异。
+- **图表审阅**：预览、提议换图，保留前后副本。
+- **配套文档预览**：使用 DSH 原生预览打开 Markdown、PDF、Office 等文件，保留当前审稿状态。
+- **文献管理**：绑定 BibTeX，定位引用，检查新增引用键。
+
+<a id="installation"></a>
+## 安装
+
+支持 DSH Web `0.2.1-alpha.4` 和 Desktop `0.2.0-rc.2`，沿用现有模型配置。
+
+### Desktop App
+
+App 自带运行环境，无需另装 Node。
+
+1. 在 App 左侧打开 **Plugins（插件）**，点击 **Add plugin（添加插件）**。
+2. 粘贴 npm 包名及版本：
+
+   `dsh-article-review@0.2.1-alpha.2`
+
+3. 安装完成后点击 **Enable now（立即启用）**，按提示重启。
+4. 选择本地工作区并打开一个对话，在右侧栏选择**阅读、批注与局部修改**。
+5. 点击**浏览工作区 → 选择本地文件**打开 Markdown 稿件。系统选择窗口属于 App，文件必须位于当前对话工作区内。BibTeX 和替换图片也使用同一 Desktop 选择器。
+
+Desktop 使用独立的 `desktop` 配置，安装到 `web` 不会同时安装到 App。若之前通过 GitHub 安装了旧包 `@deepseek-ai/dsh-experimental-paper-review`，先在 Plugins 中卸载旧包，再安装上述 npm 包并按提示重启；工作区中的 `.paper-review/` 审阅记录继续使用。macOS Desktop 已实测；Windows 要求见[支持范围与兼容性](docs/development.zh.md#scope-and-compatibility)。
+
+可选择 npm 官方源或中国大陆镜像。镜像尚未同步新版本时，先切回官方源。GitHub 安装地址为 `github:Biogod2020/dsh-article-review#v0.2.1-alpha.2`。若 GitHub 地址连接超时，可下载[预构建发行归档](https://codeload.github.com/Biogod2020/dsh-article-review/tar.gz/refs/tags/v0.2.1-alpha.2)，在 **Plugins → Add plugin** 中输入本地归档的绝对路径，无需解压或构建。`v0.2.1-alpha.1` 及更早 tag 保留旧包名，两种包名请选择一种安装。
+
+### Web
+
+需要 Node.js 22（≥22.19）或 24+：
+
+```sh
+dsh plugin --profile web add 'dsh-article-review@0.2.1-alpha.2'
+dsh web
+```
+
+安装后重启正在运行的 Web 配置。GitHub 安装请使用预构建 tag；`main` 是开发源码。
+
+## 开始审阅
+
+1. 在右侧栏选择**阅读、批注与局部修改**，打开 Markdown 稿件。
+2. 选中文字添加批注，附到对话输入框，发送修改要求。
+3. 在**审阅变更**中接受、拒绝或要求重写，检查后确认已审。
+
+接受提案更新正文，保留已审基线。审阅记录位于 `.paper-review/`，随稿件备份，勿提交公开仓库。段落锁仅约束本插件。
+
+## 操作截图
+
+选中文字，右键添加高亮或批注。
+
+![选区操作菜单](docs/screenshots/select-text.png)
+
+保存批注，把修改要求附到对话。
+
+![批注与高亮](docs/screenshots/annotate.png)
+
+查看已审进度，跳转章节与段落。
+
+![审阅进度与导航](docs/screenshots/review-outline.jpg)
+
+比较两个版本，直接查看字词变化。
+
+![版本对比](docs/screenshots/versions-rendered.jpg)
+
+预览 PDF、审阅换图、浏览文献。
+
+![PDF 预览](docs/screenshots/figure-pdf.jpg)
+
+![换图前后对比](docs/screenshots/figure-replacement.jpg)
+
+![文献浏览](docs/screenshots/references.jpg)
+
+窄屏也能顺畅阅读。
+
+<img src="docs/screenshots/narrow-zh-light.jpg" alt="窄屏阅读" width="360">
+
+## 文档
+
+- [使用指南](docs/user-guide.zh.md)：操作与配置。
+- [开发与兼容性](docs/development.zh.md)：构建、工具与持久化。
+
+编辑 Markdown 稿件，图表支持图片与 PDF。[其他格式与平台](docs/development.zh.md#scope-and-compatibility)。
+
+[MIT 许可证](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: paper-review
+      name: dsh-article-review