@researai/deepscientist 1.5.0 → 1.5.1

package/docs/zh/99_ACKNOWLEDGEMENTS.md

@@ -0,0 +1,29 @@
+# 99 致谢：项目来源与感谢
+
+DeepScientist 的构思、架构设计与实现过程中，受到了许多优秀研究系统、开源项目与研究者工作的启发与帮助。在此表示诚挚感谢。
+
+## 项目致谢
+
+特别感谢以下项目为 DeepScientist 提供的重要启发、参考与研究背景：
+
+- The AI Scientist
+- The AI Scientist v2
+- AlphaEvolve
+- OpenEvolve
+- EvoScientist
+
+这些项目在自动化科研、开放式探索、进化式搜索、实验组织与智能研究代理等方向上的探索，为 DeepScientist 的设计提供了重要参照。
+
+## 个人致谢
+
+同时，特别感谢以下老师和同学的支持、讨论、启发与贡献：
+
+- Shichen Li
+- Guangsheng Bao
+- Fuchen Shen
+- Wenyang Gao
+- Luodan Zhang
+- Junshu Pan
+- Panzhong Lu
+
+谨向以上项目与个人致以感谢。

package/install.sh

@@ -6,9 +6,11 @@ SOURCE_ROOT="$SCRIPT_DIR"
 DEFAULT_BASE_DIR="${DEEPSCIENTIST_BASE_DIR:-${DEEPSCIENTIST_HOME:-$HOME/DeepScientist}}"
 ENV_INSTALL_DIR="${DEEPSCIENTIST_INSTALL_DIR:-}"
 ENV_BIN_DIR="${DEEPSCIENTIST_BIN_DIR:-}"
+ENV_WITH_TINYTEX="${DEEPSCIENTIST_WITH_TINYTEX:-}"
 BASE_DIR="$DEFAULT_BASE_DIR"
 INSTALL_DIR=""
 BIN_DIR="${ENV_BIN_DIR:-$HOME/.local/bin}"
+WITH_TINYTEX=0
 DIR_SET=0
 INSTALL_DIR_SET=0
 BIN_DIR_SET=0
@@ -18,12 +20,13 @@ usage() {
 DeepScientist installer
 
 Usage:
-  bash install.sh [--dir BASE_DIR] [--install-dir INSTALL_DIR] [--bin-dir BIN_DIR]
+  bash install.sh [--dir BASE_DIR] [--install-dir INSTALL_DIR] [--bin-dir BIN_DIR] [--with-tinytex]
 
 Options:
   --dir PATH          Base install directory. Code is installed into PATH/cli.
   --install-dir PATH  Exact install directory for the bundled CLI tree.
   --bin-dir PATH      Directory for launcher wrappers.
+  --with-tinytex      Also install a lightweight TinyTeX pdflatex runtime after DeepScientist is installed.
   -h, --help          Show this help message.
 
 Defaults:
@@ -34,7 +37,8 @@ Defaults:
 Notes:
   - This installer deploys the current working tree into a separate install directory.
   - Runtime data lives under ~/DeepScientist by default.
-  - `DEEPSCIENTIST_BASE_DIR`, `DEEPSCIENTIST_INSTALL_DIR`, and `DEEPSCIENTIST_BIN_DIR`
+  - `DEEPSCIENTIST_BASE_DIR`, `DEEPSCIENTIST_INSTALL_DIR`, `DEEPSCIENTIST_BIN_DIR`,
+    and `DEEPSCIENTIST_WITH_TINYTEX`
     can be used from `npm run install:local` as well.
 EOF
 }
@@ -68,6 +72,10 @@ while [ $# -gt 0 ]; do
       BIN_DIR_SET=1
       shift 2
       ;;
+    --with-tinytex)
+      WITH_TINYTEX=1
+      shift
+      ;;
     -h|--help)
       usage
       exit 0
@@ -80,6 +88,14 @@ while [ $# -gt 0 ]; do
   esac
 done
 
+if [ "$WITH_TINYTEX" -eq 0 ]; then
+  case "$(printf '%s' "$ENV_WITH_TINYTEX" | tr '[:upper:]' '[:lower:]')" in
+    1|true|yes|on)
+      WITH_TINYTEX=1
+      ;;
+  esac
+fi
+
 if [ "$DIR_SET" -eq 1 ] && [ "$INSTALL_DIR_SET" -eq 1 ]; then
   echo "--dir and --install-dir cannot be used together" >&2
   exit 1
