桃源工坊 Tao Code

使用说明书

给旅行开发者和旅行供应商的工作说明。打印时用浏览器的打印功能存成 PDF。

返回工坊↗ 穿越桃花源主站帮助中心 / Help

1. 产品概述与双生态定位

桃源工坊(TaoStudio)是穿越桃花源给旅行从业者用的生产工具,桌面和网页里的名字是 Tao Code。它做四件事:生成有首页、房型与产品、周边线路、支付预订的独立站;把主库里已经公开的 20% 线路预览挂到店里;做电子名片和五个平台的文案;把对景点、线路的修改提交成待审修订。

旅行开发者(OPC)用它改线路和景点,或把一条线路做成可以解锁的产品。旅行供应商用它给民宿、手作、向导或小店建站,并把店铺说明挂到途经本店的线路上。工坊没有公开动态、没有关注关系,也没有全站聊天。和线路有关的消息只属于那一条线路。

试运行期不做现金分成。通过终审的创建和修订,会在线路页留下寻路官署名、公开主页和个人网站链接,并永久记下版本。等平台和财务风控成熟后,这些首发记录和修订记录才会作为自动分账的依据。工坊页面不计算、也不展示现金金额。

2. 多端安装与形式邮箱注册

网页端直接打开 https://www.taocross.world/studio。右侧一开始就是「天下擂茶」样板站,改品牌、房型、口号、主题色和收银台,预览会跟着变。未登录可以完成本地预览、导入 HTML 骨架、检索 20% 线路和写文案。

Windows、macOS(Apple 芯片和 Intel)和 Linux 的「立即下载」拿到的是启动器:双击或运行后打开上面的网页工作台。Android 压缩包是 PWA 安装说明和 Bubblewrap 工程,不是已经签名的 APK。编译好的 .msi、.exe、.dmg、.AppImage、.deb 由仓库里的 GitHub Actions 在标签 taostudio-v* 上构建,发布到 GitHub Releases。下载页的安装按钮会在浏览器支持时触发 beforeinstallprompt。

注册只检查邮箱形状,不发验证信。密码至少 8 位,只保存口令摘要。每日 50 次免费配额按 UTC 日计算,只用在云端模型调用。本地预览、公开线路检索和文案生成不扣这 50 次。发布上线、把站点存进云端、导出名片图片和提交主库 PR 时,如果还没登录,工坊会请你注册。

3. 本地千问与云端模型

工坊先看本机 Ollama。安装后执行 ollama pull qwen2.5-coder,并保持服务在 http://localhost:11434。生成介绍时如果本机有这个模型,就用它,不扣每日 50 次。

没有本地模型时,已登录用户可以走服务器上配置的通义千问。这一步会计入 50 次。你也可以在「模型与 API」里填写自己的 OpenAI 兼容地址,用来接 DeepSeek、Claude 兼容网关、OpenAI 或通义千问。Base URL、API Key 和模型名只写在这台浏览器的 localStorage,不进数据库。

模型只被要求用你的品牌、产品和已经检索到的公开线路名写一段短介绍。它不应该复述你的任务说明,也不应该编造价格、评分或没给它的行程正文。钥匙不要写进网页源码,不要提交到 Git。

4. 对话式建站、导入与复刻

在「智能建站」里写清店铺在做什么,而不是写一句给模型的命令。品牌名、省市、口号、四套主题色(山野森绿、陶土赤金、水墨雅白、暗夜极客)和房型列表会直接重画右侧四个页面。房型有名称、价格、亮点标签和预订状态,增删后预订页和房型页一起变。

导入本地 HTML 时,工坊只留下标题、导航文字、颜色和每段开头约 40 字,再放进你自己的房型列表。参考网址同样只取 h1 到 h3。对方页面的正文不会被保存,也不会被当成你的独立站发布。

「用公开预览润色」会按任务里的地名和天数查找已经公开的线路,并在你登录或自备钥匙时请模型改写口号。发布上线写的是你的页面,同一省市或同一品牌名已被占用时会拒绝。城市地址形如 /site/省码/市码,张家界的市码是 za。

5. 双轨网址与电子名片

每个独立站有两条地址。物理地址按省和市,例如 https://site.taocross.world/hunan/za。品牌地址按中文店名,例如 https://site.taocross.world/brand/天下擂茶。页面上、文案里和二维码里都使用解码后的中文地址。百分号编码只出现在必须编码的请求参数里,不出现在名片和复制文案中。

名片有三套版式:暗金罗盘、东方桃源、现代极简。未登录可以在右侧画布看大图。登录之后才能下载 PNG 或 JPG。客人扫码应打开品牌地址,而不是一段看不懂的编码。

线下把名片放在前台、房卡和擂茶席上。线上五个平台的文案末尾使用同一条中文地址,避免每个平台各写一个短链。

6. 支付宝与微信收款

工坊不代你扣款,也不保存私钥、APIv3 Key 或银行卡号。收银台只把你选择的方式画进「支付预订」页:支付宝当面付、微信收款码,或飞猪、携程、自有 PMS 的 https 预订链接。定金金额、信用免押徽章和收款码图片在你点击或上传后立刻出现在右侧页面。演示码的图上写着「不能付款」,用来看版式,不能当成商户码。

支付宝企业户:在 b.alipay.com 准备营业执照、实名法人个人支付宝、同名对公账户,以及开户许可证编号或基本存款账户编号。对公打款验证后签约当面付、信用免押或刷脸付。住宿场景要有住宿营业执照和特种行业许可证。官方直连的标准费率是 0.6%。另一条路是把客人送到已经签约的酒店 PMS 或飞猪等 OTA,私钥留在对方系统。

