feat(demohouse/car-decision-assistant): add car decision assistant

README.md

@@ -34,6 +34,7 @@
 | [实时对话式 AI](./demohouse/rtc_conversational_ai/README.md) | 超低延迟的 AI 实时对话应用，更流畅，更自然，更实时。                                                           |
 | [AI-Media2Doc](./demohouse/media2doc/README.md)         | 一键将视频和音频转化为小红书/公众号/知识笔记/视频总结/思维导图等各种风格的文档, 可基于视频内容进行 AI 二次对话。                          |
 | [Mobile-Use](./demohouse/mobile-use/README_zh.md) | 基于火山引擎云手机与豆包视觉大模型能力，通过自然语言指令完成面向移动端场景自动化任务的 AI Agent 解决方案 |
+| [购车决策助手](./demohouse/car-decision-assistant/README.md) | 基于 Agent Plan、专业数据集和 AI Native 应用开发底座，将自然语言购车需求与精确车型配置、城市销量和用户主观确认进行可追溯核验。 |
 | [个人投资助手](./demohouse/personal-investment-assistant/README.md) | 基于 Agent Plan、DataPro 和豆包搜索生成来源可追溯的个股简评与盘后风险摘要，支持个性化关注偏好、定时监控和 Skill 一键初始化。 |
 
 ## 相关指引

demohouse/car-decision-assistant/.env.example

@@ -0,0 +1,22 @@
+# Server-only Agent Plan credential. Never expose this value to client code.
+AGENT_PLAN_API_KEY=
+
+# Optional overrides. The defaults target the Agent Plan endpoints documented
+# in this cookbook's source material.
+AGENT_PLAN_MODEL=ark-code-latest
+AGENT_PLAN_BASE_URL=https://ark.cn-beijing.volces.com/api/plan
+DATAPRO_MCP_URL=https://datapro.hqd.cn-beijing.volces.com/mcp
+
+# Project persistence. Keep service-role credentials on the server only.
+PROJECT_STORAGE_BACKEND=supabase
+SUPABASE_URL=
+SUPABASE_SERVICE_ROLE_KEY=
+SUPABASE_ANON_KEY=
+
+# Used only by the local byted-supabase-cli startup helper.
+SUPABASE_WORKSPACE_ID=
+SUPABASE_CLI_PROFILE=
+SUPABASE_REGION=cn-beijing
+
+# Optional override for the real Provider acceptance script.
+CAR_DECISION_BASE_URL=http://localhost:3003

demohouse/car-decision-assistant/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - name: Set up Node.js
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        with:
+          node-version: 22.15.0
+          cache: npm
+
+      - name: Install locked dependencies
+        run: npm ci --ignore-scripts
+
+      - name: Run public release checks
+        run: npm run release:verify

demohouse/car-decision-assistant/.gitignore

@@ -0,0 +1,54 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/.vinext/
+/out/
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+!.env.example
+
+# vercel
+.vercel
+
+# typescript
+next-env.d.ts
+*.tsbuildinfo
+/dist/
+/.wrangler/
+/outputs/
+/work/
+
+# local browser and release-validation artifacts
+/.playwright-cli/
+/qa/
+
+# local app runtime and private configuration
+/.car-decision-assistant/
+/backups/
+/supabase/.temp/
+/.openai/hosting.json

demohouse/car-decision-assistant/CHANGELOG.md

@@ -0,0 +1,24 @@
+# 更新记录
+
+## 0.1.0
+
+- 移除内部 QA、过时验收报告和模板文件，补齐公开仓库元数据与 CI。
+- 将锁定依赖全部切换到公共 npm registry，外部环境可以直接安装。
+- 将最低 Node.js 版本调整为 `22.15.0`，与测试和真实 Supabase 验收脚本保持一致。
+- 固定 GitHub Actions 提交版本，并在 Linux 上执行完整发布门禁。
+
+首个公开版本：
+
+- 支持自然语言购车需求和最多 3 款候选车。
+- 支持一次精确车型确认并冻结专业数据集返回的 code 或精确名称标识。
+- 支持车型配置与城市车系月度数据并行查询、部分成功和来源追踪。
+- 支持 AI Native 应用开发底座的匿名项目、恢复码、版本冲突、本人确认和报价持久化。
+- 提供稳定错误码、真实 AI Native 应用开发底座验收和三组真实 Harness 场景。
+- 提供 `car-decision-assistant` 初始化 Skill。
+
+已知限制：
+
+- 当前不接入豆包搜索。
+- 部分专业数据集响应不提供原生数值车型 code。
+- 口碑、保值率、保险成本、真实落地价和主观体验不能自动核验。
+- 当前是自托管开源应用，不提供公网 SaaS、多人协作或 SLA。

demohouse/car-decision-assistant/CONTRIBUTING.md

@@ -0,0 +1,21 @@
+# 贡献指南
+
+## 开发流程
+
+1. 从最新主分支创建短分支。
+2. 不提交密钥、运行日志、浏览器状态、私有截图或 Provider 原始响应。
+3. 修改事实解析时同时增加主体、版本、单位和保守降级测试。
+4. 修改 Skill 时同步更新 `SKILL.md`、脚本和隔离安装测试。
+5. 提交前执行 `npm run release:verify`。
+
+## 数据与模型规则
+
+- 不使用模型记忆生成汽车配置、销量或价格事实。
+- 不把车系级数据借给精确配置。
+- 不把指导价写成落地价。
+- 不伪造专业数据集返回的 code、trace ID 或来源时间。
+- 主观体验和当前数据源不支持的需求必须保持待确认。
+
+## Pull Request
+
+说明用户问题、行为变化、验证命令、真实 Harness 能力是否调用、数据迁移影响和已知风险。数据库变更必须包含可重复 Schema、RLS 检查和回滚说明。

demohouse/car-decision-assistant/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

demohouse/car-decision-assistant/PRIVACY.md

@@ -0,0 +1,25 @@
+# 隐私说明
+
+购车决策助手是自托管应用。数据保存位置和保留期限由部署者控制。
+
+## 保存的数据
+
+- 用户输入的城市、预算、购车时间和原始用车需求。
+- 用户确认的候选车型、本人体验、报价和书面信息。
+- 专业数据的必要摘要、查询时间、状态和 trace/request ID。
+- 匿名项目的编辑令牌摘要和恢复码摘要。
+
+## 不保存的数据
+
+- 不要求手机号、邮箱、身份证或合同上传。
+- 不向经销商发送销售线索。
+- V1 不保存专业数据集的完整原始响应。
+- 数据库不保存明文编辑令牌或恢复码。
+
+## 保留与删除
+
+项目默认在最后一次更新后保留 90 天。用户可以在页面中删除当前项目；关联记录通过数据库外键级联删除。部署者应自行配置过期清理任务，并在公开服务前说明实际执行频率。
+
+## 第三方服务
+
+Agent Plan、专业数据集和 AI Native 应用开发底座会按各自服务条款处理请求。部署者负责确认账号权限、区域、套餐和合规要求。