# Thesisly 研迹 working agreements

- 本项目使用 Next.js App Router、TypeScript、Tailwind CSS、shadcn/ui（Radix primitives）、Lucide 和 Sonner。用户要求本地开发，但最新指示为暂不执行本地 build；不启动会隐式编译的预览，直至确认适用授权。不配置前端 CI/CD，不部署。
- 仅通过 Foundry Core 共享后端管理身份。复用 Endoleap 的 PKCE、HttpOnly Cookie、闲置续期、退出撤销与同源校验；禁止把 token 发到客户端或 localStorage。
- 论文读取模式必须显式区分真实数据库样本与远程 API。不得把本地20条样本称为全库、最新或热门数据，不虚构摘要、代码仓库、会议决定或指标。
- 源数据只读；不复制整库，不从浏览器直连 SQLite 或持有数据库凭据。
- 阅读与文章列表优先，无 KPI 仪表盘。默认 Vignelli；Editorial、Tufte 可切换。UI Craft Editorial 的衬线默认按用户现代简洁偏好及选定主题调整。
- 项目级技能在 .agents/skills；beautiful-article 内含 Vignelli/Tufte authoring profiles，两者不是独立上游 skill。Beautiful Article 只在另行请求单篇 HTML 文章时进入其完整 harness。
- 英文品牌 Thesisly、中文名研迹；远程仓库为 `ssh://git@gitea.entroia.com:22222/Zayden-Jung/Thesisly.git`。用户已在 FOUNDRY_PROJECTS 新增 thesisly 回调，线上加载及登录仍待验收。main 仅允许本次已授权的空初始化提交，其余代码走工作分支与人工 PR 合并。
- 论文库迁移至 PostgreSQL 由「调查云盘占用原因」任务负责；等待其迁移完成并核对实际 schema 后，在 Foundry Core 实现只读论文 API。不部署已撤回的 SQLite 方案，也不要求添加 FOUNDRY_RESEARCH_DATABASE。