@poco-ai/agentero-dsh 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,84 @@
-# Temporary Holding Version
+# Agentero × DeepSeek Harness
 
-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.
+Agentero 是本地优先的科研工作台。这个插件把它的文献库、笔记和 PDF 阅读器带进 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（下称 dsh），让 Agent 和你坐在同一个窗口里做科研：你读论文、做判断，Agent 帮你查资料、翻笔记、整理结论。所有资料都留在自己的本地。
+
+![文献库与 PDF 阅读](assets/pdf-library.png)
+
+## 一起做科研
+
+- 聊天在中间，论文在右边，读到哪句可以直接丢回对话。
+- Agent 能查你已经有的文献和笔记，回答时引用真实的本地论文。
+- 讨论完可以让 Agent 把结论整理成笔记，下次接着用。
+- 新论文让 Agent 按 arXiv、DOI 或链接导入，不用手动整理文件。
+
+可以这样说：
+
+> 帮我把这个方向近两年的论文找出来，导入文献库，再结合我的笔记整理一份提纲。
+
+> 把这轮讨论整理成一篇阅读笔记，开头列出用到的论文。
+
+![Agent 在对话中写笔记](assets/note.png)
+
+## 能做什么
+
+- **读文献**：搜索、标签、导入、补下载、删除到回收站。
+- **读 PDF**：翻页、查找、目录、链接；划词后复制、高亮、批注、翻译或加入对话。
+- **全文翻译**：用 dsh 配置的 DeepSeek 模型在原页面上逐段替换，保留公式和版面。
+- **写笔记**：编辑自己的笔记，也可以让 Agent 代写；每篇论文还有自己的专属笔记。
+- **让 Agent 动手**：查文献、导入论文、读和搜笔记、整理提纲。
+
+## 安装
+
+需要 dsh 0.2.x、Node.js 24.9+、一个已有的 Agentero Vault，以及 Agentero CLI。
+
+先安装 CLI：在 Agentero 桌面端打开「设置 → 关于 → 安装 CLI」，或参考 [CONTRIBUTING.md](CONTRIBUTING.md) 本地构建。确认终端里能运行：
+
+```sh
+agentero --help
+```
+
+然后安装插件：
+
+```sh
+dsh plugin --profile web add @poco-ai/agentero-dsh
+```
+
+在 `~/.dsh/profiles/web/cordis.patch.yml` 里填 Vault 和 CLI 路径：
+
+```yaml
+- id: agentero-host
+  config:
+    vault: /path/to/vault
+    agenteroBin: /path/to/agentero
+```
+
+启动：
+
+```sh
+dsh web --no-open
+```
+
+看到 `[agentero] plugin loaded` 后打开终端打印的链接。点侧边栏「更多」→「设置」→「Agentero」，填知识库目录和 Agentero CLI 的可执行文件位置；CLI 留空则使用 PATH 里的 `agentero`。
+
+也可以直接改 `~/.dsh/profiles/web/cordis.patch.yml`，适合脚本化部署：
+
+```yaml
+- id: agentero-host
+  config:
+    vault: /path/to/vault
+    agenteroBin: /path/to/agentero
+```
+
+## 数据
+
+论文、PDF、笔记和标注都留在 Vault 里，和 Agentero 桌面端共用。插件只在本机运行，不另建数据库。
+
+## 已知限制
+
+- 扫描件需要先在桌面端做 OCR 和版面分析。
+- 全文翻译重新打开文档会重新计算；译文上的原文链接和高亮暂不支持。
+- 「推荐」卡片暂未启用。
+
+## 开发
+
+见 [CONTRIBUTING.md](CONTRIBUTING.md)。

package/cordis.patch.yml

@@ -0,0 +1,12 @@
+- insert:
+    - id: agentero-host
+      name: '@poco-ai/agentero-dsh-host'
+    - id: agentero-library
+      name: '@poco-ai/agentero-dsh-library'
+    - id: agentero-notes
+      name: '@poco-ai/agentero-dsh-notes'
+    - id: agentero-pdf
+      name: '@poco-ai/agentero-dsh-pdf'
+    # Temporarily disabled: the recommend dock is not loaded until further notice.
+    # - id: agentero-recommend
+    #   name: '@poco-ai/agentero-dsh-recommend'

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@poco-ai/agentero-dsh",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "DeepSeek Harness bundle that connects Agentero to dsh",
+  "type": "module",
+  "engines": {
+    "node": ">=24.9.0",
+    "dsh": ">=0.2.1-rc.5 <0.3.0"
+  },
+  "files": [
+    "cordis.patch.yml"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@poco-ai/agentero-dsh-host": "^0.1.0",
+    "@poco-ai/agentero-dsh-library": "^0.1.0",
+    "@poco-ai/agentero-dsh-notes": "^0.1.0",
+    "@poco-ai/agentero-dsh-pdf": "^0.1.0",
+    "@poco-ai/agentero-dsh-recommend": "^0.1.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.6-alpha.1",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-store": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "0.2.2-alpha.2",
+    "@deepseek-ai/schemastery": "3.18.6-alpha.1",
+    "@tailwindcss/cli": "^4.1.16",
+    "@types/node": "^24.10.1",
+    "@types/react": "^18.3.18",
+    "esbuild": "^0.25.0",
+    "scheduler": "0.28.0",
+    "tailwindcss": "^4.1.16",
+    "typescript": "^6.0.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/poco-ai/agentero-dsh-plugin.git"
+  },
+  "scripts": {
+    "build": "node scripts/build-all.mjs",
+    "typecheck": "node scripts/build-all.mjs --noEmit",
+    "bump": "node scripts/bump-version.mjs",
+    "release": "pnpm build && pnpm -r publish --registry=https://registry.npmjs.org"
+  }
 }