# paperskills **Repository Path**: dongfangW/paperskills ## Basic Information - **Project Name**: paperskills - **Description**: paperskills:文献检索/下载/OCR/翻译/图谱/写作技能集(Claude Code / DSH 插件,npm: @dongfangw/paperskills) - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: https://www.npmjs.com/package/@dongfangw/paperskills - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-01 - **Last Updated**: 2026-11-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # paperskills 文献检索 / 付费墙下载 / 知网研究 / OCR 翻译 / 知识图谱 / 学术论文写作与评审的完整技能集(32 个 skill + ARS 学术写作子系统 + 13 个快捷命令/prompt)。 **双智能体兼容**:同时支持 [Claude Code](https://code.claude.com)(CC)和 [Pi](https://github.com/badlogic/pi-code) 两个 AI 编程智能体。 > **文档格式(1.1 起)**:写作类技能(`academic-paper` / `deep-research` / `adr-writer` / > `implementation-plan` / `academic-paper-reviewer`)的交付物统一为 **AsciiDoc(`.adoc`)**, > 不再产出 Markdown 文档;渲染走 `.adoc → HTML/PDF/DOCX`,只有期刊投稿才生成 LaTeX。 > 规范见 `ars/shared/adoc_authoring_standard.md`,门禁/构建见 `ars/shared/scripts/adoc_tool.py` > (`lint --strict` + `build --format html,pdf,docx`)。 --- ## 仓库与发布渠道 | 渠道 | 地址 | 用途 | |---|---|---| | **GitLab**(主库,内部) | 内部地址不公开 | 日常开发:分支、MR、评审 | | **Gitee**(源码发布) | | 对外源码分发,`main` 每次更新由 CI 自动镜像 | | **npm**(包发布) | [`@dongfangw/paperskills`](https://www.npmjs.com/package/@dongfangw/paperskills) | DeepSeek Harness 插件(自包含 32 技能 + 文献工作台 UI) | Gitee 镜像由 `.gitlab-ci.yml` 的 `mirror-gitee` job 在 `main` 更新后自动强推(需 CI 变量 `GITEE_TOKEN`、`GITEE_REPO`)。 CI 不可用时手动补推: ```bash git push --force "https://oauth2:${GITEE_TOKEN}@gitee.com/${GITEE_REPO}.git" HEAD:main git push --force "https://oauth2:${GITEE_TOKEN}@gitee.com/${GITEE_REPO}.git" --tags ``` --- ## 安装 ### Claude Code ```bash git clone https://gitee.com/dongfangW/paperskills.git ~/paperskills ``` 在 Claude Code 中(任意项目): ``` /plugin marketplace add ~/paperskills /plugin install paperskills ``` > 也可以尝试 `/plugin marketplace add https://gitee.com/dongfangW/paperskills.git` 跳过手动 clone。内网同事可改用内部 GitLab 地址(不在此公开)。 安装后技能带 `paperskills:` 命名空间(如 `paperskills:academic-paper`),也可用 `/paperskills:` 直接调用。 ### Pi ```bash # 方式一:本地路径安装 git clone https://gitee.com/dongfangW/paperskills.git ~/paperskills pi install ~/paperskills # 方式二:直接通过 git URL 安装 pi install git:https://gitee.com/dongfangW/paperskills.git ``` 安装后技能出现在 `/skill:` 命令列表中(如 `/skill:cnki-search`),描述匹配触发不受影响。 ### 更新 ```bash cd ~/paperskills && git pull # Claude Code /plugin update paperskills # Pi pi update --extensions ``` --- ## DSH 插件(DeepSeek Harness,带 UI) 本仓库同时打包了一个 **DSH 插件** `@dongfangw/paperskills`(`dsh/` 子目录),把技能集 + 文献工作台 Web UI 带进 DeepSeek Harness,覆盖文献检索/下载/转MD/翻译/入库/阅读/笔记/写作全流程。与 Claude Code / Pi 插件多格式共存,`skills/` 单一来源。 ```bash # npm 安装(发布后推荐;包内自带 skills/ 与 ars/shared,无需仓库其余文件) dsh plugin --profile web add @dongfangw/paperskills # 再把 @dongfangw/paperskills 加进 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles # 或者从本仓库源码安装 cd paperskills/dsh bash scripts/install.sh # 装进 web profile(也可 bash scripts/install.sh headless) ``` 装完**重启 `dsh web`**。会话顶部会出现「**文献工作台**」标签页(文献库 / 检索 / 笔记 / 活动四面板), 并提供 `paperskills_library` / `paperskills_local_search` / `paperskills_arxiv_fetch` / `paperskills_convert` / `paperskills_translate` / `paperskills_note` 六个宿主工具。 需要把文献工作台与其它工作台隔离成独立 profile 时,用 `dsh plugin --profile paperskills add <本目录>`。 详见 [`dsh/README.md`](dsh/README.md)。 --- ## 双智能体架构 本仓库同时维护两套技能入口,共享同一知识体系但适配不同智能体的工具链: ``` paperskills/ ├── skills/ ← CC 版技能(32 个),使用 MCP 工具(chrome-devtools / Playwright / shell) ├── pi-skills/ ← Pi 版技能(9 个),使用 Pi 原生工具(cnki_search / scihub_download / mineru_convert …) ├── prompts/ ← Pi prompt templates(13 个),等价于 CC 的 /ars-* 斜杠命令 ├── commands/ ← CC 斜杠命令(13 个) ├── agents/ ← CC 自定义 Agent ├── ars/ ← 学术写作共享子系统(CC/Pi 通用) ├── .claude-plugin/ ← CC 插件清单 └── package.json ← Pi Package 清单 ``` **技能分类**: | 类别 | 位置 | 数量 | 说明 | |------|------|------|------| | **A 类** — Pi 原生适配 | `pi-skills/` | 9 | Pi 有等价原生工具,适配版更精简、无 MCP 依赖 | | **B 类** — 双端通用 | `skills/` | 23 | 纯 LLM 编排技能,CC/Pi 下行为一致,无需适配 | | **C 类** — 快捷入口 | `prompts/` (Pi) / `commands/` (CC) | 13 | `/ars-full` 等快捷触发 | **A 类技能 Pi 工具映射**: | 技能 | CC 依赖 | Pi 原生工具 | |------|---------|-----------| | `cnki-search` | MCP chrome-devtools | `cnki_search` | | `cnki-download` | Playwright + KDH 转换 | `cnki_download` | | `literature-fetcher` | arXiv API + shell 脚本 | `scihub_download` + `doi_verify` | | `scihub-batch-download` | Sci-Hub shell 脚本 | `scihub_download` | | `mineru-converter` | MinerU shell 脚本 | `mineru_convert` | | `paper-translate` | DeepSeek shell 脚本 | `paper_translate` | | `paper-graphifier` | 图谱 shell 脚本 | `paper_graphify` | | `nudt-library-fetcher` | Playwright + NUDT SSO | `cnki_download` + `scihub_download` | | `paper-download-triage` | 多渠道路由 | Pi 原生工具决策树 | > **设计原则**:`package.json` 声明 `"skills": ["./pi-skills", "./skills"]`,Pi 加载时 `pi-skills/` 中的同名技能优先于 `skills/`,确保 Pi 用户拿到的是原生工具版。CC 用户只看 `skills/`,不受影响。 --- ## 外部前提(本仓库不含密钥/凭据) | 依赖 | 用到的技能 | 获取方式 | CC 必须 | Pi 必须 | |------|-----------|---------|---------|---------| | `MINERU_TOKEN` | mineru-converter | MinerU 平台申请 | ✅ | ✅ | | `DEEPSEEK_API_KEY` | paper-translate | https://platform.deepseek.com/api_keys | ✅ | ✅ | | MCP `chrome-devtools` | cnki-* 系列(CC) | CC 注册 MCP server | ✅ | — | | MCP `playwright`(有头) | nudt-library-fetcher(CC) | CC 注册 MCP server | ✅ | — | | `~/.nudt_env` | cnki-* 系列(Pi) | NUDT 图书馆凭证 | — | ✅ | | `DISPLAY=:0` | cnki-* 系列(Pi) | X11 display | — | ✅ | 未配置对应前提的技能仍会被加载,但实际调用时会因缺凭据/缺工具而失败或提示。 --- ## 文档格式:一律 AsciiDoc(v1.2 起) 所有技能产出的**用户文档**(论文、报告、综述、评审意见、ADR、实施计划、过程总结)一律 `.adoc`, 不交 `.md`。Markdown 只保留给插件自身元文档(`README.md`/`CHANGELOG.md`/`SKILL.md`/agent 契约)、 数据文件、Slidev `slides.md` 与 OCR 资产(`raw/**/full.md`、`translation.md`)。 写作链路强制三道门(实现:`ars/shared/scripts/adoc_tool.py`;各技能 `scripts/adoc_tool.py` 为转发 wrapper): | 门 | 命令 | 判据 | |---|---|---| | 语法门 | `lint .adoc --strict` | 0 ERROR / 0 WARN:Markdown 残留、公式当代码、中文强调、宏嵌套/跨行、图片缺失、xref 悬空 | | 渲染门 | `render .adoc --strict` | 0 ERROR:HTML 渲染通过,且产物与源一致(图/表/公式/锚点数量、TOC、MathJax 定界符、无残留宏) | | 格式门 | `policy <交付目录>` | 0 ERROR:目录内无 `.md` 文档(元文档白名单除外) | 自测(CI 与方法验证): ```bash python3 ars/shared/scripts/selftest_adoc_gate.py ``` 自测会生成临时夹具,断言:合规文档通过;Markdown 泄漏、属性区断裂(`:toc:` 失效)、`.md` 交付物均被拦。 ## 技能一览 ### 采集层(取文献 → 转 Markdown → 翻译 → 入图谱) `literature-fetcher` `scihub-batch-download` `nudt-library-fetcher` `mineru-converter` `mineru-html-fetcher` `paper-translate` `graphify` `paper-graphifier` `paper-download-triage` Pi 用户还可以用 `paper_pipeline` 一键完成 PDF→MD→翻译→入图谱全流程(Pi 内置工具,无需额外安装技能)。 ### 知网研究(11 个 skill) `cnki-search` `cnki-advanced-search` `cnki-journal-search` `cnki-journal-index` `cnki-journal-toc` `cnki-navigate-pages` `cnki-paper-detail` `cnki-parse-results` `cnki-download` `cnki-export` `cnki-nudt-bridge` > CC 版由 `agents/cnki-researcher.md` 负责调度;Pi 版各技能独立工作。 ### 本地知识访问 `ars-local-search` — 关键词检索 `graphify-out/graph.json` + `raw/**/full.md`,零成本零外网。**假定你自己的项目里已有 `raw/<分类>/<论文目录>/full.md` + `graphify-out/graph.json` 语料**(用上面的采集层技能积累),没有语料时只是查不到东西,不影响其它技能。 ### 学术写作/研究(ARS) `academic-paper` `academic-paper-reviewer` `academic-pipeline` `deep-research` > 依赖仓库内 `ars/` 共享子系统(`shared/` `agents/` `commands/`),CC 和 Pi 版共用同一份内容。 > > **输出格式**:论文/报告/评审意见一律 `.adoc`;HTML 必出,PDF/DOCX 按需,LaTeX 仅投稿用。 > 模板已全部改为 AsciiDoc(`skills/*/templates/*.adoc`),旧的 `.md` 模板已移除。 ### 工程辅助 `adr-writer` `implementation-plan` `rubber-duck` `boost-prompt` ### 其它 `slidev` `elsevier-research` `scholar-carsi-download` --- ## 贡献指南 ### 我要修改一个技能 1. **确定技能类别**:参考上方的 A/B/C 分类表 2. **A 类(Pi 适配技能)** → 改 `pi-skills//SKILL.md` - 确保引用的是 Pi 原生工具(`cnki_search` 等),不引用 MCP 工具 - 如果涉及领域知识变化,同步更新 `skills//SKILL.md`(CC 版) 3. **B 类(通用技能)** → 改 `skills//SKILL.md` - 纯 LLM 编排逻辑,避免引用特定智能体的专属工具 - 如果需要引用工具,区分 CC(MCP)和 Pi(原生)两种路径 4. **C 类(快捷入口)** → Pi 版改 `prompts/.md`,CC 版改 `commands/.md` ### 我要新增一个技能 1. **是纯 LLM 编排逻辑?** → 直接在 `skills//SKILL.md` 创建,两端通用 2. **依赖特定工具?** → 在 `skills/` 创建 CC 版,同时(或仅)在 `pi-skills/` 创建 Pi 版 3. **是快捷入口?** → `prompts/`(Pi)或 `commands/`(CC) ### 提交规范 ```bash # 分支命名 feat/<描述> # 新功能 fix/<描述> # 修复 chore/<描述> # 清理/维护 # Commit message : <简短描述> # 示例 feat: cnki-search Pi 适配 — 使用 Pi 原生 cnki_search 工具 fix: paper-translate 修复 G2 门禁校验逻辑 chore: 更新 README 双智能体安装说明 ``` ### 提交流程 1. 从 `main` 创建特性分支 2. 修改 + 自测(CC 下 `/plugin install` 或 Pi 下 `pi install` 本地路径) 3. `git push origin ` 4. 在 GitLab 创建 MR → `main` 5. 合并后 CC 用户 `/plugin update`,Pi 用户 `pi update --extensions` --- ## 目录结构 ``` paperskills/ ├── .claude-plugin/ # CC plugin.json + marketplace.json ├── skills/ # 32 个 CC 版技能(B 类 23 个 + A 类 CC 原版 9 个) │ ├── / │ │ ├── SKILL.md │ │ └── scripts/ # 技能自带脚本 │ └── ... ├── pi-skills/ # 9 个 Pi 适配版技能(A 类) │ └── /SKILL.md ├── ars/ # academic-paper 系列共享子系统(CC/Pi 通用) │ ├── shared/ │ ├── agents/ │ └── commands/ ├── commands/ # CC 斜杠命令(13 个,如 /ars-full) ├── prompts/ # Pi prompt templates(13 个,等价于 CC 的 /ars-*) ├── agents/ # CC 自定义 Agent(cnki-researcher.md) ├── package.json # Pi Package 清单 └── README.md ``` --- ## 备注 - 本仓库脚本已从原项目 `.github/_*.py` 迁移进各自技能目录下的 `scripts/`,路径改为相对项目目录解析。在你自己的文献项目根目录下调用即可,无需额外配置。 - CC 版依赖的 MCP server(`chrome-devtools`、`playwright`)需用户自行注册;Pi 版通过原生工具封装,无需注册 MCP server。