Files

T

carlandCursor 0136c15274 Initial commit: Plane 自部署与 gptproto AI 集成

包含本地/远程部署脚本、AI Agent 服务、Dashboard 与 QA 验证。

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-05-21 11:37:41 +08:00

7.4 KiB

Raw Permalink Blame History

团队项目协作平台 — 使用说明

内部 Plane 工作流系统 + 内置 AI 助手发布日期：2026-04-28

一、平台简介

这是一套自部署的团队项目管理平台，对标 Asana / Jira / Linear，所有数据保存在我们自有服务器，并集成了 AI 助手，可以让团队成员用自然语言创建任务、自动生成需求摘要、智能搜索。

能力	说明
项目管理	工作区 / 项目 / 任务 / 模块 / 周期 / 视图 / 标签 / 优先级
协作	评论、@提及、附件、Wiki 页面、状态流转
数据主权	所有数据在公司服务器,不上第三方 SaaS
AI 助手	自然语言生成任务 / 任务摘要 / 智能搜索（独立 API）

二、登录入口

🔗 公网访问地址

https://YOUR_SERVER_IP:8445

直接在浏览器打开即可。

⚠️ 第一次访问会出现"不安全"警告（正常现象）

服务器使用自签名 SSL 证书（公司内部用，没花钱买公网证书），浏览器会显示红字警告：

"您的连接不是私密连接 / Your connection is not private"

这是正常的，处理方式：

浏览器	操作
Chrome / Edge	点 "高级" → "继续访问 YOUR_SERVER_IP（不安全）"
Safari	点 "显示详细信息" → "访问此网站" → 输入 mac 密码确认
Firefox	点 "高级" → "接受风险并继续"

跳过一次后浏览器会记住，下次自动放行。

移动端访问

手机/平板浏览器可访问，操作同上。Plane 已适配移动端，但建议在电脑端做主要工作。

三、第一次使用（4 步 5 分钟）

Step 1：注册登录

打开 https://YOUR_SERVER_IP:8445

如果你已被管理员邀请：Sign In 用你的邮箱 + 收到的密码登录
如果是新用户：联系管理员（ruian5168@gmail.com）邀请你加入工作区
当前不开放公网注册（避免垃圾账号）

Step 2：切换中文界面

登录后：

点击左下角你的头像
选择 Profile / Settings
找到 Language
下拉选 简体中文
立即生效

Step 3：进入工作区

登录后会看到当前工作区列表，点进去 test（或其他你被分配的工作区）。

Step 4：开始工作

我想做	在哪点
创建新项目	左侧栏 "项目" → "+" 新建项目
添加任务	进入项目 → "工作项" 标签页 → "添加工作项"
给任务排优先级	创建/编辑任务时选紧急 / 高 / 中 / 低
分派给同事	任务详情 → "分派给" 选成员
查看进度	"周期"（短期 sprint）/ "模块"（中期里程碑）
写文档	项目 → "页面" 创建 wiki 文档
看日历	工作项 → 切换 "日历" 视图
看看板	工作项 → 切换 "看板" 视图

四、AI 助手能力（开发集成中）

我们部署了一套独立的 AI 助手服务，绑定团队聚合 API（OpenAI 兼容协议），目前提供 4 个能力：

能力	说明	状态
自然语言生成任务	把 "修复登录 502 报错,优先级紧急" 这种描述自动转成结构化任务	✅ 可用
任务摘要	一组任务一键生成中文进度摘要,适合写周报	✅ 可用
智能搜索	用自然语言搜索整个工作区	✅ 可用
健康检查	服务可用性自检	✅ 可用

当前形态：REST API（开发自己 curl 或集成） 后续规划（按团队反馈优先级）：

浏览器扩展：在 Plane 界面里加 ✨AI 按钮
网页面板：独立 Web 界面让所有人用
Webhook 自动化：任务创建/更新时自动触发 AI 分析

开发同学接入方式：

# 自然语言建任务
curl -X POST https://YOUR_SERVER_IP:8446/ai/create-issue \
  -H "Content-Type: application/json" \
  -d '{"prompt":"修复登录 502","project_id":"<id>","workspace_slug":"test"}'

# 任务批量摘要
curl -X POST https://YOUR_SERVER_IP:8446/ai/summarize \
  -H "Content-Type: application/json" \
  -d '{"issues":[{"title":"任务1"},{"title":"任务2"}]}'

# 自然语言搜索
curl -X POST https://YOUR_SERVER_IP:8446/ai/search \
  -H "Content-Type: application/json" \
  -d '{"query":"高优先级","workspace_slug":"test"}'

五、安全与隐私

项	说明
服务器位置	公司自有服务器（YOUR_SERVER_IP）
数据存储	100% 在自有 PostgreSQL / MinIO,不上第三方 SaaS
数据外发	仅当用户主动调用 AI 功能时,任务标题/描述会发到 gptproto.com（OpenAI 兼容聚合 API）。未调 AI 的所有数据零外发
遥测	已关闭（不向 Plane 官方上报使用统计）
公网注册	已关闭,只能管理员邀请
HTTPS	自签证书,内部使用
备份	Postgres 每日加密备份

六、关键链接快速参考

用途	链接	谁能访问
Plane 主入口	https://YOUR_SERVER_IP:8445	所有受邀用户
管理后台 (god-mode)	https://YOUR_SERVER_IP:8445/god-mode/	仅 Instance Admin
AI Agent 健康检查	https://YOUR_SERVER_IP:8446/healthz	内部/开发用
Plane 官方文档（英文）	https://developers.plane.so	公开
Plane 社区版 GitHub	https://github.com/makeplane/plane	公开

god-mode 管理后台能做什么

板块	用途
General Settings	实例名 / 注册开关 / Telemetry 开关
Authentication	Email Password / Magic Link / OAuth(Google/GitHub/GitLab) 开关
Email	SMTP 配置（发邀请邮件、密码重置）
Image Settings	Unsplash API（图片素材）
AI Settings	保持空(我们走独立 plane-ai 服务,Plane 内置 AI 不启用)
Workspace	查看 / 强制删除 / 资源限制
Member	全实例成员管理

七、常见问题

Q1：浏览器警告"不安全"还能用吗？ 能。这是因为我们用的是公司内部签的证书,不是花钱买的公网证书。数据传输仍然是 HTTPS 加密的。

Q2：忘记密码了？ 联系管理员（ruian5168@gmail.com）重置。当前未开通自助密码找回。

Q3：能在外网访问吗？ 能,这就是公网地址。但建议办公时段使用,出差临时用 VPN 更稳。

Q4：手机上能用吗？ 浏览器能用,体验对移动端做了适配。当前没有原生 App。

Q5：数据多久备份一次？丢失会怎样？ Postgres 每日凌晨自动加密备份,保留近 7 天。极端情况可恢复到任意一天。

Q6：AI 调用会把我的任务发到外面吗？ 是的,仅当你主动点 AI 功能时,任务标题和描述会发给 gptproto.com（OpenAI 兼容 API）。不调用 AI 的所有数据零外发。敏感任务避免用 AI 即可。

Q7：能加多少团队成员？ 社区版无硬性人数限制,服务器规格够支撑 50-100 人内部使用。

Q8：Plane 升级后我的数据会丢吗？ 不会。Plane 升级走标准 Django migration 流程,会保留所有历史数据。

八、技术联系人

角色	联系方式
平台管理员	ruian5168@gmail.com
服务器运维	同上

部署日期：2026-04-28 Plane 版本：v1.3.0 社区版（AGPL-3.0 开源） 最近一次验证：2026-04-28 全栈通过（14 容器 healthy + AI 端点可用 + 数据持久化验证 OK）

7.4 KiB Raw Permalink Blame History Unescape Escape