From fcfe9c7ae5d449be886133f2b9aa65b65d4ba8ef Mon Sep 17 00:00:00 2001 From: weishen Date: Thu, 23 Apr 2026 13:22:56 +0800 Subject: [PATCH] Workspace sync: auto commit 2026-04-23 13:22:56 --- Project/fonrey/PRD/楼盘管理模块PRD.md | 704 ++++++++++++++++++ wiki/entities/gog-CLI.md | 48 ++ wiki/index.md | 5 +- wiki/log.md | 31 +- wiki/overview.md | 3 +- wiki/sources/gog-cli-安装配置指南.md | 45 ++ .../scrapy-playwright-抓取tiktok-shop-data.md | 49 ++ 7 files changed, 881 insertions(+), 4 deletions(-) create mode 100644 Project/fonrey/PRD/楼盘管理模块PRD.md create mode 100644 wiki/entities/gog-CLI.md create mode 100644 wiki/sources/gog-cli-安装配置指南.md create mode 100644 wiki/sources/scrapy-playwright-抓取tiktok-shop-data.md diff --git a/Project/fonrey/PRD/楼盘管理模块PRD.md b/Project/fonrey/PRD/楼盘管理模块PRD.md new file mode 100644 index 00000000..b387e1b3 --- /dev/null +++ b/Project/fonrey/PRD/楼盘管理模块PRD.md @@ -0,0 +1,704 @@ +# PRD: 楼盘管理模块 +**状态**: Draft +**作者**: 产品经理 +**最后更新**: 2026-04-23（v1.0 初稿，基于楼盘管理列表、楼盘详情（楼盘信息/楼栋管理/结构管理/楼盘照片/楼盘价格走势/周边配套）、区域管理（城区/商圈/关联关系）、学校管理共14张截图分析完成） +**版本**: 1.0 +**所属系统**: Fonrey 房产经纪管理系统 +**关联模块**: 房源管理、客源管理、组织人事管理、权限管理 + +--- + +## 1. 问题陈述 + +### 背景 + +楼盘（小区）是房源管理的基础数据底座。一套房源必须归属于某一楼盘，楼盘的信息完整度直接决定房源数据的质量、搜索的准确性，以及向买客推荐时的可信度。 + +现实业务中，楼盘数据的核心痛点集中在以下几个方面： + +- **数据分散不统一**：楼盘名称存在多版本叫法（标准名、别名、营销名等），各门店录入口径不一，导致同一楼盘在系统中多次重复存在，房源匹配困难 +- **楼栋/单元/房号缺失**：房源录入时无法关联准确的楼栋结构，导致"同一门牌号多套房源"的数据混乱问题 +- **区域体系不规范**：城区-商圈两级区域结构缺乏统一维护，不同城市、分公司之间区域命名各行其是，无法支持跨区域数据汇总 +- **学区信息不完整**：学区是买家购房的核心关注点，但缺乏与楼盘关联的学区数据库，全靠经纪人口述，准确性和一致性极差 +- **价格走势不可视**：缺少楼盘级别的历史成交价和挂牌价趋势数据，经纪人在客户询价时无参考依据，议价能力弱 + +### 目标用户 + +| 角色 | 描述 | 使用频率 | +|------|------|----------| +| 运营/数据管理员 | 维护楼盘信息、楼栋结构、区域体系、学校信息的标准化数据 | 每日 | +| 一线经纪人 | 查询楼盘详情、参考价格走势、了解周边配套辅助成交 | 每日 | +| 店长/经理 | 监控楼盘数据完整度，分析区域市场行情 | 每周 | +| 系统管理员 | 配置区域关联关系，管理数据标准 | 不定期 | + +--- + +## 2. 目标与成功指标 + +| 目标 | 指标 | 当前基准 | 目标值 | 衡量周期 | +|------|------|----------|--------|----------| +| 提升楼盘数据完整度 | 楼盘及单元完整率 | 待统计 | ≥ 95% | 上线后 90 天 | +| 减少重复楼盘 | 楼盘关联房号率 | 待统计 | ≥ 90% | 上线后 90 天 | +| 提升学区信息准确率 | 有学区关联的楼盘占比 | 待统计 | ≥ 80% | 上线后 60 天 | +| 提升区域数据规范度 | 有坐标的商圈占比 | 1.83%（截图数据） | ≥ 90% | 上线后 120 天 | + +--- + +## 3. 非目标（本期不做） + +- **应用数据标准**：数据标准应用功能本期不做，后续版本规划 +- 不包含楼盘的对外门户网站展示（楼盘详情页对客展示为营销模块） +- 不包含楼盘数据与第三方平台（链家、贝壳等）的数据同步集成 +- 不包含销控盘（新房/一手楼盘）功能，本模块聚焦二手房楼盘管理 +- 不包含楼盘的 AI 自动补全/抓取功能（数据采集为独立项目） + +--- + +## 4. 用户故事与验收标准 + +### Story 1：运营人员在楼盘列表中查找并管理楼盘 + +**As** 运营/数据管理员，**I want** 通过楼盘列表快速查找特定楼盘并了解其数据完整度状态，**So that** 可以有针对性地补全数据，提升整体楼盘数据质量。 + +**验收标准**： +- [ ] 楼盘列表支持关键词搜索：楼盘名称/别名/概要地址，点击"查询"触发搜索，支持"清除"重置 +- [ ] 支持按区域过滤（行政区多选）：不限 / 静安 / 闵行 / 普陀 / 松江 / 长宁 等 +- [ ] 支持按用途过滤：不限 / 住宅 / 别墅 / 商住 / 商业 / 写字楼 / 其他 +- [ ] 支持按"固定情况"、"完善情况"、"楼盘类型"、"楼标号小区非标结构情况"、"有无房源"、"楼栋类型"、"权属关系"、"有无坐标"等维度组合筛选（下拉） +- [ ] 列表顶部实时显示数据完整度统计面板，包含：楼盘关联率、楼栋及单元完整率、房号匹配率、处置率、入住人结构数据、有效结构数量、房源对标等关键指标，并提供"重新计算"入口 +- [ ] 列表字段包含：楼盘名称（含信息标签、标准楼盘入口、标准楼栋入口、标准房号入口）、楼盘类型、详细地址、城区商圈、当月挂牌均价（元/m²）、楼栋数、产品数、房源数（出售/出租/总计） +- [ ] 列表支持批量操作：批量新增楼栋、批改区域商圈、删除、合并楼盘 +- [ ] 支持新增楼盘（主 CTA 按钮） +- [ ] 每行操作列提供"编辑"和"删除"按钮 +- [ ] 列表底部支持分页（20条/页，支持跳页） + +--- + +### Story 2：运营人员查看和编辑楼盘基本信息 + +**As** 运营/数据管理员，**I want** 在楼盘详情页查看完整的楼盘信息并快速修正错误，**So that** 保持楼盘档案的准确性，为房源信息提供可靠的数据基础。 + +**验收标准**： +- [ ] 楼盘详情页顶部展示楼盘完整名称（含标准名+别名组合）及4类权限标签（楼栋锁、房号锁、信息锁、标准房号锁） +- [ ] 顶部提供"解锁楼盘"操作按钮（受权限控制） +- [ ] 详情页分 Tab 展示：楼盘信息 / 楼栋管理 / 结构管理 / 楼盘照片 / 楼盘附件 / 周边配套 / 楼盘价格走势 / 销控盘 +- [ ] 楼盘信息 Tab 下，"基本信息"区块字段包含： + - 城区商圈、小区地址、概要地址、建筑类型 + - 楼栋结构（枚举：单元-房号等） + - 小区别名（可多个） + - 土地使用年限（如：70年） + - 物业类型（住宅/别墅等） + - 权属类别（如：商品房住宅） + - 竣工年限、总户数、单元总数 + - 小区坐标（经纬度，可点击坐标地图定位） +- [ ] 楼盘信息 Tab 下，"对口学校"区块展示关联学校列表，字段：学校名称/学校类型/学校性质/学校等级 +- [ ] 楼盘信息 Tab 下，"其他信息"区块字段包含： + - 小区总建筑面积、小区占地面积、容积率、绿化率 + - 物业公司、物业费（元/m²/月）、物业电话 + - 开发商、车位数（总数）、车位数（地下）、停车位配比 + - 供水类型、供电类型、统一供暖（有/无）、有无燃气 + - 备注 +- [ ] 点击"编辑"按钮跳转至独立编辑页面，编辑完成点击"确定"保存，"取消"不保存并返回 +- [ ] 楼盘地址有误时提供"纠错"入口（页面顶部"楼盘地址有误？点此【纠错】"） + +--- + +### Story 3：运营人员编辑楼盘信息（完整编辑页） + +**As** 运营/数据管理员，**I want** 在专用编辑页中全量修改楼盘的基本信息、学校信息和其他信息，**So that** 一次性完成楼盘档案的系统化维护。 + +**验收标准**： + +#### 基本信息区块 + +| 字段 | 类型 | 必填 | 说明 | +|------|------|------|------| +| 小区名称 | 文本输入 | 是 | 只读（灰底），不可在编辑页修改，需通过合并/申请流程处理 | +| 小区地址 | 文本输入 | 是 | 只读（灰底） | +| 物业类型 | 单选 | 是 | 已选中N个，可调整 | +| 城区商圈 | 级联下拉 | 否 | 城区 + 商圈二级联动 | +| 楼栋结构 | 下拉 | 是 | 单元-房号 / 其他等枚举 | +| 小区别名 | 文本 + 标准别名 | 否 | 支持自定义别名（最多20字，多个用「回号」分隔），系统别名只读展示 | +| 建筑类型 | 单选组 | 否 | 板楼 / 塔楼 / 板塔结合 | +| 概要地址 | 文本输入 | 否 | 简短描述，如"海波路1000弄" | +| 土地使用年限 | 下拉 | 否 | 已选中N个 | +| 竣工年限 | 多选下拉 | 否 | 已选中N个 | +| 权属类别 | 多选下拉 | 否 | 已选中N个 | +| 单元总数 | 数字输入 | 否 | 配合"栋"单位标识 | +| 总户数 | 数字输入 | 否 | 配合"户"单位标识 | +| 小区坐标 | 经纬度文本输入 | 否 | 格式：纬度,经度，旁有坐标编辑入口和地图定位按钮 | + +- [ ] 必填字段未填写时，点击"确定"弹出错误提示并定位到未填字段 +- [ ] 小区名称、小区地址字段灰底只读，不可编辑 + +#### 学校信息区块 + +- [ ] 支持关联多个对口学校，每条记录提供删除操作 +- [ ] 提供"+ 添加"按钮，点击打开学校选择弹窗 +- [ ] 区块说明文字："删除学校，所有房源下关联的该关联学校将会被删除" + +#### 其他信息区块 + +| 字段 | 类型 | 必填 | 说明 | +|------|------|------|------| +| 小区总建筑面积 | 数字输入 | 否 | 单位：m² | +| 小区占地面积 | 数字输入 | 否 | 单位：m² | +| 容积率 | 数字输入 | 否 | 如：1.7 | +| 绿化率 | 数字输入 | 否 | 如：38（%）| +| 开发商 | 文本输入 | 否 | 如：单位自建 | +| 物业公司 | 文本输入 | 否 | 如：业主自管 | +| 物业费 | 数字输入 | 否 | 单位：元/m²/月，如：1.20 | +| 物业电话 | 文本输入 | 否 | | +| 车位数（总数） | 数字输入 | 否 | 配合"个"单位 | +| 车位数（地下） | 数字输入 | 否 | 配合"个"单位 | +| 停车位配比 | 文本输入 | 否 | 如：100:63 | +| 供水类型 | 单选 | 否 | 民水 / 商水 | +| 供电类型 | 单选 | 否 | 民电 / 商电 | +| 统一供暖 | 单选 | 否 | 有 / 无 | +| 有无燃气 | 单选 | 否 | 有 / 无 | +| 备注 | 文本区域 | 否 | 多行文本 | + +- [ ] 页面底部固定显示"确定"（橙色主按钮）和"取消"按钮 +- [ ] 点击"取消"返回楼盘详情页，不保存 +- [ ] 保存成功后返回楼盘信息 Tab，信息即时刷新 + +--- + +### Story 4：运营人员管理楼栋和单元 + +**As** 运营/数据管理员，**I want** 在楼盘详情的楼栋管理 Tab 中维护楼栋（单元）列表，**So that** 为房源录入提供准确的楼栋结构参考，减少"无法关联结构"的房源数量。 + +**验收标准**： +- [ ] 楼栋管理 Tab 以列表形式展示该楼盘下所有单元，列字段包含：单元名、楼盘类型（标准/非标）、物业类型、竣工年限、总层数、土地使用年限、电梯（有/无）、关联学校 +- [ ] 每行操作列提供"编辑"和"结构管理"两个操作链接 +- [ ] 顶部支持按"单元"关键词搜索，点击"搜索"执行 +- [ ] 批量操作：批量设置单元信息、合并单元、移动单元 +- [ ] 提供"申请新增"入口（找不到楼栋时引导用户发起新增申请） +- [ ] 页面顶部提示文字：本楼盘还有N个非标准结构，提供"查看明细"跳转链接 +- [ ] 列表分页（20条/页，支持翻页和跳页），底部显示总条数 +- [ ] 单元名称为蓝色可点击链接，点击进入该单元的结构管理视图 + +--- + +### Story 5：运营人员管理结构（楼层与房号） + +**As** 运营/数据管理员，**I want** 在结构管理 Tab 中查看并维护每个单元下的楼层和房号信息，**So that** 构建准确的"楼盘-楼栋-单元-楼层-房号"五级数据结构，支撑房源的精准定位。 + +**验收标准**： +- [ ] 结构管理 Tab 左侧为单元列表（支持多选），右侧展示选中单元的楼层-房号矩阵 +- [ ] 左侧单元列表按单元名称列出，支持滚动，选中单元高亮显示（橙色） +- [ ] 右侧矩阵：行为楼层名（实际层），列为房号；矩阵单元格展示具体房号（附标准/非标标签） +- [ ] 矩阵顶部提供"批量编辑房号"和"合并房号"操作按钮 +- [ ] 顶部显示"已选N条"计数，以及找不到房号时引导"申请新增"链接 +- [ ] 右上角提示本楼盘还有N个房号无法关联结构，提供"查看明细"入口 +- [ ] 每个房号旁显示"标准"标签（表示已匹配标准结构） + +--- + +### Story 6：运营人员管理楼盘照片 + +**As** 运营/数据管理员，**I want** 在楼盘照片 Tab 中上传和管理楼盘的图片资源（楼盘图片、户型图、VR），**So that** 为经纪人展示楼盘和为买客提供参考提供丰富的视觉素材。 + +**验收标准**： + +#### 照片分类 Tab + +- [ ] 支持三类照片 Tab：**楼盘图片（N）** / **户型图（N）** / **楼盘VR（N）**，括号内显示该类照片数量 + +#### 户型图管理 + +- [ ] 户型图支持按户型过滤：全部 / 1室 / 2室 / 3室 / 4室 / 5室及以上 +- [ ] 支持按朝向过滤：全部 / 东 / 南 / 西 / 北 / 南北 / 东南 / 西北 / 东北 / 东西 +- [ ] 户型图内部分子 Tab：推荐户型图（N）/ **标准户型图（N）**（当前激活）/ VR户型图（N）/ 本地上传（N） +- [ ] 系统提示："推荐户型图和标准户型图仅支持查看"（标准库图片不可编辑/删除） +- [ ] 户型图以瀑布流/网格方式展示，每张图片底部标注户型描述（如"1室2厅1卫"） +- [ ] 支持分页（30条/页），显示总条数 + +#### 楼盘图片管理 + +- [ ] 支持上传楼盘实景图片，支持批量上传 +- [ ] 支持图片分类管理 + +#### 楼盘VR管理 + +- [ ] 支持上传/关联VR全景资源 + +--- + +### Story 7：经纪人查看楼盘价格走势 + +**As** 一线经纪人，**I want** 在楼盘详情页查看该楼盘的挂牌价走势和历史成交数据，**So that** 在带看时能为客户提供客观的市场行情参考，增强议价信心。 + +**验收标准**： + +#### 数据维度切换 + +- [ ] 价格走势 Tab 顶部提供两个子 Tab：**司内数据** / **市场数据** +- [ ] 顶部注明"以下数据按照T+1更新，市场&网签数据仅供参考" + +#### 司内数据视图 + +- [ ] 展示两个摘要指标：本周小区挂牌均价（元/m²）、近一年小区成交均价 +- [ ] **挂牌量分布区块**： + - 以户型为维度展示分布（如"3室挂牌分布情况"） + - 环形图展示该户型挂牌套数占总挂牌比例 + - 标注：3室挂牌套数 / 小区挂牌套数（蓝色可点击数字，跳转房源列表） + - 展示该户型挂牌价格分布：大多数业主的选择（中间价区间）/ 最低价 / 最高价（万） +- [ ] **成交分布情况区块**：展示户型维度成交分布，无数据时显示空状态"暂无数据" +- [ ] **挂牌均价趋势折线图**： + - 支持按"按周"/ "按月"切换时间粒度（按钮组切换） + - X轴为时间，Y轴为价格（万/m²） + - 双折线：本小区（橙红色实线）/ 本商圈（蓝色实线） + - 图例位于左上角，鼠标悬浮显示具体数值 Tooltip +- [ ] **成交均价趋势折线图**： + - X轴为时间（月份），Y轴为价格 + - 单折线：本小区 + - 无数据时图表显示空状态 +- [ ] **本小区成交数据明细（近一年）**： + - 数据免责说明："数据实时更新，公司设置了我售房源展示保护规则，仅列出展示权限内的成交记录" + - 表格列：房源编号 / 挂牌价格（万）/ 价差（万）/ 成交价格（万）/ 成交单价（元/m²）/ 成交周期（天）/ 户型 / 面积（m²）/ 楼层 / 朝向 / 装修 / 挂日期 / 成交日期 + - 无数据时展示空状态"暂无数据" + +--- + +### Story 8：经纪人查看楼盘周边配套 + +**As** 一线经纪人，**I want** 在楼盘详情页查看该楼盘周边的交通/教育/医疗/购物/生活/娱乐配套，**So that** 在带客时快速回答客户关于生活便利性的问题，增强成交转化。 + +**验收标准**： +- [ ] 周边配套 Tab 以地图为主体，楼盘位置以橙色标记点展示在地图上 +- [ ] 右侧面板提供分类 Tab 过滤：**交通** / **教育** / **医疗** / **购物** / **生活** / **娱乐** +- [ ] 教育类下提供二级过滤：**幼儿园** / **小学** / **中学** / **大学** +- [ ] 右侧列表展示该分类下周边设施，每条记录包含： + - 设施图标 + 设施名称 + - 线路/地址（灰色小字） + - 距楼盘直线距离（如"1227米"） +- [ ] 地图上以彩色 Pin 标注对应类别的设施位置，与右侧列表联动 +- [ ] 地图支持缩放和拖拽操作 +- [ ] 周边数据由第三方地图 API 提供（接入规范另行定义） + +--- + +### Story 9：运营人员管理城区与商圈 + +**As** 运营/数据管理员，**I want** 在区域管理模块中维护城区和商圈的二级区域体系，**So that** 为房源、楼盘、客源的区域筛选和统计提供规范的地理基础数据。 + +**验收标准**： + +#### 区域管理入口 + +- [ ] 楼盘管理页面顶部 Tab 导航：楼盘 / **区域管理** / 学校管理 / 应用标准数据 + +#### 城区管理 + +- [ ] 切换至"城区管理"子 Tab，展示城区列表，字段：城区名称 / 商圈数量 / 楼盘数量 / 坐标 +- [ ] 支持按城区名称关键词搜索（"查询"按钮触发，"重置"清空） +- [ ] 支持按有无坐标过滤：不限 / 有坐标 / 无坐标 +- [ ] 批量操作：合并城区（勾选后激活"合并城区"按钮） +- [ ] 操作列：修改 / 设置坐标 +- [ ] "新增城区"按钮（橙色，右上角） +- [ ] 商圈数量和楼盘数量为蓝色可点击数字，点击跳转查看关联数据 +- [ ] 分页（20条/页），显示总条数 + +#### 商圈管理 + +- [ ] 切换至"商圈管理"子 Tab，展示商圈列表，字段：城区名称 / 商圈名称（含标准标签）/ 楼盘数量 / 坐标 +- [ ] 支持按商圈名称关键词搜索 +- [ ] 支持按城区过滤（多个城区单选展示，如：上海周边/徐汇/宝山等） +- [ ] 支持按有无坐标过滤：不限 / 有坐标 / 无坐标 +- [ ] 批量操作：合并商圈 / 转移商圈 +- [ ] 操作列：修改 / 查看关联关系 / 设置坐标 +- [ ] "新增商圈"按钮（橙色，右上角） + +--- + +### Story 10：运营人员新增/编辑商圈 + +**As** 运营/数据管理员，**I want** 通过弹窗快速新增或修改商圈信息，**So that** 保持区域数据的及时更新，不需要跳转页面打断工作流。 + +**验收标准**： +- [ ] 点击"修改"或"新增商圈"触发浮窗（Modal） +- [ ] 浮窗标题：修改商圈 / 新增商圈 +- [ ] 字段： + - **所属城区**（下拉，必填）：选择该商圈归属的城区 + - **商圈名称**（文本输入，必填）：商圈名称，如"南通" +- [ ] 必填字段未填时，点击"确认修改"弹出错误提示 +- [ ] 确认后浮窗关闭，商圈列表即时刷新 + +--- + +### Story 11：运营人员查看商圈关联关系 + +**As** 运营/数据管理员，**I want** 查看本地商圈与标准商圈之间的映射关系，并在需要时修改关联，**So that** 跨区域数据统计时能正确聚合同一商圈下不同分公司的数据。 + +**验收标准**： +- [ ] 点击商圈列表操作列"查看关联关系"，跳转至"查看关联情况"独立页面 +- [ ] 页面顶部筛选区：标准区域（下拉，请选择）/ 本地区域（下拉，默认回填当前商圈所属城区+商圈） +- [ ] 点击"查询"触发搜索，"重置"清空条件 +- [ ] 结果列表字段：标准城市 / 标准城区 / 标准商圈 / 关联本地商圈 / 本地商圈所属城区 / 操作（"变更"链接） +- [ ] 支持批量修改（勾选后激活"批量修改"按钮） +- [ ] 分页（20条/页） + +--- + +### Story 12：运营人员管理学校信息 + +**As** 运营/数据管理员，**I want** 在学校管理模块中维护学校基础信息，并将学校与楼盘关联，**So that** 经纪人在房源录入和客户带看时能快速调用准确的学区数据，提升学区房的推荐效率。 + +**验收标准**： + +#### 学校列表 + +- [ ] 楼盘管理顶部 Tab 导航切换至"学校管理" +- [ ] 支持按学校名称关键词搜索（"查询"按钮触发） +- [ ] 支持按城区过滤（单选城区标签：不限 / 宝山 / 崇明 / 奉贤等） +- [ ] 批量操作："批量删除"按钮（勾选后激活） +- [ ] 新增操作："+ 新增学校"橙色按钮 +- [ ] 列表字段：学校名称 / 城区 / 学校地址 / 类型（幼儿园/小学/初中/高中/九年制/九年一贯制等）/ 级别（普通/重点/区重点等）/ 性质（公立/私立）/ 操作（编辑/删除） +- [ ] 分页（20条/页），显示总条数（如"共1503条"），支持跳页 + +#### 编辑/新增学校（浮窗） + +- [ ] 点击"编辑"或"新增学校"触发浮窗（Modal），标题：编辑学校 / 新增学校 +- [ ] 字段： + +| 字段 | 类型 | 必填 | 说明 | +|------|------|------|------| +| 学校名称 | 文本输入 | 是 | 红色*标注，输入框提示"学校名称" | +| 城区 | 下拉 | 是 | 红色*标注，选择所属行政区 | +| 地址 | 文本输入 | 否 | 学校具体地址，如"郭守敬路111号" | +| 学校类型 | 下拉 | 否 | 幼儿园 / 小学 / 初中 / 高中 / 九年制 / 九年一贯制 / 大学等 | +| 办学性质 | 下拉 | 否 | 公立 / 私立 | +| 级别 | 下拉 | 否 | 普通 / 重点 / 区重点 等 | + +- [ ] 必填字段（学校名称、城区）未填时，点击"确定"弹出错误提示并定位到对应字段 +- [ ] 点击"取消"关闭浮窗，不保存 +- [ ] 保存成功后浮窗关闭，列表即时刷新，新增/修改的学校显示在列表中 + +--- + +## 5. 功能详细说明 + +### 5.1 楼盘列表 + +#### 5.1.1 页面结构 + +楼盘管理页面为系统管理后台的核心数据管理页面，整体布局如下： + +**顶部 Tab 导航**（模块级）： +- 楼盘（当前） +- 区域管理 +- 学校管理 +- 应用标准数据（本期不做） + +**数据完整度统计面板**（顶部横向展示）： + +| 指标 | 说明 | +|------|------| +| 楼盘关联率 | 有房源关联的楼盘占比 | +| 楼栋及单元完整率 | 已完善楼栋/单元信息的楼盘占比 | +| 房号匹配率 | 房源已匹配到具体房号的占比 | +| 处置率 | 已处置异常数据的占比 | +| 入住人结构数据 | 有入住人信息的结构数量 | +| 有效结构数量 | 系统中有效结构总量 | +| 房源对标 | 房源与标准结构匹配度 | + +提供"重新计算"按钮手动刷新统计数据。 + +#### 5.1.2 搜索与筛选 + +**关键词搜索**： +- 搜索范围：楼盘名称 / 别名 / 供货商 / 详细地址 +- 点击"查询"执行，"清除"重置 + +**维度筛选**（水平横排，支持多维组合）： + +| 筛选维度 | 选项示例 | +|----------|----------| +| 区域 | 不限 / 静安 / 闵行 / 普陀 / 松江 / 长宁 等行政区 | +| 用途 | 不限 / 住宅 / 别墅 / 商住 / 商业 / 写字楼 / 其他 | +| 固定情况 | 下拉选择 | +| 完善情况 | 下拉选择 | +| 楼盘类型 | 下拉选择 | +| 楼标号小区非标结构情况 | 下拉选择 | +| 有无房源 | 下拉选择 | +| 楼栋类型 | 下拉选择 | +| 权属关系 | 下拉选择 | +| 有无坐标 | 下拉选择 | + +#### 5.1.3 列表字段说明 + +| 字段 | 说明 | +|------|------| +| 楼盘名称 | 蓝色可点击链接，跳转楼盘详情；行内附"信息"/"标准楼盘"/"标准楼栋"/"标准房号"等快捷标签 | +| 楼盘类型 | 住宅/别墅/商住/商业等 | +| 详细地址 | 楼盘完整地址 | +| 城区商圈 | 所属城区-商圈 | +| 当月挂牌均价（元/m²） | 本月该楼盘挂牌房源的平均单价，支持排序 | +| 楼栋数 | 该楼盘下已录入的楼栋总数，数字可点击 | +| 产品数 | 房源/户型产品数量 | +| 房源数 | 格式：出售N/出租N/共N，蓝色数字可点击跳转房源列表 | +| 操作 | 编辑 / 删除 | + +#### 5.1.4 批量操作 + +| 操作 | 说明 | +|------|------| +| 批量新增楼栋 | 为勾选楼盘批量新增楼栋 | +| 批改区域商圈 | 批量修改选中楼盘的所属区域/商圈 | +| 删除 | 批量删除（需二次确认） | +| 合并楼盘 | 将多个楼盘合并为一个标准楼盘 | + +--- + +### 5.2 楼盘详情 + +#### 5.2.1 详情页顶部区域 + +**楼盘标题**：展示楼盘的完整名称（主名称 + 括号内别名列表），多个别名以顿号分隔。 + +**权限标签**（4类锁定标志，锁状图标）： + +| 标签 | 含义 | +|------|------| +| 楼栋 🔒 | 楼栋信息已锁定，不可随意修改 | +| 房号 🔒 | 房号信息已锁定 | +| 信息 🔒 | 楼盘基本信息已锁定 | +| 标准房号 🔒 | 已关联标准房号，不可随意变更 | + +**"解锁楼盘"按钮**（橙色，右上角，受权限控制） + +**Tab 导航**（楼盘详情内部 Tab）： + +| Tab | 说明 | +|-----|------| +| 楼盘信息 | 楼盘基础数据（基本信息/对口学校/其他信息） | +| 楼栋管理 | 楼栋/单元列表管理 | +| 结构管理 | 楼层-房号矩阵管理 | +| 楼盘照片 | 楼盘图片/户型图/VR管理 | +| 楼盘附件 | 楼盘相关文件附件 | +| 周边配套 | 地图+周边设施信息 | +| 楼盘价格走势 | 挂牌价/成交价走势图表 | +| 销控盘 | 新房/销控相关（本期不展开） | + +--- + +### 5.3 楼栋管理 + +楼栋管理采用列表视图，以"单元"为基本管理单元（对于别墅类楼盘，每个独立门牌号视为一个单元）。 + +**关键设计决策**： +- 楼栋结构的最小粒度为"单元"，单元下才挂楼层和房号 +- 标准单元有"标准"标签，非标结构另行标记，支持通过"申请新增"发起数据标准化申请 +- 批量操作（设置单元信息/合并/移动）支持跨楼盘的单元管理 + +--- + +### 5.4 结构管理 + +结构管理提供"左侧单元列表 + 右侧楼层-房号矩阵"的双栏布局： + +- **左侧**：当前楼盘所有单元列表，支持多选；选中单元以橙色高亮，矩阵区同步更新 +- **右侧矩阵**：行为楼层名（显示实际层数，如"1（1层）"），列为房号，矩阵单元格显示具体房号及标准/非标标签 + +**设计原则**：矩阵布局让数据管理员能一眼看清每层每号的覆盖情况，快速定位缺失房号。 + +--- + +### 5.5 楼盘照片 + +照片管理分三类 Tab，不同类别的照片有不同的管理逻辑： + +| 类别 | 上传权限 | 管理方式 | +|------|---------|---------| +| 楼盘图片 | 运营人员可上传 | 自由上传，分类管理 | +| 户型图 | 标准库只读，本地上传可维护 | 标准户型图不可编辑；推荐图/本地上传可管理 | +| 楼盘VR | 运营人员可上传 | 上传 VR 资源文件 | + +户型图的子 Tab 分类机制： +- **推荐户型图**：系统推荐的标准图，只读查看 +- **标准户型图**：标准数据库中的户型图，只读查看 +- **VR户型图**：VR 格式的户型图 +- **本地上传**：公司自行上传的户型图，可编辑 + +户型图支持按户型（室数）和朝向双维度过滤，方便快速定位特定类型的户型图。 + +--- + +### 5.6 楼盘价格走势 + +价格走势功能提供楼盘级别的市场行情可视化，帮助经纪人建立数据支撑下的市场认知。 + +**数据来源说明**： +- **司内数据**：来自本公司系统内房源挂牌和成交记录，T+1 更新，数据准确但可能样本量有限 +- **市场数据**：来自市场/网签数据，T+1 更新，仅供参考 + +**核心可视化组件**： + +1. **挂牌量分布图（环形图）**：直观展示各户型在总挂牌量中的占比，配合价格区间（最低/大多数业主选择/最高）为经纪人提供定价参考 +2. **成交分布图**：户型维度的历史成交情况 +3. **挂牌均价趋势折线图**：支持按周/按月切换，双折线（小区 vs 商圈）对比，帮助经纪人判断本楼盘相对商圈的价格偏离度 +4. **成交均价趋势折线图**：月度维度的成交均价历史走势 +5. **成交明细表格**：近一年成交记录，字段完整，支持经纪人做具体的价格比对分析 + +--- + +### 5.7 周边配套 + +周边配套采用"地图主视图 + 右侧分类列表"的双栏布局，数据由第三方地图 API 提供。 + +**分类体系**： + +| 一级分类 | 二级分类（示例） | +|---------|----------------| +| 交通 | 地铁站/公交站/高速出入口等 | +| 教育 | 幼儿园 / 小学 / 中学 / 大学 | +| 医疗 | 医院/诊所/药店等 | +| 购物 | 超市/商场/菜市场等 | +| 生活 | 银行/邮局/政务服务等 | +| 娱乐 | 公园/影院/健身房等 | + +每条设施记录展示：名称 + 地址/线路 + 距楼盘直线距离（米）。 + +--- + +### 5.8 区域管理 + +区域管理分为"城区管理"和"商圈管理"两个子模块，共同构建城区-商圈两级区域数据体系。 + +#### 5.8.1 城区管理 + +城区为区域体系的第一级，对应行政区划（如：闵行/长宁/嘉定等）。 + +**核心功能**： +- 列表展示（城区名称/商圈数量/楼盘数量/坐标） +- 支持合并城区（处理历史数据中的同一区域多名称问题） +- 支持修改城区名称 +- 支持设置城区坐标（经纬度，用于地图展示） + +#### 5.8.2 商圈管理 + +商圈为区域体系的第二级，归属于特定城区（如：嘉定-江桥新城）。 + +**核心功能**： +- 列表展示（城区名称/商圈名称/楼盘数量/坐标） +- 新增/修改商圈（浮窗操作，字段：所属城区+商圈名称） +- 合并商圈（多个历史商圈名称合并为一个标准商圈） +- 转移商圈（将商圈从一个城区移至另一个城区） +- 设置坐标 +- 查看关联关系 + +#### 5.8.3 商圈关联关系 + +商圈关联关系用于处理本地区域数据与全国标准区域数据的映射，支持跨城市分公司的数据统一。 + +**页面字段**：标准城市 / 标准城区 / 标准商圈 / 关联本地商圈 / 本地商圈所属城区 / 操作（变更） + +**使用场景**：当系统引入国家/行业标准区域体系时，需要将历史本地商圈数据映射至标准商圈，此页面提供查看和变更能力。 + +--- + +### 5.9 学校管理 + +学校管理维护可供楼盘和房源关联的学校数据库，是学区房推荐的基础数据支撑。 + +#### 5.9.1 学校列表 + +支持按名称搜索 + 城区过滤，展示字段：学校名称/城区/学校地址/类型/级别/性质。 + +**学校类型枚举**：幼儿园 / 小学 / 初中 / 高中 / 九年制 / 九年一贯制 / 大学 + +**学校级别枚举**：普通 / 重点 / 区重点 + +**办学性质枚举**：公立 / 私立 + +#### 5.9.2 新增/编辑学校（浮窗） + +浮窗操作，字段简洁：学校名称（必填）/ 城区（必填）/ 地址 / 学校类型 / 办学性质 / 级别。 + +必填项校验，确认后列表即时刷新，无需跳转页面。 + +--- + +## 6. 技术考量 + +### 6.1 依赖项 + +| 系统/模块 | 依赖原因 | 时间线风险 | +|-----------|---------|-----------| +| 地图服务 API | 周边配套数据来源、楼盘坐标定位功能 | 中（需确定采购哪家地图供应商） | +| 第三方价格数据 | 楼盘价格走势-市场数据 Tab | 中（数据接口规范需另行对接） | +| 房源管理模块 | 房源与楼盘的关联关系 | 低（已有设计） | +| 权限管理模块 | 楼盘锁定/解锁权限、数据编辑权限 | 低（权限模块统一管理） | + +### 6.2 已知风险 + +| 风险 | 可能性 | 影响 | 缓解措施 | +|------|-------|------|---------| +| 历史楼盘数据清洗工作量大 | 高 | 高 | 上线前做数据迁移专项，优先处理有房源关联的楼盘 | +| 地图 API 数据延迟/不准确 | 中 | 低 | 周边配套数据仅供参考，界面明确标注数据来源 | +| 楼栋结构标准化周期长 | 高 | 中 | 分阶段推进，先保障主要楼盘，长尾楼盘后续持续补充 | +| 标准区域体系与本地区域冲突 | 中 | 中 | 提供关联关系映射功能，不强制替换本地区域体系 | + +### 6.3 待确认问题（开发前必须解决） + +- [ ] **坐标系标准**：楼盘坐标采用 WGS84 还是 GCJ-02（国测局坐标）？— Owner: 技术负责人 — 截止: 开发启动前 +- [ ] **地图 API 选型**：周边配套数据采用高德/百度/腾讯地图哪个 API？— Owner: 产品/采购 — 截止: 开发启动前 +- [ ] **楼盘锁定权限粒度**：楼盘/房号/楼栋/信息四类锁各自对应哪些角色可以编辑/解锁？— Owner: 产品经理 + 客户方确认 — 截止: 开发启动前 +- [ ] **历史数据迁移策略**：现有楼盘数据如何迁移到新系统？是否需要数据清洗脚本？— Owner: 技术负责人 — 截止: 开发启动前 + +--- + +## 7. 上线计划 + +| 阶段 | 时间 | 受众 | 成功标准 | +|------|------|------|---------| +| 内部 Alpha | TBD | 产品+技术+运营团队 | 核心流程无 P0 Bug，数据增删改查正常 | +| 运营灰度 | TBD | 数据管理员（3-5人） | 楼盘/楼栋/区域/学校 CRUD 功能可用，无数据丢失 | +| GA | TBD | 全员开放 | 楼盘完整度指标提升，经纪人可正常查询楼盘详情和价格走势 | + +**回滚标准**：楼盘数据查询错误率 > 1% 或核心写操作失败率 > 0.5%，立即回滚并告警。 + +--- + +## 8. 附录 + +### 8.1 截图参考索引 + +| 截图文件 | 对应章节 | +|---------|---------| +| `楼盘管理.png` | 5.1 楼盘列表 | +| `楼盘信息.png` | 5.2.1 楼盘信息 Tab（查看态） | +| `编辑楼盘信息.png` | Story 3 / 5.2.1（编辑态） | +| `楼栋管理.png` | 5.3 楼栋管理 | +| `结构管理.png` | 5.4 结构管理 | +| `楼盘照片.png` | 5.5 楼盘照片（户型图 Tab） | +| `楼盘价格走势.png` | 5.6 楼盘价格走势（司内数据） | +| `周边配套.png` | 5.7 周边配套（教育-幼儿园） | +| `区域管理.png` | 5.8.1 城区管理列表 | +| `编辑商圈.png` | 5.8.2 商圈管理-编辑浮窗 | +| `查看关联.png` | 5.8.3 商圈关联关系页面 | +| `学校管理.png` | 5.9.1 学校列表 | +| `编辑学校.png` | 5.9.2 新增/编辑学校浮窗 | + +### 8.2 数据枚举汇总 + +**楼盘类型（物业类型）**：住宅 / 别墅 / 商住 / 商业 / 写字楼 / 其他 + +**建筑类型**：板楼 / 塔楼 / 板塔结合 + +**楼栋结构**：单元-房号 / 其他 + +**土地使用年限**：40年 / 50年 / 70年 / 永久产权 + +**权属类别**：商品房住宅 / 房改房 / 集资房 / 经济活用房 + +**学校类型**：幼儿园 / 小学 / 初中 / 高中 / 九年制 / 九年一贯制 / 大学 + +**学校级别**：普通 / 重点 / 区重点 + +**办学性质**：公立 / 私立 + +**周边配套一级分类**：交通 / 教育 / 医疗 / 购物 / 生活 / 娱乐 + +**户型图类型（子Tab）**：推荐户型图 / 标准户型图 / VR户型图 / 本地上传 diff --git a/wiki/entities/gog-CLI.md b/wiki/entities/gog-CLI.md new file mode 100644 index 00000000..9ed74e46 --- /dev/null +++ b/wiki/entities/gog-CLI.md @@ -0,0 +1,48 @@ +--- +title: "gog CLI" +type: entity +tags: [google-workspace, cli, macos] +last_updated: 2026-03-15 +--- + +# gog CLI + +## Overview +gog CLI（gogcli）是由 steipete 开发的 Google Workspace 命令行管理工具，通过 Homebrew 安装（`brew install steipete/tap/gogcli`），输出路径为 `/opt/homebrew/bin/gog`。支持 Gmail、Google Calendar、Google Drive、Google Contacts、Google Docs、Google Sheets 全套服务的管理。 + +## Aliases +- gogcli +- gog CLI +- Gog CLI + +## Details + +| 属性 | 值 | +|------|-----| +| 类型 | 产品 / 工具 | +| 作者 | steipete | +| GitHub | github.com/steipete/gogcli | +| 官网 | gogcli.sh | +| 平台 | macOS（Homebrew） | +| 认证方式 | OAuth 2.0 | + +## Supported Services +- **Gmail**：搜索、发送、创建草稿 +- **Google Calendar**：查看事件、创建事件 +- **Google Drive**：搜索文件 +- **Google Contacts**：列出联系人 +- **Google Sheets**：获取/更新数据 +- **Google Docs**：导出文档、查看内容 + +## Key Dependencies +- **OAuth 凭证**：需要从 Google Cloud Console 下载 `credentials.json` 并放置到 `~/Library/Application Support/gogcli/credentials.json` +- **Google Cloud Console**：用于创建 OAuth 客户端 ID 和启用各 API 服务 +- **测试用户白名单**：首次授权需要将 Google 账号邮箱添加到 OAuth 客户端的测试用户列表 + +## Related Entities +- [[Google]] — Google 公司 +- [[personal-crm]] — 使用 gog CLI 提供 Gmail 和 Calendar 数据 +- [[multi-channel-assistant]] — 整合 Google Workspace（gog） + +## Related Sources +- [[gog-cli-安装配置指南]] — 完整安装与配置指南 diff --git a/wiki/index.md b/wiki/index.md index dbb45706..b5152898 100644 --- a/wiki/index.md +++ b/wiki/index.md @@ -4,6 +4,8 @@ - [Overview](overview.md) — living synthesis ## Sources +- [2026-04-23] [Scrapy + Playwright 抓取TikTok Shop Data](sources/scrapy-playwright-抓取tiktok-shop-data.md) +- [2026-04-23] [GOG CLI 安装配置指南](sources/gog-cli-安装配置指南.md) - [2026-04-23] [Last30Days 使用指南](sources/last30days-使用指南.md) - [2026-04-23] [如何利用Sora接口实现视频自动化生成工作流](sources/如何利用sora接口实现视频自动化生成工作流.md) - [2026-04-23] [If You Have Multiple Interests, Do Not Waste the Next 2-3 Years](sources/if-you-have-multiple-interests-do-not-waste-the-next-2-3-years-如果你有多项兴趣爱好-不要浪费接下来的两三年时间.md) @@ -176,7 +178,6 @@ - [2026-04-21] [obsidian-必装-skills](sources/obsidian-必装-skills.md) — (expected: wiki/sources/obsidian-必装-skills.md — source missing) - [2026-04-21] [marketing-weibo-strategist](sources/marketing-weibo-strategist.md) — (expected: wiki/sources/marketing-weibo-strategist.md — source missing) - [2026-04-21] [marketing-baidu-seo-specialist](sources/marketing-baidu-seo-specialist.md) — (expected: wiki/sources/marketing-baidu-seo-specialist.md — source missing) -- [2026-04-21] [gog-cli-安装配置指南](sources/gog-cli-安装配置指南.md) — (expected: wiki/sources/gog-cli-安装配置指南.md — source missing) - [2026-04-21] [marketing-carousel-growth-engine](sources/marketing-carousel-growth-engine.md) — (expected: wiki/sources/marketing-carousel-growth-engine.md — source missing) - [2026-04-21] [marketing-private-domain-operator](sources/marketing-private-domain-operator.md) — (expected: wiki/sources/marketing-private-domain-operator.md — source missing) - [2026-04-21] [marketing-short-video-editing-coach](sources/marketing-short-video-editing-coach.md) — (expected: wiki/sources/marketing-short-video-editing-coach.md — source missing) @@ -413,7 +414,6 @@ - [2026-04-18] [做tk跨境思路不对努力白费](sources/做tk跨境思路不对努力白费.md) — (expected: wiki/sources/做tk跨境思路不对努力白费.md — source missing) - [2026-04-18] [超达物流定价](sources/超达物流定价.md) — (expected: wiki/sources/超达物流定价.md — source missing) - [2026-04-18] [tk美国面单授权及操作流程](sources/tk美国面单授权及操作流程.md) — (expected: wiki/sources/tk美国面单授权及操作流程.md — source missing) -- [2026-04-18] [scrapy-playwright-抓取tiktok-shop-data](sources/scrapy-playwright-抓取tiktok-shop-data.md) — (expected: wiki/sources/scrapy-playwright-抓取tiktok-shop-data.md — source missing) - [Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog](sources/Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog.md) — (expected: wiki/sources/Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog.md — source missing) - [Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend](sources/Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend.md) — (expected: wiki/sources/Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend.md — source missing) - [zk-steward](sources/zk-steward.md) — (expected: wiki/sources/zk-steward.md — source missing) @@ -601,6 +601,7 @@ - [Gitea](entities/Gitea.md) - [glances](entities/glances.md) - [gog](entities/gog.md) +- [gog-CLI](entities/gog-CLI.md) - [Google](entities/Google.md) - [Google-Cloud](entities/Google-Cloud.md) - [GoogleCloud](entities/GoogleCloud.md) diff --git a/wiki/log.md b/wiki/log.md index 681865ee..7289424f 100644 --- a/wiki/log.md +++ b/wiki/log.md @@ -1,4 +1,33 @@ -## [2026-04-26] ingest | Last30Days 使用指南 +## [2026-04-24] ingest | Scrapy + Playwright 抓取TikTok Shop Data +- Source file: 跨境电商/Scrapy + Playwright 抓取TikTok Shop Data.md +- Status: ✅ 成功摄入 +- Summary: 使用 Scrapy + Playwright 技术栈抓取 TikTok Shop 商家数据的环境配置与运行指南。涵盖 Python venv 虚拟环境搭建、scrapy-playwright 依赖安装、Chromium 浏览器安装、Docker 容器化部署配置，以及 Playwright 验证方法。 +- Concepts touched: [[Scrapy]], [[Playwright]], [[scrapy-playwright]], [[venv]], [[Docker]], [[Chromium]] +- Entities touched: [[TikTok Shop]], [[shenwei]] +- Source page: wiki/sources/scrapy-playwright-抓取tiktok-shop-data.md +- Notes: + - 新增 1 个 Source Page（wiki/sources/scrapy-playwright-抓取tiktok-shop-data.md） + - Concept 和 Entity 均以 wikilink 形式建立关联，暂不创建独立页面（各仅出现 1 次，未达 ≥2 次阈值） + - 冲突检测：无已知冲突内容 + - 已在 index.md 添加 Source 条目 + - overview.md 无需更新（TikTok Shop 已存在于 Key Entities，Scrapy/Playwright 属技术工具不需独立概念页） + +## [2026-04-23] ingest | GOG CLI 安装配置指南 +- Source file: Skills/GOG-CLI-安装配置指南.md +- Status: ✅ 成功摄入 +- Summary: gog CLI（Google Workspace 命令行工具）在 macOS 系统上的完整安装与配置流程。涵盖 Homebrew 安装、OAuth 凭证配置、测试用户白名单添加、Google API 启用、常用命令速查及故障排除。 +- Concepts touched: [[OAuth 2.0]], [[Google Cloud Console]], [[API Enablement]], [[Google Workspace]] +- Entities touched: [[gog CLI]] +- Source page: wiki/sources/gog-cli-安装配置指南.md +- Notes: + - 新增 1 个 Source Page（wiki/sources/gog-cli-安装配置指南.md） + - 新增 1 个 Entity Page（wiki/entities/gog-CLI.md） + - 冲突检测：无已知冲突内容 + - 已在 index.md 修正 Source 条目（去除 "(expected: source missing)" 标注） + - 已在 overview.md Key Entities 添加 [[gog CLI]] 条目 + - 已在 overview.md Key Concepts 添加 [[OAuth 2.0]], [[Google Cloud Console]], [[API Enablement]] + + - Source file: Skills/Last30Days-使用指南.md - Status: ✅ 成功摄入 - Summary: Last30Days 方法论——通过 AI Agent 自动化追踪近30天内新增/更新的内容源，避免信息过载。核心价值：将"主动订阅"转变为"被动接收"，用 AI 替代人工巡检，节省 80% 信息搜集时间。 diff --git a/wiki/overview.md b/wiki/overview.md index c0814b37..c07aa726 100644 --- a/wiki/overview.md +++ b/wiki/overview.md @@ -189,7 +189,7 @@ Covers Claude Code, Claude Code Templates (npx 一键安装 Skills/Agents/MCP vi **[[我的工具集]]**：个人 AI 工具推荐清单，按类型分类（Text-to-Speech / Image-Editor / Image-to-Video / Web-Scraper / AI-Summary），每类列出工具名称、提供商、定价和链接。覆盖 Google AI Studio（Wavespeed 图生视频、Vidu $8/月、海螺 AI ¥42/月）、Brightdata（付费网页爬取）、Decopy（AI 摘要/思维导图/多语言输出）。与 [[AI图生视频工具盘点]] 互补——前者侧重工具索引清单，后者侧重免费工具详细评测。 -Key concepts: [[AI簡報工作流]], [[AI圖生視頻工具]], [[文字生成視頻]], [[電商場景]], [[AI工具整合]], [[ChatGPT]], [[Canva]], [[Gamma AI]], [[Morning Briefing]], [[Todoist API]], [[AI-Driven Task Extraction]], [[TaskAutomation]], [[Recurring Tasks]], [[MeetingNotes]], [[ActionItemTracking]], [[TranscriptProcessing]], [[RAG从入门到精通系列]], [[Agent Personality Design]], [[Vibe Coding]], [[Design-to-Code Workflow]], [[Multi-AI Review]], [[CodeWeaver]], [[LLM Wiki]], [[多智能体系统可靠性]], [[Plan Mode]], [[Build Mode]], [[Workspace]], [[Agent-Memory]], [[Claude Code Templates]], [[MCP（Model Context Protocol）]], [[Remote-SSH]], [[Bind Mount]], [[Attach 容器]], [[Docker 用户组]], [[SSH Config]], [[SSH 免密登录]], [[Vibe-Kanban]], [[OpenCode]], [[nvm]], [[pm2]], [[单一职责原则]], [[DRY原则]], [[模块化编程]], [[微服务架构]], [[Redis缓存]], [[消息队列]], [[输入-处理-输出模型]], [[并发编程]], [[Pain Point Mining]], [[Startup MVP Pipeline]], [[Agent-Driven Market Research]], [[Last 30 Days Method]], [[Pre-Build Validation]], [[Reality-Signal]], [[Competition-Analysis]], [[Pivot-Strategy]], [[Agent-Build-Gate]], [[CoworkWorkspace]], [[RemoteRescuePattern]], [[Multi-AgentHub]], [[MCPOnceAllAgents]], [[Personalization]], [[Custom Instructions]], [[Proactive AI]], [[Expert User Assumption]], [[Error Accountability]] +Key concepts: [[AI簡報工作流]], [[AI圖生視頻工具]], [[文字生成視頻]], [[電商場景]], [[AI工具整合]], [[ChatGPT]], [[Canva]], [[Gamma AI]], [[Morning Briefing]], [[Todoist API]], [[AI-Driven Task Extraction]], [[TaskAutomation]], [[Recurring Tasks]], [[MeetingNotes]], [[ActionItemTracking]], [[TranscriptProcessing]], [[RAG从入门到精通系列]], [[Agent Personality Design]], [[Vibe Coding]], [[Design-to-Code Workflow]], [[Multi-AI Review]], [[CodeWeaver]], [[LLM Wiki]], [[多智能体系统可靠性]], [[Plan Mode]], [[Build Mode]], [[Workspace]], [[API Enablement]], [[OAuth 2.0]], [[Google Cloud Console]], [[Agent-Memory]], [[Claude Code Templates]], [[MCP（Model Context Protocol）]], [[Remote-SSH]], [[Bind Mount]], [[Attach 容器]], [[Docker 用户组]], [[SSH Config]], [[SSH 免密登录]], [[Vibe-Kanban]], [[OpenCode]], [[nvm]], [[pm2]], [[单一职责原则]], [[DRY原则]], [[模块化编程]], [[微服务架构]], [[Redis缓存]], [[消息队列]], [[输入-处理-输出模型]], [[并发编程]], [[Pain Point Mining]], [[Startup MVP Pipeline]], [[Agent-Driven Market Research]], [[Last 30 Days Method]], [[Pre-Build Validation]], [[Reality-Signal]], [[Competition-Analysis]], [[Pivot-Strategy]], [[Agent-Build-Gate]], [[CoworkWorkspace]], [[RemoteRescuePattern]], [[Multi-AgentHub]], [[MCPOnceAllAgents]], [[Personalization]], [[Custom Instructions]], [[Proactive AI]], [[Expert User Assumption]], [[Error Accountability]] ### Productivity & Knowledge Management Obsidian plugins, blogwatcher RSS monitoring, Quartz static site generation, project management systems, and personal CRM frameworks. QuickAdd plugin enables quick note capture via hotkeys for rapid idea recording. @@ -238,6 +238,7 @@ Key concepts: [[Generalist]], [[Self-Education]], [[Self-Interest]], [[Self-Suff - [[AionUi]] — 桌面多 Agent Hub（macOS/Windows/Linux），将 OpenClaw 作为可视化 Cowork Agent 运行，支持内置远程救援专家和统一 MCP 配置 - [[n8n]] — workflow automation - [[Node.js]] — JavaScript 运行时环境，n8n-mcp 的运行依赖，也是 [[n8n]] 工作流引擎的后端运行环境 +- [[gog CLI]] — 由 steipete 开发的 Google Workspace 命令行管理工具（Homebrew 安装），支持 Gmail/Calendar/Drive/Contacts/Docs/Sheets 全套服务，[[personal-crm]] 和 [[multi-channel-assistant]] 的前置依赖 - [[Quartz]] — static site generator for wikis - [[RSSHub]] — open-source RSS aggregator - [[RackNerd]]：低总价OpenVZ/KVM VPS提供商，本方案中托管公网VPS1（192.227.222.142, vps.ishenwei.online），运行frps服务端（端口7000）和Caddy自动HTTPS反向代理（*.ishenwei.online），作为全网内网服务的统一公网入口 diff --git a/wiki/sources/gog-cli-安装配置指南.md b/wiki/sources/gog-cli-安装配置指南.md new file mode 100644 index 00000000..d5e855c7 --- /dev/null +++ b/wiki/sources/gog-cli-安装配置指南.md @@ -0,0 +1,45 @@ +--- +title: "GOG CLI 安装配置指南" +type: source +tags: [gog, gog-cli, macos, google-workspace] +date: 2026-03-15 +--- + +## Source File +- [[Skills/GOG-CLI-安装配置指南.md]] + +## Summary（用中文描述） +- 核心主题：gog CLI（Google Workspace 命令行工具）在 macOS 系统上的完整安装与配置流程 +- 问题域：如何通过命令行管理 Google Workspace 全套服务（Gmail、Google Calendar、Google Drive、Google Contacts、Google Docs、Google Sheets），并与 AI Agent 工作流集成 +- 方法/机制：Homebrew 安装 → Google Cloud Console 创建 OAuth 凭证 → 移动凭证文件到 gogcli 配置目录 → 添加测试用户解除 Google 安全限制 → 启用各 Google API → 验证授权状态 +- 结论/价值：实现通过命令行管理 Google Workspace 全套服务的能力，可集成到 AI Agent 工作流中（自动邮件处理、日历管理等） + +## Key Claims（用中文描述） +- Homebrew 可通过 `brew install steipete/tap/gogcli` 一键安装 gog CLI，输出路径为 `/opt/homebrew/bin/gog` +- OAuth 凭证需要放置在 `/Users/weishen/Library/Application Support/gogcli/credentials.json`，并通过 `gog auth credentials` 命令指定路径 +- 首次授权时 Google 会阻止未验证应用，需要在 Google Cloud Console 的 OAuth 客户端中将测试用户邮箱加入白名单才能通过授权 +- Google API 调用需要同时满足两个条件：OAuth 授权成功 + API 已启用（Enabling），缺一不可 +- 启用新的 API 服务后需要重新授权（`gog auth revoke` + `gog auth login`），因为旧 token 不包含新权限 + +## Key Quotes +> "此应用未经 Google 验证。此应用请求访问您 Google 账号中的敏感信息。在开发者让该应用通过 Google 验证之前，请勿使用该应用。" — Google 首次授权时的安全警告，解决方案是在测试用户中添加 Google 邮箱 +> "即使 OAuth 成功，如果 API 未启用也会报错：403 accessNotConfigured" — API 调用失败的常见原因 +> "旧 token 不包含新权限" — 启用新 API 后必须重新授权的原因 + +## Key Concepts +- [[OAuth 2.0]]：Google 账号身份认证协议，gog CLI 使用 OAuth 完成用户授权 +- [[Google Cloud Console]]：Google API 管理平台，用于创建 OAuth 凭证和启用 API 服务 +- [[Google Workspace]]：Google 办公套件，包含 Gmail、Google Calendar、Google Drive、Google Contacts、Google Docs、Google Sheets +- [[Google API Enablement]]：Google API 调用需要先在 Google Cloud Console 中启用对应服务，与 OAuth 认证是两层独立机制 + +## Key Entities +- [[gog CLI]]：由 steipete 开发的 Google Workspace 命令行管理工具，通过 Homebrew 分发 +- [[Google Cloud Console]]：Google 云平台控制台，用于管理 OAuth 凭证和 API 启用状态 + +## Connections +- [[personal-crm]] ← uses ← [[gog CLI]]（gog CLI 提供 Gmail 和 Calendar 数据，是 personal-crm 的前置依赖） +- [[gog CLI]] ← requires ← [[OAuth 2.0]]（认证机制） +- [[gog CLI]] ← requires ← [[Google API Enablement]]（每项服务需单独启用） + +## Contradictions +- 无已知冲突内容 diff --git a/wiki/sources/scrapy-playwright-抓取tiktok-shop-data.md b/wiki/sources/scrapy-playwright-抓取tiktok-shop-data.md new file mode 100644 index 00000000..377b3043 --- /dev/null +++ b/wiki/sources/scrapy-playwright-抓取tiktok-shop-data.md @@ -0,0 +1,49 @@ +--- +title: "Scrapy + Playwright 抓取TikTok Shop Data" +type: source +tags: [playwright, scrapy, tiktok-shop, python, docker, 爬虫] +date: 2026-04-24 +--- + +## Source File +- [[跨境电商/Scrapy + Playwright 抓取TikTok Shop Data.md]] + +## Summary（用中文描述） +- 核心主题：使用 Scrapy + Playwright 技术栈抓取 TikTok Shop 商家数据的环境配置与运行指南 +- 问题域：TikTok Shop 跨境电商数据采集的工程实现 +- 方法/机制：通过 Python venv 虚拟环境隔离依赖，使用 scrapy-playwright 集成包驱动 Chromium 浏览器执行动态页面渲染，再通过 Docker 容器化部署 +- 结论/价值：提供了完整的开发环境搭建流程和生产级 Docker 部署配置，是跨境电商数据采集项目的技术基座 + +## Key Claims（用中文描述） +- **虚拟环境隔离是首选方案**：通过 `python3 -m venv` 创建独立虚拟环境，安装 Scrapy + scrapy-playwright 依赖，相比 Docker 直接安装更适合开发调试 +- **Playwright Chromium 是渲染引擎**：通过 `playwright install chromium` 安装无头浏览器，负责处理 TikTok Shop 的 JavaScript 动态加载内容 +- **Docker 部署需配置 venv 环境变量**：在 Dockerfile 中添加 `RUN python3 -m venv /app/venv ENV PATH="/app/venv/bin:$PATH"`，使容器内 Python 命令使用虚拟环境 +- **可用命令行参数指定目标店铺**：通过 `scrapy runspider tiktok_shop_spider.py -a shop_url="..."` 传递 TikTok Shop 店铺 URL 参数 + +## Key Quotes +> "最推荐：创建虚拟环境 (venv) 并安装 Scrapy + Playwright" — 文档作者推荐的最佳实践方案 + +> "source venv/bin/activate" — venv 激活命令 + +> "RUN python3 -m venv /app/venv ENV PATH=\"/app/venv/bin:$PATH\"" — Docker 中配置 Python venv 的标准写法 + +> "python -c \"from playwright.sync_api import sync_playwright; print('Playwright OK')\"" — Playwright 验证命令 + +## Key Concepts +- [[Scrapy]]：Python 爬虫框架，负责请求调度、数据解析和管道存储 +- [[Playwright]]：Microsoft 开发的无头浏览器自动化工具，支持 Chromium/Firefox/WebKit 多引擎，用于渲染 JavaScript 动态页面 +- [[scrapy-playwright]]：连接 Scrapy 与 Playwright 的集成包，使 Scrapy Spider 能够执行浏览器自动化操作 +- [[venv]]：Python 内置虚拟环境工具，用于隔离项目依赖，避免版本冲突 +- [[Docker]]：容器化平台，用于生产环境部署 +- [[Chromium]]：Google 浏览器引擎，Playwright 的默认渲染引擎 + +## Key Entities +- [[TikTok Shop]]：字节跳动旗下的电商平台，本文档的数据采集目标 +- shenwei：文档作者，提供实际操作笔记 + +## Connections +- [[TikTok Shop Apache Superset Dashboard]] ← uses ← [[Scrapy-Playwright-TikTok-Shop-Data]] +- [[做tk跨境思路不对努力白费]] ← related_to ← [[Scrapy-Playwright-TikTok-Shop-Data]] + +## Contradictions +- 无已知冲突内容