Skip to content

DeepSeek Harness Tauri 桌面版 | Only 8mb installer, zero environment setup, preset plugins, Windows / macOS / Linux.

4.9 KB
Raw Blame

Workspace Routing & Context Guidelines

在执行代码分析、优化、重构或单测编写前,必须根据修改对象的路径、业务域与环境,主动读取并叠加遵循对应的规范文档:

1. 规范矩阵与路由表 (Specification Routing Matrix)

修改范围 / 触发条件 业务场景 / 对应模块 必须参照的规范文档
基础通用 所有代码修改 docs/specs/devlopment.md
测试标准 通用 Unit Test、E2E 集成测试断言与结构 docs/specs/testing.md
桌面端 - 基础架构 桌面端主进程、Shell 基础、GUI 渲染核心 docs/specs/desktop.baisc.md
桌面端 - UI 组件 设置面板 / 对话框等前端组件的内部分区、派生数据与提交动作组织 docs/specs/desktop.ui.md
桌面端 - 测试验证 桌面端 E2E 测试、UI 单元测试、桌面功能测试 docs/specs/desktop.test.md
插件 - 基础架构 插件常量归属、跨侧共享约定与退级策略 docs/specs/plugin.baisc.md
插件 - 客户端核心 插件 Client 通信、状态管理与客户端逻辑 docs/specs/plugin.client.md
插件 - 客户端面板 插件 Panel 视图组件、交互面板 UI docs/specs/plugin.client.panel.md
插件 - 宿主核心 宿主进程管理、插件加载器、沙箱隔离 docs/specs/plugin.host.md
插件 - 宿主服务 宿主系统级 Service、底座 API 实现 docs/specs/plugin.host.service.md
插件 - 测试套件 插件 Mock 测试、沙箱运行测试、集成测试 docs/specs/plugin.test.md
上游同步/依赖管理 Upstream 仓库同步、依赖重构、版本兼容 docs/specs/upstram.sync.md

2. 规范叠加与优先级 (Specification Stacking Rules)

  • 通用基础:docs/specs/devlopment.md 为全局必须叠加的基础规范。
  • 多模块协同:若同时跨越桌面端与插件(例如:优化插件面板及其与桌面宿主的通信),必须同时读取并整合涉及的所有子规范。
  • 冲突裁决:当规则冲突时,优先级为 专项/业务规范 > 运行环境规范 > devlopment.md。

最高优先级 (Strict Guidelines)

  1. 隐私与目录隔离:
    • 严禁查看 archive/ 目录下的任何内容,除非用户明确提及并给予特殊许可。
  2. 极致代码精简与注释策略:
    • 0 注释原则:编写/重构代码时必须保持 0 注释,仅允许在极难通过代码自解释的关键节点/复杂算法添加微量注释。
    • 清理冗余:优化时若发现代码中存在大面积文档描述、历史残余注释或冗余代码,应主动清理/精简,提升干净度。
  3. 临时草稿区:
    • 若需要临时记录、存放中间分析过程或草稿,可随意在 .temp 文件中编写(该文件下拥有绝对自由度)。
  4. 插件开发保护:
    • 在处理或重构插件相关代码时,切勿执行构建(Build)命令(用户可能正处于 Dev 开发热重载状态)。

沟通与评论规范 (Reply & Comment Rules)

回复用户、以及在 issue / PR 下留言时,一律适用:

  1. 短。先给结论:
    • 默认三五句说完。不写小标题、不写表格、不写清单堆砌;只有用户明确要「详细/完整报告」时才展开。
    • 不复述刚跑过的命令、文件清单或工具输出,用户不关心过程。
  2. 说人话,不要 AI 腔:
    • 禁止「综上所述」「值得注意的是」「希望能帮到你」这类套话,禁止 emoji 装饰与 ✅🎉 式排版。
    • 正文用中文;仅代码、命令、标识符与官方术语保留英文,不要中英夹杂堆术语。
  3. 不刷屏:
    • 同一话题只留一条评论/一条回复。写长了或写错了,原地编辑(gh api --method PATCH),不要补发第二条。
    • 链接与代码块只留必要的那一两条,堆参考链接视为噪音。
  4. 结论要能落地:
    • 推荐方案必须给一条可直接复制的命令,并诚实标注限制:不支持、已失效、只是缓解,都要写清楚。

Command Performance Constraints (Strictly Enforced)

执行文件查找或代码检索时,必须遵守极速命令约束,避免触发低效遍历:

  1. FORBIDDEN POWERSHELL COMMANDS:

    • NEVER use Get-ChildItem -Recurse or dir -s to search files/directories.
    • NEVER use Select-String -Path for recursive text searches.
  2. FAST ALTERNATIVES (MANDATORY):

    • Searching text in files: Use rg "pattern" (ripgrep).
    • Finding files by name/path: Use fd <pattern> or git ls-files | Select-String "pattern".
    • Listing top-level directory items: Use simple Get-ChildItem (NO -Recurse).
  3. GIT PROJECT EXEMPTION:

    • Always leverage Git index if available: git ls-files is exponentially faster than PowerShell directory traversal.