project-little-weirdo

Project Little Weirdo 🥸

一项实验性的机器对机器智能服务，旨在探索小型自主数字工具能否在极少人工关注的情况下创造可持续的经济价值。

Genesis purpose

Little Weirdo 被构建为 Genesis 基础：这是一个具备生产能力的最小系统，能够如实观察公共网络，针对观察结果给出有用的信息，将此能力开放给其他机器，并诚实核算成本与收益。它必须证明自己有资格继续演进——每项能力都须以证据为门槛，而非仅凭意图。

Current capability

• Asset 001 — 确定性观察。 获取一个合法的公开页面，并记录其有界表示（标题、规范化文本长度、内容指纹），然后通过算术比较与上一次观察的差异：BASELINE_CREATED、NO_CHANGE 或 CONTENT_CHANGED。
• Asset 001.5 — 商业变更解读。 仅针对定价和商业报价页面，解读已确认变更在商业上的含义，且每项声明都引用观察到的文本。
• 外部机器网关。 提供 REST 和 MCP 传输，须凭凭证访问，设有速率限制并记录遥测数据。
• 创始人控制室。 面向单一创始人的私有仪表板，显示实时系统状态、门槛和经济账目。

确定性观察与语义解读

这两个层面绝不混为一谈。

• 观察是证据。 纯函数、算术判定，不声称其含义。CONTENT_CHANGED 判定只证明内容不同，仅此而已。
• 解读是推断。 仅对已持久化的观察结果运行，不会重新获取页面，也不会判断是否发生了变更。无法从观察到的变更前后文本中逐字溯源的大模型声明都会被拒绝，并将拒绝及其原因持久化。

语义结果可以表达不确定性，也可以拒绝解读。非商业页面会返回 INSUFFICIENT_EVIDENCE，而不是凭空捏造含义。

MCP / 机器接口

• POST /api/public/weirdo/v1/mcp — MCP Streamable HTTP（修订版 2025-06-18），提供 observe_public_page 和 interpret_commercial_change。
• POST /api/public/weirdo/v1/observe — REST 观察接口。
• POST /api/public/weirdo/v1/interpret — REST 解读接口。
• GET /api/public/weirdo/v1/mcp — 机器可读的发现清单。
• /machines — 面向人类的机器文档。

两种传输方式都会进入同一个网关，由该网关统一负责凭证检查、预算限制、URL 防护、溯源和核算。任何一种方式都无法绕过它。

注册表文件位于 mcp/。尚未在官方 MCP Registry 注册；请参阅 mcp/REGISTRATION.md。

免费 Beta 版须知

本服务不具备付款、计量、订阅或账单功能。访问需要由创始人签发的机器凭证，并按凭证实施速率限制；整个实验还设有累计成本上限。免费 Beta 不保证永久免费使用。

合法使用边界

• 仅可观察合法且公开可访问的 HTTP/HTTPS 内容。
• 禁止访问私有、内部、环回和链路本地网络；URL 防护机制会拒绝此类访问。
• 不得绕过身份验证和访问控制；带凭证及非公开内容不在服务范围内。
• 重定向、响应大小和超时时间均有上限。
• 不保证任何特定页面包含商业情报。

安全态势（概览）

• SSRF 防护：验证主机和 IP 字面量，拒绝私有网络，限制重定向次数和响应大小。
• 创始人控制室采用默认拒绝策略：未配置允许列表时，无人获得授权。权限仅依据稳定的平台用户 ID，而非显示名称。
• 机器凭据以哈希形式存储，绝不保存原始令牌。
• 所有数据表均受行级安全策略保护，且只能通过服务端代码访问。
• 特权密钥在服务端处理程序中从环境变量读取，绝不会打包到浏览器构建中。

经济真实性原则

只有经过外部验证的事件才计入收入。创始人活动、测试流量和内部调用均不计为收入。每次运行均计入其直接成本，由模型支持的解读则计入其语义成本。账本可以显示为零——目前确实如此。

当前项目状态

• PW-G0 (LIFE) — 已达成：已保存真实的公开网页观测结果，包括实时的 CONTENT_CHANGED 判定和 NO_CHANGE 稳定性对照。
• PW-G1 (TRANSACTION) — 未完成。 凭据分类是必要条件，但并不充分；PW-G1 要求由真正独立的外部机器在生产环境中使用，并以书面证据明确认证。测试和创始人活动永远不能满足此要求。
• PW-G2 — 尚未达到，也未声称达到。
• 经验证的外部收入 — $0.00。
• 不存在自主自我改进功能。

开发 / 环境设置

git clone <this-repository-url>
cd <repository-name>
npm i
cp .env.example .env   # fill in your own values
npm run dev

技术栈：TanStack Start、React、TypeScript、Tailwind CSS、Vitest。

npm test        # full test suite
npm run build   # production build

密钥政策

• 不得将原始凭据、生产密钥、凭据哈希、使用者身份或创始人标识符存入此代码库。
• .env 已加入 Git 忽略列表。.env.example 仅列出变量名称。
• 运行时凭据应存放在托管平台的环境配置中。
• 如果有凭据被提交，应视为已泄露并立即轮换。