Skip to content

docs: correct stale README facts (port, tool count, source availability) - #16

Open
245678000000 wants to merge 1 commit into
CometixSpace:mainfrom
245678000000:docs/fix-stale-readme-facts
Open

docs: correct stale README facts (port, tool count, source availability)#16
245678000000 wants to merge 1 commit into
CometixSpace:mainfrom
245678000000:docs/fix-stale-readme-facts

Conversation

@245678000000

Copy link
Copy Markdown

Summary

Three facts in README.md / README_CN.md have drifted from the code. Docs only — no code changes.

Where Was Now Why
Architecture diagram 127.0.0.1:9960 127.0.0.1:39831 Cursor++/src/server/data/defaults.ts:15, installer/src/defaults.js:18, and the cursor2plus.server.port default in Cursor++/package.json are all 39831. 9960 appears nowhere else in the tree.
Features bullet 22 Agent Tools — … StrReplace … 24 Agent Tools — … Edit … TOOL_REGISTRY in Cursor++/src/server/handlers/agent/toolkit/registry.ts registers 24 tools (SemanticSearch is commented out and not counted). There is no StrReplace anywhere in src/ — the edit tool is Edit.
Issues & Feedback "This repository is for issue tracking and documentation only — source code is not published." Points at Cursor++/ and installer/ in this repo, AGPL-3.0-or-later The sources landed with the two subtree imports, and the licence was changed to AGPL-3.0-or-later.

The port line was spotted by @ncdeng in #14 and never got its own PR.

Note

If you count the agent tools differently (e.g. excluding the MCP meta-tools), say the word and I'll drop that row — the other two stand on their own.

Test plan

Documentation only; nothing to run. Each claim is checkable against the file:line references above.

Three facts in README.md / README_CN.md have drifted from the code:

- BYOK server port in the architecture diagram was 9960. The default is
  39831 everywhere in the tree (Cursor++/src/server/data/defaults.ts,
  installer/src/defaults.js, the cursor2plus.server.port contribution in
  Cursor++/package.json). 9960 appeared nowhere else.

- "22 Agent Tools ... StrReplace". TOOL_REGISTRY in
  Cursor++/src/server/handlers/agent/toolkit/registry.ts registers 24
  tools (SemanticSearch is commented out and not counted), and there is
  no StrReplace tool anywhere in src/ — the edit tool is Edit.

- "This repository is for issue tracking and documentation only — source
  code is not published." The extension and installer sources have been
  in the repo since the Cursor++/ and installer/ subtree imports, under
  AGPL-3.0-or-later.
Rogers-F added a commit to Rogers-F/CCursor that referenced this pull request Aug 29, 2026
- buildSummarySource: 总预算 min(0.6×窗口×4, 3.2e6) chars, 超限走官方
  CC-012 max-min 水位分配 (长度升序配额; <200 chars 整条丢弃打
  [omitted {role} message, N chars] 占位; user 截断保 <user_query> 块;
  Read/Task 截断强制保留路径清单 + error/fail 行 + 末段结论)
- 三级兜底 streamSummaryWithFallback / generateSummaryWithFallback:
  ≤3 次重试 (attempt≥2 附 "Write a shorter summary" + 源预算递减
  max(50K, min(÷2/÷3, 0.75×原长)); attempt 3 剥控制字符) → 确定性降级
  (不经模型, 水位拼接 + 注入防御声明, 预算 clamp(窗口×2%×4, 50K, 3.2M))
  → '- Prior conversation compacted.'; 两路 runtime 换用同一实现
  (流式 delta + heartbeat 保活)
- SUMMARY_HARD_CAP = 2×summaryReserve: 产出超限 → 一次 shorter-output
  重试 → 仍超则 token 级裁剪至 cap, 超支率进观测日志
- SUMMARY_USER_TEMPLATE 附加 [truncated]/[omitted] 工具输出段
  (SYSTEM_PROMPT 不动): 摘要须保留路径/命令/agentId 与结论,
  原文可重跑工具找回
- 测试: CometixSpace#11 摘要源封顶+路径错误行 / CometixSpace#16 三次失败→确定性降级含防御声明 /
  CometixSpace#17 水位分配 200 条不等长+user_query 存续 / #33 输出硬上界裁剪
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant