Twiceshy

app.twiceshy由 twiceshy.app 发布官方发布者v0.1.0更新于 Oct 24, 2026

Experience memory for coding agents: validated traps, fixes and dead-ends at decision time.

已验证Streamable HTTP可网页运行知识与记忆开发者工具

概览

AI 生成的概览

Twiceshy 是一个托管式经验记忆服务，在编码助手做决策时提供经过验证的陷阱、修复方案和死胡同记录。

可以做什么
  • 按编码任务检索相关经验记录，并按技术栈指纹和相关性下限过滤，匹配太弱时返回空结果。
  • 通过 streamable HTTP 端点上的 MCP 工具拉取记录，也可经 Claude Code 钩子推送陷阱卡片。
  • 基于带来源信息的 git 托管 Markdown 记录，使用 BM25 加稠密向量建立索引。
  • 可提交新记录，记录先被隔离，只有通过沙箱验证和人工审核后才会正式收录。
适用场景
适合编码助手反复犯已知错误、希望它在选择方案前先看到既往问题、根因和已验证修复的场景。也适合愿意维护一份共享且经审核的工程经验库的团队。
运行要求
需要访问 api.twiceshy.app 上的远程 MCP 端点（streamable HTTP）。需在 Authorization 请求头中提供 bearer 令牌，可从自助 alpha 注册获取；未声明本地运行时或环境变量。
安装前请注意
Authorization 中的 bearer 令牌属于机密，须妥善保管。该服务处于托管 alpha 阶段，可用性和行为可能变化。助手提交的记录会被隔离，需经人工 PR 审核才能收录，外部贡献还需签署 CLA。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Twiceshy，将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/app.twiceshy%2Ftwiceshy/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "twiceshy": {
      "type": "http",
      "url": "https://api.twiceshy.app/",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

twiceshy

Once bitten, twice shy.

A self-hosted service that feeds hard-won engineering experience — issues, dead-ends, root causes, validated fixes — to LLM coding agents at decision time, so they stop repeating known mistakes on autopilot. Records are git-backed and provenance-aware; automatic retrieval applies a relevance floor so a weak match can return nothing.

Hosted alpha

The hosted instance runs at twiceshy.app — self-serve tokens, remote MCP endpoint https://api.twiceshy.app/. External contributions require a signed CLA before merge (ADR-0002).

How it works (the locked architecture)

  • Source of truth: git-backed markdown experience records (YAML frontmatter
    • narrative) — format in docs/SCHEMA.md. The corpus is a separate versioned data product (twiceshy-corpus, ADR-0021); the engine ships a small frozen fixture (internal/testcorpus/) for tests.
  • Index: one derived, always-rebuildable SQLite file (FTS5 plus cached, pure-Go dense vectors for pull retrieval).
  • Retrieval: fingerprint-exact → BM25 → dense (RRF), stack-fingerprint filtered, hard cap k≤3 with a relevance floor — below it, nothing is injected.
  • Channels: push (Claude Code hooks → trap cards), pull (MCP tools over streamable HTTP), index (generated one-liners).
  • Trust: agent-proposed records are quarantined; promotion = sandbox fail-to-pass validation + human PR review. A new record IS a pull request.
  • Doctors: background jobs that dedup, staleness-check, re-execute repros (CI for memories), decay, and abstract.

Full rationale: docs/research/EXPERIENCE_SERVICE_RESEARCH.md and docs/adr/ADR-0001-architecture.md.

Status

The core service is available as a hosted alpha. For the canonical snapshot of what ships now and the current roadmap, see docs/NEXT_FEATURES.md; deployment and operating details live in docs/DEPLOY-public-alpha.md.

Development

sh
make ci    # lint + race tests + coverage floor — what CI runs

See docs/CONVENTIONS.md and docs/CONTEXT.md first.

License

AGPL-3.0-only. Contribution and corpus licensing: docs/adr/ADR-0002-licensing-strategy.md.

来源：README.md，提交 aa8f1d8

工具

0
该服务器需要 API 密钥等凭据，因此 SourceWeft 无法在没有凭据的情况下读取其工具，也未收录。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 60%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分