微信支付商户号:在 pay.weixin.qq.com 准备营业执照、法人身份证、对公账户或个体户法人银行卡、管理员手机邮箱、门头照片和室内照片。法人微信人脸核验,审核常见是 1 到 3 个工作日。普通商户费率 0.6%。特约商户优惠费率 0.2%,需要特种行业许可证、卫生许可证、近 3 个月入住率与流水,以及年流水 50 万以上。

费率计算器用月流水乘 12,再乘 0.4 个百分点,得到 0.6% 与 0.2% 的差额。月流水 50,000 元时,一年流水 60 万,差额 2,400 元。年流水不到 50 万时,页面会写明不能按 0.2% 申请。三个避坑:类目选酒店/住宿;用预订流水和入住台账证明真实经营;特种行业许可证在送审前办好。线下是 T+1 收款码,线上小程序另有微信认证费 300 元/年。材料清单可以在收银台工作台逐项勾选。

7. 五个平台的文案

文案工作台读取品牌、省市、房型、你勾选的真实线路名和途经节点、地址电话,以及可读的中文品牌地址。风格有爆款种草、硬核徒步、东方人文和限时特惠。你的任务说明不会被拼进正文。还没换成真实线路时,文案不会把样板行程写成主库原文。

小红书给出三个标题、痛点开头、房型或产品拆解、周边行程、三条实用提示和标签。微信公众号是一段带内联样式的图文,右侧和文案区都能预览;复制富文本后可以贴进公众号后台,也可以导出 HTML。微博带两个话题、九宫格配图说明和中文地址。朋友圈先写折叠前的三行,再写掌柜邀约和九宫格建议。抖音是一张分镜表:镜号、景别、画面、口播、时长、BGM 与 POI。

工坊不代发。你复制或打开微博分享页之后,在各平台自己的后台发布。没有拍过的画面不要写进九宫格建议里。

8. 主库共创、署名与未来分账

主库共创不再要求手填编号。按目的地或名称搜索,点一条现成的线路或景点,标题和公开预览会载入编辑器。三种模式:新增或修改景点、修改线路行程、把店铺挂到途经的线路。找不到景点时可以登记一个自动编号,编号会出现在条目栏里,不用你背。

右侧红绿对比是原文和你的修改。五维预演看地理围栏、合规性、完整度、是否点选了主库条目、商家信息是否写了。这是提交前的预览。真正入库前,服务器还会再做一次预审:正文过短、禁限类目,或坐标不在中国范围内,会被标成待人工看的标记。坐标不要凭空填写。

AI 预审不是批准。状态是 PENDING 或 AI_FLAGGED,直到名单里的管理员批准。批准后的修订叠在阅读时的主库内容上面,不改写原始数据文件。驳回和回滚都由管理员执行,回滚后该条不再作为线上修订展示。

试运行的回报是署名,不是现金。批准后,你的公开名片出现在该线路或景点的共创名录里,游客可以打开 /creators/你的标识,访问你填写的个人网站,或写信到公开邮箱。登录邮箱不会公开。供应商挂店不会自动变成这条线路的首发寻路官。

第二阶段才谈分账。平台成熟、交易和财务风控到位之后,试运行期记下的首发线路和已获批修订,会作为分账比例和创世寻路官分红池的依据。在那之前,名片页的声望只等于首发线路数乘 10 加已获批修订数乘 3。

9. Kirby 蓝图与纯文本档案

工坊 2.0 的左侧是文件树,不是数据库表。线路在 content/1_routes,景点在 content/2_spots,民宿在 content/3_stays,出行指南在 content/4_guides。每个档案是用 ---- 隔开的键值文本,可以导出,也存在这台浏览器的 IndexedDB 里。

蓝图在 site/blueprints。景点蓝图有名称、开放时间、门票、经纬度、行政层级、建议时长、时令、预约渠道、正文和配图。线路蓝图有天数、出发地、途经节点和九段正文。民宿蓝图有房型表、入住须知、活动日历、收款说明和品牌网址。

在结构化面板右上角可以添加自定义字段。字段类型有单行文本、Markdown、价格、时间、坐标、标签、子表和图片。新字段会写进对应的 yml,并出现在当前表单里。坐标没有来源时请留空,不要填一个看起来精确的数。

源码视图可以直接改 txt、yml 和独立站 HTML。红绿对比是你打开文件之后的改动。回滚回到打开时的文本。恢复生成结果会丢掉你对某一页 HTML 的手改。

10. 长图与多图导入

顶栏「导入长图 / 多图」接受拖拽、文件选择和粘贴,最多 12 张。单张图的高宽比大于 2.5 时,浏览器按 2200 像素高度切片,相邻切片重叠 250 像素,避免把一行字切成两半。

三张内置样板分别叫小红书滇西北五日、携程敦煌青甘四日、微信桃源古村周末。它们是工坊画出来的演示,不是从这些平台抓来的原帖。样板里的经纬度只精确到两位小数,并写明要核对。没有写进样板的门票和开放时间保持空白。

你自己的图片会先在浏览器里切片。若本机 Ollama 开着,并且模型名里有视觉模型,工坊会请它只转写看得见的文字。没有视觉模型时,把图中的文字粘贴到输入框,再点整理。服务器只收文字和样板编号,不保存原图。

核对右侧的日程、景点卡片和出行指南之后,点一键导入。文件树会多出线路、景点和指南,预览和五个平台的文案跟着变。文案仍然由你自己复制到各平台,工坊不代发。