Trình chạy
----------
Cả hai lệnh trong README đều không chạy được từ một thư mục checkout tên
khác `cowork_local`:
python -m cowork_local -> No module named cowork_local
python __main__.py -> ModuleNotFoundError: No module named 'cowork_local'
Không sửa được bằng mẹo sys.path, vì `state.py` khởi động máy chủ MCP MS365
bằng tiến trình con `python -m cowork_local.mcp_servers.ms365_server` — tiến
trình con cũng phải import được. Hai script tạo một junction ở
`%LOCALAPPDATA%\CoworkLocal\launcher` thay vì bắt người dùng đổi tên thư mục
làm việc.
Môi trường ảo đặt ở `%LOCALAPPDATA%\CoworkLocal\venv`, cố ý KHÔNG đặt trong
repo: các cổng chất lượng quét toàn bộ cây thư mục chứ không đọc
`.gitignore`, nên một `.venv` ở đây sẽ biến vài nghìn module thư viện thành
"mã production không ai import" và làm Gate O đỏ.
requirements.txt
----------------
Chạy thử `run.bat` trên một profile trắng thì app chết ngay lúc mở:
presentation/folder/code_editor.py:41
ModuleNotFoundError: No module named 'pygments'
Quét toàn bộ import bên thứ ba thì thiếu 8 thư viện, trong đó `pygments` và
`pydantic` là bắt buộc — import không có try/except, nên triệu chứng không
phải "tính năng đó không chạy" mà là app không mở được. Nghĩa là cài đúng
theo requirements.txt xong app vẫn hỏng.
Đã tách rõ nhóm bắt buộc / tuỳ chọn kèm lý do từng dòng.
`opendataloader-pdf` để nguyên dạng chú thích vì code tự cài khi cần qua
`core/deps.py::ensure_module`.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
42 lines
2.0 KiB
Plaintext
42 lines
2.0 KiB
Plaintext
# Cowork-Local BamBOO — dependencies
|
|
# Install: pip install -r requirements.txt
|
|
|
|
# --- Core UI framework ---
|
|
PySide6>=6.6.0
|
|
|
|
# --- HTTP client ---
|
|
requests>=2.31.0
|
|
|
|
# --- Process & resource monitoring ---
|
|
psutil>=5.9.0
|
|
|
|
# --- Document handling ---
|
|
openpyxl>=3.1.0 # Excel (.xlsx) creation & reading
|
|
python-pptx>=0.6.0 # PowerPoint (.pptx) editing
|
|
pypdf>=4.0.0 # PDF text extraction (preferred)
|
|
# PyPDF2>=3.0.0 # PDF fallback (optional, pypdf preferred)
|
|
|
|
# --- Microsoft 365 integration ---
|
|
msal>=1.24.0 # OAuth device-code flow for MS365
|
|
keyring>=24.0.0 # OS credential store (token cache)
|
|
|
|
# --- MCP (Model Context Protocol) ---
|
|
mcp>=1.0.0 # MCP client SDK (stdio transport)
|
|
|
|
# --- Bắt buộc: import KHÔNG có try/except, thiếu là app chết lúc khởi động ---
|
|
# Hai dòng dưới đây bị bỏ sót cho tới 30/08. Triệu chứng của việc thiếu chúng
|
|
# không phải "tính năng đó không chạy" mà là ModuleNotFoundError ngay khi dựng
|
|
# cửa sổ chính — cài đúng theo requirements.txt xong app vẫn không mở được.
|
|
pygments>=2.15.0 # tô màu cú pháp — presentation/folder/code_editor.py
|
|
pydantic>=2,<3 # kiểu dữ liệu định tuyến — core/routing/models.py
|
|
|
|
# --- Tuỳ chọn: mỗi chỗ dùng đều bọc try/except, thiếu thì mất tính năng ---
|
|
# Vẫn cài mặc định vì đều nhẹ và đều là tính năng người dùng nhìn thấy được.
|
|
networkx>=3.0 # bố cục đồ thị đẹp hơn cho GraphRAG nhiều node
|
|
holidays>=0.40 # lịch nghỉ theo quốc gia cho màn Lịch task
|
|
pywin32>=306; sys_platform == "win32" # Office -> PDF, thông báo Outlook
|
|
|
|
# opendataloader-pdf # bộ đọc PDF thay thế — KHÔNG cài sẵn có chủ ý:
|
|
# # application/workspaces/graph_index_service.py tự cài
|
|
# # khi cần, qua core/deps.py::ensure_module.
|