init repo

.gitignore

@@ -0,0 +1,24 @@
+# OS
+.DS_Store
+
+# Env
+.env
+.env.*
+
+# Python
+__pycache__/
+.pytest_cache/
+.mypy_cache/
+.venv/
+venv/
+
+# Node
+node_modules/
+.next/
+dist/
+build/
+.nuxt/
+.output/
+
+# Misc
+*.log

.project.json

@@ -0,0 +1,24 @@
+{
+  "name": "Okara AI CMO Deep Research",
+  "description": "Okara AI CMO 产品深度技术研究：架构、Agent 编排、GEO 概念、可复现性评估",
+  "status": "done",
+  "kind": "analysis",
+  "created": "2026-03-22",
+  "ports": [
+    {
+      "port": 4160,
+      "label": "dev",
+      "fixed": true
+    }
+  ],
+  "stack": [
+    "HTML"
+  ],
+  "urls": [
+    {
+      "url": "http://localhost:4160",
+      "type": "docs",
+      "label": "local docs"
+    }
+  ]
+}

AGENTS.md

@@ -0,0 +1,21 @@
+# Okara AI CMO Deep Research Agent Rules
+
+## Must Read First
+
+- `.project.json` 是机器真源：公网链接、快捷登录、凭证引用都以它为准
+- `RULES.md` 是人工规则和部署事实：启动命令、平台、域名、注意事项都写这里
+- 不允许编造不存在的域名、账号、密码；未知就保持空白并明确标记待补充
+
+## Deployment Metadata Contract
+
+- 任何任务只要新增、删除或修改公网地址，必须在同一次任务里更新 `.project.json`
+- `urls[]` 推荐显式写 `type`：`app`、`backend`、`docs`、`admin`、`repo`
+- 项目专属的网页登录信息，如果允许放进仓库，就写 `.project.json.quick_login`
+- 不能直接入库的敏感登录，不要伪造 `quick_login`，改为写 `.project.json.credentials` 引用
+- 数据库密码、API Key、服务器 root 密码，不属于 `quick_login`
+
+## Completion Gate
+
+- 部署完成后，不允许在 `.project.json` 缺少最新公网链接的状态下结束任务
+- 部署完成后，必须同步更新 `RULES.md` 的部署事实
+- 如果只更新了代码但没回写部署元数据，这个任务不算完成

CLAUDE.md

@@ -0,0 +1,21 @@
+# Okara AI CMO Deep Research Agent Rules
+
+## Must Read First
+
+- `.project.json` 是机器真源：公网链接、快捷登录、凭证引用都以它为准
+- `RULES.md` 是人工规则和部署事实：启动命令、平台、域名、注意事项都写这里
+- 不允许编造不存在的域名、账号、密码；未知就保持空白并明确标记待补充
+
+## Deployment Metadata Contract
+
+- 任何任务只要新增、删除或修改公网地址，必须在同一次任务里更新 `.project.json`
+- `urls[]` 推荐显式写 `type`：`app`、`backend`、`docs`、`admin`、`repo`
+- 项目专属的网页登录信息，如果允许放进仓库，就写 `.project.json.quick_login`
+- 不能直接入库的敏感登录，不要伪造 `quick_login`，改为写 `.project.json.credentials` 引用
+- 数据库密码、API Key、服务器 root 密码，不属于 `quick_login`
+
+## Completion Gate
+
+- 部署完成后，不允许在 `.project.json` 缺少最新公网链接的状态下结束任务
+- 部署完成后，必须同步更新 `RULES.md` 的部署事实
+- 如果只更新了代码但没回写部署元数据，这个任务不算完成

RULES.md

@@ -0,0 +1,37 @@
+# Okara AI CMO Deep Research
+
+## 启动
+- `dev` — 端口 4160
+
+## 部署事实
+- 平台：待定
+- 发布状态：已部署
+- 主站 / 前端：待定
+- API / 后端：待定
+- 文档 / 解析：http://localhost:4160
+- 管理后台：待定
+- 代码仓：待定
+
+## 快捷登录
+- 登录地址：待补充
+- 用户名：待补充
+- 密码：待补充
+- 说明：这里只写项目专属网页登录；数据库密码、API Key、服务器 root 密码不要写这里
+
+## 元数据回写清单
+- 新增或变更公网地址后，必须同步更新 `.project.json.urls`
+- 如果有网页后台登录：
+  - 可直接入库：写 `.project.json.quick_login`
+  - 不应入库：写 `.project.json.credentials` 引用
+- 部署完成后，`RULES.md` 和 `.project.json` 必须同一次任务一起更新
+
+## 环境变量
+- 待补充
+
+## 规则
+- 不允许编造不存在的部署域名、账号、密码
+- 没有公网地址时，`.project.json.urls` 保持空数组
+- 任何部署或域名变化，都要先改元数据，再视为任务完成
+
+## 注意事项
+- 待补充