@@ -132,24 +148,28 @@ print_optional_latex_notice() {
   printf 'Optional LaTeX runtime: not detected.\n'
   printf 'DeepScientist still installs and runs normally.\n'
   printf 'You only need LaTeX if you want to compile paper PDFs locally from the web workspace.\n'
+  printf 'Recommended lightweight option:\n'
+  printf '  %s latex install-runtime\n' "$BIN_DIR/ds"
+  printf '\n'
+  printf 'System package alternatives:\n'
 
   if command -v apt-get >/dev/null 2>&1; then
-    printf 'Install on Debian/Ubuntu:\n'
+    printf '  Debian/Ubuntu:\n'
     printf '  sudo apt-get update && sudo apt-get install -y texlive-latex-base texlive-latex-recommended texlive-fonts-recommended texlive-bibtex-extra\n'
   elif command -v dnf >/dev/null 2>&1; then
-    printf 'Install on Fedora/RHEL:\n'
+    printf '  Fedora/RHEL:\n'
     printf '  sudo dnf install -y texlive-scheme-basic texlive-collection-latex texlive-bibtex\n'
   elif command -v yum >/dev/null 2>&1; then
-    printf 'Install on CentOS/RHEL:\n'
+    printf '  CentOS/RHEL:\n'
     printf '  sudo yum install -y texlive-scheme-basic texlive-collection-latex texlive-bibtex\n'
   elif command -v pacman >/dev/null 2>&1; then
-    printf 'Install on Arch Linux:\n'
+    printf '  Arch Linux:\n'
     printf '  sudo pacman -S --needed texlive-basic texlive-latex\n'
   elif command -v brew >/dev/null 2>&1; then
-    printf 'Install on macOS with Homebrew:\n'
+    printf '  macOS with Homebrew:\n'
     printf '  brew install --cask mactex-no-gui\n'
   else
-    printf 'Install a TeX distribution that provides `pdflatex` and `bibtex`.\n'
+    printf '  Install a TeX distribution that provides `pdflatex` and `bibtex`.\n'
   fi
 }
 
@@ -336,6 +356,10 @@ printf 'Run: %s\n' "$BIN_DIR/ds"
 printf 'Start web workspace: %s\n' "$BIN_DIR/ds --web"
 printf 'Default start: %s\n' "$BIN_DIR/ds"
 printf 'When `ds` starts, it prints the local Web URL and opens it automatically when supported.\n'
+if [ "$WITH_TINYTEX" -eq 1 ]; then
+  print_step "Installing TinyTeX pdflatex runtime"
+  "$INSTALL_DIR/bin/ds" latex install-runtime
+fi
 print_optional_latex_notice
 if [[ ":$PATH:" != *":$BIN_DIR:"* ]]; then
   printf 'Add to PATH if needed: export PATH="%s:$PATH"\n' "$BIN_DIR"

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@researai/deepscientist",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "Local-first research operating system with a Python runtime and npm launcher",
   "license": "MIT",
   "files": [
     "AGENTS.md",
     "README.md",
+    "docs/en/",
+    "docs/zh/",
     "install.sh",
     "assets/branding/",
-    "assets/fonts/",
+    "assets/connectors/",
     "bin/",
     "pyproject.toml",
     "src/deepscientist/**/*.py",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepscientist"
-version = "1.5.0"
+version = "1.5.1"
 description = "DeepScientist Core skeleton"
 readme = "README.md"
 requires-python = ">=3.11"

package/src/deepscientist/artifact/guidance.py

@@ -252,7 +252,10 @@ def build_guidance_for_record(record: dict[str, Any]) -> dict[str, Any]:
                     _route("branch", "Branch another idea", "The current line no longer has the highest value.", "Expands search space, but delays explanation of the current line."),
                 ],
                 suggested_artifact_calls=[
-                    _artifact_call("artifact.create_analysis_campaign(...)", "Spawn structured analysis branches and worktrees."),
+                    _artifact_call(
+                        "artifact.create_analysis_campaign(...)",
+                        "Spawn one or more structured child analysis branches/worktrees from the current result node.",
+                    ),
                     _artifact_call("artifact.record(kind='report', ...)", "Summarize the campaign before the next route decision."),
                 ],
                 source_artifact_kind=kind,
@@ -488,6 +491,10 @@ def build_guidance_for_record(record: dict[str, Any]) -> dict[str, Any]:
             suggested_artifact_calls=[
                 _artifact_call("artifact.record(kind='report', ...)", "Summarize the main run and metric deltas."),
                 _artifact_call("artifact.record(kind='decision', ...)", "Choose the next route based on the result."),
+                _artifact_call(
+                    "artifact.create_analysis_campaign(...)",
+                    "When extra experiments are needed, create them as one-slice or multi-slice child branches from the current result node.",
+                ),
             ],
             source_artifact_kind=kind,
             source_artifact_id=artifact_id,
@@ -750,7 +757,7 @@ def build_guidance_for_snapshot(snapshot: dict[str, Any]) -> dict[str, Any]:
                 "A report synthesizes what the campaign changed.",
             ],
             suggested_artifact_calls=[
-                _artifact_call("artifact.record(kind='run', ...)", "Persist each analysis run."),
+                _artifact_call("artifact.record_analysis_slice(...)", "Persist each completed analysis slice and advance the campaign."),
                 _artifact_call("artifact.record(kind='report', ...)", "Write the campaign synthesis."),
             ],
         )